eADM-motor for regeluttrykk

Oversikt

Regeluttrykkmotoren utfører parentesfunksjoner og feltplassholdere i eADM. Uttrykk forekommer i:

Slik fungerer evalueringen

1. Motoren søker etter uttrykket [...] tokens.

2. [ARRAYFOREACH...] kjører først — før «innermost-first»-gjennomgangen — så malplassholdere ??? og ???i bind per element adskilt med vertikalt strek.

3. Ellers tolkes det innerste parentesparet først.

4. Hver funksjon returnerer et resultat i ren tekst som erstatter parentesen.

5. Når det ikke er flere funksjoner igjen, gjenstår [FieldName] tokens erstattes fra nåværende objekt (og valgfritt historikk-rad i meldingsflyt).

6. Feltnavn som ikke gjenkjennes, beholdes som bokstavelige uttrykk [FieldName] i utdataene.

Lister adskilt med pipe-tegn (|) brukes til data med flere verdier — spesielt innen HR stillinger på en bruker.

Eksempeldata brukt i eksemplene nedenfor

Med mindre annet er angitt, forutsetter eksemplene at kunden er Eksempel kommune med:

Objekttype-ID-er (for oppslag): Bruker=1, Avdeling=2, Gruppe=3, API-bruker=14.

Syntakskonvensjoner

• Funksjoner: [NAME;arg1;arg2;...] — argumenter atskilt med semikolon (;).

• Felt: [FieldName] — verdien fra det aktuelle objektet (skiller ikke mellom store og små bokstaver).

• Innebygde uttrykk: de indre parentesene tolkes før de ytre.

• Listeskilletegn: rørtegn | (vertikal strek) mellom verdiene — f.eks. POS-01|POS-02. Skriv aldri en tilbakeslag; | forekommer kun som Markdown-escaping i kildefilene, ikke i uttrykk.

• Datoer i felter lagres ofte som dd.MM.yyyy HH:mm:ss; import kan bruke yyyy-MM-dd og andre vanlige formater.

Spørsmålsspråk

Brukes innendørs [FOREACH], [IFTHENELSE], og avansert [OBJECT...] filtre.

Sett følgende foran dataene: object., system., systemrole., objectpermission., osv.

Reirbygging

Først det indre feltet, deretter den ytre funksjonen

Blokkeres hvis det indre feltet mangler: [SUBSTRING;0;10;[UnknownField]] forblir uendret når UnknownField finnes ikke på objektet.

Typisk Rettighetskjede (leses fra innsiden og ut):

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

1. Rettighet → avdelings-ID 2100

2. Avdeling → bruker-ID for leder

3. Bruker → visningsnavn for leder

[ARRAYFOREACH...] er annerledes: den utvider en liste med skilletegn som er rørtegn før indre funksjoner i malen. Bruk ??? for det aktuelle elementet og ???i på grunn av den 0-baserte indekseringen. Reirbygging [ARRAYFOREACH...] inne i en annen [ARRAYFOREACH...] støttes ikke — bruk [ARRAYJOIN] / [ARRAYPREFIX] eller i stedet ringe søsknene sine.

Tilgangsnivåer

Automatisering (synkronisering, meldinger, eksport) utfører uttrykk med serverrettigheter. En funksjon som fungerer i produksjonsmiljøet, kan likevel være blokkert i uttrykksbyggeren for din rolle.

Plassholdere for felt

Ikke funksjoner — erstattet fra det gjeldende objektet (eller historikkraden i hendelsesdrevne meldingsstrømmer).

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

Kun historikk (meldinger vises etter synkronisering): [OldValue], [NewValue], [EntryType], [AttributeName], [Comment].

Funksjonsoversikt med eksempler

Hver oppføring inneholder parametere, et eksempel med testdata og forventet resultat.

Dato og klokkeslett

[NÅ] / [NOW]

Returnerer dato og klokkeslett på serveren.

Bruk: Visning av Rettighetsstart og relative frister i maler.

[DATEFORMAT;date;format]

Omformaterer en datostreng.

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

[DATEDIFF;date1;date2;unit]

