maestro
latest
false
Importante :
A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.
UiPath logo, featuring letters U and I in white

Guia do usuário do Maestro

Última atualização 30 de mar de 2026

Subprocessos e modularidade

Os subprocessos oferecem suporte à clareza do modelo agrupando atividades relacionadas em uma única estrutura reutilizável. Eles ajudam a reduzir a complexidade do diagrama, isolar a lógica de negócios e incentivar a reutilização.

No BPMN, um subprocesso pode ser modelado em linha (recolhido ou expandido dentro do mesmo diagrama) ou como uma atividade de chamada reutilizável.

No Maestro:

  • Os subprocessos em linha (recolhidos ou expandidos) são compatíveis para agrupamento e estruturação de lógica dentro do mesmo diagrama.
  • As atividades de chamada são compatíveis para invocar um processo com agente separado (projeto).
  • Não é possível chamar um arquivo BPMN diferente do mesmo projeto.Para lógica de processos cruzados reutilizáveis, crie um processo com agente separado e invoque-o usando uma Atividade de chamada.
  • Ao usar uma Atividade de chamada, o processo de chamada passa entrada e recebe saída por meio de parâmetros definidos explicitamente.

Por que usar atividades de chamada?

Uma atividade de chamada faz referência a um subprocesso definido em outro lugar do projeto ou ambiente. Comporta-se como uma função reutilizável. Atividades de chamada melhoram a modelagem de processos por:

  • Reduzindo a duplicação entre diagramas
  • Isolar lógica reutilizável (por exemplo, aprovações, validações, despacho)
  • Mantendo o diagrama principal conciso
  • Suporte a comportamento consistente entre variantes de processo.

Como modelar subprocessos

No Maestro, você pode modelar subprocessos de duas maneiras:

  • Como um subprocesso em linha (recolhido ou expandido dentro do mesmo diagrama)
  • Como um subprocesso reutilizável usando uma Atividade de chamada

Modelar um subprocesso em linha

Use um subprocesso em linha quando quiser agrupar etapas relacionadas dentro da mesma instância de processo.

  1. Insira um elemento Subprocesso em seu diagrama BPMN.
  2. Escolha se deseja exibi-lo em visualização recolhida ou expandida.
  3. Modele a lógica interna diretamente dentro do subprocesso.
  4. Use o subprocesso para agrupar etapas relacionadas enquanto mantém o diagrama principal legível.

Os subprocessos em linha são executados dentro da mesma instância de processo e compartilham o mesmo contexto de execução.

Variáveis em subprocessos

Ao trabalhar com subprocessos, as variáveis se comportam de maneira diferente dependendo se o subprocesso está recolhido ou expandido:

Subprocessos recolhidos: os elementos internos são ocultos, mas suas variáveis de saída estão acessíveis no escopo pai por meio do seletor de variáveis. Isso permite que as tarefas downstream façam referência às saídas do subprocesso sem expandir o subprocesso.

Subprocessos expandidos: todos os elementos e variáveis são visíveis. As variáveis permanecem com escopo no nível do subprocesso, mas ainda estão disponíveis para escopos pai e irmãos.

Movimentação de nós entre escopos: quando você move um nó que contém saídas para dentro ou para fora de um subprocesso, o Maestro preserva IDs de variáveis e gerencia transições de escopo automaticamente. As referências de variáveis permanecem válidas entre os limites do escopo e as entradas órfãs são removidas automaticamente.

Se você encontrar erros de validação depois de mover nós entre escopos, use a caixa de diálogo Corrigir variáveis para identificar e atualizar quaisquer referências quebradas.

Modelar um subprocesso reutilizável usando uma Atividade de chamada

Use uma Atividade de chamada quando quiser reutilizar a lógica em vários processos.

  1. Crie um Processo com agente (projeto) separado que contenha a lógica reutilizável.
  2. No diagrama pai, insira uma Atividade de chamada.
  3. Selecione o processo com agente de destino para invocar.
  4. Configure variáveis de entrada e saída para trocar dados entre o processo pai e o processo chamado.

Uma Atividade de chamada invoca uma instância de processo com agente separada. Os dados devem ser mapeados explicitamente entre o pai e os processos chamados.

Exemplos de modelagem

Caso de uso: um fluxo de trabalho de integração usa o mesmo subprocesso Collect Documents nos processos de integração de funcionários e fornecedores. Em vez de duplicar etapas, uma atividade de chamada é adicionada em cada processo pai fazendo referência ao mesmo subprocesso.

subprocesso-exemplo

Caso de uso: este exemplo de subprocesso mostra um fluxo de trabalho condicional de download e upload de arquivos no Maestro. O processo começa com um evento de início de mensagem e se ramifica usando um gateway exclusivo. Dependendo da condição, ele baixa um anexo de e-mail ou um arquivo de um campo de registro. Ambos os caminhos convergem para uma tarefa Carregar arquivo, seguida por um elemento SubProcess chamado Sub-Process1. Esse subprocesso encapsula etapas adicionais relacionadas às ações pós-upload antes de concluir o fluxo de trabalho no evento final.

Subprocesso

Convenções de Nomes

Os nomes dos subprocessos e atividades de chamada devem:

  • Use linguagem de negócios, não termos técnicos
  • Descreva o resultado (por exemplo, , não )
  • Refletir o que o subprocesso realiza, não o modo como.
  • As faixas de participante não são compatíveis dentro de subprocessos.

Não Compatível

  • A chamada de um arquivo BPMN separado dentro do mesmo projeto não é compatível.
  • Para lógica reutilizável em vários processos, crie um processo com agente separado (projeto) e invoque-o usando uma Atividade de chamada.
  • Os subprocessos ad-hoc não são compatíveis.
  • O compartilhamento de variáveis implícitas em limites de processos não é compatível. Os dados devem ser mapeados explicitamente por meio de mapeamentos de entrada/saída.
  • As faixas de participante não são compatíveis dentro de subprocessos.

Marcadores de várias instâncias

Os subprocessos em linha são compatíveis com a execução de várias instâncias.

As Atividades de chamada também são compatíveis com a execução de várias instâncias ao invocar um processo com agente separado.

Subprocessos ad-hoc e subprocessos de evento não são compatíveis.

Para obter mais detalhes sobre os elementos BPMN compatíveis com o Maestro, consulte Compatibilidade com BPMN.

Esta página foi útil?

Conectar

Precisa de ajuda? Suporte

Quer aprender? Academia UiPath

Tem perguntas? Fórum do UiPath

Fique por dentro das novidades