...

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

Da FSK Registrys Adapter 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 Adapter understøtter
• Hvilke valideringer FSK Registry Adapter laver

Tilsidst i dokumentet dokumenteres det, hvordan et svar fra FSK Registry Adapter ser ud  - herunder sammenhæng med Medcoms danske profilering: XDS Metadata for Document Sharing v. 0.95.

...

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

FSK Registry Adapter understøtter følgende User Story:

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

Nedenstående viser et eksempel, hvor en dokumentanvender (sundhedsfaglig) laver forespørgsel. For andre anvendertyper og brugsscenarier henvises til dokumentationen for Dokumentdelingsservicen.

Således foregår en forespørgsel mod FSK Registry Adapter 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ørglerforespørgsler, 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 Adapter)
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 Adapter) at fortolke og besvare den konkrete query. I næste afsnit findes en detaljeret oversigt over, hvorledes FSK Registry Adapter fortolker indkommende queries.

FSK Registry Adapters fortolkning af forespørgsler

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

...

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

FSK Registry 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 FSK Registry Adapter lever op til de krav, der er sat i Medcoms danske profilering af XDS Metadata.

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

FSK Registry Adapter ignorerer ReturnCompoesedObjects parameteren. Alle queries besvarersbesvares, somom denne parameter er true - dvs vi forventer et response.

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

FSK Registry vil besvare en forespørgsel med ikke-understøttet Query ID med en fejl af typen 'XDSUnknownStoredQuery'.

FSK Registry Adapter Query Parameters

De søgeparametre, der er kan anvendes er defineret udfra Query ID. Dette betyder at hver Query type (se tabellen ovenfor) medfører en liste af tvungne/optionelle søgeparametre. I de følgende afsnit gennemgås FSK Registrys Registry Adapters understøttede Query typer, og for hver af disse angives søgeparametrene, som defineret i  IHE IT Infrastructure Technical Framework Volume 2a (ITI TF-2a) 10 Transactions Part A. En kolonne udfor hver søgeparameter angiver FSK Registrys Registry Adapters fortolkning (hvis nogen) af den medsendte parameter samt evt. valideringer.

FSK Registry Adapter FindDocuments parametre

Som defineret i  IHE IT Infrastructure Technical Framework Volume 2a (ITI TF-2a) 10 Transactions Part A giver Querytypen FindDocuments anledning til en specificeret liste af søgeparametre. Nedenfor er denne tabel gengivet, og FSK Registry understøttelse angivet i kolonnen yderst til højre. Kolonnen "FSK Registry understøttelser viser, om FSK Registry kigger på søgeparametren, og hvad FSK Registry betegner som et match på query (kommer der et svar tilbage eller ej).Adapter understøttelse" beskriver for hver søgeparameter, hvordan FSK Registry Adapter forholder sig til denne: Bliver søgeparameteren anvendt eller ignoreret af FSK Registry Adapter? Og hvis den bliver anvendt af FSK Registry Adapter, hvordan bliver den så anvendt?

...

<Slot name="authorInstitution">
 <ValueList>
  <Value>Sundhedsdatastyrelsen^^^^^&amp;1.2.208.176.1.1&amp;ISO^^^^634491000016008</Value>
 </ValueList>
</Slot>

<ExtrinsicObject mimeType="text/xml" 
                 objectType="urn:uuid:34268e47-fdf5-41a6-ba33-82133c465248" 
                 status="urn:oasis:names:tc:ebxml-regrep:StatusType:Approved" 
                 id="1.2.208.176.43210.8.20.12^80c7deaf-bf77-4abd-a187-61ab8cad111e" 
                 home="1.2.208.176.8.1.12">

<Classification classificationScheme="urn:uuid:f4f85eac-e6cb-4883-b524-f2705394840f" classifiedObject="1.2.208.176.43210.8.20.12^80c7deaf-bf77-4abd-a187-61ab8cad111e" nodeRepresentation="N" id="urn:uuid:7bcba75e-6abe-4e54-b03e-9cbe65f2e780">
 <Slot name="codingScheme">
  <ValueList>
   <Value>2.16.840.1.113883.5.25</Value>
  </ValueList>
 </Slot>
 <Name>
  <LocalizedString xml:lang="en-US" charset="UTF-8" value="normal"/>
 </Name>
</Classification>

<Slot name="creationTime">
 <ValueList>
  <Value>20190429114407</Value>
 </ValueList>
