Versions Compared

Old Version 41

changes.mady.by.user Henrik Danielsen

Saved on

compared with

New Version Current

changes.mady.by.user Kristian Dorland

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

MedComs brug af HL7 standarder

Ordliste



DDSDokumentdelingsservice
BRSBehandlingsrelationsservice
FSKFælles Stamkort
XDSCross-Enterprise Document Sharing
SFSKSynkroniseringsservice til Fælles Stamkort (SFKS)

Overblik over løsningen

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

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

FSK-SOEG-1
Som en dokumentanvender ønsker jeg at fremsøge dokumentreference til en borgers stamkort, så jeg kan få adgang til borgerens stamkort

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.

Gliffy Diagram
nameFSK-DDS-Overblik
pagePin6

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ø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
til en borgers stamkort, så jeg kan få adgang til borgerens stamkort

FSK Registry Adapter er således en kilde, som tidligere har været anvendt af DDS til at understøtte fremsøgingsforespørgsler fra anvendere. Fremadrettet sker dette via SFSK. Der henvises til SFSK - Guide til AnvendereDDS 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 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 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

...

Fra IHE IT Infrastructure Technical Framework for specifikation af parametre relevante for FindDocuments:

Find documents (XDSDocumentEntry objects) in the registry for a given patientID with a matching availabilityStatus attribute. The other parameters can be used to restrict the set of XDSDocumentEntry objects returned.


Parameter NameAttributeOpt

Multiple

(lister af værdier)

FSK Registry Adapter understøttelse
$XDSDocumentEntryPatientIdXDSDocumentEntry.patientIdR--

Denne parameter skal angives. FSK Registry Adpter validerer at den medsendte værdi for CPR nummeret har længde 10 og består af cifre.

Medsendes værdien ikke eller overholder den medsendte værdi ikke FSK Registrys validering returneres en fejl af typen 'XDSUnknownPatientId'.

DDS foran FSK Registry har også valideringer på CPR numre, så denne validering burde ikke ramme anvendere. Dog skal det nævnes, at en konsekvens af denne validering er, at FSK Registry Adapter vil melde fejl tilbage til anvendere, der forespørger på erstatningsCPR.

$XDSDocumentEntryReferenceIdList (5)XDSDocumentEntry.referenceIdList (3)RMIngen fortolkning af FSK Registry
$XDSDocumentEntryClassCode (1)XDSDocumentEntry.classCodeOM

FSK Registry matcher queries, der 

  • ikke angiver classCode

eller

  • parameterlisten er tom

eller

  • listen af classCodes includerer FSK Registrys opsætningsvariabel for classCode (se afsnittet vedr. metadataopsætning nedenfor)
$XDSDocumentEntryTypeCode (1)XDSDocumentEntry.typeCodeOM

FSK Registry matcher queries, der 

  • ikke angiver typeCode

eller

  • parameterlisten er tom

eller

  • listen af typeCodes includerer FSK Registrys opsætningsvariabel for typeCode (se afsnittet vedr. metadataopsætning nedenfor)
$XDSDocumentEntryPracticeSettingCode (1)XDSDocumentEntry.practiceSettingCodeOM

FSK Registry matcher queries, der 

  • ikke angiver practiceSettingCode

eller

  • parameterlisten er tom

eller

  • listen af practiceSettingCode includerer FSK Registrys opsætningsvariabel for practiceSettingCode (se afsnittet vedr. metadataopsætning nedenfor)
Ingen fortolkning af FSK Registry
$XDSDocumentEntryCreationTimeFromLower value of
XDSDocumentEntry.creationTime		O--Ingen fortolkning af FSK Registry

$XDSDocumentEntryCreationTimeTo

Upper value of
XDSDocumentEntry.creationTime		O--Ingen fortolkning af FSK Registry
$XDSDocumentEntryServiceStartTimeFromLower value of
XDSDocumentEntry.serviceStartTime		O--Ingen fortolkning af FSK Registry
$XDSDocumentEntryServiceStartTimeToUpper value of
XDSDocumentEntry.serviceStartTime		O--Ingen fortolkning af FSK Registry
$XDSDocumentEntryServiceStopTimeFromLower value of
XDSDocumentEntry.serviceStopTime		O--Ingen fortolkning af FSK Registry
$XDSDocumentEntryServiceStopTimeToUpper value of
XDSDocumentEntry.serviceStopTime		O--Ingen fortolkning af FSK Registry
$XDSDocumentEntryHealthcareFacilityTypeCode (1)XDSDocumentEntry.healthcareFacilityTypeCodeOMIngen fortolkning af FSK Registry
$XDSDocumentEntryEventCodeList (1)XDSDocumentEntry.eventCodeList (3)OM

