Summary
Many OpenMRS implementers have used HTML Forms (HFE) for many years. Some organizations have dozens or even hundreds of OpenMRS forms encoded in HTML. This makes it intimidating to consider moving to O3, since O3 uses a custom Form Schema.
There was a previous community project with scripts that help convert HTML forms into the O3 Form Schema for the Angular Form Engine. This did not convert 100% of the form into the new schema, but got most of it done (60-80%) so that it is faster for a team to work on the transition.
This project needs to be (1) updated to enable implementers to convert HTML forms into the newer React Form Engine schema, and (2) documented to explain how to use it.
🧵 Project Size
Medium
📋 You Will Need to:
Familiarize yourself with the previous script tool code repository
Identify all the areas that will need to be updated/changed in order to support form conversion to the RFE instead of the AFE;
Use a few test cases to confirm the tool works as expected;
Add some documentation about the tool to the README and Wiki so it is easy for implementers to know how to find and use this helpful tool.
🔗 Key Resources & Links:
Previous scripting tool Code Repo: https://github.com/openmrs/hfe-o3-form-schema-converter
Detailed wiki page explaining the history of this Conversion Script, including recordings of calls that walk-through how to use it: https://openmrs.atlassian.net/wiki/x/AYCeC
Reference List about HTML Form Entry module functionality and common form use cases: https://openmrs.atlassian.net/wiki/x/c7_EAQ
React Form Engine repo for reference: https://github.com/openmrs/openmrs-esm-form-engine-lib
Partners in Health is one example organization with many forms in HTML Form Entry which could be used to test converting into the O3 RFE schema.