Toewijzing van payloads en Flow-variabelen

Shopify Flow Triggervelden bestaan uit platte tekenreeksen. Uw payload is dat waarschijnlijk niet. Met behulp van toewijzing selecteert u de onderdelen van een binnenkomend verzoek die uw workflow nodig heeft.

De vier gebieden

Elke webhook stelt vier velden beschikbaar voor Shopify Flow: fieldOne, fieldTwo, fieldThree, fieldFour. Stel onder ‘Geavanceerde instellingen’ elk van deze velden in op een sleutel in uw payload.

Uitgaande van de volgende verzoektekst:

Het tabblad ‘Geavanceerde instellingen’, waarbij Veld 1 tot en met Veld 4 zijn gekoppeld aan orderId, status, total en note — Geavanceerde instellingen: koppel maximaal vier waarden uit de request body. Deze worden in `Shopify Flow` weergegeven als `fieldOne` tot en met `fieldFour`.

Het paneel ‘Een variabele toevoegen’ van Shopify Flow voor de Webhook-trigger, waarin webhookId en fieldOne tot en met fieldFour worden weergegeven met voorbeeldwaarden uit een recent verzoek — Wat de trigger aan uw workflow doorgeeft: de webhook-ID en uw vier gekoppelde velden, weergegeven met de waarden van een recent verzoek.

json

{
  "orderId": "1001",
  "customer": { "email": "someone@example.com", "name": "Alex" },
  "note": "gift wrap"
}

Veld	Op de kaart weergeven	Waarde die tot Shopify Flow leidt
`fieldOne`	`orderId`	`1001`
`fieldTwo`	`customer.email`	`someone@example.com`
`fieldThree`	`customer.name`	`Alex`
`fieldFour`	`note`	`gift wrap`

Bij geneste waarden wordt gebruikgemaakt van puntnotatie (customer.email). Bij array-elementen wordt gebruikgemaakt van een index (items.0.sku).

In Shopify Flow verwijst u ernaar als {{fieldOne}}, {{fieldTwo}} enzovoort.

Objecten en arrays

Indien een toegewezen waarde zelf een object of een array is, zetten wij deze automatisch om in een JSON-string, aangezien Shopify Flow geen structuren kan bevatten. Wanneer u fieldOne toewijst aan customer uit het bovenstaande voorbeeld, levert dit in Shopify Flow het volgende op:

text

{"email":"someone@example.com","name":"Alex"}

Verwerk het in een ‘Run Code’-actie in een Shopify Flow wanneer u de onderdelen weer nodig hebt.

Wanneer vier velden niet voldoende zijn

Vier benoemde velden dekken de meeste integraties af. Indien dit niet het geval is, beschikt u over drie inschakelschakelaars, die allemaal onder ’Geavanceerde instellingen’ te vinden zijn en standaard zijn uitgeschakeld:

Setting	Wat Shopify Flow ontvangt	Veld in Shopify Flow
Aangepaste verzoektekst toestaan	Accepteert elke lichaamsvorm zonder strenge controle	-
Gebruik uw hele lichaam	De volledige inhoud van het verzoek als een JSON-string	`rawBody`
Verzoekheaders opnemen	De headers van het verzoek als een lijst met sleutel-waardeparen	`requestHeaders`
Queryparameters opnemen	De query-string van de URL als een lijst met sleutels en waarden	`queryParams`

requestHeaders en queryParams worden als lijsten weergegeven - doorloop requestHeaders.items in een actie ‘Code uitvoeren’, waarbij elk item { key, value } is.

Zorg ervoor dat het kleiner is dan 50 KB

Shopify Flow beperkt elke triggerrun tot 50 KB. Wij meten vooraf de exacte payload die wij zouden verzenden en wijzen alles wat groter is af met een payload_too_large, zodat u direct een duidelijke foutmelding krijgt in plaats van dat de workflow later mislukt.

Als u hier tegenaan loopt, kunt u een kleinere body verzenden of de opties ‘Gebruik volledige body’, ‘Verzoekheaders opn_emen_’ en ‘Queryparameters opnemen’ uitschakelen - dat zijn meestal de factoren die ervoor zorgen dat het niet lukt.

Kopteksten en zoekopdrachten worden altijd geregistreerd

De opt-in-schakelaars bepalen uitsluitend wat naar Shopify Flow wordt doorgestuurd. In de oproepgeschiedenis worden altijd de headers en de queryreeks vastgelegd (waarbij gevoelige waarden worden gemaskeerd), zodat u een verzoek kunt debuggen zonder alles naar uw workflow te sturen.