Obtén dades del catàleg

En fluxos de treball que requereixen dades del catàleg, pots utilitzar l'acció Obtén dades del catàleg per recuperar informació del catàleg B2B de la teva botiga. Els catàlegs són grups de productes amb preus personalitzats per a clients B2B o ubicacions de l'empresa específics.

Nota

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

Configuració

Camps

L'acció Obtén dades del catàleg conté els camps següents:

Camps utilitzats en les accions Obtén 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. Es poden retornar fins a 100 resultats alhora.
Consulta	Obligatori. Tria entre consultes habituals o selecciona Avançat per crear la teva pròpia consulta.

Cadena de consulta

Aquest és un exemple de consulta per obtenir tots els catàlegs actius:

status:ACTIVE

La variable status és un filtre disponible a la consulta Catalogs i es pot utilitzar diverses vegades o combinar amb altres variables.

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

• Llista de filtres de catàleg disponibles

• Les consultes han de seguir una certa sintaxi

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

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

• Ves amb compte amb el que passa si la teva consulta falla. Sovint, l'API retornarà tots els resultats (en comptes de cap).

Dades retornades

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

• Si necessites gestionar cada article de la llista de manera individual, per exemple, per afegir-hi una etiqueta a cadascun, pots utilitzar l'acció Per a cada.
• Si necessites agregar dades, com ara comptar quants resultats s'han retornat, pots utilitzar les accions Comptar o Sumar.
• Si has d'emetre la llista, com ara enviar un correu electrònic amb tots els articles, pots utilitzar les dades retornades directament en accions posteriors.

Per accedir a les dades retornades en els passos que segueixen a aquesta acció, utilitza la variable anomenada Obtenir dades del catàleg, que és una llista de catàlegs. Pots utilitzar aquesta variable tant en condicions com en accions. Per exemple, pots enviar la llista de catàlegs en una acció Enviar correu electrònic intern de manera similar a aquesta:

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

Nota

Si s'utilitza una acció d'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 variable és getOrderData1. Aquest nom no es pot personalitzar.

Esdeveniments desencadenants

Pots utilitzar aquesta acció en qualsevol flux de treball, inclòs l'esdeveniment desencadenant Hora programada. En un flux de treball que utilitzi l'esdeveniment desencadenant Hora programada, el flux de treball comença a una 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 ni des d'una aplicació que iniciï el flux de treball, no hi ha dades incloses automàticament.

Referència de l'API

Per obtenir més informació sobre l'API utilitzada en aquesta acció, consulta la consulta Catàlegs.