Tratador de erro Break
Artigo histórico da Make (data não indicada na fonte). Este texto reproduz uma página de documentação da Make. As descrições de recursos e as capturas de tela são da Make no momento da sua publicação; não são uma afirmação deste site nem garantia de que essa documentação continue igual hoje. Para o estado atual da plataforma, consulte as fontes oficiais da Make.
O tratador de erro Break remove o bundle com erro do fluxo do cenário. A Make armazena a mensagem de erro, os mapeamentos e o fluxo restante do cenário como uma execução incompleta. Dependendo das configurações do tratador de erro Break, a Make tenta novamente as execuções incompletas do cenário automaticamente ou as armazena até que você as resolva. O retry automático é mais eficaz para erros temporários ou erros em que outra tentativa pode ter sucesso. A Make já repete automaticamente, por padrão, os erros temporários mais frequentes: o ConnectionError e o RateLimitError. Você não precisa do tratador de erro Break para repetir automaticamente esses tipos de erro. Para repetir automaticamente o ConnectionError e o RateLimitError, basta ativar as execuções incompletas nas configurações do cenário. Você pode ler mais sobre retry automático no artigo sobre execuções incompletas. A Make processa o restante dos bundles no fluxo do cenário. Para usar o tratador de erro Break no seu cenário, você precisa ativar as execuções incompletas nas configurações do cenário. Por exemplo: este cenário de demonstração contém cinco módulos. O cenário é útil para testes e para mostrar o efeito de um tratador de erro:
- JSON - Parse JSON fornece dados de teste na forma de um array de três IDs de registro.
- Iterator divide o array em bundles individuais.
- Data store - Update a record : atualiza os dados no data store.
- Data store - Update a record : este módulo atualiza os dados novamente. Desta vez, o módulo funciona de forma diferente. No mapeamento do módulo, há um mapeamento que cria um erro intencionalmente:
- O mapeamento insere um valor nulo no campo obrigatório Key, o que sempre cria o BundleValidationError.
- Slack - Send a message : envia uma mensagem para um canal privado de testes.
É assim que o cenário de exemplo fica:
Quando executamos o cenário de exemplo, obtemos o BundleValidationError:
Se adicionássemos o tratador de erro Break ao módulo Update a record, o tratador de erro Break removeria o bundle do fluxo do cenário. O bundle que causou o erro não continua pelo resto do cenário. Em vez disso, a Make cria uma execução incompleta para armazenar o tipo de erro, os mapeamentos e o fluxo restante do cenário.
A Make então processaria os bundles restantes no fluxo do cenário.
Para mais informações sobre estratégias de tratamento de erros, consulte a visão geral do tratamento de erros.
Armazenar o cenário quando ocorre um erro
Com o tratador de erro Break, você pode armazenar o fluxo restante do cenário nas execuções incompletas do cenário quando ocorre um erro. A Make também armazena a mensagem de erro, os mapeamentos do cenário e os dados.
Você pode concluir a execução do cenário manualmente na aba de execuções incompletas, ou a Make pode concluir a execução automaticamente.
Por exemplo, o cenário a seguir emite um erro no módulo do app Data Store:
Para armazenar o cenário como uma execução incompleta, siga os passos:
- Clique com o botão direito no módulo que está causando o erro. No menu, selecione Add error handler.
- Selecione o tratador de erro Break.
- Opcional: nas configurações do tratador de erro, selecione se você quer concluir automaticamente as execuções incompletas. Para conclusões automáticas, você pode definir o número de tentativas e o intervalo de tempo entre elas.
- Confirme as configurações do tratador Break com o botão OK.
- Ative o armazenamento de execuções incompletas nas configurações do cenário.
- Salve seu cenário.
Você adicionou o tratador de erro Break ao seu cenário. Quando ocorre um erro no módulo Data store, a Make cria uma execução incompleta. A execução incompleta do cenário contém a mensagem de erro, os mapeamentos e os dados do cenário.
Se você usar a conclusão automática do cenário, a Make tenta concluir o cenário automaticamente.