eADM:s motor för regeluttryck

eADM:s motor för regeluttryck

Översikt

Regeluttrycksmotorn utvärderar parentesfunktioner och fältplatshållare i eADM. Uttryck förekommer i:

Så här fungerar utvärderingen

1. Motorn söker igenom uttrycket efter [...] tokens.

2. [ARRAYFOREACH...] körs först — innan den inre första genomgången — så att mallplatshållare ??? och ???i bindning per element avgränsat med pipetecken.

3. I övrigt tolkas det innersta parentesparet först.

4. Varje funktion returnerar ett resultat i klartext som ersätter parentesen.

5. När inga funktioner återstår, återstående [FieldName] tokens ersätts från aktuellt objekt (och valfritt historikraden i meddelandeflöden).

6. Fältnamn som inte känns igen behålls som bokstavliga värden [FieldName] i utdata.

Listor avgränsade med pip-tecken (|) används för data med flera värden – särskilt inom HR befattningar för en användare.

Exempeldata som används i exemplen nedan

Om inte annat anges utgår exemplen från att kunden är Eksempel kommune med:

Objekttyp-ID:n (för uppslag): Användare=1, Avdelning=2, Grupp=3, API-användare=14.

Syntaxregler

• Funktioner: [NAME;arg1;arg2;...] — argument som avgränsas med semikolon (;).

• Fält: [FieldName] — värdet från det aktuella objektet (skiljer inte mellan stora och små bokstäver).

• Inbäddade uttryck: de inre parenteserna tolkas före de yttre.

• Listavgränsare: rörtecken | (vertikal streck) mellan värdena — t.ex. POS-01|POS-02. Skriv aldrig ett bakvänt snedstreck; | förekommer endast som Markdown-escaping i källfilerna, inte i uttryck.

• Datum i fält lagras ofta som dd.MM.yyyy HH:mm:ss; import kan använda yyyy-MM-dd och andra vanliga format.

Frågespråk

Används inomhus [FOREACH], [IFTHENELSE], och avancerad [OBJECT...] filter.

Lägg till följande prefix till data: object., system., systemrole., objectpermission., m.fl.

Boet

Först det inre fältet, sedan den yttre funktionen

Blockerad om det inre fältet saknas: [SUBSTRING;0;10;[UnknownField]] förblir oförändrad när UnknownField finns inte på objektet.

En typisk behörighetskedja (läsas inifrån och ut):

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

1. Behörighet → avdelnings-id 2100

2. Avdelning → chefens användar-ID

3. Användare → visningsnamn för administratör

[ARRAYFOREACH...] är annorlunda: den expanderar en lista med pip-avgränsningar innan inre funktioner i mallens körning. Använd ??? för det aktuella elementet och ???i för dess 0-baserade index. Boet [ARRAYFOREACH...] inuti en annan [ARRAYFOREACH...] stöds inte — använd [ARRAYJOIN] / [ARRAYPREFIX] eller istället samtal mellan syskon.

Åtkomstnivåer

Automatisering (synkronisering, meddelanden, export) utvärderar uttryck med serverbehörigheter. En funktion som fungerar i produktionsmiljön kan ändå vara blockerad i uttrycksbyggaren för din roll.

Platshållare för fält

Inte funktioner — ersätts från det aktuella objektet (eller historikraden i händelsestyrda meddelandeflöden).

Exempel: Mall Hello [GivenName] [Surname] om Kari Nordmann → Hello Kari Nordmann

Endast historik (meddelandeflödet efter synkronisering): [OldValue], [NewValue], [EntryType], [AttributeName], [Comment].

Funktionsöversikt med exempel

Varje uppslag innehåller parametrar, ett exempel med fiktiva data och förväntat resultat.

Datum och tid

[NÅ] / [NOW]

Returnerar serverns datum och tid.

Användning: Visning av behörighetsstart och relativa tidsfrister i mallar.

[DATEFORMAT;date;format]

Omformaterar en datumsträng.

Användning: Exportformat, ISO-datum i API-data.

[DATEDIFF;date1;date2;unit]

Den numeriska skillnaden mellan två datum.

