# Menú "Depuración"

**Depuración** es el proceso de búsqueda y corrección de errores en el script del Robot. Se recomienda realizarla en todas las etapas clave del proyecto para un control paso a paso.

En Sherpa Designer, además de la depuración local del robot, está disponible la [depuración remota del robot](https://docs.sherparpa.ru/es/sherpa-rpa/sherpa-designer/rabota-v-sherpa-designer/osnovnoe-menyu/panel-razrabotka/menyu-otladka/udalennaya-otladka-robota), así como la posibilidad de construir un diagrama en modo de depuración, lo que se demuestra en el video:

* Construcción de un diagrama en modo de depuración:

{% embed url="<https://sherparpa.ru/ucontent/?D0>" %}

* Trabajo con navegadores al construir un diagrama en modo de depuración:

{% embed url="<https://sherparpa.ru/ucontent/?D1>" %}

Principales herramientas para depuración y pruebas en Sherpa RPA:

* **Modo Depuración con puntos de interrupción;**
* **Consola para verificar variables;**
* **Registro para controlar puntos críticos.**

Hay otras funcionalidades avanzadas [Try-Catch](https://docs.sherparpa.ru/es/sherpa-rpa/sherpa-designer/spravochnik-blokov/osnovnye-bloki-main-blocks/try-catch-trycatchcontainer), así como [depuración remota](https://docs.sherparpa.ru/es/sherpa-rpa/sherpa-designer/rabota-v-sherpa-designer/osnovnoe-menyu/panel-razrabotka/menyu-otladka/udalennaya-otladka-robota).

## Ejemplo de depuración

Imaginemos una tarea en la que se requiere desarrollar un Robot para transferir datos de Excel a un formulario web. Lo construiremos utilizando las herramientas básicas de depuración:

* Agregue un bloque de carga de datos desde el documento de Excel.
* Cargue la tabla de datos y complete la ruta al archivo.
* Agregue un bloque "Obtener valor de celda". En sus propiedades, indique el nombre de la tabla, el número de fila y el número de columna. El resultado se guardará en la variable email.

> Este paso es críticamente importante. Un error al leer los datos pondrá en riesgo todo el script posterior, por lo que es imprescindible prever una verificación. Si coloca un punto de interrupción directamente en este bloque de lectura, no podrá verificar nada, porque el punto de interrupción hace una pausa antes de ejecutar el bloque en el que se encuentra. Verá el estado del sistema antes de que se lean los datos.

* Agregue un bloque "Establecer texto", y en sus propiedades indique dónde se guarda el email obtenido. Establezca en él el primer punto de interrupción.
* Vaya a las herramientas de Depuración en la barra superior y coloque un punto de interrupción en este bloque (presionando F9 o a través del menú contextual). El bloque se resaltará con un marco rojo.
* Inicie el modo de depuración haciendo clic en la barra superior o presionando Ctrl+F6. La ejecución del script se detendrá en el punto de interrupción. Además, el bloque en el que la ejecución del programa se ha detenido en ese momento se rodea con un rectángulo azul.
* Verifique el Robot, para ello, vaya a la [Consola](https://docs.sherparpa.ru/es/obuchenie-po-razrabotke-na-platforme-sherpa-rpa/obuchenie-powershell#id-6.-ispolzovanie-lokalnoi-i-udalennoi-konsoli-powershell-v-dizainere-sherpa-rpa-dlya-proverki-vyrazhe) en la parte inferior de la interfaz. La variable email aparecerá con un valor incorrecto. Dado que la numeración comienza desde `0`, en la propiedad del bloque es necesario cambiar la fila a `0` y la columna a `1` (este es un error de vinculación de columna). Inicie el modo de depuración nuevamente y verifique que el valor de la variable email ahora sea correcto.

## Botón "Iniciar"

El botón “**Iniciar**” en el menú de desarrollo permite iniciar la ejecución del proyecto (diagramas principales y anidados) por el Robot sin depuración o pausar su ejecución. Al hacer clic en este botón, se activa el trabajo del agente Sherpa Robot, y la ventana de Sherpa Designer se minimiza. Además, al hacer clic en el botón “Iniciar”, se guarda automáticamente todo el proyecto. Al hacer clic en el ícono debajo del botón “Iniciar”, se abrirá un menú desplegable de opciones de inicio.

* La opción “**Iniciar diagrama activo sin depuración**” permite activar el diagrama activo sin depuración. También, para ejecutar el inicio del diagrama activo sin depuración, se puede utilizar la combinación de teclas Ctrl+F5.
* La opción “**Iniciar en modo PiP**” permite iniciar la ejecución del proyecto mostrando en una ventana separada el inicio del Robot.

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-c2609f5630ad40cc31adea7569d2566380fbf0e7%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(66).png?alt=media" alt=""><figcaption></figcaption></figure>

## Botón "Depuración"

El botón “**Depuración**” en el menú de desarrollo permite iniciar el proyecto actual en modo de depuración. A diferencia del modo de ejecución normal, en este modo estará disponible la detención de la ejecución del proceso en los puntos de interrupción y la ejecución del proceso paso a paso. Además, al hacer clic en el botón “Depuración”, se guarda automáticamente todo el proyecto. Al hacer clic en el ícono ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXc4Nsyy5setgxJEa9bpT0agD1x-Ke9XxVfjdA0N_SOvtUz7rge5KSAkWS2KgXbC4_iqli5p4-CmJ3tYuCJUJlLKj4Etqe1ydxXWxC6nRZsnZ_vUJpi1ynT_sBIYSFEzHO6pru880g?key=0bB9k7xLUHniK5eOXmSGqg) a la derecha del botón “Depuración”, se abrirá un menú desplegable de opciones de depuración.

* La opción “**Depuración del diagrama activo**” permite iniciar la depuración del diagrama activo. También, para ejecutar la depuración del diagrama activo, se puede utilizar la combinación de teclas Ctrl+F6.
* La opción “**Depuración desde el bloque actual**” permite iniciar la depuración desde el bloque actual. También, para ejecutar la depuración desde el bloque actual, se puede utilizar la combinación de teclas Ctrl+Shift+F6.
* La opción “**Configuraciones de depuración**” permite especificar los valores de los parámetros que se utilizarán al iniciar el proyecto en modo de depuración, si en las Propiedades del proyecto se han especificado parámetros de entrada. Al establecer los valores de los parámetros de entrada, se puede iniciar la depuración del proyecto precisamente con esos parámetros de entrada.

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-cbe5c1ebf185d3769b048aefc89361ceff4c6526%2F2025-07-22_22-49-08.png?alt=media" alt=""><figcaption></figcaption></figure>

La depuración desde el bloque actual se demuestra en este video:

{% embed url="<https://sherparpa.ru/ucontent/?TZjc>" %}

## Botón "Punto de interrupción"

El botón “**Punto de interrupción**” en el menú de desarrollo permite hacer una pausa en el proceso de ejecución del script para ver los resultados de su ejecución. El paso en el que el Robot detendrá la ejecución del proyecto. Con el botón "Punto de interrupción", antes o durante el inicio del proyecto, se pueden marcar los bloques necesarios en los que el proceso debe ser pausado, y el proceso se detendrá automáticamente cuando su ejecución llegue a esos bloques.

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-201ca5aae6acd7e61cc3768ca0a54b87080a434c%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(67).png?alt=media" alt=""><figcaption></figcaption></figure>

## Botón "Paso adelante"

El botón “**Paso adelante**” en el menú de desarrollo permite iniciar o continuar la ejecución del proyecto hasta el siguiente bloque y, luego, pausar la ejecución, pero para los bloques de subprocesos, la siguiente detención se realizará en el bloque siguiente al subproceso en el diagrama actual (es decir, todo el subproceso se ejecutará completamente).

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcIHmuH1Sk5YvC4K2OZSrDXRQEaEYELdzYBjcQjHAO9epkteDHEiy8Njgm-Jb4M4F1bwX4HBMzdjaV4bpp3V1QeDHH47qi8AljynS7TdslT1oh4LZX-5US1lXq9Mh_gUCF9Mi5d?key=0bB9k7xLUHniK5eOXmSGqg" alt=""><figcaption></figcaption></figure>

## Botón "Paso dentro"

El botón “**Paso dentro**” en el menú de desarrollo permite iniciar o continuar la ejecución del proyecto hasta el siguiente bloque y, luego, pausar la ejecución, pero para los bloques de subprocesos, la siguiente detención se realizará en el primer bloque del diagrama del subproceso.

Si el bloque actual no es un bloque de subproceso, entonces las acciones "Paso adelante" y "Paso dentro" se verán iguales.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf4nI5imTXQsdxr0p33I3hxnBpOwU8ytWdvSAZMrSTKWu-5OoE6gbg6C21n60UF8K2_GrWWW16HQPXPMoMkpEU1gG5luDU6Kc6-z2C_0c_J2OmpKGaY2IsERvmct3ZSLAcfgmCMug?key=0bB9k7xLUHniK5eOXmSGqg" alt=""><figcaption></figcaption></figure>

## Botón "Detener"

El botón “**Detener**” en el menú de desarrollo permite finalizar el trabajo del Robot y regresar al modo de desarrollo.

<figure><img src="https://3940823687-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8QfFNyYLPzoIrRZpZokA%2Fuploads%2Fgit-blob-5af0daca83bdb4a1ee090f6f659022ef29a39c06%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(68).png?alt=media" alt=""><figcaption></figcaption></figure>

## Recomendaciones para la depuración y prueba de procesos RPA

Para asegurar el funcionamiento confiable de los bots en producción y prevenir errores inesperados, es necesario seguir los siguientes principios y métodos de depuración:

1. **Verificación de cada variable, condición y selector**\
   Antes de iniciar y publicar, asegúrese de que todas las variables y condiciones estén configuradas correctamente, y que los selectores funcionen con precisión. Esto ayudará a evitar errores durante la ejecución y garantizar un funcionamiento estable del bot.2. **Diseño con validación**\
   Incluya verificaciones de datos al crear pasos del proceso. El uso de mecanismos de validación integrados permite identificar datos incorrectos en las primeras etapas del desarrollo.
2. **Desarrollo y prueba interactiva**\
   Utilice un depurador para ejecutar fragmentos individuales del proceso a medida que estén listos. Esto permite identificar y corregir errores más rápidamente, sin esperar a la compilación final de todo el proceso.
3. **Adición de puntos de control**\
   Como práctica estándar, implemente puntos de registro de control y mensajes de detención. Esto facilita la detección rápida de problemas y mejora la manejabilidad del desarrollo.
4. **Pruebas de todos los nuevos bloques y enlaces lógicos**\
   Verifique regularmente el funcionamiento de cada bloque o enlace durante el desarrollo para asegurarse de que funcionen correctamente.
5. **Monitoreo de valores de variables**\
   Supervise los valores de las variables en tiempo real durante la ejecución del proceso para detectar discrepancias o errores a tiempo.
6. **Registro de eventos importantes**\
   Mantenga un registro de la ejecución con énfasis en los momentos y eventos clave del proceso. Esto facilita significativamente el análisis de errores y mejora la calidad del soporte.

Seguir estas recomendaciones ayudará a crear procesos de automatización más robustos, rápidos y de calidad, además de elevar su nivel profesional en el á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/es/sherpa-rpa/sherpa-designer/rabota-v-sherpa-designer/osnovnoe-menyu/panel-razrabotka/menyu-otladka.md?ask=<question>
```

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.
