Herramientas de depuración

Las herramientas de depuración le permiten solucionar problemas de automatizaciones complejas con tareas anidadas. Depure los bots principales y secundarios individuales dentro de la matriz para identificar y resolver problemas rápidamente y en detalle. Puede examinar cada automatización secundaria individualmente, asegurándose de que cada parte de la automatización funcione correctamente, lo que lleva a procesos de automatización más eficientes y confiables.

Uso de la herramienta Depuración

En la página de Automatización, seleccione y edite el bot que desee depurar. Puede acceder a la herramienta Depuración desde la utilidad Ayudante o desde el Editor de bots.

Acceder a la herramienta Depuración

Al activar la herramienta Depuración desde Editor de bots:
  • Puede agregar, actualizar o eliminar acciones y variables dentro de un bot. Puede seguir editando el bot, siempre y cuando el proceso de depuración no haya iniciado.
  • Cuando inicia la depuración, aparece una barra de encabezado violeta debajo del nombre del bot en el Editor de bots que muestra Depuración en progreso seguido del actual nombre del bot que se está depurando.
  • La barra de encabezado también muestra una lista de pila jerárquica de bots, igual a la que se muestra en la Pila de llamadas. De esta lista de pila de bots, puede navegar a un bot específico y verificar en qué línea ingresó para acceder al bot secundario actual. La barra de encabezado también muestra un enlace al que puede hacer clic para navegar hacia el bot actual para continuar con la depuración en caso de que salga del bot actual.
  • Debajo de la barra de encabezado, se muestran los mismos controles de depuración que se muestran en el Asistente para poder acceder rápido para controlar la depuración.
  • El panel Acciones situado en el lado izquierdo del Editor de bots se contrae automáticamente. Esto ayuda a proporcionar un área más horizontal para ver las acciones agregadas en el Editor de bots mientras se realiza la depuración. Una vez que la depuración se detiene, el panel Acciones se expande de nuevo.
Nota:
  • Invocar un depurador no inicia el proceso de depuración.
  • Antes de iniciar el proceso de depuración, asegúrese de corregir cualquier error de validación en sus bots.
  • Puede depurar el bot en las vistas de Flujo and Lista. Sin embargo, para una mayor visibilidad de sus acciones, le recomendamos que depure su bot en la vista de Lista.
Cuando abre la utilidad Asistente desde el Editor de bots, el editor API o el editor de plantillas, y lo mueve a una posición específica, el editor conservará la última posición de la utilidad Asistente incluso después de que salga del editor. La posición predeterminada de la utilidad Asistente corresponderá a la última posición a la que la movió, antes de salir del editor:
  • Incluso si la sesión de un usuario finaliza o si el navegador se cierra de manera abrupta.
  • Incluso si abre el editor desde un navegador diferente o inicia sesión en una sesión diferente con las mismas credenciales de usuario.

Esto mejora la usabilidad del Asistente, porque ya no es necesario mover el Asistente a la derecha del editor para ver el panel de Acciones cada vez que abre el bot dentro del editor.

Controles de depuración

Nota:
  • No hay límite para el número de bots secundarios a los que puede entrar.
  • La capacidad de depuración del bot secundario es compatible con el Agente de bot de Bot de tarea (versión 22.60.23 y posteriores) y paquete (versión 2.8.0-20230530-152744 y posteriores).
Acciones Íconos Teclas de acceso directo Descripción
Iniciar depuración Botón de inicio F6 Use Iniciar depuración para iniciar el proceso de depuración.
Pasar por encima a la siguiente acción Botón de omitir F7 Utilice Pasar a la siguiente acción para depurar una acción a la vez. Después de depurar la acción actual, puede utilizar Pasar a la siguiente acción para pasar a la siguiente acción de la secuencia.
Continuar al siguiente punto de interrupción Botón de continuar al siguiente punto de interrupción F6 Utilice Continuar al siguiente punto de interrupción para pasar directamente al siguiente punto de interrupción. Continuar al siguiente punto de interrupción ejecuta la acción actual, para luego pasar al siguiente punto de interrupción y hacer una pausa.
Nota: Cuando la depuración está en proceso, el ícono Iniciar depuración cambia a Continuar al siguiente punto de interrupción.
Entrar a la acción actual Botón de entrar F8 Utilice Entrar a la acción actual para entrar en el bot secundario para depurar. Entrar a la acción actual está habilitado solo cuando llama a un bot secundario usando la acción TaskBot > Ejecutar.
Salir del bot actual Botón de salir Mayús + F8 Utilice Salir del bot actual para salir del bot secundario después de depurar y hacer una pausa en la siguiente línea del bot desde donde entró.
Nota: Salir del bot actual se habilita solo después de entrar al bot secundario.
Detener la depuración Botón de detener Mayús + F6 Use Detener la depuración para detener el proceso de depuración.

Pila de llamadas

La pila de llamadas le permite determinar con facilidad el orden en que se llaman los bots y navegar rápidamente de un bot al siguiente. La pila de llamadas enumera las automatizaciones que están actualmente activas, entre las que se incluyen los bots principales y secundarios, con el número de línea y la carpeta en la que se encuentran. El bot que está actualmente activo se resalta y se muestra en la parte superior de la lista.

