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

Begrepsdefinisjon

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

Begrepsdefinisjon

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

3. Integrasjon

NOM tilbyr integrasjon via GraphQL. Kafka er planlagt på sikt.

3.1. GraphQL

GraphQL kan prøves ut i dev, eller prod. Det ligger lastet inn pre-utfylte forespørsler som kan bygges videre på.

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