Ejecución y Depuración

Aprende cómo ejecutar tus flujos, interpretar resultados y diagnosticar fallos.

Ejecutando un Flujo

Ejecución Completa

Para ejecutar todo el flujo:

1. Asegúrate de que el flujo esté guardado
2. Haz clic en el botón Ejecutar (▶️) en la barra superior
3. Espera la finalización — los nodos mostrarán indicadores de estado en tiempo real

Imagen: Canvas mostrando nodos con indicadores de estado durante la ejecución

Ejecución Visual de Flujos Web — Enterprise

Al iniciar una ejecución completa con el botón Ejecutar del canvas, desactivar Headless en al menos un nodo Smart Web Flow, Web Flow o Smart Locators activa el modo visual para esa ejecución.

El comportamiento depende de dónde se ejecuta QANode:

Live View pertenece a la ejecución iniciada desde el canvas, no a un único nodo. Por eso:

• el panel permanece abierto hasta que la ejecución finaliza con éxito, falla, se cancela o el usuario lo cierra;
• mientras el flujo ejecuta nodos que no usan navegador, como HTTP Request, IF, base de datos o Wait, no se produce una nueva imagen web y la última pantalla puede permanecer visible;
• si otro nodo web se ejecuta después, el mismo panel vuelve a acompañar el navegador sin cerrar y abrir una nueva ventana;
• mantener el panel abierto no significa necesariamente que el navegador anterior siga ejecutándose: el ciclo de vida del navegador todavía depende de la estrategia de sesión configurada en el nodo.

Este modo visual se activa únicamente para una ejecución interactiva iniciada por un usuario desde el canvas. Las suites, programaciones, CI/CD, tokens de integración, API y otros procesos externos no abren automáticamente una ventana ni Live View.

Al usar Ejecutar en el panel de propiedades, la visualización permanece limitada al nodo seleccionado.

Estado de Ejecución

Cancelando Ejecuciones

Las ejecuciones en curso pueden ser canceladas por usuarios con el permiso run.cancel.

Dónde cancelar:

• Editor del escenario: durante la ejecución, el botón de ejecutar cambia a un botón de parada.
• Lista de ejecuciones: usa el menú de acciones de la ejecución en curso.
• Ejecución de suite: cancelar la ejecución principal también cancela los escenarios pendientes o en ejecución de esa suite.

Al cancelar, el estado final queda como Cancelado. Las evidencias y logs ya generados hasta ese punto permanecen disponibles para consulta.

La cancelación ocurre en puntos seguros de la ejecución. Los nodos web, Smart Web, mobile, API, base de datos, SSH, carga y JavaScript personalizado verifican la solicitud de cancelación durante el procesamiento. En nodos con navegador o sesión mobile, QANode también intenta cerrar recursos abiertos para evitar sesiones atascadas.

Una acción externa muy larga puede terminar el tramo actual antes de reconocer la cancelación. En esos casos, QANode cancela tan pronto como la ejecución vuelve a un punto seguro.

Analizando Resultados

Después de la ejecución, haz clic en cualquier nodo para ver sus resultados en el panel de propiedades:

Pestaña de Resultados

Outputs

Los outputs de cada nodo quedan accesibles para nodos siguientes mediante expresiones. Por ejemplo, después de ejecutar un HTTP Request, los outputs serán:

{
  "status": 200,
  "body": {
    "id": 1,
    "name": "João",
    "email": "joao@exemplo.com"
  }
}

Luego puedes acceder a estos datos en nodos siguientes:

{{ steps["http-request"].outputs.body.name }}  →  "João"
{{ steps["http-request"].outputs.status }}     →  200

Cuando el output es un archivo, el valor principal es un fileRef:

{{ steps["http-request"].outputs.fileRef }}
{{ steps["file-generate"].outputs.fileRef }}

En el panel de variables, los archivos muestran nombre, MIME type y tamaño en los detalles. Los campos internos como el camino en el storage quedan ocultos en la visualización principal.

Screenshots (Evidencias)

Para nodos web (Smart Web Flow, Web Flow y Smart Locators), las capturas de pantalla aparecen como miniaturas clicables. Haz clic para verlas a tamaño completo.

Archivos

Los archivos generados o capturados durante la ejecución aparecen en la sección Archivos del detalle de la ejecución. Al descargarlos, el navegador usa el nombre real del archivo cuando está disponible, en vez de un identificador interno de la ejecución.

Los archivos de prueba aislada creados en el editor son temporales y pueden limpiarse automáticamente cuando el usuario sale del flujo o por una rutina de limpieza.