Användning: Kontroll av anställningstid i regeluppsättningar, ”antal dagar till start” i meddelanden.

[DAYOFYEAR;date]

Användning: Säsongsrelaterade regler, knep för räkenskapsperioden.

Strängbearbetning

[SUBSTRING;start;length;text]

Användning: Endast datum från datum och tid i välkomstmejl: [SUBSTRING;0;10;[Start]] → 01.04.2026.

[SPLIT;text;delimiter;index]

Användning: Hälsningsfras från fältet för sammansatt namn; välj den sista positionskoden.

[REPLACE;text;find;replace]

Användning: Normalisera telefonnummer, byt ut avgränsningstecken i användarnamn.

[REPLACELIST;text;fromChars;toChars]

Tecken-för-tecken-mappning (båda teckenlistorna måste ha samma längd).

Användning: Korrigeringar av äldre teckenuppsättningar vid import.

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

Användning: Rensa rörlistorna efter [ARRAYDIFF].

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

Användning: Personnummer med fast bredd vid filexport.

[RIGHT;length;text]

Användning: De sista siffrorna i personnummer i testmiljöer.

[INITIALS;text;startWord;endWord]

Användning: Kortkoder i gruppnamn eller e-postalias.

[PRETTIFY;text]

Stora bokstäver efter mellanslag eller bindestreck.

Användning: Visa namn i meddelanden när HR skickar med versaler.

[LOWER;text] / [UPPER;text]

Användning: Normalisera innan [CLEAN] i reglerna för användarnamn.

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

Ta bort eller ersätt tecken som inte är tillåtna i användarnamn, strikta ID:n eller AD-allmänna namn (CN).

Det exakta resultatet beror på kundens teckenregler; testa i uttrycksbyggaren.

[GETKEYVALUE;key;delimiter;metadata]

Läsningar key<delimiter>value par inom en metadatasträng avgränsad med vertikalstreck.

Användning: Anpassade importmetadata för tilläggsattribut.

Logik och kontrollflöde

[IFTHENELSE;query;thenValue;elseValue]

Användning: En enda mall för olika objekttyper.

[IFEMPTYUSE;primary;fallback;reversed]

Användning: Standardtext vid saknad utgångsdatum, ansvarig eller kommentar.

[EXISTS;value;resultIfNonEmpty]

Användning: Nästlade sökningar i Gate — kör endast [REFERENCE...] när [Manager] är inställd.

[TRANSFORM;input;mapping...]

Användning: HR-koder → visa text i meddelanden.

[CONTAINS;valueList;targetList;ifYes;ifNo]

Användning: Förgrening i form av regeluppsättningar inom en mall.

Operationer med arrayer (avgränsade med vertikalstreck)

Listor ser ut så här A|B|C. Många fält för HR-befattningar använder denna form.

[COUNT;ignored;list]

Användning: ”Hur många befattningar har den här användaren?”

[ARRAYAPPEND;list1;list2]

Användning: Sammanfoga rollistor från två behörighetsfrågor.

[ARRAYUNIQUE;list]

Användning: Ta bort dubbletter av avdelnings-ID:n före export.

[ARRAYFILTER;list;allowed]

Behåller endast de objekt som förekommer i allowed.

Användning: Lägg till meddelandetyper i vitlistan för ett meddelande.

[ARRAYDIFF;current;previous]

Objekt i current inte i previous.

Användning: Upptäcka ny tjänst i meddelandeflödet (i kombination med [LASTVALUE;APositionCodeId]). Varning: otillförlitligt om flera positioner ändras vid en och samma import.

[ARRAYJOIN;list1;list2]

Sammanfogar två listor efter index.

Användning: Kombinera parallella kolumner för exportrader i CSV-format.

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

Går igenom en avgränsade med pipetecken lista. För varje icke-tomt element ersätts ??? med elementet och ???i med sitt 0-baserade index i mallen utvärderar kapslade [...] i mallen och sammanfogar sedan resultaten.

Tomma rörsegment är hoppades över (samma konvention som [ARRAYUNIQUE] / [ARRAYPREFIX]).

