De workflow-editor in Shopify Flow gebruiken

De workflow-editor is een tool waarmee je de functionaliteit van je workflows in Shopify Flow kunt aanpassen en bewerken. De workflow-editor heeft een interface voor slepen en neerzetten waarmee je je workflows kunt organiseren en ontwerpen door verschillende soorten stappen toe te voegen in een verticale indeling, van boven naar beneden.

De eerste stap die je met de workflow-editor aan een workflow kunt toevoegen, is altijd een triggerstap. Nadat je de workflowtrigger hebt toegevoegd, kun je de +-pictogrammen gebruiken om de stappen voor de voorwaarde of actie toe te voegen die hierna plaatsvinden in de workflowreeks. Er staan pijlen tussen de verschillende stappen in de workflow-editor die aangeven welke stappen direct naar andere stappen leiden op basis van de voorwaarden of de acties die zijn ondernomen.

Alle stappen moeten met minimaal één andere stap in de workflow zijn verbonden om te kunnen functioneren. Je kunt op elke willekeurige plek in de editor stappen buiten de workflow toevoegen, maar deze stappen maken pas deel uit van de workflow als ze door middel van een pijl met een andere stap zijn verbonden. Elke stap kan slechts één voorgaande stap hebben. Het wordt daarom niet ondersteund om meerdere vertakkingen van de workflow weer samen te voegen tot het pad van één stap.

Je kunt de gegevens van voorwaarde- en actiestappen configureren met behulp van het configuratiepaneel aan de linkerkant van de workflow-editor. Het configuratiepaneel wordt alleen weergegeven als er een stap is geselecteerd.

Tip

Je kunt een notitie aan je workflow toevoegen in de workflow-editor. In notities kun je in je eigen woorden informatie over je workflow vastleggen.

Een workflow openen in de workflow-editor

In Shopify Flow krijg je toegang tot de workflow-editor door een nieuwe workflow aan te maken of door op een bestaande workflow en vervolgens op Bewerken te klikken.

Stappen:

1. Ga in het Shopify-beheercentrum naar Apps > Flow.

2. Voer in de sectie Workflows een van de volgende acties uit:

   • Klik op Workflow aanmaken om de workflow-editor voor een nieuwe, lege workflow te openen.
   • Klik op de workflow en vervolgens op Bewerken om de workflow-editor voor een bestaande workflow te openen.

Een stap aan een workflow toevoegen

In de workflow-editor kun je op de volgende manieren een stap aan de workflow toevoegen:

• Beweeg de muis over een bestaande stap en klik op het + -pictogram om een voorwaarde- of actiestap te selecteren en toe te voegen als de volgende verbinding in de workflow.
  • Voorwaardestappen hebben twee +-pictogrammen: één voor het pad Waar als aan de voorwaarde wordt voldaan en één voor het pad Niet waar als niet aan de voorwaarde wordt voldaan.
  • De actiestap Voor elke-lus (herhalen) heeft ook twee +-pictogrammen: één voor Voor elk item herhalen, waarmee je stappen kunt definiëren die voor elk artikel in de lijst worden uitgevoerd, en één voor Na het laatste item, waarmee je stappen kunt definiëren die worden uitgevoerd nadat het laatste artikel in de lijst is geretourneerd.
• Klik op een willekeurige lege plek in de workflow-editor. Als er nog geen trigger in de workflow is, worden in het configuratiepaneel opties voor de triggerstap weergegeven. Als er al een trigger in de workflow is, worden in het configuratiepaneel opties voor de actiestap weergegeven.

Stappen in een workflow kopiëren en plakken

Bij het bouwen van workflows moet je vaak stappen opnieuw maken die je ergens anders al hebt ingesteld. In de workflow-editor kun je een of meer bestaande actie- of voorwaardestappen kopiëren en in dezelfde of een andere workflow plakken. Zo hoef je de stappen niet helemaal opnieuw op te bouwen. De geplakte stappen behouden de waarden van de configuratievelden van de gekopieerde stappen en, bij voorwaardestappen, ook de logica. Ze zijn dus met slechts kleine aanpassingen klaar voor gebruik.

Als je meerdere stappen tegelijk kopieert, blijven de verbindingen tussen de gekopieerde stappen behouden. Een voorwaarde en de stappen in de bijbehorende paden Waar en Onwaar worden dus als één verbonden groep geplakt. Verbindingen met stappen die je niet hebt gekopieerd, blijven niet behouden. Je moet de geplakte groep dus nog met de rest van de workflow verbinden. Als een gekopieerde stap gegevens gebruikt die door een andere gekopieerde stap worden geretourneerd, zoals een actie Gegevens ophalen, gebruikt de geplakte stap de gegevens die door de geplakte kopie van die actie worden geretourneerd.

