REVIEWET Denne side indeholder retningslinjer for navngivning af de forskellige elementer i relation til Orkestreringskomponentens snitflader, hvor der er behov for stringent navngivning.
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 indeks-funktionalitet, 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 2 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 2 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 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