Introduktion

Formål

Formålet med dette dokument er at beskrive de brugerhistorier (user stories) der understøttes af DDS.

Brugerhistorier er overordnede beskrivelser af funktionalitet og mål set fra brugeren/anvenderens synsvinkel. Brugerhistorierne er ikke beskrevet udfra en teknisk synsvinkel med udfra en forretningsmæssig brug af DDS.

For en teknisk gennemgang af de i dette dokument skitserede brugerhistorier henvises til DDS - Guide til anvendere

Den første del af dokumentet beskriver de forskellige brugertyper/aktører af DDS.

Derefter listes de enkelte brugerhistorier med en overblikstegning, der viser, hvilke aktører, der optræder i de enkelte brugerhistorier.

DDS Servicen har en Registry-snitflade (Søgning efter dokumenter) og en Repository-snitflade (Hentning af dokumenter). Hver brugerhistorie dækker et samlet flow bestående af både et kald til Registry og bagefter et kald til Repository, da det er sådan DDS servicen anvendes i praksis.

Hver brugerhistorie gennemgås derefter - herunder en gennemgang af acceptkriterier. Der gives eksempler på konkrete instanser af brugerhistorien i form af scenarier.

Læsevejledning

Læseren af dette dokument kan være forretningskonsulenter og/eller arkitekter fra NSP anvenderorganisationer, der ønsker at vide, hvordan DDS kan anvendes til at opfylde forretningsmæssige behov.

Læseren forventes at være bekendt med dokumentdeling som koncept - herunder IHE XDS.

Brugertyper i DDS

I DDS arbejdes der med følgende brugertyper:

• Borger: En borger der forespørger på egne data
• Borger på vegne af: En borger der forespørger data på en anden borger, som denne har en relation til (forældremyndighedshaver/fuldmagtshaver). (Værge relation er blevet udfaset sommer 2024)
• Sundhedsfaglig: Kendetegnet ved at være i besiddelse af en autorisation. 
• Sundhedsfaglig på vegne af: Kendetegnet ved at  være en person på vegne af en anden person, som er i besiddelse af en autorisation.
• Ikke autoriseret bruger: Kendetegnet ved ikke at være i besiddelse af en autorisation. I stedet kan de have angivet en national rolle der kan være en af følgende: ingen rolle, national rolle 'lægesekretær' eller national rolle 'sundhedsassistent'

Forretningsregler

Gerne med link til lovgivning eller relevant rfc (Se forældre på Diagnoser)

Overblik over brugerhistorier

I den følgende tegning vises et overblik over de enkelte brugerhistorier, og hvorledes disse relaterer sig til hinanden og til de ovenfor beskrevne brugertyper:

Brugerhistorier

I det følgende gennemgåes brugerhistorierne enkeltvis. Hver brugerhistorie beskrives med de acceptkriterier der hører til, og som skal være opfyldt for en succesfuld gennemførelse af brugerhistorien.

Hvor det er relevant gives konkrete eksempler på brugerhistorien i form af scenariebeskrivelse.

 Borger forspørgsler

Forespørgsel på egne dokumenter

For en succesfuld gennemførelse af brugerhistorien skal følgende acceptkriterier være opfyldt:

1. Brugeren autentificerer sig med en gyldig sikkerheds billet
2. Får en liste tilbage fra DDS Registry med dokumentreferencer på dokumenter, der tilhører borgeren og matcher søgekriterierne anvendt
3. Får de dokumenter tilbage fra DDS Repository der matcher dokumentreferencerne fra DDS Repository
4. Kald til DDS Registry og DDS Repository resulterer hver i en loglinje i MinLog

Forespørgsel på anden borgers dokumenter

For en succesfuld gennemførelse af brugerhistorien skal følgende acceptkriterier være opfyldt:

1. Brugeren autentificerer sig med en gyldig sikkerheds billet
2. Får følgende fejlbesked tilbage ved kald til DDS Registry: "Der opstod en fejl med følgende beskrivelse (Der kunne ikke findes en relation mellem borgerne via PersonInformation)"
3. Der foretages ikke kald til DDS Repository
4. Der oprettes ikke loglinjer i MinLog

Forespørgsel på anden borgers dokumenter, hvor der er en relation

For en succesfuld gennemførelse af brugerhistorien skal følgende acceptkriterier være opfyldt:

