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

Regras de saída e término do estágio inicial

Regras de Saída no Maestro Case para encerrar estágios antecipadamente quando as condições mudam, incluindo diferenças de Regras de Conclusão e efeitos de roteamento subsequentes.

Público-alvo: Intermediário — Automation Developers, Business Architects e Solution Architects

Visão geral​

No Maestro Case, cada estágio pode terminar em uma de duas maneiras: termina seu trabalho normalmente por meio de uma Regra de Conclusão ou termina antecipadamente por meio de uma Regra de Saída. As Regras de Saída atuam como disjuntores — elas cortam um estágio no momento em que as condições mudam de uma maneira que torna o processamento contínuo desnecessário ou incorreto. Compreender a diferença entre esses dois mecanismos é essencial para criar planos de casos que tratam de fluxos sem exceção e caminhos de exceção com clareza.

O ciclo de vida do estágio em resumo​

Antes de examinar como os estágios terminam, vale a pena entender como eles começam e progridem. Cada estágio em um plano de caso é governado por um conjunto de tipos de regras que controlam seu ciclo de vida:

Tipo de RegraPergunta Que Ele Responde
Regra de entradaQuando esse estágio deve ficar ativo?
Regra de ConclusãoQuando esse estágio é concluído?
Regra de saídaQuando esse estágio deve encerrar antecipadamente?
Regra de nova entradaQuando um caso deve retornar aqui para retrabalho?

Um estágio faz a transição de Disponível para Ativo quando sua Regra de entrada resulta como verdadeira.Uma vez ativas, as tarefas do estágio começam a executar de acordo com suas próprias regras de entrada (para tarefas orientadas por eventos) ou sua posição na sequência.O estágio permanece ativo até que a Regra de Conclusão ou a Regra de Saída dispare — a que vier primeiro. Ambos os resultados fazem com que o Gerenciador de caso avalie em qual estágio entrar em seguida, com base na ação da regra.

O que é uma regra de conclusão?​

Uma Regra de Conclusão define a condição de finalização normal para um estágio. Ela dispara quando o estágio realizar o que se destina a fazer.Na maioria dos casos, a Regra de Conclusão avalia se todas as tarefas necessárias terminaram e produziram saída válida.

Pense na Regra de Conclusão como a resposta para: "Esse estágio fez seu trabalho?"

Uma Regra de Conclusão típica se parece com isto:

WHEN event("AllRequiredTasksDone")
WHEN event("AllRequiredTasksDone")

Ou, para estágios em que um resultado de dados específico é importante:

WHEN event("AdjusterDecisionMade")
  IF adjusterDecision != null
WHEN event("AdjusterDecisionMade")
  IF adjusterDecision != null

Quando uma Regra de Conclusão dispara:

  • O estágio faz a transição para um estado Concluído.
  • Todas as saídas de tarefas são preservadas na Entidade de Caso [Em Breve].
  • O Gerenciador de Caso aplica a ação da regra (avançar de acordo com a regra de entrada do próximo estágio, aguardar a seleção manual, retornar à origem ou concluir o caso) e avalia as regras de entrada para estágios subsequentes.

Regras de Conclusão representam o resultado esperado e projetado. A etapa rodou, o trabalho aconteceu e o Resultado está pronto para o que vier em seguida.

O que é uma regra de saída — o "disjuntor"?​

Uma Regra de saída define uma condição de término antecipado. Ela dispara quando algo muda no meio do estágio, tornando a continuidade do processamento desnecessária, inválida ou contraproducente.Quando uma Regra de saída dispara, o estágio termina imediatamente — tarefas em execução param, e o estágio termina sem satisfazer sua Regra de Conclusão.

Pense na Regra de Saída como a resposta para: "Mudou alguma coisa que significa que este estágio deve parar agora?"

O termo "disjuntor" captura esse comportamento com precisão. Na engenharia elétrica, um disjuntor corta a energia no instante em que detecta uma condição perigosa — ele não espera que o circuito finalize sua função pretendida.As regras de saída operam da mesma maneira: elas interrompem um estágio no momento em que uma condição torna o processamento adicional errado ou desnecessário.

Uma Regra de saída típica se parece com:

WHEN PolicyCheckCompleted event arrives
  IF policyValid == false
WHEN PolicyCheckCompleted event arrives
  IF policyValid == false

A cláusula WHEN pode ouvir um Evento interno emitido pelo ciclo de vida do caso (uma tarefa sendo concluída, um estágio que entra ou sai de um caso, uma alteração de campo de entidade, um SLA que at-risk ou breached) ou um Evento externo que chega de fora do caso (um Webhook de conector, um disparo de temporizador, um caso filho sendo concluído, uma chamada direta de API). As Regras de saída mais comumente ouvem eventos internos de conclusão de tarefas e atualizações do campo Entidade de caso que essas tarefas produzem.

