Obtenir dades de l'article

Als fluxos de treball que requereixen dades d'articles del blog, pots utilitzar l'acció Obtenir dades de l'article per recuperar la informació dels articles de la teva botiga de Shopify.

Nota

Aquest és un tipus d'acció Obtenir dades. Per entendre com s'utilitza aquest tipus d'acció amb l'esdeveniment desencadenant Hora programada i les iteracions Per a cada, consulta Programacions, obtenció de dades i fluxos de treball iteratius a Shopify Flow.

Configuració

Camps

L'acció Obtenir dades de l'article conté els camps següents:

Camps utilitzats a les accions Obtenir dades.

Camp	Descripció
Ordena les dades per	Obligatori. Els paràmetres pels quals s'ordenen les dades retornades per la consulta de cerca.
Nombre màxim de resultats	Obligatori. La quantitat màxima de resultats que pot retornar la consulta de cerca que seleccionis. Se'n poden retornar fins a 100 de cop.
Consulta	Obligatori. Tria entre consultes comunes o selecciona Avançat per crear-ne una pròpia.

Cadena de consulta

Aquest és un exemple de consulta per obtenir els articles publicats en l'últim dia:

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

La variable published_at és un filtre disponible a la consulta d'articles que es pot utilitzar diverses vegades o combinar amb altres variables. La variable de Liquid scheduledAt està disponible als fluxos de treball que utilitzen l'esdeveniment desencadenant Hora programada. L'etiqueta de Liquid date_minus és una etiqueta de Flow especial que et permet restar temps a una data.

Quan es consulten dades, és útil saber el següent:

• Llista dels filtres d'article disponibles

• Les consultes han de seguir una sintaxi determinada

• Els valors dels camps de consulta no sempre estan documentats. En alguns casos, pots trobar els valors mirant la documentació de l'API. Alternativament, sovint pots trobar els valors dels camps a les URL del panell d'administració quan filtres. Per exemple, per trobar els valors de la consulta de la comanda, filtra la pàgina Comandes al panell d'administració i comprova'n l'URL.

• Pots executar o provar una consulta a la teva botiga mitjançant l'aplicació Shopify GraphiQL.

• Tingues en compte què passa si la consulta falla. Sovint, l'API retornarà tots els resultats (en lloc de cap).

Dades retornades

Totes les accions Obtenir dades retornen una llista d'entre 0 i 100 recursos. En funció del teu cas d'ús, és possible que vulguis utilitzar aquestes dades de diverses maneres:

• Si necessites tractar cada element de la llista individualment, per exemple, per afegir-hi una etiqueta per a cadascun, pots utilitzar l'acció Per a cada.
• Si necessites agregar dades, per exemple, per comptar quants resultats s'han retornat, pots utilitzar les accions Comptar o Sumar.
• Si necessites generar la llista, per exemple, per enviar un correu electrònic amb tots els elements, pots utilitzar les dades retornades directament a les accions posteriors.

Per accedir a les dades retornades en els passos que segueixen aquesta acció, utilitza la variable anomenada Obtenir dades de l'article, que és una llista d'articles. Pots utilitzar aquesta variable tant a les condicions com a les accions. Per exemple, pots enviar la llista d'articles en una acció Enviar un correu electrònic intern semblant a aquesta:

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

Nota

Si s'utilitza una acció Obtenir dades diverses vegades en un únic flux de treball, s'afegeix un número al nom de la variable. Per exemple, en un flux de treball que utilitza l'acció Obtenir dades de la comanda dues vegades, la primera variable per a les dades retornades és getOrderData i la segona és getOrderData1. Aquest nom no es pot personalitzar.

Esdeveniments desencadenants

Pots utilitzar aquesta acció en qualsevol flux de treball, inclosos els que tenen l'esdeveniment desencadenant Hora programada. En un flux de treball que utilitza l'esdeveniment desencadenant Hora programada, aquest s'inicia a l'hora que hagis especificat en lloc de fer-ho com a resultat d'un esdeveniment. Com que no hi ha cap esdeveniment específic a la botiga o d'una aplicació que iniciï el flux de treball, no s'inclouen dades automàticament.

Referència de l'API

Per obtenir més informació sobre l'API utilitzada en aquesta acció, consulta la consulta d'articles.