Korte samenvatting:
Met syntax bepaal je hoe een aanhef of relatienaam er precies uitziet. Je combineert vaste tekst met veldcodes, filters en voorwaarden. Verderop in dit artikel vind je kant-en-klare voorbeelden die je direct kunt gebruiken.
Wil je dat een aanhef of relatienaam automatisch de juiste vorm aanneemt, bijvoorbeeld met of zonder titel, of met of zonder tussenvoegsel? Dat regel je met syntax. Dit artikel legt de bouwstenen uit: velden, filters en voorwaarden. Gebruik je liever meteen een kant-en-klaar voorbeeld? Ga dan direct naar 'Kant-en-klare voorbeelden' onderaan.
Op verschillende plekken in het Procurios Platform kun je een syntax gebruiken om in te stellen hoe relatiegegevens getoond worden in resultaten. De bekendste vorm hiervan is de aanhef. Weet je nog niet hoe je een aanhef aanmaakt en waar je deze syntax invult? Lees dan eerst het artikel 'Aanhef instellen voor persoonlijke communicatie'.
Velden
Je bouwt syntax op met velden uit het CRM. Bij velden waar je syntax kunt gebruiken, staat een knop waarmee je de lijst met beschikbare veldcodes opvraagt.
Je krijgt dan een lijst met velden te zien, met de kolommen 'Code', 'Titel' en 'Is vrij veld'. Bovenaan kun je zoeken op titel of code. Systeemvelden herken je aan een letter in de code, bijvoorbeeld %F voor voornaam of %n voor naam. Vrije velden herken je aan een cijfer, bijvoorbeeld %446 voor geslacht. Bij vrije velden staat 'Ja' in de kolom 'Is vrij veld'.
Filters gebruiken om het resultaat aan te passen
Wil je de output van een veld aanpassen, bijvoorbeeld alles in hoofdletters zetten? Gebruik dan een filter, ook wel modifier genoemd. Je voegt een verticale streep | toe achter de veldcode, gevolgd door het filter.
Je kunt kiezen uit deze filters:
upper: alles in hoofdlettersupper-first: eerste letter een hoofdletter, de rest in kleine letterslower: alles in kleine letterscamel: elk woord begint met een hoofdletter
Voorbeeld
| Syntax | Resultaat |
|---|---|
%F|upper | GERT JAN |
%F|upper-first | Gert jan |
%F|lower | gert jan |
%F|camel | Gert Jan |
Voorwaardelijk resultaat
Soms moet de tekst veranderen, afhankelijk van of een veld wel of niet is ingevuld. Dat noemen we een voorwaardelijk resultaat. Je gebruikt hiervoor vierkante haken [ ]. Tussen de haken zet je eerst de voorwaarde, dan een dubbele punt :, en daarna de tekst die moet verschijnen als aan de voorwaarde is voldaan.
Er zijn twee soorten voorwaarden:
- Bevat een veld een waarde? Gebruik de veldcode zelf. Bijvoorbeeld:
%F - Is een veld leeg? Zet een uitroepteken ! na het procentteken. Bijvoorbeeld:
%!F
Je kunt voorwaarden ook combineren (nesten). Zie voorbeeld 2 hieronder.
Voorbeeld 1
De relatie heet John Doe. Je wilt dit resultaat:
- Initialen (
%f) zijn ingevuld:%f %n(J. Doe) - Initialen (
%f) zijn leeg:%F %n(John Doe)
Dit bereik je met de syntax: [%f:%f ][%!f:%F ]%n
Dit levert het volgende op:
- Initialen en achternaam gevuld: 'J. Doe'
- Alleen voornaam en achternaam gevuld: 'John Doe'
- Alleen achternaam gevuld: ' Doe' (let op de spatie vooraan)
Voorbeeld 2
In voorbeeld 1 gaan we ervan uit dat de voornaam altijd is ingevuld. Dat is niet altijd zo. Daardoor ontstaat in het laatste resultaat een overbodige spatie.
Met deze syntax voorkom je dat: [%!f:[%F:%F ]][%f:%f ]%n
Het verschil met voorbeeld 1 zit in de voorwaarde. In voorbeeld 1 hangt de spatie af van of %f (initialen) leeg is. Hier zit binnen die voorwaarde nog een tweede, geneste voorwaarde: [%F:%F ]. Die toont %F (met spatie) alleen als %F zelf ook echt gevuld is. Is %F leeg, dan verschijnt dat hele stukje, spatie inbegrepen, helemaal niet.
- Initialen en achternaam gevuld: 'J. Doe'
- Alleen voornaam en achternaam gevuld: 'John Doe'
- Alleen achternaam gevuld: 'Doe'
Kant-en-klare voorbeelden (veelgebruikte constructies)
Herkenbare toepassingen die je direct kunt overnemen of aanpassen.
De voorbeelden voor Nederland (NL) gebruiken een apart veld voor het tussenvoegsel (%i), zoals 'van den' in 'Peter van den Bempt'. In België is het gebruikelijker om geen apart tussenvoegsel-veld te gebruiken. Het tussenvoegsel maakt daar al deel uit van het veld Naam (%n). Daarom zie je in de BE-voorbeelden geen %i. Wil jouw organisatie hier toch gebruik van maken? Gebruik dan de syntax uit het NL-voorbeeld.
Adressering van een brief (NL)
Dhr. [%i:[%f:%f %i %n][%!f:%i|upper-first %n]][%!i:[%f:%f %n][%!f:%n]]
- Alleen initialen: 'Dhr. J. Bempt'
- Initialen en tussenvoegsel: 'Dhr. J. van den Bempt'
- Alleen tussenvoegsel: 'Dhr. Van den Bempt'
- Geen van beide: 'Dhr. Bempt'
Formele aanhef met titel (NL)
Heb je een veld met de titel van een persoon, bijvoorbeeld 'Dr.'? In dit voorbeeld is %788 het veld met die titel.
Geachte [%788:%788 ][%!788:heer ][%i:%i|upper-first %n][%!i:%n]
- Met titel: 'Geachte Dr. Bempt'
- Met titel en tussenvoegsel: 'Geachte Dr. Van den Bempt'
- Zonder titel, met tussenvoegsel: 'Geachte heer Van den Bempt'
Formele aanhef per geslacht, met titel (NL)
Heb je bij het aanmaken van de aanhef een geslacht-veld gekozen? Dan vul je voor elke optie van dat veld een eigen syntax in, zoals beschreven in 'Aanhef instellen voor persoonlijke communicatie'. Welke velden je precies ziet, hangt af van de opties die op het gekozen geslacht-veld zijn ingesteld. Bij de meeste organisaties zijn dat 'Man', 'Vrouw' en 'Niet gespecificeerd'. Daarnaast is er altijd een apart veld 'Niet ingevuld', voor relaties waarbij het geslacht-veld helemaal leeg is. In dit voorbeeld is %788 opnieuw het veld met de titel van de persoon.
- Man:
[%788:%788 ][%!788:heer ][%i:%i|upper-first %n][%!i:%n] - Vrouw:
[%788:%788 ][%!788:mevrouw ][%i:%i|upper-first %n][%!i:%n] - Niet gespecificeerd:
[%788:%788 ][%!788:[%f:%f ]][%i:%i|upper-first %n][%!i:%n] - Niet ingevuld:
[%788:%788 ][%!788:heer, mevrouw ][%i:%i|upper-first %n][%!i:%n]
Bij 'Niet gespecificeerd' vervang je het aanspreekwoord door de voorletters van de relatie (%f), in plaats van 'heer' of 'mevrouw' te gebruiken. Dat past bij relaties die liever niet bij hun geslacht willen worden aangesproken. Bij 'Niet ingevuld' houden we bewust de combinatie 'heer, mevrouw' aan: hier is er geen bewuste keuze voor 'niet gespecificeerd' gemaakt, maar ontbreekt de gegevens simpelweg. Zo blijft het verschil tussen beide situaties zichtbaar in het resultaat.
Zonder titel, met tussenvoegsel en voorletter 'P.':
- Man: 'heer Van den Bempt'
- Vrouw: 'mevrouw Van den Bempt'
- Niet gespecificeerd: 'P. Van den Bempt'
- Niet ingevuld: 'heer, mevrouw Van den Bempt'
Met titel (bijvoorbeeld 'Dr.'):
- Alle vier de velden geven hetzelfde resultaat: 'Dr. Van den Bempt'. Is er een titel bekend, dan wint deze het van het aanspreekwoord of de voorletters.
Adressering van een brief (BE)
Dhr. [%F:F% ]%n
- Met voornaam en naam: 'Dhr. Johan van den Bempt'
- Zonder voornaam: 'Dhr. van den Bempt'
Formele aanhef (BE)
Geachte heer %n
- 'Geachte heer van den Bempt'
Formele aanhef per geslacht, met titel BE)
Dezelfde aanpak als bij het NL-voorbeeld, maar zonder %i: het tussenvoegsel zit in België immers al in %n. Ook hier is %788 het veld met de titel van de persoon.
- Man:
[%788:%788 ][%!788:heer ]%n - Vrouw:
[%788:%788 ][%!788:mevrouw ]%n - Niet gespecificeerd:
[%788:%788 ][%!788:[%f:%f ]]%n - Niet ingevuld:
[%788:%788 ][%!788:heer, mevrouw ]%n
Zonder titel, met voorletter 'P.':
- Man: 'heer van den Bempt'
- Vrouw: 'mevrouw van den Bempt'
- Niet gespecificeerd: 'P. van den Bempt'
- Niet ingevuld: 'heer, mevrouw van den Bempt'
Met titel (bijvoorbeeld 'Dr.'):
- Alle vier de velden geven hetzelfde resultaat: 'Dr. van den Bempt'.