Obtenir dades de l'esborrany de comanda
En els fluxos de treball que utilitzen dades d'esborrany de comanda, pots utilitzar l'acció Obtenir dades de l'esborrany de comanda per recuperar la informació de l'esborrany de comanda de la teva botiga.
Configuració
Camps
L'acció Obtenir dades de l'esborrany de comanda conté els camps següents, que s'utilitzen per crear la consulta:
| Camp | Descripció |
|---|---|
| Ordena les dades per | Obligatori. Els paràmetres segons els quals 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 la teva pròpia consulta. |
Cadena de consulta
Aquest és un exemple de consulta per obtenir esborranys de comanda que s'han actualitzat 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 d'esborranys de comanda i es pot utilitzar diverses vegades o combinar-se amb altres variables. La variable de Liquid scheduledAt està disponible en fluxos de treball que han utilitzat 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.
En consultar dades, és útil saber que:
- Llista de filtres de comanda disponibles
- Les consultes han de seguir una certa sintaxi
- Els valors del camp de consulta no sempre estan documentats. En alguns casos, es poden trobar cercant a la documentació de l'API. D'altra manera, normalment pots trobar els valors dels camps als URL al panell d'administració quan filtres. Per exemple, per trobar alguns valors de consulta de 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ó GraphiQL de Shopify.
- Tingues en compte què passa si la teva 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 has de gestionar cada element de la llista individualment, per exemple, per afegir una etiqueta per a cada un, 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 necessites generar la llista, per exemple, 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 que segueixen aquesta acció, utilitza la variable anomenada Obtenir dades de l'esborrany de comanda, que és una llista d'esborranys de comanda. Pots utilitzar aquesta variable tant en condicions com en accions. Per exemple, pots enviar la llista d'esborranys de comanda en una acció Enviar correu electrònic intern d'aquesta manera:
{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% 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 de cap aplicació que iniciï el flux de treball, no s'inclouen dades automàticament.
Detalls de l'API
Plantilles
Enviar una notificació diària amb tots els esborranys de comanda oberts
Obté esborranys de comanda oberts cada dia, els compta i envia un missatge a Slack. Utilitza l'esdeveniment desencadenant Hora programada i les accions Obtenir esborranys de comanda i Comptar. Veure la plantilla