On Exception

A ferramenta On Exception é um step que executa rotas alternativas quando houver erros que não retornem um status code. Desta forma, a execução do fluxo de integração não é interrompida.

A seguir, aprenda a adicioná-lo ao canvas e a configurar o seu formulário.

Adicione o On Exception ao canvas

  1. Clique no ícone ícone de ferramenta com sinal de mais no menu de edição à esquerda.

  2. Selecione o On Exception para adicioná-lo ao canvas. Você pode usar a barra de pesquisa search steps icon para encontrá-lo.

    Você pode adicionar o On Exception mais de uma vez. Nesse caso, cada vez que a ferramenta é adicionada, um número é acrescentado ao lado do nome (On Exception 1, On Exception 2, On Exception 3).

  3. Conecte o On Exception à conexão de saída de um step e adicione steps posteriores para criar um fluxo de exceção.

A conexão entre o On Exception e o step imediatamente anterior a ele ficará com a linha pontilhada para diferenciar o fluxo de exceção do fluxo principal. Ao passar o mouse sobre este step, aparecerá uma tooltip indicando que é um fluxo de exceção (Exception flow).

Regras gerais de conexão do On Exception

  • O On Exception indica o início do fluxo de exceção e obrigatoriamente se conecta à conexão de saída de um connector.

  • O On Exception poderá ter mais de uma conexão de entrada. Isso quer dizer que diferentes connectors podem executar o mesmo fluxo de exceção.

  • O On Exception poderá ter apenas uma conexão de saída.

  • O Rest API Connector poderá estar conectado a apenas um On Exception.

  • É obrigatório conectar o fluxo de exceção ao step End do fluxo principal.

  • Caso você exclua a linha de conexão entre o On Exception e outro step, verá o ícone de alerta no On Exception.

Fluxo de exceção dentro do For Each

Você pode criar um fluxo de exceção com o On Exception dentro do For Each.

Neste caso, as seguintes regras se aplicam:

For Each Rest API On Exception

"Ignore Errors" habilitado →

"Ignore Errors" desabilitado →

será executado e seguirá para a próxima iteração

"Ignore Errors" desabilitado →

"Ignore Errors" desabilitado →

será executado e NÃO seguirá para a próxima iteração

"Ignore Errors" habilitado →

"Ignore Errors" habilitado →

NÃO será executado e NÃO seguirá para a próxima iteração

Configure o formulário

  1. Selecione o On Exception no canvas.

  2. Clique no ícone de edição icone lapis.

  3. Preencha os seguintes campos:

    • Name: insira um nome único para o step. Por padrão, você verá "On Exception". Campo alfanumérico com limite de 20 caracteres. Caracteres especiais e espaços em branco não são permitidos.

    • Exception: selecione as exceções para a execução da rota alternativa. Para excluir alguma exceção, deverá selecionar uma a uma.

      Para excluir todas as exceções selecionadas, clique no X, à direita das exceções selecionadas.
      Table 1. Lista de exceções

      Network Errors - Connection Timeout

      Network Errors - Socket Error

      DNS Resolution Error - Host Not Found

      SSL/TLS Errors - SSL Handshake Failure

      Timeout Errors - Read/ Write Timeout

      General Exception

    • Retry interval (ms): adicione o intervalo de tempo entre as retentativas, em milissegundos. O intervalo padrão é de 5000ms e o intervalo máximo é de 30000ms.

    • Retry Quantity: adicione a quantidade de retentativas. A quantidade padrão é de 2 retentativas e a quantidade máxima é de 5 retentativas.

      Preencha os campos Retry interval (ms) e Retry Quantity com informações de steps anteriores ou variáveis de ambiente e acesse a tela Expression Builder, clicando em Properties um caderno com um sinal de visto.

      O componente Expression Builder expression builder icon permite que você crie expressões com parâmetros e variáveis através de funções e condições disponíveis dentro do componente. Assim, você pode ajustar a expressão conforme suas necessidades.

  4. Ao finalizar a configuração do formulário, clique em CONFIRM.

on exception

Para copiar o step On Exception e suas configurações, clique no ícone da ferramenta no canvas e clique no botão ícone copiar, à direita.

Para excluir o On Exception do canvas, selecione-o e clique no botão icone lixeira.

Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]