Hangi tellimuslepingu andmed

Töövoogudes, kus kasutatakse tellimuslepingu andmeid, saad oma poest tellimuslepingu teabe hankimiseks kasutada toimingut Hangi tellimuslepingu andmed.

Sellel lehel

Konfiguratsioon

Väljad

Toiming Hangi tellimuslepingu andmed sisaldab järgmisi välju, mida kasutatakse päringu koostamiseks:

Toimingutes Get data kasutatavad väljad.
Väli	Kirjeldus
Andmete sortimisalus	Nõutav. Parameetrid, mille järgi otsingupäringuga tagastatud andmeid sorditakse.
Maksimaalne tulemuste arv	Nõutav. Maksimaalne tulemuste arv, mida valitud otsingupäringuga saab tagastada. Korraga saad tagastada kuni 100 tulemust.
Päring	Nõutav. Vali levinud päringute seast või vali enda oma loomiseks Advanced.

Päringusõne

See on näidispäring olekuga ACTIVE tellimuslepingute hankimiseks:

status: ACTIVE

Muutuja status on tellimuslepingute päringus saadaolev filter ja seda saab kasutada mitu korda.

Andmete pärimisel on kasulik teada järgmist.

Saadaolevate filtrite loend
Päringud peavad järgima kindlat süntaksit
Päringuväljade väärtused ei ole alati dokumenteeritud. Mõnel juhul leiab väärtused, kui vaadata API dokumentatsiooni. Sageli leiad väljaväärtused ka adminis filtreerides URL-idest. Näiteks mõne tellimuse päringu väärtuse leidmiseks filtreeri adminis lehte Tellimused ja kontrolli seejärel URL-i.
Saad oma poes päringu käivitada või seda testida, kasutades Shopify GraphiQL-i rakendust.
Pea meeles, mis juhtub, kui sinu päring nurjub. Sageli tagastab API kõik tulemused (mitte tühja vastuse).

Tagastatud andmed

Kõik Get data tüüpi toimingud tagastavad 0 kuni 100 ressursiga loendi. Olenevalt kasutusjuhust võid soovida neid andmeid kasutada mitmel viisil:

Kui sul on vaja käsitleda igat loendiüksust eraldi (nt lisada igale üksusele silt), saad kasutada toimingut For each.
Kui sul on vaja andmeid koondada (nt lugeda kokku, mitu tulemust tagastati), saad kasutada toiminguid Count või Sum.
Kui sul on vaja loend väljastada, näiteks saata kõigi üksustega e-kiri, saad kasutada tagastatud andmeid otse järgnevates toimingutes.

Sellele toimingule järgnevates etappides tagastatud andmetele juurdepääsemiseks kasuta muutujat nimega Hangi tellimuslepingu andmed, mis on tellimuslepingute loend. Saad seda muutujat kasutada nii tingimustes kui ka toimingutes. Näiteks saad tellimuste loendi saata toiminguga Send internal email järgmiselt:

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

Käivitajad

Saad seda toimingut kasutada mis tahes töövoos, sealhulgas käivitajaga Scheduled time. Töövoos, mis kasutab käivitajat Scheduled time, algab töövoog sinu määratud ajal, mitte sündmuse tulemusel. Kuna sinu poes või mõnes rakenduses ei toimu kindlat sündmust, mis töövoo käivitaks, ei kaasata andmeid automaatselt.