Journalnotat og dokument til og fra dokumentfordeler - KMD

Begrænset

Side 1 af 59

Dokument-nr.: Version: V7.21

Forfatter: CVS/HHO/PSZ Versionsdato: 073.012.20165

Godkender:

Løsningsbeskrivelse til

P14-3

Journalnotat og dokument

til/fra Fordelingskomponenten

Begrænset

Side 2 af 59


Forfatter:

CCCCCCCCVS/

HHO

CVS/HHO/PSZ Versionsdato: 073.012.20165

Godkender:

Versionsoversigt

Version Dato Oprettet af

1.0 13.11.2014 CVS/HHO

2.0 26.11.2014 CVS/HHO

3.0 04.12.2014 CVS/HHO

4.0 27.02.2015 CVS/PSZ

5.0 17.03.2015 CVS/PSZ

6.0 19.08.2015 CVS/PSZ

7.0 27.11.2015 UM/CVS/PSZ

7.1 3.12.2015 PSZ

7.2 7.1.2016 CVS/PSZ

Indhold

1. Projektets rammer ............................................................................................. 6

1.1 Formål og baggrund for projektet ........................................................................ 6

1.1.1 Journalnotater og dokumenter ud af KMD Sag ................................................... 6

1.1.2 Journalnotater og dokumenter ind i KMD Sag .................................................... 6

1.2 Projektets forventede hovedresultat ..................................................................... 6

1.3 Projektets målgruppe ......................................................................................... 6

1.4 Myndighedskrav til løsningen .............................................................................. 6

1.5 Referencer ........................................................................................................ 7

2. Løsningsbeskrivelse ........................................................................................... 7

2.1 Journalnotater og dokumenter oprettet i KMD Sag ................................................. 8

2.1.1 Journalnotater ............................................................................................... 9

2.1.2 Dokumenter ................................................................................................. 10

2.2 Journalnotater og dokumenter oprettet i andet Afsendersystem ............................. 11

2.2.1 Journalnotater .............................................................................................. 11

2.2.2 Dokumenter ................................................................................................. 12

2.3 Fejlhåndtering .................................................................................................. 12

2.3.1 Afsendelse af journalnotat eller dokument ....................................................... 12

2.3.2 Modtagelse af journalnotat eller dokument ....................................................... 13

2.4 Arkitektur ........................................................................................................ 13

2.5 Forudsætninger ................................................................................................ 13

2.6 Sikkerhedsmodel .............................................................................................. 13

2.6.1 Autorisation og logning hos KMD .................................................................... 13

2.7 Test ................................................................................................................ 13

3. Datastrukturer .................................................................................................. 13

3.1 Send journalnotat ............................................................................................. 15

3.1.1 FordelingsobjektAfsendRequest ...................................................................... 15

3.1.2 Anmodning .................................................................................................. 16

3.1.2.1 DistributionObject ....................................................................................... 17

3.1.2.1.1 DistributionJournalPost .............................................................................. 18

3.1.2.1.2 DistributionJournalPost:Registrering:RelationListe:JournalPost........................ 20

3.1.3 Retursvar fra Fordelingskomponent ................................................................. 22

Begrænset

Side 3 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.1.3.1 FordelingskvitteringModtagRequest:DistributionContext ................................... 23

3.2 Send dokument ................................................................................................ 24


3.2.2 Anmodning .................................................................................................. 25


3.2.2.1.1 Registrering:RelationListe .......................................................................... 28

3.2.2.1.2 DokumentPartListe ................................................................................... 30

3.2.2.1.3 Registrering:Tilstand ................................................................................. 31

3.2.2.1.4 Registrering:AttributListe ........................................................................... 32



3.2.4 FordelingskvitteringModtagRequest:DistributionContext ..................................... 36

3.3 Modtagelse af journalnotat eller dokument .......................................................... 37

3.4 Modtag journalnotat .......................................................................................... 37

3.4.1 FordelingsobjektModtagRequest ...................................................................... 37

3.4.1.1 anmodning:DistributionObject ....................................................................... 39

3.4.1.1.1 Objektindhold:DistributionJournalPost ......................................................... 40

3.4.1.1.2 DistributionJournalPost:JournalPost ............................................................. 42

3.4.2 Retursvar til Fordelingskomponent/Afsendersystem........................................... 43

3.5 Modtag dokument ............................................................................................. 44



3.5.1.1.1 DistributionDokument:RelationListe ............................................................ 48

3.5.1.1.2 RelationListe:DokumentPartListe ................................................................ 50

3.5.1.1.3 DistributionDokument:Tilstand ................................................................... 51

3.5.1.1.4 DistributionDokument:AttributListe ............................................................. 52




4. Bilag ................................................................................................................. 59

4.1 Bilag 1 - Mapning af objekttyper ......................................................................... 59

1. Projektets rammer ............................................................................................. 4

1.1 Formål og baggrund for projektet ........................................................................ 4

1.1.1 Journalnotater og dokumenter ud af KMD Sag ................................................... 4

1.1.2 Journalnotater og dokumenter ind i KMD Sag .................................................... 4

1.2 Projektets forventede hovedresultat ..................................................................... 4

1.3 Projektets målgruppe ......................................................................................... 4

1.4 Myndighedskrav til løsningen .............................................................................. 4

1.5 Referencer ........................................................................................................ 5

2. Løsningsbeskrivelse ........................................................................................... 5

2.1 Journalnotater og dokumenter oprettet i KMD Sag ................................................. 6

2.1.1 Journalnotater ............................................................................................... 7

2.1.2 Dokumenter .................................................................................................. 8

2.2 Journalnotater og dokumenter oprettet i andet Afsendersystem .............................. 9

2.2.1 Journalnotater ............................................................................................... 9

2.2.2 Dokumenter ................................................................................................. 10

Formateret:Standardskrifttype i afsnit












Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Begrænset

Side 4 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

2.3 Fejlhåndtering .................................................................................................. 10

2.3.1 Afsendelse af journalnotat eller dokument ....................................................... 10

2.3.2 Modtagelse af journalnotat eller dokument ....................................................... 11

2.4 Arkitektur ........................................................................................................ 11

2.5 Forudsætninger ................................................................................................ 11

2.6 Sikkerhedsmodel .............................................................................................. 11

2.6.1 Autorisation og logning hos KMD .................................................................... 12

2.7 Test ................................................................................................................ 12

3. Datastrukturer .................................................................................................. 12

3.1 Send journalnotat ............................................................................................. 13


3.1.2 Anmodning .................................................................................................. 14


3.1.2.1.1 DistributionJournalPost .............................................................................. 16

3.1.2.1.2 DistributionJournalPost:Registrering:RelationListe:JournalPost........................ 18



3.2 Send dokument ................................................................................................ 22


3.2.2 Anmodning .................................................................................................. 23


3.2.2.1.1 Registrering:RelationListe .......................................................................... 26

3.2.2.1.2 DokumentPartListe ................................................................................... 28

3.2.2.1.3 Registrering:Tilstand ................................................................................. 29

3.2.2.1.4 Registrering:AttributListe ........................................................................... 30



3.2.4 FordelingskvitteringModtagRequest:DistributionContext ..................................... 34

3.3 Modtagelse af journalnotat eller dokument .......................................................... 35

3.4 Modtag journalnotat .......................................................................................... 35






3.5 Modtag dokument ............................................................................................. 42



3.5.1.1.1 DistributionDokument:RelationListe ............................................................ 46

3.5.1.1.2 RelationListe:DokumentPartListe ................................................................ 48

3.5.1.1.3 DistributionDokument:Tilstand ................................................................... 49

3.5.1.1.4 DistributionDokument:AttributListe ............................................................. 50




Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Formateret ...

Begrænset

Side 5 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

4. Bilag ................................................................................................................. 57

4.1 Bilag 1 - Mapning af objekttyper ......................................................................... 57





Begrænset

Side 6 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

1. Projektets rammer

1.1 Formål og baggrund for projektet

1.1.1 Journalnotater og dokumenter ud af KMD Sag

Formålet med snitfladen er, at understøtte oprettelse af journalnotater og dokumenter, der skal

knyttes til sager i systemer eksternt til KMD Sag; dvs. hvor disse sager ikke vedligeholdes af

KMD Sag.

Den skal muliggøre, at en bruger i KMD Sag kan oprette journalnotater og dokumenter på

tværs af de enkelte fagsystemer.

Snitfladen er en del af aftalen omkring KMD Sag udfasning (Bilag A 2.1.9+2.1.10)

1.1.2 Journalnotater og dokumenter ind i KMD Sag

Formålet med snitfladen er, at understøtte oprettelse af journalnotater og dokumenter, der skal knyttes til sager i KMD Sag; dvs. hvor disse sager vedligeholdes af KMD Sag.

Den skal muliggøre, at en bruger i en 3.part løsning (f.eks. SAPA) kan oprette journalnotater

og dokumenter i KMD Sag.

Snitfladen er en del af aftalen omkring KMD Sag udfasning (Bilag A 2.1.8+2.1.11)

1.2 Projektets forventede hovedresultat

Projektet skal løse følgende opgaver for sager der ikke vedligeholdes af KMD Sag: At KMD Sag, som Afsendersystem, kan overføre et journalnotat på en ny sag eller en

Indekssag via Fordelingskomponenten

At KMD Sag, som Afsendersystem, kan overføre et dokument på en ny sag eller en Indeks-

sag via Fordelingskomponenten

At KMD Sag kan modtage et journalnotat fra et Afsendersystem via Fordelingskomponenten

At KMD Sag kan modtage et dokument fra et Afsendersystem via Fordelingskomponenten

1.3 Projektets målgruppe

Kommunerne og UDK er den primære målegruppe gennem deres kommende anvendelse af

løsninger realiseret via rammearkitekturen.

1.4 Myndighedskrav til løsningen

Servicen skal indgå i den fælleskommunale Rammearkitektur.

Dataudvekslingen skal følge den mellem KL, ATP, KMD og KOMBIT udarbejdede model for Da-

taudvekslingsaftale.

Begrænset

Side 7 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

1.5 Referencer

Reference Link Beskrivelse

[Baseline] Fordelingskomponent_snitflader

xsd 20150701

Fordelingskomponentens XSD

leveret af KOMBIT 05-11-2015

[Fordelingskomponent-Afsend] SF2720 - Fordelingskomponent- Afsend objekter v.2.0.0

Integrationsbeskrivelse for Fordelingskomponenten –

afsend objekter

[Fordelingskomponent-Modtag] SF2800 - Fordelingskomponent

- Modtag objekter v.2.0.0

Integrationsbeskrivelse for

Fordelingskomponenten –

modtag objekter

[RettelsesLog] Log over ændringer til P14-3

