Trabaja con el simulador de guías

El simulador de guías proporciona un enfoque optimizado para desarrollar guías con menos tiempo y esfuerzo.

El simulador de la guía ofrece varias funciones clave que te permiten hacer lo siguiente:

• Trabajar en un entorno de preproducción, lo que te permite probar acciones y observar resultados sin afectar los datos de producción en vivo (especialmente cuando el playbook está desactivado)
• Facilita la prueba de cada paso o bloque de la guía individual para confirmar que el flujo de trabajo funciona según lo previsto.
• Prueba todas las ramas de condiciones posibles dentro de tu manual para confirmar una cobertura integral y un comportamiento predecible.

Cómo usar el simulador de guías con tu guía

Cuando trabajes con guías, ya sea que uses una existente o crees una nueva, siempre comienza por activar el Simulador de la guía. Verás un indicador verde en la parte superior que confirma que está activa.

Si usas el simulador de guías en una guía activa, se verán afectadas todas las alertas entrantes que activen esa guía. Esto se debe a que guardar una guía con datos simulados aplica esos datos a casos activos en producción, lo que podría afectar los resultados del mundo real.

1. Coloca el puntero sobre una alerta de caso, haz clic en more_vert Opciones de alerta y selecciona Ingerir alerta como caso de prueba. Esta acción crea un caso de prueba para ejecutar tu guía simulada. Las entidades modificadas en los casos de prueba no influyen en las entidades de los casos normales.
2. Mantén el puntero en la parte inferior de la página Guías y selecciona un caso de prueba. Asegúrate de que el caso de prueba seleccionado coincida con la guía que deseas ejecutar. Para confirmar, haz clic en Entidades y verifica que la guía sea capaz de procesar las entidades presentes en ese caso de prueba.
3. Haz clic en Ejecutar. El simulador procesa los pasos, ejecuta las acciones definidas y proporciona los resultados.

Cómo interpretar los resultados del simulador para cada paso

Después de hacer clic en Ejecutar, la primera fila de la consola se muestra como si fuera un manual en vivo. Cada paso simulado presenta opciones, que suelen incluir Case Data, View Results y Pin Results (o Insert Results). Los pasos manuales solicitan un botón para ingresar parámetros, proporcionar respuestas y ejecutar el paso.

Datos de casos

El ícono Case Data abre un diálogo para mostrar la información del caso en esa etapa específica, después de que finalice la acción actual. Este diálogo se actualiza de forma dinámica con los resultados del paso actual. Si una acción agregó enriquecimiento al caso, lo verás reflejado aquí. Dado que muestra el estado del caso después de la ejecución de un paso, los datos varían para cada paso en la consola de simulación. Inspeccionar los datos del caso en los diferentes pasos te ayuda a comprender los cambios que se aplicaron al caso durante la ejecución del playbook. Las múltiples pestañas dentro del diálogo proporcionan detalles adicionales.

Ver resultados

La opción Ver resultados muestra los resultados de la acción específica del paso actual. La información que se presenta es similar a un resumen del caso o a un muro de casos, y también incluye detalles sobre cualquier enriquecimiento.

Puedes acceder a los siguientes tipos de información:

• En la pestaña principal, se muestran el mensaje de salida, las tablas, los vínculos y los archivos adjuntos.
• La pestaña de detalles técnicos proporciona el resultado de la acción y el resultado en JSON (si está presente).

Al igual que con otras opciones, puedes hacer clic en los datos para realizar una inspección más profunda. En la página Ver resultados, también puedes hacer clic en Establecer resultado JSON. Esta función te permite reemplazar la muestra de JSON de la acción actual. Puedes modificar esta muestra de JSON directamente desde el entorno de desarrollo integrado (IDE) y, luego, compilarla en el compilador de expresiones para extraer datos específicos del resultado JSON.

Fijar resultados

La opción Fijar resultados está disponible cuando un paso se ejecuta correctamente. Esta es una función muy útil que te permite considerar el resultado de una acción como fijo.

Fijar resultados puede ahorrarte tiempo de las siguientes maneras:

• Elimina la necesidad de esperar los resultados de servicios de terceros.
• Reducir la cantidad de consultas realizadas a estos servicios, lo que ayuda a conservar las credenciales

Básicamente, cuando vuelves a ejecutar el playbook, se "pasa por alto" cualquier paso con resultados fijados: su código no se vuelve a ejecutar y los resultados fijados se usan tal como están. También puedes modificar este resultado insertando tus propios datos simulados. Cuando habilitas Fijar resultados, la acción ingresa al modo de simulación, y la representación visual del paso suele cambiar de un fondo azul a uno gris, lo que indica claramente que el modo Simular está activo para ese paso.

