eADM-motor for regeluttrykk

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 tillatelseskjede (leses fra innsiden og ut):

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

1. Tillatelse → 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 tillatelsesstart 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 tillatelsessø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 tillatelsen 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 gitt denne tillatelsen?» 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 tillatelse.

[SYSTEM;type;id;field]

Bruk: Kontaktinformasjon for systemeier i administrasjonsvarsel.

[SELECTION;rulesetId;returnField]

Bruk: Adresseliste 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]

Bruk: «Allerede varslet?»-kontroll i oppfølgingsprosessen.

[SYSTEMOWNER]

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

Bruk: CC-systemets eier når automatisk tillatelse 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 innspill 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 tillatelse

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 (eksempel: 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

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. Begreper: regelsett, meldingsflyt, systemtilgang, tilgang, objekthistorikk.

Sist oppdatert: 19. juni 2026