Obter dados da coleção
Em workflows que exigem dados da coleção, use a ação Obter dados da coleção para recuperar informações da coleção da sua loja.
Configuração
Campos
A ação Obter dados da coleção contém os seguintes campos.
| Campo | Descrição |
|---|---|
| Classificar dados por | Obrigatório. Os parâmetros pelos quais os dados retornados pela consulta de pesquisa são classificados. |
| Número máximo de resultados | Obrigatório. O número máximo de resultados que podem ser retornados pela consulta de pesquisa que você selecionar. É possível retornar até 100 de cada vez. |
| Consulta | Obrigatório. Escolha entre as consultas comuns ou selecione Avançado para criar uma própria. |
String de consulta
Este é um exemplo de consulta para buscar coleções 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 coleções e pode ser usada várias vezes ou combinada com outras variáveis. A variável do Liquid scheduledAt 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 coleção disponíveis
- As consultas precisam seguir uma determinada sintaxe
- Os valores dos campos de consulta nem sempre são documentados. Em alguns casos, os valores podem ser encontrados na documentação da API. Como alternativa, você pode encontrar os valores dos campos nas URLs no admin ao filtrar. Por exemplo, para encontrar alguns valores de consulta de pedidos, filtre a página Pedidos no admin e verifique a URL.
- Você pode executar ou testar uma consulta na sua loja usando o app Shopify GraphiQL.
- Fique atento ao que acontece se a consulta falhar. Muitas vezes, a API retorna todos os resultados (em vez de nenhum).
Dados retornados
Todas as ações Buscar dados retornam uma lista de 0 a 100 recursos. Dependendo do seu caso de uso, é possível usar esses dados de várias maneiras:
- Se você precisar lidar com cada item da lista individualmente, como para adicionar uma tag a cada um, use a ação Para cada.
- Se você precisar agregar dados, como contar quantos resultados foram retornados, use as ações Contar ou Somar.
- Se você precisar gerar a lista, como para enviar um e-mail com todos os itens, pode usar 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 Buscar dados de coleções, que é uma lista de coleções. Você pode usar essa variável em condições e ações. Por exemplo, é possível enviar a lista de coleções em uma ação Enviar e-mail interno como esta:
{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% endfor %}Acionadores
Você pode 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 é iniciado em um horário especificado por você, e não como resultado de um evento. Como não há um evento específico em sua loja ou de um app que inicie o workflow, nenhum dado é incluído automaticamente.