OCL Subscription Module for OpenMRS 3

Google Summer of Code 2022 Project — Final Report

Image by pch.vector on Freepik

Project Summary

Project Title: OCL Subscription Module for OpenMRS3
Primary mentor: Ian Bacher
Backup mentor: Hadijah Kyampeire
Student: Piumal Rathnayake
Project Wiki: GSoC 2022: OCL Subscription Module for OpenMRS3

Overview

OCL Subscription Module is one of the most valuable modules used with OpenMRS to make the implementations easier. The existing OCL subscription module is built targetting the OpenMRS RefApp 2.X, and its frontend runs as an OpenWebApp (with the help of the OWA Module). When it comes to OpenMRS 3.X, the OWA module is deprecated but it is still used due to the unavailability of the micro frontend of the OCL Subscription Module.

This project is focused on creating a micro frontend for the above-mentioned OpenMRS OCL Module (OCL Subscription Module) admin tool. With that modern frontend technologies, it enables OpenMRS users and developers around the world to share more frontend functionalities, reduce duplicated effort, and have a better user experience.

Objectives

To avail the OCL Module functionalities as a micro frontend:

1. Ability to manage(add/edit/remove) a subscription ✅
2. Ability to Import Concepts using the saved subscription ✅
3. Ability to Import Concepts using a zip file ✅
4. Ability to see the list of previous imports ✅
5. Ability to see the details of a selected previous import ✅

Contributions

Repositories

GitHub - openmrs/openmrs-esm-admin-tools: Administrative microfrontends for OpenMRS 3.0

Pull Requests

Pull requests · openmrs/openmrs-esm-admin-tools

JIRA Epics

GSoC 2022 - Microfrontending the OCL Module and reduce backend dependencies

Talk Threads

GSoC 2022: Microfrontend the OCL Module - Requirement Gathering

Unable to import concepts using OCL Subscription Module

GSoC 2022: Microfrontend the OCL Module - Project Updates

Weekly Blog Posts

GSoC 2022 with OpenMRS — Community Bonding Period

Working with OCL Subscriptions — GSoC 2022 Week 1

Completing the OCL Subscription Component — GSoC 2022 Week 2

A Component for Importing Concepts — GSoC 2022 Week 3

Configuring the Unit Tests — GSoC 2022 Week 4

More testing — GSoC 2022 Week 5

Designing the Previous Imports Component — GSoC 2022 Week 6

A Component for Viewing Previous OCL Imports — GSoC 2022 Week 7

Deploying OCL Subscription Module — GSoC 2022 Week 8

Upgrading the Module Dependencies — GSoC 2022 Week 9

Fixing the Broken Components— GSoC 2022 Week 10

Minor Issues — GSoC 2022 Week 11

Wrapping Up — GSoC 2022 Week 12

Demonstration

Resources

• Project proposal
• Project Wiki
• Jira Epic
• Module Wiki

Future Works

The main requirements of the project were fulfilled, so in the future, the following new features can be added.

• Automation/Scheduling Support
• Supporting multiple subscriptions

Thoughts on GSoC

First of all, Thank you for giving me the opportunity to participate in GSoC under OpenMRS. This is the second time I have been selected for Google Summer of Code. It has been a wonderful summer for me. This year I got the opportunity to develop a frontend project, and it was a good starting point for me to learn about microfrontends.

I really appreciate my mentors @ibacher and @hadijah315 for guiding me throughout the project. They were very supportive and knowledgeable, so It was easy for me to clear the doubts and complete the project. I would also like to thank @grace and @suruchi for the assistance given. Also special thanks to Jayasanka Weerasinghe for introducing me to OpenMRS and for the support given from the beginning to get selected for both GSoC 2021 and GSoC 2022. I’m looking forward to working with OpenMRS in future as well.