Triggerstappen kunnen niet worden gekopieerd. Stappen met een aangepaste configuratiepagina, zoals Marketing-e-mail verzenden, kunnen ook niet worden gekopieerd. Als je selectie een stap bevat die niet kan worden gekopieerd, wordt geen van de geselecteerde stappen gekopieerd.

Stappen:

1. Open een workflow in de workflow-editor.
2. Selecteer de stappen die je wilt kopiëren:
   • Om één stap te kopiëren, klik je op de actie- of voorwaardestap.
   • Om meerdere stappen te kopiëren, houd je Shift op je toetsenbord ingedrukt en klik je op elke stap die je wilt kopiëren, of sleep je een selectiekader rond de stappen terwijl je Shift ingedrukt houdt.
3. Kopieer de stappen met ctrl + C op een pc of command + C op een Mac.
4. Optioneel: als je de stappen in een andere workflow wilt plakken, open je die workflow in de workflow-editor. Die workflow moet al een triggerstap bevatten.
5. Plak de stappen met ctrl + V op een pc of command + V op een Mac. Een losse stap wordt in de buurt van je cursor toegevoegd. Een groep stappen wordt op de dichtstbijzijnde lege plek bij je cursor toegevoegd, met dezelfde indeling als de gekopieerde stappen. De geplakte groep wordt geselecteerd, zodat je deze kunt verplaatsen. Als je cursor zich niet boven de editor bevindt, worden de stappen in het midden van de editor toegevoegd.
6. Verbind de geplakte stappen met de rest van de workflow voordat je de workflow activeert.

Stappen in een workflow verbinden

Alle stappen moeten met minimaal één andere stap in de workflow zijn verbonden om te kunnen functioneren. De workflow-editor geeft met behulp van richtingspijlen aan welke stappen met elkaar verbonden zijn. Workflows lopen in de workflow-editor standaard verticaal van boven naar beneden.

Wanneer je een stap aan de workflow toevoegt vanuit een andere stap met het +-pictogram, wordt de nieuwe stap automatisch verbonden met de voorgaande stap. Je kunt ook handmatig een verbinding tussen stappen maken door + op de eerste stap ingedrukt te houden en het uiteinde van de pijl naar de tweede stap te slepen. Elke stap kan maar één voorgaande stapverbinding hebben, dus het samenvoegen van meerdere vertakkingen van de workflow in één pad wordt niet ondersteund.

Je kunt een verbinding tussen stappen verwijderen door de muis te bewegen over de pijl die je wilt verwijderen en vervolgens op het pictogram te klikken.

Stappen ordenen in de workflow-editor

Je kunt stappen in de workflow-editor slepen en neerzetten om de opmaak van je workflow handmatig te organiseren. Hierdoor kun je je workflow gemakkelijker volgen terwijl je deze opbouwt. Stappen worden standaard van boven naar beneden met elkaar verbonden, maar je kunt stappen overal in de workflow-editor slepen en neerzetten zonder de pijlverbindingen tussen de stappen te verbreken.

Je kunt meerdere stappen tegelijk verplaatsen door Shift op je toetsenbord ingedrukt te houden en vervolgens te klikken op de stappen die je als groep wilt selecteren. Klik en sleep een willekeurige stap in het grijze groepsvak om de inbegrepen stappen in bulk te verplaatsen.

Je kunt de opmaak van je workflow automatisch opnieuw instellen met de standaardafstand tussen stappen, zodat je workflow makkelijker te controleren is. Klik op het pictogram en klik vervolgens op Workflow rangschikken om de reset te bevestigen.

Een stap uit een workflow verwijderen

In de workflow-editor kun je een stap uit de workflow verwijderen door de muis te bewegen over de stap die je wilt verwijderen en vervolgens op het pictogram naast de stap te klikken. Het verwijderen van een stap kan niet ongedaan worden gemaakt.

Je kunt meerdere stappen tegelijk verwijderen door Shift op je toetsenbord ingedrukt te houden en vervolgens te klikken op de stappen die je als groep wilt selecteren. Klik op het -pictogram boven het grijze groepsvak om de stappen in bulk te verwijderen.

Als je een stap verwijdert die aan andere stappen is verbonden, blijven die stappen in de workflow-editor staan, maar worden ze losgekoppeld van eventuele voorgaande stappen. Je moet de losgekoppelde stappen handmatig opnieuw verbinden om deze in de workflow te kunnen blijven gebruiken.

De weergavewerkbalk van de workflow-editor gebruiken

