OpenMRS Radiology Module
OpenMRS Radiology Module is a module adding capabilities of a
Radiology Information System (RIS) onto OpenMRS. This module
connects the open source enterprise electronic medical record system
OpenMRS ([Link] with the open source clinical image
and object management system dcm4chee ([Link]
Project status
OpenMRS Radiology Module is not yet officially released to the
OpenMRS modules ([Link] The API and UI are not
yet stable and subject to frequent changes.
Table of Contents
1. Overview
2. Installation
2.1. "Manual"
2.2. Devops
3. Deployment
3.1. Module Dependencies
3.2. Module Package
4. Con guration
4.1. OpenMRS Radiology Module
4.2. Dcm4chee
1. Overview
The most important URLs are
Source code: [Link]
Issues: [Link]
Wiki: [Link]
Documentation: [Link]
Host and Port configuration
This guide assumes that your
OpenMRS installation can be reached at
[Link]
dcm4chee listens to [Link]
Please adjust the URLs accordingly.
2. Installation
To setup OpenMRS with the OpenMRS Radiology Module and dcm4chee you have two
main options
2.1. "Manual"
Follow installation instructions of both projects
[Link]
[Link]
and execute all the necessary steps yourself.
2.2. Devops
Follow
[Link]
which will do most of the steps for you.
You will need a stable internet connection. The setup is downloading all
necessary archives (a few hundred MBs) from different sites that may or
may not be responding well in your area. People have reported timeout
issues. If this does not work out for you I suggest you go the "manual"
route.
3. Deployment
3. Deployment
Deployment of the Radiology Module consists of deploying all necessary dependencies
and then the module itself into OpenMRS.
You need to login to your OpenMRS instance as administrative user and go to the
Administration, Manage Modules page and add the modules shown in the following
sections.
3.1. Module Dependencies
The Radiology Module currently depends on the OpenMRS EMRAPI Module
([Link] version 1.13 which itself has a bunch of
dependencies.
You can get the dependencies at OpenMRS modules ([Link]
The following list is a suggested order in which we have managed to successfully deploy
the necessary dependencies:
1. providermanagement - version 2.3
2. uiframework - version 3.4
3. uilibrary - version 1.5
4. emrapi - version 1.13
5. event - version 2.2.1
6. reporting - version [Link]
7. htmlwidgets - version 1.7.0
8. calculation - version 1.1
9. [Link] - version 0.2.9
10. metadatasharing - version 1.1.9
11. metadatamapping - version 1.0.1
Do not worry about alerts you might get due to a modules dependencies
not being met. Just go ahead and deploy its dependencies and hit the
start button of the module which created the alert. You might also be
able to add newer versions of the modules listed here.
3.2. Module Package
Since there has not been an official release yet you need to compile the Radiology
Module yourself.
Please follow the instructions at [Link]
4. Con guration
At this point I expect you to have OpenMRS 1.11.4 installed, OpenMRS Radiology Module
deployed and dcm4chee up and running.
Whats missing is the connection (DICOM, HL7) between OpenMRS Radiology Module
and the dcm4chee PACS and the setup of the DICOM web viewer in the PACS.
4.1. OpenMRS Radiology Module
Follow the steps as shown to finish configuration of the OpenMRS Radiology Module.
4.1.1. Radiology Concept Classes
Before you can start to enter radiology orders you need to define the orderable
procedures within your facility.
To do that you need to go to the Administration, Settings page and select "Radiology" in
the menu on the left side.
The setting that needs to be specified is called "Radiology Concept Classes" as shown
below
You can enter any list of OpenMRS concept class UUIDs.
Its easy to find these UUIDs via "Manage Concept Classes" link in the admin page
Click on any concept class you whish to configure, for example "Test"
And copy the UUID you see greyed out at the bottom
Paste this concept class UUIDs into the "Radiology Concept Classes" settings field and hit
"Save".
4.2. Dcm4chee
Follow all the steps exactly as shown in the images to configure the connection between
the OpenMRS Radiology Module and dcm4chee and to setup the DICOM web viewer
weasis in dcm4chee.
Go to [Link] ([Link] and login as
default admin user
username: admin
password: admin
4.2.1. Setup Weasis
To configure weasis as the DICOM web viewer used by dcm4chee go to section
[Link] service=WebConfig
([Link]
action=inspectMBean&name=[Link]%3Aservice%3DWebConfig)
and set
WebviewerNames: weasis
WebviewerBaseUrls: weasis:/weasis-pacs-connector/viewer
4.2.2. Setup Connection With OpenMRS Radiology Module
To connect the OpenMRS radiology module with dcm4chee you need to
4.2.3. Add New AET
Add the radiology module as DICOM Application Entity at
[Link] ([Link] under the tab
Application Entities
Select New AET and enter:
Title: RADIOLOGY_MODULE
Type: -
Hostname: localhost
Port: 11114
Description (optional): OpenMRS Radiology Module
Installed (optional): enable
4.2.4. Setup DICOM MPPS Forwarding
To configure DICOM MPPS message forwarding to the OpenMRS radiology module go to
section [Link] service=MPPSScu
([Link]
action=inspectMBean&name=[Link]%3Aservice%3DMPPSScu)
and set
ForwardingRules: [calling!=RADIOLOGY_MODULE]RADIOLOGY_MODULE
Last updated 2016-05-01 18:20:19 CEST