...

• Hvilke søgeparametre, AO XDS Adapter understøtter

Derudover opbygger AO XDS Adapters aftaledokumenter. Dette dokument indeholder dokumentation af, hvorledes disse aftaledokumenter ser ud, og hvorledes dokumentanvendere får adgang til disse.

Herefter dokumenteres det, hvordan et svar på en søgning mod AO XDS Adapter ser ud  - herunder sammenhæng aftale dokumenternes indhold og med Medcoms danske profilering: XDS Metadata for Document Sharing v. 0.95.

Derudover opbygger AO XDS Adapters aftaledokumenter. Dette dokument indeholder dokumentation af:

• Hvordan de genererede aftaledokumenter ser ud
• Hvordan dokumentanvendere får adgang aftaledokumenterne

Læsevejledning

Dette dokument antager, at læseren er bekendt med basale koncepter indenfor IHE XDS, Dokumentdelingsservicen og CDA Dokumenter.

...

AO XDS Adapter er således en kilde, som DDS anvender til at understøtte fremsøgingsforespørgsler fra anvendere. Den er installeret i to kørende udgaver: Een til Region Nord Bookplan og een til Region Midt Bookplan.

Således foregår en forespørgsel mod AO XDS Adapters på følgende måde:

1. Dokumentanvender laver en forespørgsel med DDS Registry for at fremsøge dokumenter for patient
2. DDS Registry konsulterer MinSpærring for at afvise forespørgler, hvor der er spærringer (mod dokumentanvenderen)
3. Tjek af behandlingsrelation (evt. opfølgning)
4. Videredelegering af søgning til bagvedliggende registries (herunder både AO XDS Adapter RN og AO XDS Adapter RM)
5. Der foretages evt. en filtrering af resultaterne, hvis der for patienten findes dataspecifikke spærringer
6. DDS logger dataadgang til MinLog

...

I illustrationen ovenfor vises afhentning fra AO XDS Adapter RN. Afhentning fra AO XDS Adapter RM foregår på samme vis. En afhentning af et eller flere dokumenter forløber på følgende måde:

1. Dokumentanvenderen laver en forespørgsel mod DDS Repository med en række dokumentid'er
2. DDS Repository videredelegerer dokumentforespørgslen mod bagvedliggende XDS Repository (her AO XDS Adapter RN)
3. AO XDA Adapter RN fremfinder dokumentet matchende det forespurgte id i sin database og returnerer dette
4. DDS Repository logger dataadgang i MinLog

Som beskrevet i user story AO-SOEG-1, så genererer AO XDS Adapter det konkrete dokumentindhold ved hver søgning, som en anvender foretager. De genererede dokumenter opbevares (midlertidigt) i en lokal database. Dokumentanvendere kan ikke antage at genererede aftaledokumenter overlever i denne database i længere end få timer, så enhver afhentning skal ske på baggrund af en søgning.

AO XDS Adapters fortolkning af forespørgsler i forbindelse med søgning (AO-SOEG-1)

AO XDS Adapter implementerer transaktionen Registry Stored Query (ITI-18), som er beskrevet i IHE IT Infrastructure Technical Framework Volume 2a (ITI TF-2a) 10 Transactions Part A. 

ITI-18 query beskeder følger  ebXML Registry Information Mode Version (RIM) 3.0. Overordnet set findes der i en ITI-18 query 3 typer af parametre:

1. Response Options: Mulighed for at angive to parametre, der definerer, hvilken type svar vi forventer
   1. ReturnComposedObjects: En boolsk værdi, der angiver, hvorvidt vi forventer et svar (default: true) 
   2. ReturnType: Definerer hvilken type af svar vi forventer
2. QueryID (UUID): Definerer hvilken type af forespørgsel, vi laver
3. Query Parameters: Hver type af query (defineret ved QueryID) giver anledning til en række required/optionelle søgeparametre

I det følgende afsnit vil vi gennemgå hver af disse 3 parameter-typer og angive, hvordan disse er understøttede/fortolkede i AO XDS Adapter. Gennemgangen vil indeholde eksempler på queries, hvor dette giver mening.

AO XDS Adapter melder tilbage til DDS med et response af DocumentEntries. Det dokumenteres, hvorledes en sådan DocumentEntry ser ud, og i hvor høj grad AO XDS Adapter lever op til de krav, der er sat i Medcoms danske profilering af XDS Metadata.

AO XDS Adapter Response Options

ReturnType kan som udgangspunkt antage een af følgende to værdier:

1. LeafClass: Denne type returnerer en liste af XML elementer bestående af fuldt specificerede ebXML objekter, der matcher den modtagne query. Resultatlisten af objekter (ExtrinsicObject/XDSDocumentEntry) er helt selvindeholdt: Slots, external identifiers, classifications etc. Dvs alt, hvad der vides om de konkrete objekter returneres.
2. ObjectRef: Denne type returnerer en liste af UUIDer som refererer objekter i et XDS Registry, der matcher den modtagne query.

AO XDS Adapter ignorerer ReturnCompoesedObjects parameteren. Alle queries besvarers, somom denne parameter er true.

AO XDS Adapter ignorerer return type parameteren. Alle queries besvares, somom denne parameter er sat til LeafClass dvs. fuldt sæt af metadata.

DDS bruger de returnerede metadata til evt. at foretage filtrering i forhold til dataspecifikke spærringer. For at dette kan lade sig gøre, har DDS brug for adgang

...

til det fulde sæt af metadata (LeafClass) og ikke kun objekt-ider (ObjectRef).

AO XDS Adapter QueryID (UUID)

I IHE IT Infrastructure Technical Framework opereres med en række standard XDS Query identificeret med UUID'er. Nedenstående tabel viser den samlede oversigt over de definerede Query ID.

Kolonnen længst til højre viser, om AO XDS Adapter forstår/understøtter den specifikke Query.

AO XDS Adapter vil besvare en forespørgsel med ikke-understøttet Query ID med en fejl af typen 'XDSUnknownStoredQuery'.