Quando uma Regra de Saída dispara:

  • O estágio termina imediatamente, independentemente do progresso da tarefa.
  • A execução de tarefas dentro do estágio para. O sistema preserva as Saídas de Tarefa já gravadas na entidade de caso; o sistema registra qualquer tarefa em andamento que ainda não tenha gravado sua saída como Terminada e descarta seu trabalho parcial.
  • O Gerenciador do Caso aplica a ação da regra (o mesmo conjunto que Concluir: concluir ou sair do Caso, aguardar a seleção manual, retornar à origem) e avalia o que fazer em seguida, assim como faria após uma conclusão normal.
  • O caso não termina necessariamente — ele pode seguir para um estágio diferente, um caminho secundário (exceção), ou o Agente do Gerenciador de Casos pode decidir a próxima ação quando nenhuma regra determinística abrange a situação.
  • O sistema registra a saída antecipada na trilha de auditoria do caso: a regra de disparo, o evento WHEN que a disparou, os valores da Entidade do Caso que satisfizeram a cláusula IF, a ação tomada e a lista de tarefas encerradas.A entrada aparece na linha do tempo do Aplicativo do caso e no Gerenciamento de instância do caso.

Como elas diferem​

A comparação a seguir resume a distinção fundamental entre Regras de Conclusão e Regras de Saída:

DimensõesRegra de ConclusãoRegra de saída
FinalidadeMarca o estágio como concluído quando o trabalho terminaEncerra o estágio antecipadamente quando as condições mudam
Quando ele disparaApós as tarefas necessárias terminarem e produzirem uma saída válidaAssim que uma condição monitorada se torna verdadeira, independentemente do progresso da tarefa
Relação com tarefasAguarda a finalização das tarefasNão espera — interrompe tarefas em execução
RepresentaO resultado normal, esperadoUm cenário anormal, condicional ou de atalho
Estado do estágio apósConcluídoEncerrado (saída antecipada)
O que acontece em seguidaO Gerenciador de caso avalia o próximo estágio com base nos dados do casoO Gerenciador de caso avalia o próximo estágio com base nos dados do caso

Ambos os caminhos — conclusão normal e saída antecipada — levam ao mesmo comportamento subsequente: o Gerenciador de caso lê o estado atual da Entidade do caso e determina qual estágio ativar em seguida. A diferença está no por que e quando o estágio terminou, não no que acontece depois.

Observação:

Um único estágio pode ter uma Regra de Conclusão e uma Regra de Saída definidas. No runtime, qualquer condição que se torne verdadeira primeiro determina como o estágio termina. Elas não são mutuamente exclusivas na configuração — eles são mutuamente exclusivas na execução.

Por que as regras de saída são importantes​

Sem Regras de saída, os planos de casos precisariam lidar com cada exceção após um estágio terminar todo o seu trabalho. Isso leva a vários problemas:

  • Esforço desperdiçado. As tarefas continuam em execução mesmo quando seus resultados são irrelevantes. Por exemplo, uma etapa de investigação pode gastar horas ao despachar um inspetor de campo e analisar fotos de um sinistro cuja política o sistema já localizou como inválida.
  • Roteamento atrasado. O caso não pode se mover para o caminho de exceção correto até que o estágio atual seja totalmente concluído, adicionando latência desnecessária à resolução geral do caso.
  • Regras de Conclusão Complexas. Sem um mecanismo de saída separado, a Regra de Conclusão deve levar em conta tanto términos normais quanto anormais, dificultando a leitura, manutenção e depuração.

As Regras de Saída resolvem esses problemas separando o sinal "concluído" do sinal "parar". A Regra de conclusão permanece simples — ela descreve o sucesso. A Regra de saída descreve as condições sob as quais o sucesso não é mais possível ou relevante.

Estágios necessários e saída antecipada​

Um estágio marcado como Obrigatório deve terminar em um estado Concluído para o caso satisfazer a uma regra normal de Conclusão de caso. Quando uma regra de saída dispara em um estágio obrigatório, o estágio termina em um estado Encerrado — não Concluído — para que ele não contribua para a verificação "Todos os estágios obrigatórios concluídos".

Isso significa que uma Regra de saída em um estágio obrigatório deve sempre emparelhar com um dos seguintes, caso contrário, o caso ficará preso (estágio obrigatório nunca concluído, nenhum estágio subsequente configurado para pegá-lo):

