Uw eerste workflow, stap voor stap

Uw eerste workflow, stap voor stap

Pagina kopiëren

Bouw stap voor stap uw eerste Shopify Flow-workflow met een Workflow Trigger Extensions-trigger, inclusief voorwaarden en acties.

In deze handleiding wordt één complete workflow opgezet vanuit een leeg Shopify Flow-canvas: het team waarschuwen wanneer een prijs met meer dan 10 procent wordt verlaagd. Hierbij wordt gebruikgemaakt van de trigger ‘Productvariantprijs gewijzigd’, maar aangezien elke trigger van deze app op dezelfde manier wordt gebruikt, zijn de vijf onderstaande stappen van toepassing op alle triggers.

De app moet geïnstalleerd zijn en u moet toestemming hebben voor toegang tot product-, variant- en collectiegegevens. Is dit niet het geval, begin dan met Installeren en instellen.

1. Maak een workflow aan en kies de trigger

Open Shopify Flow vanuit uw beheerdersomgeving (Apps > Shopify Flow) en klik op ‘Workflow aanmaken’. Shopify Flow opent een lege workflow met een invoerveld in het midden. Om een trigger voor deze app te selecteren, klikt u op ‘Selecteer een trigger’ daaronder.

Een nieuwe, lege Shopify Flow-workflow met een invoerveld en de knoppen ‘Selecteer een trigger’ en ‘Blader door sjablonen’
Een nieuwe workflow. Om een trigger voor deze app te selecteren, klikt u op ‘Selecteer een trigger’.

Open in het venster dat verschijnt de link Workflow Trigger Extensions. Daar vindt u een overzicht van alle triggers van de app, voorzien van een korte beschrijving. U kunt ook een naam invoeren in het zoekveld bovenaan. Kies ‘Productvariantprijs gewijzigd’.

Het Select-triggerpaneel van Shopify Flow, met de optie Workflow Trigger Extensions geactiveerd en de triggers weergegeven, elk voorzien van een beschrijving
Alle triggers van de app, elk voorzien van een beschrijving van één regel. Via het zoekveld kunt u de lijst filteren.

De trigger vormt nu de eerste stap in de workflow. In het bijbehorende paneel wordt weergegeven welke gegevens de trigger doorgeeft - dat zijn de gegevens die uw voorwaarden en acties kunnen gebruiken.

Het workflow-canvas met „Prijswijziging productvariant“ als eerste stap
De trigger vormt de eerste stap in de workflow.

2. Voeg een voorwaarde toe

Klik op de + onder de trigger en kies ‘Voorwaarde’. Klik op ‘Criteria toevoegen’: hierdoor wordt de variabelenkiezer geopend. Alles wat onder de naam van de trigger staat, is afkomstig uit deze app.

Bij een prijswijziging die priceChange is, met de oude en de nieuwe prijs, het verschil (delta), het percentage (percentChange) en de direction. Deze bestaan omdat een Shopify Flow-voorwaarde geen berekeningen kan uitvoeren en geldgegevens als tekst worden aangeleverd - de app voert dus de berekening uit en geeft u het resultaat als getal weer.

Het plusteken onder de trigger ging open en toonde de opties ‘Actie’ en ‘Voorwaarde’
Het plusteken onder een stap biedt de twee elementen waaruit een workflow bestaat: een voorwaarde en een actie.
De variabelenkiezer van Shopify Flow, waarin onder ‘priceChange’ de volgende gegevens worden weergegeven: ‘oldPrice’, ‘newPrice’, ‘delta’, ‘percentChange’ en ‘direction’
Wat de trigger van uw workflow oplevert: de prijs ervoor en erna, het verschil, het percentage en de richting.

Selecteer percentChange, kies ‘Minder dan’ en voer -10 in. De workflow wordt nu alleen voortgezet bij kortingen van meer dan 10 procent.

Een Shopify Flow-voorwaarde: priceChange.percentChange is kleiner dan -10
De uiteindelijke voorwaarde.

3. Een actie toevoegen

Klik onder ‘Dan’ op ‘+’ en kies ‘Actie’. Voor een melding is ‘Interne e-mail verzenden’ de eenvoudigste optie: hiervoor is geen andere app nodig. Voeg met ‘Variabele toevoegen’ variabelen toe aan de tekst, bijvoorbeeld:

{{productVariant.product.title}} / {{productVariant.title}}: {{priceChange.oldPrice.amount}} -> {{priceChange.newPrice.amount}} ({{priceChange.percentChange}} %)

Alles wat Shopify Flow kan, werkt hier ook: tags toevoegen, een metaveld bijwerken, een HTTP-verzoek naar Slack of uw ERP-systeem verzenden.

Optioneel: bewerk de gegevens met de optie ‘Code uitvoeren’

Wanneer de gewenste tekst meer omvat dan slechts enkele variabelen - afronding, een alternatieve waarde bij een lege waarde, een berekening - voegt u de stap ‘Code uitvoeren’ van Shopify Flow toe tussen de voorwaarde en de actie. Deze stap ontvangt de gegevens van de trigger als input en retourneert een object dat door latere stappen kan worden gebruikt.

De codestap „Run“ van Shopify Flow, waarbij oldPrice, newPrice en percentChange uit de trigger worden gelezen
De code ‘Run’ ontvangt de gegevens van de trigger als invoer en retourneert waarden voor de daaropvolgende stappen.

4. Schakel de workflow in

Geef de workflow een naam en klik op ‘Workflow inschakelen’. Shopify Flow geeft de app hiermee door dat een workflow met deze trigger actief is, en de app doet de rest:

  • het schakelt de trigger in, en
  • Bij een wijzigingstrigger wordt de huidige status van de betreffende records één keer uitgelezen (de basissynchronisatie), zodat er al bij de allereerste wijziging iets is om mee te vergelijken.

Bij een grote catalogus kan de synchronisatie van de basisgegevens enkele minuten in beslag nemen. Zolang dit proces nog niet is voltooid, wordt de eerste wijziging van een record mogelijk niet doorgevoerd.

De voltooide workflow: trigger, voorwaarde, ‘Code uitvoeren’, met ‘Workflow inschakelen’ rechtsboven
De voltooide workflow. De knop ‘Workflow inschakelen’ bevindt zich in de rechterbovenhoek.

5. Breng de wijziging aan en controleer de gebeurtenisgeschiedenis

Wijzig de prijs van een testvariant met meer dan 10 procent. Open vervolgens ‘Gebeurtenisgeschiedenis’ in de app: daar wordt elke gebeurtenis die de app naar Shopify Flow heeft verzonden weergegeven, samen met de bijbehorende status. Als de status ‘Succes’ wordt weergegeven, betekent dit dat Shopify Flow de gebeurtenis heeft geaccepteerd.

De pagina ‘Gebeurtenisgeschiedenis’ van de app, waarop geactiveerde triggers met hun status worden weergegeven
In de gebeurtenisgeschiedenis worden alle gebeurtenissen weergegeven die de app naar Shopify Flow heeft verzonden.

Klik op de gebeurtenis om precies te zien wat er is verzonden - dezelfde waarden die uw voorwaarde heeft waargenomen. Als de workflow niet heeft gewerkt zoals u had verwacht, is dit de eerste plaats waar u moet kijken: is de gebeurtenis aanwezig en bevat deze de waarden die u had verondersteld?

Er is een gebeurtenis toegevoegd aan de gebeurtenisgeschiedenis: een prijswijziging van 89,00 naar 69,00, met de waarden voor delta, percentChange en direction
Eén gebeurtenis, geopend: precies de waarden die uw voorwaarde heeft waargenomen.