eADM-regulærudtryksmotor

Oversigt

Regulærudtryksmotoren udfører parentesfunktioner og feltpladsholdere i eADM. Udtryk forekommer i:

Sådan fungerer evalueringen

1. Motoren gennemsøger udtrykket for [...] tokens.

2. [ARRAYFOREACH...] kører først — før den inderste-først-gennemgang — så skabelonpladsholdere ??? og ???i bind pr. element adskilt med lodret streg.

3. Ellers udvurderes det inderste parentespar først.

4. Hver funktion returnerer et resultat i almindelig tekst, der erstatter parentesen.

5. Når der ikke er flere funktioner tilbage, forbliver [FieldName] tokens erstattes fra det aktuelle objekt (og valgfrit historik-række i meddelelsesstrømme).

6. Feltnavne, der ikke genkendes, forbliver som bogstavelige værdier [FieldName] i udskriften.

Lister adskilt med kommaer (|) anvendes til data med flere værdier — især inden for HR stillinger på en bruger.

Fiktive data, der anvendes i eksemplerne nedenfor

Medmindre andet er angivet, forudsætter eksemplerne, at kunden er Eksempel kommune med:

Objekttype-id’er (til opslag): Bruger=1, Afdeling=2, Gruppe=3, API-bruger=14.

Syntaksregler

• Funktioner: [NAME;arg1;arg2;...] — argumenter adskilt med semikolon (;).

• Felter: [FieldName] — værdien fra det aktuelle objekt (skelner ikke mellem store og små bogstaver).

• Indlejrede udtryk: de indre parenteser udvurderes før de ydre.

• Listeskilletegn: rørtegn | (lodret streg) mellem værdierne — f.eks. POS-01|POS-02. Skriv aldrig en bagstreg; | forekommer kun som Markdown-escaping i kildefiler, ikke i udtryk.

• Datoer i felter gemmes ofte som dd.MM.yyyy HH:mm:ss; importfunktioner kan bruge yyyy-MM-dd og andre almindelige formater.

Forespørgsels-minisprog

Anvendes indendørs [FOREACH], [IFTHENELSE], og avanceret [OBJECT...] filtre.

Indsæt følgende foran dataene: object., system., systemrole., objectpermission., osv.

Rede

Først det indre felt, derefter den ydre funktion

Blokeres, hvis det indre felt mangler: [SUBSTRING;0;10;[UnknownField]] forbliver uændret, når UnknownField findes ikke på objektet.

Typisk tilladelseskæde (læses indefra og ud):

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

1. Tilladelse → afdelings-id 2100

2. Afdeling → bruger-id for leder

3. Bruger → visningsnavn for administrator

[ARRAYFOREACH...] er anderledes: den udvider en liste adskilt med lodrette streger før indre funktioner i skabelonudførelsen. Brug ??? for det aktuelle element og ???i på grund af dets 0-baserede indeks. Rede [ARRAYFOREACH...] inden i en anden [ARRAYFOREACH...] understøttes ikke — brug [ARRAYJOIN] / [ARRAYPREFIX] eller i stedet opkald fra søskende.

Adgangsniveauer

Automatisering (synkronisering, meddelelser, eksport) udfører udtryk med serverrettigheder. En funktion, der fungerer i produktionsmiljøet, kan stadig være blokeret i udtryksbyggeren for din rolle.

Pladsholdere i felter

Ikke funktioner — erstattet fra det aktuelle objekt (eller historiklinjen i begivenhedsstyrede meddelelsesstrømme).

Eksempel: Skabelon Hello [GivenName] [Surname] om Kari Nordmann → Hello Kari Nordmann

Kun historik (besked vises efter synkronisering): [OldValue], [NewValue], [EntryType], [AttributeName], [Comment].

Funktionsoversigt med eksempler

Hver post indeholder en liste over parametre, et eksempel med fiktive data og det forventede resultat.

Dato og klokkeslæt

[NÅ] / [NOW]

Returnerer serverens dato og klokkeslæt.

Anvendelse: Visning af tilladelsesstatus og relative frister i skabeloner.

[DATEFORMAT;date;format]

Omformaterer en datostreng.

Anvendelse: Eksportformater, ISO-datoer i API-data.

[DATEDIFF;date1;date2;unit]

