Gegevens van verkoopplangroep ophalen
In workflows waarvoor gegevens van verkoopplangroepen nodig zijn, kun je de actie Gegevens van verkoopplangroep ophalen gebruiken om bestelgegevens uit je winkel op te halen.
Configuratie
Velden
De actie Gegevens van verkoopplangroep ophalen bevat de volgende velden, die worden gebruikt om de query op te bouwen:
| Veld | Beschrijving |
|---|---|
| Gegevens sorteren op | Vereist. De parameters waarmee de gegevens die door de zoekopdracht worden geretourneerd, worden gesorteerd. |
| Maximumaantal resultaten | Vereist. Het maximumaantal resultaten dat kan worden geretourneerd door de geselecteerde zoekopdracht. Je kunt er maximaal 100 tegelijk retourneren. |
| Query | Vereist. Kies uit veelvoorkomende query's of selecteer Geavanceerd om je eigen query aan te maken. |
Querystring
Dit is een voorbeeldquery voor het ophalen van verkoopplangroepen die de afgelopen dag zijn bijgewerkt:
name='Subscribe & Save'De variabele category is een filter die beschikbaar is voor de query voor verkoopplangroepen en kan worden gebruikt om specifieke categorieën verkoopplangroepen te selecteren.
Bij het opvragen van gegevens is het handig om het volgende te weten:
- Lijst met beschikbare filters voor verkoopplangroepen
- Query's moeten een bepaalde syntaxis volgen
- De waarden van queryvelden zijn niet altijd gedocumenteerd. In sommige gevallen kun je de waarden vinden door de API-documentatie te raadplegen. Je kunt de veldwaarden ook vaak vinden in de URL's in het beheerpaneel wanneer je filtert. Als je bijvoorbeeld bepaalde querywaarden voor bestellingen wilt vinden, filter je de pagina Bestellingen in het beheerpaneel en controleer je vervolgens de URL.
- Je kunt een query in je winkel uitvoeren of testen met de Shopify GraphiQL-app.
- Houd er rekening mee wat er gebeurt als je query mislukt. Vaak retourneert de API alle resultaten (in plaats van geen).
Geretourneerde gegevens
Alle acties van het type Gegevens ophalen retourneren een lijst van 0 tot 100 resources. Afhankelijk van je use case, wil je deze gegevens misschien op verschillende manieren gebruiken:
- Als je elk lijstitem afzonderlijk wilt verwerken, bijvoorbeeld om aan elk item een tag toe te voegen, kun je de actie Voor elke gebruiken.
- Als je gegevens wilt verzamelen, bijvoorbeeld om te tellen hoeveel resultaten er zijn geretourneerd, kun je de acties Tellen of Optellen gebruiken.
- Als je de lijst wilt uitvoeren, bijvoorbeeld om een e-mail met alle artikelen te verzenden, kun je de geretourneerde gegevens rechtstreeks in de daaropvolgende acties gebruiken.
Om toegang te krijgen tot de geretourneerde gegevens in stappen die na deze actie komen, gebruik je de variabele Gegevens van verkoopplangroep ophalen. Dit is een lijst met verkoopplangroepen. Je kunt deze variabele gebruiken in zowel voorwaarden als acties. Je kunt bijvoorbeeld de lijst met verkoopplangroepen verzenden in een actie Interne e-mail verzenden, zoals hieronder:
{% for getSellingPlanGroupData_item in getSellingPlanGroupData %}
{{getSellingPlanGroupData_item.name}}
{% endfor %}Voorbeeld
Een workflow is bijvoorbeeld zo ingesteld dat deze elke zondag om 9.00 uur wordt uitgevoerd. De actie Gegevens van verkoopplangroep ophalen wordt gebruikt om gegevens te verzamelen voor verkoopplangroepen die in de afgelopen week zijn aangemaakt. Als de producten die aan de verkoopplangroepen zijn gekoppeld je bestsellers zijn, kan de position van de verkoopplangroep worden verhoogd.