Ações de depuração

A depuração de um único arquivo ou do projeto inteiro pode ser realizada nas guias Design ou Depurar da faixa de opções. No entanto, o processo de depuração não ficará disponível se os arquivos do projeto apresentarem erros de validação.

Depuração Completa

Utilize Depuração Completa para depurar uma atividade de cada vez. Quando essa ação for disparada, o depurador será aberto e destacará a atividade antes que ela seja executada.

Quando Depuração Completa for usada com as atividades Invoke Workflow File, o fluxo de trabalho será aberto em uma nova guia no modo ReadOnly e será executada uma atividade por vez.

O atalho do teclado para Depuração Completa é F11.

Depuração Parcial

Diferentemente da ação Depuração Completa, a Depuração Parcial não abrirá o contêiner atual. Quando utilizada, a ação depura a atividade seguinte, destacando contêineres (como fluxogramas, sequências ou atividades Invoke Workflow File) sem abri-los.

Esta ação é útil para pular a análise de contêineres grandes que dificilmente disparará algum problema durante a execução.

A Depuração Parcial está disponível utilizando o atalho do teclado F10.

Depuração Circular

Como o nome sugere, essa ação é utilizada para sair e pausar a execução no nível do contêiner atual. A Depuração Circular conclui a execução de atividades no contêiner atual, antes de pausar a depuração. Esta opção funciona bem com as sequências nested.

A Depuração Circular fica disponível usando o atalho do teclado Shift + F11.

Tentar novamente

Tentar novamente executa mais uma vez a atividade anterior e gera a exceção se for encontrada novamente. A atividade que gerou a exceção é destacada e detalhes sobre o erro são exibidos nos painéis Locais e Chamar Pilha.

Ignorar

A ação Ignorar pode ser usada para ignorar uma exceção encontrada e continuar a execução a partir da próxima atividade, para que o restante do fluxo de trabalho possa ser depurado.

Esta ação é útil ao pular a atividade que gerou a exceção e continuar a depuração da parte restante do projeto.

Reiniciar

Reiniciar fica disponível após uma exceção ser gerada e o processo de depuração ser pausado. A ação é utilizada para reiniciar o processo de depuração a partir da primeira atividade do projeto. Use Desacelerar Etapa para desacelerar a velocidade de depuração e inspecionar corretamente as atividades, conforme elas são executadas.

Considere que, ao utilizar esta opção após utilizar a ação Executar a partir desta Atividade, a depuração é reiniciada a partir da atividade indicada anteriormente.

Break

Interromper permite que você pause o processo de depuração a qualquer momento. A atividade que está em depuração permanece destacada quando é pausada. Assim que isso acontecer, você poderá escolher Continuar, Depuração Completa, Depuração Parcial ou Parar o processo de depuração.

É recomendável utilizar Interromper e Desacelerar Etapa para saber exatamente quando a depuração precisa ser interrompida.

Uma alternativa do uso de Desacelerar Etapa é observar o painel Saída e usar Interromper na atividade que está sendo depurada.

Foco

Focar no Ponto de Execução ajuda a retornar ao ponto de interrupção atual ou à atividade que causou um erro durante a depuração. O botão Focar é utilizado depois de navegar pelo processo, como uma maneira fácil de retornar à atividade que gerou o erro e retomar o processo de depuração.

Alternativamente, quando a depuração for pausada porque um ponto de interrupção foi atingido, é possível utilizar Focar para retornar a esse ponto de interrupção, depois de navegar pelas atividades contidas no processo de automação.

Um terceiro caso é quando a depuração for pausada depois de usar Depuração Completa ou Depuração Parcial e navegar pelo processo. Neste caso, Focar retorna à atividade que pausou o processo de depuração.

No menu de contexto Pontos de Interrupção, é possível selecionar Focar para destacar a atividade com o ponto de interrupção.

Desacelerar Etapa

Desacelerar Etapa permite analisar qualquer atividade durante a depuração. Enquanto essa ação estiver habilitada, as atividades ficam destacadas no processo de depuração. Além disso, contêineres como fluxogramas, sequências ou atividades Invoke Workflow File serão abertos. Isso é semelhante a usar Depuração Completa, mas sem pausar o processo de depuração.

Desacelerar Etapa pode ser ativada antes ou durante o processo de depuração. Ativar a ação não pausa a depuração.

Embora chamada de Desacelerar Etapa, a ação possui quatro velocidades diferentes. A etapa de velocidade selecionada executa o processo de depuração mais lentamente do que a anterior. Por exemplo, a depuração com Desacelerar Etapa em 1x o executa mais lentamente, e em 4x mais rapidamente. Em outras palavras, a velocidade define a rapidez com que o depurador avança de uma atividade para a próxima.

Cada vez que você clicar em Desacelerar Etapa a velocidade será alterada em uma etapa. Você pode facilmente reconhecer pelo ícone, que será atualizado de acordo.

Trilha de Execução

O botão Trilha de Execução da faixa de opções fica desabilitado por padrão. Quando habilitado, ele mostra o caminho de execução exato na depuração. Conforme o processo for executado, cada atividade será destacada e marcada no painel Designer, mostrando a execução conforme ela acontece:

• as atividades executadas ficam marcadas e destacadas em verde;
• atividades que não foram executadas não ficam marcadas de nenhuma forma;

• atividades que geraram uma exceção ficam marcadas e destacadas em vermelho.

  
  

  

  
  

Realçar Elementos

Se habilitados, os elementos de interface gráfica serão destacados durante a depuração. A opção pode ser usada com a depuração regular e passo a passo.

Registrar Atividades

