Wat zijn variabelen?

Variabelen stellen je in staat om dynamische data uit Neoforce te gebruiken in acties, zoals e-mails, notificaties of workflows.

Ze fungeren als placeholders die bij uitvoering worden vervangen door de daadwerkelijke waarden uit het systeem.

Voorbeeld: in een automatische bevestigingsmail wil je het ticketnummer en de titel van het verzoek tonen. Variabelen maken dit mogelijk zonder handmatige invoer.

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

Hoe worden variabelen gevuld?

Variabelen in Neoforce worden op twee manieren gevuld met data:

1. Automatisch door de applicatie

Neoforce vult variabelen dynamisch met data uit het systeem. Voorbeelden:

Gegevens uit een ticket (bijv.${ticket.ticketnr}, ${ticket.title})
Informatie over een organisatie (bijv. ${organisation.name}, ${organisation.address})
Contextuele data zoals de huidige datum (bijv. ${app.currentDate}, ${app.currentUser.displayName})

2. Handmatig door de beheerder

Je kunt zelf variabelen definiëren en vullen via Beheer > Triggers & Acties > Variabelen. Deze variabelen zijn bruikbaar in alle acties en workflows, zoals:

Aangepaste waarden voor specifieke processen
Tijdelijke opslag van berekende of externe data
Variabelen die je wilt hergebruiken in meerdere acties

Deze flexibiliteit zorgt ervoor dat je zowel standaard als maatwerk data kunt inzetten waar nodig.

⚠️ Let op:
Zelf toegevoegde variabelen zijn in principe altijd beschikbaar en kunnen dus mogelijk ongewenste 'data lekken'. Denk dan aan bijvoorbeeld API-tokens of andere datasoorten.
Dit geldt vooral bij het gebruik van ${app.variables.json}

Gebruik maken van variabelen

Variabelen in Neoforce volgen een vaste syntax:

Begin met ${
Voeg de sleutel toe (bijv. ticket.ticketnr of ticket.title)
Sluit af 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.

Voorbeelden

Zie bijvoorbeeld ook onderstaande screenshot van een actie (met als ouput een notificatie)

Daarnaast kun je variabelen ook gebruiken als voorwaarden in triggers zoals hieronder.

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)

W0122 Hoe gebruik je data (variabelen) in acti...

Hoe gebruik je data (variabelen) in acties?