Pridobi podatke o pogodbi o naročnini

Opomba

Pogodbe o naročnini so dosledno pridobljene v naraščajočem vrstnem redu, ki je določen z njihovim ID-jem.

V potekih dela, ki uporabljajo podatke pogodbe o naročnini, lahko z dejanjem Pridobi podatke o pogodbi o naročnini pridobite podatke o pogodbi o naročnini iz vaše trgovine.

Opomba

To je vrsta dejanja Pridobi podatke. Za razumevanje uporabe te vrste dejanja s sprožilcem Načrtovan čas in zankami Za vsakega glejte Urniki, pridobivanje podatkov in poteki dela z zankami v aplikaciji Shopify Flow.

Konfiguracija

Polja

Dejanje Pridobi podatke o pogodbi o naročnini vsebuje naslednja polja, ki se uporabljajo za izdelavo poizvedbe:

Polja, uporabljena v dejanjih Pridobi podatke.

Polje	Opis
Razvrsti podatke po	Obvezno. Parametri, po katerih so razvrščeni podatki, ki jih vrne iskalna poizvedba.
Največje število rezultatov	Obvezno. Največje število rezultatov, ki jih lahko vrne izbrana iskalna poizvedba. Hkrati je lahko vrnjenih do 100 rezultatov.
Poizvedba	Obvezno. Izberite med pogostimi poizvedbami ali izberite Napredno, da ustvarite svojo.

Niz poizvedbe

To je primer poizvedbe za pridobivanje pogodb o naročnini s statusom ACTIVE:

status: ACTIVE

Spremenljivka status je filter, ki je na voljo v Poizvedbi pogodb o naročnini in ga je mogoče uporabiti večkrat.

Pri poizvedovanju po podatkih je koristno vedeti naslednje:

• Seznam razpoložljivih filtrov
• Poizvedbe morajo upoštevati določeno skladnjo
• Vrednosti polj poizvedbe niso vedno dokumentirane. V nekaterih primerih je vrednosti mogoče najti s pregledom dokumentacije za API. Vrednosti polj pogosto najdete tudi v URL-naslovih v skrbniški plošči pri filtriranju. Da bi na primer našli nekaj vrednosti poizvedbe za Naročila, filtrirajte stran Naročila v skrbniški plošči in nato preverite URL-naslov.
• Poizvedbo v svoji trgovini lahko izvedete ali preskusite z aplikacijo Shopify GraphiQL.
• Bodite pozorni na to, kaj se zgodi v primeru neuspešne poizvedbe. API bo pogosto vrnil vse rezultate (namesto nobenega).

Vrnjeni podatki

Vsa dejanja Pridobi podatke vrnejo seznam z od 0 do 100 viri. Glede na vaš primer uporabe boste morda te podatke želeli uporabiti na različne načine:

• Če morate vsak element seznama obravnavati posamezno, na primer tako, da mu dodate oznako, lahko uporabite dejanje Za vsakega.
• Če morate zbrati podatke, na primer prešteti, koliko rezultatov je bilo vrnjenih, lahko uporabite dejanja Preštej ali Vsota.
• Če želite izpisati seznam, na primer poslati e-pošto z vsemi elementi, lahko vrnjene podatke uporabite neposredno v naslednjih dejanjih.

Za dostop do vrnjenih podatkov v korakih, ki sledijo temu dejanju, uporabite spremenljivko z imenom Pridobi podatke o pogodbi o naročnini, ki je seznam pogodb o naročnini. To spremenljivko lahko uporabite v pogojih in dejanjih. Seznam naročil lahko na primer pošljete v dejanju Pošlji interno e-pošto takole:

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

Opomba

Če je dejanje Pridobi podatke v enem poteku dela uporabljeno večkrat, se imenu spremenljivke doda številka. V poteku dela, ki na primer dvakrat uporabi dejanje Pridobi podatke o naročilu, je prva spremenljivka za vrnjene podatke getOrderData, druga pa getOrderData1. Tega imena ni mogoče prilagoditi.

Sprožilci

To dejanje lahko uporabite v katerem koli poteku dela, vključno s sprožilcem Načrtovan čas. V poteku dela, ki uporablja sprožilec Načrtovan čas, se potek dela začne ob navedenem času in ne kot rezultat dogodka. Ker v vaši trgovini ali iz aplikacije ni posebnega dogodka, ki bi zagnal potek dela, podatki niso samodejno vključeni.

Referenca za API

• Vir pogodbe o naročnini
• Filtri poizvedbe za pogodbo o naročnini