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.

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 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.

  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 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.

As Açõ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 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 é configurado para digitar algum texto em um arquivo TXT e então fechar o aplicativo, mas não sem antes salvar o arquivo.

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 em sua máquina. Você pode nomear o arquivo 1.txt.

3. No painel Atividades, procure por Use Application/Browser e arraste-a para o painel Designer.

4. Em Use Application/Browser:

   • Clique em Indicar aplicativo para automatizar e mova o ponteiro do mouse para a janela do Notepad. Quando a janela ficar realçada, clique em qualquer lugar dentro dela. A atividade Use Application/Browser é atualizada, o caminho é adicionado ao campo Caminho do aplicativo, e uma captura de tela da janela aparece dentro da atividade.
   • No painel Propriedades, selecione a opção Sempre para a propriedade Close. Isso garante que o Notepad seja fechado após a execução da automação.

5. Adicione uma atividade Type into no contêiner Do da atividade Use Application/Browser.Clique em Indicar no Aplicativo para selecionar a janela do Notepad, e insira um texto entre aspas no campo Digitar isto. Essa atividade escreve o texto no Notepad.

6. No painel Atividades, adicione uma atividade Keyboard Shortcuts ao fluxo de trabalho.Indique a janela do Notepad, selecione Gravar atalho e pressione Ctrl + S para gravar a combinação de teclas que salva o arquivo após o texto ser digitado.

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. Volte para ao fluxo de trabalho que você criou mais cedo e o modifique para que uma atividade falhe na execução. Por exemplo, na atividade Use Application/Browser, selecione a opção Corresponder ao título exato e se certifique de que o arquivo esteja fechado antes de clicar em Executar Arquivo na faixa de opções.

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 das tentativas 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