Previsualiza los datos de la API usados en Shopify Flow
La mayoría de los flujos de trabajo acceden a los datos de la tienda para usarlos en condiciones y acciones. Shopify Flow accede a los datos de la tienda llamando a la GraphQL Admin API, lo que permite acceder a casi todos los campos de la API.
Cuando creas un flujo de trabajo, a menudo encontrarás nombres de campos y descripciones basados en la API, pero quizá necesites conocer los valores de esos datos. Por ejemplo, quizá quieras saber el nombre de la aplicación para un pedido que se creó a partir de un pedido preliminar. Además, quizá quieras asegurarte de que el flujo de trabajo produce los datos que esperas o en el formato que esperas.
Para revisar los valores de los datos, hay varias opciones en Shopify Flow.
En esta página
Buscar un campo en el panel de control de Shopify
En la mayoría de los casos, puedes encontrar los datos en el panel de control de Shopify. Por ejemplo, product.title aparece en la página Producto.
Obtener datos de ejemplo
Cuando creas un flujo de trabajo, puedes obtener datos de ejemplo directamente en el editor de Flow. Como los datos de Flow provienen de eventos, para obtener datos de ejemplo precisos debes empezar eligiendo un evento relevante:
- En el editor de Flow, abre una acción donde quieras usar los datos y haz clic en Agregar variable. Como alternativa, en una condición, haz clic en Agregar criterio.
- Haz clic en Configurar datos de ejemplo.
- Flow muestra eventos anteriores según el activador del flujo de trabajo. Haz clic en Actualizar eventos para obtener eventos de ejecuciones recientes o en Comenzar a escuchar eventos en vivo y luego activa el evento manualmente en el panel de control o en la aplicación correspondiente (para activadores basados en una aplicación).
- Cuando ocurra el evento, Flow mostrará los detalles. Elige el evento que quieras usar para obtener datos de ejemplo. Haz clic en Usar este evento de activación.
- Ahora, al explorar los eventos, se mostrarán datos de ejemplo para cada variable.
Limitaciones:
- Por limitaciones de espacio, cuando los datos están en una lista, Flow solo muestra los del primer elemento.
- Flow almacena hasta 5 eventos a la vez por flujo de trabajo.
- Flow no puede obtener eventos de ejecuciones recientes para algunos activadores, como Hora programada, Se creó una entrada de metaobjeto, Cliente se unió al segmento o Cliente abandonó el segmento.
Usar el campo en un flujo de trabajo activo
Puedes usar de forma segura los campos en un flujo de trabajo mediante la acción Registrar salida. Cuando ejecutes un flujo de trabajo, la acción Registrar salida mostrará la salida de cualquier variable y texto en la página Historial de ejecuciones. También puedes usar acciones de notificación como Enviar correo electrónico interno.
Pasos para usar Registrar salida:
- Elige un activador que puedas activar manualmente.
- Agrega la acción Registrar salida al flujo de trabajo y conéctala al activador.
- En la configuración de Registrar salida, haz clic en Agregar variable para añadir las variables que quieras revisar a la sección Salida.
- Cuando termines, haz clic en Activar flujo de trabajo.
- Activa el flujo de trabajo, ya sea ejecutándolo manualmente o provocando que se dispare el activador. Por ejemplo, si usas el activador Pedido creado, crea un pedido de prueba.
- Después de que se ejecute el flujo de trabajo, revisa el registro de actividad para ver las variables.
Consultar la página JSON del recurso
La mayoría de las páginas de recursos en el panel de control de Shopify, como las páginas Pedido, Producto o Cliente, permiten ver los datos que alimentan la página. Estos datos no usan exactamente los mismos nombres ni el mismo formato que Shopify Flow, pero los valores coinciden con los de la GraphQL Admin API. Para revisar los datos, agrega .json a la URL.
Por ejemplo, ve al panel de control de Shopify, entra a la página Pedidos y haz clic en un pedido. En la barra de direcciones del navegador, cambia la dirección de:
https://https://admin.shopify.com/store/<shopname>/orders/3804849891234
por la siguiente:
https://https://admin.shopify.com/store/<shopname>/orders/3804849891234.json
Usar GraphiQL o una herramienta de API externa
Puedes consultar la API directamente con una herramienta de API externa como Postman o con la herramienta gratuita de Shopify, GraphiQL. Esta opción ofrece resultados más precisos, pero requiere cierta familiaridad con la creación de consultas GraphQL.
Para GraphiQL, Shopify ofrece un explorador de GraphiQL en la web con datos genéricos y la aplicación GraphiQL. Con GraphiQL, puedes crear una consulta GraphQL que coincida exactamente con los nombres de los campos en Shopify Flow. Si usas la aplicación, los valores también coinciden exactamente con los de la tienda.
Con esta herramienta puedes determinar con precisión qué datos usa Shopify Flow, con datos reales de la tienda. Por ejemplo, crea la siguiente consulta:
{
orders(first:5, reverse:true) {
nodes {
createdAt
app {
name
}
channelInformation {
app {
title
}
}
}
}
}En los siguientes resultados, la variable order / app / name muestra el nombre de la aplicación del pedido. En este caso, el pedido se creó desde la aplicación Draft Orders, por lo que el valor es Draft Orders. La información del canal solo está disponible para la aplicación Point of Sale.
{
"data": {
"orders": {
"nodes": [
{
"createdAt": "2023-04-10T12:32:41Z",
"app": {
"name": "Draft Orders"
},
"channelInformation": null
},
{
"createdAt": "2023-04-10T12:29:12Z",
"app": {
"name": "Draft Orders"
},
"channelInformation": null
},
{
"createdAt": "2023-03-17T20:23:10Z",
"app": {
"name": "Draft Orders"
},
"channelInformation": null
},
{
"createdAt": "2023-03-17T20:20:53Z",
"app": {
"name": "Draft Orders"
},
"channelInformation": null
},
{
"createdAt": "2023-03-17T15:45:15Z",
"app": {
"name": "Point of Sale"
},
"channelInformation": {
"app": {
"title": "Point of Sale"
}
}
}
]
}
}