Obtén dades de la ubicació
En els fluxos de treball que requereixen dades d'ubicació, pots utilitzar l'acció Obtén dades de la ubicació per recuperar informació de la teva botiga de Shopify. Les ubicacions són qualsevol lloc on emmagatzemes l'estoc, vens productes, envies comandes o les prepares.
Configuració
Camps
L'acció Obtén dades de la ubicació conté 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. El nombre màxim de resultats que pot retornar la consulta de cerca seleccionada. Pots retornar fins a 100 resultats alhora. |
| Consulta | Obligatori. Tria entre consultes habituals o selecciona Avançat per crear-ne una de pròpia. |
Cadena de consulta
Aquest és un exemple de consulta per obtenir ubicacions que tinguin activada la recollida a la botiga:
pickup_in_store:enabledLa variable pickup_in_store és un filtre disponible a la consulta d'ubicacions i es pot utilitzar diverses vegades o combinar-se amb altres variables.
En consultar dades, és útil saber el següent:
Les consultes han de seguir una sintaxi específica
Els valors del camp de consulta no sempre estan documentats. En alguns casos, els valors es poden trobar si es consulta la documentació de l'API. D'altra banda, sovint pots trobar els valors dels camps als URL del panell d'administració quan filtres. Per exemple, per trobar alguns valors de consulta de la secció Comandes, 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 el que passa si la teva consulta falla. Sovint, l'API retorna tots els resultats (en lloc de cap).
Dades retornades
Totes les accions Obtén dades retornen una llista d'entre 0 i 100 recursos. Segons el teu cas d'ús, pots utilitzar aquestes dades de diverses maneres:
- Si has de gestionar cada article de la llista individualment, per exemple, per afegir una etiqueta a cadascun, pots utilitzar l'acció Per a cada.
- Si has d'agregar dades, com ara comptar quants resultats s'han retornat, pots utilitzar les accions Compta o Suma.
- 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 posteriors a aquesta acció, utilitza la variable Obtén dades de la ubicació, que és una llista d'ubicacions. Pots utilitzar aquesta variable tant en condicions com en accions. Per exemple, pots enviar la llista d'ubicacions en una acció Envia un correu electrònic intern d'aquesta manera:
{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}Esdeveniments desencadenants
Pots utilitzar aquesta acció en qualsevol flux de treball, inclòs l'esdeveniment desencadenant Hora programada. En un flux de treball que utilitza l'esdeveniment desencadenant Hora programada, el flux de treball 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 teva botiga ni des d'una aplicació que iniciï el flux de treball, no s'inclou cap dada de manera automàtica.
Referència de l'API
Per obtenir més informació sobre l'API que s'utilitza en aquesta acció, consulta la consulta d'ubicacions.