Obtener entradas de metaobjeto

Usa la acción Obtener entradas de metaobjeto para recuperar una lista de entradas de un metaobjeto de la tienda según la consulta opcional. Consulta metaobjects documentation para obtener más información.

Configuración

Campos

La acción Obtener entradas de metaobjeto incluye una lista desplegable para especificar la metaobject definition y los siguientes campos, que se usan para crear la consulta:

Cadena de consulta

Este es un ejemplo de consulta para obtener entradas de metaobjeto 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 durante 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 usarse varias veces o combinarse con otras variables. La variable de Liquid scheduledAt está disponible en flujos de trabajo que usan el activador Hora programada. La etiqueta de Liquid date_minus es una etiqueta especial de Flow que permite restar tiempo a una fecha.

Cuando consultes datos, es útil saber lo siguiente:

• Lista de filtros de metaobjeto disponibles
• Consultar metaobjetos por valor de campo requiere que el metaobjeto tenga el filtrado habilitado, lo cual se puede habilitar en las opciones de datos personalizados del panel de control de Shopify.
• Las consultas deben seguir una sintaxis determinada
• Los valores de los campos de la consulta no siempre están documentados. En algunos casos, puedes encontrarlos en la documentación de la API. También puedes encontrarlos en las URL del panel de control cuando aplicas filtros. Por ejemplo, para encontrar algunos valores de 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 con la aplicación Shopify GraphiQL.
• Ten en cuenta qué sucede si la 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, quizá quieras utilizar estos datos de distintas maneras:

• 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.
• Si necesitas calcular agregados, como contar cuántos resultados se devolvieron, puedes usar las acciones Contar o Sumar.
• Si necesitas incluir la lista, por ejemplo enviar un correo electrónico con todos los elementos, puedes usar los datos devueltos directamente en acciones posteriores.

Para acceder a los datos devueltos en los pasos que siguen a esta acción, usa la variable llamada Get metaobject entries, que es una lista de entradas de metaobjeto. Puedes usar esta variable tanto en condiciones como en acciones. Por ejemplo, puedes enviar la lista de pares clave-valor de las entradas de metaobjeto en una acción de Enviar correo electrónico interno como esta:

{% 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. En un flujo de trabajo que usa el activador Hora programada, el flujo comienza a la hora que especificaste, en lugar de iniciarse como resultado de un evento. Como no hay un evento específico en la tienda ni de una aplicación que inicie el flujo, no se incluye ningún dato automáticamente.

Detalles de la API

• Recurso de metaobjeto
• Filtros de consulta de metaobjeto
• Consultar metaobjetos por valor de campo