Se habilitadas, as atividades depuradas serão exibidas como logs de rastreamento no painel Saída. Observe que as opções Destacar Elementos e Registrar Atividades em Log podem ser alternadas apenas antes da depuração e persistem ao reabrir o projeto de automação. Isso não é aplicável para fluxos de trabalho invocados, a menos que esses arquivos estejam abertos no painel Designer.

Os logs são enviados automaticamente para o Orchestrator se conectado. No entanto, é possível armazená-los localmente desabilitando a opção Permitir registros em log de desenvolvimento na guia Configurações do Robô, na janela Adicionar ou Editar usuário.

Desabilitar Registrar Atividades em Log pode ser uma maneira de enviar arquivos de log menores para o Orchestrator.

Observação: ao executar processos do Studio, os logs enviados ao Orchestrator são sempre Trace quando Atividades de log está desabilitada e Verbose quando Atividades de log está habilitada. Isso substitui o Robô e a configuração do Orchestrator.

Por padrão, a depuração registra as atividades em log para que cada etapa seja exibida no painel Saída. Recomendamos deixá-lo habilitado para um rastreamento mais fácil, conforme você pode ver na imagem abaixo:

O problema aqui é que um ou mais campos de entrada da sequência Entrada do usuário estão em branco, o que é uma condição True para a Flow Decision. É possível perceber isso pelo fato de que, durante a depuração, a sequência Entrada do usuário foi executada duas vezes, indicando que um ou mais campos foram deixados em branco durante a primeira execução.

Se você decidir desabilitar a opção Registrar Atividades em Log para a depuração, os logs de rastreamento não serão exibidos no painel Saída. No caso de uma execução normal sem erros, você só vê os horários de início e fim da execução da depuração. No entanto, adicionar uma Mensagem de log pode ajudar a determinar onde os problemas podem ocorrer.

Por exemplo, você pode adicionar uma atividade Log Message para informar que, neste caso, um ou mais campos de entrada estão vazios. Essa mensagem é exibida no painel Saída durante a depuração, mesmo que a opção Registrar Atividades em Log esteja desabilitada, conforme você pode ver abaixo:

Lembre-se de que você sempre pode filtrar as mensagens exibidas no painel de Saída, bastando selecionar os tipos de alerta de interesse ou até mesmo limpar todas as mensagens.

Observe que, por padrão, todos os logs de depuração são enviados para o Orchestrator. Você pode desabilitar isso limpando a opção Permitir registros em log de desenvolvimento na guia Configurações , na janela Adicionar ou Editar Robô. Se essa opção estiver desabilitada, os logs de depuração serão armazenados apenas localmente.

Continuar com Exceção

Essa funcionalidade de depuração fica desabilitada por padrão. Quando desabilitada na faixa de opções, ela gera o erro de execução e para a depuração, destaca a atividade que gerou a exceção e registra a exceção no painel Saída. Se um Gerenciador de Exceção Global foi definido anteriormente no projeto, a exceção será passada ao gerenciador.

Quando habilitada, a exceção será registrada no painel Saída, a execução continuará.

Picture in picture

A opção Picture in Picture da faixa de opções, na guia Depurar fica disponível para os processos ou bibliotecas de execução e depuração em uma sessão separada em sua máquina.

Se estiver habilitada, sempre que você selecionar Executar ou Executar arquivo, Debug ou Debug arquivo, o processo começa em uma sessão separada ou em uma área de trabalho virtual na sessão do usuário. Se a opção Picture in Picture estiver desabilitada, a depuração e a execução serão realizadas na sessão atual.

Ter a opção de executar um processo em Picture in Picture (PiP) pode ser muito útil na automação assistida. Verifique se um processo é executado com êxito no PiP e, em seguida, atualize as configurações do projeto para indicar se ele pode ser executado usando essa funcionalidade depois de ser publicado:

1. No painel Projeto, clique em Configurações para abrir a janela Configurações do Projeto.

2. Na guia Geral:

   • Opções do PiP - Indique se o projeto foi testado usando Picture in Picture e se ele deve começar no PiP por padrão.

     • Testado para uso do PiP; Começando no PiP - A automação foi aprovada para ser executada no modo PiP. Ao ser executada, ela é iniciada no PiP por padrão.
     • Testado para uso do PiP; Não começando no PiP por padrão - A automação foi aprovada para ser executada no modo PiP. Ao ser executada, ela é iniciada na sessão principal ou na área de trabalho por padrão.
     • Não testada para uso do PiP - A automação não foi aprovada para ser executada no modo PiP. Quando executada, ela começa na sessão principal ou na área de trabalho por padrão. Se for executada em PiP, uma caixa de diálogo informa ao usuário que ela não foi testada usando esse recurso e solicita uma confirmação antes de prosseguir.
   • Tipo de PiP - Selecione como isolar a automação da sessão do usuário ao executar o projeto no PiP: Nova sessão (sessão filho na máquina) ou Nova área de trabalho (área de trabalho virtual na sessão do usuário).

Para obter mais informações, incluindo as limitações desta funcionalidade, consulte Picture in Picture no Guia do Robô.

Depuração remota

Quando esse recurso está habilitado, todas as operações de execução e debug são executadas em um Robot remoto especificado em vez do Robot instalado localmente, permitindo que você teste a automação em diferentes ambientes. Para obter mais informações, consulte Depuração Remota.

Execução de perfil

Você pode identificar gargalos de desempenho no fluxo de trabalho ao depurar o arquivo. Para obter mais informações, consulte Execução de perfil.

Abrir Logs

Clicar em Abrir Logs traz a pasta %localappdata%\UiPath\Logs na qual os logs estão armazenados localmente. O formato dos nomes dos arquivos de log é YYYY-DD-MM_Component.log (como 2018-09-12_Execution.log ou 2018-09-12_Studio.log). Leia mais sobre logs aqui.