Hent data om abonnementsaftale

I workflows, der bruger data om abonnementsaftaler, kan du bruge handlingen Hent data om abonnementsaftale til at hente oplysninger om abonnementsaftaler fra din butik.

På denne side

Konfiguration

Felter

Handlingen Hent data om abonnementsaftale indeholder følgende felter, der bruges til at opbygge forespørgslen:

Felter, der bruges i handlinger af typen Hent data.
Felt	Beskrivelse
Sortér data efter	Krævet. De parametre, som de data, der returneres af søgeforespørgslen, sorteres efter.
Maksimalt antal resultater	Krævet. Det maksimale antal resultater, der kan returneres af den søgeforespørgsel, du vælger. Du kan returnere op til 100 ad gangen.
Forespørgsel	Krævet. Vælg mellem almindelige forespørgsler, eller vælg Avanceret for at oprette din egen.

Forespørgselsstreng

Dette er et eksempel på en forespørgsel til at hente abonnementsaftaler med status ACTIVE:

status: ACTIVE

Variablen status er et filter, der er tilgængeligt i forespørgslen om abonnementsaftaler og kan bruges flere gange.

Når du opretter forespørgsler på data, er det en hjælp at kende til:

Liste over tilgængelige filtre
Forespørgsler skal følge en bestemt syntaks
Værdier for forespørgselsfelter er ikke altid dokumenteret. I nogle tilfælde kan værdierne findes ved at se i API-dokumentationen. Alternativt kan du ofte finde feltværdierne i webadresserne i din administrator, når du filtrerer. Hvis du f.eks. vil finde nogle forespørgselsværdier for Ordrer, kan du filtrere siden Ordrer i administratoren og derefter tjekke webadressen.
Du kan køre eller teste en forespørgsel i din butik ved at bruge Shopify GraphiQL-appen.
Vær opmærksom på, hvad der sker, hvis din forespørgsel mislykkes. API'en returnerer ofte alle resultater (i stedet for ingen).

Returnerede data

Alle handlinger af typen Hent data returnerer en liste med mellem 0 og 100 ressourcer. Afhængigt af dit anvendelsesformål kan du bruge disse data på forskellige måder:

Hvis du har brug for at håndtere hver enkelt vare på listen individuelt, f.eks. for at tilføje et tag til hver, kan du bruge handlingen For hver.
Hvis du har brug for at aggregere data, f.eks. tælle, hvor mange resultater der blev returneret, kan du bruge handlingerne Tæl eller Sum.
Hvis du har brug for at udsende listen, f.eks. sende en mail med alle varerne, kan du bruge de returnerede data direkte i efterfølgende handlinger.

Hvis du vil have adgang til de returnerede data i de trin, der følger efter denne handling, skal du bruge variablen med navnet Hent data om abonnementsaftale, som er en liste over abonnementsaftaler. Du kan bruge denne variabel i både betingelser og handlinger. Du kan f.eks. sende listen over ordrer i en Send intern mail-handling som denne:

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

Udløsere

Du kan bruge denne handling i enhver arbejdsgang, herunder udløseren Planlagt tidspunkt. I en arbejdsgang, der bruger udløseren Planlagt tidspunkt, starter arbejdsgangen på et tidspunkt, du har angivet, i stedet for som et resultat af en hændelse. Da der ikke er nogen specifik hændelse i din butik eller fra en app, der starter arbejdsgangen, medfølger der ikke automatisk nogen data.