Adicione um manipulador de erros a um fluxo

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • Execute uma sequência de ações e subfluxos de Workflow Studio para identificar e corrigir problemas que foram causados por erros de fluxo.

    Antes de Iniciar

    Função necessária: flow_designer ou administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Um manipulador de erros de fluxo permite que seu fluxo detecte um erro e execute um conjunto de ações, opções de lógica de fluxo e subfluxos.
    Importante:
    Um manipulador de erros de fluxo não pode retomar ou reiniciar um fluxo que produz um erro.

    Procedimento

    1. Navegar até Tudo > Automação de Processo > Flow Designer.
    2. Crie um fluxo ou abra um fluxo existente.
      Para obter mais informações sobre como criar um fluxo, consulte Crie um fluxo em Workflow Studio.
    3. Habilite o comutador DO MANIPULADOR DE ERROS.
      Workflow Studio Adiciona uma seção de manipulador de erros ao fluxo e ao painel de dados.
    4. Adicione ações, opções de lógica de fluxo ou subfluxos à seção Manipulador de erros.
      Você pode adicionar até 10 ações, opções de lógica de fluxo ou subfluxos a esta seção. Considere o uso de um subfluxo para capturar as informações de erro ou corrigir problemas com os dados do registro.
      Você pode adicionar opções de lógica de fluxo ao manipulador de erros. Essas opções são descritas na tabela a seguir.
      Tabela 1. Opções de lógica de fluxo compatíveis
      Opção de lógica de fluxo Descrição
      Se Aplique de forma seletiva uma ou mais ações somente quando uma lista de condições for atendida. Para obter mais informações, consulte Se .
      Esperar por uma duração de tempo Use esta opção de lógica de fluxo para pausar o fluxo por um período de tempo especificado e retomar a execução do fluxo após o término do período. Para obter mais informações, consulte Aguarde um período de tempo .
      Encerrar fluxo Use esta opção de lógica de fluxo para interromper um fluxo no Workflow Studio. Para obter mais informações, consulte Fluxo final .
      Fluxo Dinâmico Identifique e execute um fluxo ou subfluxo dinamicamente usando dados do tempo de execução. Crie modelos para fornecer entradas esperadas para fluxos ou subfluxos chamados dinamicamente. Para obter mais informações, consulte Fluxo dinâmico .
      Definir variáveis de fluxo Atribua um valor a uma ou mais variáveis de fluxo. Mude ou atualize o valor de uma variável durante um fluxo. Para obter mais informações, consulte Variáveis de fluxo definidas .

      O objeto Status do erro contém as informações sobre o erro de fluxo. Você também pode usar o objeto Status da ação que é retornado por cada ação para criar a lógica condicional. Esses objetos estão disponíveis no painel Dados.

    5. Opcional: Adicione fases no Manipulador de erros.
      Para obter mais informações sobre como adicionar fases, consulte Configure fases e adicione-as a um fluxo.
    6. Adicione uma ação personalizada ao corpo principal do fluxo que gera um erro.
      Para saber como criar uma ação personalizada, consulte Crie uma ação personalizada para lançar um erro.
    7. Teste seu fluxo para garantir que o manipulador de erros funcione conforme o esperado.
      Para obter mais informações sobre como testar um fluxo, consulte Teste seu fluxo .
    8. Quando o tratamento de erros de fluxo estiver funcionando conforme o esperado, selecione o ícone de exclusão ao lado da ação personalizada que gera um erro para removê-lo do fluxo.

    Resultado

    Seu fluxo executa as ações, as opções de lógica de fluxo e os subfluxos especificados quando o fluxo produz um erro. Os detalhes da execução do fluxo exibem o estado Concluído (erro detectado) para o fluxo e a ação que retornou um erro.