FSK Registry matcher queries, der 

  • ikke angiver eventCodeList

eller

  • parameterlisten er tom

eller

  • listen af eventCodes includerer FSK Registrys opsætningsvariabel for eventCodes (se afsnittet vedr. metadataopsætning nedenfor)
$XDSDocumentEntryConfidentialityCode (1)XDSDocumentEntry.confidentialityCode (3)OM

FSK Registry matcher queries, der 

  • ikke angiver confidentialityCoe

eller

  • parameterlisten er tom

eller

  • listen af confidentialityCodes includerer FSK Registrys opsætningsvariabel for confidentialityCode (se afsnittet vedr. metadataopsætning nedenfor)
$XDSDocumentEntryAuthorPerson (4) XDSDocumentEntry.authorOM

FSK Registry matcher kun queries, der

  • ikke angiver author

eller

  • parameterlisten er tom.
$XDSDocumentEntryFormatCode (1) XDSDocumentEntry.formatCodeOM

FSK Registry matcher queries, der 

  • ikke angiver formatCodes

eller

  • parameterlisten er tom

eller

  • listen af formatCodes includerer FSK Registrys opsætningsvariabel for classCode (se afsnittet vedr. metadataopsætning nedenfor)
$XDSDocumentEntryStatusXDSDocumentEntry.availabilityStatusRM

FSK Registry matcher queries, der

  • ikke angiver denne parameter

eller

  • parameterlisten er tom

eller

  • parameterlisten indeholder availabilityStatus Approved (urn:oasis:names:tc:ebxml-regrep:StatusType:Approved)
$XDSDocumentEntryType (6) XDSDocumentEntry.objectTypeOM(1)

FSK Registry matcher queries, hvor

  • listen af entryTypes inkluderer On-demand dokumenter (urn:uuid:34268e47-fdf5-41a6-ba33-82133c465248)

...

Opsætningsvariablens navnBeskrivelseMiljø-specifikVærdi (nuværende opsætning)
documentEntry.repositoryUniqueIdAnvendes til indsættelse i feltet $XDSDocumentEntry.repositoryUniqueId for de returnerede DocumentEntriesJ

?? (TEST1)

1.2.208.176.43210.8.20.12 (TEST2)

documentEntry.titleAnvendes til indsættelse i $XDSDocumentEntry.Name for de returnerede DocumentEntriesNFælles stamkort
documentEntry.mimeTypeAnvendes til indsættelse i $XDSDocumentEntry.mimeType for de returnerede DocumentEntriesNtext/xml
documentEntry.languageCodeAnvendes til indsættelse i $XDSDocumentEntry.languageCode for de returnerede DocumentEntriesNda-DK
documentEntry.patient.assigningAuthority.rootAnvendes til kvalificering af $XDSDocumentEntry.sourcePatientId for de returnerede DocumentEntriesN1.2.208.176.1.2 (CPR)
documentEntry.organisation.assigningAuthority.rootAnvendes til kvalificering af $XDSDocumentEntry.author (urn:uuid:93606bcf-9494-43ec-9b4e-a7748d1a838d) for de returnerede DocumentEntriesN1.2.208.176.1.1 (SOR)
documentEntry.healthcareFacilityTypeCode.codeAnvendes til indsættelse i $XDSDocumentEntry.healthcareFacilityTypeCode (urn:uuid:f33fb8ac-18af-42cc-ae0e-ed0b0bdb91e1) for de returnerede DocumentEntriesN554041000005106
documentEntry.healthcareFacilityTypeCode.schemeNameAnvendes til indsættelse i $XDSDocumentEntry.healthcareFacilityTypeCode (urn:uuid:f33fb8ac-18af-42cc-ae0e-ed0b0bdb91e1) for de returnerede DocumentEntriesN2.16.840.1.113883.6.96
documentEntry.healthcareFacilityTypeCode.nameAnvendes til indsættelse i $XDSDocumentEntry.healthcareFacilityTypeCode (urn:uuid:f33fb8ac-18af-42cc-ae0e-ed0b0bdb91e1) for de returnerede DocumentEntriesNsundhedsforvaltning
documentEntry.classCode.code

