GSoC 2020 : Improved OpenMRS DHIS2 Integration


A lot of great work was done during GSoC 2013 to integrate OpenMRS and DHIS2. The aim of this project is to extend the OpenMRS-DHIS2 Integration Module. The new features to be added will be sourced from the community.


  1. Gather requirements by communicating with the teams who have currently deployed the OpenMRS to understand the problems using the current DHIS2 Integration module
  2. Upgrade the module to work with the latest version of the DHIS2 data model

Extra Credit

  1. Upgrade the UI of the module to be used with the micro frontend architecture

Skills Needed

  1. OpenMRS data model/understanding of OpenMRS terms.
  2. DHIS data model
  3. Reporting Module functionality.
  4. Basic understanding of Spring and Hibernate.

Basic understanding of XML and JAXB is needed as the OpenMRS-DHIS2 Integration Module implements them.

Future Work

  1. Reconcile DHIS2 Reporting module branches
    To make the module available in production, the `adx` and `adx-disaggregations` branches should be merged to master to ensure the module has the following,
    - Use CODE values instead of UIDs
    - Use DHIS2 friendly terms at the dataset level
    - Define a standard set of concepts/terms to use
    - Import datasets using a connected DHIS2 instance
    - Support multiple Period Types
    - Map OMRS locations with DHIS2 Organisation Unit codes
  2. Develop the UI using Micro Frontends
  3. Add custom SQL Queries support
  4. Add Export functionality (export SQL-mapped dataset from the module)
  5. Push data to DHIS2 automatically
  6. Store multiple DHIS2 connections

More details on the next steps can be found here: COVID-19 Public Health Response — Improving OMRS to DHIS2 Integration


OpenMRS-DHIS2-SDMX-HD Integration (see also child pages)

  1. (see documentation)
  5. (read the complete thread)
  6. (paper on integrating OpenMRS and DHIS2 using demo data)
  7. Progress thread:
  8. Project’s wiki page:
  9. COVID-19 Public Health Response - Improving OMRS to DHIS2 Integration:
  10. COVID-Squad notes:
  11. ADX specification:
  12. ADX-HIV content profile:
  13. Dive into DHIS2 Integration work: What's done, and gaps to know:
  14. Comparison between the DHIS2 Connector Module, DHIS2 Reporting Module branches, and UgandaEMR approach:
  15. Summary: Comparison between OpenMRS DHIS2 integrations:
  16. Summary: Reconcile DHIS2 Reporting module branches: