####Table of Contents
OpenMRS module radiology (previously called radiologydcm4chee) is a module adding capabilities of a Radiology Information System (RIS) onto OpenMRS.
You need to have installed
- a Java JDK 8
- the build tool Maven
You need to configure Maven to use the JAVA JDK 8
mvn -versionShould tell you what version Maven is using.
You need to clone this repository:
git clone https://github.com/openmrs/openmrs-module-radiology.gitAfter you have taken care of the Prerequisites
Execute the following command:
cd openmrs-module-radiology
mvn clean packageThis will generate the radiology module in omod/target/radiology-{VERSION}.omod which you will have to deploy into OpenMRS.
The easiest way to install the module is to use Docker.
This module can be baked into a Docker image so you can easily run and test it.
After you have taken care of the Build Prerequisites
Make sure you have Docker installed.
Build the Radiology Module and its Docker image:
cd openmrs-module-radiology
mvn clean package docker:buildTo run an instance of the OpenMRS Radiology Module execute (assumes you have created a Docker image):
cd openmrs-module-radiology
mvn docker:startOpenMRS will be accessible at http://<IP ADDRESS>:8080/openmrs
NOTE: The IP address varies depending on your setup.
If you are using Docker machine refer to its documentation on how to get the IP address.
If you are on Linux it will probably be will be localhost.
Please read the corresponding DOCKER.md for more detailed explanations on using Docker with the Radiology Module.
You can import the demo data set demo-data.sql into your database which enables you to try out the modules features or test your changes.
Please read the corresponding DEMO-DATA.md.
For a detailed guide on ways to install and configure this module see
http://teleivo.github.io/docs-openmrs-module-radiology/
Please check out the readme files at docs.
For some more background informations on the module see
https://wiki.openmrs.org/display/docs/Radiology+Module
Contributions are very welcome, we can definitely use your help!
Check out our contributing guidelines, read through the Developer guides.
After you've read up 👓 grab an issue that is Ready For Development.
We use
https://www.transifex.com/openmrs/OpenMRS/radiology-module/
to manage our translations.
The messages.properties file in this repository is our single source of
truth. It contains key, value pairs for the English language which is the
default.
Transifex fetches updates to this file every night which can then be translated
by you and me on transifex website itself. At any time we can pull new translations from transifex
back into this repository. Other languages like for ex. Spanish will then be in
the messages_es.properties file.
If you would like to know more about transifex from the coding side read
https://wiki.openmrs.org/display/docs/Maintaining+OpenMRS+Module+Translations+via+Transifex
To file new issues or help to fix existing ones please check out
https://issues.openmrs.org/browse/RAD
This module is not yet officially released to the openmrs modules.
The API and UI are not yet stable and subject to frequent changes.
❗ ATTENTION ❗ radiology orders created via the module will not be sent to the PACS as HL7 order messages. This has previously been done in a hacky/synchronous way which was not fit for production and only messy code which had to be removed. A message queue which takes care of sending HL7 order messages to the PACS once orders are created is needed. Such a queue would retry sending the order message in case the PACS is currently down. Unfortunately, OpenMRS does not provide such a message queue for outgoing HL7 messages. This is THE big missing piece in the puzzle of the radiology module which until now has been bridged with communication servers such as mirth.
The module depends on OpenMRS Version 2.0.0 so it cannot run on any version lower than that.
The module currently depends on OpenMRS Legacy UI which provides the UI but it is planned to extract the UI into a separate module so this module only provides the Java and REST API without forcing a specific UI onto anyone.
Ask questions on OpenMRS Talk.