Obtener datos de la página

En los flujos de trabajo que requieren datos de la página, puedes usar la acción Obtener datos de la página para recuperar la información de la página de la tienda. Las Páginas son las páginas web de la tienda online que contienen información que rara vez cambia, como una página "Conócenos" o de contacto.

Nota

Este es un tipo de acción Obtener datos. Para entender cómo usar este tipo de acción con el activador Hora programada y los bucles Para cada, consulta Programaciones, obtención de datos y flujos de trabajo en bucle en Shopify Flow.

Configuración

Campos

La acción Obtener datos de la página contiene los siguientes campos:

Campos utilizados en las acciones Obtener datos.

Campo	Descripción
Ordenar datos por	Obligatorio. Los parámetros con los que se ordenan los datos devueltos por 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. Se pueden devolver hasta 100 a la vez.
Consulta	Obligatorio. Elige entre consultas comunes o selecciona Avanzado para crear la tuya propia.

Cadena de consulta

Este es un ejemplo de consulta para obtener páginas publicadas:

published_status:published

La variable published_status es un filtro disponible en la consulta de Páginas y se puede usar varias veces o combinarse con otras variables.

Al consultar datos, es útil saber lo siguiente:

• Lista de filtros de página disponibles

• Las consultas deben seguir una sintaxis determinada

• Los valores de los campos de consulta no siempre están documentados. En algunos casos, los valores se pueden encontrar en la documentación de la API. Como alternativa, a menudo puedes encontrar los valores de los campos en las URL del panel de control cuando filtras. Por ejemplo, para encontrar algunos valores de la consulta de pedidos, filtra la página Pedidos en el panel de control y luego revisa la URL.

• Puedes ejecutar o probar una consulta en la tienda utilizando la aplicación GraphiQL de Shopify.

• Ten en cuenta lo que ocurre si tu consulta falla. A menudo la API devuelve todos los resultados (en lugar de ninguno).

Datos devueltos

Todas las acciones Obtener datos devuelven una lista de entre 0 y 100 recursos. Según el caso de uso, es posible que quieras usar estos datos de varias formas:

• Si necesitas gestionar cada artículo de la lista individualmente, como para agregar una etiqueta a cada uno, puedes usar la acción Para cada.
• Si necesitas agregar datos, como contar cuántos resultados se devolvieron, puedes usar las acciones Contar o Sumar.
• Si necesitas generar la lista, como 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 de la página, que es una lista de páginas. Puedes usar esta variable tanto en las condiciones como en las acciones. Por ejemplo, puedes enviar la lista de páginas en una acción Enviar correo electrónico interno similar a esta:

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

Nota

Si se usa una acción Obtener datos varias veces en un solo flujo de trabajo, se agrega un número al nombre de la variable. Por ejemplo, en un flujo de trabajo que usa la acción Obtener datos del pedido dos veces, la primera variable para los datos devueltos es getOrderData y la segunda es getOrderData1. Este nombre no se puede personalizar.

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 comienza en la hora que hayas especificado en lugar de como resultado de un evento. Dado que no hay ningún evento específico en la tienda o desde una aplicación que inicie el flujo de trabajo, no se incluyen datos 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 de Páginas.