Tratar erros em fluxos da área de trabalho

Durante o desenvolvimento e a execução, você pode encontrar erros e avisos nos fluxos da área de trabalho. Este artigo apresenta os diferentes tipos de erro e de aviso, o painel Erros e a funcionalidade de tratamento de erros disponível.

Tipos de erro dos fluxos da área de trabalho

Os fluxos da área de trabalho podem causar dois tipos de erros:

• Os erros de tempo de design estão associados à configuração das ações implantadas. Esses erros aparecem durante o desenvolvimento e impedem a execução dos fluxos da área de trabalho. Por exemplo, um campo obrigatório vazio ou uma variável indefinida podem causar esse tipo de erro.

• Erros de tempo de execução, também conhecidas como exceções, ocorrem durante a execução e fazem com haja falha nos fluxos da área de trabalho. Por exemplo, um caminho de arquivo inválido pode causar esse tipo de erro. Use qualquer uma das opções de tratamento de erros disponíveis para evitar que haja falha em seus fluxos da área de trabalho.

Quando uma ação gera um erro, o designer de fluxo exibe um ícone próximo a ela e um painel pop-up com informações de erro relevantes. Se o erro ocorrido for um erro de tempo de design, o designer de fluxo também exibirá uma descrição do erro no modal da ação.

Avisos dos fluxos da área de trabalho

Além dos erros, o designer de fluxo exibe avisos que indicam problemas não críticos em seus fluxos da área de trabalho. Os avisos não impedem a execução dos fluxos da área de trabalho, mas indicam possíveis funcionalidades indesejadas, como recursões infinitas de subfluxos.

Examinar erros e avisos usando o painel de erros

O painel de erros é o componente do designer de fluxo responsável por exibir informações sobre erros e avisos ocorridos.

Ele é composto por quatro colunas:

• Tipo: indica se o item exibido é um erro ou aviso.
• Descrição: uma descrição do erro ou aviso que ocorreu.
• Subfluxo: o nome do subfluxo que contém a ação incorreta ou a ação que causou o aviso.
• Linha: o número da linha da ação incorreta ou da ação que causa o aviso.

O painel também fornece filtros para exibir erros, avisos e/ou itens relacionados a subfluxos específicos.

Para ver informações adicionais sobre um erro ou aviso em tempo de design, clique duas vezes no respectivo item no painel de erros. Depois de fazer isso, uma caixa de diálogo exibirá informações sobre:

• Localização: o subfluxo, a linha e a ação que causaram o erro ou o aviso em tempo de design.
• Mensagem de erro: a mensagem do erro ou aviso em tempo de design ocorrido.

Para ver informações adicionais sobre um erro de runtime, clique duas vezes no respectivo item no painel de erros. Depois de fazer isso, uma caixa de diálogo exibirá informações sobre:

• A mensagem do erro ou aviso ocorrido.
• Localização: o subfluxo, a linha e a ação que causou o erro ou o aviso.
• Possíveis etapas de correção para resolver o problema ocorrido (atualmente aplicável apenas a erros de ações do Excel).
• Detalhes do erro: a ID de correlação do erro, além de uma longa descrição técnica do erro de runtime ocorrido.

Configurar a funcionalidade de tratamento de erros

O Power Automate permite que você configure a funcionalidade de tratamento de erros para ações únicas e blocos de ações em seus fluxos da área de trabalho.

Tratar erros de ações únicas

Por padrão, os fluxos da área de trabalho param sua execução quando ocorre um erro. Para configurar uma funcionalidade de tratamento de erros personalizado para uma ação específica, selecione a opção Se houver erro em seu modal.

A primeira opção disponível é a caixa de seleção Repetir ação se ocorrer um erro. Essa opção faz com que o fluxo execute a ação um determinado número de vezes após um determinado número de segundos. O valor padrão é uma nova tentativa com um intervalo de dois segundos.

Para continuar a execução do fluxo da área de trabalho, mesmo se houver falha na opção de nova tentativa, selecione a opção Continuar a execução do fluxo. Na lista suspensa exibida, você pode selecionar:

• Ir para próxima ação: executa a ação seguinte na ordem.
• Repetir a ação: repete a ação até que seja ela executada com êxito.
• Ir para o rótulo: executa o fluxo da área de trabalho a partir de um ponto definido por uma ação Rótulo.

O fluxo da área de trabalho oferece duas opções adicionais de tratamento de erros. Selecione +Nova regra para:

• Definir variável: define o valor especificado como uma variável selecionada.
• Executar subfluxo: executa um subfluxo especificado.

Se erros diferentes exigirem funcionalidades de tratamento de erros diferentes, selecione a opção Avançado e configure cada possível erro separadamente.

Tratar erros de grupo de ações

Alguns cenários podem exigir que você implemente a mesma funcionalidade de tratamento de erros para várias ações em seus fluxos da área de trabalho.

Em vez de configurar cada ação separadamente, você pode implantar a ação Erro no bloco e configurar o tratamento de erros para todas as ações dentro do bloco.

Essa ação oferece quase as mesmas opções que as configurações Se houver erro de ações únicas, mas também permite capturar erros lógicos inesperados, como tentar acessar um item de lista de uma posição fora dos limites.

Recuperar erros ocorridos em fluxos da área de trabalho

Para recuperar o erro que ocorreu por último em um fluxo da área de trabalho e usá-lo em ações posteriores use a ação Obter último erro.

Essa ação retorna uma variável de tipo de erro que fornece seis propriedades diferentes: o nome, a localização e o índice da ação com falha, o subfluxo que contém essa ação e os detalhes e a mensagem da ação.

Para evitar a recuperação do mesmo valor de erro posteriormente em seu fluxo da área de trabalho, habilite a opção Limpar erro que limpa o último erro após armazená-lo na variável.