Gerenciador de Exceção Global

O Gerenciador de Exceção Global é um tipo de fluxo de trabalho projetado para determinar o comportamento do projeto ao encontrar um erro de execução. Apenas um Gerenciador de Exceção Global pode ser definido por projeto de automação.

Observação:

O Gerenciador de Exceção Global não fica disponível para projetos de biblioteca, apenas processos.

The Global Exception Handler has two arguments, that should not be removed.

O primeiro argumento é o errorInfo com a direção In e armazena informações sobre o erro que foi gerado e o fluxo de trabalho que falhou. O nível do erro a ser registrado pode ser definido na atividade Mensagem de log.

Observação:

Use a propriedade ActivityInfo para errorInfo, a fim de obter o nome da atividade que gerou a exceção e exibi-la no painel Saída.

O segundo argumento, result tem a direção Out e será usado para determinar o próximo comportamento do processo quando ele encontrar um erro. Os seguintes valores podem ser atribuídos ao argumento result:

• Continuar – A exceção será gerada novamente.

• Ignorar – A exceção será ignorada, e a execução continua a partir da próxima atividade.

• Tentar novamente – A atividade que gerou a exceção será repetida. Use o método RetryCount para errorInfo, a fim de contar o número de vezes que a atividade será repetida.

• Anular – A execução para depois de executar o Gerenciador de Exceção Global atual.

  Observação:

  Qualquer fluxo de trabalho pode ser sinalizado como um Gerenciador de Exceção Global no Studio, exceto para projetos de biblioteca e Main.xaml.

Como lidar com erros durante a depuração

Quando uma exceção for detectada durante a depuração, a atividade com falha será destacada, a execução será pausada e o tipo e os detalhes da exceção serão mencionados nos painéis Locais e Chamar Pilha.

Debugging actions like Continue, Stop, Retry, Ignore, Restart and Slow Step are available in the ribbon. Ignore is used for continuing the execution from the next activity.

O botão Tentar novamente repete a execução da atividade atual, sem o Gerenciador de Exceção Global. A ação Continuar executa o Gerenciador de Exceção Global, considerando os valores escolhidos anteriormente para o argumento result, que podem ser Continuar, Ignorar, Tentar novamente ou Anular.

Observação:

Ao usar o Gerenciador de Exceção Global com um projeto que inclui um Try Catch, certifique-se de agrupar as atividades em uma Sequência dentro do contêiner Tentar.Caso contrário, o Gerenciador de Exceção Global não será executado.

No caso das atividades nested, o Gerenciador de Exceção Global será executado para cada atividade na pilha de chamadas. No entanto, ele não será executado para as atividades encapsuladas diretamente em uma Try Catch, a menos que elas estejam contidas em uma atividade.

Exemplo de como usar o Gerenciador de Exceção Global

O seguinte exemplo mostra o comportamento do projeto quando uma exceção é gerada durante a execução.

O projeto de automação será definido para clicar dentro de um documento do Notepad vazio e salvo, digitar algum texto e fechar o aplicativo, mas não antes de clicar no botão de salvar para salvá-lo.

Para controlar o comportamento do fluxo de trabalho no caso de um erro, o Gerenciador de Exceção Global repete a atividade três vezes e, em seguida, anula com uma mensagem de erro.

Como criar o fluxo de trabalho

1. Create a Blank Process by following the steps in the Creating a Basic Process page.

2. Abra o Notepad e salve um documento na sua máquina.

3. From the Activities panel, drag a Type Into activity to the Designer panel. The activity is automatically added to a Sequence.

4. Na atividade Type Into, clique em Indicar na tela. O Studio minimiza e permite que você clique dentro da janela do Notepad para criar o seletor. No campo de texto, digite o texto desejado entre aspas.

5. From the Activities panel, add a Send Hotkey activity to the workflow. Indicate the Notepad window, and select Ctrl from the activity, type in s in the Key field. This saves the Notepad document after the text was typed in.

6. From the Activities panel, add a Close Application activity to the workflow. Indicate the Notepad window using Indicate on screen. The resulted workflow should look like this:

   

Como adicionar um Gerenciador de Exceção Global

1. Na guia Design, na Faixa de Opções, selecione Novo > Gerenciador Global. A janela Novo Gerenciador Global será aberta. Digite um Nome para o gerenciador e salve-o no caminho do projeto. Clique em Criar, um Gerenciador de Exceção Global será adicionado ao projeto de automação.

2. Na guia Variáveis, crie uma Int32variável chamada retryCount, defina seu escopo para todo o Gerenciador de Exceção Global, deixe o campo de valor Padrão vazio. A variável armazenará o número de repetições e aumentará o número em 1 a cada vez que um erro for encontrado.

3. Crie uma variável String chamada failedActivity e defina seu escopo para todo o fluxo de trabalho. Essas variáveis vão armazenar o nome da atividade com falha e o revelar no painel Saída.

4. From the Activities panel, add an Assign activity below the Log Error in the Global Handler sequence. Add the retryCount to the activity and assign it the errorInfo.RetryCount expression, which counts the number of times the exception is thrown.

5. Adicione outra atividade Assign, a qual atribui a expressão errorInfo.ActivityInfo.Name à variável failedActivity. Neste momento, o fluxo de trabalho deve ser semelhante a isto:

   

6. Add an If activity to the workflow. Set the Condition to retryCount < 3 to limit the number of retries to 3.

7. Na atividade Assign, que faz parte da categoria Then, atribua o ErrorAction.Retry à variável result para o Gerenciador de Exceção Global repetir a atividade que gerou a exceção.

8. Na categoria Else, atribua o ErrorAction.Abort à result para o Gerenciador de Exceção Global anular a execução quando a condição for atendida. A atividade If deve ser semelhante a isto:

   

Quando o Gerenciador de Exceção Global encontrar uma exceção, ele registrará em log o nome da atividade com falha e começará a repetir a atividade três vezes. Se ele encontrar a mesma exceção todas as vezes e o número de repetições atingir 3, a execução será anulada no nível da atividade que gerou a exceção.

Se durante uma tentativa de repetição, uma exceção não for encontrada, a execução do fluxo de trabalho continuará e o Gerenciador de Exceção Global não intervirá.

Baixe o exemplo