openhim-mediator-xds

An OpenHIM mediator for OpenHIE supporting XDS.b-based workflows. It validates and enriches client, healthcare worker and facility information.

The mediator contains two endpoints:

• /xdsrepository - Validates and routes requests to an XDS.b Repository and will enrich Provide and Register Document Set.b (ITI-42) requests with client, healthcare worker and facility enterprise identifiers. All other requests will pass-through unaltered to the Repository.
• /xdsregistry - Validates and routes requests to an XDS.b Registry and will enrich Adhoc Query (Registry Stored Query ITI-18) requests with client enterprise identifiers. All other requests will pass-through unaltered to the Registry.

Document enrichment is supported via PIX and CSD requests to any compliant Client Registry or CSD Infomanager.

ATNA auditing is supported for requests.

Usage

• Ensure that a Java Runtime Environment is installed on your system. At a minimum Java 7 is required.
• Download the latest release of the mediator: curl -LO https://github.com/jembi/openhim-mediator-xds/releases/download/v1.0.3/openhim-mediator-xds-1.0.3.tar.gz
• Extract the downloaded archive: tar -xzf openhim-mediator-xds-1.0.3.tar.gz
• Edit the properties file mediator.properties and change it as required for your implementantion
• The mediator is packaged as a standalone jar and can be run as follows: java -jar mediator-xds-1.0.3-jar-with-dependencies.jar --conf mediator.properties

Compiling and running from source

• git clone https://github.com/jembi/openhim-mediator-xds.git
• cd openhim-mediator-xds
• mvn install
• java -jar target/mediator-xds-1.0.3-jar-with-dependencies.jar