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/
- 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/
- 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/


## HR-ON

Integrationen til **HR-ON** gør HR-systemet til kilde for medarbejdere og
organisation i OS2sofd. Afdelinger i HR-ON bliver til enheder i OS2sofd, og
medarbejdere bliver til personer med et tilhørsforhold pr. ansættelse. Se
[Datamodel](../../teknik/datamodel/) for begreberne person, tilhørsforhold og
enhed.

Integrationen kan desuden bestille, genaktivere, deaktivere og slette AD-konti ud
fra oplysningerne i HR-ON, så kontoadministrationen følger ansættelserne uden
manuelt arbejde.

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

## Hvornår overføres data

Integrationen kombinerer realtidsopdateringer med en daglig fuld kørsel.

- **Realtid.** Integrationen registrerer sig selv hos HR-ON og får besked, hver
  gang en medarbejder eller en afdeling oprettes, ændres eller slettes. Ændringen
  slår igennem i OS2sofd inden for få sekunder. Registreringen hos HR-ON
  kontrolleres hvert 10. minut og genoprettes automatisk, hvis den er faldet bort.
- **Daglig fuld kørsel.** En gang i døgnet, som standard kl. 17, hentes ændrede
  medarbejdere og alle afdelinger fra HR-ON, og hele datagrundlaget sammenholdes
  med OS2sofd. Forskelle rettes, også dem der er opstået udenom integrationen,
  eller fordi en enkelt realtidsbesked er gået tabt.
- **Ledere om natten.** Kl. 2 om natten opdateres lederne på enhederne igen, så de
  er på plads inden OS2sofd's natlige kørsler.

Fejler en realtidsbesked, forsøges den igen med stigende mellemrum i op til cirka
en time. Hører beskeden til en medarbejder eller afdeling, der ikke længere findes
i HR-ON, opgives den med det samme. Den daglige fulde kørsel retter op på det, der
måtte mangle.

## Afdelinger

Hver afdeling i HR-ON bliver til en enhed i OS2sofd med samme placering i
hierarkiet. Afdelinger, der forsvinder fra HR-ON, nedlægges i OS2sofd.

| Oplysning i OS2sofd | Kilde i HR-ON |
| --- | --- |
| Navn og kortnavn | Afdelingens navn |
| Overordnet enhed | Afdelingens overordnede afdeling |
| EAN, P-nummer, CVR | Afdelingens tilsvarende felter |
| E-mail | Afdelingens e-mail |
| Telefon | Afdelingens telefonnummer (fastnet) |
| Adresse | Afdelingens adresse, postnummer og by. Land sættes til Danmark, hvis det ikke er angivet |
| Ekstra felter på enheden | Alle afdelingens brugerdefinerede felter overføres med feltets navn |
| Hjemmeside | Det brugerdefinerede felt `Webside` |
| `ESDH_Org_Id` | Sættes til afdelingens id i HR-ON, når det brugerdefinerede felt `ESDH_Org` er sat |

## Medarbejdere

Medarbejdere samles pr. CPR-nummer. En person, der har flere ansættelser i HR-ON,
bliver altså én person i OS2sofd med ét tilhørsforhold pr. ansættelse.

### Personen

| Oplysning i OS2sofd | Kilde i HR-ON |
| --- | --- |
| CPR-nummer | Medarbejderens CPR-nummer. Bruges som nøgle |
| Fornavn og efternavn | Se afsnittet om navne nedenfor |
| Kaldenavn | Medarbejderens alternative for- og efternavn, hvis de afviger fra det officielle navn |
| Første ansættelsesdato og jubilæumsdato | Den tidligste startdato blandt medarbejderens ansættelser |
| Mobilnummer | Medarbejderens private mobilnummer |

Har personen flere ansættelser, læses navnene fra den senest ændrede ansættelse.

**Navne.** Kommunen vælger, hvem der er master for navnene.

