Page History
| Table of Contents |
|---|
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.
...
Tilsidst i dokumentet dokumenteres det, hvordan et svar fra FSK Registry ser ud - herunder sammenhæng med Medcoms danske profilering: XDS Metadata for Document Sharing v. 0.95.
Læsevejledning
Dette dokument antager, at læseren er bekendt med basale koncepter indenfor IHE XDS, Dokumentdelingsservicen og CDA Dokumenter.
...
MedComs brug af HL7 standarder
Ordliste
| DDS | Dokumentdelingsservice |
| BRS | Behandlingsrelationsservice |
| FSK | Fælles Stamkort |
| XDS | Cross-Enterprise Document Sharing |
Overblik over løsningen
Fremsøgning af stamkort sker via DDS (se DDS Registry - Querying User's Guide og DDS Registry Querying Interface Description).
...
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.
...
FSK Registry 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 lever op til de krav, der er sat i Medcoms danske profilering af XDS Metadata.
FSK Registry Response Options
ReturnType kan som udgangspunkt antage een af følgende to værdier:
...
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.
...
FSK Registry vil besvare en forespørgsel med ikke-understøttet Query ID med en fejl af typen 'XDSUnknownStoredQuery'.
FSK Registry 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 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 fortolkning (hvis nogen) af den medsendte parameter samt evt. valideringer.
FSK Registry 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. 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).
...
5) The value for this parameter is a pattern compatible with the SQL keyword LIKE which allows the use of the following wildcard characters: % to match any (or no) characters and _ to match a single character.
FSK Registry Response
FSK Registry er sat op med en række miljøspecifikke variable. De forskellige variable gennemgåes og deres anvendelse specificeres. Nogle af disse variable er miljøspecifikke (i disse tilfælde listes parametrene for de forskellige miljøer) mens andre er ens henover de forskellige miljøer (den nuværende konfiguration vises).
...
Gennem et konkret eksempel på svar fra FSK Registry vil vi dokumentere sammenhængen med den danske metadataprofil.
FSK Registry Metadata Opsætningsvariable
Til filtrering af indkommende queries (se afsnit vedr. FSK Registry Query Parameters) samt til generering af de udgående DocumentEntries i responses er FSK Registry konfigureret med følgende opsætningsvariable:
...
- Filtrering af queries
- Generering af DocumentEntries i response.
Eksempel: Request og response fra FSK Registry
Følgende request viser en fremsøgning af dokumenter på CPR nummeret 2110979421 via DDS (SOAP headers er fjernet for at gøre eksemplet mere læsevenligt).
...
| Code Block | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns3:AdhocQueryResponse xmlns="urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0" xmlns:ns2="urn:oasis:names:tc:ebxml-regrep:xsd:rs:3.0" xmlns:ns3="urn:oasis:names:tc:ebxml-regrep:xsd:query:3.0" xmlns:ns4="urn:oasis:names:tc:ebxml-regrep:xsd:cms:3.0" xmlns:ns5="urn:oasis:names:tc:ebxml-regrep:xsd:lcm:3.0" xmlns:ns6="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:ns7="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:ns8="http://www.w3.org/2000/09/xmldsig#" xmlns:ns9="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:ns10="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd" xmlns:ns11="http://www.nsi.dk/hsuid/2016/08/hsuid-1.1.xsd" totalResultCount="1" status="urn:ihe:iti:2007:ResponseStatusType:Success">
<RegistryObjectList>
<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">
<Slot name="creationTime">
<ValueList>
<Value>20190429114407</Value>
</ValueList>
</Slot>
<Slot name="languageCode">
<ValueList>
<Value>da-DK</Value>
</ValueList>
</Slot>
<Slot name="repositoryUniqueId">
<ValueList>
<Value>1.2.208.176.43210.8.20.12</Value>
</ValueList>
</Slot>
<Slot name="sourcePatientId">
<ValueList>
<Value>2110979421^^^&1.2.208.176.1.2&ISO</Value>
</ValueList>
</Slot>
<Name>
<LocalizedString xml:lang="en-US" charset="UTF-8" value="Fælles stamkort"/>
</Name>
<Classification classificationScheme="urn:uuid:93606bcf-9494-43ec-9b4e-a7748d1a838d" classifiedObject="1.2.208.176.43210.8.20.12^80c7deaf-bf77-4abd-a187-61ab8cad111e" nodeRepresentation="" id="urn:uuid:687cf691-aab8-4070-9243-7a38531af42d">
<Slot name="authorInstitution">
<ValueList>
<Value>Sundhedsdatastyrelsen^^^^^&1.2.208.176.1.1&ISO^^^^634491000016008</Value>
</ValueList>
</Slot>
</Classification>
<Classification classificationScheme="urn:uuid:41a5887f-8865-4c09-adf7-e362475b143a" classifiedObject="1.2.208.176.43210.8.20.12^80c7deaf-bf77-4abd-a187-61ab8cad111e" nodeRepresentation="001" id="urn:uuid:573eacd3-b124-4574-8d74-203262246a16">
<Slot name="codingScheme">
<ValueList>
<Value>1.2.208.184.100.9</Value>
</ValueList>
</Slot>
<Name>
<LocalizedString xml:lang="en-US" charset="UTF-8" value="Klinisk rapport"/>
</Name>
</Classification>
<Classification classificationScheme="urn:uuid:a09d5840-386c-46f2-b5ad-9c3699a4309d" classifiedObject="1.2.208.176.43210.8.20.12^80c7deaf-bf77-4abd-a187-61ab8cad111e" nodeRepresentation="DK FSK Schema" id="urn:uuid:6c86ab04-3cb9-4869-bb45-f44bc17b26ee">
<Slot name="codingScheme">
<ValueList>
<Value>urn:ad:dk:medcom:fsk:full</Value>
</ValueList>
</Slot>
<Name>
<LocalizedString xml:lang="en-US" charset="UTF-8" value="DK FSK Schema"/>
</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>
<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>1.2.208.176.1.2
<LocalizedString xml:lang="en-US" charset="UTF-8" value="almen medicin"/>
</Name>
</Classification>
<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: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>
<ExternalIdentifier registryObject="1.2.208.176.43210.8.20.12^80c7deaf-bf77-4abd-a187-61ab8cad111e" identificationScheme="urn:uuid:58a6f841-87b3-4a3e-92fd-a8ffeff98427" value="2110979421^^^&1.2.208.176.1.2&ISO" id="urn:uuid:8963615f-4acd-45dd-9c80-261bd41c3270">
<Name>
<LocalizedString value="XDSDocumentEntry.patientId"/>
</Name>
</ExternalIdentifier>
<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>
</ExtrinsicObject>
</RegistryObjectList>
</ns3:AdhocQueryResponse>
</soap:Body>
</soap:Envelope>
|
Sammenhæng mellem FSK Registry response og den danske metadataprofil
Et response fra FSK Registry består som tidligere beskrevet af en liste af selvindeholdte XDS Document Entries. Indholdet af et sådant response er specificeret i IHE IT Infrastructure Technical Framework Volume 3 IHE ITI TF-3 10 Cross-Transaction Specifications and Content Specifications. Derudover har Medcom udarbejdet Medcoms danske profilering: XDS Metadata for Document Sharing v. 0.95.
...