Obter dados de locais da empresa
Em fluxos de trabalho que usam dados de locais da empresa, é possível usar a ação Obter dados de locais da empresa para recuperar informações de locais da empresa da sua loja.
Configuração
Campos
A ação Obter dados de locais da empresa contém os seguintes campos, 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 uma das consultas comuns ou selecione Avançado para criar uma própria. |
String de consulta
Este é um exemplo de consulta para obter locais de empresas que foram atualizados 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 locais da empresa e pode ser usada várias vezes ou combinada com outras variáveis. A variável do Liquid scheduledAt está disponível em fluxos de trabalho 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 locais da empresa disponíveis
- 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. Como alternativa, muitas vezes é possível encontrar os valores dos campos nos URLs no painel do admin quando você aplica filtros. Por exemplo, para encontrar alguns valores de consulta de Pedido, filtre a página Pedidos no painel do admin e verifique o URL.
- Você pode executar ou testar uma consulta em sua loja usando o app GraphiQL da Shopify.
- Fique atento ao que acontece se a consulta falhar. Muitas vezes, a API retornará todos os resultados (em vez de nenhum).
Dados retornados
Todas as ações para obter dados retornam uma lista de 0 a 100 recursos. Dependendo do caso de uso, você pode usar esses dados de várias maneiras:
- Se você precisar lidar com cada item da lista individualmente (por exemplo, para adicionar uma tag a cada um), use a ação Para cada.
- Se precisar agregar dados (por exemplo, contar quantos resultados foram retornados), use as ações Contar ou Somar.
- Se precisar exportar a lista (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 essa ação, use a variável Get company location data, que é uma lista de locais da empresa. Essa variável pode ser usada em condições e ações. Por exemplo, você pode enviar a lista de locais em uma ação Enviar e-mail interno como esta:
{% for single_company in GetCompanyLocationData %}
* {{ single_company.name }}
{% endfor %}Acionadores
É possível usar esta ação em qualquer fluxo de trabalho, incluindo o acionador Horário agendado. Em um fluxo de trabalho que usa o acionador Horário agendado, o fluxo de trabalho é iniciado em um horário especificado, e não como resultado de um evento. Como não há nenhum evento específico na sua loja ou de um app que inicie o fluxo de trabalho, nenhum dado é incluído automaticamente.