Numerisk forskjell mellom to datoer.

Bruk: Kontroll av ansettelsestid i regelsett, «dager til oppstart» i meldinger.

[DAYOFYEAR;date]

Bruk: Sesongbaserte regler, triks for regnskapsperioden.

Strengmanipulering

[SUBSTRING;start;length;text]

Bruk: Bare dato fra dato og klokkeslett i velkomstmeldinger: [SUBSTRING;0;10;[Start]] → 01.04.2026.

[SPLIT;text;delimiter;index]

Bruk: Hilsen fra feltet for sammensatt navn; velg koden for siste posisjon.

[REPLACE;text;find;replace]

Bruk: Normaliser telefonnumre, bytt om skilletegn i brukernavn.

[REPLACELIST;text;fromChars;toChars]

Tegn-for-tegn-tilordning (begge tegnlistene må ha samme lengde).

Bruk: Rettelser av eldre tegnsett ved import.

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

Bruk: Rydd opp i rørlistene etter [ARRAYDIFF].

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

Bruk: Ansattnumre med fast bredde i filutførsler.

[RIGHT;length;text]

Bruk: De siste sifrene i personnummeret i testmiljøer.

[INITIALS;text;startWord;endWord]

Bruk: Kortkoder i gruppenavn eller e-postaliaser.

[PRETTIFY;text]

Store bokstaver etter mellomrom eller bindestrek.

Bruk: Vis navn i meldinger når HR sender med store bokstaver.

[LOWER;text] / [UPPER;text]

Bruk: Normaliser før [CLEAN] i reglene for brukernavn.

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

Fjern eller erstatt tegn som ikke er tillatt i brukernavn, strenge ID-er eller AD-fellesnavn (CN).

Det nøyaktige resultatet avhenger av kundens tegnregler; test i uttrykksbyggeren.

[GETKEYVALUE;key;delimiter;metadata]

Leser key<delimiter>value par innenfor en metadatastreng adskilt med pipe-tegn.

Bruk: Tilpassede importmetadata for utvidelsesattributter.

Logikk og kontrollflyt

[IFTHENELSE;query;thenValue;elseValue]

Bruk: Én mal for ulike objekttyper.

[IFEMPTYUSE;primary;fallback;reversed]

Bruk: Standardtekst ved manglende utløpsdato, ansvarlig eller kommentar.

[EXISTS;value;resultIfNonEmpty]

Bruk: Nestede oppslag i Gate — utføres kun [REFERENCE...] når [Manager] er angitt.

[TRANSFORM;input;mapping...]

Bruk: HR-koder → vis tekst i meldinger.

[CONTAINS;valueList;targetList;ifYes;ifNo]

Bruk: Forgrening i stil med «Ruleset» inne i en mal.

Operasjoner med matriser (adskilt med vertikale streker)

Lister ser slik ut A|B|C. Mange stillingsbeskrivelser innen HR bruker denne formen.

[COUNT;ignored;list]

Bruk: «Hvor mange stillinger har denne brukeren?»

[ARRAYAPPEND;list1;list2]

Bruk: Slå sammen rollelister fra to Rettighetssøk.

[ARRAYUNIQUE;list]

Bruk: Fjern duplikater av avdelings-ID-er før eksport.

[ARRAYFILTER;list;allowed]

Beholder kun elementer som forekommer i allowed.

Bruk: Legg inn posisjonstyper på hvitelisten for en melding.

[ARRAYDIFF;current;previous]

Elementer i current ikke i previous.

Bruk: Oppdage ny stilling i meldingsflyten (sammen med [LASTVALUE;APositionCodeId]). Advarsel: upålitelig hvis flere posisjoner endres i én import.

[ARRAYJOIN;list1;list2]

Sammenføyer to lister etter indeks.

Bruk: Kombiner parallelle kolonner for eksportlinjer i CSV-format.

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

Går gjennom en skilt med komma liste. For hvert element som ikke er tomt, erstatter ??? sammen med elementet og ???i med sin 0-baserte indeks i malen, evaluerer nestede [...] i malen, og slår deretter sammen resultatene.

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

