Buscar y monitorear ejecuciones de flujos de trabajo

Después de que se ejecuta un flujo de trabajo, Flow proporciona un registro de lo que ocurrió, llamado ejecución de un flujo de trabajo, que te permite monitorear su rendimiento y comportamiento.

Acceder a las ejecuciones de flujos de trabajo

En la app Flow puedes monitorear todas las ejecuciones de flujos de trabajo. Revisarlas puede ayudarte a identificar posibles problemas en el comportamiento del flujo de trabajo.

Quizás quieras revisar ejecuciones de todos los flujos de trabajo cuando estés resolviendo problemas o no sepas qué flujo revisar. Si sabes específicamente qué flujo de trabajo quieres revisar, puedes acceder solo a las ejecuciones recientes de ese flujo.

Pasos:

Buscar una ejecución específica de un flujo de trabajo

En Flow puedes buscar ejecuciones de flujos de trabajo con cualquiera de estos métodos:

• Desde las páginas de recursos en el panel de control de Shopify, como un pedido o un producto.
• Desde la app Flow, puedes filtrar las listas de ejecuciones recientes con estos filtros de búsqueda comunes:
  • Por texto en los datos del paso, como la identificación del cliente o la identificación de pedido.
  • Por intervalo de tiempo, como la fecha y la hora en que debió ocurrir la ejecución.

Qué se puede buscar

En la app Flow, la lista de Ejecuciones recientes permite filtrar toda la lista de ejecuciones con cualquier combinación de los siguientes filtros:

• Incluye texto: Filtra por el contenido de texto sin formato de los datos usados en la ejecución del flujo de trabajo, como una identificación de pedido en la carga útil del activador o el nombre de la etiqueta en una condición.
• Flujos de trabajo: Filtra por el nombre del flujo de trabajo.
• Acciones realizadas: Filtra según si la ejecución realizó acciones (verdadero) o no hizo nada (falso).
• Errores: Filtra según si la ejecución contiene errores.
• Hora de inicio: Filtra por un intervalo de fecha y hora en el que la ejecución debió iniciar. Más información sobre filtrar ejecuciones por tiempo.
• Tipo de activador: Filtra según cómo se inició la ejecución. Las opciones incluyen un evento del activador, una ejecución manual o un reintento manual.
• Estado de los reintentos: Filtra según si la ejecución tiene reintentos o no.
• Identificación de la ejecución: Filtra por una identificación de ejecución específica. También puedes optar por incluir los reintentos relacionados con una identificación de ejecución especificada.
• Etiquetas: Filtra según qué etiquetas del flujo de trabajo aplican a la ejecución.

Antes de buscar, piensa qué información puedes buscar en la ejecución del flujo de trabajo. Esta información aparece en los detalles de la ejecución e incluye lo siguiente:

• Cualquier identificación de los recursos usados en la ejecución, como identificaciones de pedido o identificaciones del cliente.
• Cualquier texto o dato incluido en la ejecución, como el nombre de una etiqueta o el nombre del producto.

Además, cuando busques una ejecución de flujo de trabajo, ten en cuenta estas limitaciones:

• La búsqueda no distingue mayúsculas y minúsculas.
• La cadena de búsqueda no debe incluir signos de puntuación. Por ejemplo, si buscas una identificación de pedido, busca 43843493 en lugar de gid://shopify/Order/43843493.
• Los registros no contienen todos los detalles sobre los recursos usados en el flujo de trabajo. Por ejemplo, si usas una identificación de producto en el flujo, el registro de la ejecución no incluye el nombre del producto a menos que también hayas usado esos campos.
• La búsqueda está limitada a las ejecuciones de los últimos 14 días.

Buscar desde el panel de control de Shopify

En los recursos que tienen el menú Más acciones, puedes iniciar una búsqueda de ejecuciones de flujo de trabajo eligiendo la opción Buscar ejecuciones de Flow. Esta opción está disponible para los siguientes recursos:

• Pedidos
• Pedidos preliminares
• Clientes
• Productos
• Variantes
• Colecciones

Si tienes problemas para encontrar una ejecución, revisa qué se puede buscar.

Pasos:

1. En el panel de control de Shopify, abre el recurso que quieres buscar, como un pedido o un producto.
2. Haz clic en Más acciones.
3. Haz clic en Buscar ejecuciones de Flow.

Buscar por texto en los datos del paso

En la app Flow, puedes buscar cualquier dato que esté incluido en las secciones de datos del paso de una ejecución del flujo de trabajo.

Si tienes problemas para encontrar una ejecución, revisa qué se puede buscar.

Pasos:

1. En la lista de Ejecuciones recientes de la app Flow, haz clic en Agregar filtro.
2. Selecciona Incluye texto.
3. Ingresa el texto o la identificación que quieres buscar.

Buscar por intervalo de tiempo

Ten en cuenta lo siguiente para encontrar una ejecución por intervalo de tiempo:

