Ferramentas de depuração

As ferramentas de depuração permitem solucionar problemas de automações complexas com tarefas aninhadas. Depurar bots principal e secundário individual dentro do principal para identificar rapidamente e resolver problemas em detalhes. Você pode examinar cada automação filha individualmente, garantindo que cada parte da automação esteja funcionando corretamente, levando a processos de automação mais eficientes e confiáveis.

Usar a ferramenta Depurar

Na página Automação, selecione e edite o bot que você deseja depurar. Você pode acessar a ferramenta Depurar a partir do utilitário Assistente ou do Editor de bot.

Acesse a ferramenta Depurar

Quando você invoca a ferramenta Depurar a partir do Editor de bot:
  • Você pode adicionar, atualizar ou excluir ações e variáveis dentro de um bot. Você pode continuar editando o bot desde que o processo de depuração ainda não tenha sido iniciado.
  • Quando você inicia a depuração, uma barra de cabeçalho roxa aparece abaixo do bot nome no Editor de bot que mostra Depuração em curso seguida pela atual bot nome que está sendo depurado.
  • A barra de cabeçalho também exibe uma lista de pilha hierárquica de bots igual à exibida na Pilha de Chamadas. Desta lista de pilha de bots, você pode navegar para um bot específico e verificar em qual linha você pisou para acessar o bot secundário atual. A barra de cabeçalho também exibe um link para o bot atual que está sendo depurado caso você tenha navegado para fora do bot atual.
  • Abaixo da barra de cabeçalho, os controles de depuração, iguais aos mostrados no Assistente, são exibidos para acesso rápido para controlar a depuração.
  • O painel Ações no lado esquerdo do Editor de bot é recolhido de modo automático. Isso ajuda a fornecer mais área horizontal para visualizar as ações adicionadas no Editor de bot durante a depuração. Quando a depuração é interrompida, o painel Ações se expande novamente.
Nota:
  • Invocar um depurador não inicia a depuração.
  • Antes de iniciar a depuração, certifique-se de corrigir qualquer erro de validação nos bots.
  • Você pode depurar o bot nas visualizações Fluxo e Lista. No entanto, para uma melhor visibilidade das ações, recomenda-se depurar o bot na visualização Lista.
Quando você abre o utilitário Assistenteno Editor de bot, editor de API ou editor de modelo e o move para uma posição específica, o editor mantém a última posição do utilitário Assistente mesmo depois de você sair do editor. A posição padrão do utilitário Assistente corresponderá à última posição para a qual você o moveu antes de sair do editor:
  • mesmo se a sessão do usuário expirar ou se o navegador for fechado de modo abrupto.
  • mesmo se você abrir o editor em um navegador diferente ou fizer login em uma sessão diferente usando as mesmas credenciais de usuário.

Isso melhora a usabilidade do Assistente, pois você não precisa mais mover o Assistente para a direita do editor para visualizar o painel Ações cada vez que abre o bot dentro do editor.

Controles de depuração

Nota:
  • Não há limite para o número de bots secundários que você pode entrar.
  • O recurso de depuração do bot secundário é compatível com o Agente de bot (versão 22.60.23 e superiores) e pacote Task Bot (versão 2.8.0-20230530-152744 e superiores).
