API-velden met argumenten gebruiken in Shopify Flow om variabelen aan te maken

Sommige variabelen hebben extra parameters nodig om goed te functioneren in een Shopify Flow-workflow. Deze parameters zijn argumenten waarvan jij de waarden moet opgeven voordat de variabele als compleet en bruikbaar voor de workflow wordt beschouwd.

Het veld product.inCollection bepaalt bijvoorbeeld of een product zich wel of niet in een opgegeven collectie bevindt en retourneert een booleaans resultaat true of false. Het id-argument van de collectie moet echter in dit veld worden opgenomen, omdat de variabele anders niet weet op welke specifieke collectie gecontroleerd moet worden. Om het veld correct te gebruiken, moet je het argument als onderdeel van het veld opnemen. Door bijvoorbeeld product.inCollection(id: "gid://shopify/Collection/123456") op te vragen, kan Flow bepalen of het product zich in de collectie met de ID 123456 bevindt en vervolgens zoals verwacht true of false retourneren. Wanneer je variabelen aanmaakt in Shopify Flow, hoef je niet te zoeken naar waarden zoals product- of collectie-ID's. Flow biedt een resourcekiezer om de gewenste waarde te selecteren, en de ID wordt automatisch ingevuld.

Om het opvragen van velden met argumenten te vereenvoudigen, kun je een nieuwe variabelenaam toewijzen aan de variabele die je aanmaakt vanuit het veld en argument in Shopify Flow. Als de naam van de collectie met de ID 123456 bijvoorbeeld Summer Bestsellers is, kun je de variabele inCollection(id: "gid://shopify/Collection/123456") de eenvoudigere naam inSummerBestsellers toewijzen. In alle volgende stappen van de workflow kun je vervolgens gewoon de variabele product.inSummerBestsellers gebruiken.

Omdat argumenten verschillen afhankelijk van welke waarden eraan worden toegewezen, kun je meerdere nieuwe variabelen aanmaken vanuit één veld dat argumenten vereist. Je kunt bijvoorbeeld 3 unieke variabelen aanmaken vanuit alleen het veld product.inCollection:

• product.inCollection(id: "gid://shopify/Collection/123456") kan product.inSummerBestsellers zijn.
• product.inCollection(id: "gid://shopify/Collection/654321") kan product.inSwimwear zijn.
• product.inCollection(id: "gid://shopify/Collection/112233") kan product.inBeachAccessories zijn.

Ondersteunde GraphQL Admin API-velden in Shopify Flow

Shopify Flow ondersteunt de volgende velden in de GraphQL Admin API met vereiste argumenten:

• channel.hasCollection
• collection.hasProduct
• collection.publishedOnChannel
• collection.publishedOnPublication
• companyLocation.inCatalog
• inventoryItem.inventoryLevel
• location.inventoryLevel
• metaobject.field
• market.assignedCustomization
• marketLocalizableResource.marketLocalizations
• product.inCollection
• product.publishedOnChannel
• product.publishedOnPublication
• product.restrictedForResource
• publication.hasCollection
• publishable.publishedOnChannel
• publishable.publishedOnPublication
• sellingPlanGroup.appliesToProduct
• sellingPlanGroup.appliesToProductVariant
• sellingPlanGroup.appliesToProductVariants
• 20 velden van het type translations, zoals collection.translations en product.translations

Niet-ondersteunde GraphQL Admin API-velden in Shopify Flow

Shopify Flow ondersteunt de volgende velden niet:

• deliveryCarrierService.availableServicesForCountries
• inventoryLevel.quantities
• return.suggestedFinancialOutcome
• return.suggestedRefund
• shop.search

Om gegevens van deze niet-ondersteunde velden in de workflow te gebruiken, moet je de actie HTTP-verzoek verzenden gebruiken.

Een variabele aanmaken uit een veld met een argument

Je kunt in Shopify Flow een variabele aanmaken voor elk ondersteund veld dat een argument vereist. Je hoeft de variabele maar één keer aan te maken in een enkele workflow, omdat de variabele als optie beschikbaar blijft in alle daaropvolgende stappen van de workflow.

De variabele die je aanmaakt, wordt niet gedeeld met andere workflows. Om deze in een andere workflow te gebruiken, moet je deze daar opnieuw toevoegen.

Stappen:

1. Klik in een Shopify Flow-workflow op Variabele toevoegen in een actie of voorwaarde.
2. Selecteer een veld dat een argument vereist. Deze velden hebben een +-knop. Klik vervolgens op + Variabele aanmaken.
3. Voer in het dialoogvenster Variabele aanmaken de volgende stappen uit:
   1. Stel een waarde in voor het vereiste argument op basis van het veld dat je hebt geselecteerd.
   2. Optioneel: pas in het veld Naam van nieuwe variabele aan hoe je de nieuwe variabele wilt noemen. Deze naam is alleen van toepassing op de huidige workflow.
   3. Klik op Toevoegen om het paneel voor variabeleselectie te vernieuwen.

Nadat je de nieuwe variabele aan een workflow hebt toegevoegd, blijft de variabele beschikbaar als veldoptie en kun je er in volgende stappen snel naar verwijzen. Als je ervoor kiest om op Variabele toevoegen te klikken, wordt deze genest weergegeven onder de oorspronkelijke veldoptie in de veldenlijst.

Een variabele aanmaken op basis van een metaveld in Shopify Flow

Metavelden zijn een type variabele met velden die argumenten vereisen. Het ophalen van metaveldgegevens in een Shopify Flow-workflow verschilt enigszins van het ophalen van standaardveldgegevens in andere variabelen. Omdat je de veldwaarden voor namespace en key van het metaveld aanmaakt en definieert, zijn deze altijd uniek voor je winkel.

Zo vereist het veld product.inCollection bijvoorbeeld altijd het argument id, ongeacht in welke winkel je werkt. Omdat je echter de naamruimte (namespace) en sleutel (key) instelt voor elk metaveld dat je in je winkel aanmaakt, zijn de vereiste argumenten uniek. Een variabele voor een productmetaveld waarin de wasvoorschriften voor een zomerkledingstuk staan, kan dus product.careGuideSummer.value zijn. Een variabele voor een productmetaveld waarin de ID wordt geregistreerd van de leeftijdsgroep waarvoor het product is bestemd, kan product.ageGroup.value_item.taxonomyReference.id zijn. De veldnamen en argumenten worden volledig door jou bepaald.

Meer informatie over metavelden in Shopify Flow.