#Variabele

This feature is provided by the commercial plugin «Workflow: Aangepaste variabele», please purchase to use

#Introductie

U kunt variabelen declareren in een workflow of waarden toewijzen aan reeds gedeclareerde variabelen. Dit wordt meestal gebruikt om tijdelijke gegevens binnen de workflow op te slaan.

#Knooppunt aanmaken

In de workflow configuratie-interface klikt u op de plusknop ("+") in de workflow om een "Variabele" knooppunt toe te voegen:

#Knooppunt configureren

#Modus

Het variabele knooppunt is vergelijkbaar met variabelen in programmeertalen; u moet het eerst declareren voordat u het kunt gebruiken en er een waarde aan kunt toewijzen. Daarom moet u bij het aanmaken van een variabele knooppunt de modus van de variabele kiezen. Er zijn twee modi beschikbaar:

• Nieuwe variabele declareren: Hiermee maakt u een nieuwe variabele aan.
• Waarde toewijzen aan bestaande variabele: Hiermee wijst u een waarde toe aan een variabele die eerder in de workflow is gedeclareerd, wat gelijk staat aan het wijzigen van de waarde van de variabele.

Wanneer het knooppunt dat u aanmaakt het eerste variabele knooppunt in de workflow is, kunt u alleen de declaratiemodus kiezen, omdat er op dat moment nog geen variabelen beschikbaar zijn om een waarde aan toe te wijzen.

Wanneer u ervoor kiest om een waarde toe te wijzen aan een gedeclareerde variabele, moet u ook de doelvariabele selecteren, oftewel het knooppunt waar de variabele is gedeclareerd:

#Waarde

De waarde van een variabele kan van elk type zijn. Het kan een constante zijn, zoals een string, getal, booleaanse waarde of datum, of het kan een andere variabele uit de workflow zijn.

In de declaratiemodus staat het instellen van de variabelewaarde gelijk aan het toewijzen van een initiële waarde aan de variabele.

In de toewijzingsmodus staat het instellen van de variabelewaarde gelijk aan het wijzigen van de waarde van de gedeclareerde doelvariabele naar een nieuwe waarde. Bij later gebruik zal deze nieuwe waarde worden opgehaald.

#De waarde van de variabele gebruiken

In de knooppunten die volgen op het variabele knooppunt, kunt u de waarde van de variabele gebruiken door de gedeclareerde variabele te selecteren uit de groep "Knooppuntvariabelen". Bijvoorbeeld, in een query knooppunt, gebruikt u de waarde van de variabele als een queryconditie:

#Voorbeeld

Een nuttiger scenario voor het variabele knooppunt is in vertakkingen, waar nieuwe waarden worden berekend of samengevoegd met eerdere waarden (vergelijkbaar met reduce/concat in programmeren), en vervolgens worden gebruikt nadat de vertakking is voltooid. Hieronder volgt een voorbeeld van het gebruik van een lusvertakking en een variabele knooppunt om een ontvanger-string samen te stellen.

Maak eerst een collectie-getriggerde workflow aan die triggert wanneer "Artikel" gegevens worden bijgewerkt, en laad de gerelateerde "Auteur" relatiegegevens voor (om ontvangers te verkrijgen):

Maak vervolgens een variabele knooppunt aan om de ontvanger-string op te slaan:

Maak daarna een lusvertakkingsknooppunt aan om door de auteurs van het artikel te itereren en hun ontvangerinformatie samen te voegen in de ontvanger-variabele:

Binnen de lusvertakking maakt u eerst een rekenknooppunt aan om de huidige auteur samen te voegen met de reeds opgeslagen auteur-string:

Na het rekenknooppunt maakt u nog een variabele knooppunt aan. Selecteer de toewijzingsmodus, kies het ontvanger-variabele knooppunt als toewijzingsdoel, en selecteer het resultaat van het rekenknooppunt als waarde:

Op deze manier, nadat de lusvertakking is voltooid, bevat de ontvanger-variabele de ontvanger-string van alle auteurs van het artikel. Vervolgens kunt u na de lus een HTTP-verzoek knooppunt gebruiken om een e-mailverzend-API aan te roepen, waarbij u de waarde van de ontvanger-variabele als ontvangerparameter aan de API doorgeeft:

Hiermee is een eenvoudige bulk-e-mailfunctie geïmplementeerd met behulp van een lus en een variabele knooppunt.