As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Configurar o tratamento de erros com o Workflow Studio no Step Functions
<a name="workflow-studio-process-error"></a>

**Gerenciar estados e transformar dados**  
Saiba mais sobre como [transmitir dados entre estados com variáveis](workflow-variables.md) e [transformar dados com JSONata](transforming-data.md).

É possível configurar o tratamento de erros no editor visual do Workflow Studio. Por padrão, quando um estado relata um erro, o Step Functions faz com que a execução do fluxo de trabalho falhe totalmente. Para ações e alguns estados de fluxo, você pode configurar como o Step Functions lida com erros. 

Mesmo que você tenha configurado o tratamento de erros, alguns erros ainda podem causar uma falha na execução de um fluxo de trabalho. Para obter mais informações, consulte [Tratar erros em fluxos de trabalho do Step Functions](concepts-error-handling.md). No Workflow Studio, configure o tratamento de erros na guia **Tratamento de erros** do [Painel Inspetor](workflow-studio.md#workflow-studio-components-formdefinition). 

## Tente novamente em caso de erros
<a name="workflow-studio-process-error-retry"></a>

Você pode adicionar uma ou mais regras aos estados de ação e ao estado de fluxo [Estado paralelo do fluxo de trabalho](state-parallel.md) para repetir a tarefa quando ocorrer um erro. Essas regras são chamadas de *retriers*. Para adicionar um retrier, escolha o ícone de edição na caixa **Retrier nº 1** e configure as opções:
+ (Opcional) No campo **Comentário**, adicione seu comentário. Isso não afetará o fluxo de trabalho, mas pode ser usado para anotar o fluxo de trabalho. 
+ Coloque o cursor no campo **Erros** e escolha um erro que acionará o retrier ou insira um nome de erro personalizado. Você pode escolher ou adicionar vários erros.
+ (Opcional) Defina um **Intervalo**. Esse é o tempo em segundos antes que o Step Functions faça a primeira nova tentativa. Novas tentativas ocorrerão em intervalos que você pode configurar com o **Máximo de tentativas** e a **Taxa de recuo**.
+ (Opcional) Defina o **Máximo de tentativas**. Esse é o número máximo de novas tentativas antes que o Step Functions cause falha na execução.
+ (Opcional) Defina a **Taxa de recuo**. Esse é um multiplicador que determina em quanto o intervalo de nova tentativa aumentará a cada tentativa.

**nota**  
Nem todas as opções de tratamento de erros estão disponíveis para todos os estados. Invocação Lambda tem um retrier configurado por padrão.

## Detecção de erros
<a name="workflow-studio-process-error-catch"></a>

Você pode adicionar uma ou mais regras aos estados de ação e aos estados de fluxo [Estado paralelo do fluxo de trabalho](state-parallel.md) e [Estado de mapa do fluxo de trabalho](state-map.md) para capturar um erro. Essas regras são chamadas de *catchers*. Para adicionar um catcher, escolha **Adicionar novo catcher** e configure as opções:
+ (Opcional) No campo **Comentário**, adicione seu comentário. Isso não afetará o fluxo de trabalho, mas pode ser usado para anotar o fluxo de trabalho. 
+ Coloque o cursor no campo **Erros** e escolha um erro que acionará o catcher ou insira um nome de erro personalizado. Você pode escolher ou adicionar vários erros.
+ No campo **Estado de fallback**, escolha um [estado de fallback](concepts-error-handling.md#error-handling-fallback-states). Esse é o estado para o qual o fluxo de trabalho será movido em seguida, depois que um erro for detectado.
+ (Opcional) No **ResultPath**campo, adicione um `ResultPath` filtro para adicionar o erro à entrada do estado original. O [`ResultPath`](input-output-resultpath.md)deve ser válido [JsonPath](https://datatracker.ietf.org/wg/jsonpath/about/). Isso será enviado para o estado de fallback.

## Tempos limite
<a name="workflow-studio-process-error-timeout"></a>

Você pode configurar um tempo limite para os estados de ação para definir o número máximo de segundos que o estado pode ser executado antes que ele falhe. Use tempos limite para evitar execuções travadas. Para configurar um tempo limite, insira o número de segundos que o estado deve esperar antes que a execução falhe. Para obter mais informações sobre os tempos limites, consulte `TimeoutSeconds`no estado [Estado de tarefa do fluxo de trabalho](state-task.md).

## HeartbeatSeconds
<a name="workflow-studio-process-error-heartbeat"></a>

Você pode configurar um *Heartbeat* ou uma notificação periódica enviada pela tarefa. Se você definir um intervalo de heartbeat, e o estado não enviar notificações de heartbeat nos intervalos configurados, a tarefa será marcada como falha. Para configurar uma heartbeat, defina um número inteiro positivo diferente de zero de segundos. Para ter mais informações, consulte `HeartBeatSeconds` no estado [Estado de tarefa do fluxo de trabalho](state-task.md).