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, ”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 med 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]

Utelämnat messageId: Om meddelandemallens ID inte anges ([COUNTMESSAGESENT;] är lika med 0), utvärderas uttrycket i sammanhanget för den meddelandemall vars avsändning utlöste regeluppsättningen. Med andra ord tolkas det som ”har det meddelande som just nu skickas redan skickats till denna mottagare?”, inte som något enskilt fast mall-ID. Tack vare detta kan samma regeluppsättning återanvändas som skydd mot dubbelutskick för flera olika meddelandemallar, istället för att skapa en separat regeluppsättning för varje mall.

Användning: Säkerhetskontrollen ”Har du redan fått ett meddelande?” i uppföljningsflödet; gemensam säkerhetskontroll mot dubbelutskick i flera meddelandemallar.

[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 enheten där den nya tjänsten ska tillsättas (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

Två inmatningssätt för ett värde i ett regelvillkor

Varje villkorsrad på fliken ”Regler” i en regeluppsättning har ett fält för ”Attribut” (eller ”Argument”) med två små ikoner som växlar mellan olika inmatningslägen:

• Rullgardinsläge (ikonen med upp- och nedpilar) — standardinställningen. Visar en sökbar rullgardinsmeny med objektets attributvärden, grupperade efter typ (användar-, grupp-, avdelnings- eller formulärattribut, beroende på vad regeluppsättningen används till).

• Fritt textläge (tangentbordsikon) — ändrar fältet till en vanlig textruta. Använd detta för att skriva in fast kodad text eller ett funktionsuttryck med hjälp av den parentesbaserade syntaxen som beskrivits tidigare i den här artikeln, t.ex. [COUNTMESSAGESENT;7166].

Även i fritextläget finns funktionen för automatisk komplettering: när man skriver in en del av ett funktions- eller fältnamn (t.ex. [count) ytor med motsvarande egenskaper och funktioner, till exempel [COUNTEMPLOYEE], [COUNTMEMBERS], och [COUNTMESSAGESENT;message id].

Testa ett uttryck med ”Redigera uttryck”

När ett villkorsfält är i fritextläge kan du klicka på en extra ikon bredvid fältet för att öppna dialogrutan ”Redigera uttryck ”. Använd den för att testa ett funktionsuttryck mot ett verkligt objekt innan du sparar regeln.

I dialogrutan visas följande:

• Objekttyp – regelsatsens primära objekttyp (t.ex. Användare) och vilka sekundära sammanhang som finns tillgängliga (Funktion, Funktionsalias, Händelse, Historik).

• Sammanhang – ett testobjekt som utvärderingen ska baseras på. Använd Sök för att välja ett specifikt objekt, eller Välj slumpmässigt för att låta eADM välja ett.

• Uttryck — ett redigerbart textfält som redan är ifyllt med villkorets aktuella uttryck.

• Resultat — det utvärderade resultatet, som visas efter att man har klickat på ”Execute”.

När du redigerar och håller muspekaren över en funktion i uttrycket visas ett hjälptips med funktionens fullständiga syntax, en kort beskrivning och betydelsen av varje parameter. Hjälptipset markerar hela uttrycket i grönt och visar den del som motsvarar den aktuella markörpositionen i fetstil, vilket gör det betydligt enklare att navigera i långa eller djupt kapslade uttryck.

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. [COUNTMESSAGESENT;] med messageId ”omitted” utvärderas mot den meddelandemall som just nu skickas, vilket innebär att en regeluppsättning kan styra flera meddelandemallar – men förhandsgranskningen fungerar inte utanför en faktisk sändning.

9. Det finns två sätt att ange värdet för ett regelvillkor: via rullgardinsmenyn (attributväljare) eller med fri text (tangentbordsikonen, fast angiven text eller uttryck), där alternativet ”Redigera uttryck” är tillgängligt i fritxtläget för att testa mot ett exempelobjekt.

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

Senast uppdaterad: 29 juli 2026