- Introdução
- Criar
- Adicione um agente de IA a um fluxo de trabalho
- Chamar uma API externa
- Processar e-mails de entrada
- Crie um fluxo de trabalho de notificação do Slack
- Adicione aprovação humana a um fluxo de trabalho
- Crie um fluxo de trabalho de agente de chat
- Tratar erros
- Noções básicas de depuração
- Intervenção humana: escalonamento ou etapa humana
- Avaliando seus fluxos de trabalho
- HTTP Request
- Como os nós de conector funcionam
- Criar uma conexão
- Vendas e relacionamentos com clientes
- Suporte ao cliente e suporte técnico
- Mensagens e reuniões
- Email
- Marketing
- Mídias sociais
- Arquivos, documentos e assinatura eletrônica
- Projetos, colaboração e código
- Pessoas e recurso
- Finanças e comércio
- Modelos e agentes de IA
- Fala, visão e idioma
- Dados e localização
- Cloud, identidade e segurança
- Implantar e executar
- Exemplos
- 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.
- Comunidade: faça perguntas e compartilhe fluxos de trabalho com outros construtores no Fórum da UiPath.