Skip to content

E-Health/openmrs-core

 
 

Repository files navigation

OpenMRS

Build Status Coverage Status Codacy Badge

OpenMRS is a patient-based medical record system focusing on giving providers a free customizable electronic medical record system (EMR).

The mission of OpenMRS is to improve health care delivery in resource-constrained environments by coordinating a global community that creates a robust, scalable, user-driven, open source medical record system platform.

About this branch

Changes

  1. Lazy loading of patient identifiers set to false.
		<set name="identifiers" lazy="false" cascade="all-delete-orphan"
			table="patient_identifier" inverse="true" sort="natural">
			<key not-null="true" column="patient_id" />
			<one-to-many class="PatientIdentifier" />
		</set>

####Table of Contents

  1. Build
  2. Navigating the repository
  3. Software Development Kit
  4. Documentation
  1. Contributing
  1. Issues
  2. Community
  3. Support
  4. License

Build

Prerequisites

Java

OpenMRS is a Java application which is why you need to install a Java JDK.

If you want to build the master branch you will need a Java JDK of minimum version 8.

Maven

Install the build tool Maven.

You need to ensure that Maven uses the Java JDK needed for the branch you want to build.

To do so execute

mvn -version

which will tell you what version Maven is using. Refer to the Maven docs if you need to configure Maven.

Git

Install the version control tool git and clone this repository with

git clone https://github.com/openmrs/openmrs-core.git

Command

After you have taken care of the Prerequisites

Execute the following

cd openmrs-core
mvn clean package

This will generate the OpenMRS application in webapp/target/openmrs.war which you will have to deploy into an application server like for example tomcat or jetty.

Navigating the repository

The project tree is set up as follows:

api/ Java and resource files for building the java api jar file.
tools/ Meta code used during compiling and testing. Does not go into any released binary (like doclets).
web/ Java and resource files that are used in the webapp/war file.
webapp/ files used in building the war file (contains JSP files on older versions).
build.properties (deprecated) Default properties used by the deprecated ANT build.xml file.
build.xml (deprecated) ANT build file containing convenience methods into the maven build.
liquibase.build.xml ANT build file containing convenience methods to run liquibase actions.
pom.xml The main maven file used to build and package OpenMRS.

Software Development Kit

For rapid development of modules and the OpenMRS Platform code check out the awesome SDK at

https://wiki.openmrs.org/display/docs/OpenMRS+SDK

Documentation

Developer guides

If you want to contribute please refer to these resources

Wiki

If you are looking for detailed guides on how to install, configure, contribute and extend OpenMRS visit

http://wiki.openmrs.org

Website

If you are looking for more information regarding OpenMRS as an organization check

http://openmrs.org

Contributing

Contributions are very welcome, we can definitely use your help!

Code

Check out our contributing guidelines, read through the Developer guides.

After you've read up 👓 grab an introductory issue that is Ready For Work.

Translation

We use

https://www.transifex.com/openmrs/OpenMRS/

to manage our translations.

The messages.properties file in this repository is our single source of truth. It contains key, value pairs for the English language which is the default.

Transifex fetches updates to this file every night which can then be translated by you and me on transifex website itself. At any time we can pull new translations from transifex back into this repository. Other languages like for ex. Spanish will then be in the messages_es.properties file.

If you would like to know how to help with translations see

http://openmrs.org/join-the-community/translate/

Issues

If you want help fix existing issues or you found a bug and want to tell us please go to

https://issues.openmrs.org

Community

OpenMRS Talk OpenMRS IRC OpenMRS Telegram OpenMRS Wiki

Support

Talk to us on OpenMRS Talk

License

MPL 2.0 w/ HD © OpenMRS Inc.

About

OpenMRS API and web application code

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 96.2%
  • SQLPL 2.9%
  • Other 0.9%