Oversigt over ændringer til P14-3

2. Løsningsbeskrivelse

Løsningen gør det muligt at oprette en anmodning om oprettelse af journalnotater og doku-

menter i et Afsendersystem, og gemme disse i et Modtagersystem. Modtagersystemet afgør

om anmodningen kan imødekommes.

Feltkode ændret

Feltkode ændret

Feltkode ændret

Feltkode ændret

https://kundenet.kmd.dk/virksomhed/a-k-k/klippekort/Projekter/Forms/AllItems.aspx?RootFolder=%2Fvirksomhed%2Fa%2Dk%2Dk%2Fklippekort%2FProjekter%2FP14%2D03%2D1%20KMD%20Sag%20journalnotat%20og%20dokument%20til%20dokumentfordeler%2FKOMBIT%20%2D%20baseline%20pr%2E%205%2E%20november%202015&FolderCTID=0x012000F8476A4ABD8BBF4AB3F6ABAAEB0E13FF&View=%7BEF6E2034%2D4F1F%2D4221%2D9230%2D132B158A08C4%7D

https://kundenet.kmd.dk/virksomhed/a-k-k/klippekort/Projekter/Forms/AllItems.aspx?RootFolder=%2Fvirksomhed%2Fa%2Dk%2Dk%2Fklippekort%2FProjekter%2FP14%2D03%2D1%20KMD%20Sag%20journalnotat%20og%20dokument%20til%20dokumentfordeler%2FKOMBIT%20%2D%20baseline%20pr%2E%205%2E%20november%202015&FolderCTID=0x012000F8476A4ABD8BBF4AB3F6ABAAEB0E13FF&View=%7BEF6E2034%2D4F1F%2D4221%2D9230%2D132B158A08C4%7D

https://kundenet.kmd.dk/virksomhed/a-k-k/klippekort/Projekter/P14-03-1%20KMD%20Sag%20journalnotat%20og%20dokument%20til%20dokumentfordeler/KOMBIT%20-%20baseline%20pr.%205.%20november%202015/SF2720%20-%20Fordelingskomponent-%20Afsend%20objekter%20v.2.0.0.pdf

https://kundenet.kmd.dk/virksomhed/a-k-k/klippekort/Projekter/P14-03-1%20KMD%20Sag%20journalnotat%20og%20dokument%20til%20dokumentfordeler/KOMBIT%20-%20baseline%20pr.%205.%20november%202015/SF2720%20-%20Fordelingskomponent-%20Afsend%20objekter%20v.2.0.0.pdf

https://kundenet.kmd.dk/virksomhed/a-k-k/klippekort/Projekter/P14-03-1%20KMD%20Sag%20journalnotat%20og%20dokument%20til%20dokumentfordeler/KOMBIT%20-%20baseline%20pr.%205.%20november%202015/SF2800%20-%20Fordelingskomponent%20-%20Modtag%20objekter%20v.2.0.0.pdf

https://kundenet.kmd.dk/virksomhed/a-k-k/klippekort/Projekter/P14-03-1%20KMD%20Sag%20journalnotat%20og%20dokument%20til%20dokumentfordeler/KOMBIT%20-%20baseline%20pr.%205.%20november%202015/SF2800%20-%20Fordelingskomponent%20-%20Modtag%20objekter%20v.2.0.0.pdf

https://kundenet.kmd.dk/virksomhed/a-k-k/klippekort/_vti_history/2/Projekter/P14-03-1%20KMD%20Sag%20journalnotat%20og%20dokument%20til%20dokumentfordeler/Log%20over%20ændringer%20til%20P14-3.xlsx

Begrænset

Side 8 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

KMD Sag som Afsendersystem kalder en service på Fordelingskomponenten, herunder udstiller

en service som Fordelingskomponenten kan kalde.

KMD Sag som Modtagersystem udstiller en WebService, der kaldes af Fordelingskomponenten,

herunder vil kunne kalde services på Fordelingskomponenten

Journalnotater og dokumentreferencer sendes via Fordelingskomponenten. De fysiske doku-

menter udveksles via Serviceplatformens SFTP server.

Det betyder, at journalnotater og dokumenter oprettes med KMD Sag som Afsendersystem,

med udgangspunkt i en Indekssag - eller uden en sags relation. I den situation vil der blive op-

rettet en midlertidig Indekssag i KMD Sag.

Løsningen skal ligeledes håndtere modtagelse af journalnotater og dokumenter, som oprettes i

andre systemer, men hvor KMD Sag er Modtagersystem på linje med øvrige Fagsystemer.

2.1 Journalnotater og dokumenter oprettet i KMD Sag

Journalnotater og dokumenter afleveres via Fordelingskomponenten til det relevante Modta-

gersystem. Indtil der via Fordelingskomponenten er kommet accept retur til KMD Sag, gem-

Begrænset

Side 9 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

mes Journalnotater og Dokumenter på en eksisterende eller en midlertidig Indekssag. Den

midlertidige indekssag stiller ikke krav til licens til manuelle sager. Det vil fremgå, at valget af

Indekssag er et forslag til sagstilknytning, og at den endelige tilknytning vælges i Modtagersy-

stemet. Indekssagerne og de midlertidigt tilknyttede Journalnotater og Dokumenter vil ikke

blive synkroniseret via snitfladerne i P13-08 og P13-09. Når accept modtages, slettes Journal-

notat/Dokument og en eventuelt midlertidig Indekssag.

Det vil være tydeligt markeret, at der er tale om et forslag til tilknytning af journalno-

tat/dokument, også hvis der er tale om en midlertidig indekssag.

Modtagersystemet kan via Fordelingskomponenten sende en fejlbesked. Dette vil generere et

advis til den sagsbehandler, som har oprettet journalnotatet/dokumentet. Metadata vil herefter

kunne redigeres, hvorefter der kan gensendes, evt. med KMD Sag som Modtagersystem, hvis

det ikke er muligt at placere dokumentet.

2.1.1 Journalnotater

Ved oprettelse af Journalnotat fra Personoverblik vælges enten oprettelse fra Indekssag eller

oprettelse uden sagsrelation

1. Opret journal notat fra Personoverblik, enten med eller uden sagstilknytning.

Nyt vindue i KMD Sag for metadata tilføjes.

På baggrund af oplysning om Organisation og KLE* vil der via kald til Fordelingskom-

ponenten vises mulige IT-systemer (leverandører), som brugeren skal kan vælge mel-

lem (hvis der kun er en mulig leverandør, vælges denne automatisk). Samtlige oplys-

ninger, som indgår i kaldet til Fordelingskomponenten, fremgår af Løsningsbeskrivelsens afsnit 3.

2. Metadata skal bl.a. indeholde Kommunenr., KLE-nummer, Modtagersystem (leveran-

dør), Part (cpr.nr.), Sagsbehandler. Kravene til beskedkuvertens metadata fremgår af

Løsningsbeskrivelsens afsnit 3.

3. Journalnotat sendes til ”Proceskomponenten”, som registrerer og videresender til For-

delingskomponenten.

4. Forsendelse til Fordelingskomponenten. Der medsendes UUID, til brug for fremtidig

kommunikation.

Kommentar [DGJ1]: Hvis

notatet er tilknyttet en

indekssag, skal brugeren

ikke angive Org./ KLE, da

disse informationer fremgår

af sagen. I dette tilfælde

benyttes IT-system refe-rencen på denne sag til va-

lideringskald. Hvis valide-

ring er ok, sendes notatet

automatisk til dette system.

Hvis systemet ikke findes i

Fordelignskomponentens

validering, må brugeren fo-

retage manuelt valg. KMD: ID1

teksten er korrigeret så den

matcher den implemente-

rede løsning. Typisk vil der

kun være et fagsystem som

matcher org og KLE og det

vil således ikke kræve bru-

gerinvolvering. KOMBIT skal beslutte om System-

Navn skal være mandatory

så det kan vises for bruge-

ren.

Begrænset

Side 10 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

5. Her modtages retursvar på baggrund at modtaget UUID (pkt. 4).

a. Fordelingskomponenten har valideret at have modtaget de nødvendige oplysnin-

ger til videresendelse af Journalnotatet

b. Modtagersystemet har modtaget Journalnotatet til videre behandling

c. Modtagersystemet fremsender accept af ejerskab for Journalnotatet

6. Behandling af modtaget accept/fejl

a. Accept af modtagelse – Journalnotat og evt. midlertidig Indekssag slettes

b. Modtagelsen er fejlet – Advis til sagsbehandler, metadata, herunder fagsystem,

låses op, således at Journalnotatet kan gensendes til Fordelingskomponenten,

eventuelt med KMD Sag som Modtagersystem.

2.1.2 Dokumenter

Der er mulighed for oprettelse af både ”Indgående” dokumenter – Skanning eller Digital Post og ”Udgående” dokumenter – Manuel oprettelse enten med udgangspunkt i en skabelon eller

via integration til Blanketsystem.

1. Opret dokument enten via

a. Indekssag Ved indgående dokumenter (Skanning og Digital Post) vil man ved tilknytning af

dokument til en Indekssag via almindelige arbejdsgange blive sendt til nyt vin-

due i KMD Sag

Ved manuel oprettelse af dokumenter på baggrund af skabelon eller blanket vil

man ligeledes automatisk blive sendt til nyt vindue i KMD Sag

b. Ingen sag

Ved indgående dokumenter (Skanning og Digital Post) vil man ved tilknytning af

dokument via almindelige arbejdsgange blive sendt til nyt vindue i KMD Sag

Nyt vindue i KMD Sag for metadata tilføjes.

På baggrund af oplysning om Organisation og KLE* vil der via kald til Fordelingskomponenten

Kommentar [DGJ2]: Sags

behandler skal her kunne

fjerne en eventuel sagstil-

knytning, så et system kan

vælges ud fra Org/KLE

KMD: ID2

teksten præciseret. KOMBIT skal undersøge

med SAPA

Begrænset

Side 11 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

vises mulige IT-systemer (leverandører), som brugeren skal kan vælge (hvis der kun er en

mulig leverandør, vælges denne automatisk). Samtlige oplysninger, som indgår i kaldet til For-

delingskomponenten, fremgår af Løsningsbeskrivelsens afsnit 3.

2. Metadata skal bl.a. indeholde Kommunenr., KLE-nummer, Modtagersystem (leveran-

dør), Part (cpr.nr.), Sagsbehandler. Kravene til beskedkuvertens metadata fremgår af

Løsningsbeskrivelsens afsnit 3

3. Dokumentets metadata sendes til ”Proceskomponenten”, som registrerer og videre-

sender til Fordelingskomponenten.

a. Dokumentet sendes til SFTP-server.

