Pular para o conteúdo principal

Exceção de Fluxo de Trabalho

Configuração atual da tarefa `Workflow Exception` no Workflow Designer

Dentro de um fluxo de trabalho, a tarefa Exceção de Fluxo de Trabalho atua como um gestor centralizado para todas as anomalias e erros que podem ocorrer durante a execução do fluxo. Em outras palavras, todas as condições de saída do tipo "Exceção" provenientes de várias tarefas podem ser conectadas a esta única tarefa especial.

Como o nome e o ícone sugerem, esta tarefa representa um ponto terminal para os caminhos do fluxo de trabalho que encontraram um erro não tratado.

Funcionamento

O princípio de funcionamento da "Exceção de Fluxo de Trabalho" é o de centralizar o tratamento de erros. Em vez de definir um caminho de erro específico para cada tarefa que possa falhar, é possível fazer convergir todas as possíveis exceções para este único ponto.

Características Principais:

  • Centralização de Erros: Recolhe todas as condições do tipo "Exception" definidas nas várias tarefas do fluxo de trabalho. Isto simplifica a lógica do diagrama, evitando ter múltiplos ramos de tratamento de erros espalhados pelo fluxo.
  • Sem Configuração: A tarefa "Exceção de Fluxo de Trabalho" não é configurável. A sua única função é "capturar" as exceções e terminar esse caminho do fluxo de trabalho, sinalizando que ocorreu um problema.

Exemplo Prático

No diagrama mostrado:

  1. O fluxo de trabalho começa com a tarefa "Importar texto".
  2. Se a importação do texto for bem-sucedida, o fluxo prossegue através da "Condição 72" para a tarefa "E-Mail Out v.2".
  3. Se, por qualquer motivo, a tarefa "Importar texto" falhar (por exemplo, o ficheiro não for encontrado), é ativada a sua condição de saída do tipo "Exceção".
  4. Esta condição está ligada diretamente à tarefa "Exceção de Fluxo de Trabalho".
  5. Consequentemente, a execução desse ramo específico do fluxo de trabalho é interrompida e registada como falhada, sem que qualquer e-mail seja enviado.

Em resumo, a tarefa "Exceção de Fluxo de Trabalho" é um elemento fundamental para a criação de fluxos de trabalho robustos, pois fornece um mecanismo simples e visual para gerir e identificar falhas durante a execução dos processos.

Além disso, é possível iniciar um novo ramo do fluxo. Este caminho é especificamente pensado para o tratamento de erros. Como mostrado na imagem, é possível conectar uma tarefa subsequente (por exemplo, uma tarefa de envio de e-mail como "mail_exception") para notificar os administradores ou utilizadores de que ocorreu um problema.

Parâmetros de Saída

Estes parâmetros podem ser utilizados nas tarefas subsequentes (como no corpo de um e-mail) para fornecer um relatório detalhado e contextualizado do erro.

A partir de "Lista de Parâmetros" podem ser utilizados os seguintes parâmetros:

  • result: O resultado geral da exceção (ex: “A exceção lançada pela tarefa Importar texto foi tratada”).
  • exceptionMessage: A mensagem de erro específica devolvida pela tarefa falhada. É o parâmetro mais útil para entender a natureza do problema (ex: "Ficheiro não encontrado", "Conexão com o base de dados falhou", etc.).
  • failedTaskName: O nome da tarefa que gerou o erro.
  • failedTaskId: O identificador único (ID) da tarefa que gerou o erro.
  • failedTaskType: O tipo de tarefa que gerou o erro (ex: "Importar texto", "Consulta de base de dados", etc.).