Naar de hoofdinhoud

Hoe werken templatecodes?

Uitleg over voordefinities, entiteiten en veldnamen, en hoe u de juiste templatecode achterhaalt via de tooltip.

Geschreven door Marieke van Sinderen

Een templatecode bestaat uit een voordefinitie, de entiteit waarvan u gegevens wilt gebruiken en de naam van het veld. Zo verwijst u vanuit een template naar gegevens uit uw BaseNet-omgeving.

⚠️ Let op: het zelf aanmaken of ontwikkelen van templates ondersteunen wij niet, vanwege de complexiteit hiervan.

📌 Wenst u dat wij de templates voor u ontwikkelen? Neem dan contact op met onze templates-afdeling via [email protected]. Houdt u rekening met onze templatespolicy.


Welke voordefinities zijn er?

Met voordefinities legt u de basis van het pad naar de gewenste velden van bijvoorbeeld een relatie en/of project. Er zijn twee voordefinities die u gebruikt bij het ontwikkelen of aanpassen van een template:

  • $data.email — te gebruiken bij e-mail- en memotemplates

  • $data.letter — te gebruiken bij brief- en faxtemplates


Welke entiteiten kunt u koppelen?

Een relatie, project of bijvoorbeeld een medewerker is binnen het systeem een zogenaamde entiteit. Achter de voordefinitie plaatst u de entiteit waarvan u de velden wilt gebruiken. Enkele voorbeelden:

Code

Wat het invult

relatie

Gegevens van de gekoppelde relatie (particulier, contactpersoon of bedrijf)

project

Gegevens van het gekoppelde project

project.relation

Gegevens van de relatie (particulier, contactpersoon of bedrijf) van het gekoppelde project

employee

Gegevens van de medewerker die het correspondentiestuk opstelt

Staat het pad naar de juiste entiteit, dan koppelt u het gewenste veld door de veldnaam (templatecode) achter dat pad te plaatsen.


Hoe ziet een volledige templatecode uit?

De code $data.email.relation.firstname omvat het volledige pad naar de voornaam van de aan de e-mail gekoppelde relatie.

Is het veld 'voornaam' bij de gekoppelde relatie ingevuld in uw systeem, dan verschijnt bij het opstellen van de e-mail op de plaats van deze code de waarde die in dat veld is ingevuld.


Hoe gebruikt u uw eigen bedrijfsgegevens?

Binnen uw systeem beheert u de gegevens van uw bedrijf via Beheer > Bedrijfsinstellingen > Beheer bedrijfsgegevens. Deze gegevens kunt u terug laten komen op uw correspondentiestukken.

De voordefinitie naar deze gegevens is $data.companyInfo.mijnBedrijf. In deze voordefinitie wordt geen onderscheid gemaakt tussen e-mail of brief; deze is altijd dezelfde. Daarachter plaatst u de templatecode van het gewenste veld.

📌 De templatecodes van de meest gebruikte velden vindt u in het overzicht Voorbeelden templatecodes op onze website.


Hoe achterhaalt u welke templatecode u nodig heeft?

Stap 1 – Schakel het weergeven van templatecodes in

Ga naar Instellingen > Persoonlijke instellingen > Persoonlijk > Templatecodes weergeven en zet de schakelaar aan.

📌 Templatecodes zijn standaard verborgen.


Stap 2 – Open de pagina met het gewenste veld

Open bijvoorbeeld de pagina van een contactpersoon en klik op Bewerken.


Stap 3 – Beweeg met uw muis over het veldlabel

Beweegt u met de cursor boven het label (bijvoorbeeld de tekst 'Voornaam'), dan verschijnt een tooltip met de templatecode. Voor Voornaam is dit firstname.


Stap 4 – Stel de volledige code samen

Zet de voordefinitie, de entiteit en de templatecode achter elkaar, bijvoorbeeld $data.email.relation.firstname.


💡 Tip: Weet u niet zeker of een code werkt? Test de template door een nieuwe e-mail aan te maken met een gekoppelde relatie en/of project. Zonder koppeling blijven de velden namelijk leeg.

Was dit een antwoord op uw vraag?