OIO Specifikation af model for Dokument

Body: 

Specifikation af Model for Dokument. 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 oprindeligt udarbejdet af en arbejdsgruppe under OIO-udvalget for sags- og dokumentområdet.

Version 2.0 er udarbejdet i regi af den fællesoffentlige Styregruppe for Data og Arkitektur.

Arkitektur.digst.dk

Indledning

Formål med Dokumentmodellen

Formålet med Dokumentmodellen er at gøre det lettere at udveksle oplysninger om dokumenter mellem to eller flere it-systemer, ved at skabe en fælles forståelse af hvad et dokument er, og hvilke informationer et dokument består af. Dokumentmodellen definerer de begreber, forretningsobjekter, attributter, datatyper og relationer, som tilsammen beskriver et dokument.

Dokumenter består af en afgrænset samling af informationer, i en kendt struktur, gemt på et kendt medie. Et dokument kan foreligge på papir, digitalt medie eller et hvilket som helst andet medie, der kan være bærer af information. Dokumenter kan rumme tekst, tegninger, grafik, fotografier, video, tale osv. Specifikationen beskriver en model for Dokument og udgør et fælles grundlag for forståelse og metadataopmærkning af digitale dokumenter. Dokumentmodellen udgør dermed det semantiske grundlag for at registrere oplysninger om en organisations dokumenter med henblik på udveksling af dokumentmetadata mellem to eller flere it-systemer.

I figuren nedenfor er illustreret, hvordan Dokumentmodellens formål er at beskrive fælles metadata for dokumenter til brug for udveksling mellem itsystemer. 

Figur 1 viser dokumentmodellens fokus
Figur 1 Dokumentmodellens fokus

Den fysiske fil udpeges fra Dokumentmodellen igennem en URI. Hvor og hvordan den fysiske fil er lagret er ikke en del af beskrivelsen i Dokumentmodellen. 

Dokument anvendes og indgår primært i sammenhæng med andre objekter som fx Sag, sammenhænge som dermed beskriver dokumenters relationer til omverdenen.

Dokumentmodellen rummer kun de fælles metadata for dokumenter og vil formentlig skulle specialiseres og beriges med fagområdets metadata ved anvendelse på specifikke fagområder. Dokumentmodellen kan enten anvendes alene eller i kombination med elementer fra andre modeller, som eksempelvis Sagsmodellen (se [SAG]), anvendes til at bygge udvekslingsmodeller, som lægges til grund for udvikling af snitflader. 

Ændringer siden version 1.1.1

Dokumentmodellen er en revision af “Specifikation af serviceinterface for Dokument. Version 1.1.1” (OIO Dokument 1.1.1). Dokumentmodellen 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 1.1.1 (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, at de generelle egenskaber er svære at forstå og kommunikere. Det kan give UDKAST 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 Dokumentmodellen 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 Dokumentmodellen. Denne beskrivelse er ens for de fire opdaterede standarder.

Egenskaber for Dokumentmodellen

Dokumentmodellen er en informationsmodel, der giver en grafisk og tekstuel beskrivelse af Dokument (jf. [GODPRAKSIS]). I beskrivelsen er anvendt en række modelelementtyper:

  • Som notation er anvendt UML klassediagram til beskrivelse af Dokumentmodellen.
  • UML-pakker er anvendt med henblik på sammenhæng og genbrug af modelelementer på tværs af modeller.
  • Forretningsobjekter er i Dokumentmodellen repræsenteret af en UMLklasse. 
  • Universelt unik, persistent identifikation af forretningsobjekterne er obligatorisk. 
  • Attributter beskriver informationsindholdet i Dokumentmodellen.
  • Relationer repræsenterer de strukturelle sammenhænge mellem forretningsobjekter i Dokumentmodellen. 

Modelelementtyperne og brugen af dem i Dokumentmodellen er forklaret yderligere i de følgende afsnit. 

Diagrammer

UML klassediagram udgør rammen for beskrivelse af Dokumentmodellen 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 et dokument når det skal udveksles mellem it-systemer. 

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å). 
  • Part eksisterer ikke som en eksternt defineret model. Men i modellen er Part alligevel vist som en UML Pakke, der rummer forretningsobjekterne Person og Virksomhed. Fremgangsmåden er anvendt for at kunne referere til de to objekter under et og i egenskab af Part. 

Diagrammet forklares uddybende i den medfølgende tekst.

Alle forretningsobjekter, attributter og relationer defineres og beskrives i afsnittene efter diagrammet.

Forretningsobjekter

Et forretningsobjekt er i UML Klassediagrammet for Dokumentmodellen repræsenteret af en UML Klasse. 

Forretningsobjekter i Dokumentmodellen er beskrevet som vist i tabellen nedenfor:

Tabel 1 Forretningsobjekter i Dokumentmodellen

Forretningsobjekt Navn

Definition

Beskrivelse

Entydigt klassenavn for det forretningsmæssige begreb.

En kort og præcis definition.

