eADM-sääntöjen ilmaisuohjelma

eADM-sääntöjen ilmaisuohjelma

Yleiskatsaus

Sääntöilmaisuja käsittelevä moottori arvioi eADM:ssä sulkeisfunktiot ja kenttäpaikkamerkit. Ilmaisuja esiintyy seuraavissa:

Arvioinnin kulku

1. Moottori etsii lausekkeesta [...] poletteja.

2. [ARRAYFOREACH...] suoritetaan ensin — ennen ”innermost-first”-kierrosta — joten mallipohjien paikkamerkit ??? ja ???i määritetään jokaiselle putkilla erotetulle elementille.

3. Muussa tapauksessa se ratkaisee ensin sisimmän sulkuparin.

4. Jokainen funktio palauttaa tekstimuotoisen tuloksen, joka korvaa sulun.

5. Kun toimintoja ei ole enää jäljellä, jäljellä olevat [FieldName] merkit korvataan nykyinen objekti (ja valinnainen historiarivi (viestivirroissa).

6. Tunnistamattomat kenttänimet säilyvät kirjaimellisina [FieldName] tulostuksessa.

Putkilla erotetut luettelot (|) käytetään moniarvoisissa tiedoissa — erityisesti henkilöstöhallinnossa tehtävät käyttäjälle.

Seuraavissa esimerkeissä käytetyt tekaistut tiedot

Ellei toisin mainita, esimerkeissä oletetaan, että asiakas on Eksempel kommune, jolla on:

Objektityyppien tunnisteet (hakua varten): Käyttäjä=1, Osasto=2, Ryhmä=3, API-käyttäjä=14.

Syntaksin säännöt

• Toiminnot: [NAME;arg1;arg2;...] — puolipisteellä erotetut argumentit (;).

• Kentät: [FieldName] — nykyisen objektin arvo (kirjainkokoa ei huomioida).

• Sisäkkäiset lausekkeet: sisemmät sulkeet tulkitaan ennen ulompia.

• Luettelon erottimena: putkimerkki | (pystysuora viiva) arvojen välissä — esim. POS-01|POS-02. Älä koskaan kirjoita kauttaviivaa; | esiintyy vain Markdown-merkintöjen pakotuksena lähdetiedostoissa, ei lausekkeissa.

• Kenttien päivämäärät tallennetaan usein muodossa dd.MM.yyyy HH:mm:ss; tuonnissa voidaan käyttää yyyy-MM-dd ja muut yleiset tiedostomuodot.

Kyselykieli

Sisäkäyttöön [FOREACH], [IFTHENELSE], ja edistyneitä [OBJECT...] suodattimet.

Lisää tietojen eteen etuliite object., system., systemrole., objectpermission., jne.

Pesintä

Ensin sisempi kenttä, sitten ulompi funktio

Estetty, jos sisäinen kenttä puuttuu: [SUBSTRING;0;10;[UnknownField]] pysyy muuttumattomana, kun UnknownField ei ole kohteessa.

Tyypillinen käyttöoikeusketju (luetaan sisältä ulospäin):

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

1. Lupa → osaston tunnus 2100

2. Osasto → esimiehen käyttäjätunnus

3. Käyttäjä → esimiehen näyttönimi

[ARRAYFOREACH...] on erilainen: se laajentaa putkilla erotetun luettelon ennen mallin sisäiset funktiot suoritetaan. Käytä ??? kyseisen elementin osalta ja ???i koska sen indeksi alkaa nollasta. Pesintä [ARRAYFOREACH...] toisen sisällä [ARRAYFOREACH...] ei ole tuettu — käytä [ARRAYJOIN] / [ARRAYPREFIX] tai soittaa sen sijaan sisaruksille.

Käyttöoikeustasot

Automaatio (synkronointi, viestit, vienti) arvioi lausekkeet palvelimen käyttöoikeuksilla. Toiminto, joka toimii tuotantoympäristössä, voi silti olla estetty roolisi lausekkeenmuodostimessa.

Kenttien paikkamerkit

Ei funktioita — korvataan nykyisestä objektista (tai tapahtumapohjaisten viestivirtojen historiarivistä ).

Esimerkki: Malli Hello [GivenName] [Surname] Kari Nordmannista → Hello Kari Nordmann

Vain historia (viestit näkyvät synkronoinnin jälkeen): [OldValue], [NewValue], [EntryType], [AttributeName], [Comment].

Toiminto-opas esimerkkeineen

Jokaisessa kohdassa on lueteltu parametrit, esimerkki, jossa on käytetty testitietoja, sekä odotettu tulos.

Päivämäärä ja kellonaika

[NÅ] / [NOW]

Palauttaa palvelimen päivämäärän ja kellonajan.

Käyttö: Luvan alkamispäivän näyttö, mallien suhteelliset määräajat.

[DATEFORMAT;date;format]

Muuntaa päivämäärämerkkijonon uuteen muotoon.

Käyttö: Vientimuodot, ISO-päivämäärät API-viestien sisällössä.

[DATEDIFF;date1;date2;unit]

Kahden päivämäärän välinen numeerinen ero.

Käyttö: Tenure-tarkistukset sääntöjoukoissa, ”päiviä alkuun” viesteissä.

[DAYOFYEAR;date]

Käyttö: Kausittaiset säännöt, tilikauden erikoisjärjestelyt.

Merkkijonojen käsittely

[SUBSTRING;start;length;text]

Käyttö: Tervetuloviesteissä päivämäärä ilman kellonaikaa: [SUBSTRING;0;10;[Start]] → 01.04.2026.

[SPLIT;text;delimiter;index]

Käyttö: Tervehdys yhdistetyistä nimikentistä; valitse viimeinen sijaintikoodi.

[REPLACE;text;find;replace]

Käyttö: Puhelinnumeroiden muotoileminen, erottimien vaihtaminen käyttäjätunnuksissa.

[REPLACELIST;text;fromChars;toChars]

Merkkikohtainen vastaavuustaulukko (molempien merkkijonojen on oltava samanpituisia).

Käyttö: Vanhojen merkistöjen korjaukset tuontitoiminnoissa.

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

Käyttö: Puhdista putkiluettelot sen jälkeen, kun [ARRAYDIFF].

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

Käyttö: Kiinteän pituiset työntekijänumerot tiedostojen viennissä.

[RIGHT;length;text]

Käyttö: Kansallisen henkilötunnuksen viimeiset numerot testausympäristöissä.

[INITIALS;text;startWord;endWord]

Käyttö: Lyhytkoodit ryhmien nimissä tai sähköpostin aliaksissa.

[PRETTIFY;text]

Isot alkukirjaimet välilyönnin tai yhdysmerkin jälkeen.

Käyttö: Näytä nimet viesteissä, kun HR lähettää viestejä isoilla kirjaimilla.

[LOWER;text] / [UPPER;text]

Käyttö: Normalisoi ennen [CLEAN] käyttäjätunnuksen sääntöissä.

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

Poista tai korvaa merkit, jotka eivät sovellu käyttäjätunnuksiin, tiukasti määriteltyihin tunnisteisiin tai AD:n yleisnimiin (CN).

Tarkka tulos riippuu asiakkaan merkkisäännöistä; testaa ilmaisurakentajassa.

[GETKEYVALUE;key;delimiter;metadata]

Lukukerrat key<delimiter>value parit putkimerkillä erotetussa metatietojonossa.

Käyttö: Mukautetut tuontimetatiedot laajennuksen attribuuteissa.

Logiikka ja ohjausvirta

[IFTHENELSE;query;thenValue;elseValue]

Käyttö: Yksi malli eri objektityyppien yhdistelmälle.

[IFEMPTYUSE;primary;fallback;reversed]

Käyttö: Oletusteksti, jos voimassaolon päättymispäivä, vastuuhenkilö tai kommentti puuttuu.

[EXISTS;value;resultIfNonEmpty]

Käyttö: Porttiin upotetut hakutoiminnot — suoritetaan vain [REFERENCE...] kun [Manager] on asetettu.

[TRANSFORM;input;mapping...]

Käyttö: HR-koodit → tekstin näyttäminen viesteissä.

[CONTAINS;valueList;targetList;ifYes;ifNo]

Käyttö: Ruleset-tyyppinen haarautuminen mallin sisällä.

Taulukon (putkilla erotetut) operaatiot

Luettelot näyttävät tältä A|B|C. Monissa henkilöstöhallinnon tehtävissä käytetään tätä mallia.

[COUNT;ignored;list]

Käyttö: ”Kuinka monta tehtävää tällä käyttäjällä on?”

[ARRAYAPPEND;list1;list2]

Käyttö: Yhdistä kahden käyttöoikeuskyselyn rooliluettelot.

[ARRAYUNIQUE;list]

Käyttö: Poista osastotunnisteiden päällekkäisyydet ennen vientiä.

[ARRAYFILTER;list;allowed]

Säilyttää vain ne kohteet, jotka esiintyvät allowed.

Käyttö: Viestin sijaintityyppien lisääminen sallittujen luetteloon.

[ARRAYDIFF;current;previous]

Tuotteet kohdassa current ei sisällä previous.

Käyttö: Tunnista uusi tehtävä viestivirrassa (yhdessä [LASTVALUE;APositionCodeId]). Varoitus: epäluotettava, jos useita asemia muuttuu yhdellä tuonnilla.

[ARRAYJOIN;list1;list2]

Yhdistää kaksi luetteloa indeksin avulla.

Käyttö: Yhdistä rinnakkaiset sarakkeet CSV-tyylisten vientirivien muodostamiseksi.

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

Käy läpi a:n putkilla erotettu luettelo. Jokaisen ei-tyhjän elementin kohdalla korvataan ??? elementin kanssa ja ???i mallissa, jossa indeksi alkaa nollasta, arvioi sisäkkäiset [...] mallissa ja yhdistää sitten tulokset.

Tyhjät putkiosat ovat ohitettu (sama käytäntö kuin [ARRAYUNIQUE] / [ARRAYPREFIX]).

Ei tueta: [ARRAYFOREACH...] sisäkkäin toisen sisällä [ARRAYFOREACH...] — lausekkeen arviointi epäonnistuu. Käytä kahta rinnakkaista kutsua tai [ARRAYJOIN] sen sijaan.

Käyttö: Muotoile kukin sijainti omaksi rivikseen viestissä; lisää jokaisen yksikön tunnisteen eteen etuliite vientiä varten.

[ARRAYPREFIX;list;mode;text]

Käyttö: Nimitilan ulkoiset tunnisteet.

[ARRAYTRIM;list;delimiter;maxCount]

Käyttö: Vain N ensimmäistä sijaa yhteenvetosähköpostissa.

[PRUNEARRAY;list;regex;reverse]

Käyttö: Poista väliaikaiset sijaintikoodit viennistä.

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

Yhdistää rinnakkaiset luettelot rivikohtaisesti välilyönnillä ja putkimerkillä yhdistetyiksi riveiksi.

Käyttö: Monisarakkeiset tekstikappaleet raporteissa.

Satunnaisuus, hajautus, ainutlaatuisuus

[RND;min;max]

Käyttö: Lippujen numerot testimalleissa.

[STRRND;minLen;maxLen;chars]

Käyttö: Kertakäyttöiset koodit, kun salasanasääntöä ei käytetä.

[PASSWORD;ruleId]

Käyttö: Aloitussalasana tervetuloviestissä — käsittele sitä huolellisesti.

[HASH;text]

Käyttö: Läpinäkymättömät tunnisteet linkeissä (ei pelkästään turvallisuuden kannalta kriittiseen hajautukseen).

[UNIQUE;base;fieldName;replacement]

Varmistaa base ei ole vielä olemassa fieldName toiseen kohteeseen; liittää 2, 3, … tai ennen replacement.

Käyttö: Asiakkaan asetukset käyttäjätunnuksen ilmaisu yhdessä [CLEAN] / [LOWER].

Tietokantahaku ja suhteet

Nämä lukevat asiakkaan reaaliaikaisia eADM-tietoja. Tunnisteiden on oltava olemassa ympäristössäsi.

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

Käyttö: Luvan osastonumero ManagerOf id:

[REFERENCE;OrgUnitnr;Id;2;2100]

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

Lukee nykyisen käyttäjän käyttöoikeudet.

Roolin nimen lyhenne:

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

Lukee nykyisen käyttäjän objektien historian (synkronoinnin ja käyttöliittymän tapahtumaloki).

Käyttö: ”Kuka on myöntänyt tämän luvan?” viestiketjuissa (usein sisäkkäin [SPLIT] / [REFERENCE]).

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

Esimerkki (käsitteellinen): Kaikki käyttäjät, joilla on rooli 501, CSV:

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

Tulostus (dummy):

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

Käyttö: Sähköpostin tekstiosaan upotettu esimiehen raportti.

[DESCENDANTS;rootId;returnField;parentKey;foreignKey]

Käyttö: Kaikki osastot, joiden toimivalta perustuu esimiehen käyttöoikeuksiin.

[SYSTEM;type;id;field]

Käyttö: Järjestelmän omistajan yhteystiedot järjestelmänvalvojan ilmoituksessa.

[SELECTION;rulesetId;returnField]

Käyttö: Postituslista, johon kuuluvat kaikki, jotka täyttävät ”Uudet työntekijät” -sääntöjoukon ehdot.

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

Palauttaa putkilla erotetut arvot järjestelmistä tai rooleista, jotka täyttävät ”Saatavilla” - säännön nykyiselle käyttäjälle.

Käyttö: Dynaamiset valintaluettelot lomakkeissa tai viesteissä.

[AVAILABLEDEPARTMENTS;fields;targetUserId]

Käyttö: Luettelee osastot, joita johtaja voi hallinnoida (perustuen ManagerOf-kenttään, yksikkötunnuksiin ja mega.eadm.no-rooleihin ).

[DATAOWNER;returnField]

Seuraa objektin data-omistaja-suhdetta; palauttaa omistajan kentän.

[ANTECEDANTS.SYSTEMROLE;roleId;departmentId;returnField]

Johtajat, joilla on hallussaan roleId ... esi-isä osastot departmentId.

Käyttö: Escalation-sähköposti, kun HR:n alaosastolla ei ole paikallista hyväksyjää.

[COUNTEMPLOYEE] / [COUNTMEMBERS]

Arvioidaan vastaavasti osaston tai ryhmän tasolla.

[GETLASTSYNCID]

Käyttö: Hallintaviestien alatunnisteiden vianmääritys.

[LASTVALUE;attributeName]

Kentän edellinen arvo viimeisimmästä HR-historiatiedostojen tuonnista, muussa tapauksessa kentän nykyinen arvo.

Sopii yhteen [ARRAYDIFF;[APositionCodeId];[LASTVALUE;APositionCodeId]] → POS-02|.

Tehtävät (monitoiminen HR)

Kenttien sijainti jakaa indeksin putkien välillä: index 0 = ensimmäinen sija, 1 = sekunti.

[POSITION;returnField;whereField;matchValue]

[POSITIONS;returnField;whereField;matchValue]

Sama kuin [POSITION] mutta palauttaa tasatun putkimerkkijonon kaikissa kohdissa (tyhjä paikka, jos vastaavuutta ei löydy).

[GROUPPRIMARYPOSITION;returnField]

Valinnat ensisijainen sijoitus: ylin APositionPercentage, tasatilanteessa ratkaisu aikajärjestyksen perusteella APositionStartDate.

[ACTIVEPOSITIONCOUNT;asOfDate]

Viestintä ja integraatio

[COUNTMESSAGESENT;messageId;fromDate]

Käyttö: ”Onko jo ilmoitettu?” -tarkistus seurantaprosessissa.

[SYSTEMOWNER]

Vaatii historiarivin käyttöoikeuden muutoksesta (lisää/muokkaa/poista -oikeus).

Käyttö: CC-järjestelmän omistaja, kun automaattinen käyttöoikeus myönnetään.

[SYNCSTEPPARAMETER;key;companySyncStepId]

Käyttöoikeudet: Yrityksen järjestelmänvalvoja Expression Builder -esikatselussa.

[APITOKEN;apiUsername]

Käyttöoikeudet: Yrityksen järjestelmänvalvoja esikatseluvaiheessa. Käytä vain suojatuissa palvelinpuolen prosesseissa.

HTML-aputoiminnot (viestipohjat)

[HTMLLISTMEMBEROF;displayField]

Ryhmän jäsenen kohdalla: näyttää yläryhmät.

[HTMLLISTARRAY;list]

Lomakemallin ohjausobjektit

Käytetään lomakemalleissa, ei vakiosääntöjoukoissa.

Esimerkkimalli: [INPUTBOX;1042;Avdeling;IT-100;] muuntaa syötteen, jonka otsikkona on ”Avdeling”, oletusarvoksi IT-100.

Merkit [NOTIFY...], [HIDDEN...], [SERVERFUNCTION...] ovat käyttäytymiskoukkuja, eivät datatoimintoja.

Kokonaisvaltaiset skenaariot (testitiedot)

Tervetuloviesti — vain aloituspäivä

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

Tulostus: Ny ansatt Kari Nordmann starter 01.04.2026.

Luvan voimassaolon päättymispäivä

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

Tulostus: Gyldig til: Permanent tilgang

Esimies poissa — ilmoita asiasta ylemmälle osastonjohtajalle

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

Säädä IFEMPTYUSE/EXISTS-yhdistelmää mallisi tarkoituksen mukaiseksi; testaa se lausekkeenmuodostajassa.

Vain uusi tehtävä — viestin vastaanottaja

Synkronoinnin jälkeen lisäykset POS-02:

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

Tulostus: Uuden tehtävän yksikön esimiehen sähköpostiosoite (esimerkki: ny-leder@eksempel.kommune.no).

Automaattisen suojausryhmän nimi (asiakkaan määrittämä)

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

Tulostus: SG-IT og digitalisering-IT-100 (tarkka CLEAN-lähtösignaali voi vaihdella).

Vientikartoitus — samAccountName

[UserName]

Tulostus: kari.nordmann

Sääntökokoelma — käyttäjällä on rooli järjestelmässä

Säännön attribuuttilauseke:

[OBJECTPERMISSION.SYSTEMROLE;Name;SystemRoleId;501]

Laskettu arvo: Bruker Fagsystem X — vertailuoperaattori Er lik / jäsenyyspalvelujen tarjoajat.

Lausekkeenmuodostaja

Vianmääritys

Pikahakemisto

Tekoälyavustajan muistiinpanot

1. Mieluummin [DisplayName]-tyyppiset kentät ennen niiden sijoittamista funktioihin.

2. Kysy, missä ilmaisu sijaitsee: sääntökokoelma, viesti, vienti vai asiakkaan asetukset.

3. Korvaa näennäistunnukset (501, 2100) asiakkaan todellisen järjestelmärooli ja osasto tunnukset lähteestä järjestelmän käyttöoikeudet.

4. Tuonnin suodatin sulkee vastaavuudet pois; synkronointivaiheen sääntöjoukko sisällyttää vastaavuudet.

5. Tapahtumaviestien kulku edellyttää synkronointikierrokselta saatua objektien historiaa.

6. Luo sisäkkäisiä esimerkkejä sisältä ulospäin — paitsi [ARRAYFOREACH...], joka sitoo ??? elementtiä kohden ennen kuin mallifunktiot suoritetaan.

7. Älä tee sisäkkäisiä rakenteita [ARRAYFOREACH...]; käytä sisarkutsuja tai [ARRAYJOIN].

8. Termit: sääntökokoelma (Regelsett), viestivirta (meldingsflyt), järjestelmän käyttöoikeus (systemtilgang), käyttöoikeus (tilgang), objektin historia (objekthistorikk).

Viimeksi päivitetty: 19. kesäkuuta 2026