Preuzimanje podataka o ugovoru o pretplati

Napomena

Ugovori o pretplati se dosledno preuzimaju u rastućem redosledu, koji je određen njihovim ID-om.

U tokovima posla koji koriste podatke o ugovoru o pretplati možete da koristite radnju Preuzimanje podataka o ugovoru o pretplati za preuzimanje informacija o ugovoru o pretplati iz vaše prodavnice.

Napomena

Ovo je tip radnje Preuzimanje podataka. Da biste razumeli kako se ovaj tip radnje koristi sa okidačem Zakazano vreme i for each petljama, pogledajte odeljak Rasporedi, preuzimanje podataka i tokovi posla sa petljama u aplikaciji Shopify Flow.

Konfiguracija

Polja

Radnja Preuzimanje podataka o ugovoru o pretplati sadrži sledeća polja, koja se koriste za kreiranje upita:

Polja koja se koriste u radnjama za preuzimanje podataka.

Polje	Opis
Sortiraj podatke po	Obavezno. Parametri po kojima se sortiraju podaci koje vraća upit za pretragu.
Maksimalan broj rezultata	Obavezno. Maksimalan broj rezultata koje može da vrati upit za pretragu koji izaberete. Možete da vratite do 100 rezultata odjednom.
Upit	Obavezno. Izaberite jedan od uobičajenih upita ili izaberite opciju Napredno da biste kreirali svoj.

String upita

Ovo je primer upita za preuzimanje ugovora o pretplati sa statusom ACTIVE:

status: ACTIVE

Promenljiva status je filter koji je dostupan u upitu za ugovore o pretplati i može se koristiti više puta.

Kada izvršavate upit za podatke, korisno je da znate sledeće:

• Lista dostupnih filtera
• Upiti moraju da prate određenu sintaksu
• Vrednosti polja upita nisu uvek dokumentovane. U nekim slučajevima se vrednosti mogu pronaći u API dokumentaciji. Alternativno, vrednosti polja često možete da pronađete u URL-ovima u adminu kada filtrirate. Na primer, da biste pronašli neke vrednosti upita za porudžbine, filtrirajte stranicu „Porudžbine“ u adminu i proverite URL.
• Možete da izvršite ili testirate upit u svojoj prodavnici pomoću aplikacije Shopify GraphiQL.
• Obratite pažnju na to šta se dešava ako vaš upit ne uspe. Često će API vratiti sve rezultate (umesto nijednog).

Vraćeni podaci

Sve radnje Preuzimanje podataka vraćaju listu od 0 do 100 resursa. U zavisnosti od vašeg slučaja upotrebe, ove podatke možete da koristite na različite načine:

• Ako je potrebno da obrađujete svaku stavku liste pojedinačno, na primer da biste za svaku dodali oznaku, možete da upotrebite radnju For each.
• Ako je potrebno da grupišete podatke, na primer da prebrojite koliko rezultata je vraćeno, možete da upotrebite radnju Count ili Sum.
• Ako je potrebno da prosledite listu, na primer da pošaljete imejl sa svim stavkama, vraćene podatke možete direktno da koristite u narednim radnjama.

Da biste pristupili vraćenim podacima u koracima koji slede nakon ove radnje, koristite promenljivu pod nazivom Preuzimanje podataka o ugovoru o pretplati, koja predstavlja listu ugovora o pretplati. Ovu promenljivu možete da koristite i u uslovima i u radnjama. Na primer, listu porudžbina u radnji Slanje internog imejla možete da pošaljete ovako:

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

Napomena

Ako se radnja Preuzimanje podataka koristi više puta u jednom toku posla, tada se imenu promenljive dodaje broj. Na primer, u toku posla koji dvaput koristi radnju Preuzimanje podataka o porudžbini, prva promenljiva za vraćene podatke je getOrderData, a druga promenljiva je getOrderData1. Ovo ime ne može da se prilagodi.

Okidači

Ovu radnju možete da koristite u bilo kom toku posla, uključujući okidač Zakazano vreme. U toku posla koji koristi okidač Zakazano vreme tok posla se pokreće u vreme koje ste naveli, a ne kao rezultat događaja. S obzirom na to da ne postoji određeni događaj u vašoj prodavnici ili iz aplikacije koji pokreće tok posla, podaci se ne uključuju automatski.

API referenca

• Resurs ugovora o pretplati
• Filteri upita za ugovor o pretplati