Iegūt abonementa līguma datus

Darbplūsmās, kurās tiek izmantoti abonementa līguma dati, vari izmantot darbību Iegūt abonementa līguma datus, lai no sava veikala izgūtu informāciju par abonementa līgumu.

Konfigurācija

Lauki

Darbība Iegūt abonementa līguma datus ietver šādus laukus, kas tiek izmantoti vaicājuma veidošanai:

Lauki, kas tiek izmantoti darbībās “Iegūt datus”.
LauksApraksts
Kārtot datus pēcObligāts. Parametri, pēc kuriem tiek kārtoti meklēšanas vaicājuma atgrieztie dati.
Maksimālais rezultātu skaitsObligāts. Maksimālais rezultātu daudzums, ko var atgriezt tavs atlasītais meklēšanas vaicājums. Vienlaikus vari atgriezt līdz pat 100 rezultātiem.
VaicājumsObligāts. Izvēlies kādu no biežāk izmantotajiem vaicājumiem vai atlasi Papildu, lai izveidotu savu.

Vaicājuma virkne

Šis ir vaicājuma piemērs abonementa līgumu iegūšanai ar statusu ACTIVE:

status: ACTIVE

Mainīgais status ir filtrs, kas pieejams sadaļā Abonementa līgumu vaicājums, un to var izmantot vairākas reizes.

Datu vaicāšanā ir noderīgi zināt tālāk norādīto.

  • Pieejamo filtru saraksts
  • Vaicājumiem ir jāatbilst noteiktai sintaksei
  • Vaicājuma lauka vērtības ne vienmēr ir dokumentētas. Dažos gadījumos vērtības var atrast, aplūkojot API dokumentāciju. Vēl lauku vērtības bieži var atrast administratora paneļa URL, veicot filtrēšanu. Piemēram, lai atrastu dažas pasūtījumu vaicājuma vērtības, administratora panelī filtrē lapu Pasūtījumi un pēc tam pārbaudi URL.
  • Savā veikalā vari izpildīt vai testēt vaicājumu, izmantojot lietotni Shopify GraphiQL.
  • Pievērs uzmanību tam, kas notiek, ja vaicājums neizdodas. Bieži vien API atgriež visus rezultātus (nevis nevienu).

Atgrieztie dati

Visas Iegūt datus darbības atgriež sarakstu, kurā ir no 0 līdz 100 resursiem. Atkarībā no tava lietošanas piemēra tu, iespējams, vēlēsies šos datus izmantot dažādos veidos:

  • Ja tev ir nepieciešams strādāt ar katru saraksta vienumu atsevišķi, piemēram, katram pievienojot tagu, vari izmantot darbību Katram.
  • Ja tev ir nepieciešams apkopot datus, piemēram, saskaitīt, cik rezultātu tika atgriezti, vari izmantot darbības Skaitīt vai Summēt.
  • Ja tev ir nepieciešams saraksta izvads, piemēram, lai nosūtītu e-pasta vēstuli ar visiem vienumiem, atgrieztos datus vari tieši izmantot turpmākajās darbībās.

Lai piekļūtu atgrieztajiem datiem soļos, kas seko šai darbībai, izmanto mainīgo ar nosaukumu Iegūt abonementa līguma datus, kas ir abonementa līgumu saraksts. Šo mainīgo vari izmantot gan nosacījumos, gan darbībās. Piemēram, pasūtījumu sarakstu vari nosūtīt, izmantojot darbību Sūtīt iekšēju e-pasta vēstuli, šādi:

{% for single_contract in GetSubscriptionContractData %}
* {{ single_contract.name }}
{% endfor %}

Trigeri

Šo darbību vari izmantot jebkurā darbplūsmā, tostarp ar trigeri Ieplānotais laiks. Darbplūsmā, kurā tiek izmantots trigers Ieplānotais laiks, darbplūsma tiek sākta tevis norādītajā laikā, nevis kāda notikuma rezultātā. Tā kā tavā veikalā vai lietotnē nav noteikta notikuma, kas sāk darbplūsmu, dati netiek automātiski iekļauti.