Ikke støttet: [ARRAYFOREACH...] innleiret i en annen [ARRAYFOREACH...] — uttrykket kan ikke evalueres. Bruk to påkallinger på samme nivå, eller [ARRAYJOIN] i stedet.

Bruk: Formater hver posisjon som en egen linje i en melding; legg til et prefiks for hver enhets-ID ved eksport.

[ARRAYPREFIX;list;mode;text]

Bruk: Eksterne ID-er i navnerommet.

[ARRAYTRIM;list;delimiter;maxCount]

Bruk: Kun de første N posisjonene i en oppsummerings-e-post.

[PRUNEARRAY;list;regex;reverse]

Bruk: Fjern midlertidige posisjonskoder fra eksporten.

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

Sammenføyer parallelle lister rad for rad til rader med mellomrom og vertikale streker.

Bruk: Tekstblokker med flere kolonner i rapporter.

Tilfeldighet, hash, unikhet

[RND;min;max]

Bruk: Billettnumre i testmaler.

[STRRND;minLen;maxLen;chars]

Bruk: Engangskoder når passordregelen ikke brukes.

[PASSWORD;ruleId]

Bruk: Opprinnelig passord i velkomstmeldingen — håndter det forsiktig.

[HASH;text]

Bruk: Ugjennomsiktige token i lenker (ikke kun til sikkerhetskritisk hashing).

[UNIQUE;base;fieldName;replacement]

Sikrer base ikke allerede finnes i fieldName på et annet objekt; legger til 2, 3, … eller innsatser før replacement.

Bruk: Kundeoppsett uttrykk for brukernavn sammen med [CLEAN] / [LOWER].

Databaseoppslag og relasjoner

Disse leser inn sanntids eADM-data for kunden. ID-ene må finnes i ditt miljø.

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

Bruk: Avdelingsnummer fra Rettighetn ManagerOf id:

[REFERENCE;OrgUnitnr;Id;2;2100]

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

Leser tilgangsrettighetene til den aktuelle brukeren.

Forkortelse for rollenavn:

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

Henter objekthistorikken for den aktuelle brukeren (logg fra synkronisering/brukergrensesnitt).

Bruk: «Hvem har tildelt denne Rettighetn?» i meldingsflyt (ofte innebygd i [SPLIT] / [REFERENCE]).

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

Eksempel (konseptuelt): Alle brukere med rolle 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

Bruk: Lederrapport innebygd i e-postteksten.

[DESCENDANTS;rootId;returnField;parentKey;foreignKey]

Bruk: Alle underavdelinger som omfattes av en leders Rettighet.

[SYSTEM;type;id;field]

Bruk: Kontaktinformasjon for systemeier i administrasjonsvarsel.

[SELECTION;rulesetId;returnField]

Bruk: E-postliste over alle som oppfyller reglene i regelsettet «Nye ansatte».

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

Returnerer verdier atskilt med vertikalt strek for systemer eller roller som oppfyller «Tilgjengelig for »-regelsettet for den aktuelle brukeren.

Bruk: Dynamiske utvalgslister i skjemaer eller meldinger.

[AVAILABLEDEPARTMENTS;fields;targetUserId]

Bruk: Viser avdelinger som en leder kan ha ansvar for (fra «ManagerOf», enhets-ID-er, roller i «mega.eadm.no» ).

[DATAOWNER;returnField]

Følger data-eier-relasjonen på objektet; returnerer feltet fra eieren.

[ANTECEDANTS.SYSTEMROLE;roleId;departmentId;returnField]

Ledere som har roleId på forfader avdelinger i departmentId.

Bruk: Eskalerings-e-post når en underavdeling i HR ikke har noen lokal godkjenner.

[COUNTEMPLOYEE] / [COUNTMEMBERS]

Vurderes henholdsvis på avdelings- eller gruppenivå.

[GETLASTSYNCID]

Bruk: Feilsøking av bunntekster i administrasjons-e-poster.

[LASTVALUE;attributeName]

Forrige verdi i feltet fra siste import av HR- historikk, ellers gjeldende felt.

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

Stillinger (HR med flere stillinger)

