Designing a Maestro Flow

Diseña un Maestro Flow en Studio Web utilizando el lienzo de flujo, incluido cómo añadir y conectar desencadenadores y nodos, configurar propiedades, gestionar variables, manejar errores y depurar tu proceso.

Nota:

Maestro Flow está en vista previa.

El lienzo Maestro Flow es un diseñador visual en el que creas automatizaciones colocando nodos y conectándolos en secuencia.

El lienzo de Maestro Flow

El lienzo muestra tu flujo como un gráfico de nodos conectados por bordes. La ejecución comienza en el nodo desencadenador y se mueve a través de cada nodo conectado en orden.

Para añadir un nodo, selecciona el controlador + en el borde saliente de cualquier nodo existente para abrir el panel Añadir nodo . Para conectar dos nodos manualmente, arrastra desde el controlador de salida de un nodo al controlador de entrada de otro. Puedes cambiar el nombre de cualquier nodo abriendo su etiqueta en el lienzo de Maestro Flow.

La barra de herramientas superior ofrece:

• Depurar en la nube : ejecuta el flujo de extremo a extremo en la nube.
• Depurar paso a paso : avanza por el flujo un nodo a la vez.
• Publicar : empaqueta y publica el flujo en Orchestrator.

Añadir desencadenadores

El flujo comienza con un nodo Desencadenador manual predeterminado que inicia el flujo bajo demanda. Selecciona el desencadenador en el lienzo para configurarlo en el panel Propiedades .

Propiedades del desencadenador

• ID : el identificador del desencadenador, utilizado para hacer referencia a sus salidas en expresiones (por ejemplo, $vars.manualTrigger1.output.userId).
• Etiqueta : el nombre para mostrar del desencadenador en el lienzo.
• Variables : variables de entrada propiedad del desencadenador. Cuando el desencadenador se activa, sus entradas están disponibles en sentido descendente como $vars.<triggerId>.output.<inputName>.

Añadir nodos

Para añadir un nodo, selecciona el controlador + en el borde saliente de cualquier nodo para abrir el panel Añadir nodo , luego selecciona una categoría y elige el tipo de nodo. Para obtener la lista completa de tipos de nodos disponibles, consulta Acerca de Maestro Flow.

Propiedades del nodo

Al seleccionar un nodo se abre su configuración en el panel Propiedades de la derecha, organizada en secciones:

• General : el ID del nodo (utilizado en $vars expresiones), Etiqueta (nombre para mostrar en el lienzo), Descripción y Color del icono.
• Gestión de errores : alterna Habilitar gestión de errores para añadir un controlador de salida de error al nodo. Cuando está habilitado y el nodo falla, la ejecución enruta a la ruta de error en lugar de detener el flujo.
• Actualizar variable : asigna un valor a una variable de proceso cuando el nodo se completa. Selecciona + Añadir actualización de variable, elige la variable de destino e introduce la expresión a asignar.

La pestaña Variables (junto a Propiedades) es donde se definen las variables a nivel de proceso. Cada variable tiene un nombre, tipo (Cadena, Número, Booleano, Objeto o Matriz) y dirección (entrada, salida o bidireccional).

Al abrir el menú contextual para un nodo en el lienzo se abre un menú contextual con: Añadir punto de interrupción, Añadir sondeo, Copiar, Cortar, Pegar y Eliminar.

Variables y flujo de datos

Los nodos no comparten datos automáticamente. Los nodos descendentes acceden a la salida de un nodo a través de expresiones utilizando el prefijo $vars .

Cada nodo que produce datos hace que su salida esté disponible como $vars.<nodeId>.output. El ID de nodo se asigna automáticamente en función del tipo de nodo; por ejemplo, el primer nodo del flujo de trabajo de la API es apiWorkflow1. Puedes ver y editar el ID de un nodo en la sección General del panel Propiedades.

// Access the output of a node named apiWorkflow1
$vars.apiWorkflow1.output

// Access the response body of an HTTP request node
$vars.httpRequest1.output.body

Utiliza la pestaña Variables para definir variables que deben ser accesibles en todo el proceso o que definen las entradas y salidas del proceso. Las variables se referencian como $vars.<variableName>.

Para obtener la gramática de expresión completa y las reglas de ámbito, consulta Variables y flujo de datos en la documentación de Maestro.

Administración de errores

De forma predeterminada, un nodo fallido detiene todo el flujo. Para gestionar fallos en un nodo específico, activa Habilitar gestión de errores en el panel Propiedades del nodo. Esto añade un controlador de salida de error en la parte inferior derecha del nodo en el lienzo. Conecta el identificador de errores a un nodo descendente para enrutar los fallos a una ruta independiente.

Cuando un nodo falla y su controlador de errores está conectado, los detalles del error están disponibles como $vars.<nodeId>.error en la ruta de error, con campos que incluyen message, code, status y detail.

Para patrones como registrar y continuar, reintentar y alertar y terminar, consulta Gestión de errores en la documentación de Maestro.

Depurar un Maestro Flow

Selecciona Depurar en la nube en la barra de herramientas superior para ejecutar el flujo de extremo a extremo. Cuando se complete la ejecución, selecciona cualquier nodo en el lienzo para inspeccionar su salida. Los nodos que se han realizado correctamente muestran un indicador verde; los nodos fallidos muestran los detalles del error cuando se seleccionan.

Selecciona Depurar paso a paso para avanzar por el flujo de nodo en nodo.

Abre el menú contextual de cualquier nodo y selecciona Añadir punto de interrupción para pausar la ejecución en ese nodo durante una ejecución de depuración. Selecciona Añadir sonda para capturar la salida del nodo sin pausa.

Enlaces relacionados

• Variables y flujo de datos
• Administración de errores
• Subflujos
• Flujo de control
• Publicar e implementar un flujo