1. Introduktion
1.1. Formål
Formålet med dette dokument er at beskrive de brugerhistorier (user stories) der understøttes af NXRG.
Brugerhistorier er overordnede beskrivelser af funktionalitet og mål set fra brugeren/anvenderens synsvinkel. Brugerhistorierne er ikke beskrevet udfra en teknisk synsvinkel, men udfra en forretningsmæssig brug af NXRG.
For en teknisk gennemgang af de i dette dokument skitserede brugerhistorier henvises til NXRG - Guide til Anvendere.
Den første del af dokumentet beskriver de forskellige brugertyper/aktører af NXRG.
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.
1.2. Læsevejledning
Læseren af dette dokument kan være forretningskonsulenter og/eller arkitekter fra NSP anvenderorganisationer, der ønsker at vide, hvordan NXRG kan anvendes til at opfylde forretningsmæssige behov.
Læseren forventes at være bekendt med dokumentdeling som koncept - herunder IHE XDS. Der henvises til NXRG - Design- og arkitekturbeskrivelse for detaljer vedr. NXRGs design og konkrete understøttelse af IHE XDS profilerne.
2. Brugertyper i NXRG
I DROS arbejdes der med følgende brugertyper:
- Dokumentkilde og on-demand dokumentkilde: Ejeren af et (on-demand) dokument og tilhørende metadata. Kan være et system eller en person.
- Dokumentrepository: Et (XDS) dokument repository, der anvender NXRG som index (XDS Registry). Kan være et system eller en person.
- Dokumentanvender: Aftagere af information i dokumenter og metadata på NSP. Kan være et system eller en person.
3. 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:
4. 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.
4.1. Brugerhistorier søgning (iti-18)
4.1.1. Brugerhistorie: Find Dokumenter
Som en dokumentanvender ønsker jeg at lave en fremsøgning af dokumenter vha QueryTypen FindDocuments for en patient så jeg kan få et overblik over, hvilke DocumentEntries der findes på den pågældende patient |
Acceptkriterier:
- Den anvendte query indeholder lovlige fremsøgningsparametre
4.1.2. Brugerhistorie: Find Dokumenter med referenceIdList
Som en dokumentanvender ønsker jeg at lave en fremsøgning af dokumenter vha QueryTypen FindDocumentsByReferenceId for en patient så jeg kan få et overblik over, hvilke DocumentEntries der findes på den pågældende patient |
For en succesfuld gennemførelse af brugerhistorien skal følgende acceptkriterier være opfyldt: Se acceptkriterier i Find Dokumenter.
4.1.3. Brugerhistorie: Find Dokumenter med getDocuments
Som en dokumentanvender ønsker jeg at lave en fremsøgning af dokumenter vha QueryTypen GetDocuments for et specifik dokument så jeg kan se hvordan det er registreret |
For en succesfuld gennemførelse af brugerhistorien skal følgende acceptkriterier være opfyldt: Se acceptkriterier i Find Dokumenter.
4.2. Brugerhistorier registrering af stable dokument (Iti-42)
4.2.1. Brugerhistorie: Registrer Dokumentsæt
Som et dokumentrepository ønsker jeg at registrere et sæt af stable DocumentEntries så jeg kan stille oplysningerne i dokumenter og tilhørende metadata til rådighed for dokumentanvendere |
Acceptkriterier:
- Dokumentrepository modtager en succesmeddelse
- Dokumentsættet (Documententries, Submissionset og Associations) er lagret i databasen og kan fremsøges efterfølgende.
4.2.2. Brugerhistorie: Registrer Dokumentsæt med DocumentEntry som rettelse til eksisterende
Som et dokumentrepository ønsker jeg at registrere en stable DocumentEntry som rettelse (replace) af en eksisterende DocumentEntry så jeg kan stille oplysningerne i dokumenter og tilhørende metadata til rådighed for dokumentanvendere |
For en succesfuld gennemførelse af brugerhistorien skal følgende acceptkriterier være opfyldt: Se acceptkriterier i Registrer DokumentSæt.
4.2.3. Brugerhistorie: Registrer Dokumentsæt med ReferenceIdList
Som et dokumentrepository ønsker jeg at registrere et sæt af stable DocumentEntries med ReferenceIdLists så jeg kan stille oplysningerne i dokumenter og tilhørende metadata til rådighed for dokumentanvendere |
For en succesfuld gennemførelse af brugerhistorien skal følgende acceptkriterier være opfyldt: Se acceptkriterier i Registrer DokumentSæt.
4.3. Brugerhistorier opdatering af dokument info (iti-57)
4.3.1. Brugerhistorie: Slettemarker DocumentEntry
Som en (on-demand) dokumentkilde eller dokumentrepository (stable) ønsker jeg at slettemarkere (deprecate) en DocumentEntry så jeg kan forhindre fremsøgning af ukorrekte oplysninger |
For en succesfuld gennemførelse af brugerhistorien skal følgende acceptkriterier være opfyldt:
- Den udpegede DocumentEntry eksisterer og har status "Approved"
4.3.2. Brugerhistorie: Opdater DocumentEntry metadata
Som en dokumentrepository (stable) ønsker jeg at opdatere en registreret DocumentEntry så jeg kan opdatere ukorrekte metadata for et registreret dokument |
For en succesfuld gennemførelse af brugerhistorien skal følgende acceptkriterier være opfyldt:
- Den udpegede DocumentEntry eksisterer og har status "Approved"
(Historien gælder kun for stable dokumenter. Den kan ikke udføres for OnDemand dokumenter. Se iøvrigt arkitektur dokumentet)
4.4. Brugerhistorier registrering af on-demand dokument (Iti-61)
4.4.1. Brugerhistorie: Registrer On-demand Dokument
Som et dokumentrepository ønsker jeg at registrere et sæt af on-demand DocumentEntries så jeg kan stille oplysningerne i dokumenter og tilhørende metadata til rådighed for dokumentanvendere |
Acceptkriterier:
- Dokumentrepository modtager en succesmeddelse
- Dokumentsættet (Documententries, Submissionset og Associations) er lagret i databasen og kan fremsøges efterfølgende.
4.4.2. Brugerhistorie: Registrer On-demand Dokument med DocumentEntry som rettelse til eksisterende
Som et dokumentrepository ønsker jeg at registrere en on-demand DocumentEntry som rettelse (replace) af en eksisterende DocumentEntry så jeg kan stille oplysningerne i dokumenter og tilhørende metadata til rådighed for dokumentanvendere |
For en succesfuld gennemførelse af brugerhistorien skal følgende acceptkriterier være opfyldt: Se acceptkriterier i Registrer On-demand Dokument.
(Historien adskiller sig fra "Brugerhistorie: Registrer Dokumentsæt med DocumentEntry som rettelse til eksisterende (Iti-42)" ved at det eksisterende ikke får status deprecated. Se iøvrigt arkitektur dokumentet)
4.4.3. Brugerhistorie: Registrer On-demand Dokument med ReferenceIdList
Som et dokumentrepository ønsker jeg at registrere et sæt af on-demand DocumentEntries med ReferenceIdLists så jeg kan stille oplysningerne i dokumenter og tilhørende metadata til rådighed for dokumentanvendere |
For en succesfuld gennemførelse af brugerhistorien skal følgende acceptkriterier være opfyldt: Se acceptkriterier i Registrer On-demand DokumentSæt.