Flujo de trabajo
Crea, prueba, implementa y revisa flujos de trabajo de proyecto reutilizables cuando el constructor está disponible.
Flujo de trabajo convierte un proceso repetible en pasos conectados que Runner puede ejecutar con las mismas entradas y reglas una y otra vez.
Condicional: La interfaz de Flujo de trabajo existe, pero la navegación estándar del proyecto actual no expone una entrada de Flujo de trabajo. Úsala solo cuando Runner muestre una entrada de Flujo de trabajo aprobada para tu espacio de trabajo o cuando el soporte de Runner proporcione una ruta aprobada. No adivines ni edites una URL para acceder a ella. Si tu plan permite solo una vista previa, Runner puede mostrar la página mientras mantiene sus controles bloqueados.
Ruta de acceso
Abre la entrada de Flujo de trabajo solo cuando Runner la presente en tu espacio de trabajo. La página enumera los flujos de trabajo del proyecto actual. Si no hay entrada presente, usa Disponibilidad de funciones o contacta con soporte en lugar de intentar una URL directa.
Antes de empezar
- El acceso a Flujo de trabajo depende del lanzamiento de funciones actual y del plan.
- Confirma el proyecto y los servicios conectados antes de probar o implementar un flujo de trabajo.
- Una vista previa o borrador guardado no está activo; la implementación y la activación son acciones separadas y consecuentes.
Lista de flujos de trabajo
Cuando no hay flujos de trabajo, selecciona Crear flujo de trabajo. Cuando la lista ya tiene elementos, usa Nuevo flujo de trabajo.
| Control | Qué sucede después de seleccionarlo |
|---|---|
| Crear flujo de trabajo o Nuevo flujo de trabajo | Abre Crear un flujo de trabajo. |
| En blanco | Crea un Flujo de trabajo sin título y abre su constructor. |
| Tarjeta de plantilla | Crea un flujo de trabajo a partir de esa plantilla y abre su constructor. Si las plantillas no se cargan, Reintentar las solicita de nuevo. |
| Nombre del flujo de trabajo | Abre ese flujo de trabajo en el constructor. |
| Renombrar | Hace que el nombre sea editable. Presionar Intro o hacer clic fuera guarda; Escape cancela la edición. |
| Fijar en la parte superior / Desfijar | Mueve el flujo de trabajo hacia o fuera del grupo fijado. No ejecuta el flujo de trabajo. |
| Duplicar | Crea una copia y abre la copia en el constructor. |
| Exportar | Descarga el flujo de trabajo como archivo JSON. No implementa ni ejecuta nada. |
| Eliminar | Abre una confirmación. Confirmar elimina permanentemente ese flujo de trabajo y no se puede deshacer. |
Usa el menú Más de cada fila para encontrar Renombrar, Fijar en la parte superior o Desfijar, Duplicar, Exportar y Eliminar.
Las etiquetas de fila también pueden mostrar si una versión es Activa, tiene un Borrador adelante, expone un Punto final, o está vinculada a una Programación o Evento. Una etiqueta pausada o bloqueada por plan significa que el desencadenamiento automático no está activo actualmente.
Trabajar con varios flujos de trabajo
Selecciona la casilla de verificación junto a una o más filas. La barra de selección muestra cuántas están seleccionadas y ofrece:
- Exportar para descargar los flujos de trabajo seleccionados.
- Eliminar para abrir una confirmación masiva. Confirmar elimina permanentemente cada flujo de trabajo seleccionado.
- Limpiar para eliminar la selección sin cambiar ningún flujo de trabajo.
Seleccionar todo selecciona los flujos de trabajo mostrados en la lista actual. Siempre recomprueba el recuento antes de la eliminación masiva.
Construir y guardar
El lienzo del constructor es donde añades pasos, los conectas y configuras qué recibe y hace cada paso. Añadir componente abre la biblioteca de componentes que se puede buscar. Los controles del lienzo amplían, reducen, ajustan el flujo de trabajo en la pantalla y organizan automáticamente los pasos conectados.
Los cambios se guardan automáticamente; no hay un botón Guardar separado. La flecha Atrás finaliza un guardado pendiente antes de volver a la lista de flujos de trabajo.
| Estado de guardado | Qué hacer |
|---|---|
| Guardando… | Espera antes de cerrar la página o implementar. |
| Guardado | El último cambio del lienzo se almacena. |
| Error al guardar | Selecciona Reintentar después de verificar la conexión. |
| Conflicto — tus cambios no se guardaron | Una versión guardada es más reciente. Recargar descarta las ediciones locales conflictivas y carga la versión guardada. |
El panel inferior contiene Área de pruebas e Historial. En Área de pruebas, completa las entradas de texto, producto o medios requeridas antes de ejecutar. El control de ejecución permanece no disponible mientras falten entradas requeridas. Los resultados aparecen en el área de salida.
El menú Más del constructor también proporciona Exportar JSON e Importar JSON…. Exportar descarga el lienzo actual. Importar reemplaza inmediatamente el lienzo actual y desencadena el guardado automático sin confirmación, así que exporta una copia de seguridad y verifica el archivo seleccionado antes de importar.
Elige la prueba correcta
Las pruebas pueden tener consecuencias muy diferentes.
| Control | Qué sucede después de seleccionarlo |
|---|---|
| Simular sin llamar a APIs | Abre un diálogo de simulación. Usa datos de muestra generados o pega JSON, luego selecciona Ejecutar simulación. Las acciones del lado de escritura como correos electrónicos, publicaciones de Slack y cambios de tienda se simulan. |
| Prueba en vivo — efectos secundarios reales, marcados como isTest | Abre un diálogo de prueba en vivo. Usa datos generados, JSON pegado o un evento reciente cuando esté disponible. Ejecutar prueba en vivo realiza llamadas API reales y puede enviar mensajes o cambiar servicios conectados. La ejecución se marca como prueba en el historial. |
| Omitir esperas | Durante una prueba en vivo, omite los períodos de espera configurados para que la prueba pueda continuar antes. No elimina otros efectos reales. |
| Ejecutar flujo de trabajo | Inicia el flujo de trabajo configurado inmediatamente y abre Historial. Sus pasos pueden tener efectos reales; revisa cada paso e entrada primero. |
| Detener ejecución | Solicita que se detenga la ejecución actual. El trabajo ya completado no se revierte. |
| Caché | En una reejecución, omite nodos elegibles cuyas entradas no han cambiado para que puedas enfocarte en el trabajo modificado aguas abajo. |
Usa Simulación para verificar ramificación y flujo de datos. Usa Prueba en vivo solo cuando los efectos secundarios reales sean aceptables en las cuentas conectadas.
Revisar historial de ejecución
Abre Historial en el panel inferior para ver ejecuciones anteriores. Filtra la lista con En vivo, Prueba o Todo, luego selecciona una ejecución para inspeccionar sus resultados de nodo, salida, tiempo y errores. Los estados incluyen Completado, Error, En ejecución y Cancelado.
Si la lista dice Sin ejecuciones aún, el flujo de trabajo actual no tiene ejecución registrada. Iniciar otra ejecución no es una solución para una fallida; abre primero la ejecución fallida y lee su error.
Algunos nodos fallidos elegibles ofrecen Reintentar desde "nodo". Esto inicia un nuevo intento inmediatamente, sin otra confirmación. Las acciones aguas abajo pueden ejecutarse de nuevo, así que verifica primero los mensajes o cambios de tienda ya producidos por la ejecución fallida.
Implementar y activar
Selecciona Implementar para abrir Implementar flujo de trabajo. Revisa el resumen de cambios, compatibilidad del contrato API, resultados de validación y registro de cambios opcional antes de continuar.
Opcionalmente, puedes vincular el flujo de trabajo implementado a una programación o un evento. Solo se puede seleccionar uno de esos tipos de desencadenamiento a la vez.
- Implementar publica una versión con la configuración seleccionada.
- Activar e implementar aparece cuando una nueva vinculación de programación o evento haría que la automatización esté activa. Confirmarlo publica la versión y permite que futuros desencadenadores se ejecuten automáticamente con efectos reales.
Un error de guardado, conflicto sin resolver o problema de validación puede bloquear la implementación. Resuélvelo en lugar de seleccionar Implementar repetidamente.
Después de la implementación, el estado de producción puede mostrar No implementado, Borrador adelante o Activo, más Sin desencadenador, Activo o Pausado para la vinculación. Abrir una vinculación existente ofrece controles consecuentes:
- Pausar detiene los desencadenadores automáticos pero mantiene el flujo de trabajo y la vinculación.
- Reanudar permite que la vinculación retenida se desencadene de nuevo.
- Eliminar elimina permanentemente la vinculación pero no elimina el flujo de trabajo.
Cada acción abre una confirmación e puede incluir un motivo. Eliminar la marca de una vinculación existente durante la implementación pausa esa vinculación en lugar de eliminarla permanentemente.
Historial de versiones y reversión
Selecciona Historial de versiones para abrir el panel Historial de versiones.
| Acción | Resultado |
|---|---|
| Revertir | Abre ¿Revertir a esta versión?. Confirmar hace que la versión implementada seleccionada reemplace la versión implementada actual. Esto puede cambiar lo que hacen las ejecuciones futuras, pero no reemplaza el lienzo de borrador actual. |
| Restaurar en Historial de borradores | Reemplaza el lienzo actual con el borrador guardado seleccionado después de la confirmación. Los cambios del lienzo sin guardar o más recientes se pueden perder. |
Añade un motivo de reversión opcional para que otros miembros del espacio de trabajo entiendan el cambio. Revisa el lienzo restaurado y el estado de implementación antes de iniciar otra ejecución.
Lista de verificación de operación segura
- Confirma que estás en el proyecto y flujo de trabajo correcto.
- Espera a Guardado antes de probar o implementar.
- Completa y revisa cada entrada requerida.
- Comienza con Ejecutar simulación cuando sea posible.
- Usa Prueba en vivo o Ejecutar flujo de trabajo solo cuando sus efectos de servicio conectado sean aceptables.
- Inspecciona Historial y salidas antes de implementar.
- Trata Activar e implementar, reversión, restauración y eliminación como acciones consecuentes que requieren una revisión final.
Solución de problemas
| Problema | Siguiente paso |
|---|---|
| No hay entrada de Flujo de trabajo visible | Esto es esperado en la navegación estándar. No adivines una URL; consulta Disponibilidad de funciones o pregunta al soporte de Runner si tu espacio de trabajo tiene una entrada aprobada. |
| Los controles están bloqueados por una vista previa del plan | Sigue el mensaje del plan en pantalla o pregunta a un propietario del espacio de trabajo sobre el acceso. |
| La lista de plantillas falla | Selecciona Reintentar o crea un flujo de trabajo En blanco. |
| El botón de ejecución no está disponible | Completa cada entrada requerida y corrige cualquier valor inválido. |
| Aparece conflicto de guardado | Decide si la versión guardada debe ganar antes de seleccionar Recargar, porque las ediciones locales conflictivas se descartan. |
| La ejecución falla | Ábrela en Historial, mantén visible el error e entradas, y evita iniciar ejecuciones idénticas repetidamente. |
| La implementación está bloqueada | Resuelve los mensajes de guardado, conflicto, contrato o validación mostrados en el diálogo de implementación. |