Stöds inte: [ARRAYFOREACH...] inbäddad i en annan [ARRAYFOREACH...] — uttrycksutvärderingen misslyckas. Använd två parallella anrop eller [ARRAYJOIN] istället.

Användning: Formatera varje position som en egen rad i ett meddelande; lägg till ett prefix framför varje enhets-ID inför export.

[ARRAYPREFIX;list;mode;text]

Användning: Externa ID:n för namnutrymmen.

[ARRAYTRIM;list;delimiter;maxCount]

Användning: Endast de första N positionerna i ett sammanfattande e-postmeddelande.

[PRUNEARRAY;list;regex;reverse]

Användning: Ta bort tillfälliga positionskoder från exporten.

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

Sammanslår parallella listor rad för rad till rader med avstånd eller kombinerade med vertikalstreck.

Användning: Textblock med flera kolumner i rapporter.

Slumpmässighet, hash, unikhet

[RND;min;max]

Användning: Biljettnummer i testmallar.

[STRRND;minLen;maxLen;chars]

Användning: Engångskoder när lösenordsregeln inte används.

[PASSWORD;ruleId]

Användning: Startlösenordet i välkomstmeddelandet – hantera det på ett säkert sätt.

[HASH;text]

Användning: Ogenomskinliga token i länkar (inte enbart för säkerhetskritisk hashning).

[UNIQUE;base;fieldName;replacement]

Säkerställer base inte redan finns i fieldName på ett annat objekt; lägger till 2, 3, … eller infogar före replacement.

Användning: Kundinställningar användarnamn-uttryck tillsammans med [CLEAN] / [LOWER].

Databasuppslag och relationer

Dessa läser in eADM-data i realtid för kunden. ID:n måste finnas i din miljö.

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

Användning: Avdelningsnummer enligt tillståndet ManagerOf id:

[REFERENCE;OrgUnitnr;Id;2;2100]

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

Läser behörigheterna för den aktuella användaren.

Förkortning för rollnamn:

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

Läser objektets historik för den aktuella användaren (logg från synkronisering/användargränssnitt).

Användning: ”Vem har beviljat denna behörighet?” i meddelandeflöden (ofta inbäddade i [SPLIT] / [REFERENCE]).

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

Exempel (konceptuellt): Alla användare med roll 501, CSV:

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

Utdata (dummy):

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

Användning: Chefsrapport inbäddad i e-postmeddelandets brödtext.

[DESCENDANTS;rootId;returnField;parentKey;foreignKey]

Användning: Alla underavdelningar som omfattas av en chefs behörighet.

[SYSTEM;type;id;field]

Användning: Kontaktuppgifter till systemägaren i administratörsmeddelandet.

[SELECTION;rulesetId;returnField]

Användning: E-postlista över alla som uppfyller reglerna för ”Nya medarbetare”.

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

Returnerar värden separerade med vertikalstreck för system eller roller som uppfyller kriterierna i regelsatsen ”Tillgänglig för” för den aktuella användaren.

Användning: Dynamiska urvalslistor i formulär eller meddelanden.

[AVAILABLEDEPARTMENTS;fields;targetUserId]

Användning: Visar en lista över avdelningar som en chef kan ansvara för (från ManagerOf, enhets-ID:n, roller i mega.eadm.no ).

[DATAOWNER;returnField]

Följer relationen mellan data och ägare för ett objekt; returnerar ett fält från ägaren.

[ANTECEDANTS.SYSTEMROLE;roleId;departmentId;returnField]

Chefer som innehar roleId på förfader avdelningarna inom departmentId.

Användning: Eskaleringsmejl när en underavdelning inom HR saknar lokal godkännare.

[COUNTEMPLOYEE] / [COUNTMEMBERS]

Utvärderas utifrån respektive avdelnings- eller gruppobjekt.

[GETLASTSYNCID]

Användning: Felsökning av sidfötter i administratörsmeddelanden.

[LASTVALUE;attributeName]

Det tidigare värdet för fältet från den senaste importen av HR- historiken, annars det aktuella fältet.

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

Befattningar (HR med flera befattningar)

Fältet ”Position” delar index över rörledningar: index 0 = första plats, 1 = sekund.

[POSITION;returnField;whereField;matchValue]

