Functie-uitdrukkingen en dynamische variabelen gebruiken in eADM

In eADM kun je dynamische variabelen gebruiken bij het configureren van regelsets, berichtsjablonen en exportsjablonen. Een dynamische variabele is een plaatshouder die wordt vervangen door een gegenereerde waarde wanneer een regel of sjabloon wordt uitgevoerd.

Wat zijn dynamische variabelen?

Een dynamische variabele kan zowel een attribuut als een functie zijn.

Attribuut: Verwijst direct naar de waarde van een attribuut op een object (bijv. de voornaam van een gebruiker).
Functie: Neemt een of meer parameters en genereert op basis daarvan een nieuwe waarde. Parameters kunnen statische tekst, getallen of zelfs andere dynamische variabelen zijn.

De beschikbare attributen worden bepaald door het objecttype (gebruiker, groep of afdeling), hoewel sommige attributen gemeenschappelijk zijn voor meerdere typen.

Opmerking:

Voornaam is alleen beschikbaar voor gebruikersobjecten.
Naam is beschikbaar voor groeps- en afdelingsobjecten (maar niet voor gebruikers).
Beschrijving is beschikbaar voor alle objecttypes.

Dynamische variabelen gebruiken

Je kunt dynamische variabelen invoegen via een vervolgkeuzemenu of door rechtstreeks in een tekstveld te typen. Een afdelingsnummer kan bijvoorbeeld worden geselecteerd als AfdelingNummer uit een dropdown of getypt als [DepartmentNumber]. in een tekstveld.

Tekstopmaak

In elk ondersteund tekstveld kun je handmatig een dynamische variabele toevoegen.

Typ een openende vierkante haak [ om te beginnen. De afsluitende haak] wordt automatisch toegevoegd.
Met de cursor tussen de haakjes verschijnt een lijst met beschikbare variabelen.
De lijst is alfabetisch gesorteerd en filtert terwijl je typt. Als je bijvoorbeeld "dep" typt, worden alle variabelen met die tekst weergegeven.
Gebruik de ↑ en ↓ pijltjestoetsen en Ga naar om een variabele te selecteren of scroll en klik met de muis. Druk op Esc om de lijst te sluiten.

Waarschuwing: Bij gebruik van de tekstindeling zijn alle dynamische variabelen moet tussen vierkante haakjes staan []. Functies moet altijd in tekstformaat en tussen vierkante haken worden geschreven [].

Voorbeelden:

Attribuut: [voornaam]
Functie: [IFEMPTYUSE;[workphone];[mobile]].

Uitdrukkingen

Een expressie is een tekststring die een of meer dynamische variabelen combineert met statische tekst om een enkele uitvoer te produceren. Expressies kunnen variëren van eenvoudig tot zeer geavanceerd.

Uitdrukking	Beschrijving	Voorbeeld van gegenereerde waarde
`[voornaam]`	Een enkel kenmerk.	`Kari`
`[voornaam] [achternaam]`	Twee attributen gescheiden door een spatie.	`Kari Nordmann`
`Hallo, [voornaam] [achternaam]!`	Statische tekst gecombineerd met twee attributen.	`Hallo, Kari Nordmann!`
`[LOWER;[voornaam]]`	Een functie met één attribuut als parameter.	`kari`
`[SUBSTRING;0;3;[voornaam]]`	Een functie met meerdere parameters, waaronder een attribuut.	`Kar`
`[LOWER;[SUBSTRING;0;3;[voornaam]][SUBSTRING;0;3;[achternaam]]`	Een geneste expressie die meerdere functies en attributen gebruikt.	`karnor`

De expressiebouwer

Voor het maken van complexe expressies met geneste functies of om te testen hoe een expressie zich zal gedragen, kun je de Expression Builder gebruiken. Deze is beschikbaar voor elk tekstveld dat dynamische variabelen ondersteunt, aangegeven met een knop naast het veld.

De Expression Builder bevat de volgende gereedschappen:

Uitdrukking: Een tekstveld om je expressie op te bouwen, met volledige ondersteuning voor de autocomplete functionaliteit die hierboven is beschreven.
Wijzigingen ongedaan maken: Een knop die alle bewerkingen ongedaan maakt die zijn gemaakt sinds de bouwer werd geopend.
Evaluatie: Een voorbeeldvenster met de gegenereerde uitvoer van de expressie voor een geselecteerd object.
Selecteer [Object]: Opent een dialoogvenster om een specifiek object (bijv. een gebruiker) te zoeken en te selecteren om te gebruiken voor de evaluatie.
Selecteer willekeurig [Object]: Selecteert automatisch een willekeurig object van het juiste type om te gebruiken voor de evaluatie.