Wiki Spaces


Get Help from Others

Q&A: Ask OpenMRS
Discussion: OpenMRS Talk
Real-Time: IRC Chat | Slack


Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


Several months ago, the OpenMRS developer community decided that we needed a better release process.  We agreed that we would aim to release OpenMRS twice a year, and the platform annually. Our goal was to release OpenMRS 2.1 2 by September March 2014. We just barely missed that goal, but today, in early OctoberApril, I'm happy to announce the release of OpenMRS 2.1!

This release doesn't bring many user-visible new features to the reference application (the Allergy functionality is nice!), but it has allowed us to focus on refactoring and automating our release process. And further, it gives us a chance to illustrate how an OpenMRS reference application release contains hundreds of under-the-hood improvements to modules that implementers and developers can leverage.

First, I'd like to give a special thanks to Cintia Del Rio, who contributed a huge amount to automating our module release processes, both by helping conceptualize the approach, by setting up bamboo plans, and by documenting the process. We should schedule time on a call to show the new approaches (automation is great!) and work through some last kinks (we have a lot of interdependent modules). Also, Mário Areias popped up out of nowhere to fix broken builds at odd hours just because he noticed them through CI emails, and Mark Goodrich did maven releases for me when I lost my nexus password.

I'd also like to thank Geoffrey WasilwaJames ArbaughAlexis Duque, and Lluis Martinez for answering my last-minute calls for help and getting tickets done fast.

Feature highlights from OpenMRS 2.1:

  • Allergy List (design led by Jonathan Teich, BA work by Shasha Liu, dev work by Daniel, Wyclif, Soldevelo, and others)
  • Implementation-defined forms in the new UI
  • Atlas module (summer of code work by Alexis Duque)
  • Built on OpenMRS Platform 1.10 (just released a couple weeks ago)
  • 34 Modules under the hood



