Catalogusgegevens ophalen

In workflows waarvoor catalogusgegevens nodig zijn, kun je de actie Catalogusgegevens ophalen gebruiken om informatie over B2B-catalogi op te halen uit je winkel. Catalogi zijn groepen producten met aangepaste prijsstellingen voor specifieke B2B-klanten of bedrijfslocaties.

Opmerking

Dit is een type actie voor Gegevens ophalen. Raadpleeg Schema's, gegevens ophalen en workflows in een loop in Shopify Flow voor meer informatie over het gebruik van dit type actie met de trigger Geplande tijd en Voor elke-loops.

Configuratie

Velden

De actie Catalogusgegevens ophalen bevat de volgende velden:

Velden die worden gebruikt in de acties voor Gegevens ophalen.

Veld	Beschrijving
Gegevens sorteren op	Vereist. De parameters op basis waarvan de gegevens uit de zoekopdracht worden gesorteerd.
Maximumaantal resultaten	Vereist. Het maximale aantal resultaten dat kan worden geretourneerd door de zoekterm die je selecteert. Je kunt er maximaal 100 tegelijk retourneren.
Query	Vereist. Kies uit algemene query's of selecteer Geavanceerd om er zelf een aan te maken.

Query-tekenreeks

Dit is een voorbeeldquery om alle actieve catalogi op te halen:

status:ACTIVE

De variabele status is een filter dat beschikbaar is in de Catalogs-query en kan meerdere keren worden gebruikt of worden gecombineerd met andere variabelen.

Bij het opvragen van gegevens is het handig om het volgende te weten:

• Lijst met beschikbare catalogusfilters

• Query's moeten een bepaalde syntaxis volgen

• Waarden van queryvelden zijn niet altijd gedocumenteerd. In sommige gevallen kun je de waarden vinden in de API-documentatie. Daarnaast vind je de veldwaarden vaak in de URL's in het beheer wanneer je filtert. Als je bijvoorbeeld een aantal waarden voor een bestellingsquery wilt vinden, filter je de pagina Bestellingen in het beheer en bekijk je de URL.

• Je kunt een query in je winkel uitvoeren of testen met behulp van de Shopify GraphiQL-app.

• Let goed op wat er gebeurt als je query mislukt. Vaak retourneert de API alle resultaten (in plaats van geen).

Geretourneerde gegevens

Alle Gegevens ophalen-acties retourneren een lijst met 0 tot 100 bronnen. Afhankelijk van je usecase kun je deze gegevens op verschillende manieren gebruiken:

• Als je elk lijstitem afzonderlijk wilt behandelen, bijvoorbeeld om overal een tag aan toe te voegen, kun je de actie For each gebruiken.
• Als je gegevens moet verzamelen, zoals het tellen van het aantal geretourneerde resultaten, kun je de acties Count of Sum gebruiken.
• Als je de lijst wilt uitvoeren, bijvoorbeeld om een e-mail met alle artikelen te verzenden, kun je de geretourneerde gegevens rechtstreeks gebruiken in volgende acties.

Gebruik de variabele Get catalog data, een lijst met catalogi, om de geretourneerde gegevens in de stappen na deze actie op te vragen. Je kunt deze variabele gebruiken in zowel voorwaarden als acties. Je kunt bijvoorbeeld de lijst met catalogi in een Send internal email-actie verzenden, vergelijkbaar met dit:

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

Opmerking

Als een Gegevens ophalen-actie meerdere keren in één workflow wordt gebruikt, wordt er een getal aan de variabelenaam toegevoegd. In een workflow die de actie Get order data bijvoorbeeld twee keer gebruikt, is de eerste variabele voor de geretourneerde gegevens getOrderData en de tweede variabele getOrderData1. Deze naam kan niet worden aangepast.

Triggers

Je kunt deze actie gebruiken in elke workflow, inclusief de trigger Scheduled time. In een workflow die de trigger Scheduled time gebruikt, begint de workflow op een door jou opgegeven tijdstip in plaats van als resultaat van een gebeurtenis. Omdat er geen specifieke gebeurtenis in je winkel of via een app is die de workflow start, worden er niet automatisch gegevens toegevoegd.

API-referentie

Raadpleeg de Catalogs-query voor meer informatie over de API die in deze actie wordt gebruikt.