Specifikation af Model for Klassifikation Version 2.0

Transkript

1 1 Specifikation af Model for Klassifikation Version 2.0

2 > Specifikation af Model for Klassifikation Version 2.0 Denne standard kan frit anvendes af alle. Citeres der fra standarden i andre publikationer til offentligheden, skal der angives korrekt kildehenvisning. Standarden er udarbejdet af en arbejdsgruppe under OIO-udvalget for sagsog dokumentområdet. Version 1.2 er udarbejdet i regi af Den fællesoffentlige Styregruppe for Sag og Dokument. Version 2.0 er udarbejdet i regi af den fællesoffentlige Styregruppe for Data og Arkitektur. Arkitektur.digst.dk 2

3 > Specifikation af Model for KLASSIFIKATION (Klassifikationsmodellen) Version 2.0 Styregruppen for Data og Arkitektur 10. april

4 Indhold Indholdsfortegnelse Indledning 5 Formål med Klassifikationsmodellen 5 Ændringer siden version Egenskaber for Klassifikationsmodellen 7 Diagrammer 7 Forretningsobjekter 7 Universelt Unik, persistent identifikation af forretningsobjekter 8 Attributter 9 Datatyper 9 Mulighed for tilpasning af attributters udfaldsrum 10 Relationer 10 Virkning 10 Klassifikationsmodellen 12 Klassifikationsbegrebet 12 Diagram for Klassifikationsmodellen 13 Forretningsobjekter i Klassifikationsmodellen 14 Centrale Forretningsobjekter 14 Hjælpeobjekter 15 Eksternt definerede forretningsobjekter 15 Klassifikation 16 Attributter 16 Relationer 17 Facet 18 Attributter 18 Relationer 19 Klasse 20 Attributter 20 Relationer 21 Søgeord 23 Attributter 23 Relationer 23 Referencer i Klassifikationsmodellen 24 Bilag 1: Retteblad til version