[POSITIONS;returnField;whereField;matchValue]

Samma som [POSITION] men returnerar en jämn rad med rör över alla positioner (tom plats där det inte finns någon matchning).

[GROUPPRIMARYPOSITION;returnField]

Val primär position: högst APositionPercentage, avgörande om tidigaste APositionStartDate.

[ACTIVEPOSITIONCOUNT;asOfDate]

Meddelandehantering och integration

[COUNTMESSAGESENT;messageId;fromDate]

Användning: Kontrollfrågan ”Har du redan fått besked?” i uppföljningsflödet.

[SYSTEMOWNER]

Kräver en historikrad från behörighetsändringen (behörighet att lägga till/redigera/ta bort).

Användning: CC-systemets ägare när automatisk behörighet beviljas.

[SYNCSTEPPARAMETER;key;companySyncStepId]

Åtkomst: Företagsadministratör i förhandsgranskningen av uttrycksbyggaren.

[APITOKEN;apiUsername]

Åtkomst: Företagsadministratör i förhandsgranskning. Använd endast i säkra flöden på serversidan.

HTML-hjälpfunktioner (meddelandemallar)

[HTMLLISTMEMBEROF;displayField]

För en användare som är gruppmedlem: visar överordnade grupper.

[HTMLLISTARRAY;list]

Kontroller för formulärmallar

Används i formulärmallar, inte i standardregelsatser.

Exempel på mönster: [INPUTBOX;1042;Avdeling;IT-100;] visar den inmatning som är märkt ”Avdeling” med standardvärdet IT-100.

Markörer [NOTIFY...], [HIDDEN...], [SERVERFUNCTION...] är beteendebaserade hooks, inte datafunktioner.

Scenarier från början till slut (fiktiva data)

Välkomstmejl – endast startdatum

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

Utdata: Ny ansatt Kari Nordmann starter 01.04.2026.

Rad om giltighetstidens utgång

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

Utdata: Gyldig til: Permanent tilgang

Chef saknas — eskalera till chefen på överordnad avdelning

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

Anpassa kombinationen IFEMPTYUSE/EXISTS så att den stämmer överens med syftet med din mall; testa i uttrycksbyggaren.

Endast ny tjänst — mottagare av meddelandet

Efter synkroniseringen läggs följande till POS-02:

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

Utdata: E-postadress till chefen för den nya tjänstens enhet (exempel: ny-leder@eksempel.kommune.no).

Namn på automatisk säkerhetsgrupp (kundkonfiguration)

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

Utdata: SG-IT og digitalisering-IT-100 (det exakta CLEAN-utgångssignalet kan variera).

Exportmappning — samAccountName

[UserName]

Utdata: kari.nordmann

Regelsats – användaren har en roll i systemet

Uttryck för regelattribut :

[OBJECTPERMISSION.SYSTEMROLE;Name;SystemRoleId;501]

Beräknat värde: Bruker Fagsystem X — jämförelseoperator Eller liknande / medlemsföretag.

Uttrycksbyggare

Felsökning

Snabbindex

Anteckningar om AI-assistenten

1. Föredra [DisplayName]-fält innan de placeras i funktioner.

2. Fråga var uttrycket finns: regeluppsättning, meddelande, export eller kundkonfiguration.

3. Ersätt platshållar-ID:n (501, 2100) med kundens verkliga systemroll och avdelning ID:n från systemåtkomst.

4. Om man använder ett positionsfilter vid import utesluts träffar; i synkroniseringsstegets regeluppsättning inkluderas träffar.

5. Händelsemeddelandeflöden kräver objekthistorik från en synkroniseringskörning.

6. Skapa kapslade exempel ut och in — förutom [ARRAYFOREACH...], som binder ??? per element innan mallfunktionerna körs.

7. Använd inte inbäddning [ARRAYFOREACH...]; använd anrop till syskonobjekt eller [ARRAYJOIN].

8. Termer: regelsätt (Regelsett), meddelandeflöde (meldingsflyt), systemåtkomst (systemtilgang), behörighet (tilgang), objekthistorik (objekthistorikk).

Senast uppdaterad: 19 juni 2026