EmparelhamentoComo funcionaQuando usar
O estágio subsequente assume o controleA Regra de entrada de um estágio separado dispara no mesmo evento (geralmente um estágio secundário com interrupting = true) e conduz o Caso para o encerramento. A Regra de saída apenas interrompe o trabalho desperdiçado.Maioria dos caminhos de exceção — por exemplo, Negado, Retenção de fraude, Retirado. O caso continua, ele apenas continua em outro lugar.
Ação da Regra de saída = Sair do casoA ação da Regra de saída encerra o caso diretamente. Nenhum estágio subsequente é necessário.A saída antecipada significa que o Caso não tem continuação significativa — por exemplo, a Política é inválida, o solicitante se retirou ou a fraude foi confirmada.

Para um estágio opcional, uma saída antecipada é adequada por si só — o caso ainda pode ser concluído sem ela.

Padrões de regras de saída comuns​

A base de conhecimento e o material do curso L300 descrevem vários padrões recorrentes em que as Regras de saída fornecem valor significativo.

Padrão 1: pré-condição inválida​

Uma tarefa no início do estágio descobre que uma pré-condição fundamental é falsa. Não há motivo para executar as tarefas restantes.

Exemplo — estágio de Recebimento do FNOL:

WHEN PolicyCheckCompleted event arrives
  IF policyValid == false
  ACTION Exit the case
WHEN PolicyCheckCompleted event arrives
  IF policyValid == false
  ACTION Exit the case

Se a política do solicitante for inválida, não há necessidade de extrair detalhes do sinistro ou criar um número do sinistro. A Regra de Saída encerra o estágio de Entrada imediatamente.Como a política é inválida, o caso não tem continuação significativa, então a ação é Sair do caso — o caso termina e um gancho de fechamento subsequente pode enviar a notificação de negação.

Padrão 2: rejeição no meio do estágio​

Uma tarefa de tomada de decisão dentro do estágio produz um resultado negativo que invalida a finalidade do estágio.

Exemplo — Estágio de avaliação:

WHEN AdjusterDecisionMade event arrives
  IF adjusterDecision == "deny"
  ACTION advance
WHEN AdjusterDecisionMade event arrives
  IF adjusterDecision == "deny"
  ACTION advance

Se o regulador negar o sinistro durante o estágio de Avaliação, o estágio de Liquidação nunca deve ficar ativo. A Regra de saída encerra a Avaliação antecipadamente. A ação é avançar — o mesmo evento atinge a regra de entrada do estágio secundário Negado (que dispara em adjusterDecision == "deny", interrupting = true por padrão), e Negado assume o controle para enviar notificação e fechar o caso.

Padrão 3: detecção de fraude ou risco​

Uma verificação automatizada descobre um sinal de risco de alta gravidade que exige escalonamento imediato, ignorando a conclusão normal do estágio.

Exemplo — Estágio de investigação:

WHEN FraudCheckCompleted event arrives
  IF fraudScore > 0.9
  ACTION advance
WHEN FraudCheckCompleted event arrives
  IF fraudScore > 0.9
  ACTION advance

Uma pontuação de fraude acima do limite significa que o caso deve sair do estágio de Investigação imediatamente. A ação é Avançar — um estágio secundário de Retenção de fraude (interrupting = true) fica ativo no mesmo evento e assume o caso. Esperar a conclusão da inspeção de campo ou a recuperação do relatório policial desperdiçaria tempo e recursos.

Padrão 4: atalho de caminho rápido​

Nem todas as saídas antecipadas são negativas. Uma Regra de saída também pode acelerar o processamento quando os dados mostram que as tarefas restantes são desnecessárias.

Exemplo — estágio de revisão:

WHEN ValidationComplete event arrives
  IF totalAmount < 500 AND validationResult.status == "pass"
  ACTION advance
WHEN ValidationComplete event arrives
  IF totalAmount < 500 AND validationResult.status == "pass"
  ACTION advance

Um envio limpo e de baixo valor não precisa do estágio de revisão completa. A Regra de saída causa curto-circuito no estágio; a ação é Avançar para que o caso prossiga diretamente para a próxima fase no fluxo primário.Esse padrão reduz o tempo do ciclo para casos simples sem remover o estágio Revisão do Plano para casos que precisam dele.

Padrão 5: falha do sistema externo​

Uma tarefa de integração falha de uma maneira que significa que o estágio não pode produzir um resultado significativo.

Exemplo — Estágio de liquidação:

WHEN PaymentProcessed event arrives
  IF paymentFailed == true
  ACTION Wait for manual selection
WHEN PaymentProcessed event arrives
  IF paymentFailed == true
  ACTION Wait for manual selection

Se o sistema de pagamento rejeitar a transação, continuar com a notificação do solicitante (que faria referência a um pagamento bem-sucedido) estará incorreto. A Regra de Saída interrompe o estágio; a ação é Aguardar a seleção manual para que um operador de processo possa escolher o caminho de recuperação — um estágio de tentar pagamento novamente, um canal de pagamento alternativo ou um caminho de resolução manual.

