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/


## Telefoni

Modulet **Telefoni** giver kommunen et samlet register over sine telefonnumre og
abonnementer direkte i OS2sofd. Hvert nummer registreres én gang med oplysninger om
udbyder, abonnement og konto og tildeles derefter en medarbejder, en eller flere
enheder eller begge dele. OS2sofd sørger selv for, at nummeret vises på de personer
og enheder, det er tildelt, og at det forsvinder igen, når tildelingen ophører.

Modulet slås til med indstillingen `sofd.modules.telephony.enabled` (se
[Moduler og funktioner](../)).

## Hvad ændrer sig, når modulet er slået til

- Menupunktet **Telefoni** kommer frem for brugere med rollen Telefonadministrator
  eller Administrator.
- På fanen **Telefoni** på personer og enheder kan der ikke længere oprettes nye numre
  manuelt. Nye numre registreres i stedet i telefoniregistret og tildeles derfra.
  Numre, der tidligere er oprettet manuelt, kan stadig rettes og slettes på fanen.
- Numre fra andre kilder, fx AD eller lønsystemet, påvirkes ikke.
- I administrationsmenuen kommer punktet **Telefoni funktionstyper** frem, hvor
  kommunen vedligeholder listen over funktionstyper til funktionstelefoner.
- På personens stamdata kommer feltet **Beskattet af Fri Telefon** frem.

## Telefonidata

Under **Telefoni > Telefonidata** vises alle registrerede numre i en liste, der kan
filtreres og søges i pr. kolonne.

![Listen over telefonnumre under Telefoni > Telefonidata](telefonidata.png)

| Kolonne | Indhold |
| --- | --- |
| Telefonitype | Fx mobil, fastnet, IP-telefon, data-SIM eller bredbånd |
| Telefonnummer | Nummeret |
| Tildelt | Om nummeret er tildelt en medarbejder eller en enhed |
| Medarbejder | Den medarbejder, nummeret er tildelt |
| Enhed | De enheder, nummeret er tildelt |

### Opret og rediger et nummer

Et nyt nummer oprettes med knappen **Opret telefoni-data**. Blyanten ud for et
nummer åbner det samme skærmbillede for et eksisterende nummer.

![Skærmbilledet Opret/rediger telefoni-data](opret-rediger.png)

| Felt | Formål |
| --- | --- |
| Telefonnummer | Nummeret. Skal udfyldes |
| Udbyder | Teleselskabet |
| Abonnementstype | Abonnementets type hos udbyderen |
| Kontonummer | Kontonummeret hos udbyderen |
| EAN | EAN-nummeret, regningen sendes til |
| Telefonitype | Mobil, fastnet, IP-telefon, data-SIM, bredbånd, funktion, afdelingsnummer eller fax |
| Synlighed | Synligt, skjult for borgere eller skjult for alle. Skjulte numre vises maskeret i OS2sofd, indtil man klikker på dem |
| Funktionstelefon | Markeres, hvis nummeret hører til en funktion frem for en person, fx en vagttelefon. Der vælges så en funktionstype |
| Noter | Fri tekst. Noten vises også ved nummeret på personens eller enhedens telefonfane |

Udbyder, abonnementstype, kontonummer og EAN bruges kun i registret og vises ikke på
personen eller enheden.

Sletter man et nummer, fjernes det samtidig fra de personer og enheder, det var
tildelt.

### Tildel et nummer

- **Til en medarbejder.** Klik på blyanten i kolonnen **Medarbejder** og søg
  medarbejderen frem på navn. Søgeresultatet viser navn, maskeret CPR-nummer og
  primær enhed, så man kan skelne medarbejdere med samme navn. Et nummer kan være
  tildelt én medarbejder ad gangen. Krydset fjerner tildelingen igen.
- **Til enheder.** Klik på blyanten i kolonnen **Enhed** og vælg en eller flere
  enheder i organisationen.

Tildelingen slår igennem på personen eller enheden inden for et minut i dagtimerne
(se nedenfor).

## Historik

Under **Telefoni > Historik** kan man slå et telefonnummer op og se, hvilke
medarbejdere der har haft nummeret, og i hvilken periode. Det er nyttigt, når et
nummer skal genbruges, eller når en regning skal placeres.

![Opslag på et telefonnummer under Telefoni > Historik](historik.png)

## Rapporter

Under **Telefoni > Rapporter** kan der hentes to Excel-rapporter. Begge viser UUID,
navn, CPR-nummer og telefonnumre pr. medarbejder.

| Rapport | Indhold |
| --- | --- |
| Ikke længere ansat | Personer, der er udgået af OS2sofd, men stadig har numre fra telefoniregistret. Bruges til at finde numre og abonnementer, der skal opsiges eller overdrages |
| Beskattet af fri telefon | Personer, hvor feltet **Beskattet af Fri Telefon** er markeret. Bruges fx som grundlag for lønindberetning |

Feltet **Beskattet af Fri Telefon** markeres på personens stamdata af en bruger med
skriveadgang.

## Sådan når numrene ud på personer og enheder

Registret er det sted, numrene vedligeholdes. OS2sofd overfører dem selv til de
tildelte personer og enheder.

- **Løbende.** Hvert minut mellem kl. 5 og 23 overføres de numre, der er ændret
  siden sidst.
- **Om natten.** Kl. 3.10 gennemgås alle numre, og personer og enheder rettes til, så
  de svarer til registret. Numre, der er slettet eller ikke længere er tildelt,
  fjernes, og manglende numre tilføjes.

Numrene får dermed samme status som numre fra andre kilder. De kan vælges som
primære numre og sendes videre til de systemer, der får telefonnumre fra OS2sofd.

Personer, der er udgået af OS2sofd, beholder deres numre fra registret. Det er
netop dem, rapporten **Ikke længere ansat** viser, så numrene kan frigives.

## Adgang

| Rolle | Adgang |
| --- | --- |
| Telefonadministrator (`telephonyadmin`) | Læseadgang til OS2sofd samt adgang til alt under menupunktet **Telefoni** |
| Administrator (`admin`) | Har samme adgang som Telefonadministrator, når modulet er slået til |

Se [Login og roller](../../teknik/login/) for de øvrige roller.

## API

Telefoniregistret kan også vedligeholdes fra et andet system via OS2sofd's API.
API'et kræver en API-nøgle med skriveadgang.

| Handling | Kald |
| --- | --- |
| Hent alle numre med alle oplysninger og tildelinger | `GET /api/telephony` |
| Opret et nyt, ikke tildelt nummer | `POST /api/telephony/` |
| Tildel nummeret til en person (personens UUID i kroppen) | `POST /api/telephony/{id}/person` |
| Fjern personen fra nummeret | `DELETE /api/telephony/{id}/person` |
| Tildel nummeret til en enhed (enhedens UUID i kroppen) | `POST /api/telephony/{id}/orgunit` |
| Fjern en enhed fra nummeret | `DELETE /api/telephony/{id}/orgunit/{enhedens UUID}` |

Ændringer via API'et overføres til personer og enheder på samme måde som ændringer
foretaget i brugergrænsefladen.