Obtén dades del contracte de subscripció
En els fluxos de treball que utilitzen dades del contracte de subscripció, pots utilitzar l'acció Obtén dades del contracte de subscripció per recuperar informació dels contractes de subscripció de la teva botiga.
Configuració
Camps
L'acció Obtén dades del contracte de subscripció conté els camps següents, que s'utilitzen per crear la consulta:
| 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 fins a 100 a la vegada. |
| 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 contractes de subscripció amb un estat ACTIVE:
status: ACTIVELa variable status és un filtre disponible a la Consulta de contractes de subscripció i es pot utilitzar diverses vegades.
A l'hora de consultar dades, és útil saber el següent:
- Llista de filtres disponibles
- Les consultes han de seguir una sintaxi específica
- Els valors dels camps de consulta no sempre estan documentats. En alguns casos, pots trobar els valors consultant els documents de l'API. També pots trobar els valors dels camps a les URL del panell d'administració quan filtres. Per exemple, per trobar alguns valors de consulta de 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.
- Tingues en compte què passa si la teva consulta falla. Sovint, l'API retornarà tots els resultats (en comptes de cap).
Dades retornades
Totes les accions Obtén 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 necessites gestionar cada element de la llista individualment, per exemple, per afegir una etiqueta a cadascun, pots utilitzar l'acció Per a cada.
- Si necessites agregar dades, per exemple, per comptar quants resultats s'han retornat, pots utilitzar les accions Compta o Suma.
- Si necessites obtenir la llista per, 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 posteriors a aquesta acció, utilitza la variable anomenada Obtén dades del contracte de subscripció, que és una llista de contractes de subscripció. Pots utilitzar aquesta variable tant en condicions com en accions. Per exemple, pots enviar la llista de comandes en una acció Envia un correu electrònic intern d'aquesta manera:
{% for single_contract in GetSubscriptionContractData %}
* {{ single_contract.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 comptes de fer-ho com a resultat d'un esdeveniment. Com que no hi ha cap esdeveniment específic a la teva botiga ni de cap aplicació que iniciï el flux de treball, no s'inclouen dades automàticament.