Ações Ícones Atalhos de teclado Descrição
Iniciar depuração Botão Iniciar F6 Use Iniciar depuração para iniciar o processo de depuração.
Passar para a próxima ação Botão Passar F7 Use Passar para a próxima ação para depurar uma ação de cada vez. Depois de depurar a ação atual, você pode usar Passar para a próxima ação para ir para a próxima ação na sequência.
Continuar no próximo ponto de parada Botão Continuar no próximo ponto de parada F6 Use Continuar no próximo ponto de parada para passar direto para o próximo ponto de parada. Continuar no próximo ponto de parada executa a ação atual e, em seguida, passa para o próximo ponto de parada e faz uma pausa.
Nota: Quando a depuração está em andamento, o ícone Iniciar depuração muda para Continuar no próximo ponto de parada.
Entrar na ação atual Botão de entrada F8 Use Entrar na ação atual para entrar no bot secundário para depuração. Entrar na ação atual só é ativada quando você está chamando um bot secundário usando a ação Taskbot > Executar.
Sair do bot atual Botão sair Shift + F8 Use Sair do bot atual para sair do bot secundário após a depuração e faça uma pausa na próxima linha do bot de onde você entrou.
Nota: Sair do bot atual só é ativado depois que você entra no bot secundário.
Parar de depurar Botão Interromper Shift + F6 Use Parar de depurar para interromper o processo de depuração.

Pilha de chamadas

A Pilha de chamadas ajuda você a determinar com facilidade a ordem em que as bots são chamadas e a navegar rápido de uma bot para a outra. A pilha de chamadas lista as automações que estão ativas no momento, incluindo bots principais e secundários, com o número da linha e a pasta em que residem. O bot que está ativo atualmente é destacado e mostrado no topo da lista.

A Pilha de chamadas permite rastrear o caminho do erro desde sua origem para entender como ele ocorreu. Isso ajuda a identificar a origem dos problemas, especialmente em automação complexa com agrupamento multinível.

Ao entrar, o bot secundário é adicionado à Pilha de chamadas. Quando você sai do bot secundário ou conclui a depuração do bot secundário, o bot é removido da Pilha de chamadas. O bot principal agora se torna o bot atual que está sendo depurado.

Dependendo do bot que você selecionou na Pilha de chamadas, as Variáveis observadas mostrarão as variáveis ​​para aquele bot selecionado. Você pode então selecionar a variável para observar seu valor atual na lista Variáveis observadas.

Visualização da pilha de chamadas

Como habilitar pontos de interrupção

Os pontos de interrupção permitem pausar o processo de depuração durante a execução de um bot para inspecionar os valores das variáveis ​​observadas e o estado atual da automação. Para pausar e solucionar problemas de uma ação específica, você pode inserir um ponto de parada nessa ação. Quando você habilita o ponto de parada, a ação específica que está sendo depurada é destacada com um sinal de pausa. Depois de adicionar o ponto de interrupção para pausar a ferramenta de depuração, você pode Continuar no próximo ponto de interrupção, Passar para a próxima ação, Entrar na ação atual ou Parar o processo de depuração.
Nota: A habilitação de pontos de interrupção nos bots secundários durante a depuração não é compatível atualmente.
Ações Ícones e atalhos de teclado Descrição
Habilitar ponto de interrupção

Botão Habilitar ponto de interrupção

F9

Para inserir um ponto de interrupção, clique nas elipses verticais na linha de código específica e selecione Habilitar ponto de interrupção.

Como alternativa, você também pode habilitar um ponto de parada clicando no número da linha específica. Isso exibe um ícone de ponto de parada na parte superior do número da linha.

Nota: Quando você habilita um ponto de parada para uma linha de código específica, a ferramenta Depurar a destaca e a indica com um botão de pausa do lado direito da linha de código.
Desabilitar ponto de interrupção

Botão Desabilitar ponto de interrupção

F9

Para desabilitar um ponto de interrupção, clique nas elipses verticais na linha de código específica e selecione Desabilitar ponto de interrupção. O ponto de parada ficará inativo. Além disso, você também pode clicar no ícone de ponto de parada na parte superior do número da linha específico para desabilitá-lo.
Limpar todos os pontos de interrupção

Botão Limpar todos os pontos de interrupção

Shift + F9

Para limpar todos os pontos de interrupção, clique no ícone Limpar todos os pontos de interrupção.

Para mais informações sobre as ferramentas de depuração, consulte Aproveitando a análise de código e a ferramenta de depuração para melhorar e otimizar seu desenvolvimento de automação.