Wat zijn variabelen?

Het is mogelijk om data, van bijvoorbeeld een ticket of een asset, te gebruiken in een actie.
Denk hierbij aan een automatische bevestigingsmail van een nieuw ticket; in die mail wil je natuurlijk ook het ticketnummer en bijvoorbeeld het verzoek gebruiken.

Hier komen de variabelen bij kijken. Hieronder lees je er meer over!

Gebruik maken van variabelen

Binnen Neoforce zijn werken variabelen als volgt:

• We beginnen met ${ om aan te geven dat het een variabele betreft.
• Daarna volgt de 'sleutel' van de betreffende variabele. Voorbeeld: ticket.ticketnr of ticket.title.
• We eindigen met }.

Een volledige variabele die het ticketnummer toont is dan ook: ${ticket.ticketnr}.

Dit betekent dat je variabelen 'mixt' met de rest van je actie. Bij een mail is het onderstaande dus mogelijk om een gepersonliseerde aanhef te tonen:

Beste ${ticket.caller.firstName}

Dit zal de voornaam van de aanmelder tonen.

Verschillende soorten variabelen

We hebben twee verschillende soorten variabelen binnen Neoforce.

• Strings
• Arrays

Strings

In de meeste gevallen zul je te maken hebben met het eerste type, de strings. Dit zijn variabelen die ook eenvoudig te gebruiken zijn en altijd slechts één waarde hebben.

Strings gebruik je altijd op de manier zoals ook hierboven beschreven, dus:

${tickets.request}

Arrays

Deze kom je in mindere zin tegen, maar we behandelen ze uiteraard toch.
Met een array kan een variabele meerdere waarden bevatten. Denk hierbij aan de module reserveringen en dan specifiek de producten van die reservering / verhuurovereenkomst. Dit kunnen er immers meer dan 1 zijn.

Arrays dien je altijd te 'loopen'. Dit doe je met behulp van een {loop in="[variabele]" out="[output]"} [content] {/loop}.

Hieronder een voorbeeld m.b.t. het loopen van een array. In dit voorbeeld tonen we de primaire sleutel, en de inhoud van het veld Merk van ieder product in een reservering / verhuurovereenkomst:

{loop in="reservation.products" out="p"}
ObjectID: ${p.productRef}
Merk: ${p.product.merk}
{/loop}

Welke variabelen kun je gebruiken?

Vrijwel alle velden zijn bruikbaar als variabelen. Je kunt, middels een andere variabele alle beschikbare variabelen tonen. We raden je dan ook aan om 1 actie te maken voor het tonen van variabelen.

➡️ Standaard wordt Neoforce geleverd met de actie '!! Toon alle beschikbare variabelen'
Deze toont, in en e-mail naar jezelf, alle variabelen zoals hier beschreven.

Om alle beschikbare variabelen te tonen, gebruik je het volgende:

${app.variables.json}

Dit toont ongeveer een lijst zoals je in de screenshot hieronder ziet. Aan de linkerzijde zie je de 'sleutel' en aan de rechterzijde de waarde op dat moment.