Depurando Fallos

Identificando el Nodo con Problema

1. Busca nodos con borde rojo (🔴) en el canvas
2. Haz clic en el nodo con fallo
3. Verifica el mensaje de error y los logs

Sugerencias Amigables de Fallo

Cuando un paso falla por un error conocido, el detalle de la ejecución puede mostrar una sección Causa posible con una sugerencia objetiva. Aparece solo en pasos con fallo y QANode muestra una sugerencia por vez para evitar mensajes contradictorios.

Las sugerencias cubren problemas comunes como sesión expirada, credenciales, expresiones rotas, archivos ausentes, objetivo ambiguo, campo oculto, deshabilitado o de solo lectura, clic bloqueado, timeout, assert que no coincide y efecto esperado que no apareció después de la acción.

Use la sugerencia como punto de partida y confirme en las evidencias, logs y capturas de pantalla antes de cambiar el flujo.

Mensajes de Error Comunes

Web Flow / Smart Locators

HTTP Request

Base de Datos

SSH

Usando Logs para Diagnóstico

Los logs de cada nodo proporcionan detalles sobre cada paso ejecutado. Para nodos web, los logs muestran:

Navigated to: https://exemplo.com/login
Filled: "usuario@exemplo.com" on [getByLabel("E-mail")]
Clicked: [getByRole("button", { name: "Entrar" })]
Assert passed: textContains "Bem-vindo" — true

Si un paso falló, el log mostrará exactamente cuál paso y por qué:

Navigated to: https://exemplo.com/login
Filled: "usuario@exemplo.com" on [getByLabel("E-mail")]
ERROR: Click failed after 3 attempts: [getByRole("button", { name: "Login" })] — element not found

Consejos de Depuración

1. Desactiva el Modo Headless

Para pruebas web, desactiva el modo headless en el nodo para ver el navegador en acción:

• En el nodo Smart Web Flow, Web Flow o Smart Locators, desmarca Headless
• Al usar Ejecutar en el panel de propiedades, la visualización muestra solo el nodo seleccionado
• Al ejecutar el flujo completo desde el canvas en un servidor, Live View acompaña toda la ejecución web en el mismo panel
• Las suites, programaciones, CI/CD y llamadas externas continúan ejecutándose sin abrir la visualización interactiva

2. Agrega Pasos de Wait

Si los elementos aparecen con retraso, agrega pasos de wait antes de interactuar:

• wait con modo visible espera que el elemento aparezca
• wait con modo networkIdle espera que todas las solicitudes de red terminen

3. Captura Screenshots para Diagnóstico

Activa las capturas de pantalla en modo antes para ver el estado de la página antes de cada acción. Esto ayuda a identificar si la página estaba en el estado esperado.

4. Verifica las Expresiones

Si un nodo falla con un valor inesperado, agrega un nodo Log antes de él para inspeccionar los valores:

Valor del token: {{ steps.login.outputs.body.token }}
Estado: {{ steps["http-request"].outputs.status }}

5. Usa el Toggle "Continuar en Fallo"

Para diagnosticar múltiples fallos a la vez, activa Continuar en Fallo en los nodos de verificación. Esto permite que el flujo continúe y puedas ver todos los fallos en una única ejecución.

Abrir un Defecto desde una Ejecución Fallida — Enterprise

Cuando una ejecución termina con fallo, el botón Abrir Defecto queda disponible en el detalle de la ejecución. Al hacer clic, se abre un modal para completar la información del defecto — título, descripción, severidad, prioridad y demás campos definidos por el flujo de trabajo.

El defecto creado queda automáticamente vinculado a la ejecución, al escenario y al paso que originó el fallo.

Permiso requerido: bug.create

Defectos relacionados

El detalle de la ejecución también muestra la sección Defectos Relacionados con la lista de todos los defectos vinculados a esa ejecución — bug key, título, estado y severidad — con enlace directo a cada defecto.

Reporte de Ejecución

Después de cada ejecución, QANode pone a disposición un reporte PDF con:

• Resumen de la ejecución (estado, duración, fecha)
• Detalles de cada paso (estado, logs, outputs, duración)
• Capturas de pantalla tomadas
• Errores encontrados

El reporte está disponible en la lista de ejecuciones del proyecto y puede descargarse o enviarse por correo electrónico. Según la plantilla activa, el PDF puede generarse automáticamente al finalizar la ejecución o solo cuando alguien solicita la descarga.

Próximos Pasos

• Referencia de Nodos — Detalles completos de cada tipo de nodo
• Expresiones — Domina el sistema de datos dinámicos