- **OS2sofd (standard).** Navnet fra HR-ON bruges kun, når personen oprettes. Derefter
  vedligeholdes navnet af OS2sofd, typisk ud fra CPR.
- **HR-ON.** Navnet opdateres i OS2sofd, hver gang det ændres i HR-ON.

### Tilhørsforholdet

Hver ansættelse bliver til et tilhørsforhold på den enhed, medarbejderen er
tilknyttet i HR-ON. Medarbejderens id i HR-ON bruges som medarbejdernummer på
tilhørsforholdet.

| Oplysning i OS2sofd | Kilde i HR-ON |
| --- | --- |
| Enhed | Den afdeling, medarbejderen er tilknyttet. For ledere feltet `Leder ansat i` (se nedenfor) |
| Start- og stopdato | Ansættelsens start- og slutdato |
| Medarbejdernummer | Medarbejderens id i HR-ON |
| Stillingsbetegnelse | Feltet `Kaldetitel`. Er det tomt, og har tilhørsforholdet ingen stillingsbetegnelse i forvejen, sættes den til "Ukendt" |
| Stillingstype | Feltet `Overenskomstmæssig stillingsbetegnelse` |
| Ugentlig arbejdstid | Feltet `Timer pr. uge (kun månedsløn)`. Mangler det, sættes arbejdstiden til 0 |
| Ansættelsesvilkår | Udledt af feltet `Aflønningsform` for aflønnede medarbejdere (fx `Månedsløn forud`, `Timeløn`, `Fleksjob - Månedsløn bagud`). Ikke-aflønnede tilknytninger får vilkåret 99 med stillingstypen fra HR-ON som tekst |
| Ekstra felt `Tjenestenummer` | Feltet `Tjenestenr` |
| Ekstra felt `It-bruger` | Feltet `It-bruger` (Ja/Nej). Styrer bestilling af AD-konti, se nedenfor |
| Ekstra felt `Leder ansat i udfyldt` | Ja, hvis medarbejderens ansættelse er placeret via `Leder ansat i` |

Ansættelser, hvor slutdatoen ligger før eller på startdatoen, overføres ikke.
Ophører en ansættelse i HR-ON, eller forsvinder medarbejderen helt, fjernes
tilhørsforholdet i OS2sofd. Tilhørsforhold og telefonnumre fra andre kilder røres
ikke.

Personer, der kun har ophørte ansættelser, oprettes ikke i OS2sofd. Er en person
allerede inaktiv i OS2sofd og har ingen igangværende ansættelser, sendes der heller
ikke ændringer til personen.

## Ledere

I HR-ON er en leder knyttet til den afdeling, vedkommende leder. Integrationen
sætter lederen på den tilsvarende enhed i OS2sofd.

Selve lederens ansættelse placeres ud fra feltet `Leder ansat i`, når lederen ikke
har en almindelig afdelingstilknytning ved siden af. Kun ledere, hvis ansættelse er
i gang i dag, kan blive sat som ledere.

Er der flere mulige ledere for den samme afdeling, vælges den senest ansatte, og
der dannes et advis i OS2sofd, så det kan rettes i HR-ON.

## Automatisk bestilling af AD-konti

Integrationen kan sættes op til selv at bestille AD-konti i OS2sofd. Ordrerne
udføres af [Brugerkonto Agenten](../../agents/user-account-agent/) på samme måde
som OS2sofd's egne kontoordrer. Det er feltet `It-bruger` på ansættelsen i HR-ON,
der afgør, om medarbejderen skal have en konto.

Koblingen mellem en AD-konto og en ansættelse sker via medarbejdernummeret, dvs.
AD-kontoens medarbejdernummer skal svare til medarbejderens id i HR-ON.

