Utløser for metafelt i ordre

Utløser for metafelt i ordre

Kopier side

Start en Shopify Flow-arbeidsflyt når et metafelt i en ordre endres, som en gavehilsen. Spor det med Workflow Trigger Extensions og få gammel og ny verdi.

En kunde ber kundeservice om å legge til en gavehilsen etter at bestillingen er lagt inn. Kundeservice skriver den inn i bestillingens metafelt Gavehilsen (custom.gift_message), og pakketeamet må se den før pakken sendes ut.

Denne siden viser hvordan du kan starte en Shopify Flow-arbeidsflyt hver gang et metafelt i en ordre endres, ved hjelp av Workflow Trigger Extensions. Fremgangsmåten er den samme for alle metafelt av denne ressurstypen; i eksemplet brukes Gavehilsen (custom.gift_message).

Det du trenger

  • En metafeltdefinisjon. Opprett den i Shopify-administrasjonspanelet under Innstillinger > Metafelt og metaobjekter > Bestillinger. Et metafelt uten definisjon kan ikke spores.
  • Tillatelsen Dataadgang. Gi denne tillatelsen på appens side for tillatelser; se Tillatelser og datatilgang.

1. Spore metafeltet

  1. Åpne Metafeltutløsere i appen og klikk på Legg til utløser.
  2. Velg ressurstypen Bestilling.
  3. Merk av i metafeltet Gavehilsen. Du kan merke av flere samtidig eller bruke Velg alt.
  4. Klikk på Legg til utløser.

For å spore alle metafelt for denne ressurstypen, inkludert de du oppretter senere, velger du Alle metafelt i stedet for å merke av enkeltfelt, og klikker deretter på Spor alle metafelt.

Dialogboksen «Legg til metafeltutløser» med ressurstypen «Bestilling» og metafeltet «Gavemelding» (custom.gift_message) merket av
Ressurstype «Order», med metafeltet avmerket. «All metafields» sporer i stedet alle metafelt av denne typen.

Den nye utløseren viser Initialiserer mens appen leser inn den gjeldende verdien for metafeltet i dine eksisterende bestillinger, og deretter Aktiv. Det er nettopp denne første avlesningen som gjør at den aller første endringen allerede kommer med riktig tidligere verdi.

Hvis metafeltet mangler i listen, klikker du på Oppdater metafelt på siden «Metafeltutløsere»: appen lagrer listen over definisjoner i en time.

2. Hva arbeidsflyten mottar

Hver endring utløser utløseren Metafield Update i Shopify Flow, med følgende verdier:

Variabel Verdi
resourceType ORDER
resourceId Ordrens ID, for eksempel gid://shopify/Order/1234567890
metafieldKey Navneområde og nøkkel, her custom.gift_message
metafield.value Den nye verdien
metafield.previousValue Verdien før endringen; tom når metafeltet ble angitt for første gang
metafield.type Metafeltets type, for eksempel single_line_text_field

Order Metafield Update er en annen utløser for den samme endringen. Den starter i tillegg til «Metafield Update» og inneholder ordren som en innebygd Shopify Flow-referanse, slik at Shopifys egne ordrehandlinger fungerer på den uten et oppslagstrinn. Begge deler én hendelse, så bruk av begge teller ikke dobbelt. Slå den på fra appens Triggers-side, eller aktiver en arbeidsflyt som bruker den.

3. Opprett arbeidsflyten

  1. I Shopify Flow oppretter du en arbeidsflyt og velger utløseren Metafield Update fra Workflow Trigger Extensions.
  2. Legg til et vilkår: resourceType er lik ORDER. Oppdateringen av metafelt starter for hver ressurstype du sporer, så dette vilkåret begrenser denne arbeidsflyten til bestillinger. Når du sporer flere metafelt av denne typen, legger du til metafieldKey er lik custom.gift_message som et andre kriterium.
  3. Legg til den handlingen du trenger. I eksemplet sendes det en intern e-post med den gamle og den nye verdien.
Eksempel på arbeidsflyt i Shopify Flow: Oppdatering av metafelt, et vilkår for ressurstypen ORDER og sending av intern e-post
Eksempel på arbeidsflyt: utløseren, betingelsen knyttet til ressurstypen og én handling.

Ta utgangspunkt i eksemplet

  1. Last ned .flow-filen som er vedlagt nederst på denne siden.
  2. I Shopify-administrasjonspanelet åpner du Shopify Flow, klikker på Importer og velger filen.
  3. Åpne trinnet Send intern e-post og skriv inn mottakeren. Filen inneholder bevisst ingen adresse.
  4. Slå på arbeidsflyten.

Gjør det til ditt eget

  • Merk bestillingen: Velg handlingen Legg til bestillingsmerker og skriv inn {{resourceId}} i feltet for bestillingsnummer.
  • Legg til betingelsen «metafield.value er ikke tom», slik at en fjernet melding ikke sender noe.
  • Bruk Oppdatering av ordre-metafelt når arbeidsflyten skal hente linjeposter eller leveringsadressen.

Hvor raskt det reagerer

Shopify gir appen beskjed når en bestilling lagres, så arbeidsflyten starter vanligvis i løpet av noen sekunder.

Godt å vite

  • Som standard viser appen bestillinger som er opprettet de siste 60 dagene. For eldre bestillinger må du ha full tilgang til bestillingshistorikken på siden «Tillatelser» og velge et lengre tidsintervall i appens innstillinger for bestillingshistorikk.

Mer