5 Indledning > Formål med Klassifikationsmodellen Nærværende dokument specificerer Klassifikationsmodellen, som er en informationsmodel for Klassifikationer. Klassifikationer (eller klassifikationssystemer) dækker over ordnede videnssystemer, som kan anvendes til emnemæssig opmærkning. FORM (den Fællesoffentlige Reference Model) (se [FORM] og KL s Emnesystematik (KLE, se [KLE]) er eksempler på klassifikationer, der kan beskrives af Klassifikationsmodellen. I praksis vil al slags systematisk klassifikation med en eller flere facetter (gruppe af begreber tilhørende samme kategori) kunne beskrives med Klassifikationsmodellen, herunder kontoplaner, uddannelseskategorier, kompetencemodeller, sundhedsfaglige klassifikationssystemer osv. Formålet med Klassifikationsmodellen er, at den skal kunne give en ensartet beskrivelse af forskellige klassifikationssystemer med tilhørende oplysninger, samt kunne tilføre klassemærker eller journalnøgler (entries fra klassifikationssystemer/journalplaner beregnet til opmærkning) til andre modeller som fx Sagsmodellen, Dokumentmodellen og Organisationsmodellen. Ændringer siden version 1.1 Klassifikationsmodellen er en revision af Specifikation af serviceinterface for Klassifikation. Version 1.1 (OIO Klassifikation 1.1). Klassifikationsmodellen er udarbejdet som en del af en samlet revision af specifikationerne, som samlet set omtales standarderne for OIO Sag og Dokument: Specifikation af serviceinterface for Dokument, Version (OIO Dokument). Specifikation af serviceinterface for Organisation, Version 1.1 (OIO Organisation). Specifikation af serviceinterface for Klassifikation, Version 1.1 (OIO Klassifikation). Specifikation af serviceinterface for Sag, Version 1.2 (OIO Sag). Specifikation af serviceinterface for Arkivstruktur, Version 1.1 (OIO Arkiv). Generelle egenskaber for serviceinterfaces på sags- og dokumentområdet, Version 1.1 (OIO Generelle egenskaber). OIO Arkiv har ingen kendte implementeringer. Endvidere har ingen af de adspurgte interessenter udtrykt et forretningsbehov for at tage den i anvendelse. Specifikationen revideres derfor ikke, men afpubliceres og udgår som standard. OIO Generelle egenskaber indeholder specifikke krav til udstilling af data i webservices. Erfaringerne fra implementering af standarderne er, 5

6 at de generelle egenskaber er svære at forstå og kommunikere. Det kan give anledning til misforståelser mellem kravstillere og udviklere. Specifikationen revideres derfor ikke, men afpubliceres og udgår som standard. OIO Generelle egenskaber udgår. Derfor kan Klassifikationsmodellen stå alene i forhold til forståelsen af modellens forretningsobjekter. I hver af de opdaterede specifikationer er der indført et afsnit om egenskaber for modellen. Her findes beskrivelse af modelnotation, forretningsobjekter, unik identifikation, attributter og relationer anvendt i Klassifikationsmodellen. Denne beskrivelse er ens for de fire opdaterede standarder. 6

7 Egenskaber for Klassifikationsmodellen > Klassifikationsmodellen er en informationsmodel, der giver en grafisk og tekstuel beskrivelse af Klassifikation (jf. [GODPRAKSIS]). I beskrivelsen er anvendt en række modelelementtyper: Som notation er anvendt UML klassediagram til beskrivelse af Klassifikationsmodellen. UML-pakker er anvendt med henblik på sammenhæng og genbrug af modelelementer på tværs af modeller. Forretningsobjekter er i Klassifikationsmodellen repræsenteret af en UML-klasse. Universelt unik, persistent identifikation af forretningsobjekterne i Klassifikationsmodellen er obligatorisk. Attributter beskriver informationsindholdet i Klassifikationsmodellen. Relationer repræsenterer de strukturelle sammenhænge mellem forretningsobjekter i Klassifikationsmodellen. Modelelementtyperne og brugen af dem i Klassifikationsmodellen er forklaret yderligere i de følgende afsnit. Diagrammer UML klassediagram udgør rammen for beskrivelse af Klassifikationssmodellen og forretningsobjekterne, der indgår heri, og deres relationer. Formålet med diagrammet er visuelt at kommunikere de forskellige metadata, der indgår i beskrivelsen af klassifikationer. Diagrammet forklares uddybende i den medfølgende tekst. Som en visuel hjælp til forståelsen af diagrammet benyttes i diagrammerne elementer, som ikke indgår i et normalt UML Klassediagram. Farvemarkering benyttes til at indikere, hvilke forretningsobjekter der defineres i modellen (grå), og hvilke der er eksternt definerede (blå). Alle forretningsobjekter, attributter og relationer defineres og beskrives i afsnittene efter diagrammet. Forretningsobjekter Et forretningsobjekt er i UML Klassediagrammet repræsenteret af en UML Klasse. Forretningsobjekterne i Klassifikationsmodellen er beskrevet som vist i tabellen nedenfor: Forretningsobjekt Definition Beskrivelse Navn Entydigt klassenavn for det forretningsmæssige begreb. En kort og præcis definition. Uddybende beskrivelse og eksemplificering af forretningsobjektet. Tabel 1 Forretningsobjekter i Klassifikationsmodellen 7

8 Universelt Unik, persistent identifikation af forretningsobjekter Universelt unik, persistent identifikation er obligatorisk for forretningsobjekterne i Klassifikationsmodellen. Unik identifikation er beskrevet igennem attributten ID og bør være af typen http-uri. Http-URI anvendes bl.a. af Grunddataprogrammet og i Den Fællesoffentlige Digitaliseringsstrategi I retningslinjerne for stabile URI er er beskrevet, hvordan eksisterende identifikatorer som fx UUID og URN kan genbruges med brug af http-uri (se [HTTPURI]). UUID (Universal Unique IDentifier jf. [RFC4122]) kan anvendes i konstruktionen af http-uri for forretningsobjekterne i Klassifikationsmodellen. Egenskaberne ved UUID garanterer, at identifikatoren er universelt unik. Eksempel på UUID: 91aa87da-9f06-11e7-abc4-cec278b6b50a Eksempel på repræsentation af UUID i http-uri-form: cec278b6b50a/ Http-URI en bør konstrueres, så det kan resolveres, hvilken objekttype en UUID er identifikator for, fx om det er OrgEnhed, Dokument, Sag mv. Eksempelvis en http-uri for et klassifikationssystem: Der kan være tilfælde, hvor det er nødvendigt at anvende en anden identifikator end UUID i konstruktion af http-uri. For klassifikationssystemer kan det være hensigtsmæssigt at have læsbare http-uri er, hvor klassen kan læses ud fra identifikatoren. I retningslinjerne for stabile http-urier (se [HTTPURII] er også anvist, hvordan en http-uri i så fald kan konstrueres: Eksempel med emneklassen i klassifikationssystemet KLE som identifikator, der indgår i konstruktion af http-uri: Eksempel med registreringsnummeret VZ26979 på køretøj som identifikator, der indgår i konstruktion af http-uri: I tabellen nedenfor er vist, hvordan kravet om universelt unik, persistent identifikation af forretningsobjekter er beskrevet i modellen: Betegnelse Beskrivelse Udfaldsrum ID Forretningsobjektets universelt unikke, persistente identifikator. Angives som http-uri (se [HTTPURI]), eksempelvis: Se også nærmere beskrivelse i afsnit ovenfor om universelt unik, Http-URI 8

9 Betegnelse Beskrivelse Udfaldsrum persistent identifikation af forretningsobjekter. Tabel 2 Universelt unik identfikation af objekter i Klassifikationsmodellen Attributter Klassifikationsmodellens informationsindhold for de respektive forretningsobjekter er repræsenteret af attributter. Attributter i Klassifikationsmodellen er beskrevet som vist i tabellen nedenfor: Betegnelse Beskrivelse Datatype Regel for udfyldelse Entydig navngivning af attributten inden for det enkelte forretningsobjekt. Den forretningsmæssige definition af attributten samt kort beskrivelse af dens anvendelse. Angivelse af navn på datatype for attributten. Hvis attributten har et udfaldsrum, som ikke er givet i datatypen, beskrives det også her. Tabel 3 Beskrivelse af attributter i Klassifikationsmodellen Beskrivelse af de regler for anvendelse, der gælder for attributten, fx om den er obligatorisk. Beskrivelsen af attributter kan være yderligere uddybet og eksemplificeret i afsnittet Beskrivelser af attributter, som følger efter tabellerne for attributter på forretningsobjekterne i Klassifikationsmodellen. Datatyper Klassifikationsmodellen skal kunne anvendes som udgangspunkt for transformation af modellens beskrivelse af forretningsdomænets indhold til konkrete datarepræsentationer, som kan udveksles mellem it-systemer. Datatyperne præciserer modellens beskrivelser som udgangspunkt for transformation til datarepræsentationer. Betegnelse Beskrivelse Datatype grundlag Restriktioner Navnet på datatypen. Beskrivelse af datatypen. Tabel 4 Beskrivelse af datatyper Angivelse af det konkrete datatype grundlag med anvendelse af XSDdatatyperne jf. [XSD]. Eventuelle restriktioner eller mønstre for datatypen. I tabellen nedenfor er beskrevet de anvendte datatyper i Klassifikationsmodellen: Betegnelse Beskrivelse Datatype grundlag Restriktioner Tekst Tekststreng. xsd:string Tekst- (enumeration ) Tekststreng med begrænsning i form af en kodeliste. xsd:string enumeration Heltal Helt tal uden decimaler. xsd:integer Http-URI For uddybende forklaring, se afsnit ovenfor om universelt unik, persistent identifikation af xsd:string jf. [HTTPURI] 9

10 Betegnelse Beskrivelse Datatype grundlag Restriktioner forretningsobjekter i Klassifikationsmodellen. Dato Dato uden tid xsd:date YYYY-MM-DD Dato og tidspunkt Præcis angivelse af dato og tid inkl. tidszone. xsd:datetime YYYY-MMDDThh: mm:ss.ssstzd Boolean Tabel 5 Datatyper i Klassifikationsmodellen xsd:boolean Mulighed for tilpasning af attributters udfaldsrum Klassifikationsmodellen rummer attributter, hvor udfaldsrummet er angivet med brug af datatypen Tekst(enumeration). Ved anvendelse af Klassifikationsmodellen vil der opstå behov for at udvide de pågældende udfaldsrum i forhold til den konkrete forretningsmæssige anvendelsessituation. I de tilfælde kan udfaldsrummet tilpasses på en af følgende måder: Udarbejde en ny enumeration med det nye udfaldsrum på attributten. Udarbejde klassifikation til at rumme det nye udfaldsrum. De konkrete værdier udtrykkes som Klasser i Klassifikationen. Fra forretningsobjektet i Klassifikationssmodellen tilføjes i modellen en relation til Klassifikationen, hvor Klasserne er udtrykt. Ved tilpasning af udfaldsrum for attributværdier må gerne tilføjes, men ikke fjernes, værdier fra udfaldsrummet. Relationer Relationer i Klassifikationsmodellen er vist i diagrammer med betegnelse på relationen og kardinalitet på det forretningsobjekt, som relationen peger på. Relationer er beskrevet som vist i tabellen nedenfor: Betegnelse Beskrivelse Relateret objekt Kardinalitet Et beskrivende navn på relationen. En kort og præcis definition på relationen. Tabel 6 Beskrivelse af relationer i Klassifikationsmodellen Det forretningsobjekt relationen peger på. Angiver rammerne for relationen. Beskrivelsen af relationer kan være yderligere uddybet og eksemplificeret i afsnittet Beskrivelser af relationer, som følger efter tabellerne. Virkning Virkning angiver de tidsperioder, hvori forretningsobjektet har virkning. Virkning skal angives i Klassifikationsmodellen, hvor der er forretningsmæssigt behov for at udtrykke en virkningsperiode. Virkning er i Klassifikationsmodellen beskrevet som vist i tabellen 10

11 nedenfor: Betegnelse Beskrivelse Datatype VirkningFra Angivelse af tidspunkt for virkningsperiodes start. Dato VirkningTil Angivelse af tidspunkt for virkningsperiodes slut. Dato Tabel 7 Beskrivelse af virkning Ved angivelse af tid i fra/til intervaller, angives intervallerne lukkede i starten og åbne i enden (inclusive/exclusive). Eksempelvis VirkningFra Dato , er inkluderet (inclusive) i virkningsperioden. VirkningTil Dato, fx er ikke inkluderet (exclusive) i virkningsperioden. 11

12 Klassifikationsmodellen > Formålet med Klassifikationsmodellen er at give en ensartet ramme for beskrivelse af klassifikationssystemer. Klassifikationsmodellen beskrives igennem: Introduktion til klassifikationsbegrebet. Diagram for Klassifikationsmodellen. Beskrivelse af forretningsobjekter, attributter og relationer i Klassifikationsmodellen. De enkelte punkter uddybes i de følgende afsnit. Klassifikationsbegrebet Klassifikation er en facetplan, idet Klassifikation også skal kunne indeholde facetsystemer som KLE og FORM. En facetplan er en emnebaseret registreringssystematik. For statslige myndigheder er det obligatorisk at anvende en registreringssystematik, som er dækkende for emneområdet i deres it-systemer med dokumenter (Se [CIR9290]). En facetplan består typisk af et antal parallelle lister, der hver især repræsenterer et bestemt aspekt af sager og objekters indhold. Se følgende figur, der med udgangspunkt i KLE illustrerer, hvordan klassifikationssystemer udgøres af én til flere facetter: Figur 1 Klassifikationssystem bygget op af facetter Facetplaner er typisk opbygget på den måde, at hele klassifikationssystemet er opdelt i et til flere separate facetter, som udgør forskellige systematikker. Facetplaner opfattes normalt som en kombination af flere facetter. Ved anvendelse af klassifikationssystemet til opmærkning, fx af en sag, kombineres klasser fra de separate facetter. Eksempelvis rummer klassifikationssystemet KL Emnesystematik (KLE) to facetter som vist i Figur 1 ovenfor: Emneplanen (som tager udgangspunkt i opgaver), og handlingsfacetplanen (som tager udgangspunkt i den administrative handling). Hvis en kommune vil bruge KLE til opmærkning af en sag om klage over hjemmehjælp, anvendes klasser fra begge facetter. Emnet opmærkes med en klasse fra facetten emneplan, Personlig og praktisk hjælp. Den administrative handling, altså 12

13 at det er en klagesag, opmærkes med en klasse fra facetten handlingsfacetplan, K02 Klage. Klassifikations centrale dele udgøres således af klassifikationssystemer (fx KLE eller FORM), som hver kan indeholde én til flere facetter. Hver facet indeholder klasser (emner), sideordnet eller i hierarkier, som anvendes i den konkrete opmærkning af sager og øvrige forretningsobjekter. Klasser udgør de centrale elementer i klassifikationssystemer. Figur 2 nedenfor viser med udgangspunkt i KLE et eksempel på, hvordan en klassifikation er bygget op med et hierarki af klasser, Facet og Klassifikation: Figur 2 Eksempel på opbygning af facetplan med Klassifikation Klassifikationen er KLE, og her er illustreret, hvordan emneplanen er en Facet. KLE er en taksonomi med hierarkisk ordnede Klasser i Hovedgruppe, Gruppe og Emne. Hierarkiet repræsenteres via Overordnet relationen imellem klasserne. Klassifikation kan også bruges til at beskrive mere enkle klassifikationssystemer som fx simple lister af værdier. Diagram for Klassifikationsmodellen I figuren nedenfor er vist diagram for Klassifikationsmodellen: 13

14 Figur 3 Diagram for Klassifikationsmodellen Klassifikationsmodellen beskriver de objekter, der hver især og igennem deres relationer til eksterne objekter udgør det nødvendige grundlag for beskrivelsen af en Klassifikation. Forretningsobjekter i Klassifikationsmodellen I Klassifikationsmodellen indgår følgende typer af forretningsobjekter: Centrale forretningsobjekter, som er defineret og ejet af Klassifikationsmodellen. Forretningsobjekter, som detaljerer beskrivelsen af det centrale forretningsobjekt (hjælpeobjekter). Eksterne forretningsobjekter, som er defineret og ejet af andre modeller De forskellige forretningsobjekttyper forklares nærmere i de følgende afsnit. Centrale Forretningsobjekter De centrale forretningsobjekter i Klassifikationsmodellen er defineret i tabellen nedenfor: Betegnelse Klassifikation Facet Beskrivelse Klassifikation beskriver en ordning af genstande, begreber eller emner i grupper, således at grupperne udgør en samlet struktur. Strukturen giver udtryk for relationerne mellem grupperne. Facet beskriver en systematik, hvori de indgående klasser har en eller flere egenskaber til fælles. 14

15 Klasse Klasse er en mængde, hvori de indgående objekter har en eller flere egenskaber til fælles. Et klassifikationssystem udgøres af klasser. Tabel 8 Centrale forretningsobjekter i Klassifikationsmodellen Hjælpeobjekter Søgeord er et hjælpeobjekt til beskrivelse af klasserne i Klassifikationsmodellen. Hjælpeobjekterne i Klassifikationsmodellen er beskrevet i tabellen nedenfor: Forretningsobjekt Navn Søgeord Definition Søgeord er termer, som efter opslag og søgning skal lede ind til de rette klasser i Klassifikation. Tabel 9 Hjælpeobjekter i Klassifikationsmodellen Beskrivelse Søgeord kan bruges til at hjælpe brugerne af et klassifikationssystem med at finde de rigtige klasser ved hjælp af andre termer end klassens titel. Der kan være mange søgeord til en klasse. Eksternt definerede forretningsobjekter Som en visuel hjælp til forståelse af diagrammet for Klassifikationsmodellen er de eksternt definerede forretningsobjekter i Figur 4 ovenfor vist med blå farve. De eksternt definerede forretningsobjekter i Klassifikationsmodellen er beskrevet i tabellen nedenfor: Betegnelse Definition Ekstern model Organisation En organisation er en [ORG] anerkendt juridisk enhed med rettigheder og ansvar. Beskrivelse Eksempler på organisationer er myndigheder (fx et ministerium, en styrelse, en kommune) eller virksomheder. OrgEnhed OrgEnhed er som enhed en del af en Organisation og har kun fuld anerkendelse i forbindelse med denne. [ORG] Forretningsobjektet OrgEnhed giver struktur på organisationen og anvendes til at opbygge organisationshierarkier. OrgEnheder kan spænde fra mindre enheder, som fx teams eller grupper, til store og komplekse enheder, som indeholder andre enheder. Retskilde Er en kilde, som giver svar på, hvad der er ret. [ELI] Eksempler på OrgEnheder er afdelinger, sektioner, kontorer, udvalg, projektgrupper, styregrupper, klasser, hold og lignende. Rummer henvisning til den lov og eventuelt, som en bestemt opgave udføres i henhold til. Omfatter også bekendtgørelse, cirkulære og andre centralt fastsatte regler, der regulerer opgaven. KLE og FORM har henvisninger til de retskilder, der er grundlag for de opgaver, som er beskrevet i taksonomierne. Tabel 10 Eksternt definerede forretningsobjekter i Klassifikationsmodellen 15

16 Klassifikation > Klassifikationssystem, eller blot klassifikation, er en systematik bestående af en eller flere facetter. Man kan referere til klassifikation med en entydig ID og dermed relatere til en bestemt systematik. Klassifikationsmodellen kan understøtte anvendelse af flere klassifikationer, og med den entydige ID kan man skelne mellem disse. Figur 4 Diagram for forretningsobjektet Klassifikation Attributter Klassifikation har følgende attributter: Betegnelse Beskrivelse Datatype Regel for udfyldelse ID Forretningsobjektets universelt unikke, persistente identifikator. Http-URI Obligatorisk Angives som http-uri (se [HTTPURI]), eksempelvis: mne# Se også nærmere beskrivelse i afsnit ovenfor om universelt unik, persistent identifikation af forretningsobjekter. Kaldenavn Betegnelse for klassifikationssystem Officiel - i forbindelse med anvendelse af standard klassifikationssystem fra en klassifikationssystemleverandør. Tekst Obligatorisk Beskrivelse Kaldenavn er også klassifikationssystemets brugervendte nøgle. Uddybende beskrivelse af klassifikationssystem. Tekst Ikkeobligatorisk Version Versionsangivelse af klassifikationssystem. Tekst Ikkeobligatorisk 16

17 PubliceretIndikator Boolean Obligatorisk Ophavsret VirkningFra Angivelse af evt. ophavsret for klassifikationssystem. Klassifikationssystemer fra eksterne leverandører kan have ophavsretslige bindinger, som skal respekteres. Angivelse af dato hvor klassifikationssystemet har virkning fra. VirkningTil Angivelse af dato hvor klassifikationssystemet har virkning til Tabel 11 Attributter for forretningsobjektet Klassifikation Tekst Dato Dato Ikkeobligatorisk Ikkeobligatorisk Ikkeobligatorisk Relationer Klassifikation har følgende relationer: Betegnelse Beskrivelse Objekttype Kardinalitet Ejer Ansvarlig Angiver den organisation, som objektet tilhører. Ejer er globalt juridisk ansvarlig for Klassifikationssystemet. Fx er KL ejer af Klassifikationssystemet KLE (jf [KLE]). Angiver den organisation eller OrgEnhed, der er ansvarlig og har forvalterrollen for Klassifikationssystemet i aktuelle anvendelse. Organisation 1..1 Organisation OrgEnhed 0..1 Skal kun udfyldes, hvis ansvarlig Organisation er en anden end Ejer. TilhørendeFacet Angiver den eller de facetter, der indgår i et klassifikationssystem. Tabel 12 Relationer fra Klassifikation Facet 1..n 17

18 Facet > En facet beskriver det ordningsprincip, som gælder for de klasser, der relaterer til facetten. En facet kan relatere til en klassifikation. En facet kan indgå i en kombineret opmærkning, hvor der anvendes klasser fra to eller flere facetter i opmærkningen. Facet kan dermed anvendes til at opbygge klassifikationssystemer bestående af en eller flere facetter, som afspejler forskellige aspekter. Eksempelvis har KLE facetterne Emne og Handling, som bruges i kombination til opmærkning af sager i kommunerne. Emne bruges til opmærkning af, hvad opgaven er for kommunen, fx Personlig og praktisk hjælp. Handling bruges til opmærkning af, hvad den administrative handling er, fx behandling af klage K02 Klage. De to facetter bruges i kombination til at angive den fulde journalnøgle K02, som fortæller, at sagen er en klagesag om emnet personlig og praktisk hjælp. En facet skal ikke relatere til en klassifikation. Figur 5 Diagram for Forretningsobjektet Facet Attributter Forretningsobjektet Facet har følgende attributter Betegnelse Beskrivelse Datatype Regel for udfyldelse ID Forretningsobjektets universelt unikke, persistente identifikator. Http-URI Obligatorisk Angives som http-uri (se [HTTPURI]), eksempelvis: Se også nærmere beskrivelse i afsnit ovenfor om universelt unik, persistent identifikation af forretningsobjekter. 18

19 BrugervendtNøgle Dette er den entydige betegnelse for en facet inden for klassifikationen. Tekst Obligatorisk FacetBeskrivelse T a FacetOphavsret b e l Uddybende beskrivelse, formål, indhold, gyldighedsområde, mv. Tekstuel beskrivelse af evt. ophavsret for pågældende facetplan. Tekst Tekst Ikkeobligatorisk Ikkeobligatorisk 1 3 A t t FacetSupplement r i b u t t e r Hvis facettens ophavsret afviger fra ophavsret for klassifikation, angives det her. Det skal bruges, hvis en facets klasser er importeret fra ekstern leverandør, eller hvis en ekstern klassifikation har fået tilføjet en lokal facet. Angivelse om og hvordan det er muligt at tilføje klasser til facetten. Angiver om og hvordan en organisation må tilføje eller specialisere facetten med egne klasser, der virker sammen med facet fra ekstern leverandør. (Se fx [KLEKRAV] for uddybende beskrivelse.) Tekst Ikkeobligatorisk f o r Eksempel 1: #9.#9.#9 angiver, at ved lokale klasser skal brugervendt nøgle for klasse slutte med ciffer 9 på alle niveauer. f Eksempel 2: ##.##.##.## angiver, at o facetopbygningen kan udvides med r et lokalt specialiseringsniveau. r etningsobjektet Facet Relationer Facet har følgende relationer: Betegnelse Beskrivelse Objekttype Kardinalitet Ejer Ansvarlig Retskilde Angiver den organisation, som objektet tilhører. Ejer er globalt juridisk ansvarlig for facetten. Angiver den organisation eller OrgEnhed, der er ansvarlig for Klassifikationssystemet i aktuelle anvendelse. Relation til retskilde som facetttens klasser reguleres af. KlassifikationTilhørsforhold Angiver den Klassifikation Facetten tilhører. Tabel 14 Relationer fra forretningsobjektet Facet Organisation 1..1 Organisation OrgEnhed 0..1 Retskilde 0..1 Klassifikation

20 Klasse > Klasse beskriver de konkrete klasser, som bruges til klassifikation af objekter. Disse klasser kan være ordnet på forskellig vis. En liste uden niveauer er den simpleste. En hierarkisk liste kan have overog underemner. Klasser kan endvidere også have sideordnede klasser (henvisninger), også kaldet relaterede klasser. De relaterede klasser skal kunne tilgås fx i forbindelse med opmærkning af sager og dokumenter. Figur 6 Diagram for forretningsobjektet Klasse Attributter Klasse har følgende attributter: Betegnelse Beskrivelse Datatype Regel for udfyldelse ID Forretningsobjektets universelt unikke, persistente identifikator. Http-URI Obligatorisk Angives som http-uri (se [HTTPURI]), eksempelvis: # BrugervendtNøgle Se også nærmere beskrivelse i afsnit ovenfor om universelt unik, persistent identifikation af forretningsobjekter. Dette er den entydige identifikator for klassen indenfor facetten. Tekst Ja Identifikatoren er en streng, hvor tilladte karakterer er bestemt af facettens attribut facetopbygning, samt attributten facetsupplement. KlasseBeskrivelse Uddybende beskrivelse af klassen. Tekst Nej KlasseTitel Kortfattet, præcis titel for klassen. Tekst Ja 20

21 KlasseEksempel Et illustrerende eksempel på brug af emnet. Tekst Nej AendringsNotat AendringsDato Når en redaktør ændrer klassens indhold, kan han her skrive hvad og hvorfor, der er ændret. Dato hvor Klasse er blevet ændret Relationen ÆndretAf skal udfyldes for at angive, hvem i organisationen der har lavet ændringen. Tekst VirkningFra Tidspunkt klassen har virkning fra Date Nej Dato Nej Obligatorisk ved ændring VirkningTil Tidspunkt klassen har virkning til Date Nej Tabel 15 Attributter for forretningsobjektet Klasse Relationer Klasse har følgende relationer: Betegnelse Beskrivelse Objekttype Kardin alitet Ejer Ansvarlig Angiver den organisation, som klassen tilhører. Ejer er globalt juridisk ansvarlig for klassen. Fx er KL ejer på de fleste klasser i KLE, imens en kommune kan være ejer af lokale klasser. Angiver den organisation eller OrgEnhed, der er ansvarlig for klassen i den aktuelle anvendelse. Organisation 1..1 Organisation OrgEnhed 0..1 ÆndretAf Anvendes til at angive, når det ikke er Organisationen, som ejer klassifikationen, der er ansvarlig for en konkret anvendelse af en klasse. OrgPerson som har afstedkommet ændring i klassen. OrgPerson 1..1 Retskilde Overordnet Anvendes til at angive, hvem der har ændret i en klasse. Relation til retskilde som facetttens klasser reguleres af. Retskilde er fx anvendt i KLE, hvor en række Emne(klasser) har relation til den retskilde, hvoraf emnet udspringer. Angiver at en klasse er overordnet en anden. Retskilde 0..1 Klasse 0..1 Med denne relation kan man angive niveauer og hierarkier mellem klasser i samme facet. Fx kan man opbygge hierarkiet i en emneklassifikation som KLE, hvor en Hovedgruppe er en klasse, som er overordnet klassen Gruppe, som igen er overordnet klassen Emne. Man må ikke nedlægge klasser, som har Overordnetrelationer med gyldig virkningsperiode. Sideordende Angiver sideordnede (relaterede) klasser. Klasse 0..n Kan anvendes ved henvisning eller sideordnet relation indenfor samme facet. Anvendes eksempelvis til at angive, at to eller flere klasser tilhører den samme gruppering, fx en gruppe i KLE. Mapninger Angiver mapning mellem klasser tilhørende forskellige facetter og ikke nødvendigvis inden for samme Klassifikationssystem. Klasse 0..n Anvendes til at angive associationer mellem klasser, som kan berige hinanden. Fx findes en mapning 21

22 Betegnelse Beskrivelse Objekttype Kardin alitet mellem KLE og FORM, som beskriver, hvordan en emneklasse i KLE relaterer sig til en opgaveklasse i FORM. Tilføjelser Angiver at en lokal klasse er tilføjet inden for samme facet. Kan anvendes til at angive, at man har foretaget en tilføjelse af klasser. Klasse 0..n En lokal klasse er en klasse, som en Organisation eller OrgEnhed har tilføjet et Klassifikationssystem, som kun har gyldighed inden for denne organisatoriske afgrænsning. Fx har kommuner mulighed for på udvalgte områder af KLE selv at tilføje Emneklasser. Erstatter Angiver at en klasse erstatter en klasse inden for samme facet. Klasse 0..n Kan anvendes til at angive, hvis en eller flere klasser erstattes af en eller flere andre klasser inden for samme facet. Hvis fx én emneklasse i KLE udgår og erstattes af en anden emneklasse, kan relationen bruges til at holde den information. LovligeKombination Kan anvendes til at angive lovlige og foretrukne er sammensætninger af klasser fra forskellige facetter, f.eks. at angive at én klasse i en emnefacet kombineres med én bestemt klasse i en handlingsfacet Klasse 0..n I KLE bliver det fx brugt til at angive kendte sammenhænge mellem emner og handlingsfacetter Facettilhørsforhold Angiver den Facet en klasse tilhører. Fx at en Klasse i KLE tilhører Emnefacetten. Tabel 16 Relationer fra forretningsobjektet Klasse Facet

23 Søgeord Søgeord indeholder termer, som efter opslag og søgning skal lede ind til de rette klasser i Klassifikation. Attributter Søgeord har følgende attributter: Betegnelse Beskrivelse Datatype Regel for udfyldelse SøgeordIdentifikator Søgeord Søgeord indeholder termer som efter opslag, søgning o.l. skal lede ind til de rette klasser i Klassifikation. Tekst Søgeordsbeskrivelse Eksempel på brug af søgeord er termen hjemmehjælp, der leder hen til klassen Personlig og Praktisk hjælp i KLE. Evt. uddybende beskrivelse af søgeordet. Søgeordskategori Kategorisering af målgruppespecifikke søgeord. Eksempelvis administrative, virksomhedsrettede, borgerrettede eller finanslovsrettede. Tabel 17 Attributter for hjælpeobjektet Søgeord Tekst Tekst Ikkeobligatorisk Ikkeobligatorisk Ikkeobligatorisk Relationer Søgeord har følgende relationer: Betegnelse Beskrivelse Objekt Regel for udfyldelse Udpeger Søgeord udpeger Klasse i Klassifikationen. Klasse 1..1 Tabel 18 Relationer for hjælpeobjektet Søgeord 23

24 Referencer i Klassifikationsmodellen Nedenfor er angivet, hvilke referencer der er anvendt i Klassifikationsmodellen: Reference Titel Link til reference [KLASANVISNING] [CIR9290] [ELI] [GODPRAKSIS] Anvisninger til Klassifikationer i Sags- og Dokumentindekset og Ydelsesindekset, KOMBIT, Cirkulære nr af 21. Juni 2013 om anmeldelse og godkendelse af statlige myndigheders it-systemer Easier access to European legislation with ELI God praksis for informationsmodellering, OIOdatastandardisering i sektorerne, It- og Telestyrelsen okumenter/sts%20anvisninger/an visninger%20til%20klassifikationer %20i%20Indeksene%20v1.2.zip (senest tilgået ) /eli/retsinfo/2013/9290 (Senest tilgået ) (senest tilgået ) s/arkitektur-ogdata/datastandardisering/oiostandardisering/god_praksis_for_in formationsmodellering_-_oiodatastandardisering_i_sektorerne.p df. (senest tilgået ) [FORM] FORM (forretningsreferencemodel) rkitektur/klassifikationer/form (senest tilgået ) [GRUNDDATA] Modelregel 6.1 ALLE MODELENTITETER SKAL MODELLERES MED PERSISTENT, UNIK IDENTIFIKATION, Grunddatabestyrelsen k/node/828 (senest tilgået ) [HTTPURI] Retningslinjer for stabile http URI er [er under udarbejdelse under FODS] [KLEKRAV] KL specifikation af krav Understøttelse af KL Emnesystematik ng/kle_specifikation_af_krav_til_e (KLE) i esdh systemer, version 1.0, KL sdh_ver1.0.pdf (senest tilgået ) [OLDKLAS] Specifikation af serviceinterface for Klassifikation OIO Udvalget for Sag og Dokument, 2011 [RFC4122] "A Universally Unique IDentifier (UUID) URN Namespace" (senest tilgået ) [UNIKID] [XSD] Unikke identifikatorer til digitale objekter, It- og Telestyrelsen, 2006 W3C XML Schema Definition Language (XSD) 1.1 Part 2: Datatypes Tabel 18 Referencer i Klassifikationsmodellen 032/artefact/UIDstandard_endelig.pdf (senest tilgået ) a11-2/ (senest tilgået ) 24

25 Bilag 1: Retteblad til version 2.0 Dette retteblad indeholder de ændringer, der er foretaget i version x.x af standarden Specifikation af serviceinterface for klassifikation. Ændringer i "Klassifikationssmodellen" i forhold til "Specifikation af serviceinterface for Klassifikation, version 1.1" Afsnit i version Nye/ændrede afsnit i Ændring Beskrivelse af ændringer 1.1 Klassifikationsmodellen Indledning Revideret Afsnittet er skrevet om, så det afspejler ændringen fra specifikation af serviceinterface til specifikation af en informationsmodel Forord Udgået Afsnittet er erstattet af et nyt afsnit med beskrivelse af formål Formål med forretningsservice for Klassifikation Udgået Afsnittet er erstattet af nyt afsnit om formål Formål med Klassifikationsmodellen Nyt Formålsafsnit som afspejler ændringen fra specifikation af serviceinterface til specifikation af en informationsmodel Ændringer siden version 1.1 Nyt Afsnittet beskriver de overordnede ændringer Egenskaber for Klassifikationsmodellen Nyt Afsnittet beskriver de modelmæssige egenskaber ved Klassifikationsmodellen. Diagrammer Nyt Afsnittet beskriver, hvordan diagrammer er anvendt i beskrivelsen af Klassifikationsmodellen Forretningsobjekter Nyt Afsnittet beskriver, hvordan forretningsobjekter er beskrevet i modellen. Universelt unik, persistent identifikation af forretningsobjekter Nyt Afsnittet anviser retningslinjerne for unik identifikation af forretningsobjekterne i modellen. Attributter Nyt Afsnittet beskriver, hvordan attributter er beskrevet i modellen Datatyper Nyt Afsnittet præciserer, hvilke datatyper der er anvendt i modellen Mulighed for tilpasning af udfaldsrum Nyt Afsnittet præciserer, hvordan udfaldsrum i modellen kan tilpasses Relationer Nyt Afsnittet beskriver, hvordan relationer er beskrevet i modellen Virkning Nyt Afsnittet beskriver, hvordan virkingstid angives i modellen Begrebsliste Udgået Alle begreber defineres og beskrives i forbindelse med modellen Introduktion udgået Overordnede krav til forretningsservicen Sammenhæng til FESD Emnesystematik, herunder anvendelse af facetplan Eksempler på anvendelse Serviceinterface Klassifikation udgået udgået udgået Klassifikationsmodellen Revideret Afsnittet er skrevet om, så det afspejler ændringen fra specifikation af serviceinterface til specifikation af en informationsmodel Klassifikationsbegrebet Nyt Nyt afsnit som beskriver anvendelsen af klassifikationssystemer i forhold til klassifikationsmodellen Diagram for Klassifikationsmodellen Revideret Afsnittet illustrerer og beskriver et diagram for Klassifikationsmodellen, diagrammet er en revision af diagrammet, som er vist i 25

26 figur 3 på side 15 i version 1.1. Forretningsobjekter i Klassifikationsmodellen Nyt Afsnittet præsenterer forretningsobjekterne i Klassifikationsmodellen. Centrale forretningsobjekter Nyt Afsnittet beskriver, hvordan centrale forretningsobjekter indgår i Klassifikationsmodellen. Hjælpeobjekter Nyt Afsnittet beskriver, hvordan hjælpeobjekter indgår i Klassifikationsmodellen. Eksternt definerede forretningsobjekter Nyt Afsnittet beskriver, hvordan eksternt definerede forretningsobjekter indgår i Klassifikationsmodellen. Klassifikation Revideret Afsnittet er skrevet om. Formål Udgået Attributter Revideret Revideret afsnit som beskriver attributter for Klassifikation. I forhold til attributlisten i tabel 3, side 16 i version 1.1 er der følgende ændringer: - BrugervendtNøgle: Udgået - KlassifikationKaldenavn: Ændret til "Kaldenavn", beskrivelse ændret - KlassifikationBeskrivelse: Ændret til "Beskrivelse" - KlassifikationOphavsret: Ændret til "Ophavsret", beskrivelse ændret Tilstand Udgået Følgende attributter er tilføjet i Klassifikationsmodellen: - ID: var i version 1.1 del af de generelle egenskaber - Version: mulighed for at angive et versionsnummer på en klassifikation - PubliceretIndikator: Var tidligere en del af objektet Tilstand - VirkningFra og VirkningTil: Var i version 1.1 del af de generelle egenskaber Relationer Revideret Afsnittet definerer og beskriver relationerne fra forretningsobjektet Klassifikation. I forhold til relationerne i tabel 5, side 17 i version 1.1 er der følgende ændringer: - Ejer: relateret objekt præciseret som Organisation i stedet for den abstrakte klasse Aktør, beskrivelse opdateret - Ansvarlig: relateret objekt præciseret som Organisation eller OrgEnhed i stedet for den abstrakte klasse Aktør, beskrivelse opdateret Operationer Udgået Følgende relationer er tilføjet i Klassifikationsmodellen: - TilhørendeFacet: angivelse af den eller de facetter, der indgår i et klassifikationssystem Facet Revideret Afsnittet er skrevet og diagrammet revideret. De enkelte ændringer beskrives under attributter og relationer. Formål Udgået 26

27 Attributter Revideret Revideret afsnit som beskriver attributter for Facet. I forhold til attributlisten i tabel 7, side 20 i version 1.1 er der følgende ændringer: - brugervendtnøgle: ændret til "BrugervendtNøgle", beskrivelse opdateret - facetbeskrivelse: ændret til "FacetBeskrivelse", beskrivelse opdateret - facetplan: udgået - facetopbygning: udgået - facetophavsret: ændret til "FacetOphavsret", beskrivelse ændret - facetsupplement: ændret til "FacetSupplement", beskrivelse ændret - retskilde: udgået - ændret til relation Tilstand Udgået Følgende attributter er tilføjet i Klassifikationsmodellen: - ID: var i version 1.1 del af de generelle egenskaber Relationer Revideret Afsnittet definerer og beskriver relationerne fra forretningsobjektet Facet. I forhold til relationerne i tabel 9, side 22 i version 1.1 er der følgende ændringer: - Ejer: relateret objekt præciseret som Organisation i stedet for den abstrakte klasse Aktør, beskrivelse opdateret. - Ansvarlig: relateret objekt præciseret som Organisation eller OrgEnhed i stedet for den abstrakte klasse Aktør, beskrivelse opdateret. - Redaktører: udgået - Ansvarlig anvendes til at angive, hvis der er andre end ejeren, som kan redigere Facetten. - Facettilhør: ændret til "KlassifikationTilhørsforhold" for bedre at afspejle, at det er relation til den Klassifikation, facetten tilhører. Operationer Udgået Følgende relationer er tilføjet i Klassifikationsmodellen: - TilhørendeFacet: angivelse af den eller de facetter, der indgår i et klassifikationssystem Klasse Revideret Afsnittet er skrevet og diagrammet revideret. De enkelte ændringer beskrives under attributter og relationer. Formål Udgået 27

28 Attributter Revideret Revideret afsnit som beskriver attributter for Facet. I forhold til attributlisten i tabel 11, side 25 i version 1.1 er der følgende ændringer: - brugervendtnøgle: ændret til "BrugervendtNøgle" - klassebeskrivelse: ændret til "KlasseBeskrivelse" - klassetitel: ændret til "KlasseTitel" - klasseeksempel: ændret til "KlasseEksempel" - klasseomfang: udgået - aendringsnotat: ændret til "AendringsNotat" - retskilde: Udgået - ændret til relation - Søgeord: udgået - ændret til relation Tilstand Udgået Følgende attributter er tilføjet i Klassifikationsmodellen: - ID: var i version 1.1 del af de generelle egenskaber. - AendringsDato: Mulighed for at angive dato for ændring. - VirkningFra og VirkningTil: var i version 1.1 en del af de generelle egenskaber. Relationer Revideret Afsnittet definerer og beskriver relationerne fra forretningsobjektet Klasse. I forhold til relationerne i tabel 14, side 27 i version 1.1 er der følgende ændringer: - Ejer: relateret objekt præciseret som Organisation i stedet for den abstrakte klasse Aktør, beskrivelse opdateret. - Ansvarlig: relateret objekt præciseret som Organisation eller OrgEnhed i stedet for den abstrakte klasse Aktør, beskrivelse opdateret.- Redaktører - Overordnet: beskrivelse opdateret. - Sideordnede: beskrivelse opdateret. - Mapninger: beskrivelse opdateret. - Tilføjelser: beskrivelse opdateret. - Erstatter: beskrivelse opdaeret. - LovligeKombinationer: beskrivelse opdateret. - Facet: ændret til "Facettilhørsforhold", beskrivelse opdateret Følgende relationer er tilføjet i Klassifikationsmodellen: - ÆndretAf: angivelse af den OrgPerson, der har afstedkommet en ændring - Retskilde: den retskilde Klassen reguleres af Operationer Udgået Søgeord Nyt Afsnittet beskriver brugen af søgeord Attributter Nyt Afsnittet beskriver attributter for Søgeord Relationer Nyt Afsnittet beskriver relationer for Søgeord Bilag 1: Struktur for input-/outputmeddelelse Referencer Udgået Nyt afsnit med referencer. Anvendes fx hvor der i modellerne er inddraget modelelementer fra andre modeller, fx retskilde hvor der henvises til retsinfo's ELI-identifikator - men også referencer mellem specifikationerne 28

29 Bilag 2: Retteblad til version 1.1 Bilag 1: Retteblad til Klassifikationsmodellen version 2.0 Udgået Nyt 29