Obter entradas de metaobjeto

Você pode usar a ação Obter entradas de metaobjeto para recuperar uma lista de entradas para um metaobjeto da sua loja com base na consulta opcional. Veja a documentação dos metaobjetos para obter mais informações.

Configuração

Campos

A ação Obter entradas de metaobjeto contém um menu suspenso para especificar a definição do metaobjeto, bem como os seguintes campos usados para criar a consulta:

Campos usados nas ações "Get data" ("Coletar dados").
CampoDescrição
Ordenar dados porObrigatório. Os parâmetros que ordenam os dados retornados na consulta de pesquisa.
Número máximo de resultadosObrigatório. Valor máximo de resultados retornados pela consulta de pesquisa selecionada. É possível retornar até 100 de cada vez.
ConsultaObrigatório. Escolha uma das consultas comuns ou selecione Advanced ("Avançado") para criar a sua.

String da consulta

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

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

Este é um exemplo de consulta para coletar entradas de metaobjeto 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 em combinação com outras. A variável scheduledAt do Liquid está disponível em fluxos de trabalho que usaram o acionador "Horário agendado". A tag date_minus do Liquid é uma tag especial do Flow que permite subtrair tempo de uma data.

Na hora de consultar dados, é útil conhecer:

Dados retornados

Todas as ações Geta data ("Coletar dados") retornam uma lista com 0 a 100 recursos. Conforme o caso de uso, é possível usar esses dados de várias maneiras:

  • Se for necessário lidar com cada item de lista individualmente, por exemplo, para adicionar uma tag, use a ação For each ("Para cada").
  • Se for necessário agregar dados, como contar quantos resultados foram retornados, use as ações Count ("Contar") ou Sum ("Somar").
  • Se for necessário gerar uma lista, por exemplo, 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ção, use a variável denominada Get product data ("Obter entradas de metaobjeto"), que é uma lista de entradas de metaobjeto. Essa variável pode ser usada em condições e em ações. Por exemplo, é possível enviar a lista de produtos em uma ação Send internal email ("Enviar e-mail 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 %}

Acionadores

Essa ação pode ser usada em todos os fluxos de trabalho, incluindo o acionador Scheduled time ("Horário agendado"). Os fluxos de trabalho com esse acionador se iniciam no momento que você especificou, não como resultado de um evento. Como não há nenhum evento específico na loja ou de um app que inicie o fluxo de trabalho, não há dados incluídos de forma automática.

Informações da API

Não encontrou as respostas que está procurando? Estamos sempre à disposição para ajudar você.