Processar error em fluxos de ambiente de trabalho

Durante o desenvolvimento e a execução, poderá encontrar erros e avisos nos seus fluxos de ambiente de trabalho. Este artigo apresenta os diferentes tipos de erros e avisos, o painel Erros e a funcionalidade de processamentos de erros disponíveis.

Tipos de erros de fluxos de ambiente de trabalho

Os fluxos de ambiente de trabalho podem causar dois tipos de erros:

• Erros de tempo de conceção estão associados à configuração das ações implementadas. Estes erros aparecem durante o desenvolvimento e impedem a execução de fluxos de ambiente de trabalho. Por exemplo, um campo obrigatório vazio ou uma variável indefinida podem causar este tipo de erro.

• Erros de runtime, também conhecidos como exceções, ocorrem durante a execução e fazem com que os fluxos de ambiente de trabalho falhem. Por exemplo, um caminho de ficheiro inválido pode causar este tipo de erro. Utilize qualquer uma das opções de processamento de erros disponíveis para impedir que os seus fluxos de ambiente de trabalho falhem.

Quando uma ação lança um erro, o estruturador de fluxos apresenta um ícone ao lado do mesmo e um painel pop-up com informações relevantes. Se o erro que ocorreu for um erro tempo de conceção, o estruturador de fluxos também apresenta uma descrição do erro no modal da ação.

Avisos de fluxos de ambiente de trabalho

Para além de erros, o estruturador de fluxos apresenta avisos que indicam problemas não críticos nos fluxos de ambiente de trabalho. Os avisos não impedem a execução de fluxos de trabalho, mas indicam funcionalidades indesejadas possíveis, tal como recursões infinitas de subfluxos.

Rever erros e avisos utilizando o painel de erros

O painel de erros é o componente do estruturador de fluxos responsável por apresentar informações relativas a erros e avisos ocorridos.

É composto por quatro colunas:

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

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

Para ver informações adicionais acerca de um erro ou aviso de tempo de conceção, clique duas vezes no item respetivo no painel de erros. Assim que o fizer, um diálogo apresentará informações sobre:

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

Para ver informações adicionais acerca de um erro de runtime, clique duas vezes no item respetivo no painel de erros. Assim que o fizer, um diálogo apresentará 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 aviso.
• Passos de remediação possíveis para resolver o problema que ocorreu (aplicável atualmente apenas aos erros das ações do Excel).
• Detalhes do erro: o ID de correlação do erro, bem como uma descrição técnica longa do erro de runtime ocorrido.

Configurar a funcionalidade de processamento de erros

O Power Automate permite-lhe configurar a funcionalidade de processamento de erros para ações individuais e blocos de ações nos seus fluxos de ambiente de trabalho.

Processar erros de ações individuais

Por predefinição, os fluxos de ambiente de trabalho param a execução quando ocorre um erro. Para configurar uma funcionalidade de processamento de erros personalizada para uma ação específica, selecione Em erro no respetivo modal.

A primeira opção disponível é a caixa de verificação Repetir ação se ocorrer um erro. Esta opção faz com que o fluxo execute a ação um conjunto de vezes após um número definido de segundos. O valor predefinido é uma repetição com um intervalo de dois segundos.

Para manter o seu fluxo de ambiente de trabalho em execução, mesmo que a opção de repetir falhe, selecione Continuar execução de fluxo. Através da lista pendente apresentada, pode:

• Ir para a próxima ação: executa a ação seguinte por ordem.
• Repetir ação: Repete a ação até que seja executada com sucesso.
• Ir para a etiqueta: execute o fluxo de ambiente de trabalho a partir de um ponto definido por uma ação Etiqueta.

Os fluxos de ambiente de trabalho oferecem duas mais opções de processamento de erros. Selecione Nova regra para:

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

Se erros diferentes requerem diferentes funcionalidades de processamento de erros, selecione Avançado e configure cada erro possível separadamente.

Processar erros de grupo de ações

Alguns cenários poderão requerer a implementação da mesma funcionalidade de processamento de erros para várias ações nos seus fluxos de ambiente de trabalho.

Em vez de configurar cada a ação em separado, pode implementar a ação Em erro de bloqueio e configurar o processamento de erros para todas as ações dentro do bloco.

Esta ação oferece praticamente as mesmas opções que as definições de Em erro de ações individuais, mas também permite capturar erros de lógica inesperados, tais como tentar aceder a um item de lista a partir de uma posição fora dos limites.

Obter erros ocorridos em fluxos de ambiente de trabalho

Para obter o erro mais recente ocorrido num fluxo de ambiente de trabalho e utilizá-lo em ações posteriores, utilize a ação Obter último erro.

Esta ação obtém uma variável de tipo de erro que fornece seis propriedades diferentes: o nome, a localização e o índice da ação que falhou, o subfluxo que contém esta ação, os detalhes e a mensagem da ação.

Para evitar a obtenção do mesmo valor de erro posteriormente no seu fluxo de ambiente de trabalho, ative a opção Limpar erro que limpa o último erro depois de o armazenar na variável.