/
Forms Migration Tool: Help HTML Form users switch to using O3 React Forms

Forms Migration Tool: Help HTML Form users switch to using O3 React Forms

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:

Related content

Fix the Fast Data Entry feature (GSOC 2025)
Fix the Fast Data Entry feature (GSOC 2025)
Read with this
Converting from HTML Form Entry (HFE Forms) to O3 Forms
Converting from HTML Form Entry (HFE Forms) to O3 Forms
More like this
O3 Growth Chart (GSOC 2025)
O3 Growth Chart (GSOC 2025)
Read with this
GSoC 2023: O3: Migrate vanilla React forms to RHF
GSoC 2023: O3: Migrate vanilla React forms to RHF
More like this
Summer of Code 2025
Summer of Code 2025
Read with this
Form Solutions Analysis
Form Solutions Analysis
More like this