Introduktion
Formål
Formålet med dette dokument er at beskrive de brugerhistorier (user stories) der understøttes af SDM.
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 SDM.
For en teknisk gennemgang af de i dette dokument skitserede brugerhistorier henvises til
Den første del af dokumentet beskriver de forskellige brugertyper/aktører af SDM.
Derefter listes de enkelte brugerhistorier med en overblikstegning, der viser, hvilke aktører, der optræder i de enkelte brugerhistorier.
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 MinSpærring kan anvendes til at opfylde forretningsmæssige behov.
Læseren forventes at være bekendt med spærring og samtykke som koncept.
I SDM udstiller følgende registre:
| Register | Forkortelse |
|---|---|
| Stamdata kopiregister service | SKRS |
| Stamdata fleropslagsregister service | SRFS |
| Enkeltopslag af stamdata i autorisationsregisteret | SAES |
| Enkeltopslag af stamdata i CPR registeret | SCES |
| Enkeltopslag af stamdaa i Yder registeret | SYES |
| Personinformation |
I det følgende henvises udelukkende til forkortelsen.
Brugertyper i SDM
| Brugertype | Security-api context |
|---|---|
| Sundhedsfaglig | ActingUser er udfyldt og har typen "HealthcareProfessional" Den sundhedsfaglige må ikke tilgå servicen på vegne af en anden bruger (PrincipalUser skal være tom). |
| Borger | ActingUser er udfyldt og har typen "Citizen" Borgeren må ikke tilgå servicen på vegne af en anden borger (fuldmagt). Dvs PrincipalUser skal være tom. Audience fra sikkerhedsbilletten skal kunne verificeres |
| Systembruger | Contexten indeholder både en ActingUser og Organisation. |
Overblik over brugerhistorier
| Register | WSDL | Antal operationer | Beskrivelse |
|---|---|---|---|
| SAES | http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-authorization-lookup-ws/service/AuthorizationService?wsdl http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-authorization-lookup-ws/service/AuthorizationCodeService?wsdl | Opslag på basis af cpr nummer Opslag på basis af autorisationsnummer Opslag på basis af cpr nummer i udvidet snitflade Opslag på basis af autorisationsnummer i udvidet snitflade | |
| SKRS | http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-batch-copy-ws/service/StamdataReplication?wsdl | Kopi register service | |
| SRFS | http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-batch-copy-ws-rfs/service/StamdataReplication?wsdl | Fleropslags register service | |
| SCES *1 | http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-cpr-ws/service/DetGodeCPROpslag-1.0.3?wsdl http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-cpr-ws/service/DetGodeCPROpslag-1.0.4?wsdl http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-cpr-ws/service/DetGodeCPROpslag-1.0.4.1?wsdl http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-cpr-ws/service/DetGodeCPROpslag-1.0.4a?wsdl http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-cpr-ws/service/DetGodeCPROpslag-1.0.4.1a?wsdl http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-cpr-ws/service/StamdataPersonLookup-1.0.1?wsdl http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-cpr-ws/service/StamdataPersonLookup-1.1.0?wsdl http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-cpr-ws/service/StamdataPersonLookup-1.2.0?wsdl | Understøtter grænsegængere inkluder udvidet familie relationer inkluder udvidet familie relationer + forbedret fejlhåndtering inkluder mulighed for at få historisk addresser inkluder mulighed for at få historisk addresser + forbedret fejlhåndtering Søgning i CPR registret kan hente hemmelige addresser kan fremsøge cpr-numre ud fra navn/fødselsdato | |
| SYES | http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-yder-lookup-ws/service/YderService?wsdl | Opslag på basis af yder nummer | |
| Personinformation | http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-personinformation | PersonInformation REST service. Der er ingen sikkerhed på denne snitflade, da den kun benyttes internt. |
Brugerhistorier
SAES - Enkelt opslag af stamdata i autorisationsregistret
| SAES | Operation | Beskrivelse |
|---|---|---|
http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-authorization-lookup-ws/service/AuthorizationService?wsdl | Authorization | Som en systembruger ønsker jeg at fremsøge autorisations- og uddannelseskode for en sundhedsfaglig person (ud fra cpr nr). så jeg kan få adgang til autorisations- og uddannelseskoden for personen - og personens navn. |
| Authorization | Som en systembruger ønsker jeg at fremsøge autorisations- og uddannelseskode for en sundhedsfaglig person der ikke findes (ud fra cpr nr). så jeg kan se at der ikke bliver returneret nogen data. |
For en succesfuld gennemførelse af brugerhistorien skal følgende acceptkriterier være opfyldt:
- Dokumentkilden autentificerer sig med et gyldigt SOSI id kort på min niveau 3
| SAES | Operation | Beskrivelse |
|---|---|---|
| http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-authorization-lookup-ws/service/AuthorizationCodeService?wsdl | Authorization | Som en systembruger ønsker jeg at fremsøge autorisations- og uddannelseskode for en sundhedsfaglig person (ud fra autorisationskode). så jeg kan få adgang til autorisations- og uddannelseskoden for personen - og personens navn. |
| Authorization | Som en systembruger ønsker jeg at fremsøge autorisations- og uddannelseskode for en sundhedsfaglig person der ikke findes (ud fra autorisationskode). så jeg kan se at der ikke bliver returneret nogen data. |
For en succesfuld gennemførelse af brugerhistorien skal følgende acceptkriterier være opfyldt:
- Dokumentkilden autentificerer sig med et gyldigt SOSI id kort på min niveau 3
SKRS - Stamdata kopiregister service
| SKRS | Operation | Beskrivelse |
|---|---|---|
http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-batch-copy-ws/service/StamdataReplication?wsdl | replicate | Som en systembruger ønsker jeg at fremsøge en person fra SKRS hvor register = 'CPR', datatype = 'person' , version = 2, registerversionsnummer = 1, MaxRowCount = 1 så jeg kan få adgang til information om personen via SKRS. |
SRFS - Stamdata fleropslagsregisterservice
| SRFS | Operation | Beskrivelse |
|---|---|---|
| http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-batch-copy-ws-rfs/service/StamdataReplication?wsdl | replicate | Som en systembruger ønsker jeg at fremsøge en person fra SKRS hvor register = 'CPR', datatype = 'person' , version = 2, registerversionsnummer = 1, IdList = <ID> så jeg kan få adgang til information om personen via SKRS. |
SCES - Enkelt opslag i stamdata for CPR registret
| SCES (Understøtter grænsegængere) | Operation | Beskrivelse |
|---|---|---|
| http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-cpr-ws/service/DetGodeCPROpslag-1.0.3?wsdl | getPersonInformation | Som en systembruger ønsker jeg at fremsøge en person med cpr nr så jeg kan få adgang til information om personen. |
| getPersonWithHealthCareInformation |
| SCES (inkluder udvidet familie relationer) | Operation | Beskrivelse |
|---|---|---|
| http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-cpr-ws/service/DetGodeCPROpslag-1.0.4?wsdl | getPersonInformation | Som en systembruger ønsker jeg at fremsøge en person med cpr nr så jeg kan få adgang til information om personen. |
| getPersonWithHealthCareInformation |
| SCES (inkluder udvidet familie relationer + forbedret fejlhåndtering) | Operation | Beskrivelse |
|---|---|---|
| http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-cpr-ws/service/DetGodeCPROpslag-1.0.4.1?wsdl | getPersonInformation | Som en systembruger ønsker jeg at fremsøge en person med cpr nr så jeg kan få adgang til information om personen. |
| getPersonWithHealthCareInformation |
| SCES (inkluder mulighed for at få historisk addresser) | Operation | Beskrivelse |
|---|---|---|
| http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-cpr-ws/service/DetGodeCPROpslag-1.0.4a?wsdl | getPersonInformation | Som en systembruger ønsker jeg at fremsøge en person med cpr nr så jeg kan få adgang til information om personen. |
| getPersonInformationWithHistoric | ||
| getPersonWithHealthCareInformation | ||
| getPersonWithHealthCareInformationAndHistoric |
| SCES (inkluder mulighed for at få historisk addresser + forbedret fejlhåndtering) *1 | Operation | Beskrivelse |
|---|---|---|
| http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-cpr-ws/service/DetGodeCPROpslag-1.0.4.1a?wsdl | getPersonInformation | Som en systembruger ønsker jeg at fremsøge en person med cpr nr så jeg kan få adgang til information om personen. |
| getPersonInformationWithHistoric | ||
| getPersonWithHealthCareInformation | ||
| getPersonWithHealthCareInformationAndHistoric |
| SCES | Operation | Beskrivelse |
|---|---|---|
| http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-cpr-ws/service/StamdataPersonLookup-1.0.1?wsdl | getPersonDetails | Som en systembruger ønsker jeg at fremsøge en person med fødselsdato så jeg kan få adgang til information om personen. |
| SCES | Operation | Beskrivelse |
|---|---|---|
| http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-cpr-ws/service/StamdataPersonLookup-1.1.0?wsdl | getPersonDetails | Som en systembruger ønsker jeg at fremsøge en person med fødselsdato så jeg kan få adgang til information om personen. |
| getPersonDetailsWithConsent |
| SCES *1 | Operation | Beskrivelse |
|---|---|---|
| http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-cpr-ws/service/StamdataPersonLookup-1.2.0?wsdl | getPersonDetails | Som en systembruger ønsker jeg at fremsøge en person med fødselsdato så jeg kan få adgang til information om personen. |
| getPersonDetailsWithConsent | ||
| searchPersonDetails |
SYES - Enkelt opslag i stamdata for Yderregistret
| SYES | Operation | Beskrivelse |
|---|---|---|
| http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-yder-lookup-ws/service/YderService?wsdl | Yder | Som en systembruger ønsker jeg at fremsøge en yder så jeg kan få adgang til information om yderen. |
Personinformation - Enkelt opslag på CPR nummer.
| Personinformation | REST endpoint | Beskrivelse |
|---|---|---|
| http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-personinformation | v1/person/{cpr} | Som en systembruger ønsker jeg at fremsøge en person med cpr så jeg kan få adgang til information om personen. |
| v1/person/{cpr}/status | Som en systembruger ønsker jeg at fremsøge status for en person med cpr så jeg kan få adgang til status for personen. | |
| v1/person/{cpr}/age | Som en systembruger ønsker jeg at fremsøge alder for en person med cpr så jeg kan få adgang til alderen for en personen. | |
| v1/person/{cpr}/birthday | Som en systembruger ønsker jeg at fremsøge fødselsdag for en person med cpr så jeg kan få adgang til fødselsdagen for en personen. | |
| v1/person/{cpr}/custody | Som en systembruger ønsker jeg at fremsøge værge og forældremåll for en person med cpr så jeg kan få adgang til værge og forældremål for en personen. | |
| v1/person/{cpr}/name | Som en systembruger ønsker jeg at fremsøge navn for en person med cpr så jeg kan få adgang til navnet for en personen. |
*1) for DetGodeCPROpslag-1.0.4a og StamdataPersonLookup-1.2.0 skal wsdl filerne med dgws/idws detaljer findes på specielle endpoints. Disse fremgår af guide til anvender dokumentet.