Obter entradas de metaobjetos

Use a ação Obter entradas de metaobjetos para recuperar da sua loja uma lista de entradas de um metaobjeto com base na consulta opcional. Para mais informações, consulte a documentação de metaobjetos.

Configuração

Campos

A ação Obter entradas de metaobjetos contém uma lista suspensa para especificar a definição de metaobjeto, bem como os seguintes campos, que são usados para criar a consulta:

String de consulta

Este é um exemplo de consulta para receber entradas de metaobjetos se o valor de um campo email corresponder ao endereço de e-mail de um pedido:

{{fields.email}}:"{{order.email}}"

Este é um exemplo de consulta para receber entradas de metaobjetos que foram atualizadas no último dia:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

A variável updated_at é um filtro disponível na consulta de metaobjetos e pode ser usada várias vezes ou combinada com outras variáveis. A variável scheduledAt do Liquid está disponível em workflows que usam o acionador “Horário agendado”. A tag date_minus do Liquid é uma tag especial do Flow que permite subtrair tempo de uma data.

Ao consultar dados, é útil saber o seguinte:

• Lista de filtros de metaobjeto disponíveis
• Consultar metaobjetos por valor do campo exige que o metaobjeto tenha a filtragem habilitada, que pode ser habilitada nas opções de dados personalizados do admin da Shopify.
• As consultas precisam seguir uma sintaxe específica
• Os valores dos campos de consulta nem sempre são documentados. Em alguns casos, os valores podem ser encontrados na documentação da API. Outra opção é encontrar os valores dos campos nos URLs do admin ao filtrar. Por exemplo, para encontrar alguns valores de consulta de pedido, filtre a página Pedidos no admin e verifique o URL.
• É possível executar ou testar uma consulta na sua loja usando o app GraphiQL da Shopify.
• Preste atenção no que acontece se a consulta falhar. Muitas vezes, a API retornará todos os resultados, em vez de nenhum.

Dados retornados

Todas as ações Obter dados retornam uma lista de 0 a 100 recursos. Dependendo do caso de uso, é possível usar esses dados de várias maneiras:

• Se for preciso lidar com cada item da lista individualmente, como para adicionar uma tag a cada um, use a ação Para cada.
• Se for preciso agregar dados, como contar quantos resultados foram retornados, use as ações Contar ou Somar.
• Se for preciso gerar a lista como resultado, como para enviar um e-mail com todos os itens, use os dados retornados diretamente nas ações subsequentes.

Para acessar os dados retornados nas etapas seguintes a esta ação, use a variável chamada Obter entradas de metaobjeto, que é uma lista de entradas de metaobjeto. Você pode usar essa variável em condições e ações. Por exemplo, é possível enviar a lista de pares de chave-valor para as entradas de metaobjeto em uma ação Enviar e-mail interno da seguinte forma:

{% 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 %}

Acionadores

É possível usar essa ação em qualquer workflow, incluindo o acionador Horário agendado. Em um workflow que usa o acionador Horário agendado, o workflow começa em um horário que você especificou, e não como resultado de um evento. Como não há um evento específico na sua loja ou de um app que inicie o workflow, nenhum dado é incluído automaticamente.

Detalhes da API

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