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 está disponível para projetos de biblioteca, apenas processos.

O Gerenciador de Exceção Global tem dois argumentos que não devem ser removidos.

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 falou. O nível do erro a ser registrado em log pode ser definido na atividade Log Message.

Observação: use a propriedade ActivityInfo para errorInfo para obter o nome da atividade que gerou a exceção e exiba-a 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.

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.

Asações de depuração como Continuar, Parar, Tentar novamente, Ignorar, Reiniciar e Desacelerar etapa ficam disponíveis na faixa de opções. Ignorar será usada para continuar a execução a partir da próxima atividade.

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 uma Try Catch, certifique-se de agrupar as atividades em uma Sequência dentro do contêiner Try. 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. Crie um processo em branco seguindo as etapas na página Como criar um processo básico.
2. Abra o Notepad e salve um documento na sua máquina.
3. No painel Atividades, arraste uma atividade Type Into para o painel Designer. A atividade será adicionada automaticamente a uma Sequência.
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. No painel Atividades, adicione uma atividade Send Hotkey ao fluxo de trabalho. Indique a janela do Notepad e selecione Ctrl na atividade, digite s no campo Chave. Isso salva o documento do Notepad após o texto ser digitado.
6. No painel Atividades, adicione uma atividade Close Application ao fluxo de trabalho. Indique a janela do Notepad usando Indicar na tela. O fluxo de trabalho resultante deve ser semelhante a isto:
   
   

   

   
   

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. No painel Atividades, adicione uma atividade Assign abaixo do Registrar erro em log na sequência do Gerenciador Global. Adicione o retryCount à atividade e atribua-o à expressão errorInfo.RetryCount, que contabiliza o número de vezes que a exceção será gerada.
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. Adicione uma atividade If ao fluxo de trabalho. Defina a Condição como retryCount < 3 para limitar o número de repetições a 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