Obtenir dades de la col·lecció
Als fluxos de treball que requereixin dades de col·leccions, pots utilitzar l'acció Obtenir dades de la col·lecció per recuperar informació de les col·leccions de la teva botiga.
Configuració
Camps
L'acció Obtenir dades de la col·lecció inclou els camps següents.
| 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. En pots retornar un màxim de 100 alhora. |
| Consulta | Obligatori. Tria entre consultes habituals o selecciona Avançat per crear-ne una. |
Cadena de consulta
Aquesta és una consulta d'exemple per obtenir col·leccions que s'han actualitzat durant l'últim dia:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'La variable updated_at és un filtre disponible a la consulta Col·leccions i es pot utilitzar diverses vegades o combinar-se amb altres variables. La variable de Liquid scheduledAt està disponible en fluxos de treball que utilitzin l'esdeveniment desencadenant Hora programada. L'etiqueta de Liquid date_minus és una etiqueta especial de Flow que et permet restar temps d'una data.
En consultar dades, és útil saber el següent:
- Llista de filtres de col·leccions 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 de la col·lecció, que és una llista de col·leccions. Pots utilitzar aquesta variable tant en condicions com en accions. Per exemple, pots enviar la llista de col·leccions en una acció Enviar correu electrònic intern com aquesta:
{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% endfor %}Esdeveniments desencadenants
Pots utilitzar aquesta acció en qualsevol flux de treball, inclòs l'esdeveniment desencadenant Scheduled time. En un flux de treball que utilitza l'esdeveniment desencadenant Scheduled time, el flux s'inicia a l'hora que has especificat, i no pas com a resultat d'un esdeveniment. Com que no hi ha cap esdeveniment específic a la teva botiga ni des d'una aplicació que iniciï el flux de treball, no s'hi inclouen dades automàticament.