</Slot>

<ExtrinsicObject mimeType="text/xml" 
                 objectType="urn:uuid:34268e47-fdf5-41a6-ba33-82133c465248" 
                 status="urn:oasis:names:tc:ebxml-regrep:StatusType:Approved" 
                 id="1.2.208.176.43210.8.20.12^80c7deaf-bf77-4abd-a187-61ab8cad111e" 
                 home="1.2.208.176.8.1.12">

<Classification classificationScheme="urn:uuid:f0306f51-975f-434e-a61c-c59651d33983" classifiedObject="1.2.208.176.43210.8.20.12^80c7deaf-bf77-4abd-a187-61ab8cad111e" nodeRepresentation="52460-3" id="urn:uuid:66d7b10a-78ef-4e17-a58c-b96ca58a3114">
 <Slot name="codingScheme">
  <ValueList>
   <Value>2.16.840.1.113883.6.1</Value>
  </ValueList>
 </Slot>
 <Name>
  <LocalizedString xml:lang="en-US" charset="UTF-8" value="Patient Information"/>
 </Name>
</Classification>

<Classification classificationScheme="urn:uuid:f33fb8ac-18af-42cc-ae0e-ed0b0bdb91e1" classifiedObject="1.2.208.176.43210.8.20.12^80c7deaf-bf77-4abd-a187-61ab8cad111e" nodeRepresentation="554041000005106" id="urn:uuid:ad3bebde-dfab-4ef0-a679-7b8271bc33c2">
 <Slot name="codingScheme">
  <ValueList>
   <Value>2.16.840.1.113883.6.96</Value>
  </ValueList>
  </Slot>
 <Name>
  <LocalizedString xml:lang="en-US" charset="UTF-8" value="sundhedsforvaltning"/>
 </Name>
</Classification>

<Slot name="languageCode">
 <ValueList>
  <Value>da-DK</Value>
 </ValueList>
</Slot>

<Classification classificationScheme="urn:uuid:cccf5598-8b07-4b77-a05e-ae952c785ead" classifiedObject="1.2.208.176.43210.8.20.12^80c7deaf-bf77-4abd-a187-61ab8cad111e" nodeRepresentation="408443003" id="urn:uuid:37cfb6b2-7279-4230-b954-f088c7e62ffb">
 <Slot name="codingScheme">
  <ValueList>
   <Value>2.16.840.1.113883.6.96</Value>
  </ValueList>
 </Slot>
 <Name>
  <LocalizedString xml:lang="en-US" charset="UTF-8" value="almen medicin"/>
 </Name>
</Classification

<Slot name="repositoryUniqueId">
 <ValueList>
  <Value>1.2.208.176.43210.8.20.12</Value>
 </ValueList>
</Slot>

<Slot name="sourcePatientId">
 <ValueList>
  <Value>2110979421^^^&amp;1.2.208.176.1.2&amp;ISO</Value>
 </ValueList>
</Slot>

<Name>
 <LocalizedString xml:lang="en-US" charset="UTF-8" value="Fælles stamkort"/>
</Name>

<Classification classificationScheme="urn:uuid:f0306f51-975f-434e-a61c-c59651d33983" classifiedObject="1.2.208.176.43210.8.20.12^80c7deaf-bf77-4abd-a187-61ab8cad111e" nodeRepresentation="52460-3" id="urn:uuid:66d7b10a-78ef-4e17-a58c-b96ca58a3114">
 <Slot name="codingScheme">
  <ValueList>
   <Value>2.16.840.1.113883.6.1</Value>
  </ValueList>
 </Slot>
 <Name>
  <LocalizedString xml:lang="en-US" charset="UTF-8" value="Patient Information"/>
 </Name>
</Classification>

<ExternalIdentifier registryObject="1.2.208.176.43210.8.20.12^80c7deaf-bf77-4abd-a187-61ab8cad111e" identificationScheme="urn:uuid:2e82c1f6-a085-4c72-9da3-8640a32e42ab" value="1.2.208.176.43210.8.20.12^80c7deaf-bf77-4abd-a187-61ab8cad111e" id="urn:uuid:85402c9d-7cf7-4b25-bd36-3b72fa132b89">
 <Name>
  <LocalizedString value="XDSDocumentEntry.uniqueId"/>
 </Name>
</ExternalIdentifier>

...