Utlösare för metafältet ”Företagets plats”

Utlösare för metafältet ”Företagets plats”

Kopiera sidan

Starta ett Shopify Flow-arbetsflöde när ett metafält för en företagsplats ändras i B2B, med både det gamla och det nya värdet tillgängligt.

En B2B-kund har flera filialer, och varje filial tar emot leveranser vid olika tidpunkter. Tiderna lagras i metafältet ”Leveransfönster” (custom.delivery_window) för företagets plats, och logistikavdelningen måste informeras om en ändring innan nästa leverans planeras.

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

Vad du behöver

  • En metafältdefinition. Skapa den i din Shopify-admin under Inställningar > Metafält och metaobjekt > Företagets platser. Ett metafält utan definition kan inte spåras.
  • Behörigheten ”Åtkomst till företags- och företagsplatsdata (B2B)”. Bevilja den på appens sida för behörigheter, se Behörigheter och åtkomst till data.
  • Företagsplatser ingår i B2B på Shopify. Denna resurstyp är endast användbar i en butik som har företag.

1. Spåra metafältet

  1. Öppna ”Metafield-utlösare” i appen och klicka på ”Lägg till utlösare”.
  2. Välj resurstypen ”Företagets plats”.
  3. Markera metafältet, i detta fall ”Leveransfönster”. 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 ”Företagets plats” och metafältet ”Leveransfönster”, custom.delivery_window, markerat
Resurstyp: Företagets plats, medmetafältet markerat. Alla metafält spårar istället varje metafält av den typen.

Den nya utlösaren visar ”Initialiserar” medan appen läser in det aktuella värdet för metafältet för dina befintliga företagsplatser, och därefter ”Aktiv”. Det är tack vare den första avläsningen som redan den allra första ändringen 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 COMPANYLOCATION
resourceId ID för företagets plats, till exempel gid://shopify/CompanyLocation/1234567890
metafieldKey Namnrymd och nyckel, här custom.delivery_window
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

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 COMPANYLOCATION. Uppdateringen av metafältet startar för varje resurstyp som du spårar, så villkoret begränsar detta arbetsflöde till företagets platser. Om du spårar flera metafält av den här typen, lägg till metafieldKey är lika med custom.delivery_window 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 COMPANYLOCATION 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

  • Skicka det nya fönstret till din operatör eller ditt planeringsverktyg med funktionen ”Skicka HTTP-förfrågan”.
  • Lägg till ett villkor för metafieldKey när du spårar flera metafält för företagets platser.
  • Spara det gamla värdet i e-postmeddelandet med metafield.previousValue, så att ingen behöver leta reda på det.

Hur snabbt den reagerar

Shopify meddelar appen när en företagsplats sparas. Vid en ändring som endast berör ett metafält skickas ibland inget meddelande, så appen kontrollerar därför även dina företagsplatser ungefär en gång i minuten. Räkna med att arbetsflödet startar inom några sekunder, och senast efter en eller två minuter.

Mer