Retry

Descubra mais sobre o conector Retry e saiba como utilizá-lo na Digibee Integration Platform.

O Retry permite novas tentativas de execução de passos definidos em um subpipeline.

Parâmetros

Dê uma olhada nos parâmetros de configuração do conector. Parâmetros suportados por expressões Double Braces estão marcados com (DB).

Parâmetro	Descrição	Valor padrão	Tipo de dado
Maximum Number of Retries	Número máximo de tentativas. A primeira tentativa também conta, então se o passo falhar na primeira execução e você deseja que seja feita uma nova tentativa, o valor nesse parâmetro deve ser igual a 2.	3	Inteiro
Timeout Of The Whole Retry Operation	Duração máxima da soma de todas as tentativas, incluindo a primeira (em milissegundos).	30000	Inteiro
Fail On Error	Se a opção for ativada, a execução do Retry que atingir o número máximo de tentativas ou a duração máxima, terminará com erro e será interrompida; do contrário, a execução do pipeline continua, mas o resultado da última tentativa será entregue ao próximo conector.	False	Booleano

Definindo o subpipeline que é executado a cada tentativa

Para trabalhar com esse tipo de conector, é importante levar em consideração:

• Subpipeline definido em onProcess: subpipeline a ser executado a cada nova tentativa.

• Subpipeline definido em onException: subpipeline a ser executado sempre que uma tentativa resultar em falha.

Para entender melhor o funcionamento de subpipelines, leia a documentação Subpipelines.

A cada nova tentativa, o primeiro passo do subpipeline definido em onProcess recebe a mensagem de saída do último passo processado. Portanto, dados a serem reutilizados nas novas tentativas devem ser devidamente tratados para que possam ser acessíveis durante as novas tentativas (exemplo.: manipulação dos dados através de conectores Session).

Informando sucesso para uma execução do conector Retry

O Retry espera que uma propriedade success com o valor true seja informada no último passo do subpipeline para que a execução seja considerada bem sucedida. Se um erro ocorrer ou se a propriedade success for informada com o valor false ou for inexistente, o Retry entenderá que uma nova tentativa deverá ser executada.

Fluxo de mensagens

Entrada

Qualquer estrutura é aceita.

Saída

Mensagem de saída do último passo processado.

Tratamento de Erros

Quando um erro ocorre durante o processamento do subpipeline em onProcess, o subpipeline em onException será invocado se estiver definido.

No onException, é possível:

• ter acesso aos detalhes do erro que ocorreu durante o processamento da última tentativa.

• definir se o Retry continua as tentativas, informando uma propriedade success com o valor false ou não a definindo. Caso a propriedade success seja especificada com o valor true, então o Retry será finalizado com sucesso e nenhuma outra tentativa será executada.

Cenários de utilização do conector Retry com tratamento de erros

Propriedade Fail on Error habilitada e nenhum subpipeline definido em onException

• o pipeline será interrompido após todas as tentativas;

• um erro será emitido a partir do conector Retry;

• nenhum outro conector será invocado após o Retry.

Propriedade Fail on Error habilitada e um subpipeline definido em onException

• o pipeline será interrompido após todas as tentativas;

• o subpipeline definido em onException será executado após cada tentativa;

• um erro será emitido a partir do conector Retry;

• nenhum outro conector será invocado após o Retry.

Propriedade Fail on Error desabilitada e nenhum subpipeline definido em onException

• o pipeline não será interrompido após todas as tentativas;

• nenhum erro será emitido a partir do conector Retry;

• o próximo conector será invocado recebendo a mensagem de saída do Retry.

Propriedade Fail on Error desabilitada e um subpipeline definido em onException

• o pipeline não será interrompido após todas as tentativas;

• o subpipeline definido em onException será executado após cada tentativa;

• nenhum erro será emitido a partir do conector Retry;

• o próximo conector será invocado recebendo a mensagem de saída do Retry.

Caso um conector de erro (como Throw Error ou Assert) seja utilizado dentro do subpipeline em onProcess, ou um erro ocorra, a tentativa falha e o Retry tenta novamente até atingir o valor de Maximum Number of Retries. O erro não é propagado nesse momento. O que acontece quando as tentativas se esgotam depende da propriedade Fail On Error: com Fail On Error desabilitado, o pipeline continua e o próximo conector recebe a mensagem da última tentativa que falhou; com Fail On Error habilitado, o pipeline é interrompido. Além disso, sempre que a propriedade success for definida com valor true no último passo do subpipeline em onException, a execução do conector Retry também será concluída, independentemente da propriedade Fail On Error estar ativa.