Configure Reports App

Purpose and Benefits

Reporting is an essential feature of any EMR. The data that is stored in the EMR needs to be exported and analyzed. Bahmni provides a reporting module for the same. There are some standard reports that come as a part of the reporting module and the implementer also has the ability to define some custom reports.   

Configuring the Reports Module 

To configure multiple reports module refer here

Follow these steps to configure the reporting module and then run reports in Bahmni

1.  Configure reports app on home page: 

Home page of user

Go to openmrs/apps/home/extension.json of your config and add the code snippet below:

"reports": {
  "id": "bahmni.reports",
  "extensionPointId": "org.bahmni.home.dashboard",
  "type": "link",
  "translationKey": "MODULE_LABEL_REPORTS_KEY",
  "url": "../reports/#/dashboard",
  "icon": "fa-user",
  "order": 8,
  "requiredPrivilege": "app:reports"

Key Fields 

These are the attributes of the above configuration


Specific Id for reports app.

"extensionPointId"Needed for configuring the reports.Yes
"type"Making reports app link on home page.Yes
Show name in particular locale used by app.Yes
To redirect to reports page.Yes
To display icon.No
Display in specific order.No
This is needed privilege for displaying reports module.Yes

When two factor authentication is enabled, add 'bypass2fa' role to reports-user in openmrs to aviod authentication problems while running reports.

Reports SSL certificate configuration:

   This configures reports application to accept trusted or untrusted SSL certificates when fetching reports.json file from httpd server. 

Default Behaviour

By default, all the SSL certificates are trusted.

Overriding the default behaviour

Default behaviour of reports can be overriden  by reconfiguring the following property in file located at /etc/bahmni-reports/ directory


In this case if the ssl certificate is untrusted, reports will be queued, but will not be generated, instead shows status as "Error"

Reports Queue

More information of Report Queue feature can be found at Report Management

Default Behaviour

By default, Report Queue feature is disabled.

Overriding the default behaviour

Default behaviour of reports can be overridden  by reconfiguring following property value from app.json file found in /bahmni_config/openmrs/apps/reports folder

"enableReportQueue": true

On this Page

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