Trigger voor het metaveld ‘Productvariant’

Trigger voor het metaveld ‘Productvariant’

Pagina kopiëren

Start een Shopify Flow-workflow wanneer een metaveld van een productvariant verandert, zoals de bin-locatie. Bekijk de oude en nieuwe waarde.

Een magazijn slaat de schaplocatie van elke variant op in het metaveld Bin location (custom.bin_location). Wanneer een variant naar een ander schap wordt verplaatst, moet het orderverzamelteam de nieuwe locatie kennen voordat de volgende bestelling wordt verpakt.

Op deze pagina wordt uitgelegd hoe u met behulp van Workflow Trigger Extensions een Shopify Flow-workflow kunt starten telkens wanneer een metaveld van een productvariant verandert. De stappen zijn voor elk metaveld van dit resourcetype hetzelfde; in het voorbeeld wordt gebruikgemaakt van de bin-locatie (custom.bin_location).

Wat u nodig hebt

  • Een metaveld-definitie. U kunt deze aanmaken in uw Shopify-beheerdersgedeelte onder Instellingen > Metavelden en meta-objecten > Varianten. Een metaveld zonder definitie kan niet worden bijgehouden.
  • De machtiging Toegang tot product-, variant- en collectiegegevens. Verleen deze machtiging op de pagina Machtigingen van de app; zie Toestemmingen en toegang tot gegevens.

1. Houd het metaveld bij

  1. Open Metaveld-triggers in de app en klik op Trigger toevoegen.
  2. Kies het resourcetype Productvariant.
  3. Vink het metaveld aan, in dit geval Bin-locatie. U kunt meerdere velden tegelijk aanvinken of de optie Alles selecteren gebruiken.
  4. Klik op Trigger toevoegen.

Om elk metaveld van dit resourcetype bij te houden, inclusief de velden die u later aanmaakt, selecteert u Alle metavelden in plaats van afzonderlijke velden aan te vinken, en klikt u vervolgens op Alle metavelden bijhouden.

Het dialoogvenster ‘Trigger voor metaveld toevoegen’ met het resourcetype ‘Productvariant’ en het metaveld ‘Opslaglocatie’ (custom.bin_location), aangevinkt
Resourcetype ‘Productvariant’, waarbij het metaveld is aangevinkt. Bij ‘Alle metavelden’ worden in plaats daarvan alle metavelden van dit type bijgehouden.

De nieuwe trigger geeft Initializing weer terwijl de app de huidige waarde van het metaveld bij uw bestaande productvarianten uitleest, en vervolgens Active. Dankzij die eerste uitlezing wordt de allereerste wijziging al met de juiste vorige waarde doorgegeven.

Indien het metaveld ontbreekt in de lijst, klikt u op Metavelden vernieuwen op de pagina ‘Metaveldtriggers’: de app onthoudt de lijst met definities gedurende een uur.

2. Wat de workflow ontvangt

Elke wijziging activeert de trigger Metaveld Update in Shopify Flow met de volgende waarden:

Variabele Waarde
resourceType PRODUCTVARIANT
resourceId Het ID van de productvariant, bijvoorbeeld gid://shopify/ProductVariant/1234567890
metafieldKey Naamruimte en sleutel, in dit geval custom.bin_location
metafield.value De nieuwe waarde
metafield.previousValue De waarde vóór de wijziging; leeg wanneer het metaveld voor het eerst werd ingesteld
metafield.type Het type van het metaveld, bijvoorbeeld single_line_text_field

Productvariant Metafield Update is een tweede trigger voor dezelfde wijziging. Deze wordt naast ‘Metafield Update’ gestart en bevat het bovenliggende product als een native Flow-verwijzing. Beide delen één gebeurtenis, dus het gebruik van beide wordt niet dubbel geteld. Schakel deze in via de pagina Triggers van de app, of schakel een Workflow in die hiervan gebruikmaakt.

3. Stel de workflow samen

  1. Maak in Shopify Flow een workflow aan en kies de trigger Metaveld Update van Workflow Trigger Extensions.
  2. Voeg een voorwaarde toe: resourceType is gelijk aan PRODUCTVARIANT. De update van het metaveld wordt gestart voor elk resourcetype dat u bijhoudt, dus deze voorwaarde zorgt ervoor dat deze workflow beperkt blijft tot productvarianten. Wanneer u meerdere metavelden van dit type bijhoudt, voeg dan metafieldKey is gelijk aan custom.bin_location toe als tweede criterium.
  3. Voeg de gewenste actie toe. In het voorbeeld wordt een interne e-mail verzonden met de oude en de nieuwe waarde.
De voorbeeldworkflow in Shopify Flow: Metaveld bijwerken, een voorwaarde voor het resourcetype PRODUCTVARIANT en een interne e-mail verzenden
De voorbeeldworkflow: de trigger, de voorwaarde op basis van het resourcetype en één actie.

Begin met het voorbeeld

  1. Download het .flow-bestand dat onderaan deze pagina is bijgevoegd.
  2. Open Shopify Flow in uw Shopify-beheerdersgedeelte, klik op Importeren en selecteer het bestand.
  3. Open de stap Interne e-mail verzenden en voer de ontvanger in. Het bestand bevat bewust geen adres.
  4. Schakel de workflow in.

Maak het tot het uwe

  • Stuur de nieuwe locatie van de container naar uw magazijnsysteem via een HTTP-verzoek.
  • Gebruik de optie Productvariant-metaveld bijwerken wanneer de workflow het bovenliggende product moet labelen of bijwerken.
  • Voeg een voorwaarde toe voor metafieldKey wanneer u meerdere variant-metavelden bijhoudt en één workflow per metaveld wilt.

Hoe snel reageert het?

Shopify stuurt geen melding wanneer een metaveld van een variant wordt gewijzigd; daarom controleert de app uw catalogus ongeveer één keer per minuut en leest alleen de varianten die zijn gewijzigd. De verwerking duurt naar verwachting enkele minuten; de allereerste controle van een grote catalogus duurt langer.

Goed om te weten

  • Een variant-metaveld activeert de trigger Product Metafield Update niet: die trigger is bedoeld voor metavelden op het product zelf.

Meer