Metafelt-udløser for virksomhedens lokation

Metafelt-udløser for virksomhedens lokation

Kopier side

Start en Shopify Flow-arbejdsgang, når et metafelt for en virksomhedslokation ændres, fx et leveringsvindue for B2B-kunder. Se krav og opsætning.

En B2B-kunde har flere filialer, og hver enkelt modtager leverancer på forskellige tidspunkter. Tidspunkterne gemmes i metafeltet Leveringsvindue (custom.delivery_window) for virksomhedens lokation, og logistikafdelingen skal have besked om eventuelle ændringer, inden den næste forsendelse planlægges.

Denne side viser, hvordan man starter en Shopify Flow-arbejdsgang, hver gang et metafelt for en virksomheds lokation ændres, ved hjælp af Workflow Trigger Extensions. Trinene er de samme for alle metafelter af denne ressourcetype; i eksemplet anvendes Leveringsvindue (custom.delivery_window).

Hvad du skal bruge

  • En metafeltdefinition. Opret den i din Shopify-administrationspanel under Indstillinger > Metafelter og metaobjekter > Virksomhedslokationer. Et metafelt uden en definition kan ikke spores.
  • Tilladelsen Adgang til virksomheds- og virksomhedslokationsdata (B2B). Du skal give denne tilladelse på appens side med tilladelser - se Tilladelser og dataadgang.
  • Virksomhedslokationer er en del af B2B på Shopify. Denne ressourcetype kan kun bruges i en butik, der har virksomheder.

1. Spor metafeltet

  1. Åbn Metafelt-udløsere i appen, og klik på Tilføj udløser.
  2. Vælg ressourcetypen Virksomhedsadresse.
  3. Markér metafeltet, her Leveringsvindue. 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 »Virksomhedsadresse« og metafeltet »Leveringsvindue«, custom.delivery_window, markeret
Ressourcetype: Virksomhedsadresse, hvor metafeltet er markeret. Alle metafelter registrerer i stedet alle metafelter af denne type.

Den nye udløser viser Initialiserer, mens appen læser den aktuelle værdi af metafeltet for dine eksisterende virksomhedslokationer, og derefter Aktiv. Det er netop denne første aflæsning, der gør, at den allerførste ændring allerede kommer med den korrekte tidligere 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 Metafield Update i Shopify Flow med følgende værdier:

Variabel Værdi
resourceType COMPANYLOCATION
resourceId ID'et for virksomhedens lokation, f.eks. gid://shopify/CompanyLocation/1234567890
metafieldKey Navneområde og nøgle, her custom.delivery_window
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

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 COMPANYLOCATION. Opdateringen af metafelter starter for hver ressourcetype, du sporer, så betingelsen begrænser denne arbejdsgang til virksomhedens lokationer. Hvis du sporer flere metafelter af denne type, skal du tilføje metafieldKey er lig med custom.delivery_window 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 COMPANYLOCATION og afsendelse af intern e-mail
Eksempel på en arbejdsgang: udløseren, 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-administrationspanel, 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

  • Send det nye vindue til din udbyder eller dit planlægningsværktøj ved hjælp af Send HTTP-anmodning.
  • Tilføj en betingelse for metafieldKey, når du sporer flere metafelter for virksomhedens lokationer.
  • Gem den gamle værdi i e-mailen ved hjælp af metafield.previousValue, så ingen behøver at slå den op.

Hvor hurtigt det reagerer

Shopify underretter appen, når en virksomhedslokation gemmes. Ved ændringer, der udelukkende vedrører et metafelt, sendes der undertiden ingen underretning, så appen tjekker derfor også dine virksomhedslokationer cirka en gang i minuttet. Du kan forvente, at arbejdsgangen starter inden for få sekunder og senest efter et minut eller to.

Mere