Indhold
1 Introduktion
1.1 Formål
1.2 Læsevejledning
1.3 Dokumenthistorik
1.4 Definitioner og referencer
2 Byg og deployment
2.1 Konfiguration af Dokumentdelingsservicen
3 Konfigurationer
3.1 Konfiguration for Svareksponeringsservice XDS Adaptere
3.1.1 Svareksponeringsservice XDS Registry Adapter
3.1.2 Svareksponeringsservice XDS Repository Adapter
Introduktion
Laboratoriesvarsdokumenter (målinger på personer i behandling med Mikrobiologi, Biokemi og Patologi) gøres tilgængelige gennem Dokumentdelingsservices (DDS) på den Nationale Service Platform (NSP). Derved underkastes opslag og indhentning af aftaleoversigtsdokumenter for den adgangskontrol og de kontroller for behandlingsrelation og adgangsnægtelse hhv. samtykker samt logning i MinLog, som gennemføres på DDS.
Der er skabt nye Svareksponeringsservice XDS-adaptere, der implementerer henholdsvis XDS-snitfladen for opslag på metadata og XDS-snitfladen for indhentning af dokumenter. Disse snitflader er implementeret i følgende komponenter i Svareksponeringsservice XDS-adaptere:
- Svareksponeringsservice XDS Registry Adapter, der fungerer som XDS Registry for så vidt angår opslag på metadata om dokumenter
- Svareksponeringsservice XDS Repository Adapter, der fungerer som XDS Repository (for så vidt angår indhentning af dokumenter).
Når snitfladen til opslag på metadata anvendes på Svareksponeringsservice XDS Registry Adapter, returneres metadata ud fra opslagets søgeparametre og konfigurerede metadata.
Når snitfladen til indhentning af dokument anvendes på Svareksponeringsservice XDS Repository Adapter, returneres et laboratoriesvarsdokument hentet fra Laboratoriedatabankens Svareksponeringsservice.
Dokumentdeling af laboratoriesvarsdokumenter opnås ved at koble DDS op mod Svareksponeringsservice XDS-adaptere, der igen kobles op til Laboratoriedatabankens Svareksponeringsservice.
Formål
Formålet med nærværende dokument er at beskrive hvilke konfigurationsparametre for Svareksponeringsservice XDS-adaptere, der skal anvendes for at understøtte et setup.
Læsevejledning
For yderligere beskrivelse af konfigurationsparametre og -filer henvises til \[Driftsvejledning\].
Dokumenthistorik
Version | Dato | Ansvarlig | Beskrivelse |
|---|---|---|---|
1.0 | 20.09.2016 | Systematic | Initiel udgave |
Definitioner og referencer
Formålet med denne sektion er at give et overblik over definitioner og dokumenter, der benyttes i dette dokument.
Definition | Beskrivelse |
|---|---|
DDS | Dokumentdelingsservices |
NSI | National Sundheds IT |
XDS | Cross-Enterprise Document Sharing |
Alias | Beskrivelse |
|---|---|
Driftsvejledning | Driftsvejledning Svareksponeringsservice XDS-adaptere, (SSE/11734/OHB/0017) |
Guide til udviklere | Guide til udviklere - Svareksponeringsservice XDS-Adaptere, (SSE/11734/PHB/0045) |
IHE DK Profil | XDS Metadata for Document Sharing, Danish Profile, Draft profile for Trial Use, National eHealth Authority, Version 0.90b, 30 January 2015 |
IHE DK Profil Value Sets | DK-IHE_Metadata_Common_Code_systems-Value_sets, version 0.90, 31 January 2015 |
Installationsvejledning | Installationsvejledning Svareksponeringsservice XDS-adaptere, (SSE/11734/INS/0011) |
Byg og deployment
Til indledende byg og tests af Svareksponeringsservice XDS-adaptere deployes som vist i Figur 1.
Figur 1 Deployment af Svareksponeringsservice XDS-adaptere
Alternativt kan der anvendes en stub for Svareksponeringsservicen hos Laboratoriedatabanken, hvorved blot endpoints (se sxa.labservice.endpoint i nedenstående) vil skulle ændres.
Bygge- og deployeringsprocedurer som beskrevet i \[Guide til udviklere\] og \[Installationsvejledning\].
Den byggede war-filer og tilhørende konfiguration etablerer den konfiguration, der er beskrevet i afsnit 3. Blot udestår at udpege Svareksponeringsservicen hos Laboratoriedatabanken.
Konfiguration af Dokumentdelingsservicen
Dokumentdelingsservicen konfigureres til at anvende Svareksponeringsservice XDS-adaptere ved at tilføje følgende indgange i Dokumentdelingsservicens konfigurationstabeller i MySQL databasen. De specifikke database tabelnavne står som en del af nedenstående tabelnavne.
Kolonne | Værdi |
|---|---|
documentregistryid | (blot fortløbende) |
documentregistryserviceurl | http://host:port/sxa-documentmetadataprovider |
documentregistryfriendlyname | SES XDS Registry Adapter |
documentregistryservicenamespace | urn:ihe:iti:xds-b:2007 |
documentregistrylocal | 0 (false) |
documentregistrytimeoutvalue | 30000 |
documentregistryactive | 1 (true) |
documentregistryservicename | DocumentRegistry_Service |
Tabel 1 documentsources.documentregistry - indgang for Svareksponeringsservice XDS Registry Adapter
Kolonne | Værdi |
|---|---|
oid | 1.2.3.4.55.66 |
type | repository_unique_id |
service_endpoint | http://host:port/sxa-documentprovider |
soap_version | 1.2 |
timeout | 120000 |
Tabel 2 documentsources.documentsource – indgang for Svareksponeringsservice XDS Repository Adapter
Konfigurationer
Ved opslag på dokumentmetadata med FindDocuments-variant, returnerer Svareksponeringsservice XDS Registry Adapter dokumentmetadata, der er tilstræbt at overholde den nationale XDS profil \[IHE DK Profil\]. Overholdelsen beror på, at der ved konfigurationen er valgt værdier i ovensstemmelse med profilen, fx ved at kodede værdier er hentet fra value settet for pågældende attribut i \[IHE DK Profil Value Sets\]. Visse metadata-attribut-værdier, fx homeCommunityId, skal afspejle opdelingen i affinitetsdomæner.
Konfiguration for Svareksponeringsservice XDS Adaptere
Svareksponeringsservice XDS Registry Adapter
Konfiguration i sxametadataconfiguration.xml (for øvrige elementer i filen anvendes defaultværdierne/fabrikindstillingerne)
Element | Værdi | Beskrivelse | |
|---|---|---|---|
homeCommunityId | 1.2.3.5.6 | SES XDS Registry Adapter fungerer som et registry i eget affinitetsdomæne. Dette affinitetsdomæne er kendt af andre affinitetsdomæner (fx det affinitetsdomæne, hvori DDS anvendes) ved denne attribut. | |
repositoryUniqueId | 1.2.3.4.55.66 | Det id, SES XDS Repository Adapter skal være defineret som. | |
uniqueIdRoot | 1.2.3.4.55.66 | Når SES XDS Registry Adapter returnerer uniqueId (documentUniqueId), da vil det have denne værdi som root, dvs. en slags prefix. | |
healthcareFacilityTypeCode | |||
/code | |||
/codeSystem | 2.16.840.1.113883.6.96 | ||
/description | |||
authorInstitution | |||
/name | Region Test | Navn | |
/id/value | SOR-kode for klinisk organisation, der leverer laboratoriesvar-dokumentet. | ||
/id/assigningAuthority | 1.2.208.176.1.1 | OID for SOR-kode |
Konfiguration i sxafilterconfiguration.xml anvendes med defaultværdierne/fabriksindstillingerne.
Svareksponeringsservice XDS Repository Adapter
Konfiguration i sxaproviderconfiguration.xml:
Element | Værdi | Beskrivelse |
|---|---|---|
homeCommunityId | 1.2.3.5.6 | Værdierne her skal følge de tilsvarende elementer i sxametadataconfiguration.xml. |
repositoryUniqueId | 1.2.3.4.55.66 | Værdierne her skal følge de tilsvarende elementer i sxametadataconfiguration.xml. |
uniqueIdRoot | 1.2.3.4.55.66 | Værdierne her skal følge de tilsvarende elementer i sxametadataconfiguration.xml. |
Konfiguration i SXADocumentProvider.properties:
Property | Værdi | Beskrivelse |
|---|---|---|
sxa.labservice.request.timeout.seconds | 120 | Timeout i sekunder for kald af SES. |
sxa.labservice.request.username | Brugernavnet der anvendes ved kald til SES | |
sxa.labservice.request.password | Kodeordet der anvendes ved kald til SES | |
sxa.labservice.endpoint | URL for Svareksponeringsservicen. | |
sxa.document.assigning.authority.name | Region Test | Navn på organisation ansvarlig for udstedelse af dokumentid anvendt i det skabte laboratoriesvars-dokument. |
sxa.document.unique.root.id | 1.2.3.4.55.66 | Værdien anvendes som root-attribut i det skabte laboratoriesvars-dokuments dokumentid (i /ClinicalDocument/id-elementet). Forventet at være på OID-form. |