# Menu "Depuração" **Depuração** é o processo de identificação e correção de erros no script do Robô. É recomendável realizá-la em todas as etapas-chave do projeto para controle passo a passo. No Sherpa Designer, além da depuração local do robô, está disponível a [depuração remota do robô](https://docs.sherparpa.ru/pt/sherpa-rpa/sherpa-designer/rabota-v-sherpa-designer/osnovnoe-menyu/panel-razrabotka/menyu-otladka/udalennaya-otladka-robota), assim como a possibilidade de construir um diagrama em modo de depuração, como demonstrado no vídeo: * Construção de diagrama em modo de depuração: {% embed url="" %} * Trabalhando com navegadores ao construir o diagrama em modo de depuração: {% embed url="" %} Principais ferramentas para depuração e teste no Sherpa RPA: * **Modo de Depuração com pontos de interrupção;** * **Console para verificação de variáveis;** * **Registro para controle de pontos críticos.** Há também outras funcionalidades avançadas [Try-Catch](https://docs.sherparpa.ru/pt/sherpa-rpa/sherpa-designer/spravochnik-blokov/osnovnye-bloki-main-blocks/try-catch-trycatchcontainer), assim como [depuração remota](https://docs.sherparpa.ru/pt/sherpa-rpa/sherpa-designer/rabota-v-sherpa-designer/osnovnoe-menyu/panel-razrabotka/menyu-otladka/udalennaya-otladka-robota). ## Exemplo de depuração Vamos imaginar uma tarefa em que é necessário desenvolver um Robô para transferir dados do Excel para um formulário da web. Vamos construí-lo aplicando as ferramentas básicas de depuração: * Adicione um bloco de carregamento de dados do documento Excel. * Carregue a tabela de dados e preencha o caminho para o arquivo. * Adicione um bloco "Obter valor da célula". Nas suas propriedades, especifique o nome da tabela, o número da linha e o número da coluna. O resultado será gravado na variável email. > Este passo é criticamente importante. Um erro ao ler os dados comprometerá todo o restante do script, portanto, certifique-se de incluir uma verificação. Se você colocar um ponto de interrupção diretamente neste bloco de leitura, não verificará nada, pois o ponto de interrupção faz uma pausa antes da execução do bloco em que está. Você verá o estado do sistema antes que os dados sejam lidos. * Adicione um bloco "Definir texto" e, nas suas propriedades, especifique onde gravar o email obtido. Coloque o primeiro ponto de interrupção nele. * Vá para as ferramentas de Depuração na barra superior e coloque um ponto de interrupção neste bloco (pressionando F9 ou através do menu de contexto). O bloco será destacado com uma borda vermelha. * Inicie o modo de depuração clicando na barra superior ou pressionando Ctrl+F6. A execução do script será interrompida no ponto de interrupção. Além disso, o bloco em que a execução do programa foi interrompida no momento será contornado por um retângulo azul. * Verifique o Robô, para isso, vá para o [Console](https://docs.sherparpa.ru/pt/obuchenie-po-razrabotke-na-platforme-sherpa-rpa/obuchenie-powershell#id-6.-ispolzovanie-lokalnoi-i-udalennoi-konsoli-powershell-v-dizainere-sherpa-rpa-dlya-proverki-vyrazhe) na parte inferior da interface. A variável email aparecerá com um valor incorreto. Como a numeração começa em `0`, na propriedade do bloco, você deve alterar a linha para `0` e a coluna para `1` (este é um erro de vinculação da coluna). Inicie o modo de depuração novamente e verifique se o valor da variável email agora está correto. ## Botão "Iniciar" O botão “**Iniciar**” no menu de desenvolvimento permite iniciar a execução do projeto (diagramas principais e aninhados) pelo Robô sem depuração ou pausar sua execução. Ao clicar neste botão, o agente Sherpa Robot é ativado e a janela do Sherpa Designer é minimizada. Além disso, ao clicar no botão “Iniciar”, ocorre o salvamento automático de todo o projeto. Ao clicar no ícone abaixo do botão “Iniciar”, será aberto um menu suspenso com opções de execução. * A opção “**Iniciar diagrama ativo sem depuração**” permite executar o diagrama ativo sem depuração. Além disso, para executar o diagrama ativo sem depuração, você pode usar a combinação de teclas Ctrl+F5. * A opção “**Iniciar em modo PiP**” permite iniciar a execução do projeto com exibição em uma janela separada do Robô.
## Botão "Depuração" O botão “**Depuração**” no menu de desenvolvimento permite iniciar o projeto atual em modo de depuração. Ao contrário do modo de execução normal, neste modo será possível interromper a execução do processo em pontos de interrupção e executar o processo passo a passo. Além disso, ao clicar no botão “Depuração”, ocorre o salvamento automático de todo o projeto. Ao clicar no ícone ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXc4Nsyy5setgxJEa9bpT0agD1x-Ke9XxVfjdA0N_SOvtUz7rge5KSAkWS2KgXbC4_iqli5p4-CmJ3tYuCJUJlLKj4Etqe1ydxXWxC6nRZsnZ_vUJpi1ynT_sBIYSFEzHO6pru880g?key=0bB9k7xLUHniK5eOXmSGqg) à direita do botão “Depuração”, será aberto um menu suspenso com opções de depuração. * A opção “**Depurar diagrama ativo**” permite iniciar a depuração do diagrama ativo. Além disso, para realizar a depuração do diagrama ativo, você pode usar a combinação de teclas Ctrl+F6. * A opção “**Depurar a partir do bloco atual**” permite iniciar a depuração a partir do bloco atual. Além disso, para realizar a depuração a partir do bloco atual, você pode usar a combinação de teclas Ctrl+Shift+F6. * A opção “**Configurações de depuração**” permite especificar os valores dos parâmetros que serão usados ao iniciar o projeto em modo de depuração, caso os parâmetros de entrada estejam especificados nas Propriedades do projeto. Ao definir os valores dos parâmetros de entrada, você pode iniciar a depuração do projeto exatamente com esses parâmetros de entrada.
A depuração a partir do bloco atual é demonstrada neste vídeo: {% embed url="" %} ## Botão "Ponto de interrupção" O botão “**Ponto de interrupção**” no menu de desenvolvimento permite pausar o processo de execução do script para visualizar os resultados de sua execução. O passo em que o Robô interromperá a execução do projeto. Com o botão "Ponto de interrupção", antes ou durante a execução do projeto, você pode marcar os blocos necessários onde o processo deve ser interrompido – e o processo automaticamente fará uma pausa quando sua execução chegar a esses blocos.
## Botão "Passo à frente" O botão “**Passo à frente**” no menu de desenvolvimento permite iniciar ou continuar a execução do projeto até o próximo bloco e, em seguida, pausar a execução, mas para blocos de subprocessos, a próxima parada será feita no bloco atual no próximo bloco após o subprocesso (ou seja, todo o subprocesso será executado completamente).
## Botão "Passo dentro" O botão “**Passo dentro**” no menu de desenvolvimento permite iniciar ou continuar a execução do projeto até o próximo bloco e, em seguida, pausar a execução, mas para blocos de subprocessos, a próxima parada será feita no primeiro bloco do diagrama do subprocesso. Se o bloco atual não for um bloco de subprocesso, as ações "Passo à frente" e "Passo dentro" terão o mesmo comportamento.
## Botão "Parar" O botão “**Parar**” no menu de desenvolvimento permite encerrar o trabalho do Robô e retornar ao modo de desenvolvimento.
## Recomendações para depuração e teste de processos RPA Para garantir o funcionamento confiável dos bots em produção e evitar erros inesperados, é necessário seguir os seguintes princípios e métodos de depuração: 1. **Verificação de cada variável, condição e seletor**\ Antes de iniciar e publicar, certifique-se de que todas as variáveis e condições estão configuradas corretamente e que os seletores funcionam com precisão. Isso ajudará a evitar erros durante a execução e garantir a operação estável do bot.2. **Projeto com validação**\ Inclua verificações de dados ao criar etapas do processo. O uso de mecanismos de validação integrados permite identificar dados incorretos nas primeiras fases do desenvolvimento. 2. **Desenvolvimento e teste interativos**\ Utilize o depurador para executar fragmentos individuais do processo à medida que eles estão prontos. Isso permite identificar e corrigir erros mais rapidamente, sem esperar pela compilação final de todo o processo. 3. **Adição de pontos de verificação**\ Como prática padrão, implemente pontos de log e mensagens de parada. Isso ajuda na rápida detecção de problemas e aumenta a gerenciabilidade do desenvolvimento. 4. **Teste de todos os novos blocos e ligações lógicas**\ Verifique regularmente o funcionamento de cada bloco ou ligação durante o desenvolvimento para garantir que estão funcionando corretamente. 5. **Monitoramento de valores de variáveis**\ Acompanhe os valores das variáveis em tempo real durante a execução do processo, para detectar discrepâncias ou erros prontamente. 6. **Registro de eventos importantes**\ Mantenha um registro de execução com foco em momentos e eventos-chave do processo. Isso facilita significativamente a análise de erros e melhora a qualidade do suporte. Seguir essas recomendações ajudará a criar processos de automação mais robustos, rápidos e de qualidade, além de elevar seu nível profissional na área de RPA. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.sherparpa.ru/pt/sherpa-rpa/sherpa-designer/rabota-v-sherpa-designer/osnovnoe-menyu/panel-razrabotka/menyu-otladka.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.