Feltposisjoner deler indeks på tvers av rør: indeks 0 = første posisjon, 1 = sekund.

[POSITION;returnField;whereField;matchValue]

[POSITIONS;returnField;whereField;matchValue]

Det samme som [POSITION] men returnerer en jevnt innrettet rørstreng på tvers av alle posisjoner (tom plass der det ikke er noe treff).

[GROUPPRIMARYPOSITION;returnField]

Valg primær posisjon: høyest APositionPercentage, tie-break etter tidligste APositionStartDate.

[ACTIVEPOSITIONCOUNT;asOfDate]

Meldinger og integrasjon

[COUNTMESSAGESENT;messageId;fromDate]

Utelatt messageId: Hvis ID-en til meldingsmalen ikke er oppgitt ([COUNTMESSAGESENT;] er lik 0), blir uttrykket evaluert i sammenheng med den meldingsmalen hvis sending utløste regelsettet. Med andre ord tolkes det som «har meldingen som nå sendes, allerede blitt sendt til denne mottakeren?», og ikke som en bestemt, fast mal-ID. På grunn av dette kan det samme regelsettet gjenbrukes som beskyttelse mot duplikatutsendelser for flere ulike meldingsmaler, i stedet for å opprette et eget regelsett for hver enkelt mal.

Bruk: «Allerede varslet?»-sjekk i oppfølgingsprosessen; felles sjekk for å unngå dobbeltutsendelse på tvers av flere meldingsmaler.

[SYSTEMOWNER]

Krever en historikkoppføring fra endringen av Rettighetn (Rettighet til å legge til/redigere/slette).

Bruk: CC-systemets eier når automatisk Rettighet gis.

[SYNCSTEPPARAMETER;key;companySyncStepId]

Tilgang: Bedriftsadministrator i forhåndsvisning av uttrykksbyggeren.

[APITOKEN;apiUsername]

Tilgang: Bedriftsadministrator i forhåndsvisning. Brukes kun i sikrede serverbaserte arbeidsflyter.

HTML-hjelpefunksjoner (meldingsmaler)

[HTMLLISTMEMBEROF;displayField]

For en bruker som er medlem av en gruppe: viser overordnede grupper.

[HTMLLISTARRAY;list]

Kontroller for skjemaer

Brukes i skjemaer, ikke i standardregelsett.

Eksempel på mønster: [INPUTBOX;1042;Avdeling;IT-100;] viser inndata merket «Avdeling» med standardverdien IT-100.

Markører [NOTIFY...], [HIDDEN...], [SERVERFUNCTION...] er atferdskroker, ikke datafunksjoner.

Scenarier fra start til slutt (fiktive data)

Velkomst-e-post – kun startdato

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

Utdata: Ny ansatt Kari Nordmann starter 01.04.2026.

Linje for utløp av Rettighet

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

Utdata: Gyldig til: Permanent tilgang

Leder fraværende — eskaler til avdelingsleder på overordnet nivå

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

Juster kombinasjonen IFEMPTYUSE/EXISTS slik at den samsvarer med formålet med malen din; test i uttrykksbyggeren.

Kun ny stilling — mottaker av meldingen

Etter synkronisering legges det til POS-02:

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

Utdata: E-postadresse til lederen for avdelingen som den nye stillingen tilhører (fiktiv: ny-leder@eksempel.kommune.no).

Navn på automatisk sikkerhetsgruppe (konfigurert av kunden)

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

Utdata: SG-IT og digitalisering-IT-100 (det faktiske CLEAN-utgangssignalet kan variere).

Eksportkartlegging — samAccountName

[UserName]

Utdata: kari.nordmann

Regelsett — brukeren har en rolle i systemet

Uttrykk for regelattributt :

[OBJECTPERMISSION.SYSTEMROLE;Name;SystemRoleId;501]

Beregnet verdi: Bruker Fagsystem X — sammenligningsoperatør Er lik / medlemsoperatører.

Uttrykksgenerator

To inndatamåter for verdien til et regelbetingelse

Hver betingelsesrad i fanen «Regler» i et regelsett har et «Attributt»- (eller «Argument»-) felt med to små ikoner som brukes til å bytte mellom inntastingsmodusene:

