Trigger för ordermetafält

Trigger för ordermetafält

Kopiera sidan

Starta ett Shopify Flow-arbetsflöde när ett metafält i en beställning ändras. Spåra det i Workflow Trigger Extensions och hämta det gamla och det nya värdet.

En kund ber kundtjänsten att lägga till ett presentmeddelande efter att beställningen har gjorts. Kundtjänsten skriver in det i beställningens metafält ”Presentmeddelande” (custom.gift_message), och packteamet måste se det innan paketet skickas iväg.

På den här sidan beskrivs hur man startar ett Shopify Flow-arbetsflöde när ett metafält i en beställning ändras, med hjälp av Workflow Trigger Extensions. Stegen är desamma för alla metafält av denna resurstyp; i exemplet används ”Gåvomeddelande” (custom.gift_message).

Vad du behöver

  • En metafältdefinition. Skapa den i din Shopify-admin under Inställningar > Metafält och metaobjekt > Beställningar. Ett metafält utan definition kan inte spåras.
  • Behörigheten ”Dataåtkomst”. Bevilja den på appens sida för behörigheter, se Behörigheter och åtkomst till data.

1. Spåra metafältet

  1. Öppna ”Metafield-utlösare” i appen och klicka på ”Lägg till utlösare”.
  2. Välj resurstypen ”Order”.
  3. Markera metafältet, i detta fall ”Presentmeddelande”. Du kan markera flera samtidigt eller använda ”Välj alla”.
  4. Klicka på ”Lägg till utlösare”.

För att spåra alla metafält för den här resurstypen, inklusive de som du skapar senare, väljer du ”Alla metafält” istället för att markera enskilda fält och klickar sedan på ”Spåra alla metafält”.

Dialogrutan ”Lägg till metafältutlösare” med resurstypen ”Order” och metafältet ”Gåva” (anpassat meddelande: custom.gift_message) markerat
Resurstyp: Order, metafältet är markerat. Alternativet ”Alla metafält” spårar istället alla metafält av den typen.

Den nya utlösaren visar ”Initialiserar” medan appen läser in det aktuella värdet för metafältet i dina befintliga beställningar, och därefter ”Aktiv”. Det är tack vare den första avläsningen som den allra första ändringen redan kommer med rätt tidigare värde.

Om metafältet saknas i listan klickar du på ”Uppdatera metafält” på sidan ”Metafältutlösare”: appen lagrar listan med definitioner i en timme.

2. Vad arbetsflödet tar emot

Varje ändring utlöser händelsen ”Metafield Update” i Shopify Flow med följande värden:

Variabel Värde
resourceType ORDER
resourceId Order-ID:t, till exempel gid://shopify/Order/1234567890
metafieldKey Namnrymd och nyckel, här custom.gift_message
metafield.value Det nya värdet
metafield.previousValue Värdet före ändringen; tomt när metafältet angavs för första gången
metafield.type Metafältets typ, till exempel single_line_text_field

”Order Metafield Update” är en andra utlösare för samma ändring. Den startas utöver ”Metafield Update” och hanterar ordern som en inbyggd Shopify Flow-referens, vilket innebär att Shopifys egna orderåtgärder fungerar på den utan något uppslagssteg. Båda delar samma händelse, så att använda båda räknas inte dubbelt. Aktivera den på appens sida Triggers, eller aktivera ett arbetsflöde som använder den.

3. Skapa arbetsflödet

  1. I Shopify Flow skapar du ett arbetsflöde och väljer utlösaren ”Metafield Update” från Workflow Trigger Extensions.
  2. Lägg till ett villkor: resourceType är lika med ORDER. Uppdateringen av metafältet startar för varje resurstyp som du spårar, så villkoret begränsar detta arbetsflöde till beställningar. Om du spårar flera metafält av samma typ lägger du till metafieldKey är lika med custom.gift_message som ett andra kriterium.
  3. Lägg till den åtgärd du behöver. I exemplet skickas ett internt e-postmeddelande med det gamla och det nya värdet.
Exempel på arbetsflöde i Shopify Flow: Uppdatering av metafält, ett villkor för resurstypen ORDER och skicka internt e-postmeddelande
Exempel på arbetsflöde: utlösaren, villkoret för resurstypen och en åtgärd.

Börja med exemplet

  1. Ladda ner .flow-filen som finns bifogad längst ner på denna sida.
  2. Öppna Shopify Flow i din Shopify-admin, klicka på Importera och välj filen.
  3. Öppna steget ”Skicka internt e-postmeddelande” och ange mottagaren. Filen innehåller avsiktligt ingen adress.
  4. Aktivera arbetsflödet.

Gör den till din egen

  • Märk beställningen: välj funktionen ”Lägg till beställningsetiketter” och ange {{resourceId}} i fältet för beställningsnummer.
  • Lägg till villkoret ”metafield.value är inte tomt” så att ett borttaget meddelande inte skickar något.
  • Använd ”Uppdatering av ordermetafält” när arbetsflödet ska läsa in enskilda rader eller leveransadressen.

Hur snabbt den reagerar

Shopify meddelar appen när en beställning sparas, så arbetsflödet startar vanligtvis inom några sekunder.

Bra att veta

  • Som standard visar appen beställningar som skapats under de senaste 60 dagarna. För äldre beställningar krävs full åtkomst till beställningshistoriken på sidan ”Behörigheter” samt ett längre tidsintervall i appens inställningar för beställningshistoriken.

Mer