b. Metadata sendes til Fordelingskomponenten. Her modtages UUID, til brug for fremtidig kommunikation.

4. Forsendelse til Fordelingskomponenten. Der medsendes UUID, til brug for fremtidig

kommunikation.

a. Fordelingskomponenten har valideret at have modtaget de nødvendige oplysnin-

ger til videresendelse af Dokumentet

b. Modtagersystemet har modtaget Dokumentet til videre behandling

c. Modtagersystemet fremsender accept af ejerskab for Dokumentet

5. Behandling af modtaget accept/fejl

a. Accept af modtagelse – Dokumentet (Metadata og det fysiske dokument) og evt.

midlertidig Indekssag slettes

b. Modtagelsen er fejlet – Advis til sagsbehandler, metadata låses op, således at

Dokumentet kan gensendes til Fordelingskomponenten, eventuelt med KMD Sag

som Modtagersystem eller evt. gemmes lokalt i KMD Sag.

2.2 Journalnotater og dokumenter oprettet i andet Afsendersystem

Journalnotater og dokumenter, kan oprettes i andre Afsendersystemer og sendes via Forde-

lingskomponenten med KMD Sag som Modtagersystem.

Når journalnotat eller dokument er modtaget i KMD Sag sendes accept retur til Afsendersy-stemet via Fordelingskomponenten.

Hvis Journalnotatet eller dokumentet ikke kan modtages i KMD Sag, vil der blive sendt en

fejlmeddelelse til Afsendersystemet via Fordelingskomponenten. Der vil blive medsendt en for-

retningsmæssig forklaring med begrundelse på hvorfor objektet blev afvist.

2.2.1 Journalnotater

Når der modtages et journalnotat kontrolleres, at kommunen har adgang til oprettelse af jour-

nalnotater i KMD Sag. Herefter tilknyttes journalnotatet til en eksisterende sag på baggrund af

medsendt sags-UUID. Er der ikke medsendt sags-UUID kontrolleres, om kommunen har ad-

gang til oprettelse af manuelle sager. Hvis dette er tilfældet oprettes ny sag.

Kommentar [DGJ3]: Sam

me kommentar som oven-

for under Journalnotat

KMD: ID3

som ID1

Begrænset

Side 12 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

Hvis kommunen ikke har tilkøbt Journalfunktionen i KMD Sag, kan der ikke oprettes Journalno-

tat, og der vil blive sendt en fejl retur. Hvis kommunen ikke har tilkøbt funktionaliteten ”Manu-

elle sager”, vil modtagelsen også fejle.

Hvis Journalnotatet forsøges tilknyttet en Indekssag, vil modtagelsen ligeledes fejle.

Processen er automatisk.

2.2.2 Dokumenter

Når der modtages et dokument kontrolleres, at kommunen har adgang til oprettelse af doku-

menter i KMD Sag EDH. Herefter tilknyttes dokumentet til en eksisterende sag på baggrund af

medsendt sags-UUID. Er der ikke medsendt sags-UUID kontrolleres, om kommunen har ad-

gang til oprettelse af manuelle sager. Hvis dette er tilfældet oprettes ny sag.

Hvis kommunen ikke har tilkøbt KMD Sag EDH kan der ikke oprettes dokumenter og der vil bli-

ve sendt fejl retur. Hvis kommunen ikke har tilkøbt funktionaliteten ”Manuelle Sager, vil mod-

tagelsen også fejle.

Hvis dokumentet forsøges tilknyttet en Indekssag, vil modtagelsen ligeledes fejle.

Hvis der sendes dokumentmetadata på et nyt dokument til en eksiterende sag, vil de blive til-

knyttet sagen. (Forudsætter integration til Fordelingskomponenten version 2.0, hvilket ikke er

en del af [Baseline]).

Processen er automatisk.

2.3 Fejlhåndtering

2.3.1 Afsendelse af journalnotat eller dokument

Når der modtages en Forretningskvittering (ForretningsValideringsKode) på et afsendt doku-

ment eller journalnotat, opdateres status på det med ForretningsValideringsKoden og en evt.

beskrivelse, hvis det afsendte blev afvist eller fejlede. I de sidstnævnte tilfælde oprettes et ad-

vis. Dette sker efter følgende regler:

Hvis ForretningsValideringsKoden er:

MODTAGET, AFLEVERET, ACCEPTERET

opdateres status med samme værdi uden en beskrivelse.


AFVIST

opdateres status med samme værdi, der oprettes et advis og teksten i adviset udfyldes med

indholdet af feltet Begrundelse i forretningskvitteringen.


FEJLET

opdateres status med samme værdi, der oprettes et advis og teksten i bygges på basis af de modtagne FejlListe elementer:

Operationen fejlede med følgende fejlbeskeder: <fejl1.FejlTekst> (<fejl1.FejlKode>) <fejl2.FejlTekst> (<fejl2.FejlKode>)

Kommentar [DGJ4]: Det

skal være muligt at se me-

tadata omkring dokumentet

i KMD Sag basis, selvom kommunen ikke har aftale

omkring KMD Sag EDH.

Dette er en del af KMD Sag

udfasningsaftalen omkring

synkronisering.

Informationen vises på

samme måde som det i dag

sker for dokumenter i

Doc2Archive.

KMD: kommentaren er af-

vist med henvisning til dia-

log med Peter Müller.

DGJ: Dette er nu afklaret:

Hvis kommunen ikke har KMD Sag EDH, modtages

dokumentobjektet i KMD

Sag, mens den vedhæftede

fil ignoreres.

Der er en version 2 af For-

delingskomponenten under

udvikling; denne understøt-

ter at der sendes et doku-mentobjekt uden tilknyttet

fil. Hvis dokumentfilen ig-

noreres, vil det svare til at

der ikke modtages en fil

som defineret i version 2.

KOMBIT fastholder at do-

kumentobjekter skal kunne

indlæses i tabellen og vises i KMD Sag basis, selvom

kommunen ikke har EDH

tilknyttet.

KMD: ID5

Dette er omfattet af CR56.

Formateret: Fremhævning

Begrænset

Side 13 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

…

Der er således en linje for hver fejl i listen.

2.3.2 Modtagelse af journalnotat eller dokument

Når der modtages et journalnotat eller et dokument forsøges oprettet, sendes synkront svar tilbage således:

Hvis dokumentet eller journalnotatet kunne oprettes sendes en Forretningskvittering med For-

retningsvalideringsKode ACCEPTERET.

Hvis det ikke kunne oprettes sendes en Forretningskvittering med ForretningsvalideringsKode

FEJLET og en FejlListe med et element:

FejlKode = <Mainframe.ErrorCode> FejlTekst = <Mainframe.Reason> (<Mainframe.ReasonCode>)

Der understøttes således ikke asynkron afsendelse af forretningskvitteringer, fx AFVIST.

2.4 Arkitektur

Arkitekturen er beskrevet i ovenstående.

2.5 Forudsætninger

Det forudsættes at Fordelingskomponenten fungerer som overfor beskrevet.

2.6 Sikkerhedsmodel

Sikkerhed i forhold til Serviceplatformen er inkluderet i scope for klippekortet, men er ikke be-

handlet som en del af denne Løsningsbeskrivelse, da kravene ikke er kendt. Det betyder at det

anvendte estimat er et ’bedste gæt’, som vil blive revurderet når de endelige krav er kendt.

Løsningsbeskrivelsen, estimat og planen vil blive opdateret i forhold til implementering af sik-

kerhed i forhold til Serviceplatformen, når detailkrav/dokumentation er modtaget fra KOMBIT

og omfanget er analyseret af KMD.

2.6.1 Autorisation og logning hos KMD

KMD logger brugerens aktiviteter generelt. Samtidig logges kommunikationen med Fordelings-

komponenten.

2.7 Test

Løsningen verificeres ved dataleverance til/fra teststub på KMD’s testserver.

3. Datastrukturer

Når KMD Sag skal levere et journalnotat eller dokument til et Modtagersystem kaldes servicen FordelingsobjektAfsendRequest på Fordelingskomponenten med de tilhørende data. Detaljer

om de medsendte data er beskrevet i to sektioner:

Begrænset

Side 14 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

Send Journalnotat, se afsnit 3.1

Send Dokument, se afsnit 3.2

Når et Afsendersystem skal levere et journalnotat eller dokument til KMD Sag gøres det ved at

Fordelingskomponenten kalder servicen FordelingsobjektModtagRequest med de tilhørende da-

ta. Detaljer om de medsendte data er beskrevet i to sektioner:

Modtag Journalnotat, se afsnit 3.4

Modtag Dokument, se afsnit 3.5

Den anvendte XSD er DistributionServiceMsg.xsd, som ligger i [Baseline].

Forklaringer til skemaerne

I skemaerne nedenfor benyttes følgende værdier til at angive, om et felt skal udfyldes eller ej:

M = Krævet oplysning. O = Valgfri oplysning.

For Send journalnotat og Send dokument gælder at hvis Bemærkning/Link feltet ikke er ud-

fyldt vil feltet ikke blive udfyldt.

Der er strukturer i det følgende hvor de enten udfyldes for journalnotat eller for dokument.

Hvor hele strukturer ikke er udfyldt for det beskrevne objekt er de ikke vist i de følgende.

Begrænset

Side 15 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.1 Send journalnotat

3.1.1 FordelingsobjektAfsendRequest

FordelingsobjektAfsendRequest

Navn Type M/O Bemærkning/link

FordelingsobjektAf-

sendRequest:CallContext

M

callctx:CallContext O

tns:OnBehalfOfUser Tekst O

Kommentar [DGJ5]: In-

vocationContext er erstattet

af ny struktur CallContext

(Se SF2800 på kombit.dk)

Løses sandsynligvis af Sik-

kerhedsspor

KMD: ID7

Lukket i dette regi. (Be-mærk: SF2800 kan ikke

fremsøges på KOMBIT.dk)

KOMBIT: SF2800 findes

her.

https://share-komm.kombit.dk/p089/Integrationsbeskrivelser/SF2800%20-%20Fordelingskomponent%20-%20Modtag%20objekter%20v.2.0.0.pdf

Begrænset

Side 16 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

tns:CallersServiceCallIdentifier UUID O Udfyldes med fast UUID

tns:AccountingInfo UUID O Udfyldes med fast UUID

anmodning M Link: Anmodning

3.1.2 Anmodning

tns:anmodning


anmodning:DistributionContext M

tns:AnvenderTransaktionsID UUID M Udfyldes med en unik identifikation på

denne specifikke overførsel. Benyttes

til at koordinere det asynkrone svar i

anvendersystemet. Ved levering af

asynkron kvittering skal denne værdi

returneres uændret.

tns:DistributionTransaktionsID UUID O

