Retry
Descubra mais sobre o componente 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 componente. Parâmetros suportados por expressões Double Braces estão marcados com (DB)
.
Definindo o subpipeline que é executado a cada tentativa
Para trabalhar com esse tipo de componente, é 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 componentes Session).
Informando sucesso para uma execução do componente 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 valorfalse
ou não a definindo. Caso a propriedadesuccess
seja especificada com o valortrue
, então o Retry será finalizado com sucesso e nenhuma outra tentativa será executada.
Cenários de utilização do componente 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 componente Retry;
nenhum outro componente 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 componente Retry;
nenhum outro componente 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 componente Retry;
o próximo componente 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 componente Retry;
o próximo componente será invocado recebendo a mensagem de saída do Retry.
Caso um componente de erro (como Throw Error ou Assert) seja utilizado dentro do subpipeline em onProcess ou um erro ocorra, então o Retry será finalizado e o erro será propagado para o pipeline. Além disso, sempre que a propriedade success
for definida com valor true
no último passo do subpipeline em onException, a execução do componente Retry também será concluída, independentemente da propriedade Fail on Error estar ativa.
Atualizado