NOM-teamets interne dokumentasjon: her.
Sist oppdatert 20.07.2023
1. Visjon
NAV Organisasjonsmaster (NOM) skal være masterkilde for ressurser, organisasjonsenheter inkl. organisasjonshierarkiet, samt orgtilknytning mellom ressurser og organisasjonsenheter. Som masterkilde skal NOM forsyne andre applikasjoner med data. NOM skal være en smal applikasjon som holder på sentral informasjon om ressurser og orgenheter som mange konsumenter kan være interessert i, og så legges det heller opp til at andre konsumenter kan berike med mer info om elementer som finnes i NOM. Et eksempel på det er at NOM er master for ressurser med navn, NAV-ident mm., mens lønnsinfo vil lønnssystemet berike med, eller at Teamkatalogen vil berike med teamtilknytning.
Visjon: NOM skal inneholde og dele autoritativ informasjon om hvordan NAV er organisert og hvem som jobber for NAV.
1.1. Bakgrunn - hvorfor NOM?
I dag er informasjon om statlige og kommunalt ansatte samt eksterne spredt på tvers av mange applikasjoner uten en reell autoritativ hovedkilde (masterkilde). Tilsvarende har vi ulike kilder til informasjon om organisasjonsenheter og organisasjonsstrukturen (hierarkiet organisasjonen er koblet sammen i). Dette skaper utfordringer med at man må sammenligne flere kilder og gjøre en manuell tolkning for å lande på hva som er korrekt.
Utfordringene innebærer blant annet:
-
merarbeid da data må vedlikeholdes flere steder, gjerne manuelt
-
flere parallelle kilder til omtrent samme data gir økt vedlikeholdskostnad og økt risiko for usynkrone data.
-
vanskelig å vite hvilke data du kan stole på
-
vanskelig for nye konsumenter å vite hvilke kilder de skal legge til grunn for organisasjonsinformasjon, og dermed også større risiko for at det etableres nye kilder med omtrent samme data.
2. Domenet
2.1. Organisering
Begrepsdefinisjon (TODO) |
Oppslag: Kommer |
Hendelser: Kommer |
Beskrivelse:
Organisering er den hierarkiske koblingen mellom orgEnheter som danner et hierarki.
En organisering omfatter 2 orgEnheter og typen organisering mellom dem.
En orgEnhet kan ha flere underenheter, men en orgEnhet kan bare ha én overenhet. Slik NAV er organisert i dag, vil alle aktive enheter være knyttet til orghierarkiet i NOM.
Felt | Påkrevd | Beskrivelse | Eksempel | Kilde |
---|---|---|---|---|
retning |
Ja |
Angir om det pekes på en overliggende eller underliggende orgEnhet |
"over"/"under" |
Unit4 via DVH |
orgEnhet |
Ja |
OrgEnhet over eller under avhengig av retning |
Se OrgEnhet |
Unit4 via DVH |
gyldigFom |
Ja |
Dagen organiseringen er gyldig fra og med. I dag vises kun dummyverdi (dato for siste innlasting, ofte dagens dato eller gårsdagen). |
2009-01-22 |
Dummy |
gyldigTom |
Nei |
Dagen organiseringen er gyldig til og med. I dag vises kun dummyverdi NULL |
2020-02-14, NULL hvis ikke satt. |
Dummy |
2.2. OrgEnhet
Oppslag: Kommer |
Hendelser: Kommer |
Beskrivelse:
Delmengde av en organisasjon som etableres som følge av forhandlinger i Medbestemmelsesapparatet. Den har en leder, kan ha ressurser og underliggende orgEnheter.
Begrepet brukes om alle nivåer i hierakiet.
Team og produktområder er i dag ikke definert som orgEnheter. Oppgavekøer, arbeidsbenker og virtuelle enheter er ikke orgEnheter selv om enkelte løsninger i NAV beskriver de som enheter.
Eksempler:
NAV Halden Stab er en orgEnhet og har overliggende orgEnhet NAV Halden. Denne har igjen flere underliggende orgEnheter.
Merk:
-
Begrepet orgenhet brukes også i Unit4/Agresso, men angir da kun løvnoden (nederste node) i organisasjonshierarkiet siden man der sier at de organisasjonsenhetene som er løvnoder er på organisasjonsnivå = ORGENHET. I NOM er alle noder i organisasjonshierarkiet egne orgEnheter, ikke bare løvnodene.
-
I NAV har begrepet orgenhet/organisasjonsenhet/enhet ulik betydning avhengig av hvilken kontekst man er i. I mange fagsystemer, oppgaveruting og i NAV-IT representerer begrepet ofte en 4-sifret enhet. I NAVs kopi av Enhetsregisteret i Brønnøysund representerer begrepet de offisielle organisasjonsenhetene som NAV har registrert der. I NOM representerer begrepet alle organisasjonsenheter som er etablert gjennom forhandlinger i Medbestemmelsesapparatet, og ligner veldig på de organisasjonsenhetene som finnes i Unit4/Agresso. Merk at det er en viss overlapp mellom de ulike definisjonene av organisasjonsenhet, men det f.eks. finnes 4-sifferenheter som ikke finnes som orgEnhet i NOM og vice versa.
Felt | Påkrevd | Beskrivelse | Eksempel | Kilde |
---|---|---|---|---|
id |
Ja |
NOMs unike ID for en orgEnhet. Formatet er <XX999X>. Id-en er en syntetisk nøkkel, og altså ikke meningsbærende. |
pa649a |
NOM |
navn |
Ja |
Navnet på en orgEnheten |
NAV Halden Stab |
Unit4 via DVH |
gyldigFom |
Ja |
Virkningsdato for når orgEnheten er/var virksom fra. Kan også være frem i tid. For orgEnheter over nederste nivå vil gyldigFom alltid være første innlastingsdato i DVH. |
2009-01-22 |
Unit4 via DVH |
gyldigTom |
Nei |
Siste dag orgEnheten var (eller skal være) virksom. Kan være frem i tid. For orgEnheter over nederste nivå vil gyldigTom alltid være NULL, også for de som er avviklet. Per nå kan derfor ikke gyldigTom benyttes for å sile ut avviklede orgEnheter høyere opp i hierarkiet, se også beskrivelse av feltet organiseringer. |
2020-02-14, NULL hvis ikke satt. |
Unit4 via DVH |
agressoId |
Ja |
Id fra lønnssystemet Unit4-Agresso. Merk at denne id-en ikke er unik. Det forekommer at flere historiske orgEnheter har gjenbrukt agressoId. Konsumenter av NOM oppfordres sterkt til å ikke brukke agressoId, men heller bruke NOMs id for enheten som er unik. |
1001360 |
Unit4 via DVH |
orgNiv |
Ja |
Nivå i organisasjonshierarkiet i lønnsystemet Unit4-Agresso. Ønsker ikke at konsumenter skal bygge logikk på dette feltet da NOM vil gå bort fra orgnivå på sikt. |
ORGNIV2 |
Unit4 via DVH |
agressoOrgenhetType |
Ja |
Enhetstype slik det er definert i Unit4. Alle enheter i direktoratet er f.eks. DIR, et NAV-kontor er LOKAL |
LOKAL/DIR… |
Unit4 via DVH |
remedyEnhetId |
Nei |
Angir hvilket enhetsnummer en ressurs i denne orgEnheten vanligvis vil bli tildelt i tilgangsløsningene. Alle orgEnheter nederst i orgHierarkiet vil ha verdi i dette feltet, og mange orgEnheter oppover i hierarkiet også. De øverste orgEnhetene vil ikke ha verdi her. Verdi i dette feltet utledes av NOM sin mapping mellom NOMs orgEnheter og remedyEnheter |
1783 |
NOM |
nomNivaa |
Nei |
Enkelte orgenheter kan klassifiseres som et ARBEIDSOMRÅDE (også kalt ENHET), DRIFTSENHET eller LINJEENHET. Dette feltet er satt for de orgEnhetene som kan klassifiseres som et av disse tre verdiene. |
DRIFTSENHET |
NOM |
organiseringer |
Ja |
Liste over overliggende orgEnhet og eventuelle underliggende orgEnheter. Alle aktive orgEnheter vil ha minst 1 organisering. Avviklede orgEnheter vil fjernes fra orghierarkiet, og således vil organiseringer være tom, og den egenskapen kan benyttes for å avdekke avviklede orgEnheter. |
Se Organiseringer-objektet |
Unit4 via DVH |
leder |
Ja |
Ressursen som er leder for orgEnheten. Alle aktive orgEnheter skal ha feltet satt. |
Se OrgEnhetsleder-objektet |
Unit4 via DVH |
orgEnhetstype |
Nei |
Typen orgEnhet. Per juni 2023 er feltet kun populert for orgEnheter i direktoratet, og disse har da orgEnhetstype=DIR. Det er planlagt at alle orgEnheter skal få verdi her iløpet av 2023. |
DIR, Familie- og pensjonsytelser, eller NAV-kontor |
NOM |
koblinger |
Ja |
Liste over alle ressurser knyttet til orgEnheten. Både ressurser som er ansatt ved orgEnheten, og utlånt til orgEnheten. Merk at per i dag er praksisen å plassere ansatte i nederste orgEnheter (løvnodene) i orghierarkiet, og derfor vil koblinger være tom for alle orgEnheter bortsett fra løvnodene. |
Se OrgEnhetsKobling |
Unit4 via DVH |
2.3. OrgEnhetsKobling
Beskrivelse:
OrgEnhetskobling er knytningen mellom en orgEnhet og en ressurs. En orgEnhet kan flere orgEnhetskoblinger samtidig, men ikke flere for samme ressurs på et gitt tidspunkt. Merk også at det kun er orgEnheter nederst i orghierarkiet (løvnoder) som har ressurser knyttet til seg per juni 2023.
Eksempler:
OrgEnhet NAV Halden Stab har en orgEnhetskobling til ansatt Ola i perioden 01.01.2020 - 31.03.2022
Felt | Påkrevd | Beskrivelse | Eksempel | Kilde |
---|---|---|---|---|
ressurs |
Ja |
Ressursen orgEnheten er koblet til |
Se Ressurs-objekt |
Unit4 via DVH |
gyldigFom |
Ja |
Datoen koblingen er gyldig fra og med. Per jan 2023 viser denne oftest en nyere dato enn da ressursen ble koblet til den gitte orgEnheten. Dette skyldes at Unit4, og dernest DVH, stykker opp periodene vesentlig mer enn det NOM vil presentere. Verdi kan også være frem i tid |
2009-01-22 |
Unit4 via DVH |
gyldigTom |
Nei |
Siste dag ressursen er tilknyttet orgEnheten. NULL hvis ikke satt. Verdi kan være frem i tid |
2020-02-14, NULL hvis ikke satt. |
Unit4 via DVH |
2.4. OrgEnhetsleder
Beskrivelse:
Knytning mellom en orgEnhet og en ressurs hvor ressursen er orgEnhetens leder. Alle aktive orgEnheter skal ha leder.
Fremtidig: : I dag støttes ikke historikk over ledere på en orgEnhet. På sikt skal objektet utvides med periode, slik at man kan se historiske ledere, dog slik at en orgEnhet har maks én leder på et gitt tidspunkt.
Felt | Påkrevd | Beskrivelse | Eksempel | Kilde |
---|---|---|---|---|
ressurs |
Ja |
Ressursen som er leder for orgEnheten |
Se Ressurs-objekt |
Unit4 via DVH |
2.5. Ressurs
Oppslag: Kommer |
Hendelser: Kommer |
Beskrivelse:
Person som utfører oppgaver på vegne av NAV. Omfatter også roboter og andre ikke-mennesker som har fått tildelt en NAV-ident.
Eksempler:
Alle personer som er tilknyttet NAV som ressurs, enten direkte eller gjennom underleverandører.
Omfatter:
-
Interne ressurser: Statlig ansatte i NAV, lærlinger i NAV og kommunalt ansatte i NAV.
-
Eksterne ressurser: Konsulenter, personer på tiltak i NAV, tolker mm.
Felt | Påkrevd | Beskrivelse | Eksempel | Kilde |
---|---|---|---|---|
navIdent |
Ja |
Intern identifikator som tildeles alle ressurser i NAV. Format <X999999>. Unikt for alle ressurser. Tallsekvensen 999999 er i seg selv også unik. Praksis er også at en person får tildelt samme NAV-ident selv om vedkommende f.eks. har vært i NAV for ti år siden, så ute, men så kommer tilbake. |
Z123456 |
Remedy via DVH |
personIdent |
Ja |
11-sifret fødselsnummer eller DNR for ressurser med innslag i Folkeregisteret. For ressurser uten fnr/dnr vil det her finnes id-er på ulike format - dette gjelder f.eks. for utenlandske konsulenter på korttidsoppdrag, roboter mv. |
1234567890 |
Remedy via DVH |
sektor |
Ja |
Kodeverk som angir om ressursen er statlig eller kommunalt ansatt i NAV, eller ekstern. |
NAV_STATLIG, NAV_KOMMUNAL eller EKSTERN |
Remedy via DVH |
folkeregisterPerson |
Nei |
Inneholder folkeregisterrert navn for ressursen. Folkeregisteret opererer med for-, mellom- og etternavn. I NAV benyttes ikke folkeregistrert navn, men visningsnavn som kun inneholder fornavn og etternavn. |
Folkereg. via PDL |
|
epost |
Nei |
Personlig NAV-epostadresse |
Exchange via AD |
|
visningsNavn |
Nei |
Navnet ressursen bruker i NAV. Formatert <Fornavn Etternavn> Ofte er antall mellomnavn redusert eller fjernet. Kan avvike noe fra folkeregistrert navn |
Remedy via AD |
|
fornavn |
Nei |
Fornavn for ressursen. Dersom man ønsker å ha med folkeregistrert mellomnavn blir den en del av fornavn her. Fra visningsnavnet, kan avvike fra folkeregisterert navn. |
||
etternavn |
Nei |
Etternavn for ressursen. Fra visningsnavnet, kan avvike fra folkeregisterert navn. |
||
sluttDato DEPRECATED |
Nei |
Ressursens sluttdato. Pga. dårlig datakvalitet er feltet satt til deprecated i API-et inntil videre. Statlig ansatt: sluttDato i Unit4 brukes hvis satt, ellers brukes Remedy sluttdato Kommunalt ansatt: Sluttdato i Remedy benyttes annenStat (Helfo m.fl.): Sluttdato i Remedy benyttes Ekstern: Sluttdato i Remedy benyttes Ved permisjonsflagg i Remedy på statlig ansatte, kommunalt ansatte og eksterne brukes samme logikk som over, men hvis sluttDato da ikke er satt så tillates NULL. Dette betyr at ressursen ikke har sluttdato. For annenStat settes sluttdato til datoen permisjonsflagget settes i Remedy, selv om ressursen er aktiv. |
Remedy og Unit4 via DVH |
|
telefon |
Ja |
Liste av telefonnumre på ressursen. Kan inneholde både private og NAV-utdelte personlige telefonnumre. |
Se Telefon-objekt |
Telenor og Remedy via DVH |
ledere |
Ja |
Liste av ledere for ressursen. Normalt kun én leder, men for ressurser som er ansatt i en orgEnhet og jobber i en annen kan det være flere.- Per juni 2023 kun populert for statlige og kommunalt ansatte ressurser. Planlagt å få inn leder for eksterne i løpet av 2023. |
Se eget objekt RessursLeder |
Unit4 via DVH |
lederFor |
Ja |
Liste av LederOrgEnhet-objekter som representerer orgEnheter akuell ressurs er leder for. Kan ha 0, 1 eller flere forekomster. Merk at LederOrgEnhet.gyldigFom og LederOrgEnhet.gyldigTom her p.t. er dummydato og viser innlastingsdato (normalt dagens dato eller gårsdagen) eller NULL. Planlagt forbedring i datokvalitet her i 2024. |
Unit4 via DVH |
|
orgTilknytning |
Ja |
Ressursens orgtilknytning til orgEnheter. Alle aktive ressurser må ha en knytning til en orgEnhet, med unntak av eksterne som per i dag ikke har denne knytningen (planlagt innført i 2023). Hvis en ressurs er ansatt i en orgEnhet og jobber i et annet kan vedkommende ha flere samtidige koblinger. OrgEnheter man har vært ansatt i eller jobbet ved tidligere listes også her med angivelse av periode. Merk at historiske orgTilknytninger ikke er komplett, og går kun noen få år tilbake. |
Se eget objekt RessursOrgTilknytning |
Unit4 via DVH |
2.6. RessursLeder
Beskrivelse:
Knytning mellom en ressurs og vedkommendes leder. Alle ressurser med unntak av NAV-direktøren skal ha en leder.
Fremtidig: : Per juni 2023 mangler de eksterne også leder, med unntak av noen ytterst få, men det vil komme på plass i løpet av 2023. I dag støttes ikke historikk over ledere for en ressurs, så gyldighetsperiodene som er angitt er per juni 2023 kun dummydata.
Felt | Påkrevd | Beskrivelse | Eksempel | Kilde |
---|---|---|---|---|
ressurs |
Ja |
Personen som er leder for den aktuelle ressursen |
Se Ressurs-objekt |
Unit4 via DVH |
erDagligOppfølging |
Ja |
Angir om denne lederen er den som har det daglige oppfølgingsansvaret for ressursen. Det innebærer at lederen har det daglige ansvaret for bl.a. sykefraværsoppfølging, godkjenning i MinWinTid, og har tilgang til den ansatte i Læringsportalen. |
TRUE/FALSE |
Unit4 via DVH |
gyldigFom |
Ja |
Datoen personen ble leder for ressursen. Per juni 2023 kun dummydata. |
Dummydato |
Unit4 via DVH |
gyldigTom |
Nei |
Siste dag personen var leder for den aktuelle ressursen. Per juni 2023 kun dummydata/NULL. |
Dummydato/Null |
Unit4 via DVH |
2.7. RessursOrgTilknytning
Beskrivelse:
RessursOrgTilknytning er knytningen mellom en ressurs og en organisasjonsenhet. En ressurs kan flere ressursOrgTilknytninger samtidig, f.eks. hvis vedkommende er ansatt i en orgEnhet og utlånt til en annen orgEnhet. En ressurs kan maks ha én ressursOrgTilknytning til en gitt orgEnhet på et gitt tidspunkt.
Eksempler:
Ansatt Ola har en ressursOrgTilknytning til orgEnhet NAV Halden Stab i perioden 01.01.2020 - 31.03.2022.
Felt | Påkrevd | Beskrivelse | Eksempel | Kilde |
---|---|---|---|---|
orgEnhet |
Ja |
orgEnheten ressursen er koblet til |
Se OrgEnhet-objekt |
Unit4 via DVH |
erDagligOppfølging |
Ja |
Angir om den aktuelle orgTilknytningen er der ressursen får sin daglige oppfølging. Med daglig oppfølging menes at lederen i denne orgEnheten har det daglige ansvaret for bl.a. sykefraværsoppfølging, godkjenning i MinWinTid, og har tilgang til den ansatte i Læringsportalen. Det kan finnes flere orgTilknytninger hvor flagget er TRUE, men aldri med overlappende gyldighetsperiode. |
TRUE/FALSE |
Unit4 via DVH |
gyldigFom |
Ja |
Datoen ressursen er tilknyttet orgEnheten. Kan være frem i tid. |
2009-01-22 |
Unit4 via DVH |
gyldigTom |
Nei |
Siste dag ressursen er tilknyttet orgEnheten. Kan være frem i tid. Oftest NULL fordi ressurser er i et løpende arbeidsforhold |
2020-02-14, NULL hvis ikke satt. |
Unit4 via DVH |
2.8. Telefon
Beskrivelse:
Telefon mastres ikke i NOM, men tilbys i våre API-er as-a-service. I dag støttes ikke privattelefon, men er planlagt å støttes på sikt.
Felt | Påkrevd | Beskrivelse | Eksempel | Kilde |
---|---|---|---|---|
nummer |
Ja |
Telefonnr med retningsnummer |
4712345678 |
Telenor via DVH |
type |
Ja |
Angir typen telefon, både private og NAV-utdelt nr støttes. |
NAV_TJENESTE_TELEFON, NAV_KONTOR_TELEFON, PRIVAT_TELEFON |
DVH |
beskrivelse |
Nei |
Per juni 2023 er feltet tomt for alle. |
DVH |
4. Hendelser
I dag støtter ikke NOM hendelser som konsumenter kan abonnere på. Det ligger derimot i planene å tilby hendelser over Kafka når NOM tar over som master for ressurs og orgEnhet. Dersom det er behov for Kafkahendelser før den tid, vil det vurderes å tilby dette tidligere. Ta kontakt på #nom
På sikt vil NOM tilby hendelser som f.eks.:
-
OrgEnhet opprettet
-
OrgEnhet nedlagt
-
OrgEnhet har fått ny leder
-
Ressurs opprettet
-
Ressurs sluttet
-
Ressurs tilkoblet ny orgEnhet
-
Ressurs har fått ny leder
-
Ressurs fratred som leder