tns:AfsendendeMyndighed CVR M Udfyldes med CVR nummer for kom-

mune / myndighed

tns:RoutingMyndighed CVR M Udfyldes med CVR nummer for kom-

mune / myndighed

DistributionContext:RoutingValg M

RoutingValg:RoutingEmneHandling M

tns:RoutingEmneFacet KLE M Udfyldes ikke.

tns:RoutingHandlingFacet Tekst O Udfyldes ikke.

Routing-Valg:RoutingModtagerAktoer

UUID M Udfyldes med UUID for leverandør, som modtaget fra Fordelingskompo-

nenten i første kald.

DistributionCon-

text:DokumentFilNavn

Tekst O

anmodning:DistributionObject M Link: DistributionObjectDistributionO-

bject

Kommentar [DGJ6]: Hvis

objektet er relateret til en

indekssag, skal det være

”MasterSystem” aktør-ID

fra sagsobjektet der angi-

ves her.

KMD: ID10

Afventer beslutning fra KOMBIT

KOMBIT: Et notat der

knyttes til en sag skal AL-

TID til det system der er

master på sagen

KMD: Den valgte imple-

mentering er som aftalt på

workshop med KOMBIT 6/11-2015 og betyder at

KMD Sag henter mulige IT

systemer fra Fordelings-

komponenten og hvis der

er flere mulige IT systemer

skal brugeren vælge.

Parallelt med dette blev der

i ÆA 125 arbejdet med ob-

jektroller, men de beslut-ninger der blev truffet i det-

te regi resulterede ikke i et

efterfølgende tilbageløb på

P14-3. Det vil være muligt

at ændre P14-3 jævnfør

ÆA125, men kræver en

ÆA.

Bemærk at objektroller an-vendes i Spor 2, men ikke i

P13-39.

Formateret: Skrifttype: 10pkt, Understregning

Begrænset

Side 17 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.1.2.1 DistributionObject

tns:DistributionObject


tns:ObjektType Tekst M Udfyldes med ”Journalnotat”

DistributionObject:ObjektIndhold M

ObjektIndhold:DistributionDokument M Udfyldes ikke for journalnotat

tns:ID Tekst M

tns:EmneFacetForslag KLE M

tns:HandlingFacetForslag Tekst O

tns:ObjektType Tekst M

tns:SagForslag Tekst O

DistributionDokument:Registrering M Udfyldes ikke for journalnotat

tns:FraTidsPunkt datetime M

tns:LivscyklusKode Tekst M

tns:ImportTidspunkt datetime O

tns:BrugerRef Tekst O

tns:RegistreringItSystem Tekst M

RelationListe M Udfyldes ikke for journalnotat

Tilstand M Udfyldes ikke for journalnotat

Attributliste M Udfyldes ikke for journalnotat

ObjektInd-

hold:DistributionJournalPost

M Link: DistributionJournalPostDistribu-

tionJournalPost


Begrænset

Side 18 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.1.2.1.1 DistributionJournalPost

tns:DistributionJournalPost


tns:ID UUID M Udfyldes med unik nøgle for journal-

postobjektet

(KMD Sag felt: EXPORTIARKDNOTAT-

INDEKS.NOTATUUID)

tns:EmneFacetForslag KLE M Udfyldes med KLE Emnefacet (nn.nn.nn) til at identificere den sag,

der skal modtage Journalposten.

Hvis SagForslag er udfyldt, udfyldes

dette felt med den primære klassifika-

tion fra sagen


INDEKS.EMNEFACET)

Begrænset

Side 19 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

tns:HandlingFacetForslag Tekst O Udfyldes med KLE Handlingsfacet (xn)

til at identificere den sag der skal

modtage dokumentet.


dette felt med den primære facet fra sagen eller hvis der ikke er en sag ud-

fyldes feltet som udfyldt af brugeren.

tns:ObjektType Tekst M Udfyldes med ”Journalnotat”

tns:SagForslag UUID O Udfyldes med reference til den sag

der er foreslået som destination for

journalposten dvs. indekssagens

UUID, hvis journalnotater er tilføjet til

en indekssag.

DistributionJournalPost:PartAngivelse O

tns:ObjektType Tekst M Angiver typen:

02 = Personnummer.

03 = SE/CVR-nummer.

10 = Myndighedsnummer (kun se-kundær part)

11 = Kommunenummer (kun sekun-

dær part)

12 = Nordisk myndighed (kun sekun-

dær part)

13 = Fritekst

14 = Ejendomsnummer

15 = Produktionsenhedsnummer

99 = Intet Objekt

tns:ReferenceID Tekst M For objekttype udfyldes:

02

"urn:oio:cpr:<objekt.objekt_id>"

03

"urn:oio:cvr:<objekt.objekt_id>"

13

”urn:oio:fuldtnavn:<objekt.objekt

.id>”

--

Udfyldes med

"urn:oio:cpr:nnnnnnnnnn",

"urn:oio:cvr:nnnnnnnn",

"urn:oio:pnr:xxxx" eller

"urn:oio:fuldtnavn:xxxx" afhængig

af den definerede objekttype.

Se evt.

Link: Bilag 1 - Mapning af objekttyper

Ejendomsnummer mappes til

”urn:oio:fuldtnavn:<Ejendom_<nr>

>” (KMD Sag felt: EXPORTIARKDNOTAT-

INDEKS.REFERENCEID)

DistributionJournalPost:Registrering M

tns:FraTidsPunkt datetime M Udfyldes med journalnotatets oprettel-sestidspunkt eller tidspunkt for tilknyt-ning til sag.

Begrænset

Side 20 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

tns:Livscykluskode Tekst M Udfyldes med ”Oprettet”

tns:ImportTidspunkt datetime O Udfyldes ikke

tns:BrugerRef Tekst O Udfyldes med URN på den bruger der

har oprettet journalnotatet (RACF).

tns:RegistreringItSystem UUID/

URN

M Udfyldes initielt med urn, der indehol-

der KMDSAG, men skal udfyldes med

en konstant udtrukket fra STS-

Organisation. KOMBIT leverer denne konstant.

Angiver en reference til organisation

for den IT-systemaktør der har afgivet

objektet (bemærk at dette ikke altid

er det samme som afsendersyste-

met).

Registrering:RelationListe:JournalPost Link: DistributionJournal-

Post:Registrering:RelationListe:Journa

lPostDistributionJournal-

Post:Registrering:RelationListe:Journa

lPost

3.1.2.1.2 DistributionJournalPost:Registrering:RelationListe:JournalPost

tns:JournalPost


Formateret: tx1

Begrænset

Side 21 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

JournalPost:Virkning M

tns:FraTidspunkt datetime O Tidspunktet for hvornår journalnotat

er oprettet.

tns:TilTidspunkt datetime O

tns:Aktoer Tekst M Udfyldes med URN med CVR nummer

for kommunen "urn:oio:cvr:<cvr>"


INDEKS.AFSENDENDEMYNDIGHED)

tns:AktoerType Tekst M Udfyldes med ”Myndighed”

tns:NoteTekst Tekst O

tns:JournalPost:Rolle Tekst M Udfyldes med ”Journalnotat”

tns:JournalPost:Indeks Tekst M Udfyldes med 1” ”

Journalpost:Dokument O


tns:ReferenceID Tekst M

JournalPost:JournalpostAttributter O

tns:DokumentTitel Tekst O

JournalpostAttribut-

ter:OffentlighedUndtaget

O

tns:TitelAlternativTekst Tekst M

tns:HjemmelTekst Tekst M

JournalPost:JournalnotatAttributter M

tns:Titel Tekst O Udyldes med overskrift for notatet


INDEKS.TITEL.TITELDV)

tns:Notat Tekst M Udfyldes med selve journalnotatet.

Maksimal længde på et journalnotat

er 51.200 tegn.

Benyttes OOXML format, er der tale

om binært indhold, der skal BASE64

kodes. Det er således størrelsen af

det BASE64 kodet indhold der er be-grænset til 51.200 tegn. Opdeles i se-

kvenser af 1024 karakterer.

(KMD Sag felt: GROUPEXPORTIND-

HOLDRG.GROUPEXPORTINDHOLD)

Kommentar [DGJ7]: Det-

te felt skal være tomt her

