Indledning

Dette dokument er en vejledning til brug for anvendere af FSK Registry. Da anvendelsen af FSK Registry sker via Dokumentdelingsservicen, starter dokumentet med et overblik over arkitekturen. Formålet med dette er at dokumentere, hvordan DDS og FSK Registry hænger sammen, og hvilke opgaver disse komponenter dækker hver især.

Da FSK Registrys primære opgave er at fortolke forespørgsler fra dokumentanvendere og levere konkrete svar på disse, indeholder dette dokument beskrivelser af:

• Hvilke søgeparametre, FSK Registry understøtter
• Hvilke valideringer FSK Registry laver
• Hvordan et svar fra FSK Registry ser ud (herunder sammenhæng med Medcoms danske profilering: XDS Metadata for Document Sharing v. 0.95

Disse beskrivelser er bygget op med eksempler på requests og responses. Eksemplerne stammer fra TEST1 miljøet.

Ordliste

Overblik over løsningen

Fremsøgning af stamkort sker via DDS (se DDS Registry - Querying User's Guide og DDS Registry Querying Interface Description).

FSK Registry er således en kilde, som DDS anvender til at understøtte fremsøgingsforespørgsler fra anvendere. 

Således foregår en forespørgsel mod FSK Registry 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 FSK Registry)
5. Der foretages evt. en filtrering af resultaterne, hvis der for patienten findes dataspecifikke spærringer
6. DDS logger dataadgang til MinLog

DDS Registry forholder sig ikke til indholdet af den konkrete query, der kommer fra Dokumentanvenderen, men overlader til de bagvedliggende registre (herunder FSK Registry) at fortolke og besvare den konkrete query. I næste afsnit findes en detaljeret oversigt over, hvorledes FSK Registry fortolker indkommende queries.

FSK Registry fortolkning af forespørgsler

FSK Registry 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 FSK Registry. Gennemgangen vil indeholde eksempler på queries, hvor dette giver mening.

FSK Registry melder tilbage til DDS med et response af  ...TODO.

FSK Registry 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.

FSK Registry ignorerer ReturnCompoesedObjects parameteren. Alle queries besvarers, somom denne parameter er true.

FSK Registry 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).

FSK Registry 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 FSK Registry forstår/understøtter den specifikke Query.