Buscar dados da empresa
Em workflows que usam dados da empresa, você pode usar a ação Buscar dados da empresa para recuperar as informações da empresa na sua loja.
Configuração
Campos
A ação Buscar dados da empresa contém os seguintes campos, que são usados para criar a consulta:
| 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 por 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 empresas 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 empresas 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 empresa 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 precisar agregar dados, como contar quantos resultados foram retornados, use as ações Count ou Sum.
- Se precisar usar a lista de resultados, por exemplo, para enviar um e-mail com todos os itens, use os dados retornados diretamente nas ações seguintes.
Para acessar os dados retornados nas etapas seguintes a esta ação, use a variável chamada Get company data, que é uma lista de empresas. Você pode usar essa variável em condições e ações. Por exemplo, é possível enviar a lista de empresas em uma ação Send internal email da seguinte forma:
{% for single_company in GetCompanyData %}
* {{ single_company.name }}
{% endfor %}Acionadores
É possível usar esta ação em qualquer workflow, inclusive com o acionador Scheduled time. Em um workflow que usa o acionador Scheduled time, o workflow é iniciado no horário que você especificou, e não como resultado de um evento. Como não há um evento específico na loja ou de um app que inicie o workflow, nenhum dado é incluído automaticamente.