Den numeriske forskel mellem to datoer.

Anvendelse: Kontrol af ansættelsesperioder i regelsæt, »dage indtil start« i meddelelser.

[DAYOFYEAR;date]

Anvendelse: Sæsonbestemte regler, regnskabsårsrelaterede finesser.

Strengmanipulation

[SUBSTRING;start;length;text]

Anvendelse: Kun dato fra dato og klokkeslæt i velkomstmails: [SUBSTRING;0;10;[Start]] → 01.04.2026.

[SPLIT;text;delimiter;index]

Anvendelse: Hilsen fra feltet med det sammensatte navn; vælg koden for den sidste position.

[REPLACE;text;find;replace]

Anvendelse: Normalisering af telefonnumre, udskiftning af separatorer i brugernavne.

[REPLACELIST;text;fromChars;toChars]

Tegn-for-tegn-tabel (begge tegnlister skal have samme længde).

Anvendelse: Rettelser af ældre tegnsæt ved import.

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

Anvendelse: Rens rørlisterne efter [ARRAYDIFF].

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

Anvendelse: Medarbejdernumre med fast bredde i fileksport.

[RIGHT;length;text]

Anvendelse: De sidste cifre i det nationale identifikationsnummer i testmiljøer.

[INITIALS;text;startWord;endWord]

Anvendelse: Kortkoder i gruppenavne eller e-mail-aliaser.

[PRETTIFY;text]

Store bogstaver efter mellemrum eller bindestreg.

Anvendelse: Vis navne i meddelelser, når HR skriver med store bogstaver.

[LOWER;text] / [UPPER;text]

Anvendelse: Normaliser først [CLEAN] i reglerne for brugernavne.

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

Fjern eller udskift tegn, der ikke er tilladt i brugernavne, strenge id’er eller AD-fællesnavne (CN).

Det nøjagtige resultat afhænger af kundens tegnregler; test det i udtryksbyggeren.

[GETKEYVALUE;key;delimiter;metadata]

Læser key<delimiter>value par inden for en metadatestreng, der er adskilt med lodrette streger.

Anvendelse: Brugerdefinerede importmetadata for udvidelsesattributter.

Logik og kontrolflow

[IFTHENELSE;query;thenValue;elseValue]

Anvendelse: En enkelt skabelon til blandede objekttyper.

[IFEMPTYUSE;primary;fallback;reversed]

Anvendelse: Standardtekst, hvis udløbsdato, ansvarlig eller kommentar mangler.

[EXISTS;value;resultIfNonEmpty]

Anvendelse: Indlejrede opslag i Gate — udføres kun [REFERENCE...] når [Manager] er indstillet.

[TRANSFORM;input;mapping...]

Anvendelse: HR-koder → vis tekst i meddelelser.

[CONTAINS;valueList;targetList;ifYes;ifNo]

Anvendelse: Forgrening i stil med et regelsæt inden for en skabelon.

Operationer med arrays (adskilt med lodrette streger)

Lister ser sådan ud A|B|C. Mange felter i HR-stillingsbeskrivelser bruger denne form.

[COUNT;ignored;list]

Anvendelse: »Hvor mange stillinger har denne bruger?«

[ARRAYAPPEND;list1;list2]

Anvendelse: Sammenføj rollelister fra to tilladelsesforespørgsler.

[ARRAYUNIQUE;list]

Anvendelse: Fjern dubletter blandt afdelings-id’er inden eksport.

[ARRAYFILTER;list;allowed]

Bevarer kun de elementer, der forekommer i allowed.

Anvendelse: Tilføj positionstyper til en meddelelses hvidliste.

[ARRAYDIFF;current;previous]

Varer i current ikke i previous.

Anvendelse: Registrer ny stilling i meddelelsesflowet (sammen med [LASTVALUE;APositionCodeId]). Advarsel: upålideligt, hvis flere positioner ændres i én import.

[ARRAYJOIN;list1;list2]

Sammenkæder to lister efter indeks.

Anvendelse: Sammenlæg parallelle kolonner for at oprette eksportlinjer i CSV-format.

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

Gennemløber en adskilt med komma liste. For hvert element, der ikke er tomt, erstattes ??? sammen med elementet og ???i med sin 0-baserede indeksering i skabelonen evaluerer indlejrede [...] i skabelonen og sammenkæder derefter resultaterne.

