GSoC 2020 : Add Support for FHIR Narratives

Primary mentor

Backup mentor

Assigned to


FHIR is an emerging standard for healthcare interoperability. While OpenMRS has been an early adopter of the FHIR standard, there is still work to do to get our FHIR implementation working properly. This project focuses on implementing support for FHIR narratives. FHIR narratives are human-readable representations of a FHIR resource. Basically, they provides a simple XHTML web fragment that includes all the relevant content. The main objective for this project is to not only create narratives for all the resources defined and handled by the OpenMRS FHIR module, but also to develop a framework which will let implementations define and specify their own templates for FHIR narratives.

Project Champions

Skills Needed

  • Some familiarity with Java
  • Familiarity with HTML / XHTML and especially HTML templating


  • Create FHIR narratives for all resources defined by OpenMRS FHIR module (Completed)
  • Develop a framework to support implementation-driven overrides for FHIR narratives (Completed)
  • Add support for localization of the generated narratives. (Completed)

Extra Credit

  • Implement search for FHIR resources using the _text parameter
  • Develop standardized class names for elements to assist front-end code with proper styling and interpretation (Completed)

Project Overview and Demonstration

Getting Started