Udløser for metafelt »Order«
Start et Shopify Flow-arbejdsgang, når et metafelt i en ordre ændres. Følg med i Workflow Trigger Extensions, og få både den gamle og den nye værdi.
En kunde beder support om at tilføje en gavebesked, efter at ordren er afgivet. Support indtaster den i ordrens metafelt Gavebesked (custom.gift_message), og pakketeamet skal se den, inden pakken sendes af sted.
Denne side viser, hvordan man starter en Shopify Flow-arbejdsgang, hver gang et metafelt i en ordre ændres, ved hjælp af Workflow Trigger Extensions. Trinene er de samme for alle metafelter af denne ressourcetype; i eksemplet anvendes Gavebesked (custom.gift_message).
Hvad du skal bruge
- En metafeltdefinition. Opret den i din Shopify-administrationspanel under Indstillinger > Metafelter og metaobjekter > Ordrer. Et metafelt uden en definition kan ikke spores.
- Tilladelsen Dataadgang. Giv tilladelsen på appens side Tilladelser - se Tilladelser og dataadgang.
1. Spor metafeltet
- Åbn Metafelt-udløsere i appen, og klik på Tilføj udløser.
- Vælg ressourcetypen Ordre.
- Markér metafeltet, her Gavebesked. Du kan markere flere på én gang eller bruge Vælg alle.
- Klik på Tilføj udløser.
For at spore alle metafelter for denne ressourcetype, herunder dem, du opretter senere, skal du vælge Alle metafelter i stedet for at markere dem enkeltvis og derefter klikke på Spor alle metafelter.

Den nye udløser viser Initialiserer, mens appen læser den aktuelle værdi af metafeltet på dine eksisterende ordrer, og derefter Aktiv. Det er netop denne første aflæsning, der gør, at den allerførste ændring allerede kommer med den korrekte forrige værdi.
Hvis metafeltet ikke er med på listen, skal du klikke på Opdater metafelter på siden »Metafelt-udløsere«: appen gemmer listen over definitioner i en time.
2. Hvad arbejdsgangen modtager
Hver ændring udløser triggeren Metafelt Update i Shopify Flow med følgende værdier:
| Variabel | Værdi |
|---|---|
resourceType |
ORDER |
resourceId |
Ordrens ID, f.eks. gid://shopify/Order/1234567890 |
metafieldKey |
Navneområde og nøgle, her custom.gift_message |
metafield.value |
Den nye værdi |
metafield.previousValue |
Værdien før ændringen; tom, når metafeltet blev indstillet for første gang |
metafield.type |
Metafeltets type, f.eks. single_line_text_field |
Order Metafield Update er en anden udløser for den samme ændring. Den udløses ud over »Metafield Update« og indeholder ordren som en indbygget Flow-reference, så Shopifys egne ordrehandlinger kan udføres på den uden et opslagstrin. Begge deler den samme begivenhed, så brugen af begge tæller ikke dobbelt. Aktivér den på appens side Udløsere, eller aktiver en arbejdsgang, der bruger den.
3. Opbyg arbejdsgangen
- I Shopify Flow skal du oprette en arbejdsgang og vælge udløseren Metafelt Update fra Workflow Trigger Extensions.
- Tilføj en betingelse:
resourceTypeer lig medORDER. Opdateringen af metafelter starter for hver ressourcetype, du sporer, så denne betingelse sikrer, at denne arbejdsgang kun omfatter ordrer. Hvis du sporer flere metafelter af denne type, skal du tilføjemetafieldKeyer lig medcustom.gift_messagesom et andet kriterium. - Tilføj den ønskede handling. I eksemplet sendes en intern e-mail med den gamle og den nye værdi.

Start med eksemplet
- Download
.flow-filen, der er vedhæftet nederst på denne side. - Åbn Shopify Flow i din Shopify-administrationsside, klik på Import og vælg filen.
- Åbn trinnet Send intern e-mail, og indtast modtageren. Filen indeholder bevidst ingen adresse.
- Aktivér arbejdsgangen.
Gør det til dit eget
- Mærk ordren: Vælg handlingen Tilføj ordremærker, og indsæt
{{resourceId}}i feltet for ordren. - Tilføj betingelsen »
metafield.valueer ikke tom«, så der ikke sendes noget, når en besked slettes. - Brug Opdatering af ordrens metafelt, når arbejdsgangen skal læse varelinjer eller leveringsadressen.
Hvor hurtigt det reagerer
Shopify underretter appen, når en ordre gemmes, så arbejdsgangen starter som regel inden for få sekunder.
Godt at vide
- Som standard viser appen ordrer, der er oprettet inden for de seneste 60 dage. For ældre ordrer kræves der fuld adgang til ordrehistorikken på siden »Tilladelser« samt en længere tidsperiode i appens indstilling for ordrehistorik.
Mere
- Metafelt-udløsere: Sådan fungerer metafelt-udløsere for alle ressourcetyper.
- Udløs »Shopify Flow« ved opdateringer af ordre-metafelter: et eksempel med video.
- Hændelseshistorik og fejlfinding: Se alle begivenheder, som appen har sendt, med både den gamle og den nye værdi.
