eADM-engine voor regeluitdrukkingen

eADM-engine voor regeluitdrukkingen

Overzicht

De regeluitdrukkingsengine evalueert haakjesfuncties en veldplaatshouders in eADM. Uitdrukkingen komen voor in:

Hoe de evaluatie in zijn werk gaat

1. De engine doorzoekt de uitdrukking op [...] tokens.

2. [ARRAYFOREACH...] wordt als eerste uitgevoerd — vóór de ‘innermost-first’-doorloop — dus sjabloonplaatshouders ??? en ???i bind per door een pipe gescheiden element.

3. Anders worden eerst de binnenste haakjes verwerkt.

4. Elke functie retourneert een resultaat in platte tekst dat de haak vervangt.

5. Als er geen functies meer over zijn, blijven [FieldName] tokens worden vervangen vanuit de huidig object (en eventueel geschiedenisrij (in berichtenstromen).

6. Niet-herkende veldnamen blijven letterlijk behouden [FieldName] in de uitvoer.

Door komma’s gescheiden lijsten (|) worden gebruikt voor gegevens met meerdere waarden — met name op het gebied van HR functies voor een gebruiker.

Fictieve gegevens die in de onderstaande voorbeelden worden gebruikt

Tenzij anders vermeld, gaan de voorbeelden uit van de klant Eksempel kommune met:

ID’s van objecttypen (voor opzoekacties): Gebruiker=1, Afdeling=2, Groep=3, API-gebruiker=14.

Syntaxregels

• Functies: [NAME;arg1;arg2;...] — argumenten gescheiden door een puntkomma (;).

• Velden: [FieldName] — waarde uit het huidige object (hoofdlettergevoelig).

• Geneste uitdrukkingen: binnenste haakjes worden eerst verwerkt, daarna de buitenste.

• Lijstscheidingsteken: pijpje | (verticale streep) tussen waarden — bijv. POS-01|POS-02. Typ nooit een backslash; | komt alleen voor als Markdown-escaping in bronbestanden, niet in uitdrukkingen.

• Datums in velden worden vaak opgeslagen als dd.MM.yyyy HH:mm:ss; bij het importeren kan gebruik worden gemaakt van yyyy-MM-dd en andere gangbare formaten.

Mini-taal voor query's

Voor gebruik binnenshuis [FOREACH], [IFTHENELSE], en gevorderd [OBJECT...] filters.

Voeg aan de gegevens het voorvoegsel toe object., system., systemrole., objectpermission., enz.

Nestelen

Eerst het binnenste veld, daarna de buitenste functie

Wordt geblokkeerd als het binnenste veld ontbreekt: [SUBSTRING;0;10;[UnknownField]] blijft ongewijzigd wanneer UnknownField bevindt zich niet op het object.

Typische machtigingsketen (van binnen naar buiten gelezen):

[REFERENCE;DisplayName;UserId;1;[REFERENCE;Manager;Id;2;[OBJECTPERMISSION;ManagerOf;SystemRoleId;501]]]

1. Toestemming → afdelings-id 2100

2. Afdeling → gebruikers-ID van de manager

3. Gebruiker → weergavenaam beheerder

[ARRAYFOREACH...] is anders: het vult een door verticale streepjes gescheiden lijst aan vóór interne functies in de sjabloon worden uitgevoerd. Gebruik ??? voor het huidige element en ???i vanwege de indexering vanaf 0. Nestelen [ARRAYFOREACH...] binnenin een andere [ARRAYFOREACH...] wordt niet ondersteund — gebruik [ARRAYJOIN] / [ARRAYPREFIX] of in plaats daarvan telefoontjes van broers en zussen.

Toegangsniveaus

Automatisering (synchronisatie, berichten, exporten) voert uitdrukkingen uit met serverrechten. Een functie die in de productieomgeving werkt, kan in de uitdrukkingsbouwer voor jouw rol toch geblokkeerd zijn.

Plaatshouders voor velden

Geen functies — vervangen vanuit het huidige object (of de geschiedenisregel in gebeurtenisgestuurde berichtenstromen).

Voorbeeld: Sjabloon Hello [GivenName] [Surname] over Kari Nordmann → Hello Kari Nordmann

Alleen geschiedenis (berichtstroom na synchronisatie): [OldValue], [NewValue], [EntryType], [AttributeName], [Comment].

Functieoverzicht met voorbeelden

Elk item bevat een overzicht van de parameters, een uitgewerkt voorbeeld met voorbeeldgegevens en de verwachte uitvoer.

Datum en tijd

[NÅ] / [NOW]

Geeft de datum en tijd van de server weer.

Gebruik: Weergave van toestemmingsstatus en relevante deadlines in sjablonen.

[DATEFORMAT;date;format]

Pakt een datumstring opnieuw in.

Gebruik: Exportformaten, ISO-datums in API-payloads.

[DATEDIFF;date1;date2;unit]

Het numerieke verschil tussen twee datums.

Gebruik: Controles op de looptijd in regelsets, „aantal dagen tot aanvang“ in berichten.

[DAYOFYEAR;date]

Toepassing: Seizoensgebonden regels, trucs voor het boekjaar.

Tekenreeksbewerking

[SUBSTRING;start;length;text]

Gebruik: Alleen de datum uit de datum-tijdcombinatie in welkomstmails: [SUBSTRING;0;10;[Start]] → 01.04.2026.

[SPLIT;text;delimiter;index]

Gebruik: Aanhef op basis van het veld met de samengestelde naam; kies de code voor de laatste positie.

[REPLACE;text;find;replace]

Gebruik: Telefoonnummers normaliseren, scheidingstekens in gebruikersnamen omwisselen.

[REPLACELIST;text;fromChars;toChars]

Teken-voor-teken-toewijzing (beide tekenlijsten moeten even lang zijn).

Toepassing: Correcties voor verouderde tekensets bij het importeren.

[RTRIM;text;chars] / [LTRIM;text;chars]

Gebruik: Pijplijsten opschonen na [ARRAYDIFF].

[RPAD;text;padChar;totalLength] / [LPAD;text;padChar;totalLength]

Toepassing: Personeelsnummers met vaste breedte bij het exporteren van bestanden.

[RIGHT;length;text]

Gebruik: De laatste cijfers van het nationale identiteitsnummer in testomgevingen.

[INITIALS;text;startWord;endWord]

Gebruik: Korte codes in groepsnamen of e-mailaliassen.

[PRETTIFY;text]

Hoofdletters na een spatie of koppelteken.

Gebruik: Namen in berichten weergeven wanneer HR deze in hoofdletters verstuurt.

[LOWER;text] / [UPPER;text]

Gebruik: Eerst normaliseren [CLEAN] in de regels voor gebruikersnamen.

[CLEAN;text] / [STRICTCLEAN;text] / [CNCLEAN;text]

Verwijder of vervang tekens die ongeschikt zijn voor gebruikersnamen, strikte ID’s of AD-algemene namen (CN).

De exacte uitvoer hangt af van de tekenregels van de klant; test dit in de Expressie-bouwer.

[GETKEYVALUE;key;delimiter;metadata]

Leest key<delimiter>value paren binnen een door verticale streepjes gescheiden metadatastring.

Gebruik: Metadata voor aangepaste import op extensie-attributen.

Logica en controlestroom

[IFTHENELSE;query;thenValue;elseValue]

Gebruik: Eén sjabloon voor verschillende objecttypes.

[IFEMPTYUSE;primary;fallback;reversed]

Gebruik: Standaardtekst voor ontbrekende vervaldatum, beheerder of opmerking.

[EXISTS;value;resultIfNonEmpty]

Gebruik: Geneste opzoekacties in Gate — alleen uitvoeren [REFERENCE...] wanneer [Manager] is ingesteld.

[TRANSFORM;input;mapping...]

Gebruik: HR-codes → tekst weergeven in berichten.

[CONTAINS;valueList;targetList;ifYes;ifNo]

Gebruik: vertakkingen in de stijl van een regelset binnen een sjabloon.

Bewerkingen op arrays (gescheiden door vertikale streepjes)

Lijsten zien er als volgt uit: A|B|C. In veel HR-functieomschrijvingen wordt deze vorm gebruikt.

[COUNT;ignored;list]

Gebruik: „Hoeveel functies heeft deze gebruiker?”

[ARRAYAPPEND;list1;list2]

Toepassing: Rollijsten uit twee machtigingsquery’s samenvoegen.

[ARRAYUNIQUE;list]

Gebruik: Verwijder dubbele afdelings-ID’s vóór het exporteren.

[ARRAYFILTER;list;allowed]

Behoudt alleen items die voorkomen in allowed.

Gebruik: Voeg berichttypen toe aan de witte lijst voor een bericht.

[ARRAYDIFF;current;previous]

Items in current niet in previous.

Gebruik: Detecteren nieuwe functie in de berichtenstroom (in combinatie met [LASTVALUE;APositionCodeId]). Waarschuwing: onbetrouwbaar als er bij één import meerdere posities veranderen.

[ARRAYJOIN;list1;list2]

Voegt twee lijsten samen op basis van de index.

Gebruik: Combineer parallelle kolommen voor exportregels in CSV-stijl.

[ARRAYFOREACH;array;template] / [ARRAYFOREACH;array;separator;template]

Loopt door een door komma’s gescheiden lijst. Voor elk niet-leeg element wordt vervangen door ??? met het element en ???i met zijn 0-gebaseerde index in de sjabloon, evalueert geneste [...] in het sjabloon, en voegt vervolgens de resultaten samen.

Lege buissegmenten zijn overgeslagen (volgens dezelfde conventie als [ARRAYUNIQUE] / [ARRAYPREFIX]).

Niet ondersteund: [ARRAYFOREACH...] genest in een andere [ARRAYFOREACH...] — de evaluatie van de uitdrukking mislukt. Gebruik twee gelijkwaardige aanroepen of [ARRAYJOIN] in plaats daarvan.

Gebruik: Geef elke positie als een aparte regel in een bericht weer; voeg voor elke eenheids-ID een voorvoegsel toe voor de export.

[ARRAYPREFIX;list;mode;text]

Gebruik: Externe ID’s van naamruimten.

[ARRAYTRIM;list;delimiter;maxCount]

Gebruik: Alleen de eerste N posities in een overzichtsmail.

[PRUNEARRAY;list;regex;reverse]

Gebruik: Verwijder tijdelijke positiecodes uit de export.

[UNION;headers;list1;list2;...]

Voegt parallelle lijsten rij voor rij samen tot rijen met spaties of vertikale streepjes.

Toepassing: Tekstblokken met meerdere kolommen in rapporten.

Willekeurig, hash, uniekheid

[RND;min;max]

Gebruik: Ticketnummers in testsjablonen.

[STRRND;minLen;maxLen;chars]

Gebruik: Eenmalige codes wanneer er geen wachtwoordregel wordt toegepast.

[PASSWORD;ruleId]

Gebruik: Het initiële wachtwoord in het welkomstbericht — ga hier zorgvuldig mee om.

[HASH;text]

Gebruik: Ondoorzichtige tokens in links (niet uitsluitend voor beveiligingskritische hashing).

[UNIQUE;base;fieldName;replacement]

Zorgt ervoor dat base nog niet bestaat in fieldName op een ander object; voegt toe 2, 3, … of invoegingen vóór replacement.

Gebruik: Klantconfiguratie gebruikersnaam-uitdrukking samen met [CLEAN] / [LOWER].

Zoeken in databases en relaties

Deze lezen live eADM-gegevens voor de klant. De ID’s moeten in uw omgeving bestaan.

[REFERENCE;returnField;whereField;objectTypeId;searchValue;exactMatch]

Gebruik: Afdelingsnummer uit de toestemming ManagerOf id:

[REFERENCE;OrgUnitnr;Id;2;2100]

[OBJECTPERMISSION;returnField;whereField;filterValue;exactMatch;aggregate]

Leest de toegangsrechten van de huidige gebruiker.

Afkorting voor de rolnaam:

[OBJECTHISTORIES;returnField;whereField;filterValue;exactMatch;aggregate]

Leest de objectgeschiedenis van de huidige gebruiker (audittrail van synchronisatie/gebruikersinterface).

Gebruik: “Wie heeft deze toestemming verleend?” in berichtenstromen (vaak genest in [SPLIT] / [REFERENCE]).

[FOREACH;collection;query;returnFields;headers;format]

Voorbeeld (conceptueel): Alle gebruikers met rol 501, CSV:

[FOREACH;objectpermission;SystemRoleId=501;object.DisplayName,object.Email;Name,Email;csv]

Uitvoer (dummy):

Name,Email
Kari Nordmann,kari.nordmann@eksempel.kommune.no
Ola Hansen,ola.hansen@eksempel.kommune.no

Gebruik: Managerrapport opgenomen in de tekst van de e-mail.

[DESCENDANTS;rootId;returnField;parentKey;foreignKey]

Gebruik: Alle subafdelingen vallen onder de bevoegdheid van een manager.

[SYSTEM;type;id;field]

Gebruik: Contactgegevens van de systeemeigenaar in de beheerdersmelding.

[SELECTION;rulesetId;returnField]

Gebruik: Mailinglijst van iedereen die voldoet aan de regelset „Nieuwe medewerkers“.

[AVAILABLESYSTEM;field] / [AVAILABLEROLE;systemId;field]

Geeft waarden terug, gescheiden door verticale streepjes, voor systemen of rollen die voldoen aan de regel „Beschikbaar voor ” voor de huidige gebruiker.

Toepassing: dynamische keuzelijsten in formulieren of berichten.

[AVAILABLEDEPARTMENTS;fields;targetUserId]

Gebruik: Geef een overzicht van de afdelingen die een manager kan beheren (op basis van ManagerOf, afdelings-ID’s en rollen in mega.eadm.no ).

[DATAOWNER;returnField]

Volgt de relatie tussen gegevens en eigenaar op het object; retourneert het veld van de eigenaar.

[ANTECEDANTS.SYSTEMROLE;roleId;departmentId;returnField]

Managers die in het bezit zijn van roleId op voorouder afdelingen van departmentId.

Gebruik: Escalatiemail wanneer de onderafdeling van HR geen lokale goedkeurder heeft.

[COUNTEMPLOYEE] / [COUNTMEMBERS]

Beoordeeld op basis van respectievelijk de afdeling of de groep.

[GETLASTSYNCID]

Toepassing: Problemen met voetteksten in beheerdersmails oplossen.

[LASTVALUE;attributeName]

Vorige waarde van het veld uit de laatste import van de HR- geschiedenis, anders de huidige waarde van het veld.

Serveer bij [ARRAYDIFF;[APositionCodeId];[LASTVALUE;APositionCodeId]] → POS-02|.

Functies (HR met meerdere functies)

Velden in de positie delen de index over pipes: index 0 = eerste plaats, 1 = seconde.

[POSITION;returnField;whereField;matchValue]

[POSITIONS;returnField;whereField;matchValue]

Hetzelfde als [POSITION] maar geeft een uitgelijnde reeks van verticale streepjes weer voor alle posities (een leeg vakje als er geen overeenkomst is).

[GROUPPRIMARYPOSITION;returnField]

Keuzes primair positie: hoogste APositionPercentage, beslissingswedstrijd op basis van de vroegste APositionStartDate.

[ACTIVEPOSITIONCOUNT;asOfDate]

Berichtenverkeer en integratie

[COUNTMESSAGESENT;messageId;fromDate]

Gebruik: de controle „Reeds op de hoogte gebracht?“ in de vervolgstroom.

[SYSTEMOWNER]

Hiervoor is de geschiedenisregel van de wijziging in de machtiging nodig (machtiging toevoegen/bewerken/verwijderen).

Gebruik: eigenaar van het CC-systeem wanneer geautomatiseerde toestemming wordt verleend.

[SYNCSTEPPARAMETER;key;companySyncStepId]

Toegang: Bedrijfsbeheerder in het voorbeeldvenster van de Expression Builder.

[APITOKEN;apiUsername]

Toegang: Bedrijfsbeheerder in de previewversie. Alleen gebruiken in beveiligde server-side processen.

HTML-hulpfuncties (bericht-sjablonen)

[HTMLLISTMEMBEROF;displayField]

Bij een gebruiker die lid is van een groep: geeft een overzicht van de bovenliggende groepen.

[HTMLLISTARRAY;list]

Besturingselementen voor formuliersjablonen

Wordt gebruikt in formuliersjablonen, niet in standaardregelsets.

Voorbeeldpatroon: [INPUTBOX;1042;Avdeling;IT-100;] geeft de invoer met het label „Avdeling“ standaard weer als IT-100.

Markeringen [NOTIFY...], [HIDDEN...], [SERVERFUNCTION...] zijn hooks voor formuliergedrag, geen gegevensfuncties.

End-to-end-scenario's (fictieve gegevens)

Welkomstmail — alleen startdatum

Ny ansatt [DisplayName] starter [SUBSTRING;0;10;[Start]].

Uitvoer: Ny ansatt Kari Nordmann starter 01.04.2026.

Regel betreffende het verstrijken van de toestemming

Gyldig til: [IFEMPTYUSE;[OBJECTPERMISSION;ExpiryDate;SystemRoleId;501];Permanent tilgang]

Uitvoer: Gyldig til: Permanent tilgang

Manager afwezig — doorgeven aan de manager van de bovenliggende afdeling

[IFEMPTYUSE;
 [EXISTS;[Manager];];
 [REFERENCE;Email;UserId;1;[REFERENCE;Manager;Id;2;[REFERENCE;ParentDepartmentNumber;DepartmentNumber;2;[DepartmentNumber]]]]]

Pas de combinatie van IFEMPTYUSE en EXISTS aan zodat deze overeenkomt met de bedoeling van je sjabloon; test dit in de Expressie-bouwer.

Alleen nieuwe functie — ontvanger van het bericht

Na het synchroniseren worden de volgende items toegevoegd POS-02:

[REFERENCE;Email;UserId;1;[POSITION;APositionManager;AUnitId;[RTRIM;[ARRAYDIFF;[APositionCodeId];[LASTVALUE;APositionCodeId]];|]]]

Uitvoer: E-mailadres van de manager van de afdeling waar de nieuwe functie onder valt (plaatshouder: ny-leder@eksempel.kommune.no).

Naam van de automatische beveiligingsgroep (door de klant ingesteld)

SG-[Department]-[CLEAN;[OrgUnitnr]]

Uitvoer: SG-IT og digitalisering-IT-100 (de exacte CLEAN-uitvoer kan afwijken).

Exporttoewijzing — samAccountName

[UserName]

Uitvoer: kari.nordmann

Regelset — gebruiker heeft een rol in het systeem

Uitdrukking van het regelattribuut :

[OBJECTPERMISSION.SYSTEMROLE;Name;SystemRoleId;501]

Berekende waarde: Bruker Fagsystem X — vergelijkingsoperator Er lik / exploitanten van lidmaatschappen.

Uitdrukkingsbouwer

Problemen oplossen

Sneloverzicht

Aantekeningen van de AI-assistent

1. Liever [DisplayName]velden van het -type voordat ze in functies worden ingekapseld.

2. Vraag waar de uitdrukking is opgeslagen: regelset, bericht, export of klantconfiguratie.

3. Vervang de dummy-ID's (501, 2100) met de echte systeemrol en afdeling ids uit toegang tot het systeem.

4. Als je bij het importeren een filter instelt, worden overeenkomsten uitgesloten; in de regelset voor de synchronisatiestap worden overeenkomsten meegenomen.

5. Voor de gegevensstromen van gebeurtenissen is de objectgeschiedenis van een synchronisatieronde nodig.

6. Maak geneste voorbeelden binnenstebuiten — behalve [ARRAYFOREACH...], dat zich bindt aan ??? per element voordat de sjabloonfuncties worden uitgevoerd.

7. Niet nesten [ARRAYFOREACH...]; gebruik aanroepen van broers en zussen of [ARRAYJOIN].

8. Termen: regelset (Regelsett), berichtenstroom (meldingsflyt), systeemtoegang (systemtilgang), toestemming (tilgang), objectgeschiedenis (objekthistorikk).

Laatst bijgewerkt: 19 juni 2026