Anvendes til filtrering af queries.

Anvendes til indsættelse i $XDSDocumentEntry.classCode (urn:uuid:41a5887f-8865-4c09-adf7-e362475b143a) for de returnerede DocumentEntries

N001
documentEntry.classCode.schemeName

Anvendes til filtrering af queries.

Anvendes til indsættelse i $XDSDocumentEntry.classCode (urn:uuid:41a5887f-8865-4c09-adf7-e362475b143a) for de returnerede DocumentEntries

N1.2.208.184.100.9
documentEntry.classCode.nameAnvendes til indsættelse i $XDSDocumentEntry.classCode (urn:uuid:41a5887f-8865-4c09-adf7-e362475b143a) for de returnerede DocumentEntriesNKlinisk rapport

documentEntry.metadata.metadataEntry[*].formatCodeCode

Anvendes til filtrering af queries.

Anvendes til indsættelse i $XDSDocumentEntry.formatCode (urn:uuid:a09d5840-386c-46f2-b5ad-9c3699a4309d) for de returnerede DocumentEntries

("*" er et løbenummer startende med 0, så der på den måde kan være x antal kombinationer)

N

0: DK FSK Schemaurn:ad:dk:medcom:pdc-v2.0:full

1: urn:ad:dk:medcom:pdc-v2v3.0:full

documentEntry.metadata.metadataEntry[*].formatCodeScheme

Anvendes til filtrering af queries.

Anvendes til indsættelse i $XDSDocumentEntry.formatCode (urn:uuid:a09d5840-386c-46f2-b5ad-9c3699a4309d) for de returnerede DocumentEntries

("*" er et løbenummer startende med 0, så der på den måde kan være x antal kombinationer)

N

0: urn:ad:dk:medcom:fsk:full

1:1.2.208.184.100.10

documentEntry.metadata.metadataEntry[*].formatCodeName

Anvendes til indsættelse i $XDSDocumentEntry.formatCode (urn:uuid:a09d5840-386c-46f2-b5ad-9c3699a4309d) for de returnerede DocumentEntries

("*" er et løbenummer startende med 0, så der på den måde kan være x antal kombinationer)

N

0: DK FSK Schema

1: DK PDC schema

documentEntry.metadata.metadataEntry[*].typeCodeCode

Anvendes til filtrering af queries.

Anvendes til indsættelse i $XDSDocumentEntry.typeCode (urn:uuid:f0306f51-975f-434e-a61c-c59651d33983) for de returnerede DocumentEntries

("*" er et løbenummer startende med 0, så der på den måde kan være x antal kombinationer)

N

0: 52460-3

1: PDC

documentEntry.metadata.metadataEntry[*].typeCodeScheme

Anvendes til filtrering af queries.

Anvendes til indsættelse i $XDSDocumentEntry.typeCode (urn:uuid:f0306f51-975f-434e-a61c-c59651d33983) for de returnerede DocumentEntries

("*" er et løbenummer startende med 0, så der på den måde kan være x antal kombinationer)

N

0: 2.16.840.1.113883.6.1

1: 1.2.208.184.100.1

documentEntry.metadata.metadataEntry[*].typeCodeName

Anvendes til indsættelse i $XDSDocumentEntry.typeCode (urn:uuid:f0306f51-975f-434e-a61c-c59651d33983) for de returnerede DocumentEntries

("*" er et løbenummer startende med 0, så der på den måde kan være x antal kombinationer)

N

0: Patient Information

1: Stamkort

documentEntry.author.organisation.idAnvendes til indsættelse i $XDSDocumentEntry.author (urn:uuid:93606bcf-9494-43ec-9b4e-a7748d1a838d) for de returnerede DocumentEntriesN634491000016008
documentEntry.author.organisation.nameAnvendes til indsættelse i $XDSDocumentEntry.author (urn:uuid:93606bcf-9494-43ec-9b4e-a7748d1a838d) for de returnerede DocumentEntriesNSundhedsdatastyrelsen
documentEntry.confidentialityCode.code

