Emply

Emply#

Integrationen til Emply overfører kommunens organisation og medarbejdere fra OS2sofd til Emply, så enheder og brugere i Emply ikke skal vedligeholdes manuelt. Se Datamodel for begreberne person, tilhørsforhold og enhed.

Integrationen driftes som et centralt middleware-modul (se Arkitektur). Der skal ikke installeres noget hos kommunen.

Hvad integrationen gør#

En gang i døgnet, kl. 6 om morgenen, dannes to filer ud fra de aktuelle data i OS2sofd. Filerne lægges på Emply’s SFTP-server, hvor Emply henter dem og opdaterer organisation og brugere.

  • organisation.csv med kommunens enheder og deres placering i hierarkiet.
  • users.csv med medarbejderne som brugere, placeret på deres enhed.

Hver fil indeholder hele datagrundlaget og erstatter den forrige. Enheder og medarbejdere, der ikke længere er med i OS2sofd, udgår derfor af filen ved næste kørsel. Filerne dannes også, når integrationen startes.

Enheder#

Alle aktive enheder i OS2sofd kommer med, med undtagelse af de enheder, kommunen har valgt at udelade. Udelades en enhed, udelades alle enhederne under den også.

KolonneIndhold
EnhedsID og EnhedsNavnEnhedens id og navn i OS2sofd
ParentID og ParentEnhedsNavnDen overordnede enheds id og navn. Tomme for den øverste enhed
OrgAdresse, OrgPostnr, OrgPostDistriktEnhedens primære adresse
OrgTelefonEnhedens primære telefonnummer
OrgMailSendes altid tom
OrgEANEnhedens EAN-nummer. Pladsholderen 9999999999999 sendes som tom
OrgPNREnhedens P-nummer

Brugere#

En medarbejder kommer med som bruger for hver aktiv AD-konto, medarbejderen har i OS2sofd. Deaktiverede AD-konti kommer ikke med.

Brugeren knyttes til den aktive ansættelse, der har samme medarbejdernummer som AD-kontoen. Findes der ingen, bruges medarbejderens primære aktive ansættelse.

KolonneIndhold
nameMedarbejderens kaldenavn, hvis det er registreret, og ellers for- og efternavn
emailMedarbejderens primære Exchange-mailadresse
usernameAD-kontoens brugernavn
jobtitleStillingsbetegnelsen på ansættelsen
departmentId på ansættelsens enhed, så brugeren placeres på den tilsvarende enhed i Emply
passwordEt tilfældigt genereret password, da filformatet kræver feltet udfyldt
usertypeSendes altid tom
languagekeyAltid da-DK
phoneDe sidste fire cifre af medarbejderens primære fastnet- eller IP-telefonnummer
mobileMedarbejderens primære mobilnummer

Følgende medarbejdere kommer ikke med.

  • Medarbejdere uden en primær Exchange-mailadresse.
  • Medarbejdere uden en aktiv ansættelse (tilknytninger af anden type end ansættelse tæller ikke med).
  • Medarbejdere, der ikke har en aktiv AD-konto.

Ligger ansættelsens enhed under en af de udeladte enheder, kommer brugeren stadig med, men uden enhed i department.

Hvad kan tilpasses#

MulighedFormål
Udeladte enhederEnheder, der sammen med alle underliggende enheder ikke skal overføres til Emply

Forudsætninger#

  • Adgang til Emply’s SFTP-server i form af adresse, brugernavn og password, som kommunen får fra Emply.
  • Aftale med Emply om indlæsning af de to filer i det beskrevne format.
  • OS2sofd i drift med AD-konti og primære Exchange-mailadresser registreret på medarbejderne, da de afgør, hvem der kommer med.

Ændringslog#

Ændringslog for Emply integrationen. Nyeste ændring øverst.

DatoÆndring
14.04.2023• filerne overføres nu via SFTP i stedet for FTP
• en eksisterende fil overskrives nu helt, så der ikke kan hænge rester af en tidligere og længere fil tilbage
09.02.2023• enheder kan udelades fra overførslen, og enhederne under dem udelades med
13.10.2022• ny version, der henter data direkte fra OS2sofd og kører dagligt kl. 6
• kun aktive AD-konti kommer med
• brugere knyttes til deres enhed i department
• phone udfyldes nu korrekt og kan komme fra både fastnet- og IP-telefonnumre
04.06.2019• første version