Expressies

Expressies verbinden een template met het datacontract. Gebruik ze om waarden in tekst te plaatsen, datums en getallen te formatteren, blokken te tonen of te verbergen, inhoud te herhalen of een waarde te berekenen. Epistola gebruikt JSONata voor expressies.

Een veld invoegen

Gebruik een veld wanneer een deel van het document uit de zaak of een andere invoerbron moet komen.

Open een tekstblok en plaats de cursor waar de waarde moet verschijnen.
Typ {{ of gebruik de expressieknop om de expressiebouwer te openen.
Kies een veld uit de verwachte informatie van de template.
Sla de expressie op en preview met een voorbeeld.

Een begroeting kan bijvoorbeeld vaste tekst met een veld combineren:

Geachte {{customer.name}},

Het veld wordt als een expressiechip opgeslagen. De waarde verandert wanneer je een ander data-voorbeeld selecteert.

Waarden formatteren

Gebruik de locale-aware formatters wanneer de uitvoer de taal of regio van het document moet volgen.

Datums en tijden

Gebruik $formatDate(value, pattern) met een ISO-datum of -datetime:

$formatDate(invoiceDate, "dd-MM-yyyy")
$formatDate(createdAt, "EEEE d MMMM yyyy")
$formatDate(createdAt, "dd-MM-yyyy HH:mm")

Numerieke tokens zoals dd, MM en yyyy volgen het patroon exact. Maand- en dagnamen zoals MMMM en EEEE worden gelokaliseerd. De formatteerkeuze biedt gangbare datum- en datetimepatronen.

Getallen en percentages

Gebruik $formatLocaleNumber(value, picture) voor locale-aware getalnotatie:

$formatLocaleNumber(amount, "#,##0.00")
$formatLocaleNumber(rate, "0.0%")

Hetzelfde patroon geeft 1.234,56 in nl-NL en 1,234.56 in en-US. De effectieve locale komt uit de variant, tenant of applicatiestandaard.

Er is geen aparte valutaformatter. Zet het valutasymbool als vaste tekst rond het gelokaliseerde getal:

"€ " & $formatLocaleNumber(amount, "#,##0.00")

De ingebouwde $formatNumber() is niet locale-aware. Gebruik $formatLocaleNumber() voor documenten die een regionale getalnotatie moeten volgen. In de Builder-modus zijn algemene presets voor getallen en percentages beschikbaar; gebruik de Code-modus voor aangepaste patronen.

Inhoud conditioneel tonen

Gebruik een conditieblok wanneer inhoud alleen in bepaalde zaken moet verschijnen. De onderliggende blokken worden getoond wanneer de conditie true oplevert. Bijvoorbeeld:

decision = "refused"

Plaats een toelichtende paragraaf in het conditieblok en preview beide uitkomsten door een ander data-voorbeeld te selecteren.

Data herhalen

Gebruik een Lus om onderliggende blokken te herhalen voor elk item in een array. Verwijs in de herhaalde inhoud naar het huidige item via de itemvariabele, bijvoorbeeld:

item.name

Gebruik Data List wanneer het resultaat een lijst moet zijn. Je kunt opsommingstekens, nummers, letters, Romeinse cijfers of geen markering kiezen. Configureer één itemtemplate; Epistola herhaalt die voor elk array-item.

Preview met meerdere voorbeelden

Wissel tijdens het bewerken tussen de voorbeelden van de template en controleer:

Een gevuld veld en een leeg of optioneel veld.
Zowel de true- als false-uitkomst van een conditie.
Een korte en lange array voor lussen en Data Lists.
Datum-, getal- en percentage-uitvoer in de bedoelde locale.
Lange namen, adressen en paragrafen die pagina-einden kunnen veranderen.

De expressiebouwer toont een live preview voor het geselecteerde voorbeeld. Gebruik de Code-modus wanneer een aangepaste JSONata-expressie of formatteringspatroon niet als Builder-preset beschikbaar is.

Houd expressies onderhoudbaar

Gebruik directe veldpaden voor eenvoudige waarden en expressies voor presentatielogica. Houd zakelijke beslissingen in het zaak- of workflowsysteem en stuur de uitkomst naar Epistola. Als een regel moeilijk uit te leggen of te testen is voor een documenteigenaar, vereenvoudig hem dan of verplaats de beslissing upstream.