Obtener datos del artículo
En los flujos de trabajo que requieren datos de artículos de blog, puedes usar la acción Obtener datos del artículo para recuperar información de los artículos de tu tienda Shopify.
Configuración
Campos
La acción Obtener datos del artículo contiene los siguientes campos:
| Campo | Descripción |
|---|---|
| Ordenar datos por | Obligatorio. Los parámetros con los que se ordenan los datos que devuelve la consulta de búsqueda. |
| Número máximo de resultados | Obligatorio. La cantidad máxima de resultados que puede devolver la consulta de búsqueda que selecciones. Puedes obtener hasta 100 a la vez. |
| Consulta | Obligatorio. Elige entre consultas comunes o selecciona Avanzada para crear la tuya. |
Cadena de consulta
Este es un ejemplo de consulta para obtener artículos publicados el último día:
published_at:<='{{ scheduledAt }}' AND published_at:>'{{ scheduledAt | date_minus: "1 day" }}'La variable published_at es un filtro disponible en la consulta Articles y se puede usar varias veces o combinarse con otras variables. La variable de Liquid scheduledAt está disponible en los flujos de trabajo que usan el activador Hora programada. La etiqueta de Liquid date_minus es una etiqueta especial de Flow con la que puedes restar tiempo a una fecha.
Cuando consultas datos, es útil saber lo siguiente:
Las consultas deben seguir una sintaxis determinada
Los valores de los campos de consulta no siempre están documentados. En algunos casos, se pueden encontrar en la documentación de la API. Como alternativa, a menudo puedes encontrarlos en las URL del panel de control cuando usas filtros. Por ejemplo, para encontrar algunos valores de la consulta Order, filtra la página Pedidos en el panel de control y luego revisa la URL.
Puedes ejecutar o probar una consulta en tu tienda usando la aplicación Shopify GraphiQL.
Ten en cuenta lo que sucede si la consulta falla. A menudo, la API devuelve todos los resultados (en lugar de ninguno).
Datos devueltos
Todas las acciones de tipo Obtener datos devuelven una lista de entre 0 y 100 recursos. Dependiendo de tu caso de uso, puedes usar estos datos de varias formas:
- Si necesitas gestionar cada elemento de la lista de forma individual, por ejemplo, para agregar una etiqueta a cada uno, puedes usar la acción Para cada uno.
- Si necesitas agregar datos, por ejemplo, para contar cuántos resultados se devolvieron, puedes usar las acciones Contar o Sumar.
- Si necesitas generar la lista, por ejemplo, para enviar un correo electrónico con todos los artículos, puedes usar los datos devueltos directamente en las acciones posteriores.
Para acceder a los datos devueltos en los pasos que siguen a esta acción, usa la variable llamada Obtener datos del artículo, que es una lista de artículos. Puedes usar esta variable tanto en las condiciones como en las acciones. Por ejemplo, puedes enviar la lista de artículos en una acción Enviar correo electrónico interno similar a esta:
{% for single_article in GetArticleData %}
* {{ single_article.title }}
{% endfor %}Activadores
Puedes usar esta acción en cualquier flujo de trabajo, incluido el activador Hora programada. En un flujo de trabajo que usa el activador Hora programada, el flujo de trabajo se inicia a la hora que hayas especificado, en lugar de como resultado de un evento. Dado que no hay ningún evento específico en tu tienda o de una aplicación que inicie el flujo de trabajo, no se incluye ningún dato automáticamente.
Referencia de la API
Para obtener más información sobre la API que se usa en esta acción, consulta la consulta Articles.