Anvendes til filtrering af queries.

Anvendes til indsættelse i $XDSDocumentEntry.confidentialityCode (urn:uuid:f4f85eac-e6cb-4883-b524-f2705394840f) for de returnerede DocumentEntries

NN
documentEntry.confidentialityCode.schemeName

Anvendes til filtrering af queries.

Anvendes til indsættelse i $XDSDocumentEntry.confidentialityCode (urn:uuid:f4f85eac-e6cb-4883-b524-f2705394840f) for de returnerede DocumentEntries

N2.16.840.1.113883.5.25
documentEntry.confidentialityCode.nameAnvendes til indsættelse i $XDSDocumentEntry.confidentialityCode (urn:uuid:f4f85eac-e6cb-4883-b524-f2705394840f) for de returnerede DocumentEntriesNnormal
documentEntry.practiceSettingCode.codeAnvendes til indsættelse i $XDSDocumentEntry.practiceSettingCode (urn:uuid:cccf5598-8b07-4b77-a05e-ae952c785ead) for de returnerede DocumentEntriesN408443003
documentEntry.practiceSettingCode.schemeNameAnvendes til indsættelse i $XDSDocumentEntry.practiceSettingCode (urn:uuid:cccf5598-8b07-4b77-a05e-ae952c785ead) for de returnerede DocumentEntriesN2.16.840.1.113883.6.96
documentEntry.practiceSettingCode.nameAnvendes til indsættelse i $XDSDocumentEntry.practiceSettingCode (urn:uuid:cccf5598-8b07-4b77-a05e-ae952c785ead) for de returnerede DocumentEntriesNalmen medicin

...

  • Filtrering af queries
  • Generering af DocumentEntries i response.

Bemærk: FSK justerer telefonnumre efter dette mønster: tel:?[-0-9().] . Telefonnummer kan være både under pårørende og kontaktinformation.

Eksempel: Request og response fra FSK Registry

Følgende request viser en fremsøgning af dokumenter på CPR nummeret 2110979421 via DDS nummeret 2110979421 (SOAP headers er fjernet for at gøre eksemplet mere læsevenligt). Eksemplet viser en søgning hvor der kun returneres eet dokument.

Code Block
languagexml
titleRequest DDS (FSK Registry)
collapsetrue
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ns4:AdhocQueryRequest xmlns:ns6="urn:oasis:names:tc:ebxml-regrep:xsd:lcm:3.0" xmlns:ns5="urn:ihe:iti:xds-b:2007" xmlns:ns4="urn:oasis:names:tc:ebxml-regrep:xsd:query:3.0" xmlns:ns3="urn:oasis:names:tc:ebxml-regrep:xsd:rs:3.0" xmlns:ns2="urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0">
      <ns4:ResponseOption returnType="LeafClass" returnComposedObjects="true"/>
      <ns2:AdhocQuery id="urn:uuid:14d4debf-8f97-4251-9a74-a90016b0af0d">
        <ns2:Slot name="$XDSDocumentEntryPatientId">
          <ns2:ValueList>
            <ns2:Value>'2110979421^^^&1.2.208.176.1.2&ISO'</ns2:Value>
          </ns2:ValueList>
        </ns2:Slot>
        <ns2:Slot name="$XDSDocumentEntryType">
          <ns2:ValueList>
            <ns2:Value>('urn:uuid:34268e47-fdf5-41a6-ba33-82133c465248')</ns2:Value>
            <ns2:Value>('urn:uuid:7edca82f-054d-47f2-a032-9b2a5b5186c1')</ns2:Value>
          </ns2:ValueList>
        </ns2:Slot>
      </ns2:AdhocQuery>
    </ns4:AdhocQueryRequest>
  </soap:Body>
</soap:Envelope>

Som vist i overblikket delegerer DDS query videre til bl.a. FSK Registry og samler kildernes svar i et samlet response til anvenderen. Følgende viser, hvordan response ser ud (SOAP headers er fjernet for at gøre eksemplet mere læsevenligt).

...