Skip to content

Latest commit

 

History

History
35 lines (19 loc) · 2.07 KB

README.md

File metadata and controls

35 lines (19 loc) · 2.07 KB
Raw

Bahmni Reports

Hosts the reports web application for the Bahmni project

Build Status

Installing the application

  1. Clone or download this repository.

  2. Run ./mvnw clean install -DskipTests to build it

  3. Deploy the WAR file in target/bahmnireports.war

Running Integration tests

  1. Install MySQL client and server in your machine. If you already have a MySQL server available make sure that the user has the privileges to dump the database.
  2. Run: ./mvnw -DskipDump=false -DskipConfig=false clean package (note this would trigger scripts/create_configuration.sh as part of test-compile and create respective test properties under $HOME/.bahmni-reports/bahmni-reports-test.properties. You can also explicitly run scripts/create_configuration.sh to create the properties (incase if you are using IDE to run the test)
  3. This should trigger all the tests including integration (it assumes jdbc:mysql://localhost:3306/reports_integration_tests as the DB URL)

Note:

OpenMRS 2.1.6 and its corresponding schema dump is on MySql 5.6(preferred). There are breaking changes between 5.6 and 5.7

E.g. only_full_group_by is enabled by default

We are mutating global and session sql_mode as workaround to make 5.7 almost similar to 5.6. For reference check github action workflow.

SNOMED Integration Support

bahmni-reports also integrates with SNOMED for descendant-based reporting by querying the terminology server. More details can be found in this Reports documentation and also this Wiki link

Integration of Third-Party Extensions

Discover how bahmni-reports effortlessly integrates third-party extensions. Check this documentation for details.