/openhim-mediator-xds

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

Primary LanguageJavaMozilla Public License 2.0MPL-2.0

Build Status

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.5/openhim-mediator-xds-1.0.5.tar.gz
  • Extract the downloaded archive: tar -xzf openhim-mediator-xds-1.0.5.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.5-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.5-jar-with-dependencies.jar