• Si la zona horaria del dispositivo es distinta de la zona horaria de la tienda, la fecha y la hora de una ejecución pueden ser inexactas. Ten en cuenta esta diferencia en el filtro Hora de inicio que uses.
• En tiendas con alto volumen, quizá necesites usar un intervalo de tiempo acotado y otros filtros para facilitar la búsqueda de una ejecución específica.
• Las ejecuciones solo se almacenan durante 14 días después de que finalizan.
• Puede haber un retraso entre el momento en que se ejecuta un flujo de trabajo y cuando sus resultados se muestran en la página de Ejecuciones recientes. Si aún no aparecen los resultados de un flujo de trabajo reciente, espera unos minutos y vuelve a intentarlo.

Pasos:

1. En la lista de Ejecuciones recientes de la app Flow, haz clic en Agregar filtro y luego en Hora de inicio.
2. En el campo Desde, ingresa una fecha y hora iguales al momento en que debió ocurrir el evento. Por ejemplo, para el activador Pedido creado, usa la hora en que se creó el pedido. Asegúrate de ingresar el valor correcto de AM/PM.
3. En el campo Hasta, ingresa una fecha y hora 10 minutos posteriores a la fecha y hora de Desde.
4. Revisa los resultados. Por lo general, los flujos de trabajo se ejecutan exactamente al mismo tiempo que el evento activador o poco después.
5. Haz clic en un resultado que coincida con la hora y verifica que el recurso que se muestra sea el que buscas, por ejemplo, el pedido.

Columnas de la lista de ejecuciones recientes

La lista de ejecuciones recientes de un flujo de trabajo muestra datos clave sobre las ejecuciones:

Ver los detalles de una ejecución de flujo de trabajo

Para acceder a información detallada de un flujo de trabajo en particular, haz clic en la fila de la ejecución.

En la parte superior, la sección Estado indica si el flujo de trabajo se completó. La sección Acciones indica cuántas acciones del flujo de trabajo se ejecutaron correctamente.

La sección Detalles muestra una vista previa del flujo de trabajo y resalta las rutas que siguió.

Después de la vista previa del flujo de trabajo, puedes ver los resultados, los registros y los datos de cada paso del flujo de trabajo.

En cada paso, puedes expandir la sección Datos del paso para ver los datos que se usaron en la ejecución. Estos datos incluyen cualquier identificación de los recursos que se usaron en la ejecución, como identificaciones de pedido o de cliente, y cualquier texto o dato que se incluyó en la ejecución, como un nombre de etiqueta o el nombre del producto.

Flujos de trabajo con acciones 'bucle para cada'

Los flujos de trabajo que incluyen la acción For each loop (iterate) repiten pasos varias veces. Flow resalta cuántos artículos siguieron una ruta en la vista previa del flujo de trabajo.

Flow también muestra los resultados de cada iteración del bucle y te permite filtrar por acciones realizadas y errores para resolver rápidamente los problemas en los bucles.

Cancelar ejecuciones de flujos de trabajo en curso

Puedes cancelar una ejecución de flujo de trabajo con estado En curso o Limitado por tasa cuando quieras detener un flujo de trabajo antes de que termine. Cancelar una ejecución puede ser útil para evitar alcanzar los límites de la API, cuando notes que el flujo de trabajo no se ejecuta como se esperaba o para evitar que las ejecuciones con errores saturen la lista Ejecuciones recientes.

Consideraciones para cancelar ejecuciones de flujos de trabajo en curso

Antes de cancelar una ejecución en curso, revisa las siguientes consideraciones:

• Debes usar un dispositivo de escritorio para cancelar ejecuciones en la app Shopify Flow.
• No puedes cancelar ejecuciones que ya se completaron.
• Las ejecuciones canceladas no se pueden reanudar después. Si necesitas que el flujo de trabajo vuelva a ejecutarse, puedes esperar a que se active automáticamente, retry the run o start a new workflow run manually.
• Cancelar ejecuciones no desactiva automáticamente el flujo de trabajo asociado. Sin embargo, turning off a workflow sí cancela automáticamente todas sus ejecuciones en curso.
• Cancelar una ejecución puede tardar desde unos segundos hasta un minuto, según la complejidad del flujo de trabajo.

Cancelar ejecuciones en curso

Puedes cancelar una ejecución en curso en cualquier momento. Hay varias maneras de cancelar ejecuciones en curso:

• Para cancelar una ejecución específica, puedes hacerlo directamente desde la página de detalles de la ejecución.
• Para cancelar varias ejecuciones de un mismo flujo de trabajo, puedes cancelarlas de forma masiva desde la lista Ejecuciones recientes del flujo de trabajo.

Pasos:

Resolución de problemas de las ejecuciones de flujos de trabajo

En algunos casos, una ejecución de flujo de trabajo puede encontrar un error o no ejecutarse como se esperaba. Por lo general, esto ocurre cuando hay un problema de configuración en el flujo de trabajo. Más información sobre troubleshooting Flow errors y retrying workflow runs para corregir retroactivamente el resultado de ejecuciones anteriores.