1. Brugeren autentificerer sig med en gyldig sikkerheds billet
2. Brugeren anvender gyldig typecode og formatcode jf vedkommens fuldmagtadgang *
3. Får en liste tilbage fra DDS Registry med dokumentreferencer på dokumenter, der tilhører borgeren der ageres på vegne af og matcher søgekriterierne anvendt
4. Får de dokumenter tilbage fra DDS Repository der matcher dokumentreferencerne fra DDS Registry
5. Kald til DDS Registry og DDS Repository resulterer hver i en loglinje i MinLog

*) Se også anvender guide for disse regler

Ikke-autoriseret bruger

Forespørgsel uden nationale roller

For en succesfuld gennemførelse af brugerhistorien skal følgende acceptkriterier være opfyldt:

1. Brugeren autentificerer sig med en gyldig sikkerhedsbillet
2. Får følgende fejlbesked tilbage ved kald til DDS Registry: "urn:dk:nsi:Unauthorized Role"
3. Der foretages ikke kald til DDS Repository
4. Kaldet til DDS Registry resulterer i en loglinje i MinLog

Forespørgsel med national rolle

For en succesfuld gennemførelse af brugerhistorien skal følgende acceptkriterier være opfyldt:

1. Brugeren autentificerer sig med en gyldigt sikkerhedsbillet
2. Får en liste tilbage med dokumentreferencer på dokumenter der tilhører borgeren og matcher søgekriterier og frabedelser fra DDS Registry
3. Får de dokumenter tilbage der tilhører borgeren fra DDS Repository
4. Kald til DDS Registry og DDS Repository resulterer hver i en loglinje i MinLog

Sundhedsfaglig bruger

Forespørgsel uden værdispring

For en succesfuld gennemførelse af brugerhistorien skal følgende acceptkriterier være opfyldt:

1. Brugeren autentificerer sig med en gyldigt sikkerhedsbillet
2. Får en liste tilbage fra DDS Registry med dokumentreferencer på dokumenter, der tilhører borgeren og matcher anvendte søgekriterier og eventuelle frabedelser.
3. Får de dokumenter tilbage fra DDS Repository der matcher dokumentreferencerne fra DDS Registry
4. Kald til DDS Registry og DDS Repository resulterer hver i en loglinje i MinLog

Forespørgsel med værdispring

For en succesfuld gennemførelse af brugerhistorien skal følgende acceptkriterier være opfyldt:

1. Brugeren autentificerer sig med en gyldigt sikkerhedsbillet
2. Værdispring er aktiveret
3. Får en liste tilbage fra DDS Registry med dokumentreferencer på dokumenter, der tilhører borgeren og matcher anvendte søgekriterier uanset frabedelser.
4. Får de dokumenter tilbage fra DDS Repository der matcher dokumentreferencerne fra DDS Registry
5. Kald til DDS Registry og DDS Repository resulterer hver i en loglinje i MinLog

Sundhedsfaglig bruger på vegne af

Forespørgsel uden værdispring

For en succesfuld gennemførelse af brugerhistorien skal følgende acceptkriterier være opfyldt:

1. Brugeren autentificerer sig med en gyldigt sikkerhedsbillet
2. Får en liste tilbage fra DDS Registry med dokumentreferencer på dokumenter, der tilhører borgeren og matcher anvendte søgekriterier og eventuelle frabedelser.
3. Får de dokumenter tilbage fra DDS Repository der matcher dokumentreferencerne fra DDS Registry
4. Kald til DDS Registry og DDS Repository resulterer hver i en loglinje i MinLog

Forespørgsel med værdispring

For en succesfuld gennemførelse af brugerhistorien skal følgende acceptkriterier være opfyldt:

1. Brugeren autentificerer sig med en gyldigt sikkerhedsbillet
2. Værdispring er aktiveret
3. Får en liste tilbage fra DDS Registry med dokumentreferencer på dokumenter, der tilhører borgeren og matcher anvendte søgekriterier uanset frabedelser.
4. Får de dokumenter tilbage fra DDS Repository der matcher dokumentreferencerne fra DDS Registry
5. Kald til DDS Registry og DDS Repository resulterer hver i en loglinje i MinLog

Registreringer i MinLog i forbindelse med hent og registrering af dokumenter