Obtenir dades de la pàgina

Als fluxos de treball que necessiten dades de pàgines, pots fer servir l'acció Obtenir dades de la pàgina per recuperar informació de les pàgines de la teva botiga. Les Pàgines són les pàgines web de la teva botiga en línia que contenen informació que poques vegades canvia, com ara la pàgina Qui som o la de contacte.

Nota

Aquesta és una acció del tipus Obtenir dades. Per entendre com pots utilitzar aquest tipus d'acció amb l'esdeveniment desencadenant d'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 la pàgina conté els camps següents:

Camps utilitzats a les accions Obtenir dades.

Camp	Descripció
Ordena les dades per	Obligatori. Els paràmetres amb què s'ordenen les dades que retorna 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 alhora.
Consulta	Obligatori. Tria entre consultes comunes o selecciona Avançat per crear-ne una de pròpia.

Cadena de consulta

Aquest és un exemple de consulta per obtenir pàgines publicades:

published_status:published

La variable published_status és un filtre disponible a la consulta de Pàgines i es pot utilitzar diverses vegades o combinar-se amb altres variables.

A l'hora de consultar dades, és útil saber el següent:

• Llista de filtres de pàgines disponibles

• Les consultes han de seguir una sintaxi determinada

• Els valors dels camps de consulta no sempre estan documentats. En alguns casos, es poden trobar consultant la documentació de l'API. Com a alternativa, sovint pots trobar els valors dels camps als URL del panell d'administració quan hi apliques filtres. Per exemple, per trobar alguns valors de consulta de Comandes, filtra la pàgina Comandes al panell d'administració i, després, comprova l'URL.

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

• Tingues en compte el que passa si la teva consulta falla. Sovint, l'API retornarà tots els resultats (en comptes 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 has de gestionar cada element de la llista individualment, com ara per afegir-hi una etiqueta a cadascun, pots fer servir l'acció Per a cada.
• Si necessites agregar dades, com ara comptar quants resultats s'han retornat, pots fer servir les accions Comptar o Sumar.
• Si necessites emetre la llista, com ara enviar un correu electrònic amb tots els elements, pots utilitzar les dades retornades directament en accions posteriors.

Per accedir a les dades retornades als passos posteriors a aquesta acció, utilitza la variable anomenada Obtenir dades de la pàgina, que és una llista de pàgines. Pots fer servir aquesta variable tant a les condicions com a les accions. Per exemple, pots enviar la llista de pàgines en una acció Enviar un correu electrònic intern semblant a aquesta:

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

Nota

Si s'utilitza una acció Obtenir dades diverses vegades en un sol 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 de les dades retornades és getOrderData i la segona és getOrderData1. Aquest nom no es pot personalitzar.

Esdeveniments desencadenants

Pots utilitzar aquesta acció a qualsevol flux de treball, fins i tot amb l'esdeveniment desencadenant d'Hora programada. A un flux de treball que fa servir l'esdeveniment desencadenant d'Hora programada, el flux s'inicia en el moment que has especificat, i no com a conseqüència d'un esdeveniment. Com que no hi ha cap esdeveniment concret a la teva botiga ni des 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 de Pàgines.