Obter dados do artigo

Em fluxos de trabalho que exigem dados de artigos de blog, é possível usar a ação Obter dados do artigo para recuperar informações do artigo da loja na Shopify.

Observação

Esse é um tipo de ação Obter dados. Para entender como usar esse tipo de ação com o acionador Horário agendado e os loops Para cada, consulte Programações, obtenção de dados e loops em fluxos de trabalho no Shopify Flow.

Configuração

Campos

A ação Obter dados do artigo contém os seguintes campos:

Campos usados nas ações Obter dados.

Campo	Descrição
Ordenar dados por	Obrigatório. Os parâmetros pelos quais os dados retornados pela consulta de pesquisa são ordenados.
Número máximo de resultados	Obrigatório. A quantidade máxima de resultados que podem ser retornados pela consulta de pesquisa selecionada. É possível retornar até 100 por vez.
Consulta	Obrigatório. Escolha entre consultas comuns ou selecione Avançado para criar a sua.

String de consulta

Confira um exemplo de consulta para obter artigos publicados no último dia:

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

A variável published_at é um filtro disponível na consulta Articles 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 do Liquid date_minus é uma tag especial do Flow que permite subtrair tempo de uma data.

Ao consultar dados, é útil saber:

• Lista de filtros de artigo disponíveis

• As consultas devem seguir uma determinada sintaxe

• Os valores do campo de consulta nem sempre estão documentados. Em alguns casos, é possível encontrá-los na documentação da API. Como alternativa, você geralmente pode encontrar os valores dos campos nos URLs do painel do admin ao filtrar. Por exemplo, para encontrar alguns valores de consulta de Pedido, filtre a página Pedidos no painel do admin e verifique o URL.

• É possível executar ou testar uma consulta na loja usando o app Shopify GraphiQL.

• Lembre-se do que acontece em caso de falha na consulta. Muitas vezes, a API retorna todos os resultados (em vez de nenhum).

Dados retornados

Todas as ações Obter dados retornam uma lista com de 0 a 100 recursos. Dependendo do caso de uso, convém utilizar esses dados de várias maneiras:

• Caso precise processar cada item da lista individualmente, como adicionar uma tag a cada um, você poderá usar a ação Para cada.
• Caso precise agregar dados, como contar o número de resultados retornados, use as ações Contar ou Somar.
• Caso precise gerar a lista como saída, por exemplo, 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, use a variável Obter dados do artigo, que é uma lista de artigos. É possível usar essa variável em condições e em ações. Por exemplo, você pode enviar a lista de artigos numa ação Enviar e-mail interno semelhante a esta:

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% endfor %}

Observação

Se a ação Obter dados for usada diversas vezes num único fluxo de trabalho, um número será adicionado ao nome da variável. Por exemplo, em um fluxo de trabalho em que a ação Obter dados do pedido é usada duas vezes, a primeira variável dos dados retornados é getOrderData, e a segunda é getOrderData1. Não é possível personalizar esse nome.

Acionadores

A ação pode ser usada em qualquer fluxo de trabalho, inclusive no acionador Horário agendado. Em fluxos de trabalho que o utilizam, a execução começa num horário especificado, e não como resultado de um evento. Como não há um evento específico na loja ou em um app para iniciar o fluxo de trabalho, não há dados incluídos de forma automática.

Referência da API

Para obter mais informações sobre a API usada nesta ação, consulte a consulta Articles.