Getting Started with Reporting
- Former user (Deleted)
- Jeremy Keiper
- Ellen Ball
- Ben Wolfe
Downloads
We encourage all OpenMRS users and developers to download the reporting module, use it frequently, create new tickets for bug fixes and feature requests, and provide feedback to dev@openmrs.org .
Requirements
Required Modules
HTML Widgets 1.5.5
Serialization XStream 0.1.8.1
Recommended modules
Reporting Compatibility 1.5.0.3
Disclaimer
The Reporting Module uses the OpenMRS Serialization API to serialize/deserialize reporting objects to/from the database. One disadvantage of using the Serialization API is that it can lead to incompatibility issues (e.g. broken reports) if the API classes are changed in a certain way.
Therefore, we cannot guarantee that all reports that you create with the Reporting Module will continue to work in subsequent releases of the module. However, we will do our best to mitigate the risk and avoid compatibility issues, or provide means to upgrade/migrate your reports gracefully.
View, download or fork source code: on GitHub
Installation
To install the Reporting Module download the Reporting Module .omod (above), along with its dependencies (see box above) and upload them into your system.
Upgrade
To upgrade from Reporting Module 0.3.x:
Check to make sure that you have all of the Required Modules installed on your system.
Double-check to make sure that you have all of the Required Modules installed on your system.
Log into OpenMRS
Navigate to Admin > Manage Modules.
Click the trash icon next to Reporting 0.3.x to remove the module from your system.
Navigate to the newer omod on your system using the browse button and click Upload.
Privileges
In order for users to be able to run most reports, you need to put them in a group with the privileges:
(this is accurate as of 0.4.1.2)
View Reports
Run Reports
View Patient Cohorts
technically this is only required if you want to be able to run reports including cohorts of patients, which is basically all reports
(up until 0.4.1.1) Manage Scheduler
To be able to edit and configure reports, you need:
(this is accurate as of 0.4.1.3)Manage Reports (this just enables you to see the menu items)
Manage Report Definitions
Manage Data Set Definitions
Manage Indicator Definitions
Manage Dimension Definitions
Manage Cohort Definitions
Manage Report Designs
You also need to grant View privileges related to the base objects your reporting definitions use. For example you need "View Programs" to create and use an "In Program" Cohort Query