- Introdução
- Introdução
- Crie em qualquer tela
- Criar com Caso
- Referência
- Definição de chaves de caso (sistema versus externo)
- Estabelecimento de contratos de E/S e de write-back
- Modelagem de estágios primário e secundário
- Disparo de um caso a partir do Data Fabric
- Implementação de personas e permissões no nível de estágio
- Configuração de SLAs e regras de escalonamento automatizadas
- Configuração de um loop de retrabalho (reentrada)
- Configuração e teste do agente do caso (pré-visualização)
- Criar com fluxo
- Criar com BPMN
- Operando
- Monitoramento
- Otimizando
- Informações de referência
Subfluxo
Agrupe nós em um subfluxo que é executado como uma etapa dentro de um fluxo de trabalho, passe dados para dentro e para fora dele e restrinja suas variáveis.
Um subfluxo é um fluxo de trabalho incorporado dentro de outro fluxo de trabalho, chamado de fluxo de trabalho pai. Ele agrupa um conjunto de nós em uma unidade independente que é executada como parte do pai e retorna a saída para ele. Os subfluxos organizam lógica complexa em grupos independentes e gerenciáveis.
Como funciona
Quando um fluxo de trabalho pai atinge um nó de subfluxo, a execução entra no subfluxo e executa seus nós em sequência. O subfluxo tem seu próprio escopo, a parte de um fluxo de trabalho em que um nome pode ser lido, para que as variáveis definidas dentro dele não colidem com variáveis no fluxo de trabalho pai. Quando o subfluxo for concluído, sua saída será passada de volta para o fluxo de trabalho pai, e a execução continuará com o próximo nó.
Os nós dentro de um subfluxo podem acessar:
- Outros nós dentro do mesmo subfluxo.
- O escopo do fluxo de trabalho pai.
A saída do subfluxo é acessível ao fluxo de trabalho pai $vars.<subflowName>.output.
Adicionando um subfluxo
Um nó de subfluxo é adicionado do painel Adicionar nó , onde está listado na categoria Maestro Flow e conecta-se ao nó antes dele. Ele aparece na tela como um nó com um ícone de camadas empilhadas. O botão Detalhar na barra de ferramentas de foco do nó abre o dentro do subfluxo como sua própria tela. Uma trilha no canto superior esquerdo, com um ícone de início e o nome do subfluxo, leva de volta ao fluxo de trabalho pai. O interno começa com um nó Inicial conectado a um nó Final e tem a mesma barra de ferramentas inferior que a tela principal, portanto, os nós são adicionados da mesma maneira.
Transmissão de dados
Entradas
A seção Entradas do painel de propriedades do nó de subfluxo define as variáveis de entrada do subfluxo e mapeia expressões do escopo pai para elas. Adicionar variável de entrada adiciona uma entrada. Cada entrada tem um nome, um tipo e um Valor, uma expressão que é avaliada no escopo do fluxo de trabalho pai. O menu Inserir do campo Valor lista os valores desse escopo, como os nós antes do subfluxo $metadata.
Dentro do subfluxo, as entradas são saídas do nó Iniciar do subfluxo. O menu Inserir lista esse <subflowName>Start como, por exemplo $vars.subflow1Start.output.orderData O nó Iniciar também oferece Adicionar argumento de entrada.
Saída
A seção Saídas do nó do subfluxo define as variáveis de saída do subfluxo. Adicionar variável de saída adiciona um e os valores são mapeados por meio dos mapeamentos de saída do nó Final dentro do subfluxo. A saída está disponível para o fluxo de trabalho pai como $vars.<subflowName>.output, e cada variável de saída é um campo dela, por exemplo, $vars.subflow1.output.isValid. Qualquer nó após o subfluxo pode fazer referência a ele em uma expressão, como em qualquer outra saída de nó.
// Access the output of a subflow named "validateOrder"
$vars.validateOrder.output
$vars.validateOrder.output.isValid
// Access the output of a subflow named "validateOrder"
$vars.validateOrder.output
$vars.validateOrder.output.isValid
Escopo de variáveis
Os subfluxos criam seu próprio escopo de variável. As variáveis atualizadas dentro de um subfluxo são namespaces, o que significa prefixado com o nome do subfluxo, para evitar conflitos com o fluxo de trabalho pai.
De fora do subfluxo, as variáveis internas de um subfluxo são referenciadas como $vars.<subflowName>.<variableName>. Por exemplo, uma variável counter dentro de um subfluxo chamado subflow1 é referenciada como $vars.subflow1.counter a partir do fluxo de trabalho pai.
De dentro do subfluxo, os nós acessam a saída de seus nós irmãos usando o padrão $vars.<nodeName>.<property> padrão. Eles também podem ler do escopo do fluxo de trabalho pai diretamente.
O namespace da variável impede que as variáveis internas de um subfluxo substituam variáveis pai que compartilham o mesmo nome. Os nomes de variáveis não precisam ser coordenadas entre o pai e o subfluxo.
Exemplo prático
Um fluxo de trabalho pai chama um subfluxo para validar os dados do pedido antes de processá-los.
O fluxo de trabalho pai tem três nós:
- Solicitação HTTP (
httpRequest1): busca dados de pedidos de uma API externa. - Subfluxo (
validateOrder): valida os dados do pedido e retorna um resultado. - Decisão (
decision1): ramificações com base no resultado da validação.
O subfluxo validateOrder tem um nó, Script (script1), que verifica se os campos necessários estão presentes e se o total do pedido está acima de zero:
const order = $vars.validateOrderStart.output.orderData;
const isValid = order.items.length > 0
&& order.total > 0
&& order.customerId !== undefined;
return { isValid: isValid, reason: isValid ? "OK" : "Missing required fields" };
const order = $vars.validateOrderStart.output.orderData;
const isValid = order.items.length > 0
&& order.total > 0
&& order.customerId !== undefined;
return { isValid: isValid, reason: isValid ? "OK" : "Missing required fields" };
A seção Saídas do nó do subfluxo define uma variável de saída nomeada isValid com o tipo de dados Booleano, e o nó Final dentro do subfluxo mapeia-a para $vars.script1.output.isValid. De volta ao fluxo de trabalho pai, o nó Decisão avalia $vars.validateOrder.output.isValid === true e roteia para um caminho de atendimento ou um caminho de tratamento de erros.
Próximas Etapas
- Variáveis e fluxo de dados: regras de escopo de variáveis, sintaxe de expressão e padrões de acesso
$vars. - A tela Fluxo: a tela, o painel de propriedades e o painel Adicionar nó.
- Tratamento de erros: configuração de identificadores de erros em nós, incluindo subfluxos internos.