Editor de Flujos — Visión General
El Editor de Flujos es el corazón de QANode. Es donde creas, configuras y ejecutas tus escenarios de prueba de forma visual.
Interfaz del Editor
El editor está dividido en cuatro áreas principales:
Imagen: Editor de flujos mostrando las cuatro áreas: barra superior, paleta de nodos, canvas y panel de propiedades
1. Barra Superior
La barra superior contiene:
| Elemento | Descripción |
|---|---|
| Botón Volver | Regresa al proyecto (muestra una advertencia si hay cambios sin guardar) |
| Nombre del Flujo | Campo editable con el nombre del escenario |
| Botón Guardar | Guarda el flujo actual (Ctrl+S) |
| Botón Ejecutar | Ejecuta el flujo y muestra los resultados |
| Historial de Versiones | Abre snapshots guardados del escenario para consulta y restauración (Enterprise) |
| Menú de Opciones | Exportar, importar, duplicar y otras opciones |
2. Paleta de Nodos (Lado Izquierdo)
La paleta muestra todos los nodos disponibles organizados por categoría:
- Control de Flujo — If, Switch, Loop
- Web — Smart Web Flow, Web Flow, Smart Locators
- Mobile — Mobile Flow
- API — HTTP Request
- Base de Datos — PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, MongoDB
- Archivos — Generar Archivo, Extraer Archivo, Base64 a Archivo, Archivo a Base64
- Infraestructura — SSH Command
- Performance — Load Test
- Utilidades — Set Variable, Log, Wait, Stop and Fail, Custom JavaScript
- Nodos Personalizados — Nodos de proveedores registrados (si los hay)
Para agregar un nodo, arrástralo desde la paleta al canvas.
3. Canvas (Área Central)
El canvas es el área de trabajo donde posicionas y conectas los nodos. Funcionalidades:
| Acción | Cómo Hacerlo |
|---|---|
| Mover el canvas | Haz clic y arrastra el fondo (o usa la rueda del mouse) |
| Zoom | Rueda del mouse o pellizco en el trackpad |
| Seleccionar nodo | Haz clic en el nodo |
| Mover nodo | Arrastra el nodo |
| Seleccionar múltiples | Mantén Shift y haz clic, o arrastra un cuadro de selección |
| Eliminar nodo | Selecciona y presiona Delete o Backspace |
| Conectar nodos | Arrastra desde un handle de salida (●) hacia un handle de entrada (●) |
| Eliminar conexión | Haz clic en la conexión y presiona Delete |
| Pegar flujo | Ctrl+V con JSON de flujo copiado (p. ej., del Grabador de Chrome) |
| Agregar anotación | Haz clic derecho en el canvas o presiona Shift+A |
| Copiar/pegar nodo o anotación | Selecciona el elemento y usa Ctrl+C / Ctrl+V |
4. Panel de Propiedades (Lado Derecho)
Al seleccionar un nodo, el panel de propiedades aparece a la derecha con:
- Ejecutar: Ejecución del nodo en modo aislado
- Variables: Abre las propiedades de nodos anteriores, variables locales, variables globales y, cuando corresponda, variables del proyecto
- Configuración: Campos específicos del tipo de nodo
- Outputs: Esquema de salida del nodo (después de la ejecución, muestra los datos reales)
- Continuar en Fallo: Toggle para continuar el flujo incluso si el nodo falla
Flujo de Trabajo Típico
- Crea el escenario desde un proyecto
- Arrastra los nodos de la paleta al canvas
- Conecta los nodos arrastrando entre handles
- Configura cada nodo usando el panel de propiedades
- Guarda el flujo (Ctrl+S)
- Ejecuta y verifica los resultados
Orden de Ejecución
QANode ejecuta los nodos en orden topológico, determinado por las conexiones:
[A] → [B] → [D]
↘
[C] ──────→ [E]
En este ejemplo:
Ase ejecuta primeroByCpueden ejecutarse a continuación (después deA)Dse ejecuta después deBEse ejecuta después deByC
Nota: Si un nodo tiene múltiples entradas, solo se ejecuta cuando todos los nodos anteriores han completado.
Indicadores Visuales
Después de una ejecución, los nodos muestran indicadores de estado:
| Indicador | Significado |
|---|---|
| 🟢 Borde verde | Nodo ejecutado con éxito |
| 🔴 Borde rojo | Nodo falló |
| ⚪ Borde gris | Nodo omitido (rama no activada) |
| 🔵 Borde azul | Nodo en ejecución |
Atajos de Teclado
| Atajo | Acción |
|---|---|
Ctrl+S | Guardar flujo |
Delete / Backspace | Eliminar nodo o conexión seleccionada |
Ctrl+C | Copiar nodo |
Ctrl+V | Pegar nodo, anotación o JSON del Grabador de Chrome |
Ctrl+Z | Deshacer |
Ctrl+Shift+Z | Rehacer |
Shift+A | Crear anotación en el canvas |
Anotaciones en el Canvas
Las anotaciones ayudan a documentar partes del flujo directamente en el canvas. Úselas para explicar precondiciones, reglas de negocio, agrupaciones lógicas, pendientes u observaciones importantes para el equipo.
Las anotaciones soportan:
- texto libre;
- formato simple estilo Markdown;
- colores;
- redimensionamiento;
- arrastrar y posicionar en el canvas;
- copiar, pegar, duplicar y eliminar.
Puede crear una anotación desde el menú contextual del canvas o con Shift+A.
Cambios Sin Guardar
El editor detecta automáticamente cuando hay cambios sin guardar. Al intentar salir de la página (mediante el botón volver, navegación o cierre de pestaña), se mostrará una advertencia:
"¿Salir sin guardar?" Tienes cambios sin guardar. Si sales, tus cambios se perderán.
Esto protege contra la pérdida accidental de trabajo. La advertencia solo aparece cuando hay cambios reales, no al abrir un flujo sin modificarlo.
Historial de Versiones — Enterprise
QANode Enterprise puede mantener snapshots del escenario al guardar cambios relevantes en el flujo. El historial ayuda a auditar cambios, comparar versiones y volver a una versión anterior cuando sea necesario.
Para acceder:
- Abre el escenario en el editor.
- Haz clic en el icono de Historial de Versiones en la barra superior.
- Selecciona una versión para visualizar.
Al abrir una versión antigua, el escenario se muestra en modo de consulta. Puedes navegar por el canvas, seleccionar nodos y revisar parámetros, pero no editas directamente el snapshot.
Para volver a una versión anterior, usa Restaurar esta versión. QANode aplica ese snapshot como la versión actual del escenario y preserva la trazabilidad de la operación.
El historial de versiones está disponible solo en Enterprise. La cantidad de versiones retenidas es definida por el Super Admin en Configuración → General.
Próximos Pasos
- Trabajando con Nodos — Detalles sobre cómo agregar, conectar y configurar nodos
- Ejecución y Depuración — Cómo ejecutar flujos y diagnosticar fallos
