Ferramentas de depuração
- Última atualização2024/10/24
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.
- 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.
- 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.
- 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
- 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 Task Bot pacote (versão 2.8.0-20230530-152744 e superiores).
| Ações | Ícones | Atalhos de teclado | Descrição |
|---|---|---|---|
| Iniciar depuração |
|
F6 | Use Iniciar depuração para iniciar o processo de depuração. |
| Passar para a próxima ação |
|
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 |
|
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 |
|
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ê chama um bot secundário usando a ação . |
| Sair do bot atual |
|
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 |
|
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 eles estão. O bot que está ativo no momento é 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.
Pontos de parada
Pontos de interrupção na depuração são ferramentas que permitem pausar a execução de um programa ou automação em um ponto específico. Isso permite que você inspecione o estado atual do aplicativo, incluindo variáveis monitoradas e o fluxo de execução, garantindo que sua automação se comporte conforme o esperado.
Controles de ponto de interrupção
Habilitar pontos de interrupção em bots principais e secundários permite 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. Isso é útil para processos complexos e demorados que abrangem diversas tarefas ou automações secundárias.
| Ações | Ícones e atalhos de teclado | Descriçã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 |
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 |
Shift + F9 |
Para limpar todos os pontos de interrupção, clique no ícone Limpar todos os pontos de interrupção. |
Como usar pontos de interrupção para depuraçã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.
- Verificar um bot específico não criará uma nova versão do bot, pois ele não será mais modificado.
- Copiar um bot não copia os pontos de interrupção.
Você pode configurar pontos de interrupção rapidamente durante a depuração. Por exemplo, se você quiser verificar o status de um bot primário de um bot secundário existente, você pode ir até esse bot usando Pilha de chamadas e adicionar pontos de interrupção no bot principal conforme necessário. Após habilitar o ponto de interrupção, quando você clicar na opção Continuar para o próximo ponto de interrupção, o bot pausará no próximo ponto de interrupção, que é aquele que você acabou de adicionar.
- Considere que está automatizando o processo de integração de clientes e criou três bots para o processo, isto é, o bot Coletor de dados do cliente contendo um Processo de verificação bot que, por sua vez, contém um bot Comunicador de boas-vindas
- Habilite um ponto de interrupção no bot Comunicador de boas-vindas em que deseja que a depuração pause.
- Clique no ícone Iniciar depuração.
O bot entrará automaticamente no bot Comunicador de boas-vindas e pausará no ponto de interrupção definido.
- Saia do bot
Comunicador de boas-vindas.
Observe que a automação pausará diretamente no bot Coletor de dados do cliente.
Nota: Ao sair de qualquer bot específico, o bot deve, de forma ideal, pausar na linha depois daquela em que você entrou do bot pai. No entanto, no cenário, você não entrou de forma explícita no bot Comunicador de boas-vindas. Ele foi acessado de forma automática devido ao ponto de interrupção. - Da mesma forma, ao Sair na última linha do bot Comunicador de boas-vindas, o bot pausará diretamente no bot Coletor de dados do cliente.
Para mais informações sobre as ferramentas de depuração, consulte Leveraging code analysis and debug tool to improve and optimize your automation development.