La pila de llamadas le permite rastrear la ruta del error desde su origen para comprender cómo ocurrió. Esto ayuda a identificar el origen de los problemas, especialmente en automatizaciones complejas con anidamiento multinivel.

Cuando ingresa, el bot secundario se agrega a la pila de llamadas. Cuando sale del bot secundario o completa la depuración del bot secundario, el bot se elimina de la pila de llamadas. El bot principal se convierte ahora en el bot actual que se está depurando.

En función del bot que haya seleccionado en la pila de llamadas, las variables vigiladas mostrarán las variables para ese bot seleccionado. Luego puede seleccionar la variable para observar su valor actual desde la lista de Variables vigiladas .

Vista de pila de llamadas

Puntos de interrupción

Los puntos de interrupción en la depuración son herramientas que le permiten pausar la ejecución de un programa o automatización en un punto específico. Esto le permite inspeccionar el estado actual de la aplicación, incluidas las variables observadas y el flujo de ejecución, lo que garantiza que su automatización se comporte como se espera.

Controles de punto de interrupción

Habilitar puntos de interrupción en los bots principal y secundario le permite pausar el proceso de depuración durante la ejecución de un bot para examinar los valores de las variables vigiladas y el estado actual de la automatización. Para pausar y solucionar los problemas de una acción específica, puede insertar un punto de ruptura en esa acción en particular. Esto es útil para procesos complejos y de larga duración que abarcan múltiples tareas o automatizaciones secundarias.

Revise la siguiente tabla para aprender cómo habilitar y deshabilitar puntos de interrupción.
Acciones Iconos y atajos de teclado Descripción
Habilitar punto de interrupción

Botón de habilitar punto de interrupción

F9

Para insertar un punto de interrupción, haga clic en los tres puntos verticales de la línea de código específica y seleccione Habilitar punto de interrupción.

De manera alternativa, también puede activar un punto de interrupción al hacer clic en el número de línea específica. Esto muestra un ícono de punto de ruptura situado encima del número de línea.

Nota: Al activar un punto de interrupción para una línea de código específica, la herramienta Depuración la resalta y la señala con un botón de pausa a la derecha de la línea de código.
Inhabilitar punto de interrupción

Botón de inhabilitar punto de interrupción

F9

Para inhabilitar un punto de interrupción, haga clic en los tres puntos verticales y seleccione Inhabilitar punto de interrupción. El punto de ruptura se vuelve inactivo. Además, también puede hacer clic en el ícono del punto de interrupción situado encima del número de línea específico para inhabilitarlo.
Borrar todos los puntos de interrupción

Botón de borrar todos los puntos de interrupción

Mayús + F9

Para borrar todos los puntos de interrupción, haga clic en el ícono Borrar todos los puntos de interrupción.

Cómo usar puntos de interrupción para depurar

Al activar el punto de interrupción, la acción específica que se está depurando aparece resaltada con un signo de pausa al lado. Después de agregar el punto de interrupción para pausar la herramienta de depuración, puede Continuar al siguiente punto de interrupción, Pasar por encima a la siguiente acción, Entrar a la acción actual o Detener el proceso de depuración.

Los puntos de interrupción añadidos a un bot específico durante la depuración se guardan automáticamente, lo que garantiza que todos los puntos de interrupción se conserven incluso si cierra y vuelve a abrir su automatización o cambia entre diferentes sesiones de depuración.
Nota:
  • Registrar un bot específico no creará una nueva versión del bot ya que ya no se modifica.
  • Copiar un bot no copia los puntos de interrupción.

Puede configurar puntos de interrupción sobre la marcha durante la depuración. Por ejemplo, si desea verificar el estado del bot principal de un bot secundario existente, puede navegar hasta ese bot a través de la Pila de llamadas y agregar puntos de interrupción dentro del bot principal según sea necesario. Después de habilitar el punto de interrupción, al hacer clic en la opción Continuar al siguiente punto de interrupción, el bot se detendrá en el siguiente punto de interrupción, que es el que acaba de agregar.

Exploremos un escenario en el que habilita puntos de interrupción en bots específicos mientras depura una automatización y observa cómo se comporta.
  1. Considere una automatización donde tiene un bot principal (A) que contiene un bot secundario (B), que a su vez contiene un bot terciario (C).
  2. Habilite un punto de interrupción dentro del bot terciario (C) donde desea que la depuración se detenga.
  3. Haga clic en el ícono Iniciar depuración.

    El bot entrará automáticamente en el bot terciario (C) y se detendrá en el punto de interrupción establecido.

  4. Salga del bot terciario (C).

    Notará que la automatización se detendrá directamente en el bot principal (A).

    Nota: Al salir de cualquier bot específico, lo ideal es que el bot se detenga en la línea inmediatamente siguiente a aquella en la que entró desde su bot principal. Sin embargo, en este escenario, no entró explícitamente en el bot terciario (C); ingresó automáticamente debido al punto de interrupción.
  5. De manera similar, cuando realiza un Paso a paso desde la última línea del bot terciario (C), el bot se detendrá directamente en el bot principal (A).

Para obtener más información sobre las herramientas de depuración, consulte Leveraging code analysis and debug tool to improve and optimize your automation development.