GSoC 2021: Export & import feature for the OMRS Reporting module

Abstract

DHIS mappings are created in OpenNMS instances to keep information about how period indicator reports are mapped with DHIS data elements. Previously the DHIS connector module had the functionality to export these mapping files but they were not usable in different OpenMRS instances because the mapped period indicator reports are required to be present in the system. Thus this project was proposed to introduce a new feature to bundle up period indicator reports and other underlying reporting metadata with the DHIS mappings on the mapping export and import the same type of bundles back in.

Main objectives

• Improve export DHIS mappings function to include period indicator reports with other related reporting metadata.
• Improve import DHIS mappings function to persist period indicator reports and other underlying reporting metadata.

Additional objectives

• Simplify the user experience by improving manage mappings user interface to handle every DHIS mapping-related function.
• Handle metadata UUID conflicts by letting the users pick the action for such cases.
• Improve the export function to have the option to export mappings without period indicator reports.

Technical details

Project Champions

• Kaweesi Joseph Mike Seaton,  Jayasanka Weerasinghe, Grace Potma

Requirements

• Programming fundamentals
• Java
• SQL
• OpenMRS data model & API
• OpenMRS DHIS connector module
• OpenMRS reporting module

Resources

• Important GitHub links:
  • DHIS Connector Module
  • Reporting Module
  • Metadata Sharing Module
  • Metadata Deploy Module