(Hvis validering kræver en

værdi skal denne være

blank

(Skyldes ændring i sagsin-

dekset, hvor feltet er optio-nelt)

KMD: ID15

uændret.

KOMBIT: Hvad betyder

det, at der stadig står en

værdi ”1”?

KMD: Feltet er mandatory,

udfyldes med blank (” ”).

Kommentar [DGJ8]: For-

delingskomponenten un-

derstøtter kun ren uformat-

teret tekst Teksten formatteres (UTF-

8) med linjeskift (CR,LF)

som en lang streng. Sidste

linje i teksten kræver ikke

CR,LF tilføjet.

Teksten placeres i feltet

”Notat” i BASE64 format.

KMD: ID16 KMD leveres i UTF-8.

Der encodes ikke til Base-

64 da feltet allerede er

tekst.

Begrænset

Side 22 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.1.3 Retursvar fra Fordelingskomponent

Valgt XSD: FordelingskvitteringModtagRequest

FordelingskvitteringModtagRequest


FordelingskvitteringMod-

tagRequest:CallContext

M

OnBehalfOfUser Tekst O

CallersServiceCallIdentifier Tekst O

AccountingInfo Tekst O

FordelingskvitteringModtagRequest:

Fordelingskvittering

M

ForretningsValideringsKode Tekst M Håndtering af svaret fra Fordelings-

komponenten, se afsnit 2.3.1

Begrundelse Tekst O Se afsnit 2.3.1

Fordelingskvittering:FejlListe:Fejl

FejlKode Tekst M Se afsnit 2.3.1

FejlTekst Tekst M Se afsnit 2.3.1

DistributionContext M Link: FordelingskvitteringModtag-

tag-

Request:DistributionContextFordelings

kvitteringMod-

tagRequest:DistributionContext

Kommentar [DGJ9]: det-

te skal bl.a. benyttes til sikkerhed

KMD: ID17

Den endelige version afven-

ter ny XSD fra KOMBIT


Begrænset

Side 23 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.1.3.1 FordelingskvitteringModtagRequest:DistributionContext


DistributionContext M

AnvenderTransaktionsID UUID M Anvendes ikke

DistributionTransaktionsID UUID O

AfsendendeMyndighed CVR M Anvendes ikke

RoutingMyndighed CVR M Anvendes ikke

DokumentFilNavn Tekst O


RoutingModtagerAktoer Tekst M Anvendes ikke


RoutingEmneFacet KLE M Anvendes ikke.

RoutingHandlingFacet Tekst O Anvendes ikke.

Begrænset

Side 24 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.2 Send dokument

3.2.1 FordelingsobjektAfsendRequest

FordelingsobjektAfsendRequest


FordelingsobjektAf-

sendRequest:CallContext

M

callctx:CallContext M


tns:CallersServiceCallIdentifier UUID O Udfyldes med fast UUID

tns:AccountingInfo UUID O Udfyldes med fast UUID

anmodning M Link: Anmodning

Begrænset

Side 25 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.2.2 Anmodning

tns:anmodning



tns:AnvenderTransaktionsID UUID M Udfyldes med en unik identifikation på

denne specifikke overførsel. Benyttes

til at koordinere det asynkrone svar i

anvendersystemet. Ved levering af

asynkron kvittering skal denne værdi

returneres uændret.

tns:DistributionTransaktionsID UUID O

tns:AfsendendeMyndighed CVR M Udfyldes med CVR nummer for kom-mune / myndighed

tns:RoutingMyndighed CVR M Udfyldes med CVR nummer for kom-

mune / myndighed



tns:RoutingEmneFacet KLE M Udfyldes ikke.

tns:RoutingHandlingFacet Tekst O Udfyldes ikke.

Routing-

Valg:RoutingModtagerAktoer

UUID M Udfyldes med UUID for leverandør,

som modtaget fra Fordelingskompo-


DistributionCon-text:DokumentFilNavn

Tekst O Udfyldes med navnet på den fil på FTP-serveren der indeholder den bi-

nære information til at kunne produ-

cere dokument image (f.eks. pdf eller

doc).

anmodning:DistributionObject M Link: DistributionObject

Kommentar [PSZ10]: DG

J:Hvis objektet er relateret

til en indekssag, skal det

være ”MasterSystem” ak-

tør-ID fra sagsobjektet der

angives her. KMD: ID10 (igen)

Afventer beslutning fra

KOMBIT

Begrænset

Side 26 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.2.2.1 DistributionObject

tns:DistributionObject


tns:ObjektType Tekst M Udfyldes med ”Dokument”


ObjektIndhold:DistributionDokument M

tns:ID UUID M UUID for dokumentet

tns:EmneFacetForslag KLE M Udfyldes med KLE Emnefacet

(nn.nn.nn)

Benyttes af modtager til at identificere

den sag der skal modtage dokumen-

tet.


dette felt med den primære klassifi-

kation fra sagen.

tns:HandlingFacetForslag Tekst O Udfyldes med KLE Handlingsfacet (xn)

som udfyldt af brugeren, eller som

angivet på sagen

Benyttes af modtager til at identifice-

re den sag der skal modtage doku-

mentet.

tns:ObjektType Tekst M Udfyldes med ”Dokument”

Begrænset

Side 27 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

tns:SagForslag Tekst O Udfyldes med reference til den sag

der er foreslået tilknyttet dokumentet,

dvs indekssagen, hvis en er valgt.

DistributionDokument:Registrering M

tns:FraTidsPunkt datetime M Udfyldes med timestamp for hvornår

registering er sendt til Fordelingskom-

ponenten.

Udfyldes med journalnotatets oprettel-sestidspunkt eller tidspunktet for tilknyt-ning til sag

tns:LivscyklusKode Tekst M Udfyldes med ”Oprettet”

tns:ImportTidspunkt datetime O Udfyldes ikke

tns:BrugerRef Tekst O Udfyldes med URN på den bruger der

har oprettet journalnotat (RACF).

tns:RegistreringItSystem Tekst M Udfyldes initielt med urn, der indehol-

der KMDSAG, men skal udfyldes med

en konstant udtrukket fra STS-

Organisation. KOMBIT leverer denne

konstant.

Angiver en reference til organisation

for den IT-systemaktør der har afgivet

objektet (bemærk at dette ikke altid

er det samme som afsendersyste-

met).

Registrering:RelationListe M Link: Registre-

ring:RelationListeRegistrering:Relation

Liste

Registrering:Tilstand M Link: Registre-

ring:TilstandRegistrering:Tilstand

Registrering:Attributliste M Link: Registre-

ring:AttributListeRegistrering:Attribut

Liste

ObjektInd-


M Udfyldes ikke for dokument




Begrænset

Side 28 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.2.2.1.1 Registrering:RelationListe

tns:RelationListe


RelationListe:VariantListe M

VariantListe:Variant M

Variant:Virkning M

tns:FraTidspunkt datetime O Datetime for hvornår dokumentet er

oprettet.

tns:TilTidspunkt datetime O Udfyldes ikke

Begrænset

Side 29 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:






tns:NoteTekst Tekst O Udfyldes ikke

Variant:Rolle Tekst M Udfyldes med ”Variant”

Variant:Indeks Tekst M 1

Variant:VariantAttributter M

tns:VariantType Tekst M Udfyldes med extension på fil.

tns:Produktion Tekst O Udfyldes ikke

tns:Offentliggoerelse Bool O Udfyldes ikke

tns:Arkivering Bool O Udfyldes ikke

tns:DelvistScannet Bool O Udfyldes ikke

Variant:DelAttributter M

tns:DelTekst Tekst M Udfyldes med ”Dokument”

tns:Indeks Integer O 1

tns:Indhold Tekst O Udfyldes med dokumentets filnavn på

SFTP server

tns:Filstoerrelse Integer O Udfyldes med størrelsen på filen

tns:MimeType Tekst O Udfyldes ikke

tns:ScannerID Tekst O Udfyldes ikke

tns:Lokation Tekst O Udfyldes med den fulde filangivelse,

dvs. sti + fuldt filnavn

RelationListe:DokumentPartListe O Link: Fejl! Henvisningskilde ikke

fundet.DokumentPartListe


Begrænset

Side 30 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.2.2.1.2 DokumentPartListe

tns:DokumentPartListe O


DokumentPartListe:DokumentPart O

DokumentPart:Virkning M

tns:FraTidspunkt datetime O Udfyldes med dokumentets oprettel-

sestidspunkt








DokumentPart:Rolle Tekst M Udfyldes med ”PrimaerPart”

DokumentPart:Indeks Integer M Udfyldes altid med ”1 ”

DokumentPart:Part M

tns:ObjektType Tekst M Angiver typen (Person/ Virksomhed/

Produktionsenhed/ Myndighed/ Ejen-

dom, Andet)

Kommentar [DGJ11]: To

mt felt/ blank (Ændring i

sagsindeks) KMD: ID23

Ændres ikke.

KOMBIT: Hvad betyder det

at dette felt stadig har en

værdi ”1”?

KMD: Udfyldes med blank

(” ”)

Begrænset

Side 31 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

tns:ReferenceID URN M Brugervendt nøgle (CPR nr, CVR nr, P

nr, MyndighedsID, Ejendomsnummer,

Andet)

Angives i form af URN: urn:oio:cpr:xxxxxxxxxx

urn:oio:cvr:xxxxxxxx

urn:oio:pnr:xxxxxxxx

urn:oio:fuldtnavn:xxxx

3.2.2.1.3 Registrering:Tilstand

tns:Tilstand M


Tilstand:Fremdrift Tekst M ”Endeligt”

Tilstand:Virkning M


sestidspunkt








Begrænset

Side 32 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.2.2.1.4 Registrering:AttributListe

tns:AttributListe M


AttributListe:Attributter M

tns:BrugerVendtNoegleTekst Tekst M Udfyldes med en talrækkefølge sam-

mensat af organisations-id, årstal og

løbenummer (starter forfra hvert år).

Format: orgid-aar-loebenr.

orgid er numerisk 4, år er numerisk 4,

loebenr numerisk 15.

F.eks.: 173-2010-188.

Foranstillede nuller fjernes

tns:TitelTekst Tekst M Udfyldes med overskrift på dokumen-

tet

tns:BeskrivelseTekst Tekst M Udfyldt med dokumentbeskrivelse i fri

Begrænset

Side 33 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

tekst.

tns:Dokumenttype Tekst M Udfyldes med ”Andet”

tns:Retning Tekst M Udfyldes med retningen for dokumen-

tet.

I KMD Sag EDH findes følgende do-

kumenttyper: Indgående, Udgående

eller Internt notat. Mulighederne for

yderligere værdier afhænger derfor

af, om kommunen har oprettet dem

via KMD Sag Administration.

Hvis det ikke er en standard type, vil

feltet blive udfyldt med ”Internt”

tns:Brevdato datetime M Udfyldes med den brevdato, der

fremgår af det indgående dokument

tns:Fristdato datetime O Udfyldes hvis fristdato er udfyldt på

dokument

tns:VersionIdentifikator Integer O Udfyldes ikke

tns:UnderversionIdentificator Integer O Udfyldes ikke

tns:KassationskodeTekst Tekst O Udfyldes ikke

Attributter:Virkning M


sestidspunkt








Attributter:OffentlighedUndtaget O Udfyldes ikke



Begrænset

Side 34 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.2.3 Retursvar fra Fordelingskomponent

Valgt XSD: FordelingskvitteringModtagRequest

FordelingskvitteringModtagRequest


FordelingskvitteringMod-

tagRequest:InvocationContext

M


tns:CallersServiceCallIdentifier Tekst O

tns:AccountingInfo Tekst O

FordelingskvitteringModtagRequest:

Fordelingskvittering

M

tns:ForretningsValideringsKode Tekst M Håndtering af svaret fra Fordelings-


tns:Begrundelse Tekst O Se afsnit 2.3.1

Fordelingskvittering:FejlListe:Fejl

tns:FejlKode Tekst M Se afsnit 2.3.1

tns:FejlTekst Tekst M Se afsnit 2.3.1

FordelingskvitteringModtag

tag-

Request:DistributionContext

M Link: FordelingskvitteringModtag-

tag-

Request:DistributionContextFordelings

kvitteringMod-

tagRequest:DistributionContext


Begrænset

Side 35 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.2.3.1 FordelingskvitteringModtagRequest:DistributionContext



AnvenderTransaktionsID UUID M Skal udfyldes med en den unikke

identifikation der var knyttet til trans-

aktionen.


AfsendendeMyndighed CVR M Skal udfyldes med CVR-nummer for

afsender myndigheden. Myndigheden

skal ved afsendelse være den samme

som den der angives i InvocationCon-

text

RoutingMyndighed CVR M CVR-nummer for modtager myndig-

hed. Bemærk at denne kan afvige fra

AfsendendeMyndighed ovenfor.



RoutingModtagerAktoer Tekst M Skal udfyldes med UUID for den leve-

randør, leveret af Fordelingskompo-



RoutingEmneFacet KLE M Skal udfyldes med KLE Emnefacet

(nn.nn.nn).

RoutingHandlingFacet Tekst O Udfyldes med KLE Handlingsfacet

(xn).

Yderligere specifikation til brug for

routing.

Begrænset

Side 36 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.2.4 FordelingskvitteringModtagRequest:DistributionContext



AnvenderTransaktionsID UUID M Skal udfyldes med en den unikke

identifikation der var knyttet til trans-

aktionen.


AfsendendeMyndighed CVR M Skal udfyldes med CVR-nummer for

afsender myndigheden. Myndigheden

skal ved afsendelse være den samme

som den der angives i InvocationCon-

text

RoutingMyndighed CVR M CVR-nummer for modtager myndig-

hed. Bemærk at denne kan afvige fra

AfsendendeMyndighed ovenfor.



RoutingModtagerAktoer Tekst M Skal udfyldes med UUID for den leve-

randør, leveret af Fordelingskompo-



RoutingEmneFacet KLE M Skal udfyldes med KLE Emnefacet

(nn.nn.nn).

RoutingHandlingFacet Tekst O Udfyldes med KLE Handlingsfacet

(xn).

Yderligere specifikation til brug for

routing.

Begrænset

Side 37 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.3 Modtagelse af journalnotat eller dokument

Hvis der fremsendes et journalnotat eller dokument som refererer til en sag, som ikke eksi-

strer eller hvor KMD Sags forretningsregler ikke er opfyldt (fx sagen er passiv), vil KMD Sag

oprette en ny manuel sag til at indeholde journalnotatet/dokumentet. Der skal checkes for li-cens til Manuelle sager.

Attributterne for den nye manuelle sag vil basere sig på de fremsendte data, fx personnum-

mer, KLE, etc. Sagens attributter vil basere sig på en eksisterede sag (Sagforslag), hvis til-

knytning af journalnotat eller dokument ikke kan lade sig gøre.

For attributter der ikke er obligatoriske gælder følgende default værdier:

Handlingsfacet: G01

Hvis KLE ikke er valid ifht KMD Sags KLE vil der blive anvendt følgende regler:.

Hvis emnefacet = space, returneres med fejlkode og fejlbesked.

Hvis handlingsfacet er udfyldt, skal den være valid og være på niveau 2 (fx G01).

Hvis handlingsfacet ikke er valid returneres med fejlkode og fejlbesked.

Hvis der ikke er tale om en EDH kommune, returneres med fejlkode og fejlbesked.

3.4 Modtag journalnotat

FordelingsobjektModtagRequest: denne service anvendes når et Afsendersystem vil levere et

journalnotat til et Modtagersystem, dvs. i dette tilfælde KMD Sag.

Skemaerne nedenfor beskriver hvorledes KMD Sag anvender de felter som Afsendersystemet

leverer. Der er i skemaerne taget stilling til alle obligatoriske felter (M) og relevante optionelle

felter. Felter hvor der ikke står noget i Bemærkning/link gemmes ikke i KMD Sag.

Skemaet for FordelingsobjektModtagRequest findes i DistributionServiceMsg.xsd

3.4.1 FordelingsobjektModtagRequest

Kommentar [MRL12]: Hvi

s modtagelse nægtes grun-det manglende licens til

EDH eller Manuelle sager,

må der ikke returneres en

fejl, men skal afvises med

forretningskvittering AFVIS.

Dette da der ikke er tale

om fejl, men en forret-

ningsmæssig afvisning af

notatet (KMD Sag under-støtter ikke Journalnota-

tet/Dokumentet).

KMD: Det der sendes er en

AFVIS, men teknisk er det

at betragte som en fejlko-

de.

Begrænset

Side 38 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

FordelingsobjektModtagRequest Den request, der sendes fra Fordelingskompo-

nenten med et objekt fra et Afsendersystem.

Her beskrives hvorledes et modtaget journalno-

tat behandles i KMD Sag.


FordelingsobjektModtagRequest M

FordelingsobjektMod-

tagRequest:anmodning

M


tns:AnvenderTransaktionsID UUID M UUID genereret af Afsendersystem til

identifikation af denne transaktion.

Skal anvendes i forbindelse med svar.

tns:DistributionTransaktionsID Tekst O Anvendes til retursvaret til Forde-

lingskomponenten.

tns:AfsendendeMyndighed CVR M CVR-nummer for afsender myndighe-

den – gemmes i Kommunenummer.

tns:RoutingMyndighed CVR M Indeholder det samme som Afsenden-

deMyndighed (i version 1). Gemmes

ikke.

tns:DokumentFilNavn Tekst O

DistributionCon-

text:RoutingValg

M

tns:RoutingModtagerAktoer Tekst M Gemmes ikke.

Routing-

Valg:RoutingEmneHandling

M

tns:RoutingEmneFacet KLE M Gemmes ikke.

tns:RoutingHandlingFacet Tekst O Gemmes ikke.

anmodning:DistributionObject M

ObjektIndhold M Link: anmodning:DistributionObject

Begrænset

Side 39 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.4.1.1 anmodning:DistributionObject

DistributionObject M


tns:ObjektType M Angiver typen af objekt, enten ”Jour-

nalnotat” eller ”Dokument”.

Dette afsnit beskriver mapning af fel-

ter hvor ObjektType er ”Journalnotat”.

Feltet gemmes ikke.


ObjektIndhold:DistributionDokument M Gemmes ikke for dokument

tns:ID Tekst M

tns:EmneFacetForslag KLE M

tns:HandlingFacetForslag Tekst O




tns:FraTidsPunkt datetime M

tns:Livscykluskode Tekst M



tns:RegistreringItSystem Tekst M

RelationsListe M Gemmes ikke for dokument

Tilstand M Gemmes ikke for dokument

AttributListe M Gemmes ikke for dokument

Begrænset

Side 40 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

ObjektIndhold:Distribution-

JournalPost

M Link: Objektind-

hold:DistributionJournalPostObjektind


3.4.1.1.1 Objektindhold:DistributionJournalPost

Objektind-


M


tns:ID Tekst M UUID for journalnotatet. Konverteres

til COID og INSTANCE_ID. Hver gang

et journalnotat fremsendes vil det bli-

ve gemt, dvs. gensendte journalnota-

ter vil ligge i flere kopier. Hver frem-

sendelse vil blive mærket med sin

egen UUID, baseret på COID og IN-

STANCE_ID.

tns:EmneFacetForslag KLE M Anvendes til oprettelse af ny sag, hvis

SagForslag ikke er validt eller udfyldt.


Formateret: Skrifttype: 10pkt

Kommentar [DGJ13]: Ko

nverteringen skal sikre en

unik nøgle, så genfremsen-

delse af samme UUID efter

positiv kvittering fejlmeldes som dublet. Bemærk at

UUID her er genereret af et

andet system, og derfor ik-

ke kan relateres til nøglerne

i KMD Sag. Bemærk at for-

delingskomponentet ikke

understøtter korrektioner.

Eventuelle korrektioner må derfor efterfølgende udføres

af en KMD Sag bruger

KMD: ID29

Dette er implementeret

som beskrevet.

KOMBIT: Beskriv det i tek-

sten, hvis det er implemen-

teret som DGJ har beskre-vet.

KMD: teksten beskriver det

der er implementeret (ikke

det DGJ efterspørger).

Begrænset

Side 41 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

tns:HandlingFacetForslag Tekst O Anvendes til oprettelse af ny sag, hvis


Hvis ikke udfyldt anvendes G01.

tns:ObjektType Tekst M Udfyldes med ”Journalpost”

tns:SagForslag Tekst O UUID på den sag som journalnotatet

foreslås tilknyttet.

UUID converteres til COID og IN-

STANCE_ID og sagen fremsøges.

Hvis sagen findes og er valid lægges

journalnotat på sagen.

Hvis sagen ikke findes, eller ikke er

valid eller ikke er angivet oprettes en

ny manuel sag med anvendelse af

EmneFacetForslag, se beskrivelse i

afsnit 3.3.


tns:ObjektType Tekst M Udfaldsrummet er:

”Person” (CPR)

”Virksomhed” (CVR)

”Organisation”

”OrgEnhed”

”OrgFunktion”

”Interesse-faellesskab”

”Bruger”

tns:ReferenceID Tekst M Dette angiver den eksterne relation til

parten (f.eks. CPR-nr).

Dekodes i forhold til ObjektType såle-

des at cifre i teksten angiver fx

CPR/CVR nr.


tns:FraTidsPunkt datetime M Tidsstempel for oprettelse af journal-

notat. Gemmes som oprettelsestids-

punkt for journalnotatet. Hvis tids-

stemplet er -∞ anvendes sagens

oprettelsestidspunkt.

tns:Livscykluskode Tekst M Gemmes ikke.


tns:BrugerRef Tekst O Hvis udfyldt konverteres BrugerRef til

KMD Sag brugeridentifikationGemmes

ikke.

tns:RegistreringItSystem Tekst M Gemmes ikke.

Registrering:RelationListe M

RelationListe:JournalPost M Link: DistributionJournal-

Post:JournalPostDistributionJournalPo

st:JournalPost

Kommentar [DGJ14]: Det

te er ikke muligt, da bruger

vil være UUID til STS-

Organisation. Dette er pt.

et udestående – Skal løses

via Spor 2 eller en udvidel-se af Fordelingskompone-

neten, så afsender angiver

brugernavn

KMD: ID31

Ingen rettelse.

KOMBIT: Løses det via

Spor 2 i og med, at der ik-

ke er nogen rettelse?

KMD: teksten rettet



Begrænset

Side 42 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.4.1.1.2 DistributionJournalPost:JournalPost

JournalPost M


JournalPost:Virkning M

tns:FraTidspunkt dateTime O

tns:TilTidspunkt dateTime O

tns:Aktoer Tekst M CVR nummer for kommunen

tns:AktoerType Tekst M Gemmes ikke.


JournalPost:Rolle Tekst M Gemmes ikke.

JournalPost:Indeks Tekst M Gemmes ikke.

JournalPost:Dokument O

tns:Objekttype Tekst M Hvis udfyldt sendes anvendes som

Objekttype, se Bilag 1 - Mapning af

objekttyperBilag 1 - Mapning af ob-

jekttyper


Begrænset

Side 43 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

tns:ReferenceID Tekst M Hvis udfyldt sendes anvendes som ID,

fx CPR/CVR/…


tns:Dokumenttitel Tekst O



O




tns:Titel Tekst O Gemmes i titel for journalnotat

tns:Notat Tekst M Gemmes i journalnotat tekst. Der

modtages kun tekstformat.

3.4.2 Retursvar til Fordelingskomponent/Afsendersystem

Det svar som KMD Sag sender til Fordelingskomponenten efter behandling af det modtagne

journalnotat er via servicen FordelingskvitteringAfsendResponse.

FordelingskvitteringAfsendResponse M


FordelingskvitteringAfsendRespon-

se:Forretningskvittering

M

tns:ForretningsValiderings-

Kode

Tekst M Håndtering af svaret fra Fordelings-



Kommentar [DGJ15]: Der modtages kun ren tekst,

som er BASE64 kodet (En

lang streng i UTF-8 med

CR,LF)

KMD:ID35

Gemmes som tekst.

Begrænset

Side 44 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

Forretningskvittering:FejlListe O

FejlListe:Fejl


tns:FejlTekst Tekst O Se afsnit 2.3.2


se:DistributionContext

M

tns:AnvenderTransaktionsID UUID M Modtaget AnvenderTransaktionsID

returneres for at kunne koble request

med response.

tns:DistributionTransaktions

ID

UUID O Hvis Request indeholder Distribution-

TransaktionsID returneres den i dette

felt.

tns:AfsendendeMyndighed CVR M

tns:RoutingMyndighed CVR M



tns:RoutingEmneFacet Tekst M

tns:RoutingHandlingFacet Tekst O

Routing-


Tekst O

DistributionCon-text:DokumentFilNavn

Tekst O

3.5 Modtag dokument

FordelingsobjektModtagRequest: denne service anvendes når et Afsendersystem vil levere et dokument til et Modtagersystem, dvs. i dette tilfælde KMD Sag.

Skemaerne nedenfor beskriver hvorledes KMD Sag anvender de felter som Afsendersystemet

leverer. Der er i skemaerne taget stilling til alle obligatoriske felter (M) og relevante optionelle

felter. Felter hvor der ikke står noget i Bemærkning/link gemmes ikke i KMD Sag.

Skemaet for FordelingsobjektModtagRequest findes i DistributionServiceMsg.xsd

Kommentar [DGJ16]: Al-le felter i denne struktur

skal indeholde en komplet

kopi af det der blev modta-

get i ”Forretningsobjekt-

ModtagRequest”

KMD: ID39

KOMBIT bedes forklare det

forretningsmæssige formål

med dette. Pt er det ikke implementeret at returnere

alt hvad der er modtaget.

Begrænset

Side 45 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.5.1 FordelingsobjektModtagRequest

FordelingsobjektModtagRequest Den request, der sendes fra Fordelingskompo-

nenten med et objekt fra et Afsendersystem.

Her beskrives hvorledes et modtaget dokument

behandles i KMD Sag.


FordelingsobjektModtagRequest M

FordelingsobjektMod-

tagRequest:anmodning

M


tns:AnvenderTransaktionsID UUID M UUID genereret af Afsendersystem til

identifikation af denne transaktion.

Skal anvendes i forbindelse med svar.

tns:DistributionTransaktionsID UUID O Anvendes til retursvaret til Forde-

lingskomponenten.

tns:AfsendendeMyndighed CVR M CVR-nummer for afsender myndighe-

den – gemmes i Kommunenummer.

tns:RoutingMyndighed CVR M CVR-nummer for modtager myndig-

hed konverteres til Adm Enhedsid

tns:DokumentFilNavn Tekst O

DistributionCon-

text:RoutingValg

M

tns:RoutingModtagerAktoer Tekst M Gemmes ikke.

Routing-

Valg:RoutingEmneHandling

M

tns:RoutingEmneFacet KLE M Anvendes ikke.

tns:RoutingHandlingFacet Tekst O Anvendes ikke.

anmodning:DistributionObject M

ObjektIndhold M Link: anmodning:DistributionObject

Begrænset

Side 46 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.5.1.1 anmodning:DistributionObject

DistributionObject M


tns:ObjektType M Angiver typen af objekt, enten ”Jour-

nalnotat” eller ”Dokument”.

Dette afsnit beskriver mapning af fel-

ter hvor ObjektType er ”Dokument”.

Feltet gemmes ikke.


ObjektIndhold:DistributionDokument M

tns:ID Tekst M Der oprettes en ny COID og INSTAN-

CE_ID. Hver gang et dokument frem-

sendes vil det blive gemt, dvs. gens-

endte dokumenter vil ligge i flere

kopier. Hver fremsendelse vil blive

mærket med sin egen UUID, baseret

på COID og INSTANCE_ID.

tns:EmneFacetForslag KLE M Anvendes til oprettelse af ny sag, hvis


tns:HandlingFacetForslag Tekst O Anvendes til oprettelse af ny sag, hvis


Hvis ikke udfyldt anvendes G01.

tns:ObjektType Tekst M Anvendes ikke

Kommentar [DGJ17]: Her

er tale om et dokument.

Konverteringen skal sikre

en unik nøgle, så genfrem-

sendelse af samme UUID

efter positiv kvittering fejl-

meldes som dublet. Be-

mærk at UUID her er gene-

reret af et andet system, og derfor ikke kan relateres til

nøglerne i KMD Sag. Be-

mærk at fordelingskompo-

nentet ikke understøtter

korrektioner. Eventuelle

korrektioner må derfor ef-

terfølgende udføres af en

KMD Sag bruger KMD: ID 42

KMD Sag opretter en ny

COID og INSTANCE_ID ved

modtagelse af et doku-

ment. Gensendte dokumen-

ter vil derfor forekomme

flere gange.

KOMBIT: Håndtering af dubletter og korrektioner er

ikke beskrevet. Det skal

meget gerne uddybes.

KMD: funktion uddybet.

Begrænset

Side 47 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

tns:SagForslag Tekst O UUID på den sag som dokumentet fo-

reslås tilknyttet.

UUID converteres til COID og IN-

STANCE_ID og sagen fremsøges.

Hvis sagen findes og er valid lægges

journalnotat på sagen.

Hvis sagen ikke findes, eller ikke er

valid eller ikke er angivet oprettes en

ny manuel sag, se beskrivelse i afsnit

3.3.


tns:FraTidsPunkt datetime M Tidsstempel for oprettelse af doku-

ment. Gemmes som oprettelsestids-

punkt for dokumentet.

tns:Livscykluskode Tekst M Gemmes ikke. Tilstand på dokument

sættes til Godkendt.


tns:BrugerRef Tekst O Gemmes i diversefelt.


RelationsListe M Link: DistributionDoku-

ment:RelationListeDistributionDokume

nt:RelationListe

Tilstand M Link: DistributionDoku-

ment:TilstandDistributionDokument:Ti

lstand

AttributListe M Link: DistributionDoku-

ment:AttributListeDistributionDokume

nt:AttributListe

ObjektIndhold:Distribution-

JournalPost

M Link: Objektind-

hold:DistributionJournalPostObjektind


Kommentar [DGJ18]: De

nne bruger er vigtig af hen-

syn til eventuel opfølgning

på den foretagne tilaktering

og vil være UUID til STS-

Organisation. Dette er pt.

et udestående – Skal løses

via Spor 2 eller en udvidel-

se af Fordelingskompone-

neten, så afsender angiver

brugernavn

KMD: ID45

Teksten rettet





Begrænset

Side 48 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.5.1.1.1 DistributionDokument:RelationListe

RelationListe M


RelationListe:VariantListe:Variant M

Variant:Virkning M

tns:FraTidspunkt datetime O Varianter der har VirkningFra > NU

ignoreres. Hvis ingen varianter har

virkning NU returneres en fejlkode og

fejlbesked.

Kommentar [DGJ19]: Sk

al afvises med fejl, såfremt

dette tidspunkt er fremme i

tiden (Der understøttes kun

varianter med virkning her

og nu)

KMD: ID47 KMD ignorerer de varianter

der har virkning ud i tiden.

Der kan være relevante ob-

jekter transaktionen som

går tabt ved at afvise hele

transaktionen.

KOMBIT: Data kan ikke

blot ignoreres. De skal afvi-ses m. AFVIST (Det er en

forretningsmæssig afvis-

ning og ikke en fejl).

KMD: Teksten uddybet.

Begrænset

Side 49 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

tns:TilTidspunkt datetime O Varianter der har VirkningTil < NU ig-

noreres. Hvis ingen varianter har


fejlbesked.

tns:Aktoer Tekst M CVR nummer for kommunen - gem-

mes ikke, da den allerede er taget fra

tidligere forekomst.



Variant:Rolle Tekst M Gemmes ikke.

Variant:Indeks Tekst M Gemmes ikke.

Variant:VariantAttributter M

tns:VariantType Tekst M Gemmes ikke.

tns:Produktion Tekst O

tns:Offentliggoerelse Bool O

tns:Arkivering Bool O

tns:DelvistScannet Bool O

Variant:DelAttributter M

tns:DelTekst Tekst M Gemmes ikke.

tns:Indeks Integer O

tns:Indhold Tekst O Navn på fil, placeret på SFTP server.

Anvendes til at hente filen.

tns:Filstoerrelse Integer O Gemmes i Dok.Størrelse.

tns:MimeType Tekst O

tns:ScannerID Tekst O Hvis feltet er udfyldt gemmes indhol-

det på Diversefelt kaldet ScannerID.

Diversefelt

tns:Lokation Tekst O Hvis feltet er udfyldt gemmes indhol-

det på Diversefelt kaldet ArkivRefe-

rence.

Arkiv Reference

RelationListe:DokumentPartListe O Link: RelationLi-

ste:DokumentPartListeRelationListe:D

okumentPartListe



dette tidspunkt er tilbage i

tiden (Der understøttes kun

varianter med virkning her og nu). Det skal defineres

hvordan virkning til-dato

håndteres i KMD Sag

KMD: ID48

Udløbne varianter ignore-

res.

KOMBIT: Data kan ikke

blot ignoreres. De skal afvi-ses m. AFVIST (Det er en



KMD: tekten uddybet.


Begrænset

Side 50 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.5.1.1.2 RelationListe:DokumentPartListe

DokumentPartListe O


DokumentPartListe:DokumentPart M

DokumentPart:Virkning M

tns:FraTidspunkt datetime O Parter, der har VirkningFra > NU igno-

reres. Hvis ingen parter har virkning

NU returneres en fejlkode og fejlbe-

sked.

tns:TilTidspunkt datetime O Parter, der har VirkningTil < NU igno-

reres. Hvis ingen parter har virkning

NU returneres en fejlkode og fejlbe-

sked.

tns:Aktoer Tekst M Gemmes ikke – er taget fra tidligere

forekomst.

tns:AktoerType Tekst M Gemmes ikke – er taget fra tidligere

forekomst.


Kommentar [PSZ21]: DG

J: Denne liste af relaterede personer overføres til den

sag der oprettes (dvs. hvis

dokumentet ikke tilknyttes

en eksisterende sag)

KMD: ID49

Parterne lægges på doku-

mentet, men der oprettes

ikke en sag, da KMD Sag kan håndtere sagsløse do-

kumenter. Hvis dokumentet

tilknyttes en sag vil sagen

ikke blive opdateret med de

til dokumentet tilknyttede

parter. Det er en manuel

opgave for sagsbehandle-

ren.

Kommentar [DGJ22]: Der

er ikke beskrevet hvordan

flere virkninger håndteres. Alternativt skal dokumenter

med flere virkninger på re-

laterede personer afvises.

NB! KMD Sag understøtter

flere parter på dokumenter,

men der understøttes kun

en virkning (her-og-nu) pr.

relateret person. Skal afvises med en fejl,

hvis FraTidspunkt er frem i

tiden (Understøttes ikke)

KMD: ID50

som tidligere er der tale om

en passende fejlkode og

fejlbesked.




tiden (Der understøttes kun relaterede personer med

virkning her og nu). Det

skal defineres hvordan

virkning til-dato håndteres i

KMD Sag

KMD: ID51

Udløbne parter ignoreres

KOMBIT: Data kan ikke blot ignoreres. De skal afvi-

ses m. AFVIST (Det er en


ning og ikke en fejl). ...

Begrænset

Side 51 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

DokumentPart:Rolle Tekst M Udfaldsrummet er

”PrimaerPart”

”SekundaerPart”

”KopiModtager”.

Gemmes som hhv Primær part, se-

kundær part og sekundær part.

DokumentPart:Indeks Integer M Gemmes ikke.1

DokumentPart:Part M

tns:ObjektType Tekst M Det udfaldsrum der mappes er:

”Person” (CPR)

”Virksomhed” (CVR)

”Organisation”

”OrgEnhed”

”OrgFunktion”

”Interesse-faellesskab”

”Bruger”

Hvis udfyldt sendes anvendes som

Objekttype, se Bilag 1 - Mapning af

objekttyperBilag 1 - Mapning af ob-

jekttyper

tns:ReferenceID Tekst M Hvis udfyldt sendes anvendes som ID,

fx CPR/CVR/…

3.5.1.1.3 DistributionDokument:Tilstand

Tilstand M


1 Bemærk: feltet er af type Integer, jf. nyeste XSD. ”SF2800 - Fordelingskomponent - Modtag objekter v.2.0.0.pdf” angiver at dette er

tekst. Integer anvendes til validering.


Begrænset

Side 52 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

Tilstand M

tns:Fremdrift Tekst M Status på dokument sættes altid til Godkendt.

Tilstand:Virkning M

tns:FraTidspunkt datetime O Gemmes ikke, da status altid sættes

til Godkendt.


tns:Aktoer Tekst M Gemmes ikke.



3.5.1.1.4 DistributionDokument:AttributListe

AttributListe M


Begrænset

Side 53 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

AttributListe M

AttributListe:Attributter M

tns:BrugerVendtNoegleTekst Tekst M Gemmes i Diverse felt

tns:TitelTekst Tekst M Gemmes i Overskrift for dokument.

tns:BeskrivelseTekst Tekst M Gemmes i Beskrivelse.

tns:Dokumenttype Tekst M Gemmes i Medie/kanal [”Faktura”,

”Brev”, ”Notat”…].

tns:Retning Tekst M Gemmes i Type.

Indgaaende -> Indgående

Udgaaende -> Udgående

InterntInd -> Internt

InterntUd -> Internt

Internt -> Internt

tns:Brevdato datetime M Gemmes i Dato.

tns:Fristdato datetime O Gemmes i Fristdato.

tns:VersionIdentifikator Integer O Gemmes i Version.

tns:UnderversionIdentificator Integer O Gemmes ikke.

tns:KassationskodeTekst Tekst O Gemmes i Kassation

Attributter:Virkning M

tns:FraTidspunkt datetime O Attributter der har VirkningFra > NU

ignoreres. Hvis ingen attributter har


fejlbesked.

tns:TilTidspunkt datetime O Attributter der har VirkningTil < NU

ignoreres. Hvis ingen attributter har


fejlbesked.

tns:Aktoer Tekst M Gemmes ikke.



Attributter:OffentlighedUndtaget O



Kommentar [DGJ24]: Hvi

s der er flere attributsæt (med forskellige virkninger)

skal dokumentet afvises

med en fejl, da KMD Sag

kun understøtter en virk-

ning (Her-og-nu)

KMD: ID52

KMD Sag anvender kun det

sæt der har Virkning NU. KOMBIT: Hvad sker der så

med de sæt der ikke har

virkning NU?

KMD: Instanser der ikke

har virkning NU ignoreres.

Hvis der er flere, der er

gældende NU gemmes den

første forekomst, der har virkning NU og resten igno-

reres.

Kommentar [DGJ25]: Skal afvises med fejl, såfremt

FraTidspunkt er frem i tiden

(KMD Sag understøtter ikke

fremtidige attributsæt)

KMD: ID53

Rettet til kun aktuelle attri-

butter





KMD: fejlkode og fejlbe-

sked returneres som be-

skrevet tidligere.




tiden (Der understøttes kun attributter med virkning her

og nu). Det skal defineres

hvordan virkning til-dato

håndteres i KMD Sag

KMD: ID54

Rettet til kun aktuelle attri-

butter




ning og ikke en fejl). ...

Begrænset

Side 54 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.5.1.1.5 Objektindhold:DistributionJournalPost

Objektind-


M


tns:ID Tekst M UUID for dokument. Gemmes ikke –

hentet tidligere.

tns:EmneFacetForslag KLE M Gemmes ikke – hentet tidligere.

tns:Handling FacetForslag Tekst O

tns:ObjektType Tekst M Gemmes ikke – hentet tidligere.




tns:ReferenceID Tekst M


tns:FraTidsPunkt datetime M Gemmes ikke – hentet tidligere.

tns:Livscykluskode Tekst M

tns:ImportTidspunkt datetime O Gemmes ikke.



Registrering:RelationListe M

Begrænset

Side 55 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

RelationListe:JournalPost M Link: DistributionJournal-

Post:JournalPostDistributionJournalPo

st:JournalPost

3.5.1.1.6 DistributionJournalPost:JournalPost

JournalPost M


JournalPost:Virkning M Gemmes ikke.

tns:FraTidspunkt date-

Time

O

tns:TilTidspunkt date-

Time

O

tns:Aktoer Tekst M

tns:AktoerType Tekst M



Begrænset

Side 56 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

JournalPost:Rolle Tekst M Rollen anvendes til at sikre at doku-

ment lægges på rette sag.

JournalPost:Indeks Tekst M Gemmes ikke.

JournalPost:Dokument Mappes til KMD Sag objekttyper:

”Person” (CPR) -> 02 (Pnr)

”Virksomhed” (CVR) -> 03 (CVR/SE)

”Myndighed” -> 10 (myndighed)

”OrgEnhed” -> 10 (myndighed)

”OrgFunktion” -> 10 (myndighed)

”Interesse-faellesskab” -> 13 (fri)

tns:Objekttype Tekst M Objekttype (Person, Virksomhed, etc.)

anvendes til at sikre at dokument

lægges på rette sag.

Anvendes også til at udfylde Doku-

ment vdr. Type:

”Person” (CPR) -> ”Person”

”Virksomhed” (CVR) -> ”Virksomhed”

”Myndighed” -> ””

”OrgEnhed” -> ””

”OrgFunktion” -> ””

”Interesse-faellesskab” -> ””

”Bruger” -> ””

tns:ReferenceID Tekst M URN med Personnummer, CVR-

nummer, etc.. Informationen anven-

des til at sikre at dokument lægges på

rette sag.


tns:Dokumenttitel Tekst O



O




tns:Titel Tekst O

tns:Notat Tekst M

Begrænset

Side 57 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

3.5.2 Retursvar til Fordelingskomponent/Afsendersystem

Det svar som KMD Sag sender til Fordelingskomponenten efter behandling af det modtagne

dokument er via servicen FordelingskvitteringAfsendResponse.

FordelingskvitteringAfsendResponse M



se:Forretningskvittering

M

tns:ForretningsValiderings-

Kode

Tekst M Håndtering af svaret fra Fordelings-



Forretningskvittering:FejlListe O

FejlListe:Fejl


tns:FejlTekst Tekst O Se afsnit 2.3.2


se:DistributionContext

M

tns:AnvenderTransaktionsID UUID M Modtaget AnvenderTransaktionsID

returneres for at kunne koble request

med response.

tns:DistributionTransaktionsID UUID O Hvis Request indeholder Distribution-

TransaktionsID returneres den i dette

felt.

tns:AfsendendeMyndighed CVR M

tns:RoutingMyndighed CVR M

Begrænset

Side 58 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:



tns:RoutingEmneFacet Tekst M

tns:RoutingHandlingFacet Tekst O

Routing-


Tekst O

DistributionCon-

text:DokumentFilNavn

Tekst O

Begrænset

Side 59 af 59


Forfatter:

CCCCCCCCVS/

HHO


Godkender:

4. Bilag

4.1 Bilag 1 - Mapning af objekttyper

Objekt type

Objekttypenavn URN Placering LokalUdvidelse

02 Personnummer urn:oio:objekttype:Person

Sagspart Dokumentpart

Cpr-nr +Brugervendtnoegle

03 SE/CVR-nummer urn:oio:objekttype:Virksomhed


CVR-nr +Brugervendtnoegle

10 Myndigheds-nummer

urn:oio:objekttype:Myndighed/ urn:oio:objekttype:

Fuldtnavn


CVR-nr/

Fuldtnavn

+Brugervendtnoegle

11 Kommunenum-mer

urn:oio:objekttype:Myndighed/ urn:oio:objekttype:Fuldtnavn

Sagspart (sekundær) Dokumentpart

CVR-nr/ Fuldtnavn +Brugervendtnoegle

12 Nordisk myndig-hed

urn:oio:objekttype:Myndighed/ urn:oio:objekttype:Fuldtnavn

Sagspart (sekundær) Dokumentpart

CVR-nr/ Fuldtnavn +Brugervendtnoegle

13 Fritekst urn:oio:objekttype:

Fuldtnavn

Sagspart

Dokumentpart

Fuldtnavn

+Brugervendtnoegle

14 Ejendomsnum-mer

urn:oio:objekttype:Ejendom

Sagsgenstande Tekstfelt +Brugervendtnoegle

urn:oio:objekttype:Fuldtnavn

Dokumentpart Fuldtnavn +Brugervendtnoegle

15 Produktionsen-hed

urn:oio:objekttype:ProduktionsAfdeling


Pnr +Brugervendtnoegle

99 Intet objekt

Journalnotat og dokument til og fra dokumentfordeler - KMD

Documents

Transcript of Journalnotat og dokument til og fra dokumentfordeler - KMD