Kartlegging av nyttelast og Shopify Flow-variabler

Kopier side

Knytt opptil fire nyttelastfelt til Shopify Flow-variabler med punktbaner, og se hva som skjer med manglende felt, objekter og matriser.

Triggerfeltene i Shopify Flow er enkle strenger. Datapakken din er sannsynligvis ikke det. Tilordning er måten du velger ut de delene av en innkommende forespørsel som arbeidsflyten din trenger.

De fire feltene

Hver webhook gjør fire felt tilgjengelige for Shopify Flow: fieldOne, fieldTwo, fieldThree og fieldFour. Under Avanserte innstillinger må du knytte hvert av disse feltene til en nøkkel i datapakken din.

Gitt følgende forespørselstekst:

Fanen «Avanserte innstillinger», der felt 1 til felt 4 er tilordnet til «orderId», «status», «total» og «note» — Avanserte innstillinger: Tilordne opptil fire verdier fra forespørselsteksten. Disse kommer inn i Shopify Flow som fieldOne til fieldFour.

Shopify Flow — Hva utløseren sender til arbeidsflyten din: webhook-ID-en og de fire tilordnede feltene dine, vist sammen med verdiene fra en nylig forespørsel.

json

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

Felt	Vis på kartet	Verdien som sendes til Shopify Flow
`fieldOne`	`orderId`	`1001`
`fieldTwo`	`customer.email`	`someone@example.com`
`fieldThree`	`customer.name`	`Alex`
`fieldFour`	`note`	`gift wrap`

Innebygde verdier bruker punktseparerte baner (customer.email). Elementer i en matrise bruker en indeks (items.0.sku).

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

Objekter og tabeller

Hvis en tilordnet verdi i seg selv er et objekt eller en matrise, konverterer vi den automatisk til en JSON-streng, fordi Shopify Flow-variabler ikke kan inneholde strukturer. Når man tilordner fieldOne til customer fra eksemplet ovenfor, blir resultatet i Shopify Flow:

text

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

Analyser den i en «Shopify Flow Run Code»-handling når du trenger delene igjen.

Når fire felt ikke er nok

Fire navngitte felt dekker de fleste integrasjoner. Når dette ikke er tilfelle, har du tre valgbare brytere, som alle finnes under Avanserte innstillinger og som alle er slått av som standard:

Innstilling	Hva Shopify Flow mottar	Felt i Shopify Flow
Tillat tilpasset forespørselstekst	Aksepterer alle kroppsformer uten strenge krav	-
Bruk hele kroppen	Hele forespørselsinnholdet som en JSON-streng	`rawBody`
Inkluder forespørselshoder	Forespørselens overskrifter som en liste med nøkkel/verdi-par	`requestHeaders`
Inkluder spørringsparametere	URL-spørringsstrengen som en liste med nøkkel/verdi-par	`queryParams`

requestHeaders og queryParams leveres som lister - gå gjennom requestHeaders.items i en «Kjør kode»-handling, der hver oppføring er { key, value }.

Sørg for at filstørrelsen er under 50 KB

Shopify Flows setter en grense på 50 KB for hver utløsning. Vi måler den nøyaktige datamengden vi skal sende, og avviser alt som er større med payload_too_large med en gang, slik at du får en tydelig feilmelding i stedet for at arbeidsflyten mislykkes senere.

Hvis du får feilmelding, kan du sende en mindre dataobjekt, eller deaktivere alternativene Bruk hele dataobjektet, Inkluder forespørselshoder og Inkluder spørringsparametere - det er vanligvis disse som utløser feilen.

Overskrifter og søk blir alltid loggført

Opt-in-bryterne styrer kun hva som videresendes til Shopify Flow. Oppkallshistorikken registrerer alltid overskriftene og spørringsstrengen (med sensitive verdier maskert), slik at du kan feilsøke en forespørsel uten å sende alt til arbeidsflyten din.