Uddybende beskrivelse og eksemplificering af forretningsobjektet. 

Universelt unik, persistent identifikation af forretningsobjekter

Universelt unik, persistent identifikation er obligatorisk for forretningsobjekterne i Dokumentmodellen. 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 2016 – 2020. 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]) bør anvendes i konstruktionen af http-URI for forretningsobjekterne i Dokumentmodellen. 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:

https://data.gov.dk/id/thing/91aa87da-9f06-11e7-abc4-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 konkret Dokument:

https://data.gov.dk/id/document/document/91aa87da-9f06-11e7-abc4cec278b6b50a

Der kan være tilfælde, hvor det er nødvendigt at anvende en anden identifikator end UUID i konstruktion af http-URI. I retningslinjerne for stabile http-URIer (se [HTTPURII] er også anvist, hvordan en http-URI i så fald kan konstrueres, fx: 

Eksempel med emneklassen 27.34.02 i klassifikationssystemet KLE som identifikator, der indgår i konstruktion af http-URI:

https://data.gov.dk/id/classification/KLE/emne#27.34.02

Eksempel med registreringsnummeret VZ26979 på køretøj som identifikator, der indgår i konstruktion af http-URI: 

https://data.gov.dk/id/vehicle/registration#VZ26979

I tabellen nedenfor er vist, hvordan kravet om universel unikt, persistent identifikation af forretningsobjekter er beskrevet i modellen:

Tabel 2 Universelt unik identifikation af objekter i Dokumentmodellen

Betegnelse

Beskrivelse

Udfaldsrum

ID

Forretningsobjektets universelt unikke, persistente identifikator.

Angives som http-URI (se [HTTPURI]), eksempelvis:

https://data.gov.dk/id/document/document/91aa87da-9f0611e7-abc4-cec278b6b50a/

Se også nærmere beskrivelse i afsnit ovenfor om universelt unik, persistent identifikation af forretningsobjekter. 

Http-URI

Attributter

Dokumentmodellens informationsindhold, fx titlen på et dokument, er for de respektive forretningsobjekter, fx dokumentet, repræsenteret af attributter.

Attributter i Dokumentmodellen er beskrevet som vist i tabellen nedenfor:

Tabel 3 Beskrivelse af attributter i Dokumentmodellen

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.

Hvis attributten har et udfaldsrum, som ikke er givet i datatypen, beskrives det også her.

Angivelse af navn på datatype for attributten.

Beskrivelse af de regler for anvendelse, der gælder for attributten, fx om den er obligatorisk. 

Beskrivelsen af attributter er yderligere uddybet og eksemplificeret i afsnittet ”Beskrivelser af attributter”, som følger efter tabellerne. 

Datatyper

Dokumentmodellen skal kunne anvendes som udgangspunkt for udvekslinger af oplysninger om dokumenter mellem to eller flere it-systemer. 

Angivelse af datatyper sikrer, at informationsindholdet beskrives og læses på samme måde af de it-systemer, som udveksler informationer, fx ved at deltagerne i en informationsudveksling bruger det samme datoformat.

Datatyperne præciserer modellens beskrivelser som udgangspunkt for transformation fra model til konkrete repræsentationer af data, fx en XMLstruktur som kan udveksles mellem it-systemer. 

Datatyperne er beskrevet som vist i tabellen nedenfor:

Tabel 4 Beskrivelse af datatyper

Betegnelse

Beskrivelse

Datatype grundlag

Restriktioner

Navnet på datatypen som den anvendes til at angive datatype for en attribut.

Beskrivelse af datatypen.

Angivelse af den konkrete datatype med anvendelse af XSD-datatyperne jf.

[XSD].

Eventuelle restriktioner eller mønstre for datatypen.

Nedenstående datatyper er anvendt i Dokumentmodellen:

Tabel 5 Datatyper i Dokumentmodellen

Betegnelse

Beskrivelse

Datatypegrundlag

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

 

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

Http-URI

For uddybende forklaring, se afsnit ovenfor om universelt unik, persistent identfikation af forretningsobjekter i Dokumentmodellen

xsd:string

jf. [HTTPURI]

Boolean

Anvendes med mulighed for at svare Ja/Nej

xsd:boolean

True = ja, False = Nej

Mulighed for tilpasning af attributters udfaldsrum

I Dokumentmodellen er der attributter, hvor udfaldsrummet er angivet med brug af datatypen Tekst(enumeration).

Ved anvendelse af Dokumentmodellen 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 Dokumentmodellen 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 Dokumentmodellen 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:

Tabel 6 Beskrivelse af relationer i Dokumentmodellen

Betegnelse

Beskrivelse

Relateret objekt

Kardinalitet

Et beskrivende navn på relationen.

En kort og præcis definition på relationen.

Det forretningsobjekt relationen peger på.

Angiver rammerne for relationen.

Dokumentmodellen

Dokumentmodellen beskrives igennem:

  • Introduktion til dokumentbegrebet.
  • Diagram for dokumentmodellen.
  • Beskrivelse af forretningsobjekter, attributter og relationer.

De enkelte punkter gennemgås i de følgende afsnit.

Dokumentbegrebet

Dokumenter består af afgrænsede samlinger af informationer, i kendte strukturer, på kendte formater. Dokumenter kan rumme tekster, tegninger, grafik, fotografier, video, tale og/eller meget andet.

Dokumenter består dels af de faktiske dokumenter, fx et regneark eller en rapport, og dels af metadata, der beskriver dokumentet, fx dokumenttitel og brevdato. Dokumentmodellen fokuserer udelukkende på de beskrivende metadata for dokumenter med udveksling mellem it-systemer som formål.

I de fleste tilfælde findes de faktiske dokumenter kun i en elektronisk variant, hvad enten de er produceret elektronisk, eller de er omformet til elektronisk form, fx igennem skanning.

Men i nogle tilfælde findes de faktiske dokumenter også i en fysisk variant enten suppleret med en elektronisk variant eller helt uden nogen elektronisk variant. Forekomsten af fysiske varianter gør sig typisk gældende ved store dokumenter, der er svære at skanne, herunder tykke manualer eller tekniske tegninger. 

Dokumentmodellen fokuserer på at beskrive nogle få fælles metadata om dokumenter med henblik på udveksling. It-systemer, som håndterer elektroniske dokumenter, håndterer typisk også dokumenternes forretningslogik. Det kan eksempelvis være i forhold til forskellige varianter af det samme dokument, hvor der kan eksistere en offentliggørelsesvariant i pdf-format eller en produktionsvariant i word-format. Dokumentmodellen sigter ikke imod at kunne udtrykke alt forretningslogik omkring dokumenter. Men hvor behovet opstår, fx i forbindelse med udstilling af dokumenter i en webservice, rummer modellen mulighed for specialisering med tilføjelse af de nødvendige attributter og relationer til den konkrete anvendelse og de specifikke behov. 

Diagram for Dokumentmodellen

Dokumentmodellen er illustreret i nedenstående figur:

Figur 2 viser diagram for Dokumentmodellen
Figur 2 Diagram for Dokumentmodellen

Diagrammet viser, at Dokument er det centrale forretningsobjekt.

Dokumentet og dets attributter er beskrevet i afsnittet omkring Dokument. 

Alle relationer i diagrammet peger væk fra Dokument. Der er ikke vist kardinalitet på det centrale forretningsobjekt Dokument, som der altid skal være netop ét af. 

Relationerne til Klasse i den eksternt definerede Klassifikationsmodel viser, at den relaterede værdi findes som en klasse i et klassifikationssystem.

Relationerne til andre dokumenter vises i diagrammet ved, at der er indsat et nyt forretningsobjekt af typen Dokument, som relationerne til andre dokumenter peger på. 

Relationerne til dokumentets parter peger på en UML Pakke navngivet Part.

Part findes ikke aktuelt som eksternt defineret forretningsobjekt. Derfor er Part som abstrakt betegnelse for personer eller virksomheder vist i diagrammet på denne måde i Dokumentmodellen.

Relationerne til den eksternt definerede Organisationsmodel beskriver dokumentets stamdata i forhold til ejere, ansvarlige, behandlere, og hvem der har ændret dokumentet.

Forretningsobjekterne og deres relationer er beskrevet nærmere i de følgende afsnit. 

Forretningsobjekter i Dokumentmodellen

I Dokumentmodellen indgår følgende typer af forretningsobjekter:

  • Centrale forretningsobjekter, som er defineret og ejet af Dokumentmodellen. 
  • Eksterne forretningsobjekter, som er defineret og ejet af andre modeller

De forskellige objekttyper forklares nærmere i næste afsnit.

Centralt Forretningsobjekt

Dokumentmodellens centrale forretningsobjekt Dokument er beskrevet i tabellen nedenfor: 

Tabel 7 Centrale forretningsobjekt i Dokumentmodellen

Forretningsobjekt Navn

UDKAST Definition

Beskrivelse

Dokument

Dokumenter er afgrænsede samlinger af informationer, i kendte strukturer, på kendte formater.

Eksempler på dokumenter er tekster, tegninger, grafik, fotografier, video, tale mv.

Eksternt definerede forretningsobjekter

I Dokumentmodellen indgår en række forretningsobjekter, som er eksternt definerede. 

Som en visuel hjælp til forståelse af diagrammet, er eksternt definerede forretningsobjekter i diagrammet vist med blå farve. 

Hvor forretningsobjektet er defineret og beskrevet i andre informationsmodeller, er det i diagrammet for Dokumentmodellen modelleret ved hjælp af en pakke. Pakken angiver titlen på den eksterne informationsmodel

Tabel 8 Eksternt definerede forretningsobjekter i Dokumentmodellen
Betegnelse Definition Ekstern model Beskrivelse

OrgPerson

OrgPerson repræsenterer en persons tilhørsforhold og medlemskab i Organisationer og OrgEnheder.

Organisation se [ORG]

OrgPersoner er personer med medlemskab af organisationen i en bestemt rolle, eksempelvis ansatte.

Organisation En organisation er en anerkendt juridisk enhed med rettigheder og ansvar. [ORG]

Forretningsobjektet Organisation er den formelle præsentation i forhold til omverdenen.

Eksempler på organisationer er myndigheder (fx et ministerium, en styrelse, en kommune) eller virksomheder.

OrgEnhed

Forretningsobjektet

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. 

Eksempler på OrgEnheder er afdelinger, sektioner, kontorer, udvalg, projektgrupper, styregrupper, klasser, hold og lignende.

Klasse

Klasse er et begreb, som man ønsker at opmærke (klassificere) et dokument med.

Det er alene den juridiske enhed, der udgør den formelle repræsentation i forhold til omverdenen.

[KLASSIFIKATION]

En klasse kan fx være et emne, en handlingsfacet, et stikord mv. Klasser kan ordnes i lister eller hierarkier.

Person

Person er et individ, der er registreret i CPR-registeret med personnummer.

[PERSON]

Personer identificeres med CPR-nummer. 

Virksomhed

Virksomhed er en juridisk enhed registreret i CVR med CVR-nummer.

[VIRKSOMHED]

Organisatoriske aktører som Dokumentpart registreres ved deres CVR-nummer. 

Dokument

Dokument er det centrale forretningsobjekt i Dokumentmodellen. Den samlede beskrivelse af fænomenet ”et dokument” gives igennem Dokumentmodellens objekter, attributter og relationer til eksterne forretningsobjekter.

Attributter

Dokumenter har følgende attributter:

Tabel 9 Attributter for Dokument
Betegnelse Beskrivelse Datatype Regel for udfyldelse
ID

Forretningsobjektets universelt unikke, persistente identifikator.

Angives som http-URI (se [HTTPURI]), eksempelvis: 

https://data.gov.dk/id/thing/91aa87da-9f06-11e7-abc4cec278b6b50a/

Se også nærmere beskrivelse i afsnit ovenfor om universelt unik, persistent identifikation af forretningsobjekter. 

Http-URI Obligatorisk
Dokumentnummer

Dokumentnummer tildeles ved oprettelse af dokumentet. Det er typisk det dokumentnummer, som fagsystemet har tildelt dokumentet, og som brugeren kender som dokumentets ID/entydige reference.

Dokumentnummer fungerer også som dokumentets brugervendte nøgle.

Ved eksport fra én myndighed og import til en anden myndighed er der risiko for, at dokumentnummeret ikke længere er unikt.

Tekst Obligatorisk
Titel

Dokumentets titel.

Tekst Obligatorisk
Beskrivelse

Dokumentbeskrivelse i fri tekst. En kort beskrivelse af det forretningsmæssige indhold af dokumentet.

Tekst

Ikke-Obigatorisk

Indgående-

Indikator

Angivelse af om dokumentet er modtaget fra en ekstern organisation og dermed indgående i forhold til organisationen. 

Sættes til ”Ja”, hvis dokumentet er indgående. IndgåendeIndikator skal ikke ændres ved fordeling mellem OrgEnheder, der tilhører den samme Organisation. 

Boolean

Obligatorisk

DokumentType

Angivelse af hvilken type dokument, der er tale om.

Attributten Type inddeler dokumenter i en række dokumenttyper:

  • Brev, indgaaende
  • Brev, udgaaende
  • Dagsorden
  • Eksternt Notat
  • Faktura
  • Internt Notat
  • Rapport

Dokumenttyper udtrykkes som et endeligt antal strukturerede værdier (enumeration). Antallet af værdier kan udvides jf. beskrivelsen af mulighed for tilpasning af udfaldsrum. 

Tekst(enumeration)

Nej

Brevdato

Den brevdato, der fremgår af dokumentet.

Hvis der er tale om et brev, angives her datoen for afsendelse af brevet. Dvs. den dato hvor borgeren eller anden part har afsendt et brev til myndigheden, eller hvor myndigheden har afsendt et brev til borgeren eller anden part.

Dato

Obligatorisk hvis Dokumentty pen er et Brev (indgående eller udgående)

Lagringsform

Lagringsform er angivelse af, hvorvidt et dokument er lagret:

  • Digitalt
  • Delvis digitalt
  • Ligger på papir
  • Uden tilknyttet et dokument til registeringen. 

Formålet med disse registreringer er at tydeliggøre, at der ikke er sket en fejl i lagringen af dokumentet, men at det kan findes andetsteds.

Tekst (enumeration)

Ikke-obligatorisk

Versionsnummer

Dokumentets versionsnummerUDKAST , fx 2.00.

Ved ændring af versionsnummer skal relationen ÆndretAf være udfyldt, så det er tydeligt, hvem i organisationen der har afstedkommet den nye version.

Tekst

Ikke-obligatorisk

 

VersionsTid

Tidspunkt for skiftet til dokumentets aktuelle version

DateTime

Obligatorisk hvis versionsnummer er udfyldt.

DokumentTilstand

Dokumentets forretningsmæssige fremdrift.

  • Modtaget: Eksternt produceret dokument, der er modtaget i organisationen.
  • Fordelt: Eksternt produceret dokument, der er modtaget i organisationen, er fordelt.
  • UnderUdarbejdelse: Internt produceret dokument, i hvilket det fortsat er muligt at redigere indholdet.
  • UnderReview: Internt produceret dokument, der midlertidigt er under ekstern eller intern høring.
  • Publiceret: Dokument er publiceret til offentligheden.
  • Endeligt: Internt produceret dokument i hvilket det ikke længere er muligt at redigere i indholdet, eller eksternt produceret dokument der er modtaget i myndigheden. 
  • Afleveret: Angiver, at dokumentet er afleveret til offentligt arkiv.

OrgPersonen eller it-systemet, som har registreret dokumentets aktuelle tilstand, angives med relationen ’ÆndretAf’.

Tekst (enumeration)

Obligatorisk

TilstandsDato Dato for dokumentets aktuelle tilstand. Dato Nej

Relationer fra Dokument

Relationer til andre dokumenter

Relationerne til andre dokumenter er modelleret ud fra en processuel tilgang i forhold til, hvornår relationen oprettet, og hvilken vej den peger. Relationen tager udgangspunkt i, at den altid peger væk fra det seneste dokument, fx et dokument, som er en besvarelse af et andet dokument. Her må besvarelsen antages at ligge senere i processen end dokumentet, som besvares. Derfor peger relationen væk fra dokumentet, som er besvarelsen, og over på dokumentet som besvares. 

Relationer til andre dokumenter er beskrevet i tabellen nedenfor:

Tabel 10 Relation til andre dokumenter

Betegnelse

Beskrivelse Relateret objekt Kardinalitet

Besvarelse

Dokumentet angives at være en besvarelse af et eller flere relaterede dokumenter.

Dokument

0..n

Udgangspunkt

Et eller flere dokumenter kan angives som udgangspunkt for dette dokument.

Dokument

0..n

NyRevision

Dokumentet angives som værende en ny revision af et relateret dokument.

Dokument

0..1

Kommentar

Dokumentet kan angives som kommentar til det relaterede dokument.

Dokument

0..1

Bilag

Dokumentet kan angives som værende bilag til et eller flere dokumenter, som dokumentet er indeholdt i.UDKAST

Dokument

0..n

AndetDokument

Et eller flere dokumenter kan angives som relateret til dette dokument.

Dokument

0..n

Relationer til Organisation

Relationer til Organisation beskriver, hvilke OrgPersoner eller organisatoriske enheder, der deltager i behandlingen af dokumentet.
De relaterede objekter er beskrevet i Organisationsmodellen (jf. [ORG]).

Tabel 11 Relationer til Organisation

Betegnelse

Beskrivelse Relateret objekt Kardinalitet

Ejer

Organisation som ejer dokumentet. Organisation 1..1

Ansvarlig

Den OrganisationEnhed, som er ansvarlig for dokumentet. OrgEnhed 0..1
PrimærBehandler Den specifikke medarbejder eller OrganisationEnhed, der er primær behandler på dokumentet. OrgEnhed
OrgPerson
0..1
AndenBehandler Andre medarbejdere eller organisatoriske enheder, der arbejder med/behandler dokumentet.
Hvis der i forhold til udformningen af dokumentet er inddraget andre sagsbehandlere end den primære behandler, angives de med denne relation.
OrgEnhed
OrgPerson
0..n
OprettetAf OrgPerson som har oprettet dokumentet. OrgPerson 1..1
ÆndretAf OrgPerson som har afstedkommet ændring i dokumentets tilstand eller version. OrgPerson

1..1

Relationer til Klassifikation

Relationer til klassifikation anvendes til at angive typer eller kategoriseringer af dokumentet ud fra en klassifikation.

Dokument har følgende relationer til Klassifikation:

Tabel 12 Relationer til Klassifikation
Betegnelse Beskrivelse Relateret Objekt Kardinalitet
PrimærKlassse

Er den klasse i et klassifikationssystem, der klassificerer dokumentet.

Klasse 1..1
AndreKlasser Denne dokumentklasserolle anvendes, hvis man ønsker at klassificere dokumentet efter andre klassifikationssystemer end det, som angives i den primære klasse. Klasse 0..n

Dokumentpart

Dokumentpart bruges til at beskrive relationen mellem dokumentet og dets parter. 

Attributter

Dokumentpart kan beskrives yderligere ved hjælp af attributten partsrolle, der er defineret i tabellen nedenfor.

Tabel 13 Beskrivelse af attributter for Dokumentpart

Betegnelse

Beskrivelse

Datatype

Regel for udfyldelse

Partsrolle

Partsrolle beskriver den rolle, som en part har i forhold til dokumentet. 

Parter kan have forskellige roller i forhold til dokumentet. De kan fx være afsendere eller modtagere af et brev. 

Ønskes en nærmere angivelse af udfaldsrummet for Partsrolle for Dokumentparter, kan relationen yderligere beskrives igennem tilpasning af denne attribut jf. beskrivelsen heraf i afsnittet ’Mulighed for tilpasning af attributters udfaldsrum’.

Tekst

Ikke obligatorisk

Relationer til Part

Relationer til part anvendes il at angive dokumentets parter, som dokumentet drejer sig om, eller som har en relation til dokumentet. 

Person og Virsomhed er de konkrete forretningsobjekter, der kan angives som part på et dokument. 

  • Person identificeres med CPR. 
    • Ikke alle personer findes dog i CPR-registeret, fx udlændinge. 
    • Personer uden CPR-nummer identificeres med et erstatningsnummer.
    • Erstatningsnummeret er typisk et lokalt tildelt identifikationsnummer. Af hensyn til identifikation er information om udstedende Organisation vigtig.
  • Virksomhed identificeres med CVR.
    • Ikke alle virksomheder findes i CVR-registeret, fx udenlandske virksomheder. 
    • Virksomheder uden CVR identificeres med et erstatningsnummer.
    • Erstatningsnummeret er typisk et lokalt tildelt identifikationsnummeret. Af hensyn til identifikation er information om udstedende Organisation vigtig.

Part eksisterer ikke aktuelt som eksternt defineret forretningsobjekt. Part anvendes derfor her som en abstrakt betegnelse for personer og virksomheder. I diagrammet for Dokumentmodellen er det vist ved, at Peron og Virksomhed er vist i diagrammet i en UML Pakke navngivet Part, og som partsrelationerne fra Dokument peger på.

Tabel 14 Beskrivelse af relationer fra Sagspart

Betegnelse

Beskrivelse

Objekttype

Kardinalitet

Part

En eller flere Parter, der har indsendt dokumentet til myndigheden eller har modtaget dokumentet fra myndigheden.

Person

Virksomhed

0..1

Kopipart

Parter, der har modtaget dokumentet fra myndigheden i kopi.

Person

Virksomhed

0..1

Referencer i Dokumentmodellen

Nedenfor er angivet, hvilke referencer der er anvendt i Dokumentmodellen: 

Tabel 15 Referencer i Dokumentmodellen

Reference

Titel

Link til reference

[ANVISNING]

“Anvendelse af Dokumentobjektet i Sags- og Dokumentindekset v1.1”

https://share-komm.kombit.dk/p089/Referencedokumenter/STS%20Anvisninger/... (senest tilgået 18.12.2017)

[BEK1007]

”Bekendtgørelse nr. 1007 af 20. august 2010 om arkiveringsversioner”

https://www.retsinformation.dk/eli/lta/2010/1007 (senest tilgået 05.04.2018)

[CIR9290]

“cirkulære nr. 9290 af 21. juni 2013 om anmeldelse og godkendelse af statslige myndigheders it-systemer”

https://www.sa.dk/wp-content/uploads/2014/10/It-systemer-Vejledning-til-cirkulaerer-om-anmeldelse-godkendelse.pdf (senest tilgået 05.04.2018)

[ELI]

“Easier access to European legislation with ELI”

https://www.retsinformation.dk/eli (senest tilgået 16.12.2017)

[GODPRAKSIS]

”God praksis for informationsmodellering, OIO-datastandardisering i sektorerne”, It- og telestyrelsen 2007

https://bibliotek.dk/linkme.php?rec.id=870970-basis%3A26939844

[GRUNDDATA]

Modelregel 6.1 ”ALLE MODELENTITETER SKAL MODELLERES MED PERSISTENT, UNIK IDENTIFIKATION”, Grunddatabestyrelsen 3. 01 2014

http://arkitekturguiden.digitaliser.dk/node/828 (senest tilgået 17.12.2017)

[HTTPURI]

”Udkast til Retningslinjer for stabile http URIer”, Styregruppen for Data og Arkitektur

https://arkitektur.digst.dk/node/588 (senest tilgået 18.01.2018)

[KLAS]

Specifikation af model for Klassifikation (Klassifikationsmodellen)

[indsættes når model er klar]

[ORG]

Specifikation af model for Organisation (Organisationsmodellen)

[indsættes når model er klar]
[PERSON] autoritativ kilde til Person?  

[RFC4122]

"A Universally Unique IDentifier (UUID) URN Namespace"

https://tools.ietf.org/html/rfc4122 (senest tilgået 17.12.2017)

[SAG]

Specifikation af model for Sag (Sagsmodellen)

[indsættes når model er klar]

[VIRKSOMHED]

 

autoritativ kilde til Virksomhed

[XSD]

“W3C XML Schema Definition Language (XSD) 1.1 Part 2: Datatypes”

https://www.w3.org/TR/xmlschema11-2/ (senest tilgået 16.12.2017)

Retteblad for Dokumentmodellen version 2.0

Ændringer i "Dokumentmodellen" i forhold til "Specifikation af serviceinterface for Dokument, version 1.1.1"

Afsnit i Version 1.1.1

Nye/ændrede afsnit i Dokumentmodellen

Ændring

Revisionshandling

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 nyt afsnit om formål

Formål med forretningsservice for Dokument

 

Udgået

Afsnittet er erstattet af nyt afsnit om formål

Formål med Serviceinterface Dokument

 

Udgået

Afsnittet er erstattet af nyt afsnit om formål

 

Formål med Dokumentmodellen

Nyt

Afsnittet afspejler ændringen fra specifikation af serviceinterface til specifikation af en informationsmodel

 

Ændringer siden version 1.1.1

Nyt

Afsnittet beskriver de overordnede ændringer

 

Egenskaber for Dokumentmodellen

Nyt

Afsnittet beskriver de modelmæssige egenskaber ved Dokumentmodellen. 

 

Diagrammer

Nyt

Afsnittet beskriver, hvordan diagrammer er anvendt i beskrivelsen af Organisationsmodellen

 

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

Begrebsliste

 

Udgået

Udgået som selvstændigt afsnit. De enkelte begreber er alle defineret som en del af modellen.

Serviceinterface Dokument

Dokumentmodellen

Revideret

Afsnittet er skrevet om, så det afspejler ændringen fra specifikation af serviceinterface til specifikation af en informationsmodel

Dokument

Dokumentbegrebet

Revideret

Afsnittet er skrevet om

Beskrivelse, opbygning og struktur

Diagram for Dokumentmodellen

Revideret

Nyt diagram for dokumentmodellen. I forhold til 1.1.1 diagrammet er det nye diagram mere detaljeret og viser modellens relationer og kardinalitet. 

 

Forretningsobjekter i Dokumentmodellen

Nyt

Afsnittet forklarer, hvordan forskellige objekttyper er repræsenteret i modellen.

 

Centrale forretningsobjekter

Nyt

Afsnittet introducerer modellens centrale forretningsobjekter

 

Eksternt definerede forretningsobjekter

Nyt

Afsnittet introducerer modellens eksternt definerede forretningsobjekter

Dokumentvarianter

 

Udgået

Dokumentvariant indgår ikke længere i Dokumentmodellen.

Dokumentdele

 

Udgået

Dokumentdel indgår ikke længere i Dokumentmodellen

Versionering  

Udgået

Afsnittet foreskrev at dokumenter styres bitemporalt og er udgået. Dokumenter versioneres via attributten versionIdentifikator.

  Dokument Nyt

Afsnittet beskriver dokumentobjektet

Attributter   Revideret

Definitioner og beskrivelser for de enkelte attributter er revideret.

I tabellen er titlen på kolonnen "værdisæt" ændret til "Datatype. De anvendte datatyper referer til beskrivelsen af disse i afsnittet om anvendte datatyper. 

I tabellen er titlen på kolonnen "obligatorisk" ændret til "Regel for udfyldelse", som giver mulighed for en mere detaljeret angivelse af reglerne for attributtens udfyldelse end den hidtidige ja/nej for obligatorisk.

I forhold til attributlisten i tabel 3, side 13 i version 1.1.1 er der følgende ændringer:

  • BrugervendtNøgle: ændret til "Dokumentnummer", der fortsat også fungerer som brugervendt nøgle. - Titel: beskrivelse ændret- Beskrivelse: beskrivelse ændret
  • Type: ændret til "DokumentType", liste ændret, beskrivelse ændret.
  • Brevdato: beskrivelse ændret. - OffentlighedUndtaget: udgået, styres af sagen.
  • Alternativtitel: udgået - Hjemmel: udgået.
  • Major: udgået, versionering styres i stedet af attributterne "Versionsnummer" og "VersionsTid".
  • Minor: udgået, versionering styres i stedet af attributterne "Versionsnummer" og "VersionsTid".
  • Kassationskode: udgået, styres på sagen.

Følgende attributter er tilføjet Dokumentmodellen:

  • ID: var i version 1.1 del af de generelle egenskaber.
  • VirkningFra og VirkningTil for angivelse af dokumentets virkningsperiode. Indgik i version 1.1.1 som en del af de generelle egenskaber. - DokumentTilstand: var i version 1.1 beskrevet i objektet Tilstand som følge af de generelle egenskaber. - TilstandsDato: Følger DokumentTilstand.
  • Versionsnummer: til angivelse af dokumentets version.
  • VersionsTid: til angivelse af tidspunkt for dokumentets aktuelle version. - IndgåendeIndikator: attribut til angivelse af, om dokumentet er indgående i forhold til organisationen. 
Tilstande

DokumentTilstand

Udgået

Tilstand er med bortfaldet af de generelle egenskaber ikke længere en del af en generel objektmodel.

Relationer

Relationer fra Dokument

Revideret

Titel er ændret. 

Afsnittet er af hensyn til overskueligheden inddelt i underafsnit i forhold til, hvilke objekter relationen går til. 

I forhold til listen over relationer i tabel

6, side 17 i version 1.1.1 er der følgende ændringer af relationer i Dokumentmodellen:

  • Arkiver: udgået.
  • Besvarelser: ændret til entalsformen "Besvarelse", relationen vendt, beskrivelse ændret. Relationen er beskrevet i afsnittet "relationer til andre dokumenter".
  • Udgangspunkter: ændret til entalsformen "Udgangspunkt", relationen vendt, beskrivelse ændret. Relationen er beskrevet i afsnittet "relationer til andre dokumenter".
  • NyRevision: relationen vendt, beskrivelse ændret. Relationen er beskrevet i afsnittet "relationer til andre dokumenter".
  • Kommentarer: ændret til entalsformen "Kommentar", relationen vendt, beskrivelse ændret. Relationen er beskrevet i afsnittet "relationer til andre dokumenter".
  • Bilag: relationen vendt, beskrivelse ændret. Relationen er beskrevet i afsnittet "relationer til andre dokumenter".
  • Andre- Dokumenter: ændret til entalsformen "AndetDokument", beskrivelse ændret. Relationen er beskrevet i afsnittet "relationer til andre dokumenter".
  • PrimærKlasse: beskrivelse ændret. Relationen er beskrevet i afsnittet "relationer til Klassifikation".
  • AndreKlasser: beskrivelse ændret. Relationen er beskrevet i afsnittet "relationer til Klassifikation".
  • Ejer: Relateret objekt indsnævret fra den abstrakte klasse Aktør til at skulle være en Organisation. Relationen er beskrevet i afsnittet "relationer til Organisation".
  • Ansvarlig: Relateret objekt indsnævret fra den abstrakte klasse Aktør til at skulle være en OrgEnhed. Relationen er beskrevet i afsnittet "relationer til Organisation".
  • PrimærBehandler: Relateret objekt indsnævret fra den abstrakte klasse Aktør til at skulle være en OrgEnhed eller OrgPerson. Beskrivelse ændret. Relationen er beskrevet i afsnittet "relationer til Organisation".
  • AndreBehandlere: Relateret objekt indsnævret fra den abstrakte klasse Aktør til at skulle være en OrgEnhed eller OrgPerson. Beskrivelse ændret. Relationen er beskrevet i afsnittet "relationer til Organisation".
  • FordeltTil: Udgået.
  • Parter: ændret til "Part", kardinalitet ændret som følge af introduktionen af Dokumentpart. Relationen er beskrevet i afsnittet "Dokumentpart".
  • Kopiparter: ændret til "Kopipart", kardinalitet ændret som følge af introduktionen af Dokumentpart. Relationen er beskrevet i afsnittet "Dokumentpart".
  • TilknyttedeSager: udgået.
 

Relationer til andre dokumenter

Nyt

Afsnittet grupperer relationerne til andre dokumenter. 

Ændringer i relationer som også fandtes i version 1.1.1 er beskrevet under "Relationer fra Dokument".

 

Relationer til Organisation

Nyt

Afsnittet grupperer relationerne til Organisation. 

Ændringer i relationer som også fandtes i version 1.1.1 er beskrevet under "Relationer fra Dokument".

Derudover er følgende relationer tilføjet Dokumentmodellen i dette afsnit:

  • OprettetAf: til angivelse af den OrgPerson, der har oprettet dokumentet.
  • ÆndretAf: til angivelse af den OrgPerson, der har ændret dokumentet.
  Relationer til Klassifikation Nyt

Afsnittet grupperer relationerne til Klassifikation.

Ændringer i relationer som også fandtes i version 1.1.1 er beskrevet under "Relationer fra Dokument".

  Dokumentpart Nyt

Afsnittet præsenterer Dokumentpart, som anvendes til at beskrive relationen mellem dokumentet og dets parter.Ændringer i relationer som også fandtes i version 1.1.1 er beskrevet under "Relationer fra Dokument".

Operationer   Udgået  
Dokumentvariant   Udgået

Dokumentvariant indgår ikke længere i Dokumentmodellen.

Attributter   Udgået  
  Dokumentpart Nyt

Nyt afsnit som beskriver relationsobjektet Dokumentpart, der giver mulighed for en mere detaljeret beskrivelse af relationen mellem dokumentet og de personer eller virksomheder, der er dokumentparter.

  Attributter Nyt

Attributten "Partsrolle" tilføjet.

 

Relationer til Part

Nyt

Relationerne "Part" og "Kopipart" findes nu her.

Dokumentdel   Udgået  
Attributter   Udgået  
Relationer   Udgået  
Bilag 1: Struktur ofr input-/outputmeddelelse   Udgået  
Bilag 2: Retteblad til version 1.1.1   Udgået  
 

Referencer i Dokumentmodellen

Nyt

Nyt afsnit med referencer i modellen.