UiPath Documentation
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.

Guia do usuário do Maestro

Última atualização 12 de mai de 2026

Configuração de propriedades e dados

Configurar o que acontece no Runtime / runtime.

Configurar propriedades é como você faz seu processo ser executado. É onde seu diagrama BPMN se torna um fluxo de trabalho executável. Cada evento, tarefa ou gateway no Maestro tem propriedades de Runtime / runtime que definem o que ele faz, quais dados ele usa e o que acontece a seguir.

Use o painel Propriedades para conectar seu processo a automações, agentes ou APIs e o Gerenciador de dados para lidar com variáveis e mapeamentos.Juntos, eles controlam como as informações se movem pelo seu processo.

Início rápido: configurar qualquer elemento

  1. Selecionar um elemento na tela.

  2. Abra o painel Propriedades usando o ícone de chave no canto superior direito.

  3. Em Implementação, escolha uma ação, por exemplo, Iniciar e aguardar o fluxo de trabalho de RPA.

  4. Adicione ou selecione Entradas e Saídas para passar dados entre etapas.

  5. Revise variáveis no Gerenciador de dados e teste sua configuração.

    Dica:

    Você pode testar sua configuração instantaneamente com Debug ou Simulate antes de publicar.

    Seções-chave no painel de propriedades

SeçãoFinalidade
GeralDefina o nome do elemento, descrição e ID do sistema.
ImplementaçãoEscolha a ação de Runtime / runtime (por exemplo, chame uma automação, agente ou conector).
Entradas / SaídasMapear variáveis, expressões ou campos do Data Fabric usados pelo element.
XMLInspecione o XML BPMN bruto (para usuários avançados ou suporte).

Observação:

Se você quiser saber os elementos compatíveis no XML do BPMN, consulte Especificação do BPMN - Modelo de processo de negócios e Notation.

AVISO:

Não edite o atributo bpmn:process id no XML. Esse atributo é a chave primária para identificação de diagrama — modificá-lo interrompe todas as referências do diagrama e causa o erro No diagrams found in the BPMN file. Para recuperar um processo corrompido, você deve restaurá-lo a partir de um instantâneo (Controle de versão) ou de uma cópia salva localmente; não existe nenhum caminho de recuperação de autoatendimento sem um.

Observação:

A configuração de Iniciar entradas de evento e Terminar saídas de evento permite que você preencha Argumentos de entrada ao iniciar o processo a partir da interface do Orchestrator ou da API. Isso também permite que você retorne a saída em quaisquer fontes mencionadas acima.

NovasTentativas no nível do elemento

NovasTentativas no nível de elemento permitem que você defina como o Maestro deve tentar novamente automaticamente uma falha no nível de tarefa antes de marcá-la como com falha.Use essa funcionalidade para lidar com problemas temporários sem intervenção manual.

Por que usá-lo?

Quando uma tarefa falha, o Maestro pode executá-la novamente com base em uma estratégia de nova tentativa que você define no painel Propriedades.Isso ajuda a estabilizar processos de longa duração absorvendo erros transitórios e dando aos sistemas dependentes tempo para se recuperar.

Como configurar NovasTentativas

  1. Selecionar um elemento de tarefa (por exemplo, Tarefa de serviço).
  2. No painel Propriedades, expanda Tratamento de erros → NovasTentativas no nível de elemento.
  3. Ative TentarNovamenteEmCasoDeFalha.
  4. Escolha ou edite os Parâmetros da Estratégia de tentar novamente:
    • Máx. de NovasTentativas: número de NovasTentativas antes que a Tarefa falhe permanentemente.
    • Atraso inicial: período para esperar antes da primeira nova tentativa (Duração ISO 8601, por exemplo PT1S).
    • Tipo de retrocesso: Estático, Linear ou Exponencial.
    • Base exponencial: (opcional) aplicado quando Retirada exponencial é selecionada.
    • Máx. Duração: (opcional) atraso máximo entre NovasTentativas.
    • Tentar novamente em rros: escolha quais erros devem disparar NovasTentativas (por exemplo, Todos).
Observação:

Novas tentativas no nível do elemento aplicam-se apenas a tarefas executáveis (por exemplo, Serviço, Agente, Fluxo de trabalho da API, Item da fila). Elas não estão disponíveis para gateways ou elementos de captura de eventos.

Gerenciador de Dados

O Gerenciador de dados centraliza cada variável, argumento e origem de dados em seu processo.

  • Defina entradas e saídas uma vez e, em seguida, reuse-as em tarefas.

  • Visualize estruturas de dados das cargas do Data Fabric ou conector.

  • Valide e teste expressões antes da implantação.

Dica:

Mantenha os nomes de variáveis significativos (por exemplo, InvoiceId, ApprovalStatus) para simplificar a depuração e o monitoramento posteriormente.

Observação:

A configuração de Iniciar entradas de evento e Terminar saídas de evento permite que você preencha Argumentos de entrada ao iniciar o processo a partir da interface do Orchestrator ou da API. Isso também permite que você retorne a saída em quaisquer fontes mencionadas acima.

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