studio
2024.10
true
UiPath logo, featuring letters U and I in white
Guia do usuário do Studio
Last updated 18 de nov de 2024

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

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 é 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 de Atividades, pesquise 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 Application path, 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 a 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á.

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.