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.

Variabelen vinden

We hebben een 'variabelen browser' toegevoegd aan het beheerderspaneel van Neoforce. Deze kun je vanuit iedere beheerpagina openen zonder dat je de pagina verlaat! Zodra je klikt op een regel wordt de betreffende variabele naar jouw klembord overgenomen. Hierdoor kun je deze later gemakkelijk plakken op de gewenste plaats.

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}

Alle variabelen tonen

Naast de hierboven genoemde opties. is er binnen Neoforce ook één variable die je kunt gebruiken om een overzicht van alle beschikbare variabelen te tonen. Dit toont een JSON-array waarin je aan de linkerzijde de 'sleutel' ziet en aan de rechterzijde de huidige waarde.

Voorbeeld:

"SLEUTEL": "WAARDE"

Gebruik de onderstaande variabele om dit overzicht te tonen:

${app.variables.json}

Voorbeeld:

{
    "app.currentDate": "2024-08-25 08:24:26",
    "app.currentDate.datetime": "2024-08-25T08:24:26+02:00",
    "app.currentDate.datetime.f": "25-08-2024 08:24",
    "app.currentDate.datetime.long": "zondag 25 augustus 2024 08:24",
    "app.currentDate.date": "2024-08-25",
    "app.currentDate.date.f": "25-08-2024",
    "app.currentDate.date.long": "zondag 25 augustus 2024",
    "app.currentDate.yy": "24",
    "app.currentDate.yyyy": "2024",
    "app.currentDate.ww": "34",
    "app.currentDate.m": "8",
    "app.currentDate.mm": "08",
    "app.currentDate.d": "25",
    "app.currentDate.dd": "25",
    "app.currentDate.n": "7",
    "app.currentDate.hh": "08",
    "app.currentDate.ii": "24",
    "app.currentDate.ss": "26",
    "app.currentDate.timestamp": 1724567066,

        ....
}

(Voorbeeld ingekort)