INHOUDSOPGAVE

Inleiding

Met conditional statements kan een document ingericht worden op basis van een gegeven uit een data- of formulierveld. Bijvoorbeeld als een formulierveld aangeeft 'Engels' kan middels de conditional statement een Engelse tekst gegenereerd worden. Als het formulierveld 'Nederlands' aangeeft, kan er Nederlandse tekst gegenereerd worden. Naast dit voorbeeld kunnen conditional statements ook gebruikt worden voor delen in tekst zoals tijdstip of locatie.


Op deze pagina wordt kort uitleg gegeven over hoe de conditional statements ingericht kunnen worden. Voor verdiepende kennis kan gebruik gemaakt worden van de officiële documentatie: 

Verder staat op de website Using Fields in Microsoft Word duidelijke uitleg over dit onderwerp. Voor meer informatie over het invoegen van formuliervelden uit Xpert Suite in Word kan je hier terecht XSC - Waar kan ik de Word add-in downloaden om dotx documenten aan te maken?.


Inrichting veldcodes

Conditional statements worden in Word ingericht. In de statement maak je gebruik van de data- en formuliervelden uit Xpert Suite. Meer uitleg over het toevoegen van data- en formuliervelden aan Word documenten staat op de supportpagina Documentsjablonen. Velden kunnen ook vanuit Word ingevoegd worden, zoals huidige datum. Dit kan via Invoegen →  Snelonderdelen → Veld...


Met ALT + F9 kan er geschakeld worden tussen de weergave van de veldcodes en weergave van de veldresultaten. Alvorens je begint met het maken van een conditional statement dien je de weergave van veldcodes in te schakelen. Wanneer je de veldcode bekijkt, ziet de syntax er als volgt uit.


{ MERGEFIELD FieldName [Switches] }

  • MERGEFIELD: Dit is de veldnaam, deze moet altijd MERGEFIELD zijn.
  • Fieldname: Dit moet gelijk zijn aan de code uit Xpert Suite, de code die je ziet als je een veld via de add-in toevoegt.
  • [Switches]: Hier kunnen veel verschillende switches ingevoegd worden, als je in het dialoogvenster het vinkje “Preserve formatting during updates” aan laat staan verschijnt bijvoorbeeld de switch \* MERGEFORMAT. Je kunt nog enkele switches in het dialoogvenster aanklikken of invullen, maar er zijn er nog veel meer. Een switch begint altijd met een backslash ( \ ).


Een switch die vaak van pas komt in de aanhef van een document is de \f switch. Als je «Roepnaam Werknemer» «Tussenv Werknemer» «Achternaam Werknemer» gebruikt in de aanhef komt er een dubbele spatie als er geen tussenvoegsels ingevuld zijn. Door deze switch te gebruiken in de roepnaam en tussenvoegsel velden met een enkele spatie heb je dit probleem niet meer. Je kunt deze switch makkelijk toevoegen via rechtermuisknop → Edit Field.


Sneltoetsen

F9

Update veld

Alt + F9

Schakelen tussen veldcode en resultaat

Ctrl + F9

Leeg veld creëren

Alt + I, dan F

Veld aanmaken via dialoogvenster


Inrichting conditional statement

Middels een IF statement kan de voorwaarde ingesteld worden waarop een bepaald stuk tekst naar boven komt. De syntax van een IF-field ziet er als volgt uit:


{ IF expression1 operator expression2 "truetext" "falsetext" }



  • expression1: De eerste waarde die je wilt controleren, vaak een mergefield.
  • operator: De vergelijking die Word uitvoert. Hieronder staat een lijst van mogelijke operators.
  • expression2: De tweede waarde die Word vergelijkt met de eerste.
  • truetext: De tekst die Word toont als de vergelijking Waar is.
  • falsetext: De tekst die Word toont als de vergelijking Onwaar is.



Let op: 
De accolades moeten toegevoegd worden via Ctrl + F9, handmatig typen lijkt hetzelfde maar wordt niet door Word herkend. Het mergefield kan toegevoegd worden vanuit Xpert Suite. Vervolgens dien je de tekst in te voeren die er komt als de statement Waar is en de tekst in te voeren als de statement Onwaar is.


In de tabel hieronder staan de mogelijke operators:


=

Gelijk aan

<> 

Niet gelijk aan

> 

Groter dan

< 

Kleiner dan

>=

Groter dan of gelijk aan

<=

Kleiner dan of gelijk aan


Verder kan je een IF statement in een IF statement, in een IF statement zetten. Daarmee kan je dus bijvoorbeeld uit wel 4 opties kiezen/tonen op een document. Bij de falsetext , zet je dan weer een nieuwe IF statement die weer 2 andere waardes vergelijkt.


Voorbeeld met twee opties:

{ IF { MERGEFIELD "Leeftijd" } >= "18" "Volwassen" "Niet volwassen" }


Hier word de mergefield Leeftijd vergeleken om te kijken of hij groter dan of gelijk is aan 18. Als de vergelijking Waar is, staat er "Volwassen". Anders staat er "Niet volwassen".


Voorbeeld met meer dan twee opties:

{ IF { MERGEFIELD "Leeftijd" } >= "30" "30 of ouder" { IF { MERGEFIELD "Leeftijd" } < "18" "Niet volwassen" "Jonger dan 30" } }


Hier word de mergefield Leeftijd vergeleken om te kijken of hij groter dan of gelijk is aan 30. Als de vergelijking Waar is, staat er "30 of ouder". Anders start er nog een IF statement, die vergelijkt of dezelfde mergefield kleiner is dan 18. Als de vergelijking Waar is, staat er "Niet volwassen". Anders staat er "Jonger dan 30".

Voorbeeld met formuliervelden in een IF Statement. In de falsetext is tevens een formulierveld als vulling van de tekst gebruikt.

Het gesprek vindt plaats { IF { MERGEFIELD "chk!!Locatie" } = "Kantoor A" "op kantoor A. Het adres is dorpstraat 14, Den Boch"  { IF { MERGEFIELD "chk!!Locatie"} = "Bij de werknemer thuis" "de bedrijfsarts zal bij jou thuis langskomen" { IF { MERGEFIELD "chk!!Locatie" } ="Anders, namelijk" { MERGEFIELD "chk!!Andere_Locatie"} } } }.


Hulp nodig?

Mocht er behoefte zijn om dit door een consultant te laten inrichten, neem dan contact op met je customer succes manager.