Navngivningsregler

Overview

 Denne version af navngivningsregler indeholder retningslinjer for:

• Navngivning af datamodeller

• Datakilde - tildeling af ItSystemID og navngivning af datakilder

• MyndighedsKode

• Visningsklient

Navngivning af datamodeller

Anvendelse: Anvendes ved brug af Indeksfunktionalitet, i forbindelse med opdatering af data i Indeks. Anvendes endvidere internt i Orkestreringskomponenten.

Retningslinje:

Datamodeller navngives ved at tilføje et standard prefix til det datadomæne som datamodellen favner, uden bindestreg eller lign.

Prefix for alle datamodeller er: Borgervendt

Følgende datadomæner er identificeret:

• Sag

• OekonomiskYdelse

• Betaling

• Gaeld

• AftaleFrister

Eksempel:

• BorgervendtSag 

Datakilde

Anvendelse: Datakilde anvendes af Orkestreringskomponent og visningsklienter til at styre hvor data skal hentes (på engelsk: context based routing).

Retningslinje:

For en datakilde er der to attributter der skal udfyldes af datakilder:

• ItSystemID: For ItSystemId tildeles datakilden et UUID, der genereres af Orkestreringskomponent-forvaltningen

• ItSystemnavn: Vælges frit af datakilden, men her anbefales at sammensætte navnet af CVR-nummer for organisation der ejer datakilden og systemets navn, adskilt af en bindestreg:

Format: <CVR-nummer><-><systemnavn> 

Eksempel: 

• KOMBIT iTSystemID: 0f52fab1-6c18-448e-99c3-6f68e343d52b

• KOMBIT itSystemnavn: 19435075-BOB

Visningsklient

Anvendelse: Visningsklient anvendes af Orkestreringskomponent til aftalestyring, herunder udvælgelse af hvilke datakilder der skal kaldes for at fremsøge data.

Retningslinje:

For en visningklient er der to attributter, der skal fastsættes:

• VisningsklientID: visningsklientId tildeles et UUID, der genereres af Orkestreringskomponent-forvaltningen

• Visningsklientnavn: Vælges frit af visningsklienten, men her anbefales at sammensætte navnet af CVR-nummer for organisation der ejer visningsklienten og systemets navn, adskilt af en bindestreg:

Format: <CVR-nummer><-><systemnavn>

Eksempel: 

• Borger.dk: 7fecca9a-b27b-429b-a74c-27564d657b75

• Borger.dk visningsklientnavn: 34051178-borger.dk

MyndighedsKode

Anvendelse: MyndighedsKode skal angives i henhold til datamodeller i elementet Myndighed. Denne attribut anvendes af Orkestreringskomponenten til aftalestyring, dvs. det valideres, at der findes en gyldig databehandleraftale for data, der modtages fra en datakilde.

Retningslinje:

• Myndighedskode tildeles af Orkestreringskomponenten og kommunikeres til datakilder, således at de kan indsætte den korrekte værdi i svar på forespørgsler fra Orkestreringskomponenten.

• For kommuner vil Myndighedskode være lige kommunekode, som det er registreret i CPR-kontoret myndighedsregister

• For statslige myndigheder, fx styrelser, vil Myndighedskode være lig med CVR-nummer, som det er registreret i virksomhedsregistret. 

Eksempel:

• Uddannelses og Forskningsstyrelsen: 34042012

• Roskilde kommune: 265