Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 18 Next »

Steps to Install the MDR-TB Module Version 3.0

Prerequisites

You must have OpenMRS 1.9.2 or higher installed. (Note that as of August 2012, OpenMRS 1.9.2 has yet to be released... until it is released, the only way to use MDR-TB 3.0 is to run a custom build of the 1.9.x branch of OpenMRS core).

The following modules must be installed for the MDR-TB module to operate:

  • Serialization XStream
  • HTML Widgets
  • Reporting 
  • Metadata Sharing (v1.0.9)

All these modules can be downloaded from the OpenMRS module repository.

Also note that module only supports Firefox.  There are a few issues when using the module with Chrome; it has not been tested at all in IE.

Core MDR-TB Metadata

Once you've got these modules installed, you will need to import the core concepts, encounter types, and workflows used by the MDR-TB module. If you are using the MVP dictionary, you should already have the core concepts, but will still need to import the encounter types and workflows.

Importing is done via the Metadata Sharing module. Make sure you are using v1.0.9 of the Metadata Sharing module. From the "Administration" page, select "Share Metadata" from the "Metadata Sharing" section.  Click on "Import Package".

If you are not using the MVP dictionary, import the full package "MDR-TB MODULE 2.0 CORE METADATA.zip" which you can down here:

MDR-TB Module Core Metadata

If you are using the MVP dictionary, import the MVP-specific package "MDR-TB MODULE 2.0 MVP METADATA.zip" which you can download here:

MDR-TB Module MVP Metadata

MDR-TB Install 

Once that has been successfully imported, install the MDR-TB module from the OpenMRS module repository.

Once it has been installed successfully, click on the "MDR-TB Homepage" tag to go to the MDR-TB Homepage.

Upgrading from Version 2.0

If you upgrade your OpenMRS install from 1.6.x to 1.9.x, you will have to update your MDR-TB module from version 2.x to version 3.x.  This should be as simple as making sure you replace your 2.x omod with the latest 3.x omod, and also making sure you have upgraded the dependent modules listed in the Prerequisites section to versions that are compatible with your version of OpenMRS.  Also note that the Program Location module, a prerequiste when running version 2.x of the MDR-TB is no longer required when running version 3.0, and, in fact, should be removed (this is because starting with OpenMRS 1.8.x, the core platform supports program locations natively).

Adding Your Own Intake and Followup Forms

The Visits section of the MDR-TB module comes with very simple intake and followup forms that just collect the basic details of the encounter, vitals, and clinician notes.  It is possible, however, to include your own custom HTML Forms here.  To do so, simply associate an HTML Form you create with the MDR-TB Intake or MDR-TB Followup encounter type (via Manage HTML Forms).  Then, when you add a new Intake or Followup encounter for a patient, you will be asked to chose whether you want to use the "simple" form, or the custom HTML Form you have installed.

More Information

MDR-TB Module User Guide

MDR-TB Module Report Guide

  • No labels