OpenMRS 2.2 includes new versions of lots of modules. Some highlights of new features since OpenMRS 2.0:

  • App Framework has improvements to the context model and it's easier to apply this to URL templates
  • EMR API supports the new order entry API via the encountertransaction web resource
  • HTML Form Entry has 30 tickets, including uploading and viewing files
  • ID Gen can now generate identifiers of variable length
  • Reporting has >90 tickets closed, including Visit data sets
  • REST has 30 tickets closed, including i18n of display names, and support for the new order entry API

  • UI Commons now includes angular services for calling our REST API, and improvements to the Simple Form UI framework
  • Metadata Deploy


    (built by I-TECH for Kenya EMR) is a better way for a distribution to set up its packaged metadata

    Indeed, there is way more than I can describe here. See the Bundled Modules and Closed Issues section below.

    As always, Daniel Kayiwa

    Wyclif Luyima,  Ryan Yates, Darius JazayeriRafal KorytkowskiWyclif Luyima, Burke Mamlin, Michael Downey, and  Daniel Kayiwa, Joseph Kaweesi   and the Infrastructure Team made big contributions that would take too long to enumerate.


    Thanks to the complete list of code contributors to OpenMRS 2.12:

    Alexis Duque, Andrew Szell, Angshuman Sarkar, Aniketha Katakam, Anton Kravchenko, Arathy-mac, Benjamin Wolfe, Burke Mamlin, Cintia Del Rio Calvo, Cosmin Ioan, Damian Szafranek, Damitha Kithmal, Daniel Kayiwa, Darius Jazayeri, Deepak N, Filip Biedrzycki, Geoffrey W Wasilwa, Gitahi Ng'ang'a, Glauber Ramos, Harsha Kumara, Hemanth, Jakub Kondrat, Kaweesi Joseph, Krzysztof Kaczmarczyk, Lech Rozanski, Lee Breisacher, Lukas Breitwieser, Madawa Soysa, Marek Szukalski, Mark Goodrich, Mihir, Mike Seation, Miss Beens, Mujir Shaikh, Mário Areias, Nehashri P L, Neissi Torres Lima, Nicholas Ingosi Magaja, Nyoman Ribeka, Pamela Canchanya, Paweł Muchowski, Przemyslaw Gierszewski, Radek Puzdrowski, Radoslaw Puzdrowski, Rafal Korytkowski, Rohan Poddar, Rowan Seymour, Saptarshi Purkayastha, Shruthi Dipali, Suraj Ponugoti, Sushmitha Rao, Vinay Venu, Vinkesh Banka, Wesley Spencer See, Willa Ahmed, Wyclif Luyima, hemanths, indraneelr, Łukasz Gąsior


    ModuleVersion in OpenMRS 2.2Version in OpenMRS 2.1Notes/Issue(s)
    Allergy API Included in RA
    Allergy UI Included in RA
    App Framework See in JIRA
    App UI in RA
    Appointment Scheduling Module1.3Not IncludedSee in JIRA 
    Atlas Appointment Scheduling UI Module1.0.1Not IncludedSee in JIRA 
    Atlas2.12.1 Same
    Calculation 1.11.1Same
    Chart Search Module1.2Not IncludedSee in JIRA
    Core Apps 1.51.4 Included in RA
    Data Exchange Included in RA
    EMR API 1.61.4 See in JIRA
    Event See in JIRA
    Form Entry App 1.11.0 Included in RA
    HTML Form Entry 2.52.4 See in JIRA
    HTML Form Entry Extensions for OpenMRS 1.9 1.51.4 Included in HTML Form Entry
    HTML Form Entry UI Framework Integration 1.21.1 Included in HTML Form Entry
    HTML Widgets See in JIRA
    ID Generation See in JIRA
    Metadata Deploy 1.41.2 See in JIRA
    Metadata Mapping 
    Metadata Sharing See in JIRA
    Name Phonetics 1.41.4 Same
    OpenMRS UI Framework See in JIRA
    Provider Management 2.22.2 Same
    Reference Application (RA) See in JIRA
    Reference Demo Data (optional) Included in RA
    Reference Metadata Included in RA
    Registration App 1.21.0 
    Registration Core 
    Reporting See in JIRA
    Reporting REST 1.41.3 See in JIRA
    Rest Web Services 2.11.dae2e22.6.9 d2016 See in JIRA
    Serialization Xstream Same
    UI Commons 1.51.3 See in JIRA
    UI Library 2.0.4 

    Closed Issues in Reference Application modules

    StoryRA-417Roles and Privileges using Metadata DeployBugRA-403Export concepts preserving IDs for OpenMRS 2.1
    StoryRA-401OpenMRS 2.1 should be based on OpenMRS Platform 1.10
    BugRA-399Error when you click to "Find Patient Record": Cannot format given Object as a Date
    StoryRA-397Top-level administrative apps
    StoryRA-396Include a "sysadmin" user in the demo data
    StoryRA-393Implementation-defined forms in Reference Application
    StoryRA-392Disable Awaiting Admission app
    StoryRA-391Remove reportingui from the refapp distro
    StoryRA-390Disable Patient Relationships with a feature toggle
    EpicRA-389Create upgrade path from OpenMRS 2.0 to OpenMRS 2.14
    ImprovementRA-387Core Apps: Improve patient dashboard header to display multiple identifiers if exist for an extra patient identifier type
    BugRA-380Active Vists displays incorrectly in Firefox
    BugRA-379User session location is not updated when changed
    ImprovementRA-378Remove superfluous RA home heading
    StoryRA-375Include Atlas in OpenMRS Distribution
    ImprovementRA-363[Tech] Refactor app context model to be closer to our ideal representation
    StoryRA-362[Tech] fragment that includes and renders all extensions for an extension point
    StoryRA-356Find Patient app template in core apps should be configurable with breadcrumbs
    BugRA-351Fix Reference Metadata build
    StoryRA-347Tech Story: Add list of allergens and reactions
    BugRA-343Include Process HL7 task
    StoryRA-328Create static demo data for the reference application
    ImprovementRA-324Core Apps: EncounterDispositionTagHander: Admission disposition should not be allowed if a patient is already admitted
    ImprovementRA-322Core Apps module should not rely on the activeVisit being injected by the appui module
    EpicRA-304Implementation-defined forms should be available through the RA user interface
    StoryRA-271Modules should be able to add content to the clinician facing patient dashboard





    Download OpenMRS 2.2 at and see the implementer documentation.