Utløser for metafeltet «Bedriftens beliggenhet»

Utløser for metafeltet «Bedriftens beliggenhet»

Kopier side

Start en Shopify Flow-arbeidsflyt når et metafelt på en B2B-bedriftslokasjon endres, og få både gammel og ny verdi med Workflow Trigger Extensions.

En B2B-kunde har flere filialer, og hver av dem tar imot leveranser på forskjellige tidspunkter. Tidspunktene lagres i metafeltet Leveringsvindu (custom.delivery_window) for selskapets lokasjon, og logistikkavdelingen må få beskjed om endringer før neste forsendelse planlegges.

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

Det du trenger

  • En metafeltdefinisjon. Opprett den i Shopify-administrasjonspanelet under Innstillinger > Metafelt og metaobjekter > Bedriftens lokasjoner. Et metafelt uten definisjon kan ikke spores.
  • Tillatelsen Tilgang til bedrifts- og bedriftslokasjonsdata (B2B). Gi denne tillatelsen på appens side for tillatelser; se Tillatelser og datatilgang.
  • Bedriftslokasjoner er en del av B2B på Shopify. Ressurstypen er kun relevant for butikker som har bedrifter.

1. Spore metafeltet

  1. Åpne Metafeltutløsere i appen og klikk på Legg til utløser.
  2. Velg ressurstypen Bedriftslokalisering.
  3. Merk av i metafeltet, her Leveringsvindu. Du kan merke av flere samtidig eller bruke Velg alle.
  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 «Bedriftslokalisering» og metafeltet «Leveringsvindu», custom.delivery_window, merket av
Ressurstype «Bedriftslokalisering», med avkryssingsruten for metafeltet merket av. «Alle metafelt» sporer i stedet alle metafelt av denne typen.

Den nye utløseren viser Initialiserer mens appen leser inn den gjeldende verdien for metafeltet for dine eksisterende bedriftslokasjoner, og deretter Aktiv. Det er takket være denne første avlesningen 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 COMPANYLOCATION
resourceId ID-en til selskapets lokasjon, for eksempel gid://shopify/CompanyLocation/1234567890
metafieldKey Navneområde og nøkkel, her custom.delivery_window
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

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 COMPANYLOCATION. Oppdateringen av metafelt starter for hver ressurstype du sporer, så dette vilkåret begrenser denne arbeidsflyten til selskapets lokasjoner. Når du sporer flere metafelt av denne typen, kan du legge til metafieldKey er lik custom.delivery_window som et andre kriterium.
  3. Legg til den handlingen du trenger. I dette eksemplet sendes 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 COMPANYLOCATION 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

  • Send det nye vinduet til operatøren eller planleggingsverktøyet ditt ved hjelp av Send HTTP-forespørsel.
  • Legg til et vilkår for metafieldKey når du sporer flere metafelt for bedriftens lokasjoner.
  • Behold den gamle verdien i e-posten ved hjelp av metafield.previousValue, slik at ingen trenger å slå den opp.

Hvor raskt det reagerer

Shopify sender et varsel til appen når en bedriftslokalisering lagres. Ved endringer som kun berører et metafelt, sendes det noen ganger ikke noe varsel, så appen sjekker også bedriftslokaliseringene dine omtrent en gang i minuttet. Du kan forvente at arbeidsflyten starter i løpet av sekunder, og senest etter et minutt eller to.

Mer