| Situation | Hvad integrationen gør |
| --- | --- |
| `It-bruger` er Ja, ansættelsen starter inden for den opsatte frist og er ikke ophørt, og der findes ingen konto | Bestiller en ny konto (`CREATE`) |
| Som ovenfor, men der findes en deaktiveret konto til ansættelsen | Genaktiverer den eksisterende konto (`REACTIVATE`) i stedet for at oprette en ny. En ventende sletning af kontoen annulleres |
| `It-bruger` er Nej, eller ansættelsen er ophørt | Deaktiverer kontoen (`DEACTIVATE`) og planlægger sletning (`DELETE`) |
| Personen har en AD-konto, som ikke hører til nogen af personens ansættelser i HR-ON | Deaktiverer og planlægger sletning af kontoen |
| En ventende ordre er ikke længere relevant, fx fordi `It-bruger` er sat tilbage | Annullerer ordren |

Frister og hvilke ordretyper der er slået til (oprettelse, deaktivering og
sletning), styres af opsætningen af brugerkontotypen Active Directory i OS2sofd.
Integrationen respekterer den opsætning. Genaktivering følger oprettelsen, så er
oprettelse slået fra, genaktiveres der heller ikke.

Er kontotypen sat op til at oprette konti deaktiveret, bestilles kontoen i god tid
og genaktiveres automatisk, når genaktiveringsfristen nærmer sig. Nyligt oprettede
konti kontrolleres hvert andet minut, så en konto til en medarbejder, der starter i
dag eller er startet, bliver aktiveret inden for få minutter.

Den fulde gennemgang af alle konti sker en gang i døgnet om natten. Ændringer, der
kommer i realtid fra HR-ON, behandles med det samme for den berørte medarbejder.

> [!WARNING]
> Da integrationen deaktiverer AD-konti, der ikke kan kobles til en ansættelse i
> HR-ON, skal medarbejdernummeret på eksisterende AD-konti være korrekt, inden
> kontobestillingen slås til.

## Adviser

