Obtener entradas de metaobjeto
Puedes utilizar la acción Obtener entradas de metaobjeto para recuperar una lista de entradas para un metaobjeto de tu tienda en función de la consulta opcional. Consulta la documentación sobre metaobjetos para obtener más información.
En esta página
Configuración
Campos
La acción Obtener entradas de metaobjeto contiene un menú desplegable para especificar la definición del metaobjeto , así como los siguientes campos, que se utilizan para crear la consulta:
Campo | Descripción |
---|---|
Ordenar datos por | Obligatorio. Los parámetros con que se ordenan los datos obtenidos por la consulta de búsqueda. |
Cantidad máxima de resultados | Obligatorio. La cantidad máxima de resultados que puede mostrar la consulta de búsqueda que selecciones. Puedes mostrar hasta 100 a la vez. |
Consulta | Obligatorio. Elige entre las consultas comunes o selecciona Avanzada para crear la tuya. |
Cadena de consulta
Este es un ejemplo de consulta para obtener entradas de metaobjetos si el valor de un campo email
coincide con la dirección de correo electrónico de un pedido:
{{fields.email}}:"{{order.email}}"
Este es un ejemplo de consulta para obtener entradas de metaobjeto que se actualizaron en el último día:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'
La variable updated_at
es un filtro disponible en la consulta de metaobjetos y puede utilizarse varias veces o combinarse con otras variables. La variable Liquid scheduledAt
está disponible en los flujos de trabajo que utilizaron el activador Hora programada. La etiqueta de Liquid date_minus
es una etiqueta especial de Flow que te permite restar tiempo de una fecha.
Cuando se consultan datos, es útil saber lo siguiente:
- Lista de filtros de metaobjeto disponibles
- Para consultar metaobjetos por valor de campo es necesario que los metaobjetos tengan los filtros habilitados, que se pueden habilitar en las opciones para datos personalizados del panel de control de Shopify. - Las consultas deben seguir una sintaxis determinada.
- Los valores de campo de consulta no siempre se documentan. En algunos casos, los valores se pueden encontrar si se revisan los documentos de la API. O bien, a menudo puedes encontrarlos en las URL en el panel de control cuando filtras. Por ejemplo, para encontrar algunos valores de consulta de pedidos, filtra la página Pedidos en el panel de control y luego verifica la URL.
- Puedes ejecutar o probar una consulta en la tienda mediante la aplicación Shopify GraphiQL.
- Ten cuidado con lo que sucede si falla la consulta. A menudo, la API mostrará todos los resultados (en lugar de ninguno).
Datos obtenidos
Todas las acciones Obtener datos muestran una lista de 0 a 100 recursos desde cualquier lugar. Según corresponda, es posible que desees utilizar estos datos de varias maneras:
- Si necesitas gestionar cada elemento de la lista de forma individual, como agregar una etiqueta para cada uno, puedes usar la acción Para cada.
- Si necesitas sumar los datos, como contar cuántos resultados se mostraron, puedes usar las acciones Recuento o Suma.
- Si necesitas exportar la lista, como enviar un correo electrónico con todos los elementos, puedes usar los datos obtenidos directamente en acciones posteriores.
Para acceder a los datos obtenidos en los pasos que siguen a esta acción, utiliza la variable con el nombre Obtener entradas de metaobjeto, que consiste en una lista de entradas de metaobjeto. Puedes usar esta variable tanto en estados como en acciones. Por ejemplo, puedes enviar la lista de pares clave-valor para las entradas de metaobjeto en una acción de Enviar un correo electrónico interno como la siguiente:
{% for getMetaobjectEntries_item in getMetaobjectEntries %}
Key-value pairs for entry:
{% for fields_item in getMetaobjectEntries_item.system.fields %}
{{fields_item.key}}:{{fields_item.value}}
{% endfor %}
{% endfor %}
Activadores
Puedes usar esta acción en cualquier flujo de trabajo, incluido el activador Hora programada. Un flujo de trabajo que use el activador Hora programada empezará a la hora que especifiques, en lugar de hacerlo como resultado de un evento. Como no hay ningún evento específico de la tienda o de una aplicación que inicie el flujo de trabajo, no se incluye ningún dato automáticamente.