Obter datos do artigo

Nos fluxos de traballo que requiren datos do artigo do blog, podes utilizar a acción Obter datos do artigo para recuperar a información do artigo da túa tenda de Shopify.

Nesta páxina

Configuración

Campos

A acción Obter datos do artigo contén os seguintes campos:

Campos utilizados nas accións Obter datos.
Campo	Descrición
Ordenar datos por	Obrigatorio. Os parámetros cos que se ordenan os datos devoltos pola consulta de busca.
Número máximo de resultados	Obrigatorio. A cantidade máxima de resultados que pode devolver a consulta de busca que selecciones. Podes devolver un máximo de 100 á vez.
Consulta	Obrigatorio. Escolle entre as consultas comúns ou selecciona Avanzada para crear a túa propia.

Cadea de consulta

Este é un exemplo de consulta para obter artigos publicados no último día:

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

A variable published_at é un filtro dispoñible na consulta de artigos e pódese utilizar varias veces ou combinarse con outras variables. A variable de Liquid scheduledAt está dispoñible nos fluxos de traballo que utilizan o activador Hora programada. A etiqueta de Liquid date_minus é unha etiqueta especial de Flow que che permite restar tempo a unha data.

Ao consultar datos, convén saber o seguinte:

Lista dos filtros de artigos dispoñibles
As consultas deben seguir unha determinada sintaxe
Os valores do campo de consulta non sempre están documentados. Nalgúns casos, os valores poden atoparse na documentación da API. Alternativamente, a miúdo podes atopar os valores do campo nos URL do administrador cando filtres. Por exemplo, para atopar algúns valores da consulta de pedidos, filtra a páxina Pedidos no administrador e, a continuación, comproba o URL.
Podes executar ou probar unha consulta na túa tenda utilizando a aplicación Shopify GraphiQL.
Ten en conta o que sucede se a túa consulta falla. A miúdo, a API devolverá todos os resultados (en lugar de ningún).

Datos devoltos

Todas as accións Obter datos devolven unha lista de entre 0 e 100 recursos. Dependendo do teu caso de uso, podes querer utilizar estes datos de varias formas:

Se precisas xestionar cada elemento da lista de forma individual, como por exemplo para engadirlle unha etiqueta a cada un, podes utilizar a acción Para cada.
Se precisas agregar datos, como contar cantos resultados se devolveron, podes utilizar as accións Contar ou Sumar.
Se precisas mostrar a lista, como enviar un correo electrónico con todos os artigos, podes utilizar os datos devoltos directamente nas accións posteriores.

Para acceder aos datos devoltos nos pasos posteriores a esta acción, utiliza a variable co nome Obter datos do artigo, que é unha lista de artigos. Podes utilizar esta variable tanto nas condicións como nas accións. Por exemplo, podes enviar a lista de artigos nunha acción Enviar correo electrónico interno parecida á seguinte:

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

Activadores

Podes utilizar esta acción en calquera fluxo de traballo, incluíndo o activador Hora programada. Nun fluxo de traballo que utiliza o activador Hora programada, o fluxo de traballo comeza nunha hora que ti especificaches, e non como resultado dun evento. Dado que non hai ningún evento específico na túa tenda ou nunha aplicación que inicie o fluxo de traballo, tampouco hai datos incluídos automaticamente.

Referencia da API

Para obter máis información sobre a API utilizada nesta acción, consulta a consulta de artigos.