Como as regras de saída interagem com o gerenciador de casos​

Quando uma Regra de Saída dispara, o Gerenciador de caso assume o controle. Seu comportamento depende do mesmo mecanismo que ele usa após qualquer estágio terminar: ele aplica a ação da Regra de Saída, avalia o estado atual da Entidade de caso [em breve] e determina em qual estágio entrar em seguida.

Isso significa que as Regras de Saída não precisam especificar aonde o caso vai — elas especificam apenas quando o estágio para (e a ação descreve a intenção de alto nível: avançar, aguardar o usuário, retornar à origem ou encerrar o caso). A lógica de roteamento reside nas Regras de Entrada dos estágios subsequentes e na lógica de orquestração do Gerenciador de caso (regras determinísticas primeiro, raciocínio do Agente do gerenciador de caso como alternativa).

Por exemplo, quando o estágio de Avaliação sai cedo devido a uma negação:

  1. A Regra de Saída do estágio de Avaliação dispara — WHEN o evento AdjusterDecisionMade chega IF adjusterDecision == "deny". O estágio termina e as tarefas em execução param.
  2. O mesmo evento AdjusterDecisionMade atinge todas as outras regras cuja condição WHEN corresponde a ele. A Regra de Entrada do estágio secundário Negado — WHEN AdjusterDecisionMade chega IF adjusterDecision == "deny" — resulta em verdadeiro e ativa o estágio.Como Negado é um estágio secundário, sua regra de entrada tem o valor padrão de interrupting = true, para que quaisquer outros estágios ativos sejam retirados.
  3. O estágio Negado executa suas tarefas (enviar pacote de negação, gerar relatório de auditoria). Quando todas as tarefas necessárias terminam, o caso fecha por meio de uma regra de Caso Concluído.

Essa separação de preocupações — Regras de Saída definem quando parar, Regras de Entrada definem quando começar — mantém o plano de caso modular e de fácil manutenção. Cada estágio precisa conhecer apenas suas próprias regras, não o gráfico de roteamento completo.O Gerenciador de caso nunca pesquisa a Entidade do caso: cada regra é orientada por eventos e avalia apenas quando seu Evento WHEN chega.

Observação:

O Agente do gerenciador de caso serve como uma alternativa quando nenhuma regra determinística cobre a situação após uma saída antecipada. Se a Regra de Saída for acionada sob circunstâncias inesperadas e nenhuma Regra de Entrada subsequente corresponder, o agente raciocina sobre os dados da Entidade do caso e políticas configuradas para decidir a próxima ação — ou escalona para um humano se não puder determinar o caminho correto.

Observação:

As Regras de Saída são apenas de estágio. As tarefas têm apenas uma Regra de Entrada — não há Regra de Conclusão ou Saída no nível de tarefa. A conclusão de uma tarefa é determinada pelo trabalho subjacente (formulário enviado, agente finalizado, RPA retornado etc.). Para parar o trabalho no meio do estágio, defina a Regra de Saída no próprio estágio; ela encerra todas as tarefas em execução dentro do estágio.

Diretrizes de design​

Ao incorporar Regras de Saída em um plano de caso, considere os seguintes princípios:

  • Mantenha as Regras de Conclusão simples. Uma Regra de Conclusão deve descrever o caminho sem exceção: "todas as tarefas necessárias são concluídas" ou "a decisão esperada foi tomada". Não incorpore a lógica de exceção na Regra de Conclusão.
  • Use Regras de Saída para o excepcional. Reserve Regras de Saída para condições que genuinamente invalidam o processamento continuado. Nem toda ramificação condicional precisa de uma Regra de Saída — algumas condições são mais bem tratadas pela lógica de roteamento do Gerenciador de Caso após a conclusão normal.
  • Monitore saídas upstream. As Regras de Saída normalmente avaliam campos gravados por tarefas anteriormente no estágio.Projete seu esquema de Entidade de Caso para que tarefas específicas e identificáveis gravem os campos que uma Regra de Saída monitora.
  • Emparelhe Regras de Saída com Regras de Entrada subsequentes. Uma Regra de Saída interrompe o processamento; uma Regra de Entrada subsequente captura o caso e o roteia para o caminho correto. Projete-os em pares para evitar casos que encerram um estágio, mas não têm para onde ir.
  • Documente a intenção.As Regras de Saída são poderosas, mas podem ser surpreendentes para alguém que lê um plano de caso pela primeira vez.Use nomes claros e comentários para indicar por que cada Regra de Saída existe e qual cenário ela aborda.

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