Tomme rørsegmenter er sprunget over (samme konvention som [ARRAYUNIQUE] / [ARRAYPREFIX]).

Understøttes ikke: [ARRAYFOREACH...] indlejret i en anden [ARRAYFOREACH...] — udtrykket kan ikke evalueres. Brug to på hinanden følgende opkald eller [ARRAYJOIN] i stedet.

Anvendelse: Formater hver position som en separat linje i en besked; sæt et præfiks for hvert enheds-id ved eksport.

[ARRAYPREFIX;list;mode;text]

Anvendelse: Eksterne id’er i navneområdet.

[ARRAYTRIM;list;delimiter;maxCount]

Anvendelse: Kun de første N positioner i en oversigtsmail.

[PRUNEARRAY;list;regex;reverse]

Anvendelse: Fjern midlertidige positionskoder fra eksporten.

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

Sammenfletter parallelle lister række for række til rækker, der består af mellemrum og lodstreger.

Anvendelse: Tekstblokke med flere kolonner i rapporter.

Tilfældighed, hash, entydighed

[RND;min;max]

Anvendelse: Billetnumre i testskabeloner.

[STRRND;minLen;maxLen;chars]

Anvendelse: Engangskoder, når der ikke anvendes en adgangskoderegel.

[PASSWORD;ruleId]

Anvendelse: Indledende adgangskode i velkomstbeskeden — skal håndteres sikkert.

[HASH;text]

Anvendelse: Uigennemsigtige tokens i links (ikke udelukkende til sikkerhedskritisk hashing).

[UNIQUE;base;fieldName;replacement]

Sikrer base findes ikke allerede i fieldName på et andet objekt; tilføjer 2, 3, … eller indsætninger før replacement.

Anvendelse: Kundeopsætning udtryk for brugernavn sammen med [CLEAN] / [LOWER].

Databaseopslag og relationer

Disse læser live eADM-data for kunden. ID’erne skal findes i dit miljø.

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

Anvendelse: Afdelingsnummer fra tilladelsen ManagerOf id:

[REFERENCE;OrgUnitnr;Id;2;2100]

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

Læser tilladelser for den aktuelle bruger.

Forkortelse for rollenavn:

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

Henter objektets historik for den aktuelle bruger (logspor fra synkronisering/brugergrænseflade).

Anvendelse: "Hvem har tildelt denne tilladelse?" i meddelelsesforløb (ofte indlejret i [SPLIT] / [REFERENCE]).

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

Eksempel (konceptuelt): Alle brugere med rolle 501, CSV:

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

Output (dummy):

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

Anvendelse: Ledelsesrapport indlejret i e-mailens brødtekst.

[DESCENDANTS;rootId;returnField;parentKey;foreignKey]

Anvendelse: Alle underafdelinger, der er omfattet af en leders tilladelse.

[SYSTEM;type;id;field]

Anvendelse: Kontaktoplysninger på systemejeren i administratorbeskeden.

[SELECTION;rulesetId;returnField]

Anvendelse: Mailingliste over alle, der opfylder regelsættet »Nye medarbejdere«.

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

Returnerer værdier adskilt med lodrette streger for systemer eller roller, der opfylder regelsættet »Tilgængelig for« for den aktuelle bruger.

Anvendelse: Dynamiske udvælgelseslister i formularer eller meddelelser.

[AVAILABLEDEPARTMENTS;fields;targetUserId]

Anvendelse: Viser de afdelinger, som en leder kan administrere (fra ManagerOf, enheds-id’er, mega.eadm.no-roller ).

[DATAOWNER;returnField]

Følger data-ejer-relationen på objektet; returnerer feltet fra ejeren.

[ANTECEDANTS.SYSTEMROLE;roleId;departmentId;returnField]

Ledere, der besidder roleId på forfader afdelinger under departmentId.

Anvendelse: Eskaleringsmail, når en underafdeling under HR ikke har en lokal godkendende person.

[COUNTEMPLOYEE] / [COUNTMEMBERS]

Vurderes henholdsvis på afdelings- eller gruppeniveau.

[GETLASTSYNCID]

Anvendelse: Fejlfinding i sidefødder i administrator-e-mails.

[LASTVALUE;attributeName]