Insertar resultados

La opción Insert Results estará disponible si falla un paso. Esta función te permite insertar datos de simulación de forma manual. La próxima vez que ejecutes este paso específico, devolverá los datos que proporcionaste manualmente como resultado.

Una vez que hagas clic en esta opción, la acción tendrá habilitado automáticamente el modo Simular. La representación visual del paso cambia de un fondo azul a uno gris, lo que indica claramente que el modo Simular está activo. El campo Resultado del script es obligatorio para todos los pasos cuando se encuentra en el modo Simular.

Inserta datos simulados

Para insertar datos simulados, debes tener en cuenta algunos casos de uso:

• Crea y prueba tu guía sobre la marcha: Puedes ejecutar un paso, ver los resultados y comprender de inmediato cómo puedes usar esos datos más adelante en tu guía.
• Ahorra tiempo después de una ejecución exitosa: Es posible que desees fijar los resultados del paso. Esto te ahorra tiempo, ya que evita que el paso se ejecute repetidamente en las APIs de terceros durante las pruebas posteriores.
• Prueba diferentes situaciones: Puedes cambiar los resultados de los pasos para probar tu guía en diversas condiciones. Si configuras diferentes datos de simulación, puedes influir en las condiciones y acciones posteriores que dependen de los resultados anteriores. Por ejemplo, si tu guía tiene una condición que se bifurca en dos o más rutas, puedes experimentar con datos de simulación para "forzar" la guía a tomar una rama específica.

Inserta datos de simulación

Puedes insertar datos de simulación (ficticios) en tu cuaderno de estrategias de dos maneras principales: a través del diálogo de configuración del paso del cuaderno de estrategias o con Fijar resultados (o Insertar resultados) después de ejecutar un simulador.

Usa el diálogo de configuración del paso de la guía

1. Haz clic en el diálogo de configuración del paso dentro de tu guía.
2. Activa el Modo de simulación para habilitarlo. La representación visual de la acción cambia a gris, lo que indica que está en el modo de simulación.
3. En la sección Action results, puedes insertar los datos de simulación (ficticios). Esto incluye lo siguiente:
• Resultado de la secuencia de comandos: Proporciona un resultado simulado para las acciones basadas en secuencias de comandos.
• Resultado en JSON: Ingresa datos JSON, posiblemente extrayendo datos específicos del código JSON. También puedes cargar un ejemplo de salida haciendo clic en Cargar muestra. Esto carga el resultado de JSON esperado de la acción, lo que resulta particularmente útil en los siguientes casos:
• La simulación aún no se ejecutó y el resultado está vacío.
• Se produjo un error en la simulación y no se muestran resultados.
• Quieres anular los resultados existentes (de la fijación o inserción anteriores) con la muestra.
• Enriquecimientos: Puedes usar enriquecimientos de ejecuciones de simulación anteriores o crear tus propias claves de enriquecimiento personalizadas.

Cómo usar los resultados después de ejecutar el simulador

Fijar resultados

Si un paso se ejecuta correctamente, puedes hacer clic en Fijar resultados junto a esa acción. Después, ocurre lo siguiente:

• El paso se abre automáticamente en el modo Simulate.
.
• Los resultados de la última ejecución de simulación exitosa se fijan en el paso. Puedes usar estos resultados o editarlos.
• Puedes editar el resultado JSON con el editor de JSON o hacer clic en Cargar muestra para anularlo.
• Puedes usar los enriquecimientos de ejecuciones de simulación anteriores o crear claves de enriquecimiento personalizadas.

Insertar resultados

Si un paso falló, puedes hacer clic en Insertar resultados junto a esa acción. Después, ocurre lo siguiente:

1. Estos datos ahora se devolverán cada vez que se ejecute el paso.

Cómo desactivar el simulador de guías

Cuando desactivas el Simulador de guías, se oculta la consola inferior y cualquier paso en el modo de simulación vuelve al modo "en vivo" normal. La excepción son los bloques de la guía: debes desactivar el simulador de bloques para cerrar su modo de simulación. Todos los datos de simulación (ficticios) insertados se guardan para usarlos la próxima vez que enciendas el simulador.

Trabaja con bloques de guías

También puedes usar el simulador de la guía para compilar y probar un nuevo bloque de la guía. Cuando un bloque está en modo de simulación, todas las guías principales que usan este bloque también usan los datos simulados del bloque.