UiPath Documentation
maestro
latest
false
Guia do usuário do Maestro Orchestrate
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo. A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.

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.

Observação:

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:

  1. Solicitação HTTP (httpRequest1): busca dados de pedidos de uma API externa.
  2. Subfluxo (validateOrder): valida os dados do pedido e retorna um resultado.
  3. 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​

  • Como funciona​
  • Adicionando um subfluxo​
  • Transmissão de dados​
  • Entradas​
  • Saída​
  • Escopo de variáveis​
  • Exemplo prático​
  • Próximas Etapas​

Esta página foi útil?

Conectar

Precisa de ajuda? Suporte(opens in new window)

Quer aprender? Academia UiPath(opens in new window)

Tem perguntas? Fórum do UiPath(opens in new window)

Fique por dentro das novidades