Kortlægning af payload og strømningsvariabler

Shopify Flow Triggerfelter er rene strenge. Din payload er sandsynligvis ikke det. Ved hjælp af mapping vælger du de dele af en indgående anmodning, som din arbejdsgang har brug for.

De fire felter

Hver webhook stiller fire felter til rådighed for Shopify Flow: fieldOne, fieldTwo, fieldThree, fieldFour. Under »Avancerede indstillinger« skal du knytte hvert felt til en nøgle i din payload.

Ud fra følgende anmodningstekst:

Fanen »Avancerede indstillinger«, hvor felt 1 til felt 4 er knyttet til henholdsvis orderId, status, total og note — Avancerede indstillinger: Tilknyt op til fire værdier fra anmodningens brødtekst. De modtages i `Shopify Flow` som `fieldOne` til `fieldFour`.

Shopify Flow-panel »Tilføj en variabel« til Webhook-udløseren, hvor webhookId og fieldOne til fieldFour vises med eksempelværdier fra en nylig anmodning — Hvad udløseren leverer til din arbejdsgang: webhook-ID’et og dine fire tilknyttede felter, vist med værdierne fra en nylig anmodning.

json

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

Felt	Vis det på kortet	En værdi, der når frem til Shopify Flow
`fieldOne`	`orderId`	`1001`
`fieldTwo`	`customer.email`	`someone@example.com`
`fieldThree`	`customer.name`	`Alex`
`fieldFour`	`note`	`gift wrap`

Indlejrede værdier bruger punktstier (customer.email). Array-elementer bruger et indeks (items.0.sku).

I Shopify Flow henviser man til dem som {{fieldOne}}, {{fieldTwo}} og så videre.

Objekter og arrays

Hvis en tilknyttet værdi i sig selv er et objekt eller en array, konverterer vi den automatisk til en JSON-streng, da Shopify Flow ikke kan indeholde strukturer. Når man i eksemplet ovenfor tilknytter fieldOne til customer, giver det følgende i Shopify Flow:

text

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

Analyser det i en »Flow Run Code«-handling, når du har brug for delene igen.

Når fire felter ikke er nok

Fire navngivne felter dækker de fleste integrationer. Hvis dette ikke er tilfældet, har du tre aktiveringsknapper, som alle findes under »Avancerede indstillinger« og som alle er slået fra som standard:

Indstilling	Hvad Shopify Flow modtager	Felt i Shopify Flow
Tillad brugerdefineret anmodningstekst	Accepterer alle kropstyper uden strenge krav	-
Brug hele kroppen	Hele anmodningens indhold som en JSON-streng	`rawBody`
Medtag anmodningsheadere	Anmodningens headere som en liste med nøgle/værdi-par	`requestHeaders`
Medtag forespørgselsparametre	URL-forespørgselsstrengen som en liste over nøgle/værdi-par	`queryParams`

requestHeaders og queryParams leveres som lister - gennemrequestHeaders.items i en »Kør kode«-handling, hvor hver post er { key, value }.

Sørg for, at den ikke overstiger 50 KB

Shopify Flow begrænser hver udløser-kørsel til 50 KB. Vi måler den nøjagtige payload, vi vil sende, og afviser alt, der er større, med en »payload_too_large« på forhånd, så du får en tydelig fejlmeddelelse i stedet for en arbejdsgang, der mislykkes senere.

Hvis du støder på problemet, skal du sende en mindre body eller deaktivere indstillingerne »Brug hele body« / »Medtag anmodningsheadere« / »Medtag forespørgselsparametre« - det er som regel disse indstillinger, der forårsager problemet.

Overskrifter og forespørgsler registreres altid

Opt-in-kontakterne styrer udelukkende, hvad der videresendes til Shopify Flow. Opkaldshistorikken registrerer altid headere og forespørgselsstrengen (hvor følsomme værdier er maskeret), så du kan fejlfinde en anmodning uden at sende det hele til din arbejdsgang.