Den tidligere værdi for feltet fra den seneste import af HR- historik, ellers den aktuelle værdi for feltet.

Serveres sammen med [ARRAYDIFF;[APositionCodeId];[LASTVALUE;APositionCodeId]] → POS-02|.

Stillinger (HR med flere stillinger)

Feltpositioner deler indeks på tværs af rør: indeks 0 = første plads, 1 = sekund.

[POSITION;returnField;whereField;matchValue]

[POSITIONS;returnField;whereField;matchValue]

Det samme som [POSITION] men returnerer en sammenhængende række af tegn på tværs af alle positioner (et tomt felt, hvor der ikke er noget match).

[GROUPPRIMARYPOSITION;returnField]

Valg primær placering: øverst APositionPercentage, tie-break efter tidligste APositionStartDate.

[ACTIVEPOSITIONCOUNT;asOfDate]

Meddelelser og integration

[COUNTMESSAGESENT;messageId;fromDate]

Udeladt messageId: Hvis id'et for meddelelsesskabelonen ikke er angivet ([COUNTMESSAGESENT;] er lig med 0), udtrykket udregnes i sammenhæng med den meddelelsesskabelon, hvis afsendelse udløste regelsættet. Med andre ord betyder det »er den meddelelse, der netop nu sendes, allerede blevet sendt til denne modtager?«, og ikke noget bestemt skabelon-id. Derfor kan det samme regelsæt genbruges som beskyttelse mod dobbeltudsendelse for flere forskellige meddelelsesskabeloner, i stedet for at man skal oprette et separat regelsæt for hver enkelt skabelon.

Anvendelse: »Er der allerede sendt en besked?«-kontrol i opfølgningsforløbet; fælles kontrol mod dobbeltudsendelse på tværs af flere meddelelsesskabeloner.

[SYSTEMOWNER]

Kræver en historikpost fra en ændring af tilladelsen (tilladelse til at tilføje/redigere/slette).

Anvendelse: CC-systemejer, når der gives automatisk tilladelse.

[SYNCSTEPPARAMETER;key;companySyncStepId]

Adgang: Virksomhedsadministrator i forhåndsvisning af udtryksbyggeren.

[APITOKEN;apiUsername]

Adgang: Virksomhedsadministrator i forhåndsvisning. Må kun bruges i sikrede serverbaserede arbejdsgange.

HTML-hjælpefunktioner (meddelelsesskabeloner)

[HTMLLISTMEMBEROF;displayField]

For en bruger, der er medlem af en gruppe: viser overordnede grupper.

[HTMLLISTARRAY;list]

Kontrolelementer i formularskabeloner

Anvendes i formularskabeloner, ikke i standardregelsæt.

Eksempel på mønster: [INPUTBOX;1042;Avdeling;IT-100;] viser indtastningen med betegnelsen »Avdeling«, hvor standardværdien er IT-100.

Markører [NOTIFY...], [HIDDEN...], [SERVERFUNCTION...] er adfærdshooks, ikke datafunktioner.

End-to-end-scenarier (fiktive data)

Velkomstmail — kun startdato

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

Resultat: Ny ansatt Kari Nordmann starter 01.04.2026.

Linje om udløb af tilladelse

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

Resultat: Gyldig til: Permanent tilgang

Lederen er fraværende — eskaler sagen til lederen i den overordnede afdeling

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

Juster kombinationen af IFEMPTYUSE og EXISTS, så den passer til formålet med din skabelon; test den i udtryksbyggeren.

Kun ny stilling — modtager af meddelelsen

Efter synkronisering tilføjes POS-02:

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

Resultat: E-mail-adresse til lederen for den nye stillings afdeling (fiktiv: ny-leder@eksempel.kommune.no).

Navn på autosikkerhedsgruppe (kundeopsætning)

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

Resultat: SG-IT og digitalisering-IT-100 (det nøjagtige CLEAN-output kan variere).

Eksportkortlægning — samAccountName

[UserName]

Resultat: kari.nordmann

Regelsæt — brugeren har en rolle i systemet

Regelattributudtryk :

[OBJECTPERMISSION.SYSTEMROLE;Name;SystemRoleId;501]

Beregnet værdi: Bruker Fagsystem X — sammenligningsoperatør Er lig / medlemsudbydere.

Udtryksgenerator