• Nedtrekksmodus (ikon med opp-/nedpiler) — standardinnstillingen. Viser en søkbar nedtrekksliste med objektets attributtverdier, gruppert etter type (bruker-, gruppe-, avdelings- eller skjemattributter, avhengig av hva regelsettet brukes sammen med).

• Fri tekst-modus (tastaturikon) — endrer feltet til et vanlig tekstfelt. Bruk dette til å skrive inn fastkodet tekst eller et funksjonsuttrykk ved hjelp av parentes-syntaksen som er beskrevet tidligere i denne artikkelen, f.eks. [COUNTMESSAGESENT;7166].

Fritt tekst-modus har fortsatt funksjonen for automatisk fullføring: når du skriver inn en del av et funksjons- eller feltnavn (f.eks. [count) overflater med tilsvarende egenskaper og funksjoner, for eksempel [COUNTEMPLOYEE], [COUNTMEMBERS], og [COUNTMESSAGESENT;message id].

Teste et uttrykk med «Rediger uttrykk»

Når et betingelsesfelt er i fritekstmodus, kan du klikke på et ekstra ikon ved siden av det for å åpne dialogboksen «Rediger uttrykk ». Bruk denne til å teste et funksjonsuttrykk mot et reelt objekt før du lagrer regelen.

Dialogboksen viser:

• Objekttype — regelsettets primære objekttype (f.eks. Bruker) og hvilke sekundære kontekster som er tilgjengelige (Funksjon, Funksjonsalias, Hendelse, Historikk).

• Kontekst — et testobjekt som skal brukes som sammenligningsgrunnlag. Bruk «Søk» for å velge et bestemt objekt, eller «Velg tilfeldig» for å la eADM velge et.

• Uttrykk — et redigerbart tekstfelt som allerede er fylt ut med betingelsens gjeldende uttrykk.

• Resultat — det utregnede resultatet, som vises etter at du har klikket på «Utfør».

Når du redigerer, vises det et hjelpetips med fullstendig syntaks for funksjonen, en kort beskrivelse og betydningen av hver parameter når du holder musepekeren over en funksjon i uttrykket. Hjelpetipset markerer hele uttrykket i grønt og viser den delen som tilsvarer den aktuelle markørposisjonen i fet skrift, noe som gjør det betydelig enklere å finne frem i lange eller dypt innkapslede uttrykk.

Feilsøking

Hurtigindeks

Notater fra AI-assistenten

1. Foretrekker [DisplayName]-felter før de innrammes i funksjoner.

2. Spør hvor uttrykket befinner seg: regelsett, melding, eksport eller kundeoppsett.

3. Erstatt plassholder-ID-er (501, 2100) med kundens virkelige systemrolle og avdeling ID-er fra systemtilgang.

4. Når man bruker et posisjonsfilter ved import, blir treffene ekskludert; i regelsettet for synkroniseringstrinnet inkluderes treffene.

5. Hendelsesmeldingsstrømmer trenger objekthistorikk fra en synkroniseringskjøring.

6. Lag eksempler med innleirede elementer innvendig-utvendig — bortsett fra [ARRAYFOREACH...], som binder seg til ??? per element før malfunksjonene kjøres.

7. Ikke bruk innleirede elementer [ARRAYFOREACH...]; bruk søskenoppkall eller [ARRAYJOIN].

8. [COUNTMESSAGESENT;] med messageId «omitted» vurderes opp mot den meldingsmalen som sendes akkurat nå, slik at ett regelsett kan styre flere meldingsmaler — men forhåndsvisningen vil ikke fungere utenfor en faktisk sending.

9. Det finnes to måter å angi verdien for et regelbetingelse på: nedtrekksmeny (attributtvelger) eller fritekst (tastaturikon, fastkodet tekst eller uttrykk), og i fritekstmodus er «Rediger uttrykk» tilgjengelig for å teste mot et eksempelobjekt.

10. Begreper: regelsett, meldingsflyt, systemtilgang, tilgang, objekthistorikk.

Sist oppdatert: 29. juli 2026