Fundamentos de la depuración

Depura un flujo de trabajo en el lienzo: inicia una ejecución de depuración, lee los resultados, encuentra fallos y prueba partes de un flujo de trabajo con simulacros.

La depuración se produce en el mismo lienzo donde se crea un flujo de trabajo. No hay una vista de depuración independiente: una ejecución de depuración se inicia desde el lienzo, el panel debajo del lienzo muestra los resultados y los cambios se realizan en el lienzo cuando aparece un problema.

Iniciar una sesión de depuración

Run Debug (▶) in the bottom toolbar of the canvas starts a debug run, in every tool. If the trigger has inputs, a dialog asks for their values. In Studio Web, Debug at the top left of the toolbar does the same. A panel appears below the canvas, and the execution trace fills in as each node runs.

Detener depuración finaliza la ejecución explícitamente, y cualquier cambio en el flujo de trabajo también la finaliza. El lienzo Flujo describe los controles de depuración y el panel debajo del lienzo en su totalidad.

Leer los resultados

La pestaña Ejecuciones debajo del lienzo tiene tres partes, cada una de las cuales responde a una pregunta diferente:

• Ejecuciones de depuración: la lista de ejecuciones, con el nombre, la duración y la antigüedad de cada una.
• Seguimiento de ejecución: cada nodo que se ejecutó, en orden, con tiempo y un indicador de éxito o fallo. Al seleccionar un nodo en el seguimiento, se resalta en el lienzo, y al pasar el ratón sobre un nodo se muestra cuándo comenzó y finalizó.
• Detalles: para una ejecución, las pestañas Variables, Incidentes y Metadatos . Para un nodo, las entradas que recibió y las salidas que produjo.

La pestaña Incidentes enumera los errores de la ejecución, agrupados por nodo. Cada incidente nombra el nodo que falló e incluye el mensaje de error. Es mejor comprobar primero una parada inesperada allí.

La pestaña Variables muestra los valores de las variables de runtime en tres secciones: Entradas (valores pasados al flujo de trabajo), Salidas (valores que produce) y Variables (variables internas del flujo de trabajo). La selección de un nodo en el seguimiento muestra el estado en ese punto. Un campo Filtrar variables busca los valores por nombre.

Identificación de fallos

Después de una ejecución de depuración, cada nodo del lienzo muestra un indicador de éxito o fallo. El nodo fallido también se marca en el seguimiento de ejecución, y la pestaña Incidentes muestra el mensaje de error.

El objeto de error incluye un campo message (descripción legible por humanos) y un campo detail (causa técnica). El campo message contiene el resumen de fallos orientado al usuario, por lo que es el lugar para empezar.

Usar nodos simulados

Un simulacro estático prueba parte de un flujo de trabajo de forma aislada. Un nodo con un simulacro estático no se ejecuta y pasa los datos simulados a los nodos posteriores. Esto es útil cuando un nodo anterior es lento, necesita credenciales que no están disponibles localmente o depende de sistemas externos. La vista expandida del nodo, que se abre al hacer doble clic en el nodo, tiene un menú de modo en la columna Salida . El simulacro estático reemplaza la respuesta real con datos que los nodos posteriores esperan, y Generado tiene un LLM que produce la respuesta. La salida simulada describe ambos.

Simular varios nodos a la vez permite que la ejecución de depuración se centre en una sección específica del flujo de trabajo.

Consejos

• El seguimiento de la ejecución primero, los incidentes después: el seguimiento muestra toda la ejecución y los incidentes muestran solo lo que se rompió.
• Los valores de las variables revelan discrepancias en los datos: compara los datos que recibió un nodo con los datos que esperaba el siguiente nodo.
• Simular dependencias externas permite una iteración más rápida: simular un nodo que llama a una API o desencadena un proceso RPA permite depurar la lógica sin esperar a sistemas externos.
• Las iteraciones pequeñas son más rápidas: una corrección por ciclo de depuración es más eficiente que intentar solucionarlo todo de una vez.
• Los nombres de nodos descriptivos mejoran la legibilidad del seguimiento: el seguimiento y los incidentes hacen referencia a los nombres de los nodos, y los nombres que describen lo que hace un nodo hacen que los seguimientos sean más fáciles de escanear.

Próximos pasos

• El lienzo de flujo: los controles de depuración y el panel debajo del lienzo.
• Gestión de errores: configurar ramas de error en nodos.
• Variables y flujo de datos: cómo funcionan las variables en los nodos.
• Comunidad: haz preguntas y comparte flujos de trabajo con otros constructores en UiPath Forum.