OCL (Dictionary manager) for Bahmni



Integrate OCL and Bahmni to improve metadata management

Due date


Key outcomes



Problem Statement

Terminology management has been a long-standing problem with Bahmni implementations that wanted to share the same concept dictionary and wanted to standardize their data collection and reporting across implementations. Since every installation is free to create its own concepts in isolation, this approach also leads to a lot of chaos. Over the years, several methods for sharing concepts have been created, but none of them have made it easy to follow best practices or led to large-scale adoption of concept sharing. OCL provides a way for the facilities to manage their concepts in a shared service on the web and create a shared concept dictionary.

OCL for OpenMRS is a work-in-progress project (documented here). Since Bahmni uses OpenMRS' concept dictionary and data model, we believe that Bahmni can leverage the OCL for OpenMRS with minimum work required on top of it.


Documented here


  1. MSF team is already working on incorporating OCL into Bahmni

  2. On the Bahmni/OpenMRS side, it only requires installing Openmrs-module-openconceptlab OMOD in Bahmni

  3. The organization/hospital needs to signup on the OCL website and generate an API token and add the API token to the OCL module in the OpenMRS admin of Bahmni to make it work

  4. OCL for OpenMRS supports the OpenMRS Initializer module for implementations that have bad or no internet and work offline on a local network.

Analysis Document (WIP)

  1. This document for OCL Setup with Bahmni, and certain challenges with Bahmni-OCL integration / concept data setups.

  2. this document (older) for the gap analysis.

How can I contribute

If you have a good understanding of OCL or Bahmni Concepts or Terminology Management (SNOMED, ICD10, LOINC, etc) and are interested in how Bahmni terminology management workflow can look like, please ping us on Slack and we will connect with you.


Channel: #bahmni-india-distro (Slack)

Reference materials

The Bahmni documentation is licensed under Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)