Projetando um Maestro Flow

Crie um fluxo do Maestro Flow no Studio Web usando a tela de fluxo, incluindo como adicionar e conectar gatilhos e nós, configurar propriedades, gerenciar variáveis, lidar com erros e depurar seu processo.

Observação:

O Maestro Flow está em Visualização.

A tela do Maestro Flow é um designer visual onde você cria automações colocando nós e conectando-os em sequência.

A tela do Maestro Flow

A tela mostra seu fluxo como um gráfico de nós conectados por bordas. A execução começa no nó do gatilho e move-se por cada nó conectado em ordem.

Para adicionar um nó, selecione o identificador + na borda de saída de qualquer nó existente para abrir o painel Adicionar nó . Para conectar dois nós manualmente, arraste do identificador de saída de um nó até o identificador de entrada de outro. Você pode renomear qualquer nó abrindo seu rótulo na tela Maestro Flow.

A barra de ferramentas superior fornece:

• Depurar na nuvem — executa o fluxo de ponta a ponta na nuvem.
• Debug passo a passo — avança pelo fluxo um nó de cada vez.
• Publicar — empacota e publica o fluxo no Orchestrator.

Adicionando gatilhos

O fluxo começa com um nó Disparo manual padrão que inicia o fluxo sob demanda. Selecione o gatilho na tela para configurá-lo no painel Propriedades .

Propriedades do gatilho

• ID — o identificador do gatilho, usado para fazer referência às suas saídas em expressões (por exemplo, $vars.manualTrigger1.output.userId).
• Rótulo — o nome de exibição do gatilho na tela.
• Variáveis — variáveis de entrada pertencentes ao gatilho. Quando o gatilho é acionado, suas entradas estão disponíveis posteriormente como $vars.<triggerId>.output.<inputName>.

Adicionando nós

Para adicionar um nó, selecione o identificador + na borda de saída de qualquer nó para abrir o painel Adicionar nó e, em seguida, selecione uma categoria e escolha o tipo de nó. Para obter a lista completa de tipos de nós disponíveis, consulte Sobre o Maestro Flow.

Propriedades do nó

Selecionar um nó abre sua configuração no painel Propriedades à direita, organizado em seções:

• Geral — o ID do nó (usado em expressões $vars ), Rótulo (nome de exibição na tela), Descrição e Cor do ícone.
• Tratamento de erros — alterne Habilitar o tratamento de erros para adicionar um identificador de saída de erro ao nó. Quando habilitado e o nó falha, a execução roteia para o caminho de erro em vez de interromper o fluxo.
• Atualizar variável — atribua um valor a uma variável de processo quando o nó for concluído. Selecione + Adicionar atualização de variável, escolha a variável de destino e insira a expressão a ser atribuída.

A guia Variáveis (ao lado de Propriedades) é onde você define variáveis no nível do processo. Cada variável tem um nome, tipo (String, Number, Boolean, Object ou Array) e direção (entrada, saída ou bidirecional).

Abrir o menu de contexto para um nó na tela abre um menu de contexto com: Adicionar ponto de interrupção, Adicionar teste, Copiar, Cortar, Colar e Excluir.

Variáveis e fluxo de dados

Os nós não compartilham dados automaticamente. Os nós downstream acessam a saída de um nó por meio de expressões usando o prefixo $vars .

Cada nó que produz dados disponibiliza sua saída como $vars.<nodeId>.output. O ID do nó é atribuído automaticamente com base no tipo de nó — por exemplo, o primeiro nó de fluxo de trabalho da API é apiWorkflow1. Você pode ver e editar o ID de um nó na seção Geral do painel Propriedades.

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

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

Use a aba Variáveis para definir variáveis que devem ser acessíveis em todo o processo ou que definem as entradas e saídas do processo. As variáveis são referenciadas como $vars.<variableName>.

Para obter as regras completas de gramática e escopo de expressões, consulte Variáveis e fluxo de dados na documentação do Maestro.

Tratamento de Erro

Por padrão, um nó com falha interrompe o fluxo inteiro. Para lidar com falhas em um nó específico, alterne Habilitar tratamento de erros no painel Propriedades do nó. Isso adiciona um identificador de saída de erro à parte inferior direita do nó na tela. Conecte o identificador de erro a um nó downstream para rotear falhas para um caminho separado.

Quando um nó falha e seu identificador de erro está conectado, os detalhes do erro estão disponíveis como $vars.<nodeId>.error no caminho de erro, com campos incluindo message, code, status, e detail.

Para padrões como registrar e continuar, tentar novamente e alertar e encerrar, consulte Tratamento de erro na documentação do Maestro.

Depuração de um Maestro Flow

Selecione Debug na nuvem na barra de ferramentas superior para executar o fluxo de ponta a ponta. Quando a execução for concluída, selecione qualquer nó na tela para inspecionar sua saída. Os nós que foram bem-sucedidos mostram um indicador verde; os nós com falha mostram os detalhes do erro quando selecionados.

Selecione Debug passo a passo para avançar pelo fluxo, um nó de cada vez.

Abra o menu de contexto para qualquer nó e selecione Adicionar ponto de interrupção para pausar a execução nesse nó durante uma execução de depuração. Selecione Adicionar teste para capturar a saída do nó sem pausar.

Links relacionados

• Variáveis e fluxo de dados
• Tratamento de Erro
• Subfluxos
• Fluxo de controle
• Publicação e implantação de um fluxo