Utilize o nó TryCatch para fornecer um manipulador especial para processamento de exceções.
Este tópico contém as seguintes seções:
Inicialmente, a mensagem de entrada é roteada no terminal Try, que você deve conectar aos nós de processamento sem erro restantes do fluxo de mensagens. Se um nó de recebimento de dados (que pode ser um nó Throw) emitir uma exceção, o nó TryCatch a capturará e roteará a mensagem original para seu terminal Catch. Conecte o terminal Catch a nós adicionais para fornecer processamento de erro para a mensagem após uma exceção. Se o terminal Catch estiver conectado, a mensagem será propagada para ele. Se o terminal Catch não estiver conectado, a mensagem será descartada.
O nó TryCatch está contido no repositório Construção da paleta e é representado no ambiente de trabalho pelo seguinte ícone:
Utilize os nós Throw e TryCatch quando utilizar o nó Compute para calcular um total. Você pode criar uma mensagem que seja enviada ao administrador do sistema quando o total calculado exceder o valor máximo do campo Total.
O nó TryCatch não possui propriedades configuráveis que afetam sua operação. Você determina como ele opera, conectando os terminais de saída aos nós subseqüentes em seu fluxo de mensagens.
Quando for emitida uma exceção no fluxo de mensagens, pela utilização explícita do nó Throw ou pela instrução ESQL THROW ou pelo intermediário que gera uma exceção implícita quando detecta um erro que o fluxo de mensagens não está programado para manipular, o controle retorna ao nó TryCatch.
A mensagem é propagada através do terminal Catch e o tratamento de erros projetado é executado. A mensagem que é propagada através desse terminal possui o conteúdo que possuía no ponto em que a exceção foi emitida, incluindo a descrição completa da exceção em Lista de Exceção.
Quando tiver colocado uma instância do nó TryCatch em um fluxo de mensagens, você poderá configurá-lo; consulte Configurando um Nó do Fluxo de Mensagens. As propriedades do nó são exibidas na visualização Propriedades. Para exibir as propriedades do nó no diálogo Propriedades, dê um clique duplo no nó ou clique com o botão direito no nó e clique em Propriedades.
Os terminais do nó TryCatch são descritos na tabela a seguir.
Terminal | Descrição |
---|---|
Entrada | O terminal de entrada que aceita a mensagem para processamento pelo nó. |
Catch | O terminal de saída para o qual a mensagem será propagada se for emitida uma exceção downstream e capturada por esse nó. |
Teste | O terminal de saída para o qual a mensagem será propagada se não for capturada. |
A tabela a seguir descreve as propriedades do nó. A coluna com cabeçalho M indica se a propriedade é obrigatória (marcada com um asterisco caso seja necessário digitar um valor quando nenhum padrão for definido); a coluna com cabeçalho C indica se a propriedade é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens ao arquivo BAR para implementá-lo).
As propriedades Descrição do nó TryCatch são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Nome do Nó | Não | Não | O tipo de nó: TryCatch | O nome do nó. |
Descrição Breve | Não | Não | Uma breve descrição do nó. | |
Descrição Longa | Não | Não | Texto que descreve a finalidade do nó no fluxo de mensagens. |