Získať údaje zmluvy o predplatnom

V pracovných postupoch, ktoré používajú údaje zmluvy o predplatnom, môžete na získanie informácií o zmluve o predplatnom z obchodu použiť akciu Získať údaje zmluvy o predplatnom.

Na tejto stránke

Konfigurácia

Polia

Akcia Získať údaje zmluvy o predplatnom obsahuje nasledujúce polia, ktoré sa používajú na vytvorenie vyhľadávacieho dopytu:

Polia používané v akciách Získať údaje.
Pole	Popis
Zoradiť údaje podľa	Povinné. Parametre, podľa ktorých sú zoradené údaje vrátené vyhľadávacím dopytom.
Maximálny počet výsledkov	Povinné. Maximálny počet výsledkov, ktoré môže vrátiť vybratý vyhľadávací dopyt. Naraz sa môže vrátiť maximálne 100 výsledkov.
Vyhľadávací dopyt	Povinné. Vyberte si z bežných vyhľadávacích dopytov alebo výberom možnosti Pokročilé vytvorte svoj vlastný.

Reťazec vyhľadávacieho dopytu

Toto je príklad vyhľadávacieho dopytu na získanie zmlúv o predplatnom so stavom ACTIVE:

status: ACTIVE

Premenná status je filter, ktorý je k dispozícii vo vyhľadávacom dopyte zmlúv o predplatnom, a dá sa použiť viackrát.

Pri dopytovaní údajov je užitočné vedieť tieto informácie:

Zoznam dostupných filtrov
Vyhľadávacie dopyty musia dodržiavať určitú syntax
Hodnoty polí vo vyhľadávacích dopytoch nie sú vždy zdokumentované. V niektorých prípadoch ich možno nájsť v dokumentácii k rozhraniu API. Hodnoty polí často nájdete aj v adresách URL v administrátorskom paneli pri filtrovaní. Ak chcete napríklad nájsť niektoré hodnoty pre vyhľadávací dopyt v časti Objednávky, vyfiltrujte stránku Objednávky v administrátorskom paneli a potom skontrolujte adresu URL.
Vyhľadávací dopyt vo svojom obchode môžete spustiť alebo otestovať pomocou aplikácie Shopify GraphiQL.
Dávajte pozor na to, čo sa stane v prípade zlyhania vyhľadávacieho dopytu. Rozhranie API často vráti všetky výsledky (namiesto žiadneho).

Vrátené údaje

Všetky akcie Získať údaje vrátia zoznam od 0 do 100 zdrojov. V závislosti od vášho prípadu použitia môžete tieto údaje využiť rôznymi spôsobmi:

Ak potrebujete spracovať každú položku zoznamu samostatne, napríklad ku každej pridať štítok, môžete použiť akciu Pre každé.
Ak potrebujete agregovať údaje, napríklad zistiť počet vrátených výsledkov, môžete použiť akcie Počet alebo Súčet.
Ak potrebujete vytvoriť výstup zoznamu, napríklad odoslať e-mail so všetkými položkami, vrátené údaje môžete použiť priamo v nasledujúcich akciách.

Ak chcete získať prístup k vráteným údajom v krokoch nasledujúcich po tejto akcii, použite premennú s názvom Získať údaje zmluvy o predplatnom, čo je zoznam zmlúv o predplatnom. Túto premennú môžete použiť v podmienkach aj akciách. Zoznam objednávok môžete napríklad odoslať v akcii Odoslať interný e-mail takto:

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

Spúšťače

Túto akciu môžete použiť v ľubovoľnom pracovnom postupe vrátane spúšťača Naplánovaný čas. V pracovnom postupe, ktorý používa spúšťač Naplánovaný čas, sa pracovný postup začne v určenom čase a nie ako výsledok udalosti. Keďže vo vašom obchode ani z aplikácie neexistuje žiadna konkrétna udalosť, ktorá by spustila pracovný postup, žiadne údaje sa nezahrnú automaticky.