Udløser for metafelt »Order«

Udløser for metafelt »Order«

Kopier side

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

  1. Åbn Metafelt-udløsere i appen, og klik på Tilføj udløser.
  2. Vælg ressourcetypen Ordre.
  3. Markér metafeltet, her Gavebesked. Du kan markere flere på én gang eller bruge Vælg alle.
  4. 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.

Dialogboksen »Tilføj metafelt-udløser« med ressourcetypen »Ordre« og metafeltet »Gavebesked«, custom.gift_message, markeret
Ressourcetype: Ordre, metafeltet er markeret. Alle metafelter sporer i stedet alle metafelter af denne type.

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

  1. I Shopify Flow skal du oprette en arbejdsgang og vælge udløseren Metafelt Update fra Workflow Trigger Extensions.
  2. Tilføj en betingelse: resourceType er lig med ORDER. 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øje metafieldKey er lig med custom.gift_message som et andet kriterium.
  3. Tilføj den ønskede handling. I eksemplet sendes en intern e-mail med den gamle og den nye værdi.
Eksempel på en arbejdsgang i Shopify Flow: Opdatering af metafelt, en betingelse for ressourcetypen ORDER og afsendelse af intern e-mail
Eksempel på en arbejdsgang: udløser, betingelsen for ressourcetypen og én handling.

Start med eksemplet

  1. Download .flow-filen, der er vedhæftet nederst på denne side.
  2. Åbn Shopify Flow i din Shopify-administrationsside, klik på Import og vælg filen.
  3. Åbn trinnet Send intern e-mail, og indtast modtageren. Filen indeholder bevidst ingen adresse.
  4. 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.value er 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