Onderaan de workflow-editor kun je op een van de volgende pictogrammen in de weergavewerkbalk klikken:

• Gebruik of om uit of in te zoomen op de workflow.
• Gebruik om je workflow in het zichtbare gedeelte van de workflow-editor te centreren, op een zoomniveau waarbij de hele workflow wordt weergegeven.
• Gebruik om de Shopify Flow-Helpcentrum-documentatie in een nieuw browsertabblad te openen.
• Gebruik om de indeling van je workflow te rangschikken.

Het stapconfiguratiepaneel in de workflow-editor gebruiken

Wanneer je een stap selecteert, wordt het configuratiepaneel aan de linkerkant van de workflow-editor weergegeven. Het configuratiepaneel bevat de stapgegevens en is de plek waar je de functionaliteit van specifieke stappen kunt aanpassen, zoals variabelen instellen, logische operators toewijzen of aangepaste actie-informatie toevoegen, afhankelijk van wat je wilt dat de stap doet.

De opties die in het configuratiepaneel worden weergegeven, zijn rechtstreeks gerelateerd aan het type stap dat je selecteert.

De beschrijving van een stap toevoegen of bewerken

Je kunt de beschrijving van elke voorwaarde- of actiestap bewerken in het configuratiepaneel. Klik op Beschrijving toevoegen of Beschrijving bewerken en voer een beschrijving van de stap in je eigen woorden in. Dit kan jou en je medewerkers helpen te interpreteren wat de workflow doet op basis van je eigen beschrijving. Je kunt alle tekst in het beschrijvingsveld verwijderen om de beschrijving van de stap opnieuw in te stellen.

Een stap controleren op ontbrekende configuratiecontent

Als een stap ontbrekende gegevens of configuratiegegevens heeft die van invloed zijn op de functionaliteit, wordt er bovenaan de stap een Controleren-banner weergegeven. Klik op de stap om het configuratiepaneel te openen en de ontbrekende gegevens toe te voegen om de Controleren-banner te verwijderen. Tenzij een veld als optioneel is aangegeven, moet het worden ingevuld voordat de stap als volledig geconfigureerd kan worden beschouwd.

Stappen geven ook een Controleren-banner weer wanneer ze niet zijn verbonden met andere stappen. Je moet de stap verbinden met een andere stap in de workflow voordat je door kunt gaan met het configureren van de stapgegevens.

Als een Controleren-banner niet is opgelost voordat je de workflow probeert te activeren, wordt de stap als een fout weergegeven en wordt de workflow niet geactiveerd. Je moet alle configuratiefouten in een workflow oplossen voordat de workflow kan worden geactiveerd.

Het dialoogvenster 'Een variabele toevoegen' gebruiken

In het stapconfiguratiepaneel hebben sommige velden de optie Een variabele toevoegen om een variabele toe te voegen aan de configuratiecontent. Welke datasets in het dialoogvenster Een variabele toevoegen worden weergegeven, is afhankelijk van de gegevens die worden geretourneerd door een voorgaande stap in de workflow. Standaard wordt het dialoogvenster Een variabele toevoegen bijvoorbeeld met de volgende opties weergegeven:

• Een zoekbalk om naar variabelen te zoeken op naam of beschrijving.
• De standaard variabele datasets die door de trigger van de workflow worden geretourneerd, die doorgaans de volgende opties bevatten:
  • shop-variabelen, die globaal zijn voor je winkel.
  • Minstens 1 ander type, op basis van de workflowtrigger.

Als je echter stappen aan de workflow toevoegt die aanvullende gegevens retourneren, zoals Gegevens ophalen-acties of Code uitvoeren, worden er extra variabele datasets in het dialoogvenster weergegeven die je kunt selecteren voor elke stap die later in de workflowtak komt, omdat de extra gegevens op dat punt in de workflow beschikbaar zijn. De meest recent geretourneerde gegevens worden als eerste weergegeven.

Je kunt naar specifieke variabelen navigeren door op de verschillende variabele-opties te klikken. Sommige variabelen hebben geneste opties en een > om aan te geven dat er subopties zijn in dat variabele-API-pad. Wanneer je het einde van een variabele-API-pad hebt bereikt, heeft de variabele geen >-optie en wordt een variabele-contenttypebadge weergegeven, zoals String, Boolean, DateTime of Int, om aan te geven wat voor soort informatie door de variabele wordt geretourneerd.

Tip

Om meer te weten te komen over een bepaald element van een variabele, beweeg je de muis over de variabele en klik je op het pictogram om het relevante artikel in de Shopify-documentatie voor ontwikkelaars te openen.