Ga naar hoofdinhoud

Sjablonen — de basis

Je hoeft geen ontwikkelaar te zijn om sjablonen te begrijpen. Als je ooit een mailmerge hebt gebruikt om dezelfde brief naar honderd mensen te sturen — elk met een persoonlijke begroeting — dan ken je het idee al.

Een sjabloon is een stuk tekst dat je eenmalig schrijft, met een aantal lege plekken erin. SHIPM8 vult die plekken automatisch in, op basis van de gegevens van elk schip, elke klant of elk havenbezoek.

Placeholders​

De lege plekken heten placeholders, en je schrijft ze met dubbele accolades: {{ }}. Wanneer het sjabloon wordt uitgevoerd, wordt elke placeholder vervangen door een echte waarde.

Hier is een voorbeeld van een havenbezoekmelding:

Dear {{customer.name}},

Your vessel {{vessel.name}} is expected at {{port.name}} on {{eta}}.

Gecombineerd met de gegevens van één havenbezoek wordt dit:

Dear Blue Tide Shipping,

Your vessel Ocean Star is expected at Amsterdam on 22-07-2025.

Hetzelfde sjabloon, andere gegevens, elke keer een andere boodschap. Dat is het idee — alles wat volgt bouwt hierop voort.

Waar SHIPM8 sjablonen gebruikt​

Sjablonen sturen de tekst die SHIPM8 voor je genereert, waaronder:

  • Meldingen — de e-mails en berichten die worden verstuurd bij gebeurtenissen zoals een bijgewerkte ETA.
  • Facturen — de opmaak en tekst van factuurdocumenten.
  • Exports — Word-, PDF-, Excel- en andere documenten die op basis van je gegevens worden aangemaakt.

Overal waar je een van deze kunt bewerken, bewerk je een sjabloon.

Meer dan alleen placeholders​

In de meeste gevallen zijn placeholders genoeg. Maar soms is een ruwe waarde niet direct presentabel — een datum opgeslagen als 2025-07-22T00:00:00, of een bedrag dat als € 1.250,00 moet worden weergegeven. Voor zulke gevallen biedt de engine helpers die waarden opmaken en omzetten, bijvoorbeeld:

{{dateFormat eta 'dd-MM-yyyy'}}      →  22-07-2025
{{currencyFormat amount 'EUR'}}      →  EUR 1.250,00

Er zijn helpers voor datums, valuta, tekst, lijsten, eenvoudige "als dit, dan dat"-logica en meer. Je hebt ze niet nodig om te beginnen — als je er wel behoefte aan hebt, vormt de rest van dit onderdeel een volledige naslagwerktekst, gegroepeerd naar wat je wilt doen.

Zelf uitproberen: de Playground​

De beste manier om te leren is experimenteren, en SHIPM8 heeft daar een veilige omgeving voor. In het onderdeel Data export vind je de Template Playground.

Daar kun je aan de ene kant een sjabloon plakken en aan de andere kant wat voorbeeldgegevens (in JSON), op Toepassen klikken en direct het resultaat zien — zonder een echte melding of factuur aan te passen. Het is de eenvoudigste manier om een voorbeeld uit deze pagina's uit te proberen en te zien wat het doet.

tip

Als je het onderdeel Data export niet ziet, heeft je account er mogelijk geen toegang toe. Vraag je beheerder als je de Playground wilt gebruiken.

Verder lezen​

  • Sjablonen schrijven — placeholders, lussen en hoe je geneste gegevens bereikt.
  • Gegevens selecteren met JSONPath — hoe je precies het veld aanwijst dat je wilt, inclusief namen met spaties.
  • De overige pagina's zijn een naslagwerk voor de opmaak-, lijst-, logica- en berekeningshelpers — raadpleeg ze wanneer je ze nodig hebt.