To indtastningsmåder for værdien af en regelbetingelse

Hver betingelseslinje under fanen »Regler« i et regelsæt har et felt kald et »Attribut« (eller »Argument«) med to små ikoner, der skifter mellem indtastningsmodus:

• Dropdown-tilstand (ikonet med op-/ned-pile) — standardindstillingen. Viser en dropdown-liste med objektets attributværdier, som kan søges i, grupperet efter type (bruger-, gruppe-, afdelings- eller formularattributter, afhængigt af hvad regelsættet bruges sammen med).

• Fri tekst-tilstand (tastaturikon) — ændrer feltet til et almindeligt tekstfelt. Brug dette til at indtaste fastkodet tekst eller et funktionsudtryk ved hjælp af den parentes-syntaks, der er beskrevet tidligere i denne artikel, f.eks. [COUNTMESSAGESENT;7166].

I friteksttilstand er der stadig autofuldførelse: Når man skriver en del af et funktions- eller feltnavn (f.eks. [count) overflader, der har fælles egenskaber og funktioner, såsom [COUNTEMPLOYEE], [COUNTMEMBERS], og [COUNTMESSAGESENT;message id].

Test af et udtryk med »Rediger udtryk«

Når et betingelsesfelt er i friteksttilstand, kan man ved at klikke på et ekstra ikon ved siden af det åbne dialogboksen »Rediger udtryk «. Brug den til at afprøve et funktionsudtryk på et konkret objekt, inden reglen gemmes.

I dialogboksen vises følgende:

• Objekttype — regelsættets primære objekttype (f.eks. Bruger) og hvilke sekundære kontekster der er tilgængelige (Funktion, Funktionsalias, Begivenhed, Historik).

• Kontekst — et testobjekt, der skal bruges til evalueringen. Brug »Søg« til at vælge et bestemt objekt, eller vælg »Vælg tilfældigt«, så eADM vælger et.

• Udtryk — et redigerbart tekstfelt, der er forudfyldt med betingelsens aktuelle udtryk.

• Resultat — det evaluerede resultat, der vises, når man klikker på »Udfør«.

Når du redigerer, vises der en hjælpetip, når du holder markøren over en funktion i udtrykket. Den indeholder funktionens fulde syntaks, en kort beskrivelse og betydningen af hver parameter. Hjælpetipet fremhæver hele udtrykket i grønt og viser den del, der svarer til den aktuelle markørposition, med fed skrift, hvilket gør det betydeligt nemmere at finde rundt i lange eller dybt indlejrede udtryk.

Fejlfinding

Hurtigoversigt

Noter om AI-assistenten

1. Foretrækker [DisplayName]-felter, inden de indsættes i funktioner.

2. Spørg, hvor udtrykket findes: regelsæt, besked, eksport eller kundeopsætning.

3. Erstat fiktive id’er (501, 2100) med kundens rigtige systemrolle og afdeling id'er fra systemadgang.

4. Filtrering ved import udelukker resultater, der matcher; regelsættet for synkroniseringstrinnet inkluderer resultater, der matcher.

5. Begivenhedsmeddelelsesforløb kræver objekthistorik fra en synkroniseringskørsel.

6. Opret indlejrede eksempler indefra og ud — bortset fra [ARRAYFOREACH...], som binder ??? pr. element, inden skabelonfunktionerne udføres.

7. Undgå indlejring [ARRAYFOREACH...]; brug søskendeopkald eller [ARRAYJOIN].

8. [COUNTMESSAGESENT;] med den messageId »omitted« vurderes i forhold til den meddelelsesskabelon, der netop sendes, så ét regelsæt kan styre flere meddelelsesskabeloner — men forhåndsvisningen fungerer ikke uden for en egentlig afsendelse.

9. Der er to måder at indstille værdien for en regelbetingelse på: rullemenu (attributvælger) eller fritekst (tastaturikon, fastkodet tekst eller udtryk), hvor funkt ionen »Rediger udtryk« er tilgængelig i friteksttilstand, så man kan teste udtrykket mod et eksempelobjekt.

10. Begreber: regelsæt (Regelsett), meddelelsesflow (meldingsflyt), systemadgang (systemtilgang), tilladelse (tilgang), objekthistorik (objekthistorikk).

Senest opdateret: 29. juli 2026