OS2sofd

- Om OS2sofd: https://www.sofd.io/
- Brugervejledning: https://www.sofd.io/brugervejledning/
- Adviser: https://www.sofd.io/brugervejledning/adviser/
- Moduler og funktioner: https://www.sofd.io/moduler/
- Telefoni: https://www.sofd.io/moduler/telefoni/
- Implementeringsdrejebøger: https://www.sofd.io/implementation-guides/
- Drejebog: OPUS-kommune: https://www.sofd.io/implementation-guides/opus-loen-integration/
- Drejebog: SD-kommune: https://www.sofd.io/implementation-guides/sd-loen-integration/
- Drejebog: Opgradering til 2026R2 (IDM): https://www.sofd.io/implementation-guides/opgradering-2026r2-idm/
- Brugerstyring: https://www.sofd.io/idm/
- Forudsætninger og forberedelse: https://www.sofd.io/idm/prerequisites/
- Processer og hændelser: https://www.sofd.io/idm/processes/
- Personinaktivering: https://www.sofd.io/idm/person-inactivation/
- Konfiguration: https://www.sofd.io/idm/configuration/
- Teknik: https://www.sofd.io/teknik/
- Arkitektur: https://www.sofd.io/teknik/arkitektur/
- Datamodel: https://www.sofd.io/teknik/datamodel/
- Login og SAML: https://www.sofd.io/teknik/login/
- API: https://www.sofd.io/teknik/api/
- OData (læsning): https://www.sofd.io/teknik/api/odata/
- REST-API: https://www.sofd.io/teknik/api/rest/
- Fremtidig API-udvikling: https://www.sofd.io/teknik/api/strategi/
- Batchkørsler: https://www.sofd.io/teknik/batchkoersler/
- Integrationer: https://www.sofd.io/integrationer/
- Emply: https://www.sofd.io/integrationer/emply/
- FK Organisation: https://www.sofd.io/integrationer/fk-organisation/
- HR-ON: https://www.sofd.io/integrationer/hr-on/
- IST Tabulex: https://www.sofd.io/integrationer/ist-tabulex/
- KMD I2: https://www.sofd.io/integrationer/kmd-i2/
- KMD Nexus: https://www.sofd.io/integrationer/kmd-nexus/
- On-premise agenter: https://www.sofd.io/agents/
- Brugerkonto Agent: https://www.sofd.io/agents/user-account-agent/
- AD Writeback Agent: https://www.sofd.io/agents/ad-writeback-agent/
- AD Replikator Agent: https://www.sofd.io/agents/ad-replikator/
- AD indlæsningsintegration: https://www.sofd.io/agents/ad-indlaesningsintegration/
- OPUS indlæsningsintegration: https://www.sofd.io/agents/opus-indlaesningsintegration/
- Indlæsning af skoleelever: https://www.sofd.io/agents/skoleelev-indlaesning/
- OS2vikar - Brugerkonto Agent: https://www.sofd.io/agents/os2vikar-agent/
- Download: https://www.sofd.io/downloads/
- Ændringslog: https://www.sofd.io/changelog/
- Support og kontakt: https://www.sofd.io/support/


## 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](../../teknik/datamodel/) for begreberne person, tilhørsforhold og
enhed.

Integrationen driftes som et centralt middleware-modul (se
[Arkitektur](../../teknik/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å.

| Kolonne | Indhold |
| --- | --- |
| `EnhedsID` og `EnhedsNavn` | Enhedens id og navn i OS2sofd |
| `ParentID` og `ParentEnhedsNavn` | Den overordnede enheds id og navn. Tomme for den øverste enhed |
| `OrgAdresse`, `OrgPostnr`, `OrgPostDistrikt` | Enhedens primære adresse |
| `OrgTelefon` | Enhedens primære telefonnummer |
| `OrgMail` | Sendes altid tom |
| `OrgEAN` | Enhedens EAN-nummer. Pladsholderen 9999999999999 sendes som tom |
| `OrgPNR` | Enhedens 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.

| Kolonne | Indhold |
| --- | --- |
| `name` | Medarbejderens kaldenavn, hvis det er registreret, og ellers for- og efternavn |
| `email` | Medarbejderens primære Exchange-mailadresse |
| `username` | AD-kontoens brugernavn |
| `jobtitle` | Stillingsbetegnelsen på ansættelsen |
| `department` | Id på ansættelsens enhed, så brugeren placeres på den tilsvarende enhed i Emply |
| `password` | Et tilfældigt genereret password, da filformatet kræver feltet udfyldt |
| `usertype` | Sendes altid tom |
| `languagekey` | Altid `da-DK` |
| `phone` | De sidste fire cifre af medarbejderens primære fastnet- eller IP-telefonnummer |
| `mobile` | Medarbejderens 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

| Mulighed | Formål |
| --- | --- |
| Udeladte enheder | Enheder, 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 |
| --- | --- |
| <span class="nowrap">14.04.2023</span> | • filerne overføres nu via SFTP i stedet for FTP<br>• en eksisterende fil overskrives nu helt, så der ikke kan hænge rester af en tidligere og længere fil tilbage |
| <span class="nowrap">09.02.2023</span> | • enheder kan udelades fra overførslen, og enhederne under dem udelades med |
| <span class="nowrap">13.10.2022</span> | • ny version, der henter data direkte fra OS2sofd og kører dagligt kl. 6<br>• kun aktive AD-konti kommer med<br>• brugere knyttes til deres enhed i `department`<br>• `phone` udfyldes nu korrekt og kan komme fra både fastnet- og IP-telefonnumre |
| <span class="nowrap">04.06.2019</span> | • første version |