Integrationen danner adviser af typen
[Fejl ved import af person](../../brugervejledning/adviser/#fejl-ved-import-af-person)
og [Fejl ved import af enhed](../../brugervejledning/adviser/#fejl-ved-import-af-enhed),
når data i HR-ON ikke kan overføres som forventet. Det sker i disse tilfælde.

- En medarbejder er tilknyttet mere end én afdeling.
- En medarbejder har både en almindelig afdelingstilknytning og feltet `Leder ansat i`
  udfyldt.
- En medarbejder har skiftet CPR-nummer i HR-ON. Adviset lægges på den gamle person
  og oplyser både det gamle og det nye CPR-nummer, så de to personer kan håndteres.
- En afdeling har flere mulige ledere.
- Oprettelse eller opdatering af en person afvises af OS2sofd.

## Hvad kan tilpasses

| Mulighed | Formål |
| --- | --- |
| Tidspunkt for den daglige fulde kørsel | Standard er kl. 17 |
| Realtidsopdateringer | Kan slås til og fra |
| Master for navne | OS2sofd (standard) eller HR-ON |
| Bestilling af AD-konti | Kan slås til og fra |
| Tidspunkt for den natlige kontogennemgang | Standard er kl. 1 |
| Kontrol af nyligt oprettede konti | Standard er hvert andet minut. Kan slås fra |

## Forudsætninger

- **Adgang til HR-ON's API** i form af et klient-id og en klientnøgle, som kommunen
  opretter i HR-ON.
- **Afdelingerne er vedligeholdt i HR-ON**, og hver medarbejder er tilknyttet præcis
  én afdeling, eller for ledere udfyldt `Leder ansat i`.
- **De brugerdefinerede felter**, som integrationen læser (fx `Kaldetitel`,
  `Aflønningsform`, `Tjenestenr` og `It-bruger`), er oprettet i HR-ON. Feltopsætningen
  aftales med kommunen i opstarten.
- **Ved bestilling af AD-konti**: Brugerkonto Agenten er installeret, brugerkontotypen
  Active Directory er sat op i OS2sofd, og AD-konti har medarbejderens id fra HR-ON
  som medarbejdernummer. Genaktivering kræver OS2sofd 2026R2 og Brugerkonto Agent
  3.0.0 eller nyere.

## Ændringslog

Ændringslog for HR-ON integrationen. Nyeste ændring øverst.

| Dato | Ændring |
| --- | --- |
| <span class="nowrap">11.09.2026</span> | • tilhørsforhold får nu altid en stillingsbetegnelse. Er `Kaldetitel` tom i HR-ON, sættes den til "Ukendt", så ansættelsen ikke afvises af OS2sofd |
| <span class="nowrap">08.09.2026</span> | • ved opstart fjernes kun integrationens egen registrering hos HR-ON, så andre registreringer på samme HR-ON-konto ikke påvirkes |
| <span class="nowrap">01.09.2026</span> | • realtidsbeskeder, der fejler, forsøges igen med stigende mellemrum og opgives efter cirka en time<br>• beskeder om medarbejdere eller afdelinger, der ikke længere findes i HR-ON, opgives med det samme |
| <span class="nowrap">18.08.2026</span> | • personer, der kun har ophørte ansættelser, forsøges ikke længere oprettet i OS2sofd, og inaktive personer uden igangværende ansættelser opdateres ikke |
| <span class="nowrap">06.07.2026</span> | • nyligt oprettede AD-konti kontrolleres hvert andet minut, så en konto, der er oprettet deaktiveret, bliver aktiveret inden for få minutter i stedet for ved den natlige kørsel |
| <span class="nowrap">03.07.2026</span> | • deaktiverede AD-konti genaktiveres nu med en `REACTIVATE`-ordre. Kræver OS2sofd 2026R2 og Brugerkonto Agent 3.0.0 eller nyere |
| <span class="nowrap">11.06.2026</span> | • advis på den gamle person, når en medarbejder skifter CPR-nummer i HR-ON |
| <span class="nowrap">20.05.2026</span> | • ved genansættelse genbruges en eksisterende deaktiveret AD-konto i stedet for at oprette en ny<br>• adviset om flere mulige ledere oplyser nu afdelingens navn |
| <span class="nowrap">07.05.2026</span> | • når en AD-konto deaktiveres, planlægges sletningen samtidig efter brugerkontotypens frist |
| <span class="nowrap">01.05.2026</span> | • lederne opdateres også kl. 2 om natten, så de er på plads inden OS2sofd's natlige kørsler |
| <span class="nowrap">27.04.2026</span> | • manglende ugentlig arbejdstid i HR-ON overføres som 0<br>• brugerdefinerede felter af typen link overføres med deres tekst<br>• rettet fejl, hvor et forkert medarbejder-id kunne blive brugt ved realtidsopdateringer |
| <span class="nowrap">16.04.2026</span> | • rettet kontobestillingen, så den håndterer flere AD-konti med samme medarbejdernummer<br>• rettet kontobestillingen ved realtidsopdateringer |
| <span class="nowrap">01.04.2026</span> | • automatisk bestilling af AD-konti ud fra feltet `It-bruger`<br>• ventende kontoordrer, der ikke længere er relevante, annulleres |
| <span class="nowrap">14.01.2026</span> | • ekstra felter `Tjenestenummer`, `It-bruger` og `Leder ansat i udfyldt` på tilhørsforholdet<br>• ansættelsesvilkår udledes af `Aflønningsform`<br>• advis, når en afdeling har flere mulige ledere, og når en medarbejder både har en afdelingstilknytning og `Leder ansat i` udfyldt |
| <span class="nowrap">21.12.2025</span> | • advis, når en person ikke kan oprettes eller opdateres<br>• afdelinger opdateres ved hver kørsel, da HR-ON ikke altid melder ændringer på afdelinger korrekt |
| <span class="nowrap">28.11.2025</span> | • første version med overførsel af afdelinger og medarbejdere, realtidsopdateringer, hjemmeside og `ESDH_Org_Id` på enheder samt privat mobilnummer på personer |