From 853660f26d8b6ac94a5880cef60bf9fee9e6aa09 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 6 May 2024 21:36:33 +0300
Subject: [PATCH 001/163] maven(deps): bump jacksonVersion from 2.17.0 to
 2.17.1 (#4629)

Bumps `jacksonVersion` from 2.17.0 to 2.17.1.

Updates `com.fasterxml.jackson.core:jackson-core` from 2.17.0 to 2.17.1
- [Commits](https://github.com/FasterXML/jackson-core/compare/jackson-core-2.17.0...jackson-core-2.17.1)

Updates `com.fasterxml.jackson.core:jackson-annotations` from 2.17.0 to 2.17.1
- [Commits](https://github.com/FasterXML/jackson/commits)

Updates `com.fasterxml.jackson.core:jackson-databind` from 2.17.0 to 2.17.1
- [Commits](https://github.com/FasterXML/jackson/commits)

Updates `com.fasterxml.jackson.datatype:jackson-datatype-jsr310` from 2.17.0 to 2.17.1

---
updated-dependencies:
- dependency-name: com.fasterxml.jackson.core:jackson-core
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: com.fasterxml.jackson.core:jackson-annotations
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: com.fasterxml.jackson.core:jackson-databind
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: com.fasterxml.jackson.datatype:jackson-datatype-jsr310
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index d6a75efce9c9..fb326cf3892a 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1211,7 +1211,7 @@
 		<hibernateSearchVersion>5.11.12.Final</hibernateSearchVersion>
 		<luceneVersion>5.5.5</luceneVersion>
 		<aspectjVersion>1.9.22</aspectjVersion>
-		<jacksonVersion>2.17.0</jacksonVersion>
+		<jacksonVersion>2.17.1</jacksonVersion>
 		<junitVersion>5.10.2</junitVersion>
 		<mockitoVersion>3.12.4</mockitoVersion>
 		<hamcrestVersion>2.2</hamcrestVersion>

From d31b072afb50fca908eca3bb61e13e5646bf8192 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 8 May 2024 22:46:36 +0300
Subject: [PATCH 002/163] maven(deps): bump net.bytebuddy:byte-buddy from
 1.14.14 to 1.14.15 (#4632)

Bumps [net.bytebuddy:byte-buddy](https://github.com/raphw/byte-buddy) from 1.14.14 to 1.14.15.
- [Release notes](https://github.com/raphw/byte-buddy/releases)
- [Changelog](https://github.com/raphw/byte-buddy/blob/master/release-notes.md)
- [Commits](https://github.com/raphw/byte-buddy/compare/byte-buddy-1.14.14...byte-buddy-1.14.15)

---
updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index fb326cf3892a..343821f30318 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1124,7 +1124,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy</artifactId>
-						<version>1.14.14</version>
+						<version>1.14.15</version>
 					</dependency>
 					<dependency>
 						<groupId>net.bytebuddy</groupId>

From 6eb52c9a18b78593cadd53a12be61868128551a0 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 8 May 2024 22:47:50 +0300
Subject: [PATCH 003/163] maven(deps): bump net.bytebuddy:byte-buddy-agent from
 1.14.14 to 1.14.15 (#4633)

Bumps [net.bytebuddy:byte-buddy-agent](https://github.com/raphw/byte-buddy) from 1.14.14 to 1.14.15.
- [Release notes](https://github.com/raphw/byte-buddy/releases)
- [Changelog](https://github.com/raphw/byte-buddy/blob/master/release-notes.md)
- [Commits](https://github.com/raphw/byte-buddy/compare/byte-buddy-1.14.14...byte-buddy-1.14.15)

---
updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy-agent
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 343821f30318..8c2737ddbc62 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1129,7 +1129,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy-agent</artifactId>
-						<version>1.14.14</version>
+						<version>1.14.15</version>
 					</dependency>
 				</dependencies>
 			</dependencyManagement>

From 857bcd1bbe781aed221f79eb2c5ec389ed4a283d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 9 May 2024 22:00:33 +0300
Subject: [PATCH 004/163] maven(deps-dev): bump org.testcontainers:mysql from
 1.19.7 to 1.19.8 (#4634)

Bumps [org.testcontainers:mysql](https://github.com/testcontainers/testcontainers-java) from 1.19.7 to 1.19.8.
- [Release notes](https://github.com/testcontainers/testcontainers-java/releases)
- [Changelog](https://github.com/testcontainers/testcontainers-java/blob/main/CHANGELOG.md)
- [Commits](https://github.com/testcontainers/testcontainers-java/compare/1.19.7...1.19.8)

---
updated-dependencies:
- dependency-name: org.testcontainers:mysql
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 8c2737ddbc62..96da084468f8 100644
--- a/pom.xml
+++ b/pom.xml
@@ -580,7 +580,7 @@
 			<dependency>
 				<groupId>org.testcontainers</groupId>
 				<artifactId>mysql</artifactId>
-				<version>1.19.7</version>
+				<version>1.19.8</version>
 				<scope>test</scope>
 			</dependency>
 			<dependency>

From b9e1542bc994a0a5323e727c19305a6429d84098 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 9 May 2024 22:01:02 +0300
Subject: [PATCH 005/163] maven(deps-dev): bump org.testcontainers:postgresql
 (#4635)

Bumps [org.testcontainers:postgresql](https://github.com/testcontainers/testcontainers-java) from 1.19.7 to 1.19.8.
- [Release notes](https://github.com/testcontainers/testcontainers-java/releases)
- [Changelog](https://github.com/testcontainers/testcontainers-java/blob/main/CHANGELOG.md)
- [Commits](https://github.com/testcontainers/testcontainers-java/compare/1.19.7...1.19.8)

---
updated-dependencies:
- dependency-name: org.testcontainers:postgresql
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 96da084468f8..3c9239a0de5d 100644
--- a/pom.xml
+++ b/pom.xml
@@ -586,7 +586,7 @@
 			<dependency>
 				<groupId>org.testcontainers</groupId>
 				<artifactId>postgresql</artifactId>
-				<version>1.19.7</version>
+				<version>1.19.8</version>
 				<scope>test</scope>
 			</dependency>
 		</dependencies>

From 9369eee6361b5a79eaff2762b55dfb9dc64574b8 Mon Sep 17 00:00:00 2001
From: rkorytkowski <rafal.korytkowski@gmail.com>
Date: Fri, 10 May 2024 14:57:19 +0200
Subject: [PATCH 006/163] TRUNK-6234 Provide JDK 11 and JDK 18 docker images

---
 Dockerfile | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/Dockerfile b/Dockerfile
index 08955eee9daf..bfa6b81ba0ae 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -9,7 +9,8 @@
 #	graphic logo is a trademark of OpenMRS Inc.
 
 ### Compile Stage (platform-agnostic)
-FROM --platform=$BUILDPLATFORM maven:3.8-amazoncorretto-8 as compile
+ARG DEV_JDK=amazoncorretto-8
+FROM --platform=$BUILDPLATFORM maven:3.8-$DEV_JDK as compile
 
 RUN yum -y update && yum -y install git && yum clean all
 
@@ -46,7 +47,7 @@ ARG MVN_ARGS='clean install -DskipTests'
 RUN mvn $MVN_SETTINGS $MVN_ARGS
 
 ### Development Stage
-FROM maven:3.8-amazoncorretto-8 as dev
+FROM maven:3.8-$DEV_JDK as dev
 
 RUN yum -y update && yum -y install tar gzip git && yum clean all
 
@@ -92,7 +93,8 @@ ENTRYPOINT ["/usr/bin/tini", "--", "/usr/local/bin/mvn-entrypoint.sh"]
 CMD ["/openmrs/startup-dev.sh"]
 
 ### Production Stage
-FROM tomcat:8.5-jdk8-corretto
+ARG RUNTIME_JDK=jdk8-corretto
+FROM tomcat:8.5-$RUNTIME_JDK
 
 RUN yum -y update && yum clean all && rm -rf /usr/local/tomcat/webapps/*
 

From 6c99763fd5d1024fdb093c75e3504b49372f28d9 Mon Sep 17 00:00:00 2001
From: rkorytkowski <rafal.korytkowski@gmail.com>
Date: Fri, 10 May 2024 15:55:14 +0200
Subject: [PATCH 007/163] TRUNK-6234 Provide JDK 11 and JDK 18 docker images,
 fix

---
 Dockerfile | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/Dockerfile b/Dockerfile
index bfa6b81ba0ae..0a5fd157ea85 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -8,8 +8,10 @@
 #	Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS 
 #	graphic logo is a trademark of OpenMRS Inc.
 
-### Compile Stage (platform-agnostic)
 ARG DEV_JDK=amazoncorretto-8
+ARG RUNTIME_JDK=jdk8-corretto
+
+### Compile Stage (platform-agnostic)
 FROM --platform=$BUILDPLATFORM maven:3.8-$DEV_JDK as compile
 
 RUN yum -y update && yum -y install git && yum clean all
@@ -93,7 +95,6 @@ ENTRYPOINT ["/usr/bin/tini", "--", "/usr/local/bin/mvn-entrypoint.sh"]
 CMD ["/openmrs/startup-dev.sh"]
 
 ### Production Stage
-ARG RUNTIME_JDK=jdk8-corretto
 FROM tomcat:8.5-$RUNTIME_JDK
 
 RUN yum -y update && yum clean all && rm -rf /usr/local/tomcat/webapps/*

From 982882722b155da4d86a4b964a0f4dd6cf01fa5f Mon Sep 17 00:00:00 2001
From: rkorytkowski <rafal.korytkowski@gmail.com>
Date: Fri, 10 May 2024 16:09:45 +0200
Subject: [PATCH 008/163] TRUNK-6234 Adding build config for dev

---
 bamboo-specs/bamboo.yml | 56 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)

diff --git a/bamboo-specs/bamboo.yml b/bamboo-specs/bamboo.yml
index 7c6f41526773..1c04118cf6cc 100644
--- a/bamboo-specs/bamboo.yml
+++ b/bamboo-specs/bamboo.yml
@@ -23,6 +23,8 @@ stages:
           jobs:
               - Deploy to maven
               - Deploy to docker
+              - Deploy to docker JDK 11
+              - Deploy to docker JDK 17
     - Release:
           manual: true
           final: false
@@ -152,6 +154,60 @@ Deploy to docker:
                           --build-arg MVN_ARGS="clean install -DskipTests" -t ${IMAGE_NIGHTLY}  .
               description: Deploy to docker
     artifact-subscriptions: []
+Deploy to docker JDK 11:
+    key: DTD
+    tasks:
+        - checkout:
+              force-clean-build: 'false'
+              description: Checkout source
+        - script:
+              interpreter: SHELL
+              scripts:
+                  - |-
+                      #!/bin/bash -eux
+                      
+                      set +x
+                      
+                      export IMAGE_NIGHTLY=${bamboo.docker.image.name}:${bamboo.docker.image.tag}-amazoncorretto-11
+                      export IMAGE_DEV=${bamboo.docker.image.name}:dev-amazoncorretto-11
+                      
+                      docker login -u ${bamboo.dockerhub.username} -p ${bamboo.dockerhub.password}
+                      
+                      docker buildx build --pull --push --platform ${bamboo.docker.image.platforms} \
+                          --cache-to=type=registry,mode=max,ref=${IMAGE_NIGHTLY}-cache \
+                          --cache-from=${IMAGE_NIGHTLY}-cache \
+                          --build-arg MVN_ARGS="clean install -DskipTests" \
+                          --build-arg DEV_JDK="amazoncorretto-11" \
+                          -t ${IMAGE_NIGHTLY} -t ${IMAGE_DEV} .
+              description: Deploy to docker
+    artifact-subscriptions: []
+Deploy to docker JDK 17:
+    key: DTD
+    tasks:
+        - checkout:
+              force-clean-build: 'false'
+              description: Checkout source
+        - script:
+              interpreter: SHELL
+              scripts:
+                  - |-
+                      #!/bin/bash -eux
+                      
+                      set +x
+                      
+                      export IMAGE_NIGHTLY=${bamboo.docker.image.name}:${bamboo.docker.image.tag}-amazoncorretto-17
+                      export IMAGE_DEV=${bamboo.docker.image.name}:dev-amazoncorretto-17
+                      
+                      docker login -u ${bamboo.dockerhub.username} -p ${bamboo.dockerhub.password}
+                      
+                      docker buildx build --pull --push --platform ${bamboo.docker.image.platforms} \
+                          --cache-to=type=registry,mode=max,ref=${IMAGE_NIGHTLY}-cache \
+                          --cache-from=${IMAGE_NIGHTLY}-cache \
+                          --build-arg MVN_ARGS="clean install -DskipTests" \
+                          --build-arg DEV_JDK="amazoncorretto-17" \
+                          -t ${IMAGE_NIGHTLY} -t ${IMAGE_DEV} .
+              description: Deploy to docker
+    artifact-subscriptions: []
 Release:
     key: RTD
     tasks:

From 7d70503404031469b8e3fa98cc4dd39edb38e0c8 Mon Sep 17 00:00:00 2001
From: rkorytkowski <rafal.korytkowski@gmail.com>
Date: Fri, 10 May 2024 16:10:29 +0200
Subject: [PATCH 009/163] TRUNK-6234 Adding build config for dev, fix

---
 bamboo-specs/bamboo.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bamboo-specs/bamboo.yml b/bamboo-specs/bamboo.yml
index 1c04118cf6cc..546f68305d8a 100644
--- a/bamboo-specs/bamboo.yml
+++ b/bamboo-specs/bamboo.yml
@@ -155,7 +155,7 @@ Deploy to docker:
               description: Deploy to docker
     artifact-subscriptions: []
 Deploy to docker JDK 11:
-    key: DTD
+    key: DTD11
     tasks:
         - checkout:
               force-clean-build: 'false'
@@ -182,7 +182,7 @@ Deploy to docker JDK 11:
               description: Deploy to docker
     artifact-subscriptions: []
 Deploy to docker JDK 17:
-    key: DTD
+    key: DTD17
     tasks:
         - checkout:
               force-clean-build: 'false'

From 0060a1d80b91658bb2fbe381daff4e0a5919392f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 12 May 2024 23:41:25 +0300
Subject: [PATCH 010/163] github-actions(deps): bump ossf/scorecard-action from
 2.3.1 to 2.3.3 (#4636)

Bumps [ossf/scorecard-action](https://github.com/ossf/scorecard-action) from 2.3.1 to 2.3.3.
- [Release notes](https://github.com/ossf/scorecard-action/releases)
- [Changelog](https://github.com/ossf/scorecard-action/blob/main/RELEASE.md)
- [Commits](https://github.com/ossf/scorecard-action/compare/v2.3.1...v2.3.3)

---
updated-dependencies:
- dependency-name: ossf/scorecard-action
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/scorecard.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/scorecard.yml b/.github/workflows/scorecard.yml
index 780f18af8f24..d61d7aa8b491 100644
--- a/.github/workflows/scorecard.yml
+++ b/.github/workflows/scorecard.yml
@@ -32,7 +32,7 @@ jobs:
           persist-credentials: false
 
       - name: "Run analysis"
-        uses: ossf/scorecard-action@v2.3.1
+        uses: ossf/scorecard-action@v2.3.3
         with:
           results_file: results.sarif
           results_format: sarif

From e962f22be8ec4f02998e0f13b7918b792de71dcf Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 14 May 2024 12:25:24 +0300
Subject: [PATCH 011/163] maven(deps): bump aspectjVersion from 1.9.22 to
 1.9.22.1 (#4638)

Bumps `aspectjVersion` from 1.9.22 to 1.9.22.1.

Updates `org.aspectj:aspectjrt` from 1.9.22 to 1.9.22.1
- [Release notes](https://github.com/eclipse/org.aspectj/releases)
- [Commits](https://github.com/eclipse/org.aspectj/commits)

Updates `org.aspectj:aspectjweaver` from 1.9.22 to 1.9.22.1
- [Release notes](https://github.com/eclipse/org.aspectj/releases)
- [Commits](https://github.com/eclipse/org.aspectj/commits)

---
updated-dependencies:
- dependency-name: org.aspectj:aspectjrt
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: org.aspectj:aspectjweaver
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 3c9239a0de5d..e07522d4e2f7 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1210,7 +1210,7 @@
 		<hibernateVersion>5.6.15.Final</hibernateVersion>
 		<hibernateSearchVersion>5.11.12.Final</hibernateSearchVersion>
 		<luceneVersion>5.5.5</luceneVersion>
-		<aspectjVersion>1.9.22</aspectjVersion>
+		<aspectjVersion>1.9.22.1</aspectjVersion>
 		<jacksonVersion>2.17.1</jacksonVersion>
 		<junitVersion>5.10.2</junitVersion>
 		<mockitoVersion>3.12.4</mockitoVersion>

From 1018560da6025eaaa3d611206abc666ded18d4a0 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 20 May 2024 22:53:38 +0300
Subject: [PATCH 012/163] --- (#4643)

updated-dependencies:
- dependency-name: org.codehaus.mojo:build-helper-maven-plugin
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index e07522d4e2f7..a49e9aee2871 100644
--- a/pom.xml
+++ b/pom.xml
@@ -660,7 +660,7 @@
 				<plugin>
 					<groupId>org.codehaus.mojo</groupId>
 					<artifactId>build-helper-maven-plugin</artifactId>
-					<version>3.5.0</version>
+					<version>3.6.0</version>
 				</plugin>
 				<plugin>
 					<groupId>com.googlecode.maven-java-formatter-plugin</groupId>

From 0102f60d99c10c853cbbbbcab9a46fc61c54e2a9 Mon Sep 17 00:00:00 2001
From: Ian <52504170+ibacher@users.noreply.github.com>
Date: Tue, 21 May 2024 16:22:10 -0400
Subject: [PATCH 013/163] Update to Tomcat 9

---
 Dockerfile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Dockerfile b/Dockerfile
index 0a5fd157ea85..ad00abcba1ad 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -95,7 +95,7 @@ ENTRYPOINT ["/usr/bin/tini", "--", "/usr/local/bin/mvn-entrypoint.sh"]
 CMD ["/openmrs/startup-dev.sh"]
 
 ### Production Stage
-FROM tomcat:8.5-$RUNTIME_JDK
+FROM tomcat:9-$RUNTIME_JDK
 
 RUN yum -y update && yum clean all && rm -rf /usr/local/tomcat/webapps/*
 

From 84d5db5d5c9d9bab06d2d5ed5fca08a8e846e082 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 22 May 2024 23:08:10 +0300
Subject: [PATCH 014/163] --- (#4647)

updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index a49e9aee2871..c8d5a8f881b3 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1124,7 +1124,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy</artifactId>
-						<version>1.14.15</version>
+						<version>1.14.16</version>
 					</dependency>
 					<dependency>
 						<groupId>net.bytebuddy</groupId>

From 00b99cf2c9e83c28c174bff95ae77aea6e877bc1 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 22 May 2024 23:08:44 +0300
Subject: [PATCH 015/163] --- (#4648)

updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy-agent
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index c8d5a8f881b3..9874b04c550c 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1129,7 +1129,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy-agent</artifactId>
-						<version>1.14.15</version>
+						<version>1.14.16</version>
 					</dependency>
 				</dependencies>
 			</dependencyManagement>

From 28b69bddc2804f61b1efd2046ef491231b4b70f4 Mon Sep 17 00:00:00 2001
From: rkorytkowski <rafal.korytkowski@gmail.com>
Date: Tue, 28 May 2024 11:06:20 +0200
Subject: [PATCH 016/163] TRUNK-6234 Adding release config

---
 bamboo-specs/bamboo.yml | 148 ++++++++++++++++++++++++++++++++++++----
 1 file changed, 134 insertions(+), 14 deletions(-)

diff --git a/bamboo-specs/bamboo.yml b/bamboo-specs/bamboo.yml
index 546f68305d8a..64653f550029 100644
--- a/bamboo-specs/bamboo.yml
+++ b/bamboo-specs/bamboo.yml
@@ -30,6 +30,12 @@ stages:
           final: false
           jobs:
               - Release
+    - Release image variants:
+          manual: false
+          final: false
+          jobs:
+              - Release JDK 11 image
+              - Release JDK 17 image
 Build:
     key: BUIL
     tasks:
@@ -168,17 +174,31 @@ Deploy to docker JDK 11:
                       
                       set +x
                       
-                      export IMAGE_NIGHTLY=${bamboo.docker.image.name}:${bamboo.docker.image.tag}-amazoncorretto-11
-                      export IMAGE_DEV=${bamboo.docker.image.name}:dev-amazoncorretto-11
+                      export JDK_IMAGE="amazoncorretto-11"
+                      export RUNTIME_JDK="jdk8-corretto"
+                      
+                      export IMAGE_NIGHTLY=${bamboo.docker.image.name}:${bamboo.docker.image.tag}-${JDK_IMAGE}
+                      export IMAGE_DEV=${bamboo.docker.image.name}:dev-${JDK_IMAGE}
                       
                       docker login -u ${bamboo.dockerhub.username} -p ${bamboo.dockerhub.password}
                       
                       docker buildx build --pull --push --platform ${bamboo.docker.image.platforms} \
-                          --cache-to=type=registry,mode=max,ref=${IMAGE_NIGHTLY}-cache \
-                          --cache-from=${IMAGE_NIGHTLY}-cache \
-                          --build-arg MVN_ARGS="clean install -DskipTests" \
-                          --build-arg DEV_JDK="amazoncorretto-11" \
-                          -t ${IMAGE_NIGHTLY} -t ${IMAGE_DEV} .
+                        --target dev \
+                        --cache-to=type=registry,mode=max,ref=${IMAGE_DEV}-cache \
+                        --cache-from=${IMAGE_DEV}-cache \
+                        --build-arg MVN_ARGS="clean install -DskipTests" \
+                        --build-arg DEV_JDK="${JDK_IMAGE}" \
+                        --build-arg RUNTIME_JDK="${RUNTIME_JDK}" \
+                        -t ${IMAGE_DEV} .
+                      
+                      docker buildx build --pull --push --platform ${bamboo.docker.image.platforms} \
+                        --cache-to=type=registry,mode=max,ref=${IMAGE_NIGHTLY}-cache \
+                        --cache-from=${IMAGE_DEV}-cache \
+                        --cache-from=${IMAGE_NIGHTLY}-cache \
+                        --build-arg MVN_ARGS="clean install -DskipTests" \
+                        --build-arg DEV_JDK="${JDK_IMAGE}" \
+                        --build-arg RUNTIME_JDK="${RUNTIME_JDK}" \
+                        -t ${IMAGE_NIGHTLY} .
               description: Deploy to docker
     artifact-subscriptions: []
 Deploy to docker JDK 17:
@@ -195,17 +215,31 @@ Deploy to docker JDK 17:
                       
                       set +x
                       
-                      export IMAGE_NIGHTLY=${bamboo.docker.image.name}:${bamboo.docker.image.tag}-amazoncorretto-17
-                      export IMAGE_DEV=${bamboo.docker.image.name}:dev-amazoncorretto-17
+                      export JDK_IMAGE="amazoncorretto-17"
+                      export RUNTIME_JDK="jdk17-corretto"
+                      
+                      export IMAGE_NIGHTLY=${bamboo.docker.image.name}:${bamboo.docker.image.tag}-${JDK_IMAGE}
+                      export IMAGE_DEV=${bamboo.docker.image.name}:dev-${JDK_IMAGE}
                       
                       docker login -u ${bamboo.dockerhub.username} -p ${bamboo.dockerhub.password}
                       
                       docker buildx build --pull --push --platform ${bamboo.docker.image.platforms} \
-                          --cache-to=type=registry,mode=max,ref=${IMAGE_NIGHTLY}-cache \
-                          --cache-from=${IMAGE_NIGHTLY}-cache \
-                          --build-arg MVN_ARGS="clean install -DskipTests" \
-                          --build-arg DEV_JDK="amazoncorretto-17" \
-                          -t ${IMAGE_NIGHTLY} -t ${IMAGE_DEV} .
+                        --target dev \
+                        --cache-to=type=registry,mode=max,ref=${IMAGE_DEV}-cache \
+                        --cache-from=${IMAGE_DEV}-cache \
+                        --build-arg MVN_ARGS="clean install -DskipTests" \
+                        --build-arg DEV_JDK="${JDK_IMAGE}" \
+                        --build-arg RUNTIME_JDK="${RUNTIME_JDK}" \
+                        -t ${IMAGE_DEV} .
+                      
+                      docker buildx build --pull --push --platform ${bamboo.docker.image.platforms} \
+                        --cache-to=type=registry,mode=max,ref=${IMAGE_NIGHTLY}-cache \
+                        --cache-from=${IMAGE_DEV}-cache \
+                        --cache-from=${IMAGE_NIGHTLY}-cache \
+                        --build-arg MVN_ARGS="clean install -DskipTests" \
+                        --build-arg DEV_JDK="${JDK_IMAGE}" \
+                        --build-arg RUNTIME_JDK="${RUNTIME_JDK}" \
+                        -t ${IMAGE_NIGHTLY} .
               description: Deploy to docker
     artifact-subscriptions: []
 Release:
@@ -290,6 +324,92 @@ Release:
                   variableScope: PLAN
               description: Save next release version
     artifact-subscriptions: []
+Release JDK 11 image:
+    key: RTD11
+    tasks:
+        - checkout:
+              force-clean-build: 'false'
+              description: Checkout Default Repository
+        - script:
+              interpreter: SHELL
+              scripts:
+                  - |-
+                      #!/bin/bash -eux
+                      
+                      set +x
+                      
+                      export OMRS_VERSION=${bamboo.maven.release.version}
+                      export IMAGE_NIGHTLY=${bamboo.docker.image.name}:${bamboo.docker.image.tag}-${JDK_IMAGE}
+                      
+                      export IMAGE=${bamboo.docker.image.name}:${OMRS_VERSION}
+                      export DEV_IMAGE=${bamboo.docker.image.name}:${OMRS_VERSION}-dev
+                      export JDK_IMAGE="amazoncorretto-11"
+                      export RUNTIME_JDK="jdk11-corretto"
+                      
+                      docker login -u ${bamboo.dockerhub.username} -p ${bamboo.dockerhub.password}
+                      
+                      echo "Checkout the release version"
+                      git checkout ${OMRS_VERSION}
+                      
+                      docker buildx build --pull --push --platform ${bamboo.docker.image.platforms} \
+                      --cache-from ${DEV_IMAGE}-${JDK_IMAGE}-cache \
+                      --target dev \
+                      --build-arg DEV_JDK="${JDK_IMAGE}" \
+                      --build-arg RUNTIME_JDK="${RUNTIME_JDK}" \
+                      --build-arg MVN_ARGS="clean install -DskipTests" -t ${DEV_IMAGE}-${JDK_IMAGE} .
+                      
+                      echo "Building the production image"
+                      docker buildx build --pull --push --platform ${bamboo.docker.image.platforms} \
+                      --cache-from ${DEV_IMAGE}-${JDK_IMAGE}-cache \
+                      --build-arg DEV_JDK="${JDK_IMAGE}" \
+                      --build-arg RUNTIME_JDK="${RUNTIME_JDK}" \
+                      --build-arg MVN_ARGS="clean install -DskipTests" -t ${IMAGE}-${JDK_IMAGE} .
+                      
+              description: Build and push JDK 11 images
+    artifact-subscriptions: []
+Release JDK 17 image:
+    key: RTD17
+    tasks:
+        - checkout:
+              force-clean-build: 'false'
+              description: Checkout Default Repository
+        - script:
+              interpreter: SHELL
+              scripts:
+                  - |-
+                      #!/bin/bash -eux
+                      
+                      set +x
+                      
+                      export OMRS_VERSION=${bamboo.maven.release.version}
+                      export IMAGE_NIGHTLY=${bamboo.docker.image.name}:${bamboo.docker.image.tag}-${JDK_IMAGE}
+                      
+                      export IMAGE=${bamboo.docker.image.name}:${OMRS_VERSION}
+                      export DEV_IMAGE=${bamboo.docker.image.name}:${OMRS_VERSION}-dev
+                      export JDK_IMAGE="amazoncorretto-17"
+                      export RUNTIME_JDK="jdk17-corretto"
+                      
+                      docker login -u ${bamboo.dockerhub.username} -p ${bamboo.dockerhub.password}
+                      
+                      echo "Checkout the release version"
+                      git checkout ${OMRS_VERSION}
+                      
+                      docker buildx build --pull --push --platform ${bamboo.docker.image.platforms} \
+                      --cache-from ${DEV_IMAGE}-${JDK_IMAGE}-cache \
+                      --target dev \
+                      --build-arg DEV_JDK="${JDK_IMAGE}" \
+                      --build-arg RUNTIME_JDK="${RUNTIME_JDK}" \
+                      --build-arg MVN_ARGS="clean install -DskipTests" -t ${DEV_IMAGE}-${JDK_IMAGE} .
+                      
+                      echo "Building the production image"
+                      docker buildx build --pull --push --platform ${bamboo.docker.image.platforms} \
+                      --cache-from ${DEV_IMAGE}-${JDK_IMAGE}-cache \
+                      --build-arg DEV_JDK="${JDK_IMAGE}" \
+                      --build-arg RUNTIME_JDK="${RUNTIME_JDK}" \
+                      --build-arg MVN_ARGS="clean install -DskipTests" -t ${IMAGE}-${JDK_IMAGE} .
+              
+              description: Build and push JDK 17 images
+    artifact-subscriptions: []
 variables:
     docker.image.name: openmrs/openmrs-core
     docker.image.tag: nightly

From b289591149e21822bf0e88c52522de88adc3118d Mon Sep 17 00:00:00 2001
From: rkorytkowski <rafal.korytkowski@gmail.com>
Date: Tue, 28 May 2024 11:44:15 +0200
Subject: [PATCH 017/163] TRUNK-6234 Fixing runtime jdk11

---
 bamboo-specs/bamboo.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bamboo-specs/bamboo.yml b/bamboo-specs/bamboo.yml
index 64653f550029..5787c46261c2 100644
--- a/bamboo-specs/bamboo.yml
+++ b/bamboo-specs/bamboo.yml
@@ -175,7 +175,7 @@ Deploy to docker JDK 11:
                       set +x
                       
                       export JDK_IMAGE="amazoncorretto-11"
-                      export RUNTIME_JDK="jdk8-corretto"
+                      export RUNTIME_JDK="jdk11-corretto"
                       
                       export IMAGE_NIGHTLY=${bamboo.docker.image.name}:${bamboo.docker.image.tag}-${JDK_IMAGE}
                       export IMAGE_DEV=${bamboo.docker.image.name}:dev-${JDK_IMAGE}

From a8ab02db43bc886764964d00b3642589ee8547fb Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 29 May 2024 23:08:01 +0300
Subject: [PATCH 018/163] maven(deps): bump net.bytebuddy:byte-buddy-agent from
 1.14.16 to 1.14.17 (#4651)

Bumps [net.bytebuddy:byte-buddy-agent](https://github.com/raphw/byte-buddy) from 1.14.16 to 1.14.17.
- [Release notes](https://github.com/raphw/byte-buddy/releases)
- [Changelog](https://github.com/raphw/byte-buddy/blob/master/release-notes.md)
- [Commits](https://github.com/raphw/byte-buddy/compare/byte-buddy-1.14.16...byte-buddy-1.14.17)

---
updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy-agent
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 9874b04c550c..4a9f426be423 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1129,7 +1129,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy-agent</artifactId>
-						<version>1.14.16</version>
+						<version>1.14.17</version>
 					</dependency>
 				</dependencies>
 			</dependencyManagement>

From 4ea3471fc5affde52b3c3b58da5b92ee2ec32b81 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 29 May 2024 23:41:58 +0300
Subject: [PATCH 019/163] maven(deps): bump net.bytebuddy:byte-buddy from
 1.14.16 to 1.14.17 (#4653)

Bumps [net.bytebuddy:byte-buddy](https://github.com/raphw/byte-buddy) from 1.14.16 to 1.14.17.
- [Release notes](https://github.com/raphw/byte-buddy/releases)
- [Changelog](https://github.com/raphw/byte-buddy/blob/master/release-notes.md)
- [Commits](https://github.com/raphw/byte-buddy/compare/byte-buddy-1.14.16...byte-buddy-1.14.17)

---
updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 4a9f426be423..ba6b68f867d1 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1124,7 +1124,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy</artifactId>
-						<version>1.14.16</version>
+						<version>1.14.17</version>
 					</dependency>
 					<dependency>
 						<groupId>net.bytebuddy</groupId>

From 7b3bb535e6324f47e698aca31cb4967490b4acb7 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 29 May 2024 23:49:27 +0300
Subject: [PATCH 020/163] maven(deps): bump commons-validator:commons-validator
 (#4652)

Bumps commons-validator:commons-validator from 1.8.0 to 1.9.0.

---
updated-dependencies:
- dependency-name: commons-validator:commons-validator
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index ba6b68f867d1..338687348991 100644
--- a/pom.xml
+++ b/pom.xml
@@ -528,7 +528,7 @@
 			<dependency>
 			    <groupId>commons-validator</groupId>
 			    <artifactId>commons-validator</artifactId>
-			    <version>1.8.0</version>
+			    <version>1.9.0</version>
 			</dependency>
 			<dependency>
 				<groupId>org.aspectj</groupId>

From d5f53efa6d1121f4ed0ac7199ff77a43acab90e2 Mon Sep 17 00:00:00 2001
From: Wikum Weerakutti <wikum@linuxdeveloper.space>
Date: Fri, 31 May 2024 01:35:57 +0530
Subject: [PATCH 021/163] TRUNK-6240: Field Answer - Switching from Hibernate
 Mapping to JPA annotations (#4645)

---
 .../main/java/org/openmrs/FieldAnswer.java    | 23 +++++-
 api/src/main/resources/hibernate.cfg.xml      |  1 -
 .../api/db/hibernate/FieldAnswer.hbm.xml      | 75 -------------------
 3 files changed, 21 insertions(+), 78 deletions(-)
 delete mode 100644 api/src/main/resources/org/openmrs/api/db/hibernate/FieldAnswer.hbm.xml

diff --git a/api/src/main/java/org/openmrs/FieldAnswer.java b/api/src/main/java/org/openmrs/FieldAnswer.java
index 30e54d131838..d426c8d874ba 100644
--- a/api/src/main/java/org/openmrs/FieldAnswer.java
+++ b/api/src/main/java/org/openmrs/FieldAnswer.java
@@ -13,25 +13,45 @@
 
 import org.codehaus.jackson.annotate.JsonIgnore;
 
+import javax.persistence.Column;
+import javax.persistence.Entity;
+import javax.persistence.Id;
+import javax.persistence.JoinColumn;
+import javax.persistence.ManyToOne;
+import javax.persistence.Table;
+import javax.persistence.Transient;
+
 /**
  * FieldAnswer
  * 
  * @version 1.0
  */
+@Entity
+@Table(name = "field_answer")
 public class FieldAnswer extends BaseOpenmrsObject {
 	
 	public static final long serialVersionUID = 5656L;
 	
 	// Fields
-	
+	@Column(name = "date_created", length = 19)
 	private Date dateCreated;
 	
+	@ManyToOne
+	@JoinColumn(name = "answer_id")
+	@Id
 	private Concept concept;
 	
+	@ManyToOne
+	@JoinColumn(name = "creator", nullable = false)
 	private User creator;
 	
+	
+	@ManyToOne
+	@JoinColumn(name = "field_id")
+	@Id
 	private Field field;
 	
+	@Transient
 	private boolean dirty;
 	
 	// Constructors
@@ -63,7 +83,6 @@ public void setClean() {
 	}
 	
 	// Property accessors
-	
 	/**
 	 * @return Returns the concept.
 	 */
diff --git a/api/src/main/resources/hibernate.cfg.xml b/api/src/main/resources/hibernate.cfg.xml
index c40eced51978..25888c751c95 100644
--- a/api/src/main/resources/hibernate.cfg.xml
+++ b/api/src/main/resources/hibernate.cfg.xml
@@ -46,7 +46,6 @@
 		<mapping resource="org/openmrs/api/db/hibernate/DrugIngredient.hbm.xml" />
 		<mapping resource="org/openmrs/api/db/hibernate/DrugReferenceMap.hbm.xml" />
 		<mapping resource="org/openmrs/api/db/hibernate/Field.hbm.xml" />
-		<mapping resource="org/openmrs/api/db/hibernate/FieldAnswer.hbm.xml" />
 		<mapping resource="org/openmrs/api/db/hibernate/FieldType.hbm.xml" />
 		<mapping resource="org/openmrs/api/db/hibernate/Form.hbm.xml" />
 		<mapping resource="org/openmrs/api/db/hibernate/FormField.hbm.xml" />
diff --git a/api/src/main/resources/org/openmrs/api/db/hibernate/FieldAnswer.hbm.xml b/api/src/main/resources/org/openmrs/api/db/hibernate/FieldAnswer.hbm.xml
deleted file mode 100644
index 867a91352bf6..000000000000
--- a/api/src/main/resources/org/openmrs/api/db/hibernate/FieldAnswer.hbm.xml
+++ /dev/null
@@ -1,75 +0,0 @@
-<?xml version="1.0"?>
-<!--
-
-    This Source Code Form is subject to the terms of the Mozilla Public License,
-    v. 2.0. If a copy of the MPL was not distributed with this file, You can
-    obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
-    the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
-
-    Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
-    graphic logo is a trademark of OpenMRS Inc.
-
--->
-<!DOCTYPE hibernate-mapping PUBLIC
-    "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
-    "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">   
-<hibernate-mapping>
-<!-- 
-    Created by the Middlegen Hibernate plugin 2.1
-
-    http://boss.bekk.no/boss/middlegen/
-    http://www.hibernate.org/
--->
-
-<class 
-    name="org.openmrs.FieldAnswer" 
-    table="field_answer"
->
-
-    <composite-id>
-        <key-many-to-one name="concept" class="org.openmrs.Concept" column="answer_id" />
-        <key-many-to-one name="field" class="org.openmrs.Field" column="field_id" />
-    </composite-id>    
-
-		<property name="uuid" type="java.lang.String"
-			column="uuid" length="38" unique="true" />
-
-    <property 
-        name="dateCreated" 
-        column="date_created" 
-        type="java.util.Date"
-        length="19"
-    />
-
-    <!-- Associations -->
-  
-    <!-- bi-directional many-to-one association to Concept -->
-    <!--
-    <many-to-one
-        name="concept"
-        class="org.openmrs.Concept"
-        not-null="true"
-    >
-        <column name="answer_id" />
-    </many-to-one>
-    -->
-    <!-- bi-directional many-to-one association to Field -->
-    <!--
-    <many-to-one
-        name="field"
-        class="org.openmrs.Field"
-        not-null="true"
-    >
-        <column name="field_id" />
-    </many-to-one>
-    -->
-    <!-- bi-directional many-to-one association to User -->
-    <many-to-one
-        name="creator"
-        class="org.openmrs.User"
-        not-null="true"
-    >
-        <column name="creator" />
-    </many-to-one>
-</class>
-</hibernate-mapping>

From f57b1d6760d1218607433c4915693ba694121cc3 Mon Sep 17 00:00:00 2001
From: Wikum Weerakutti <wikum@linuxdeveloper.space>
Date: Fri, 31 May 2024 18:40:58 +0530
Subject: [PATCH 022/163] TRUNK-6239: AlertRecipient - Switching from Hibernate
 Mapping to JPA annotations (#4646)

---
 .../openmrs/notification/AlertRecipient.java  | 23 ++++++++++-
 api/src/main/resources/hibernate.cfg.xml      |  1 -
 .../db/hibernate/AlertRecipient.hbm.xml       | 39 -------------------
 .../org/openmrs/api/OrderServiceTest.java     |  2 +
 4 files changed, 23 insertions(+), 42 deletions(-)
 delete mode 100644 api/src/main/resources/org/openmrs/notification/db/hibernate/AlertRecipient.hbm.xml

diff --git a/api/src/main/java/org/openmrs/notification/AlertRecipient.java b/api/src/main/java/org/openmrs/notification/AlertRecipient.java
index ac28c4ab4783..4fa30dd578e7 100644
--- a/api/src/main/java/org/openmrs/notification/AlertRecipient.java
+++ b/api/src/main/java/org/openmrs/notification/AlertRecipient.java
@@ -14,26 +14,45 @@
 import org.openmrs.BaseOpenmrsObject;
 import org.openmrs.User;
 
+import javax.persistence.Column;
+import javax.persistence.Entity;
+import javax.persistence.Id;
+import javax.persistence.JoinColumn;
+import javax.persistence.ManyToOne;
+import javax.persistence.Table;
+
+
 /**
  * This class is essentially a wrapper for the user object. The alert is assigned to each recipient.
  * A recipient then has either "read" the alert or has not.
  * 
  * @see org.openmrs.notification.Alert
  */
+@Entity
+@Table(name = "notification_alert_recipient")
 public class AlertRecipient extends BaseOpenmrsObject {
 	
 	private static final long serialVersionUID = -507111109155L;
 	
+	@JoinColumn(name = "alert_id")
+	@Id
+	@ManyToOne
 	private Alert alert;
-	
+
+	@JoinColumn(name = "user_id", updatable = false, insertable = false)
+	@Id
+	@ManyToOne
 	private User recipient;
 	
+	@Column(name = "alert_read", length = 1)
 	private Boolean alertRead = false;
 	
+	@Column(name = "date_changed", length = 19, updatable = false, insertable = false)
 	private Date dateChanged;
 	
 	// necessary for hql queries
-	private transient Integer recipientId;
+	@Column(name = "user_id", nullable = false, updatable = false, insertable = false)
+	private Integer recipientId;
 	
 	/** Default empty constructor */
 	public AlertRecipient() {
diff --git a/api/src/main/resources/hibernate.cfg.xml b/api/src/main/resources/hibernate.cfg.xml
index 25888c751c95..acddeedea4b0 100644
--- a/api/src/main/resources/hibernate.cfg.xml
+++ b/api/src/main/resources/hibernate.cfg.xml
@@ -99,7 +99,6 @@
 		<!-- Notification -->
 		<mapping resource="org/openmrs/notification/db/hibernate/Template.hbm.xml" />
 		<mapping resource="org/openmrs/notification/db/hibernate/Alert.hbm.xml" />
-		<mapping resource="org/openmrs/notification/db/hibernate/AlertRecipient.hbm.xml" />
 		
 		<!-- Scheduler -->
 		<mapping resource="org/openmrs/scheduler/db/hibernate/TaskDefinition.hbm.xml" />
diff --git a/api/src/main/resources/org/openmrs/notification/db/hibernate/AlertRecipient.hbm.xml b/api/src/main/resources/org/openmrs/notification/db/hibernate/AlertRecipient.hbm.xml
deleted file mode 100644
index 0698c9c4eb9c..000000000000
--- a/api/src/main/resources/org/openmrs/notification/db/hibernate/AlertRecipient.hbm.xml
+++ /dev/null
@@ -1,39 +0,0 @@
-<?xml version="1.0"?>
-<!--
-
-    This Source Code Form is subject to the terms of the Mozilla Public License,
-    v. 2.0. If a copy of the MPL was not distributed with this file, You can
-    obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
-    the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
-
-    Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
-    graphic logo is a trademark of OpenMRS Inc.
-
--->
-<!DOCTYPE hibernate-mapping PUBLIC
-    "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
-    "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">
-<hibernate-mapping package="org.openmrs.notification">
-
-	<class name="org.openmrs.notification.AlertRecipient" table="notification_alert_recipient">
-		
-		<composite-id>
-			<key-many-to-one name="alert" column="alert_id"	class="org.openmrs.notification.Alert" />
-			<key-many-to-one name="recipient" class="org.openmrs.User" column="user_id" />
-		</composite-id>
-		
-		<property name="recipientId" column="user_id" type="java.lang.Integer" 
-				not-null="true" update="false" insert="false" />
-		
-		<property name="alertRead" column="alert_read" type="java.lang.Boolean" 
-				not-null="true" length="1"/>
-		
-		<property name="dateChanged" type="java.util.Date"
-				column="date_changed" length="19" update="false" insert="false" />
-		
-		<property name="uuid" type="java.lang.String"
-			column="uuid" length="38" unique="true" />
-		
-	</class>
-
-</hibernate-mapping>
diff --git a/api/src/test/java/org/openmrs/api/OrderServiceTest.java b/api/src/test/java/org/openmrs/api/OrderServiceTest.java
index 075a7cdb0193..b3b62d31a4bb 100644
--- a/api/src/test/java/org/openmrs/api/OrderServiceTest.java
+++ b/api/src/test/java/org/openmrs/api/OrderServiceTest.java
@@ -70,6 +70,7 @@
 import org.openmrs.api.impl.OrderServiceImpl;
 import org.openmrs.customdatatype.datatype.FreeTextDatatype;
 import org.openmrs.messagesource.MessageSourceService;
+import org.openmrs.notification.AlertRecipient;
 import org.openmrs.order.OrderUtil;
 import org.openmrs.order.OrderUtilTest;
 import org.openmrs.orders.TimestampOrderNumberGenerator;
@@ -2664,6 +2665,7 @@ public void saveOrder_shouldFailIfTheJavaTypeOfThePreviousOrderDoesNotMatch() th
 			.addAnnotatedClass(LocationAttributeType.class)
 			.addAnnotatedClass(SerializedObject.class)
 			.addAnnotatedClass(PatientState.class)
+			.addAnnotatedClass(AlertRecipient.class)
 			.getMetadataBuilder().build();
 
 

From 4b5f83feb9bf2ddb5d5ec5e28da02ff2f1e8dba1 Mon Sep 17 00:00:00 2001
From: Wikum Weerakutti <wikum@linuxdeveloper.space>
Date: Sun, 2 Jun 2024 01:38:53 +0530
Subject: [PATCH 023/163] TRUNK-6238: Drug Ingredients - Switching from
 Hibernate Mapping to JPA annotations (#4644)

---
 .../main/java/org/openmrs/DrugIngredient.java | 28 +++++++++--
 api/src/main/resources/hibernate.cfg.xml      |  1 -
 .../api/db/hibernate/DrugIngredient.hbm.xml   | 48 -------------------
 .../org/openmrs/api/OrderServiceTest.java     |  3 ++
 4 files changed, 26 insertions(+), 54 deletions(-)
 delete mode 100644 api/src/main/resources/org/openmrs/api/db/hibernate/DrugIngredient.hbm.xml

diff --git a/api/src/main/java/org/openmrs/DrugIngredient.java b/api/src/main/java/org/openmrs/DrugIngredient.java
index 8f4c709dac57..916785904f67 100644
--- a/api/src/main/java/org/openmrs/DrugIngredient.java
+++ b/api/src/main/java/org/openmrs/DrugIngredient.java
@@ -9,21 +9,40 @@
  */
 package org.openmrs;
 
+
+import javax.persistence.Column;
+import javax.persistence.Entity;
+import javax.persistence.Id;
+import javax.persistence.JoinColumn;
+import javax.persistence.ManyToOne;
+import javax.persistence.Table;
+import java.io.Serializable;
+
 /**
  * DrugIngredient
  */
-public class DrugIngredient extends BaseOpenmrsObject implements java.io.Serializable, OpenmrsObject {
+@Entity
+@Table(name = "drug_ingredient")
+public class DrugIngredient extends BaseOpenmrsObject implements Serializable, OpenmrsObject {
 	
 	public static final long serialVersionUID = 94023L;
 	
 	// Fields
-	
+	@ManyToOne
+	@JoinColumn(name = "drug_id", updatable = false, insertable = false)
+	@Id
 	private Drug drug;
-	
+
+	@ManyToOne
+	@JoinColumn(name = "ingredient_id", updatable = false, insertable = false)
+	@Id
 	private Concept ingredient;
-	
+
+	@Column(name = "strength")
 	private Double strength;
 	
+	@JoinColumn(name = "units", insertable = false, updatable = false)
+	@ManyToOne
 	private Concept units;
 	
 	// Constructors
@@ -33,7 +52,6 @@ public DrugIngredient() {
 	}
 	
 	// Property accessors
-	
 	/**
 	 * @return the drug
 	 */
diff --git a/api/src/main/resources/hibernate.cfg.xml b/api/src/main/resources/hibernate.cfg.xml
index acddeedea4b0..f8695300e5c1 100644
--- a/api/src/main/resources/hibernate.cfg.xml
+++ b/api/src/main/resources/hibernate.cfg.xml
@@ -43,7 +43,6 @@
 		<mapping resource="org/openmrs/api/db/hibernate/DiagnosisAttribute.hbm.xml" />
 		<mapping resource="org/openmrs/api/db/hibernate/DiagnosisAttributeType.hbm.xml" />
 		<mapping resource="org/openmrs/api/db/hibernate/Drug.hbm.xml" />
-		<mapping resource="org/openmrs/api/db/hibernate/DrugIngredient.hbm.xml" />
 		<mapping resource="org/openmrs/api/db/hibernate/DrugReferenceMap.hbm.xml" />
 		<mapping resource="org/openmrs/api/db/hibernate/Field.hbm.xml" />
 		<mapping resource="org/openmrs/api/db/hibernate/FieldType.hbm.xml" />
diff --git a/api/src/main/resources/org/openmrs/api/db/hibernate/DrugIngredient.hbm.xml b/api/src/main/resources/org/openmrs/api/db/hibernate/DrugIngredient.hbm.xml
deleted file mode 100644
index 19bee799e749..000000000000
--- a/api/src/main/resources/org/openmrs/api/db/hibernate/DrugIngredient.hbm.xml
+++ /dev/null
@@ -1,48 +0,0 @@
-<?xml version="1.0"?>
-<!--
-
-    This Source Code Form is subject to the terms of the Mozilla Public License,
-    v. 2.0. If a copy of the MPL was not distributed with this file, You can
-    obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
-    the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
-
-    Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
-    graphic logo is a trademark of OpenMRS Inc.
-
--->
-<!DOCTYPE hibernate-mapping PUBLIC
-    "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
-    "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">
-<hibernate-mapping package="org.openmrs">
-
-	<class name="DrugIngredient" table="drug_ingredient">
-
-		<composite-id>
-			<key-many-to-one name="drug" column="drug_id" class="Drug" />
-			<key-many-to-one name="ingredient" column="ingredient_id"
-				class="Concept" />
-		</composite-id>
-
-		<property name="uuid" type="java.lang.String" column="uuid"
-			length="38" unique="true" />
-
-		<property name="strength" type="java.lang.Double" />
-
-		<many-to-one name="units" class="Concept" column="units"
-			update="false" insert="false" />
-
-		<!-- Associations -->
-		<!-- derived association(s) for compound key -->
-		<!-- bi-directional many-to-one association to Drug -->
-		<many-to-one name="drug" class="Drug" column="drug_id"
-			update="false" insert="false" not-null="true" />
-
-		<!-- bi-directional many-to-one association to Concept -->
-		<many-to-one name="ingredient" class="Concept" column="ingredient_id"
-			update="false" insert="false" not-null="true" />
-
-		<!-- end of derived association(s) -->
-
-	</class>
-
-</hibernate-mapping>
diff --git a/api/src/test/java/org/openmrs/api/OrderServiceTest.java b/api/src/test/java/org/openmrs/api/OrderServiceTest.java
index b3b62d31a4bb..cbb56999954a 100644
--- a/api/src/test/java/org/openmrs/api/OrderServiceTest.java
+++ b/api/src/test/java/org/openmrs/api/OrderServiceTest.java
@@ -18,6 +18,7 @@
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Disabled;
 import org.junit.jupiter.api.Test;
+
 import org.openmrs.Allergy;
 import org.openmrs.CareSetting;
 import org.openmrs.Concept;
@@ -31,6 +32,7 @@
 import org.openmrs.Condition;
 import org.openmrs.Diagnosis;
 import org.openmrs.Drug;
+import org.openmrs.DrugIngredient;
 import org.openmrs.DrugOrder;
 import org.openmrs.Encounter;
 import org.openmrs.FreeTextDosingInstructions;
@@ -2665,6 +2667,7 @@ public void saveOrder_shouldFailIfTheJavaTypeOfThePreviousOrderDoesNotMatch() th
 			.addAnnotatedClass(LocationAttributeType.class)
 			.addAnnotatedClass(SerializedObject.class)
 			.addAnnotatedClass(PatientState.class)
+			.addAnnotatedClass(DrugIngredient.class)
 			.addAnnotatedClass(AlertRecipient.class)
 			.getMetadataBuilder().build();
 

From 4b08bc75c54122e6d8717793aef0395375562ba1 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 2 Jun 2024 22:13:03 +0300
Subject: [PATCH 024/163] maven(deps): bump
 org.sonarsource.scanner.maven:sonar-maven-plugin (#4654)

Bumps [org.sonarsource.scanner.maven:sonar-maven-plugin](https://github.com/SonarSource/sonar-scanner-maven) from 3.11.0.3922 to 4.0.0.4121.
- [Release notes](https://github.com/SonarSource/sonar-scanner-maven/releases)
- [Commits](https://github.com/SonarSource/sonar-scanner-maven/compare/3.11.0.3922...4.0.0.4121)

---
updated-dependencies:
- dependency-name: org.sonarsource.scanner.maven:sonar-maven-plugin
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 338687348991..cebfe7b880bb 100644
--- a/pom.xml
+++ b/pom.xml
@@ -815,7 +815,7 @@
 				<plugin>
 					<groupId>org.sonarsource.scanner.maven</groupId>
 					<artifactId>sonar-maven-plugin</artifactId>
-					<version>3.11.0.3922</version>
+					<version>4.0.0.4121</version>
 				</plugin>
 				<plugin>
 					<groupId>org.jacoco</groupId>

From 67ed5edd64a9fb37066fd491393219f8ef62d9b2 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 3 Jun 2024 23:06:20 +0300
Subject: [PATCH 025/163] maven(deps): bump
 org.apache.maven.plugins:maven-javadoc-plugin (#4655)

Bumps [org.apache.maven.plugins:maven-javadoc-plugin](https://github.com/apache/maven-javadoc-plugin) from 3.6.3 to 3.7.0.
- [Release notes](https://github.com/apache/maven-javadoc-plugin/releases)
- [Commits](https://github.com/apache/maven-javadoc-plugin/compare/maven-javadoc-plugin-3.6.3...maven-javadoc-plugin-3.7.0)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-javadoc-plugin
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pom.xml b/pom.xml
index cebfe7b880bb..687846578549 100644
--- a/pom.xml
+++ b/pom.xml
@@ -725,7 +725,7 @@
 				<plugin>
 					<groupId>org.apache.maven.plugins</groupId>
 					<artifactId>maven-javadoc-plugin</artifactId>
-					<version>3.6.3</version>
+					<version>3.7.0</version>
 					<configuration>
 						<!-- For some reason some packages from org.springframework are being
 						included and causing errors. -->
@@ -1142,7 +1142,7 @@
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-javadoc-plugin</artifactId>
-				<version>3.6.3</version>
+				<version>3.7.0</version>
 				<configuration>
 					<docfilessubdirs>true</docfilessubdirs>
 					<bottom>&lt;em&gt;&lt;small&gt; Generated ${TIMESTAMP} NOTE - these libraries are in active development and subject to change&lt;/small&gt;&lt;/em&gt;</bottom>

From 3a12e4fd867638135ac9f6b8a56e4094a9dadc05 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 3 Jun 2024 23:07:09 +0300
Subject: [PATCH 026/163] maven(deps): bump org.dbunit:dbunit from 2.7.3 to
 2.8.0 (#4656)

Bumps org.dbunit:dbunit from 2.7.3 to 2.8.0.

---
updated-dependencies:
- dependency-name: org.dbunit:dbunit
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 687846578549..ef781487bbb4 100644
--- a/pom.xml
+++ b/pom.xml
@@ -508,7 +508,7 @@
 			<dependency>
 				<groupId>org.dbunit</groupId>
 				<artifactId>dbunit</artifactId>
-				<version>2.7.3</version>
+				<version>2.8.0</version>
 			</dependency>
 			<dependency>
 				<groupId>javax.validation</groupId>

From 45f12533429f4de7fa34de741728c6fef38710d4 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 3 Jun 2024 23:09:01 +0300
Subject: [PATCH 027/163] maven(deps): bump com.google.guava:guava from
 33.2.0-jre to 33.2.1-jre (#4657)

Bumps [com.google.guava:guava](https://github.com/google/guava) from 33.2.0-jre to 33.2.1-jre.
- [Release notes](https://github.com/google/guava/releases)
- [Commits](https://github.com/google/guava/commits)

---
updated-dependencies:
- dependency-name: com.google.guava:guava
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index ef781487bbb4..7da688874c3f 100644
--- a/pom.xml
+++ b/pom.xml
@@ -558,7 +558,7 @@
 			<dependency>
 				<groupId>com.google.guava</groupId>
 				<artifactId>guava</artifactId>
-				<version>33.2.0-jre</version>
+				<version>33.2.1-jre</version>
 			</dependency>
 			<dependency>
 			    <groupId>jakarta.xml.bind</groupId>

From 6ee0ed56ba76af23553dc74c98682c92b17b230f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 4 Jun 2024 22:50:21 +0300
Subject: [PATCH 028/163] maven(deps): bump
 org.apache.maven.plugins:maven-jxr-plugin (#4658)

Bumps [org.apache.maven.plugins:maven-jxr-plugin](https://github.com/apache/maven-jxr) from 3.3.2 to 3.4.0.
- [Release notes](https://github.com/apache/maven-jxr/releases)
- [Commits](https://github.com/apache/maven-jxr/compare/jxr-3.3.2...jxr-3.4.0)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-jxr-plugin
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 7da688874c3f..6ebc2ea4358c 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1153,7 +1153,7 @@
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-jxr-plugin</artifactId>
-				<version>3.3.2</version>
+				<version>3.4.0</version>
 			</plugin>
 		</plugins>
 	</reporting>

From 8f50e492bc5bf64f077f6386fbb5b431d39e17a7 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 5 Jun 2024 22:07:17 +0300
Subject: [PATCH 029/163] maven(deps): bump
 org.apache.maven.plugins:maven-checkstyle-plugin (#4659)

Bumps [org.apache.maven.plugins:maven-checkstyle-plugin](https://github.com/apache/maven-checkstyle-plugin) from 3.3.1 to 3.4.0.
- [Commits](https://github.com/apache/maven-checkstyle-plugin/compare/maven-checkstyle-plugin-3.3.1...maven-checkstyle-plugin-3.4.0)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-checkstyle-plugin
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 6ebc2ea4358c..e6c7391cd2fe 100644
--- a/pom.xml
+++ b/pom.xml
@@ -684,7 +684,7 @@
 				<plugin>
 					<groupId>org.apache.maven.plugins</groupId>
 					<artifactId>maven-checkstyle-plugin</artifactId>
-					<version>3.3.1</version>
+					<version>3.4.0</version>
 					<configuration>
 						<configLocation>checkstyle.xml</configLocation>
 					</configuration>

From 8d3e65b48ea3d41c1270c609a081b363849c8c41 Mon Sep 17 00:00:00 2001
From: Ssegujja Joseph Bate <38130891+josephbate@users.noreply.github.com>
Date: Mon, 10 Jun 2024 15:36:54 +0300
Subject: [PATCH 030/163] TRUNK-6242: editing the hydrate() to fetch concepts
 by id/Uuid/mappings by replacing ConceptService#getConcept() with 
 ConceptService#getConceptByReference() (#4660)

---
 api/src/main/java/org/openmrs/Concept.java | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/api/src/main/java/org/openmrs/Concept.java b/api/src/main/java/org/openmrs/Concept.java
index ecd9833cd7eb..8a63b0e1b4b0 100644
--- a/api/src/main/java/org/openmrs/Concept.java
+++ b/api/src/main/java/org/openmrs/Concept.java
@@ -1436,9 +1436,9 @@ public List<Concept> getPossibleValues() {
 	 * @see org.openmrs.Attributable#hydrate(java.lang.String)
 	 */
 	@Override
-	public Concept hydrate(String s) {
+	public Concept hydrate(String reference) {
 		try {
-			return Context.getConceptService().getConcept(Integer.valueOf(s));
+			return Context.getConceptService().getConceptByReference(reference);
 		}
 		catch (Exception e) {
 			// pass

From d17bd15ae67e2bb92538640c3bfd4bde5220c3de Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 11 Jun 2024 21:49:05 +0300
Subject: [PATCH 031/163] maven(deps): bump
 org.apache.maven.plugins:maven-dependency-plugin (#4661)

Bumps [org.apache.maven.plugins:maven-dependency-plugin](https://github.com/apache/maven-dependency-plugin) from 3.6.1 to 3.7.0.
- [Release notes](https://github.com/apache/maven-dependency-plugin/releases)
- [Commits](https://github.com/apache/maven-dependency-plugin/compare/maven-dependency-plugin-3.6.1...maven-dependency-plugin-3.7.0)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-dependency-plugin
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index e6c7391cd2fe..c3ab2cc4fae0 100644
--- a/pom.xml
+++ b/pom.xml
@@ -942,7 +942,7 @@
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-dependency-plugin</artifactId>
-				<version>3.6.1</version>
+				<version>3.7.0</version>
 			</plugin>
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>

From 2111f62acc036525fbf45b4e7b1f864503cad940 Mon Sep 17 00:00:00 2001
From: Wikum Weerakutti <wikum@linuxdeveloper.space>
Date: Thu, 13 Jun 2024 19:18:00 +0530
Subject: [PATCH 032/163] OMRS-131: Detailed Audit Logging (#4620)

---
 api/pom.xml                                   |  4 ++
 api/src/main/java/org/openmrs/Allergy.java    |  2 +
 .../java/org/openmrs/AllergyReaction.java     |  2 +
 .../main/java/org/openmrs/CareSetting.java    |  3 ++
 api/src/main/java/org/openmrs/Cohort.java     |  2 +
 .../java/org/openmrs/CohortMembership.java    |  2 +
 api/src/main/java/org/openmrs/Concept.java    |  2 +
 .../main/java/org/openmrs/ConceptAnswer.java  |  3 ++
 .../java/org/openmrs/ConceptAttribute.java    |  2 +
 .../main/java/org/openmrs/ConceptClass.java   |  2 +
 .../main/java/org/openmrs/ConceptComplex.java |  2 +
 .../java/org/openmrs/ConceptDatatype.java     |  2 +
 .../java/org/openmrs/ConceptDescription.java  |  3 ++
 api/src/main/java/org/openmrs/ConceptMap.java |  2 +
 .../main/java/org/openmrs/ConceptMapType.java |  2 +
 .../main/java/org/openmrs/ConceptName.java    |  2 +
 .../main/java/org/openmrs/ConceptNameTag.java |  2 +
 .../org/openmrs/ConceptReferenceTerm.java     |  2 +
 .../org/openmrs/ConceptReferenceTermMap.java  |  3 ++
 api/src/main/java/org/openmrs/ConceptSet.java |  2 +
 .../main/java/org/openmrs/ConceptSource.java  |  3 ++
 api/src/main/java/org/openmrs/Condition.java  |  2 +
 api/src/main/java/org/openmrs/Diagnosis.java  |  2 +
 .../java/org/openmrs/DiagnosisAttribute.java  |  2 +
 .../org/openmrs/DiagnosisAttributeType.java   |  2 +
 api/src/main/java/org/openmrs/Drug.java       |  3 ++
 .../main/java/org/openmrs/DrugIngredient.java |  3 ++
 api/src/main/java/org/openmrs/DrugOrder.java  |  2 +
 .../java/org/openmrs/DrugReferenceMap.java    |  4 +-
 api/src/main/java/org/openmrs/Encounter.java  |  2 +
 .../java/org/openmrs/EncounterProvider.java   |  3 ++
 .../main/java/org/openmrs/EncounterRole.java  |  3 ++
 .../main/java/org/openmrs/EncounterType.java  |  3 ++
 api/src/main/java/org/openmrs/Field.java      |  2 +
 .../main/java/org/openmrs/FieldAnswer.java    |  2 +
 api/src/main/java/org/openmrs/FieldType.java  |  3 ++
 api/src/main/java/org/openmrs/Form.java       |  3 ++
 api/src/main/java/org/openmrs/FormField.java  |  2 +
 .../main/java/org/openmrs/FormResource.java   |  2 +
 .../main/java/org/openmrs/GlobalProperty.java |  2 +
 api/src/main/java/org/openmrs/Location.java   |  2 +
 .../java/org/openmrs/LocationAttribute.java   |  2 +
 .../org/openmrs/LocationAttributeType.java    |  2 +
 .../main/java/org/openmrs/LocationTag.java    |  3 ++
 api/src/main/java/org/openmrs/Obs.java        |  3 ++
 api/src/main/java/org/openmrs/Order.java      |  4 +-
 .../main/java/org/openmrs/OrderAttribute.java |  4 +-
 .../java/org/openmrs/OrderAttributeType.java  |  2 +
 .../main/java/org/openmrs/OrderFrequency.java |  3 ++
 api/src/main/java/org/openmrs/OrderGroup.java |  2 +
 .../java/org/openmrs/OrderGroupAttribute.java |  2 +
 .../org/openmrs/OrderGroupAttributeType.java  |  2 +
 api/src/main/java/org/openmrs/OrderSet.java   |  2 +
 .../java/org/openmrs/OrderSetAttribute.java   |  2 +
 .../org/openmrs/OrderSetAttributeType.java    |  2 +
 .../main/java/org/openmrs/OrderSetMember.java |  3 ++
 api/src/main/java/org/openmrs/OrderType.java  |  2 +
 api/src/main/java/org/openmrs/Patient.java    |  2 +
 .../java/org/openmrs/PatientIdentifier.java   |  2 +
 .../org/openmrs/PatientIdentifierType.java    |  2 +
 .../main/java/org/openmrs/PatientProgram.java |  2 +
 .../org/openmrs/PatientProgramAttribute.java  |  4 +-
 .../main/java/org/openmrs/PatientState.java   |  2 +
 api/src/main/java/org/openmrs/Person.java     | 12 +++--
 .../main/java/org/openmrs/PersonAddress.java  |  2 +
 .../java/org/openmrs/PersonAttribute.java     |  2 +
 .../java/org/openmrs/PersonAttributeType.java |  2 +
 api/src/main/java/org/openmrs/PersonName.java |  2 +
 api/src/main/java/org/openmrs/Privilege.java  |  3 ++
 api/src/main/java/org/openmrs/Program.java    |  2 +
 .../org/openmrs/ProgramAttributeType.java     |  4 +-
 .../java/org/openmrs/ProgramWorkflow.java     |  2 +
 .../org/openmrs/ProgramWorkflowState.java     |  3 ++
 api/src/main/java/org/openmrs/Provider.java   |  2 +
 .../java/org/openmrs/ProviderAttribute.java   |  2 +
 .../org/openmrs/ProviderAttributeType.java    |  2 +
 .../main/java/org/openmrs/ReferralOrder.java  |  3 ++
 .../main/java/org/openmrs/Relationship.java   |  2 +
 .../java/org/openmrs/RelationshipType.java    |  2 +
 api/src/main/java/org/openmrs/Role.java       |  2 +
 api/src/main/java/org/openmrs/User.java       |  4 ++
 api/src/main/java/org/openmrs/Visit.java      |  2 +
 .../main/java/org/openmrs/VisitAttribute.java |  2 +
 api/src/main/java/org/openmrs/VisitType.java  |  3 ++
 .../envers/OpenMRSRevisionEntity.java         | 46 +++++++++++++++++++
 .../envers/OpenMRSRevisionEntityListener.java | 31 +++++++++++++
 .../java/org/openmrs/notification/Alert.java  |  2 +
 .../openmrs/notification/AlertRecipient.java  |  2 +
 .../resources/hibernate.default.properties    |  6 ++-
 .../db/hibernate/ConceptDescription.hbm.xml   |  2 +-
 .../api/db/hibernate/ConceptName.hbm.xml      |  2 +-
 .../api/db/hibernate/ConceptNameTag.hbm.xml   |  2 +-
 .../openmrs/api/db/hibernate/Field.hbm.xml    |  4 +-
 .../api/db/hibernate/FormResource.hbm.xml     |  2 +-
 .../api/db/hibernate/GlobalProperty.hbm.xml   |  4 +-
 .../org/openmrs/api/db/hibernate/Obs.hbm.xml  |  2 +-
 .../openmrs/api/db/hibernate/Order.hbm.xml    |  8 ++--
 .../api/db/hibernate/OrderSetMember.hbm.xml   |  2 +-
 .../org/openmrs/api/db/hibernate/Role.hbm.xml |  2 +-
 .../ValidateHibernateMappingsDatabaseIT.java  |  8 ++--
 pom.xml                                       |  5 ++
 .../autocomplete/OpenmrsAutoComplete.js       |  2 +-
 102 files changed, 314 insertions(+), 30 deletions(-)
 create mode 100644 api/src/main/java/org/openmrs/api/db/hibernate/envers/OpenMRSRevisionEntity.java
 create mode 100644 api/src/main/java/org/openmrs/api/db/hibernate/envers/OpenMRSRevisionEntityListener.java

diff --git a/api/pom.xml b/api/pom.xml
index d92c3468cc44..0864ba6f1df0 100644
--- a/api/pom.xml
+++ b/api/pom.xml
@@ -152,6 +152,10 @@
 			<groupId>org.hibernate</groupId>
 			<artifactId>hibernate-search-orm</artifactId>
 		</dependency>
+		<dependency>
+			<groupId>org.hibernate</groupId>
+			<artifactId>hibernate-envers</artifactId>
+		</dependency>
 		<dependency>
 			<groupId>org.apache.lucene</groupId>
 			<artifactId>lucene-queryparser</artifactId>
diff --git a/api/src/main/java/org/openmrs/Allergy.java b/api/src/main/java/org/openmrs/Allergy.java
index 99c60695fa4a..6f0316215341 100644
--- a/api/src/main/java/org/openmrs/Allergy.java
+++ b/api/src/main/java/org/openmrs/Allergy.java
@@ -30,6 +30,7 @@
 import org.apache.commons.lang3.StringUtils;
 import org.hibernate.annotations.LazyCollection;
 import org.hibernate.annotations.LazyCollectionOption;
+import org.hibernate.envers.Audited;
 import org.openmrs.util.OpenmrsUtil;
 
 /**
@@ -37,6 +38,7 @@
  */
 @Entity
 @Table(name = "allergy")
+@Audited
 public class Allergy extends BaseFormRecordableOpenmrsData {
 	
 	public static final long serialVersionUID = 1;
diff --git a/api/src/main/java/org/openmrs/AllergyReaction.java b/api/src/main/java/org/openmrs/AllergyReaction.java
index 2db04225fb2d..28d5e416e95c 100644
--- a/api/src/main/java/org/openmrs/AllergyReaction.java
+++ b/api/src/main/java/org/openmrs/AllergyReaction.java
@@ -10,11 +10,13 @@
 package org.openmrs;
 
 import org.apache.commons.lang3.StringUtils;
+import org.hibernate.envers.Audited;
 import org.openmrs.util.OpenmrsUtil;
 
 /**
  * Represent allergy reactions
  */
+@Audited
 public class AllergyReaction extends BaseOpenmrsObject implements java.io.Serializable{
 	
 	public static final long serialVersionUID = 1;
diff --git a/api/src/main/java/org/openmrs/CareSetting.java b/api/src/main/java/org/openmrs/CareSetting.java
index 165cff29b533..145a753cbeb0 100644
--- a/api/src/main/java/org/openmrs/CareSetting.java
+++ b/api/src/main/java/org/openmrs/CareSetting.java
@@ -9,6 +9,8 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
+
 /**
  * Care Setting defines the scope of care for any piece of data within the medical record. Clinical
  * data (treatments, notes, etc.) apply within their associated care setting. Implementations
@@ -24,6 +26,7 @@
  * 
  * @since 1.10
  */
+@Audited
 public class CareSetting extends BaseChangeableOpenmrsMetadata {
 	
 	public enum CareSettingType {
diff --git a/api/src/main/java/org/openmrs/Cohort.java b/api/src/main/java/org/openmrs/Cohort.java
index fdc0d806c469..881a128cc322 100644
--- a/api/src/main/java/org/openmrs/Cohort.java
+++ b/api/src/main/java/org/openmrs/Cohort.java
@@ -10,6 +10,7 @@
 package org.openmrs;
 
 import org.apache.commons.lang3.StringUtils;
+import org.hibernate.envers.Audited;
 
 import java.util.Arrays;
 import java.util.Collection;
@@ -21,6 +22,7 @@
 /**
  * This class represents a list of patientIds.
  */
+@Audited
 public class Cohort extends BaseChangeableOpenmrsData {
 	
 	public static final long serialVersionUID = 0L;
diff --git a/api/src/main/java/org/openmrs/CohortMembership.java b/api/src/main/java/org/openmrs/CohortMembership.java
index 69ec240e05d3..f459f7847567 100644
--- a/api/src/main/java/org/openmrs/CohortMembership.java
+++ b/api/src/main/java/org/openmrs/CohortMembership.java
@@ -12,11 +12,13 @@
 import java.util.Date;
 import java.util.Objects;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.util.OpenmrsUtil;
 
 /**
  * @since 2.1.0
  */
+@Audited
 public class CohortMembership extends BaseChangeableOpenmrsData implements Comparable<CohortMembership> {
 	
 	public static final long serialVersionUID = 0L;
diff --git a/api/src/main/java/org/openmrs/Concept.java b/api/src/main/java/org/openmrs/Concept.java
index 8a63b0e1b4b0..8a1753b29f55 100644
--- a/api/src/main/java/org/openmrs/Concept.java
+++ b/api/src/main/java/org/openmrs/Concept.java
@@ -26,6 +26,7 @@
 
 import org.apache.commons.lang3.StringUtils;
 import org.codehaus.jackson.annotate.JsonIgnore;
+import org.hibernate.envers.Audited;
 import org.hibernate.search.annotations.ContainedIn;
 import org.hibernate.search.annotations.DocumentId;
 import org.hibernate.search.annotations.Field;
@@ -69,6 +70,7 @@
  * @see ConceptService
  */
 @FullTextFilterDefs( { @FullTextFilterDef(name = "termsFilterFactory", impl = TermsFilterFactory.class) })
+@Audited
 public class Concept extends BaseOpenmrsObject implements Auditable, Retireable, Serializable, Attributable<Concept>,Customizable<ConceptAttribute> {
 	
 	public static final long serialVersionUID = 57332L;
diff --git a/api/src/main/java/org/openmrs/ConceptAnswer.java b/api/src/main/java/org/openmrs/ConceptAnswer.java
index 4552f3b97e4c..9a476af6e026 100644
--- a/api/src/main/java/org/openmrs/ConceptAnswer.java
+++ b/api/src/main/java/org/openmrs/ConceptAnswer.java
@@ -9,6 +9,8 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
+
 import java.util.Date;
 
 /**
@@ -18,6 +20,7 @@
  *
  * @see Concept#getAnswers()
  */
+@Audited
 public class ConceptAnswer extends BaseOpenmrsObject implements Auditable, java.io.Serializable, Comparable<ConceptAnswer> {
 	
 	public static final long serialVersionUID = 3744L;
diff --git a/api/src/main/java/org/openmrs/ConceptAttribute.java b/api/src/main/java/org/openmrs/ConceptAttribute.java
index b43fafd8fd4a..f2a71ce26382 100644
--- a/api/src/main/java/org/openmrs/ConceptAttribute.java
+++ b/api/src/main/java/org/openmrs/ConceptAttribute.java
@@ -9,9 +9,11 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.attribute.Attribute;
 import org.openmrs.attribute.BaseAttribute;
 
+@Audited
 public class ConceptAttribute extends BaseAttribute<ConceptAttributeType, Concept> implements Attribute<ConceptAttributeType, Concept> {
 	
 	private Integer conceptAttributeId;
diff --git a/api/src/main/java/org/openmrs/ConceptClass.java b/api/src/main/java/org/openmrs/ConceptClass.java
index 1aab341bdf67..1e4937857a62 100644
--- a/api/src/main/java/org/openmrs/ConceptClass.java
+++ b/api/src/main/java/org/openmrs/ConceptClass.java
@@ -9,11 +9,13 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.hibernate.search.annotations.DocumentId;
 
 /**
  * ConceptClass
  */
+@Audited
 public class ConceptClass extends BaseChangeableOpenmrsMetadata {
 	
 	public static final long serialVersionUID = 33473L;
diff --git a/api/src/main/java/org/openmrs/ConceptComplex.java b/api/src/main/java/org/openmrs/ConceptComplex.java
index c2201692f7a9..7fa5764e6fc8 100644
--- a/api/src/main/java/org/openmrs/ConceptComplex.java
+++ b/api/src/main/java/org/openmrs/ConceptComplex.java
@@ -9,6 +9,7 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.hibernate.search.annotations.Indexed;
 import org.openmrs.obs.ComplexObsHandler;
 
@@ -18,6 +19,7 @@
  * @since 1.5
  */
 @Indexed
+@Audited
 public class ConceptComplex extends Concept {
 	
 	public static final long serialVersionUID = 473231233L;
diff --git a/api/src/main/java/org/openmrs/ConceptDatatype.java b/api/src/main/java/org/openmrs/ConceptDatatype.java
index e29831240f7b..bb891a213cdc 100644
--- a/api/src/main/java/org/openmrs/ConceptDatatype.java
+++ b/api/src/main/java/org/openmrs/ConceptDatatype.java
@@ -9,11 +9,13 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.hibernate.search.annotations.DocumentId;
 
 /**
  * ConceptDatatype
  */
+@Audited
 public class ConceptDatatype extends BaseChangeableOpenmrsMetadata {
 	
 	public static final long serialVersionUID = 473L;
diff --git a/api/src/main/java/org/openmrs/ConceptDescription.java b/api/src/main/java/org/openmrs/ConceptDescription.java
index 5d9f29bc2be8..dd476facdf70 100644
--- a/api/src/main/java/org/openmrs/ConceptDescription.java
+++ b/api/src/main/java/org/openmrs/ConceptDescription.java
@@ -9,12 +9,15 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
+
 import java.util.Date;
 import java.util.Locale;
 
 /**
  * ConceptDescription is the localized description of a concept.
  */
+@Audited
 public class ConceptDescription extends BaseOpenmrsObject implements Auditable, java.io.Serializable {
 	
 	private static final long serialVersionUID = -7223075113369136584L;
diff --git a/api/src/main/java/org/openmrs/ConceptMap.java b/api/src/main/java/org/openmrs/ConceptMap.java
index 7ccc9e2b33ea..c7f1df342411 100644
--- a/api/src/main/java/org/openmrs/ConceptMap.java
+++ b/api/src/main/java/org/openmrs/ConceptMap.java
@@ -9,6 +9,7 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.hibernate.search.annotations.ContainedIn;
 import org.hibernate.search.annotations.DocumentId;
 import org.hibernate.search.annotations.IndexedEmbedded;
@@ -17,6 +18,7 @@
  * The concept map object represents a mapping of Concept to ConceptSource. A concept can have 0 to
  * N mappings to any and all concept sources in the database.
  */
+@Audited
 public class ConceptMap extends BaseConceptMap {
 	
 	public static final long serialVersionUID = 754677L;
diff --git a/api/src/main/java/org/openmrs/ConceptMapType.java b/api/src/main/java/org/openmrs/ConceptMapType.java
index 605d75728a36..323b3f3f2ec7 100644
--- a/api/src/main/java/org/openmrs/ConceptMapType.java
+++ b/api/src/main/java/org/openmrs/ConceptMapType.java
@@ -10,6 +10,7 @@
 package org.openmrs;
 
 import org.codehaus.jackson.annotate.JsonIgnore;
+import org.hibernate.envers.Audited;
 
 import javax.persistence.Column;
 import javax.persistence.Entity;
@@ -26,6 +27,7 @@
  */
 @Entity
 @Table(name = "concept_map_type")
+@Audited
 public class ConceptMapType extends BaseChangeableOpenmrsMetadata {
 
 	private static final long serialVersionUID = 1L;
diff --git a/api/src/main/java/org/openmrs/ConceptName.java b/api/src/main/java/org/openmrs/ConceptName.java
index 8816525a75cb..b8ba7f856aaa 100644
--- a/api/src/main/java/org/openmrs/ConceptName.java
+++ b/api/src/main/java/org/openmrs/ConceptName.java
@@ -20,6 +20,7 @@
 import org.apache.lucene.analysis.standard.StandardFilterFactory;
 import org.apache.lucene.analysis.standard.StandardTokenizerFactory;
 import org.codehaus.jackson.annotate.JsonIgnore;
+import org.hibernate.envers.Audited;
 import org.hibernate.search.annotations.Analyze;
 import org.hibernate.search.annotations.Analyzer;
 import org.hibernate.search.annotations.AnalyzerDef;
@@ -45,6 +46,7 @@
 		@TokenFilterDef(factory = ASCIIFoldingFilterFactory.class)
 	})
 @Analyzer(definition = "ConceptNameAnalyzer")
+@Audited
 public class ConceptName extends BaseOpenmrsObject implements Auditable, Voidable, java.io.Serializable {
 	
 	public static final long serialVersionUID = 2L;
diff --git a/api/src/main/java/org/openmrs/ConceptNameTag.java b/api/src/main/java/org/openmrs/ConceptNameTag.java
index b8f992777cd7..f2adc82797ae 100644
--- a/api/src/main/java/org/openmrs/ConceptNameTag.java
+++ b/api/src/main/java/org/openmrs/ConceptNameTag.java
@@ -12,10 +12,12 @@
 import java.util.Date;
 
 import org.codehaus.jackson.annotate.JsonIgnore;
+import org.hibernate.envers.Audited;
 
 /**
  * ConceptNameTag is a textual tag which can be applied to a ConceptName.
  */
+@Audited
 public class ConceptNameTag extends BaseOpenmrsObject implements Auditable, Voidable, java.io.Serializable {
 	
 	public static final long serialVersionUID = 33226787L;
diff --git a/api/src/main/java/org/openmrs/ConceptReferenceTerm.java b/api/src/main/java/org/openmrs/ConceptReferenceTerm.java
index 4792c1a32556..4959bfd4209a 100644
--- a/api/src/main/java/org/openmrs/ConceptReferenceTerm.java
+++ b/api/src/main/java/org/openmrs/ConceptReferenceTerm.java
@@ -12,6 +12,7 @@
 import java.util.LinkedHashSet;
 import java.util.Set;
 
+import org.hibernate.envers.Audited;
 import org.hibernate.search.annotations.Analyze;
 import org.hibernate.search.annotations.DocumentId;
 import org.hibernate.search.annotations.Field;
@@ -23,6 +24,7 @@
  *
  * @since 1.9
  */
+@Audited
 public class ConceptReferenceTerm extends BaseChangeableOpenmrsMetadata {
 	
 	private static final long serialVersionUID = 1L;
diff --git a/api/src/main/java/org/openmrs/ConceptReferenceTermMap.java b/api/src/main/java/org/openmrs/ConceptReferenceTermMap.java
index 80648f5bca84..92dfe6b84335 100644
--- a/api/src/main/java/org/openmrs/ConceptReferenceTermMap.java
+++ b/api/src/main/java/org/openmrs/ConceptReferenceTermMap.java
@@ -9,6 +9,8 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
+
 /**
  * The concept Reference Term map object represents a mapping between two Concept Reference Terms. A
  * concept reference term can have 0 to N concept reference term mappings to any or all Concept
@@ -16,6 +18,7 @@
  *
  * @since 1.9
  */
+@Audited
 public class ConceptReferenceTermMap extends BaseConceptMap {
 	
 	private static final long serialVersionUID = 1L;
diff --git a/api/src/main/java/org/openmrs/ConceptSet.java b/api/src/main/java/org/openmrs/ConceptSet.java
index be6c1da3e148..6b0cd3736ca3 100644
--- a/api/src/main/java/org/openmrs/ConceptSet.java
+++ b/api/src/main/java/org/openmrs/ConceptSet.java
@@ -11,11 +11,13 @@
 
 import java.util.Date;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.util.OpenmrsUtil;
 
 /**
  * This represents a single concept within a concept set.
  */
+@Audited
 public class ConceptSet extends BaseOpenmrsObject implements Auditable, java.io.Serializable, Comparable<ConceptSet> {
 	
 	public static final long serialVersionUID = 3787L;
diff --git a/api/src/main/java/org/openmrs/ConceptSource.java b/api/src/main/java/org/openmrs/ConceptSource.java
index 5db6c8f12e76..fff53481c957 100644
--- a/api/src/main/java/org/openmrs/ConceptSource.java
+++ b/api/src/main/java/org/openmrs/ConceptSource.java
@@ -9,12 +9,15 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
+
 import java.util.Date;
 
 /**
  * A concept source is defined as any institution that keeps a concept dictionary. Examples are
  * ICD9, ICD10, SNOMED, or any other OpenMRS implementation
  */
+@Audited
 public class ConceptSource extends BaseChangeableOpenmrsMetadata {
 	
 	public static final long serialVersionUID = 375L;
diff --git a/api/src/main/java/org/openmrs/Condition.java b/api/src/main/java/org/openmrs/Condition.java
index c16e86f6c1f4..b571cf3f819d 100644
--- a/api/src/main/java/org/openmrs/Condition.java
+++ b/api/src/main/java/org/openmrs/Condition.java
@@ -9,6 +9,7 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.util.OpenmrsUtil;
 
 import javax.persistence.AssociationOverride;
@@ -40,6 +41,7 @@
  */
 @Entity
 @Table(name = "conditions")
+@Audited
 public class Condition extends BaseFormRecordableOpenmrsData {
 	
 	private static final long serialVersionUID = 1L;
diff --git a/api/src/main/java/org/openmrs/Diagnosis.java b/api/src/main/java/org/openmrs/Diagnosis.java
index e80c1d05845e..e4dff03156dd 100644
--- a/api/src/main/java/org/openmrs/Diagnosis.java
+++ b/api/src/main/java/org/openmrs/Diagnosis.java
@@ -10,6 +10,7 @@
 package org.openmrs;
 
 import org.hibernate.annotations.BatchSize;
+import org.hibernate.envers.Audited;
 
 import javax.persistence.Access;
 import javax.persistence.AccessType;
@@ -44,6 +45,7 @@
  */
 @Entity
 @Table(name = "encounter_diagnosis")
+@Audited
 public class Diagnosis extends BaseCustomizableData<DiagnosisAttribute> implements FormRecordable {
 	
 	private static final long serialVersionUID = 1L;
diff --git a/api/src/main/java/org/openmrs/DiagnosisAttribute.java b/api/src/main/java/org/openmrs/DiagnosisAttribute.java
index 1dc4241a26c9..f0ddb0568e22 100644
--- a/api/src/main/java/org/openmrs/DiagnosisAttribute.java
+++ b/api/src/main/java/org/openmrs/DiagnosisAttribute.java
@@ -9,6 +9,7 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.attribute.Attribute;
 import org.openmrs.attribute.BaseAttribute;
 
@@ -17,6 +18,7 @@
  * @see Attribute
  * @since 2.5.0
  */
+@Audited
 public class DiagnosisAttribute extends BaseAttribute<DiagnosisAttributeType, Diagnosis> implements Attribute<DiagnosisAttributeType, Diagnosis> {
 	
 	private Integer diagnosisAttributeId;
diff --git a/api/src/main/java/org/openmrs/DiagnosisAttributeType.java b/api/src/main/java/org/openmrs/DiagnosisAttributeType.java
index b93e690b11bc..71ea06125ed9 100644
--- a/api/src/main/java/org/openmrs/DiagnosisAttributeType.java
+++ b/api/src/main/java/org/openmrs/DiagnosisAttributeType.java
@@ -9,6 +9,7 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.attribute.AttributeType;
 import org.openmrs.attribute.BaseAttributeType;
 
@@ -17,6 +18,7 @@
  * @see AttributeType
  * @since 2.5.0
  */
+@Audited
 public class DiagnosisAttributeType extends BaseAttributeType<Diagnosis> implements AttributeType<Diagnosis> {
 
 	private Integer diagnosisAttributeTypeId;
diff --git a/api/src/main/java/org/openmrs/Drug.java b/api/src/main/java/org/openmrs/Drug.java
index 8bf00699d390..1fd5adb86668 100644
--- a/api/src/main/java/org/openmrs/Drug.java
+++ b/api/src/main/java/org/openmrs/Drug.java
@@ -16,6 +16,8 @@
 
 import org.apache.commons.lang3.StringUtils;
 import org.codehaus.jackson.annotate.JsonIgnore;
+import org.hibernate.envers.Audited;
+import org.hibernate.envers.NotAudited;
 import org.hibernate.search.annotations.DocumentId;
 import org.hibernate.search.annotations.Indexed;
 import org.hibernate.search.annotations.IndexedEmbedded;
@@ -25,6 +27,7 @@
  * Drug
  */
 @Indexed
+@Audited
 public class Drug extends BaseChangeableOpenmrsMetadata {
 	
 	public static final long serialVersionUID = 285L;
diff --git a/api/src/main/java/org/openmrs/DrugIngredient.java b/api/src/main/java/org/openmrs/DrugIngredient.java
index 916785904f67..3705ae70f398 100644
--- a/api/src/main/java/org/openmrs/DrugIngredient.java
+++ b/api/src/main/java/org/openmrs/DrugIngredient.java
@@ -10,6 +10,8 @@
 package org.openmrs;
 
 
+import org.hibernate.envers.Audited;
+
 import javax.persistence.Column;
 import javax.persistence.Entity;
 import javax.persistence.Id;
@@ -23,6 +25,7 @@
  */
 @Entity
 @Table(name = "drug_ingredient")
+@Audited
 public class DrugIngredient extends BaseOpenmrsObject implements Serializable, OpenmrsObject {
 	
 	public static final long serialVersionUID = 94023L;
diff --git a/api/src/main/java/org/openmrs/DrugOrder.java b/api/src/main/java/org/openmrs/DrugOrder.java
index f2d0a187c656..c304f8b0e21e 100644
--- a/api/src/main/java/org/openmrs/DrugOrder.java
+++ b/api/src/main/java/org/openmrs/DrugOrder.java
@@ -12,6 +12,7 @@
 import static org.openmrs.Order.Action.DISCONTINUE;
 
 import org.apache.commons.lang3.StringUtils;
+import org.hibernate.envers.Audited;
 import org.openmrs.util.OpenmrsUtil;
 
 /**
@@ -19,6 +20,7 @@
  *
  * @version 1.0
  */
+@Audited
 public class DrugOrder extends Order {
 
 	public static final long serialVersionUID = 72232L;
diff --git a/api/src/main/java/org/openmrs/DrugReferenceMap.java b/api/src/main/java/org/openmrs/DrugReferenceMap.java
index e28b99c54258..bd28135ea9a6 100644
--- a/api/src/main/java/org/openmrs/DrugReferenceMap.java
+++ b/api/src/main/java/org/openmrs/DrugReferenceMap.java
@@ -12,6 +12,7 @@
 import java.io.Serializable;
 import java.util.Date;
 
+import org.hibernate.envers.Audited;
 import org.hibernate.search.annotations.ContainedIn;
 import org.hibernate.search.annotations.DocumentId;
 import org.hibernate.search.annotations.IndexedEmbedded;
@@ -22,6 +23,7 @@
  * 
  * @since 1.10
  */
+@Audited
 public class DrugReferenceMap extends BaseOpenmrsObject implements Auditable, Serializable {
 	
 	public static final long serialVersionUID = 1L;
@@ -40,7 +42,7 @@ public class DrugReferenceMap extends BaseOpenmrsObject implements Auditable, Se
 	private User creator;
 	
 	private Date dateCreated;
-	
+
 	private User changedBy;
 	
 	private Date dateChanged;
diff --git a/api/src/main/java/org/openmrs/Encounter.java b/api/src/main/java/org/openmrs/Encounter.java
index 9b5daced688f..b8e27c144bdf 100644
--- a/api/src/main/java/org/openmrs/Encounter.java
+++ b/api/src/main/java/org/openmrs/Encounter.java
@@ -37,6 +37,7 @@
 
 import org.hibernate.annotations.BatchSize;
 import org.hibernate.annotations.Cascade;
+import org.hibernate.envers.Audited;
 import org.openmrs.annotation.AllowDirectAccess;
 import org.openmrs.annotation.DisableHandlers;
 import org.openmrs.api.context.Context;
@@ -54,6 +55,7 @@
 @Entity
 @Table(name = "encounter")
 @BatchSize(size = 25)
+@Audited
 public class Encounter extends BaseChangeableOpenmrsData {
 	
 	public static final long serialVersionUID = 2L;
diff --git a/api/src/main/java/org/openmrs/EncounterProvider.java b/api/src/main/java/org/openmrs/EncounterProvider.java
index 298e512b2d52..cf4ee70141de 100644
--- a/api/src/main/java/org/openmrs/EncounterProvider.java
+++ b/api/src/main/java/org/openmrs/EncounterProvider.java
@@ -9,11 +9,14 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
+
 /**
  * Mapping Class between Encounters and Providers which allows many to many relationship.
  * 
  * @since 1.9
  */
+@Audited
 public class EncounterProvider extends BaseChangeableOpenmrsData {
 	
 	public static final long serialVersionUID = 1L;
diff --git a/api/src/main/java/org/openmrs/EncounterRole.java b/api/src/main/java/org/openmrs/EncounterRole.java
index d9ae94d3b856..0d3f7564cac1 100644
--- a/api/src/main/java/org/openmrs/EncounterRole.java
+++ b/api/src/main/java/org/openmrs/EncounterRole.java
@@ -9,12 +9,15 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
+
 /**
  * An EncounterRole a role specific to the encounter. While these could match up to existing
  * organizational roles (e.g., "Nurse"), they don't have to (e.g., "Lead Surgeon")
  *
  * @since 1.9
  */
+@Audited
 public class EncounterRole extends BaseChangeableOpenmrsMetadata {
 	
 	public static final String UNKNOWN_ENCOUNTER_ROLE_UUID = "a0b03050-c99b-11e0-9572-0800200c9a66";
diff --git a/api/src/main/java/org/openmrs/EncounterType.java b/api/src/main/java/org/openmrs/EncounterType.java
index 0b5542644bdd..5c2e72670eb1 100644
--- a/api/src/main/java/org/openmrs/EncounterType.java
+++ b/api/src/main/java/org/openmrs/EncounterType.java
@@ -9,11 +9,14 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
+
 /**
  * An EncounterType defines how a certain kind of {@link Encounter}.
  * 
  * @see Encounter
  */
+@Audited
 public class EncounterType extends BaseChangeableOpenmrsMetadata {
 	
 	public static final long serialVersionUID = 789L;
diff --git a/api/src/main/java/org/openmrs/Field.java b/api/src/main/java/org/openmrs/Field.java
index bced97649505..d70496557745 100644
--- a/api/src/main/java/org/openmrs/Field.java
+++ b/api/src/main/java/org/openmrs/Field.java
@@ -13,12 +13,14 @@
 import java.util.Set;
 
 import org.codehaus.jackson.annotate.JsonIgnore;
+import org.hibernate.envers.Audited;
 
 /**
  * Field
  *
  * @version 1.0
  */
+@Audited
 public class Field extends BaseChangeableOpenmrsMetadata {
 	
 	public static final long serialVersionUID = 4454L;
diff --git a/api/src/main/java/org/openmrs/FieldAnswer.java b/api/src/main/java/org/openmrs/FieldAnswer.java
index d426c8d874ba..51ad62055d6d 100644
--- a/api/src/main/java/org/openmrs/FieldAnswer.java
+++ b/api/src/main/java/org/openmrs/FieldAnswer.java
@@ -12,6 +12,7 @@
 import java.util.Date;
 
 import org.codehaus.jackson.annotate.JsonIgnore;
+import org.hibernate.envers.Audited;
 
 import javax.persistence.Column;
 import javax.persistence.Entity;
@@ -28,6 +29,7 @@
  */
 @Entity
 @Table(name = "field_answer")
+@Audited
 public class FieldAnswer extends BaseOpenmrsObject {
 	
 	public static final long serialVersionUID = 5656L;
diff --git a/api/src/main/java/org/openmrs/FieldType.java b/api/src/main/java/org/openmrs/FieldType.java
index e5009dba2e61..31c4d4506dd1 100644
--- a/api/src/main/java/org/openmrs/FieldType.java
+++ b/api/src/main/java/org/openmrs/FieldType.java
@@ -9,9 +9,12 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
+
 /**
  * FieldType
  */
+@Audited
 public class FieldType extends BaseChangeableOpenmrsMetadata {
 	
 	public static final long serialVersionUID = 35467L;
diff --git a/api/src/main/java/org/openmrs/Form.java b/api/src/main/java/org/openmrs/Form.java
index 0b5e2f63664b..bc006cd9cf0f 100644
--- a/api/src/main/java/org/openmrs/Form.java
+++ b/api/src/main/java/org/openmrs/Form.java
@@ -9,6 +9,8 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
+
 import java.util.ArrayList;
 import java.util.HashSet;
 import java.util.List;
@@ -19,6 +21,7 @@
  *
  * @version 1.0
  */
+@Audited
 public class Form extends BaseChangeableOpenmrsMetadata {
 	
 	public static final long serialVersionUID = 845634L;
diff --git a/api/src/main/java/org/openmrs/FormField.java b/api/src/main/java/org/openmrs/FormField.java
index 777a5c103143..e1ebc9a6e8ea 100755
--- a/api/src/main/java/org/openmrs/FormField.java
+++ b/api/src/main/java/org/openmrs/FormField.java
@@ -13,6 +13,7 @@
 import java.util.Comparator;
 
 import org.codehaus.jackson.annotate.JsonIgnore;
+import org.hibernate.envers.Audited;
 
 /**
  * The FormField object relates/orders the <code>fields</code> on a <code>form</code> A form can
@@ -22,6 +23,7 @@
  * @see org.openmrs.Form
  * @see org.openmrs.Field
  */
+@Audited
 public class FormField extends BaseChangeableOpenmrsMetadata implements java.io.Serializable, Comparable<FormField> {
 	
 	public static final long serialVersionUID = 3456L;
diff --git a/api/src/main/java/org/openmrs/FormResource.java b/api/src/main/java/org/openmrs/FormResource.java
index ed85652518d0..2f701a49bd6a 100644
--- a/api/src/main/java/org/openmrs/FormResource.java
+++ b/api/src/main/java/org/openmrs/FormResource.java
@@ -12,6 +12,7 @@
 import java.util.Date;
 
 import org.codehaus.jackson.annotate.JsonIgnore;
+import org.hibernate.envers.Audited;
 import org.openmrs.customdatatype.CustomDatatypeUtil;
 import org.openmrs.customdatatype.CustomValueDescriptor;
 import org.openmrs.customdatatype.NotYetPersistedException;
@@ -29,6 +30,7 @@
  *
  * @since 1.9
  */
+@Audited
 public class FormResource extends BaseOpenmrsObject implements CustomValueDescriptor, SingleCustomValue<FormResource> {
 
 	private static final long serialVersionUID = 1L;
diff --git a/api/src/main/java/org/openmrs/GlobalProperty.java b/api/src/main/java/org/openmrs/GlobalProperty.java
index acc8ccae05ce..ce7b503b2eae 100644
--- a/api/src/main/java/org/openmrs/GlobalProperty.java
+++ b/api/src/main/java/org/openmrs/GlobalProperty.java
@@ -12,6 +12,7 @@
 import java.util.Date;
 
 import org.codehaus.jackson.annotate.JsonIgnore;
+import org.hibernate.envers.Audited;
 import org.openmrs.customdatatype.CustomDatatype;
 import org.openmrs.customdatatype.CustomDatatypeUtil;
 import org.openmrs.customdatatype.CustomValueDescriptor;
@@ -21,6 +22,7 @@
  * Global properties are simple key-value pairs persisted in the database GPs can be thought of as
  * something similar to environment variables used in operating systems.
  */
+@Audited
 public class GlobalProperty extends BaseOpenmrsObject implements CustomValueDescriptor, SingleCustomValue<GlobalProperty> {
 	
 	private static final long serialVersionUID = 1L;
diff --git a/api/src/main/java/org/openmrs/Location.java b/api/src/main/java/org/openmrs/Location.java
index 329f063a8c75..ed5f00ddc52a 100644
--- a/api/src/main/java/org/openmrs/Location.java
+++ b/api/src/main/java/org/openmrs/Location.java
@@ -12,6 +12,7 @@
 import org.hibernate.annotations.BatchSize;
 import org.hibernate.annotations.Cache;
 import org.hibernate.annotations.CacheConcurrencyStrategy;
+import org.hibernate.envers.Audited;
 import org.openmrs.annotation.Independent;
 import org.openmrs.api.APIException;
 import org.openmrs.api.context.Context;
@@ -47,6 +48,7 @@
 @Table(name = "location")
 @Cache(usage = CacheConcurrencyStrategy.READ_WRITE)
 @AttributeOverride(name = "attributes", column = @Column(name = "location_id"))
+@Audited
 public class Location extends BaseCustomizableMetadata<LocationAttribute> implements java.io.Serializable, Attributable<Location>, Address {
 	
 	public static final long serialVersionUID = 455634L;
diff --git a/api/src/main/java/org/openmrs/LocationAttribute.java b/api/src/main/java/org/openmrs/LocationAttribute.java
index bbbf72580cab..76d802f4c67e 100644
--- a/api/src/main/java/org/openmrs/LocationAttribute.java
+++ b/api/src/main/java/org/openmrs/LocationAttribute.java
@@ -9,6 +9,7 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.attribute.Attribute;
 import org.openmrs.attribute.BaseAttribute;
 
@@ -17,6 +18,7 @@
  * @see Attribute
  * @since 1.9
  */
+@Audited
 public class LocationAttribute extends BaseAttribute<LocationAttributeType, Location> implements Attribute<LocationAttributeType, Location> {
 	
 	private Integer locationAttributeId;
diff --git a/api/src/main/java/org/openmrs/LocationAttributeType.java b/api/src/main/java/org/openmrs/LocationAttributeType.java
index c9f1e67225bb..1fe43226c635 100644
--- a/api/src/main/java/org/openmrs/LocationAttributeType.java
+++ b/api/src/main/java/org/openmrs/LocationAttributeType.java
@@ -11,6 +11,7 @@
 
 import org.hibernate.annotations.GenericGenerator;
 import org.hibernate.annotations.Parameter;
+import org.hibernate.envers.Audited;
 import org.openmrs.attribute.AttributeType;
 import org.openmrs.attribute.BaseAttributeType;
 
@@ -28,6 +29,7 @@
  */
 @Entity
 @Table(name = "location_attribute_type")
+@Audited
 public class LocationAttributeType extends BaseAttributeType<Location> implements AttributeType<Location> {
 
 	@Id
diff --git a/api/src/main/java/org/openmrs/LocationTag.java b/api/src/main/java/org/openmrs/LocationTag.java
index 4bd9eb3acdad..6c0a2902e4ca 100644
--- a/api/src/main/java/org/openmrs/LocationTag.java
+++ b/api/src/main/java/org/openmrs/LocationTag.java
@@ -9,12 +9,15 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
+
 /**
  * An LocationTag allows categorization of {@link Location}s
  * 
  * @see Location
  * @since 1.5
  */
+@Audited
 public class LocationTag extends BaseChangeableOpenmrsMetadata {
 	
 	public static final long serialVersionUID = 7654L;
diff --git a/api/src/main/java/org/openmrs/Obs.java b/api/src/main/java/org/openmrs/Obs.java
index c8a12b758511..1e650363c36e 100644
--- a/api/src/main/java/org/openmrs/Obs.java
+++ b/api/src/main/java/org/openmrs/Obs.java
@@ -21,6 +21,7 @@
 import java.util.Set;
 
 import org.apache.commons.lang3.StringUtils;
+import org.hibernate.envers.Audited;
 import org.openmrs.annotation.AllowDirectAccess;
 import org.openmrs.api.APIException;
 import org.openmrs.api.context.Context;
@@ -61,6 +62,7 @@
  * 
  * @see Encounter
  */
+@Audited
 public class Obs extends BaseFormRecordableOpenmrsData {
 	
 	/**
@@ -675,6 +677,7 @@ public Boolean getValueBoolean() {
 	/**
 	 * @return Returns the valueCoded.
 	 */
+	
 	public Concept getValueCoded() {
 		return valueCoded;
 	}
diff --git a/api/src/main/java/org/openmrs/Order.java b/api/src/main/java/org/openmrs/Order.java
index e9157dc3aeca..430d32a0871e 100644
--- a/api/src/main/java/org/openmrs/Order.java
+++ b/api/src/main/java/org/openmrs/Order.java
@@ -9,14 +9,13 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.api.APIException;
 import org.openmrs.api.db.hibernate.HibernateUtil;
 import org.openmrs.order.OrderUtil;
 import org.openmrs.util.OpenmrsUtil;
 
 import java.util.Date;
-import java.util.LinkedHashSet;
-import java.util.Set;
 
 /**
  * Encapsulates information about the clinical action of a provider requesting something for a
@@ -32,6 +31,7 @@
  * 
  * @version 1.0
  */
+@Audited
 public class Order extends BaseCustomizableData<OrderAttribute> implements FormRecordable {
 
 	public static final long serialVersionUID = 4334343L;
diff --git a/api/src/main/java/org/openmrs/OrderAttribute.java b/api/src/main/java/org/openmrs/OrderAttribute.java
index 81dc0118b2a4..37b7a3ce8184 100644
--- a/api/src/main/java/org/openmrs/OrderAttribute.java
+++ b/api/src/main/java/org/openmrs/OrderAttribute.java
@@ -9,6 +9,7 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.attribute.Attribute;
 import org.openmrs.attribute.BaseAttribute;
 
@@ -17,6 +18,7 @@
  * @see Attribute
  * @since 2.5.0
  */
+@Audited
 public class OrderAttribute extends BaseAttribute<OrderAttributeType, Order>
 		implements Attribute<OrderAttributeType, Order> {
 
@@ -65,4 +67,4 @@ public Integer getOrderAttributeId() {
 	public void setOrderAttributeId(Integer orderAttributeId) {
 		this.orderAttributeId = orderAttributeId;
 	}
-}
\ No newline at end of file
+}
diff --git a/api/src/main/java/org/openmrs/OrderAttributeType.java b/api/src/main/java/org/openmrs/OrderAttributeType.java
index f8fb65e6d885..f2c17e740076 100644
--- a/api/src/main/java/org/openmrs/OrderAttributeType.java
+++ b/api/src/main/java/org/openmrs/OrderAttributeType.java
@@ -9,6 +9,7 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.attribute.AttributeType;
 import org.openmrs.attribute.BaseAttributeType;
 
@@ -17,6 +18,7 @@
  * @see AttributeType
  * @since 2.5.0
  */
+@Audited
 public class OrderAttributeType extends BaseAttributeType<Order> implements AttributeType<Order> {
 
 	private Integer orderAttributeTypeId;
diff --git a/api/src/main/java/org/openmrs/OrderFrequency.java b/api/src/main/java/org/openmrs/OrderFrequency.java
index c8fb3872f179..58653f3b8153 100644
--- a/api/src/main/java/org/openmrs/OrderFrequency.java
+++ b/api/src/main/java/org/openmrs/OrderFrequency.java
@@ -9,6 +9,8 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
+
 /**
  * The frequency at which an Order's action should be repeated, e.g. TWICE DAILY or EVERY 6 HOURS.
  * This class is backed by a Concept for i18n, synonyms, mappings, etc, but it contains additional
@@ -16,6 +18,7 @@
  * 
  * @since 1.10
  */
+@Audited
 public class OrderFrequency extends BaseChangeableOpenmrsMetadata {
 	
 	private static final long serialVersionUID = 1L;
diff --git a/api/src/main/java/org/openmrs/OrderGroup.java b/api/src/main/java/org/openmrs/OrderGroup.java
index 0aa4aeb696fc..f15ddb8d6dee 100644
--- a/api/src/main/java/org/openmrs/OrderGroup.java
+++ b/api/src/main/java/org/openmrs/OrderGroup.java
@@ -13,6 +13,7 @@
 import java.util.List;
 import java.util.Set;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.api.APIException;
 
 /**
@@ -22,6 +23,7 @@
  * 
  * @since 1.12
  */
+@Audited
 public class OrderGroup extends BaseCustomizableData<OrderGroupAttribute> {
 	
 	public static final long serialVersionUID = 72232L;
diff --git a/api/src/main/java/org/openmrs/OrderGroupAttribute.java b/api/src/main/java/org/openmrs/OrderGroupAttribute.java
index 560d0ce9a944..248a931caf86 100644
--- a/api/src/main/java/org/openmrs/OrderGroupAttribute.java
+++ b/api/src/main/java/org/openmrs/OrderGroupAttribute.java
@@ -9,6 +9,7 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.attribute.Attribute;
 import org.openmrs.attribute.BaseAttribute;
 
@@ -17,6 +18,7 @@
  * @see Attribute
  * @since 2.4.0
  */
+@Audited
 public class OrderGroupAttribute extends BaseAttribute<OrderGroupAttributeType, OrderGroup> implements Attribute<OrderGroupAttributeType, OrderGroup> {
 
 	private Integer orderGroupAttributeId;
diff --git a/api/src/main/java/org/openmrs/OrderGroupAttributeType.java b/api/src/main/java/org/openmrs/OrderGroupAttributeType.java
index 8e40c5714057..b81f08ba7367 100644
--- a/api/src/main/java/org/openmrs/OrderGroupAttributeType.java
+++ b/api/src/main/java/org/openmrs/OrderGroupAttributeType.java
@@ -9,6 +9,7 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.attribute.AttributeType;
 import org.openmrs.attribute.BaseAttributeType;
 
@@ -17,6 +18,7 @@
  * @see AttributeType
  * @since 2.4.0
  */
+@Audited
 public class OrderGroupAttributeType extends BaseAttributeType<OrderGroup> implements AttributeType<OrderGroup> {
 	
 	private Integer orderGroupAttributeTypeId;
diff --git a/api/src/main/java/org/openmrs/OrderSet.java b/api/src/main/java/org/openmrs/OrderSet.java
index 6064e2948e87..b8d904aff6e8 100644
--- a/api/src/main/java/org/openmrs/OrderSet.java
+++ b/api/src/main/java/org/openmrs/OrderSet.java
@@ -12,6 +12,7 @@
 import java.util.ArrayList;
 import java.util.List;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.api.APIException;
 
 /**
@@ -20,6 +21,7 @@
  * 
  * @since 1.12
  */
+@Audited
 public class OrderSet extends BaseCustomizableMetadata<OrderSetAttribute> {
 	
 	public static final long serialVersionUID = 72232L;
diff --git a/api/src/main/java/org/openmrs/OrderSetAttribute.java b/api/src/main/java/org/openmrs/OrderSetAttribute.java
index 282a0df10638..4a3785bb7def 100644
--- a/api/src/main/java/org/openmrs/OrderSetAttribute.java
+++ b/api/src/main/java/org/openmrs/OrderSetAttribute.java
@@ -10,6 +10,7 @@
 
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.attribute.Attribute;
 import org.openmrs.attribute.BaseAttribute;
 
@@ -18,6 +19,7 @@
  * @see Attribute
  * @since 2.4.0
  */
+@Audited
 public class OrderSetAttribute extends BaseAttribute<OrderSetAttributeType, OrderSet> implements Attribute<OrderSetAttributeType, OrderSet>{
 	
 	private static final long serialVersionUID = 1L;
diff --git a/api/src/main/java/org/openmrs/OrderSetAttributeType.java b/api/src/main/java/org/openmrs/OrderSetAttributeType.java
index 5d0752cb32a7..e58a223961ca 100644
--- a/api/src/main/java/org/openmrs/OrderSetAttributeType.java
+++ b/api/src/main/java/org/openmrs/OrderSetAttributeType.java
@@ -9,6 +9,7 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.attribute.AttributeType;
 import org.openmrs.attribute.BaseAttributeType;
 
@@ -17,6 +18,7 @@
  * @see AttributeType
  * @since 2.4.0
  */
+@Audited
 public class OrderSetAttributeType extends BaseAttributeType<OrderSet> implements AttributeType<OrderSet> {
 	
 	private Integer orderSetAttributeTypeId;
diff --git a/api/src/main/java/org/openmrs/OrderSetMember.java b/api/src/main/java/org/openmrs/OrderSetMember.java
index 27488c9c5ed1..991b858ae32f 100644
--- a/api/src/main/java/org/openmrs/OrderSetMember.java
+++ b/api/src/main/java/org/openmrs/OrderSetMember.java
@@ -9,10 +9,13 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
+
 /**
  * @since 1.12
  * OrderSetMember
  */
+@Audited
 public class OrderSetMember extends BaseChangeableOpenmrsMetadata {
 	
 	public static final long serialVersionUID = 72232L;
diff --git a/api/src/main/java/org/openmrs/OrderType.java b/api/src/main/java/org/openmrs/OrderType.java
index 9d3d99b01c3a..610a857d65dd 100644
--- a/api/src/main/java/org/openmrs/OrderType.java
+++ b/api/src/main/java/org/openmrs/OrderType.java
@@ -13,6 +13,7 @@
 import java.util.LinkedHashSet;
 
 import org.apache.commons.lang3.StringUtils;
+import org.hibernate.envers.Audited;
 import org.openmrs.annotation.Independent;
 import org.openmrs.api.APIException;
 import org.openmrs.api.context.Context;
@@ -22,6 +23,7 @@
  * Radiology TestOrders
  *
  */
+@Audited
 public class OrderType extends BaseChangeableOpenmrsMetadata {
 	
 	public static final long serialVersionUID = 23232L;
diff --git a/api/src/main/java/org/openmrs/Patient.java b/api/src/main/java/org/openmrs/Patient.java
index 3ce619e4edfc..efc6c8d90900 100644
--- a/api/src/main/java/org/openmrs/Patient.java
+++ b/api/src/main/java/org/openmrs/Patient.java
@@ -16,6 +16,7 @@
 import java.util.Set;
 import java.util.TreeSet;
 
+import org.hibernate.envers.Audited;
 import org.hibernate.search.annotations.ContainedIn;
 
 /**
@@ -24,6 +25,7 @@
  * 
  * @version 2.0
  */
+@Audited
 public class Patient extends Person {
 	
 	public static final long serialVersionUID = 93123L;
diff --git a/api/src/main/java/org/openmrs/PatientIdentifier.java b/api/src/main/java/org/openmrs/PatientIdentifier.java
index f95c6f4c1a26..516f7bf09bc5 100644
--- a/api/src/main/java/org/openmrs/PatientIdentifier.java
+++ b/api/src/main/java/org/openmrs/PatientIdentifier.java
@@ -15,6 +15,7 @@
 import java.util.Comparator;
 
 import org.codehaus.jackson.annotate.JsonIgnore;
+import org.hibernate.envers.Audited;
 import org.hibernate.search.annotations.Analyzer;
 import org.hibernate.search.annotations.Boost;
 import org.hibernate.search.annotations.DocumentId;
@@ -37,6 +38,7 @@
  * @see org.openmrs.PatientIdentifierType
  */
 @Indexed
+@Audited
 public class PatientIdentifier extends BaseChangeableOpenmrsData implements java.io.Serializable, Cloneable, Comparable<PatientIdentifier> {
 	
 	public static final long serialVersionUID = 1123121L;
diff --git a/api/src/main/java/org/openmrs/PatientIdentifierType.java b/api/src/main/java/org/openmrs/PatientIdentifierType.java
index 2853ebb65158..600530bba2b4 100644
--- a/api/src/main/java/org/openmrs/PatientIdentifierType.java
+++ b/api/src/main/java/org/openmrs/PatientIdentifierType.java
@@ -10,12 +10,14 @@
 package org.openmrs;
 
 import org.apache.commons.lang3.StringUtils;
+import org.hibernate.envers.Audited;
 import org.hibernate.search.annotations.DocumentId;
 import org.hibernate.search.annotations.Field;
 
 /**
  * PatientIdentifierType
  */
+@Audited
 public class PatientIdentifierType extends BaseChangeableOpenmrsMetadata {
 	
 	public static final long serialVersionUID = 211231L;
diff --git a/api/src/main/java/org/openmrs/PatientProgram.java b/api/src/main/java/org/openmrs/PatientProgram.java
index 8de2c51311d7..62af3c07d197 100644
--- a/api/src/main/java/org/openmrs/PatientProgram.java
+++ b/api/src/main/java/org/openmrs/PatientProgram.java
@@ -9,6 +9,7 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.customdatatype.CustomValueDescriptor;
 import org.openmrs.customdatatype.Customizable;
 import org.openmrs.util.OpenmrsUtil;
@@ -27,6 +28,7 @@
 /**
  * PatientProgram
  */
+@Audited
 public class PatientProgram extends BaseChangeableOpenmrsData implements Customizable<PatientProgramAttribute>{
 	
 	public static final long serialVersionUID = 0L;
diff --git a/api/src/main/java/org/openmrs/PatientProgramAttribute.java b/api/src/main/java/org/openmrs/PatientProgramAttribute.java
index 6015f99655ff..abb91ed24a82 100644
--- a/api/src/main/java/org/openmrs/PatientProgramAttribute.java
+++ b/api/src/main/java/org/openmrs/PatientProgramAttribute.java
@@ -10,9 +10,11 @@
 
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.attribute.Attribute;
 import org.openmrs.attribute.BaseAttribute;
 
+@Audited
 public class PatientProgramAttribute extends BaseAttribute<ProgramAttributeType, PatientProgram> implements Attribute<ProgramAttributeType, PatientProgram> {
     private Integer patientProgramAttributeId;
 
@@ -41,4 +43,4 @@ public Integer getPatientProgramAttributeId() {
     public void setPatientProgramAttributeId(Integer id) {
         this.patientProgramAttributeId = id;
     }
-}
\ No newline at end of file
+}
diff --git a/api/src/main/java/org/openmrs/PatientState.java b/api/src/main/java/org/openmrs/PatientState.java
index 9166d2b78175..548037c080f7 100644
--- a/api/src/main/java/org/openmrs/PatientState.java
+++ b/api/src/main/java/org/openmrs/PatientState.java
@@ -13,6 +13,7 @@
 
 import org.hibernate.annotations.GenericGenerator;
 import org.hibernate.annotations.Parameter;
+import org.hibernate.envers.Audited;
 import org.openmrs.util.OpenmrsUtil;
 
 import javax.persistence.Column;
@@ -29,6 +30,7 @@
  */
 @Entity
 @Table(name = "patient_state")
+@Audited
 public class PatientState extends BaseFormRecordableOpenmrsData implements java.io.Serializable, Comparable<PatientState> {
 	
 	public static final long serialVersionUID = 0L;
diff --git a/api/src/main/java/org/openmrs/Person.java b/api/src/main/java/org/openmrs/Person.java
index 421349661e79..a23577e8ed53 100644
--- a/api/src/main/java/org/openmrs/Person.java
+++ b/api/src/main/java/org/openmrs/Person.java
@@ -22,6 +22,8 @@
 
 import javax.persistence.Transient;
 import org.codehaus.jackson.annotate.JsonIgnore;
+import org.hibernate.envers.Audited;
+import org.hibernate.envers.NotAudited;
 import org.hibernate.search.annotations.Analyze;
 import org.hibernate.search.annotations.ContainedIn;
 import org.hibernate.search.annotations.DateBridge;
@@ -42,6 +44,7 @@
  * 
  * @see org.openmrs.Patient
  */
+@Audited
 public class Person extends BaseChangeableOpenmrsData {
 	
 	public static final long serialVersionUID = 2L;
@@ -81,17 +84,17 @@ public class Person extends BaseChangeableOpenmrsData {
 	private Concept causeOfDeath;
 	
 	private String causeOfDeathNonCoded;
-	
+
 	private User personCreator;
 	
 	private Date personDateCreated;
-	
+
 	private User personChangedBy;
 	
 	private Date personDateChanged;
 	
 	private Boolean personVoided = false;
-	
+
 	private User personVoidedBy;
 	
 	private Date personDateVoided;
@@ -99,6 +102,7 @@ public class Person extends BaseChangeableOpenmrsData {
 	private String personVoidReason;
 	
 	@Field
+	@NotAudited
 	private boolean isPatient;
 	
 	/**
@@ -1049,10 +1053,12 @@ public void setPersonVoidReason(String voidReason) {
 	 */
 	@Deprecated
 	@JsonIgnore
+	@NotAudited
 	public boolean isPatient() {
 		return getIsPatient();
 	}
 	
+	@NotAudited
 	public boolean getIsPatient() {
 		return isPatient;
 	}
diff --git a/api/src/main/java/org/openmrs/PersonAddress.java b/api/src/main/java/org/openmrs/PersonAddress.java
index 17c5da255c83..b28b3f681bb8 100644
--- a/api/src/main/java/org/openmrs/PersonAddress.java
+++ b/api/src/main/java/org/openmrs/PersonAddress.java
@@ -12,6 +12,7 @@
 import org.apache.commons.lang3.StringUtils;
 import org.apache.commons.lang3.builder.EqualsBuilder;
 import org.codehaus.jackson.annotate.JsonIgnore;
+import org.hibernate.envers.Audited;
 import org.openmrs.util.OpenmrsUtil;
 
 import javax.persistence.Column;
@@ -33,6 +34,7 @@
  */
 @Entity
 @Table(name = "person_address")
+@Audited
 public class PersonAddress extends BaseChangeableOpenmrsData implements java.io.Serializable, Cloneable, Comparable<PersonAddress>, Address {
 	
 	public static final long serialVersionUID = 343333L;
diff --git a/api/src/main/java/org/openmrs/PersonAttribute.java b/api/src/main/java/org/openmrs/PersonAttribute.java
index ddfb00c3f2f4..4d5cb6332da0 100644
--- a/api/src/main/java/org/openmrs/PersonAttribute.java
+++ b/api/src/main/java/org/openmrs/PersonAttribute.java
@@ -16,6 +16,7 @@
 import java.util.Date;
 
 import org.apache.commons.lang3.StringUtils;
+import org.hibernate.envers.Audited;
 import org.hibernate.search.annotations.Analyzer;
 import org.hibernate.search.annotations.Boost;
 import org.hibernate.search.annotations.DocumentId;
@@ -42,6 +43,7 @@
  * @see org.openmrs.Attributable
  */
 @Indexed
+@Audited
 public class PersonAttribute extends BaseChangeableOpenmrsData implements java.io.Serializable, Comparable<PersonAttribute> {
 	
 	public static final long serialVersionUID = 11231211232111L;
diff --git a/api/src/main/java/org/openmrs/PersonAttributeType.java b/api/src/main/java/org/openmrs/PersonAttributeType.java
index 751dfe991c26..9e740f76e258 100644
--- a/api/src/main/java/org/openmrs/PersonAttributeType.java
+++ b/api/src/main/java/org/openmrs/PersonAttributeType.java
@@ -10,6 +10,7 @@
 package org.openmrs;
 
 import org.codehaus.jackson.annotate.JsonIgnore;
+import org.hibernate.envers.Audited;
 import org.hibernate.search.annotations.Field;
 import org.openmrs.util.OpenmrsUtil;
 
@@ -29,6 +30,7 @@
  */
 @Entity
 @Table(name = "person_attribute_type")
+@Audited
 public class PersonAttributeType extends BaseChangeableOpenmrsMetadata implements java.io.Serializable, Comparable<PersonAttributeType> {
 	
 	public static final long serialVersionUID = 2112313431211L;
diff --git a/api/src/main/java/org/openmrs/PersonName.java b/api/src/main/java/org/openmrs/PersonName.java
index ec0d88a22a03..6492fe6650e6 100644
--- a/api/src/main/java/org/openmrs/PersonName.java
+++ b/api/src/main/java/org/openmrs/PersonName.java
@@ -19,6 +19,7 @@
 
 import org.apache.commons.lang3.builder.EqualsBuilder;
 import org.codehaus.jackson.annotate.JsonIgnore;
+import org.hibernate.envers.Audited;
 import org.hibernate.search.annotations.Analyzer;
 import org.hibernate.search.annotations.Boost;
 import org.hibernate.search.annotations.DocumentId;
@@ -40,6 +41,7 @@
  * A Person can have zero to n PersonName(s).
  */
 @Indexed
+@Audited
 public class PersonName extends BaseChangeableOpenmrsData implements java.io.Serializable, Cloneable, Comparable<PersonName> {
 	
 	public static final long serialVersionUID = 4353L;
diff --git a/api/src/main/java/org/openmrs/Privilege.java b/api/src/main/java/org/openmrs/Privilege.java
index 3c0ad1a6c555..9995c9e4aef1 100644
--- a/api/src/main/java/org/openmrs/Privilege.java
+++ b/api/src/main/java/org/openmrs/Privilege.java
@@ -9,11 +9,14 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
+
 /**
  * Privilege
  * 
  * @version 1.0
  */
+@Audited
 public class Privilege extends BaseChangeableOpenmrsMetadata {
 	
 	public static final long serialVersionUID = 312L;
diff --git a/api/src/main/java/org/openmrs/Program.java b/api/src/main/java/org/openmrs/Program.java
index 348c342f3666..753032a61816 100644
--- a/api/src/main/java/org/openmrs/Program.java
+++ b/api/src/main/java/org/openmrs/Program.java
@@ -13,11 +13,13 @@
 import java.util.Locale;
 import java.util.Set;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.annotation.AllowDirectAccess;
 
 /**
  * Program
  */
+@Audited
 public class Program extends BaseChangeableOpenmrsMetadata {
 	
 	public static final long serialVersionUID = 3214567L;
diff --git a/api/src/main/java/org/openmrs/ProgramAttributeType.java b/api/src/main/java/org/openmrs/ProgramAttributeType.java
index 61e9e18b25c0..a2313c694f4d 100644
--- a/api/src/main/java/org/openmrs/ProgramAttributeType.java
+++ b/api/src/main/java/org/openmrs/ProgramAttributeType.java
@@ -10,9 +10,11 @@
 
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.attribute.AttributeType;
 import org.openmrs.attribute.BaseAttributeType;
 
+@Audited
 public class ProgramAttributeType extends BaseAttributeType<PatientProgram> implements AttributeType<PatientProgram> {
     private Integer programAttributeTypeId;
 
@@ -33,4 +35,4 @@ public Integer getProgramAttributeTypeId() {
     public void setProgramAttributeTypeId(Integer programAttributeTypeId) {
         this.programAttributeTypeId = programAttributeTypeId;
     }
-}
\ No newline at end of file
+}
diff --git a/api/src/main/java/org/openmrs/ProgramWorkflow.java b/api/src/main/java/org/openmrs/ProgramWorkflow.java
index e2ae42937686..93715d068092 100644
--- a/api/src/main/java/org/openmrs/ProgramWorkflow.java
+++ b/api/src/main/java/org/openmrs/ProgramWorkflow.java
@@ -17,11 +17,13 @@
 import java.util.Set;
 import java.util.TreeSet;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.util.NaturalStrings;
 
 /**
  * ProgramWorkflow
  */
+@Audited
 public class ProgramWorkflow extends BaseChangeableOpenmrsMetadata {
 	
 	private static final long serialVersionUID = 1L;
diff --git a/api/src/main/java/org/openmrs/ProgramWorkflowState.java b/api/src/main/java/org/openmrs/ProgramWorkflowState.java
index 915d3eae5512..2e21faaabb8d 100644
--- a/api/src/main/java/org/openmrs/ProgramWorkflowState.java
+++ b/api/src/main/java/org/openmrs/ProgramWorkflowState.java
@@ -9,9 +9,12 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
+
 /**
  * ProgramWorkflowState
  */
+@Audited
 public class ProgramWorkflowState extends BaseChangeableOpenmrsMetadata {
 	
 	private static final long serialVersionUID = 1L;
diff --git a/api/src/main/java/org/openmrs/Provider.java b/api/src/main/java/org/openmrs/Provider.java
index 8722ad595bf9..2b26d3f35d7f 100644
--- a/api/src/main/java/org/openmrs/Provider.java
+++ b/api/src/main/java/org/openmrs/Provider.java
@@ -9,6 +9,7 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -17,6 +18,7 @@
  *
  * @since 1.9
  */
+@Audited
 public class Provider extends BaseCustomizableMetadata<ProviderAttribute> {
 	
 	private static final Logger log = LoggerFactory.getLogger(Provider.class);
diff --git a/api/src/main/java/org/openmrs/ProviderAttribute.java b/api/src/main/java/org/openmrs/ProviderAttribute.java
index f9144aec5207..8a7d91fd5742 100644
--- a/api/src/main/java/org/openmrs/ProviderAttribute.java
+++ b/api/src/main/java/org/openmrs/ProviderAttribute.java
@@ -9,6 +9,7 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.attribute.Attribute;
 import org.openmrs.attribute.BaseAttribute;
 
@@ -18,6 +19,7 @@
  * @see Attribute
  * @since 1.9
  */
+@Audited
 public class ProviderAttribute extends BaseAttribute<ProviderAttributeType, Provider> implements Attribute<ProviderAttributeType, Provider> {
 	
 	private Integer providerAttributeId;
diff --git a/api/src/main/java/org/openmrs/ProviderAttributeType.java b/api/src/main/java/org/openmrs/ProviderAttributeType.java
index 3ad57ffa17f0..f241621a5255 100644
--- a/api/src/main/java/org/openmrs/ProviderAttributeType.java
+++ b/api/src/main/java/org/openmrs/ProviderAttributeType.java
@@ -9,6 +9,7 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.attribute.AttributeType;
 import org.openmrs.attribute.BaseAttributeType;
 
@@ -26,6 +27,7 @@
  */
 @Entity
 @Table(name = "provider_attribute_type")
+@Audited
 public class ProviderAttributeType extends BaseAttributeType<Provider> implements AttributeType<Provider> {
 
 	@Id
diff --git a/api/src/main/java/org/openmrs/ReferralOrder.java b/api/src/main/java/org/openmrs/ReferralOrder.java
index 888f23737f6e..cb1084e68671 100644
--- a/api/src/main/java/org/openmrs/ReferralOrder.java
+++ b/api/src/main/java/org/openmrs/ReferralOrder.java
@@ -9,11 +9,14 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
+
 /**
  * This is a type of order that adds referral specific attributes.
  * 
  * @since 2.5.0
  */
+@Audited
 public class ReferralOrder extends ServiceOrder {
 
 	private static final long serialVersionUID = 1L;
diff --git a/api/src/main/java/org/openmrs/Relationship.java b/api/src/main/java/org/openmrs/Relationship.java
index 59c840693ec1..ac9a02ab6e55 100644
--- a/api/src/main/java/org/openmrs/Relationship.java
+++ b/api/src/main/java/org/openmrs/Relationship.java
@@ -11,6 +11,7 @@
 
 import org.hibernate.annotations.GenericGenerator;
 import org.hibernate.annotations.Parameter;
+import org.hibernate.envers.Audited;
 
 import javax.persistence.Column;
 import javax.persistence.Entity;
@@ -27,6 +28,7 @@
  */
 @Entity
 @Table(name = "relationship")
+@Audited
 public class Relationship extends BaseChangeableOpenmrsData {
 	
 	public static final long serialVersionUID = 323423L;
diff --git a/api/src/main/java/org/openmrs/RelationshipType.java b/api/src/main/java/org/openmrs/RelationshipType.java
index 6f82ca44a62a..0a7bdfa6e904 100644
--- a/api/src/main/java/org/openmrs/RelationshipType.java
+++ b/api/src/main/java/org/openmrs/RelationshipType.java
@@ -10,6 +10,7 @@
 package org.openmrs;
 
 import org.codehaus.jackson.annotate.JsonIgnore;
+import org.hibernate.envers.Audited;
 
 /**
  * Defines a type of relationship between two people in the database. <br>
@@ -32,6 +33,7 @@
  * In English, we run into a tricky RelationshipType with aunts and uncles. We have chosen to define
  * them as aunt/uncle-niece/nephew.
  */
+@Audited
 public class RelationshipType extends BaseChangeableOpenmrsMetadata{
 	
 	public static final long serialVersionUID = 4223L;
diff --git a/api/src/main/java/org/openmrs/Role.java b/api/src/main/java/org/openmrs/Role.java
index 6158ada4591e..daf1a3ece963 100644
--- a/api/src/main/java/org/openmrs/Role.java
+++ b/api/src/main/java/org/openmrs/Role.java
@@ -13,6 +13,7 @@
 import java.util.HashSet;
 import java.util.Set;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.util.RoleConstants;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -25,6 +26,7 @@
  *
  * @see Privilege
  */
+@Audited
 public class Role extends BaseChangeableOpenmrsMetadata {
 	
 	public static final long serialVersionUID = 1234233L;
diff --git a/api/src/main/java/org/openmrs/User.java b/api/src/main/java/org/openmrs/User.java
index 77c51355c50e..cddda88bea88 100644
--- a/api/src/main/java/org/openmrs/User.java
+++ b/api/src/main/java/org/openmrs/User.java
@@ -43,6 +43,8 @@
 import org.hibernate.annotations.LazyCollection;
 import org.hibernate.annotations.LazyCollectionOption;
 import org.hibernate.annotations.Parameter;
+import org.hibernate.envers.Audited;
+import org.hibernate.envers.NotAudited;
 import org.openmrs.api.context.Context;
 import org.openmrs.util.LocaleUtility;
 import org.openmrs.util.OpenmrsConstants;
@@ -62,6 +64,7 @@
 @Entity
 @Table(name = "users")
 @Cache(usage = CacheConcurrencyStrategy.READ_WRITE)
+@Audited
 public class User extends BaseOpenmrsObject implements java.io.Serializable, Attributable<User>, Auditable, Retireable {
 	
 	public static final long serialVersionUID = 2L ;
@@ -106,6 +109,7 @@ public class User extends BaseOpenmrsObject implements java.io.Serializable, Att
 	@MapKeyColumn(name = "property", length = 255)
 	@Column(name = "property_value", length = Integer.MAX_VALUE)
 	@Cascade({ CascadeType.SAVE_UPDATE, CascadeType.MERGE, CascadeType.EVICT })
+	@NotAudited
 	private Map<String, String> userProperties;
 
 	@Transient
diff --git a/api/src/main/java/org/openmrs/Visit.java b/api/src/main/java/org/openmrs/Visit.java
index 81cbf49c2417..25bc7c0f0281 100644
--- a/api/src/main/java/org/openmrs/Visit.java
+++ b/api/src/main/java/org/openmrs/Visit.java
@@ -31,6 +31,7 @@
 import javax.persistence.Table;
 
 import org.hibernate.annotations.BatchSize;
+import org.hibernate.envers.Audited;
 import org.openmrs.customdatatype.Customizable;
 
 /**
@@ -41,6 +42,7 @@
  */
 @Entity
 @Table(name = "visit")
+@Audited
 public class Visit extends BaseCustomizableData<VisitAttribute> implements Auditable, Customizable<VisitAttribute> {
 	
 	@Id
diff --git a/api/src/main/java/org/openmrs/VisitAttribute.java b/api/src/main/java/org/openmrs/VisitAttribute.java
index cd75bd2b77bf..a79a9aad6f08 100644
--- a/api/src/main/java/org/openmrs/VisitAttribute.java
+++ b/api/src/main/java/org/openmrs/VisitAttribute.java
@@ -9,6 +9,7 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.attribute.Attribute;
 import org.openmrs.attribute.BaseAttribute;
 
@@ -17,6 +18,7 @@
  * @see Attribute
  * @since 1.9
  */
+@Audited
 public class VisitAttribute extends BaseAttribute<VisitAttributeType, Visit> implements Attribute<VisitAttributeType, Visit> {
 	
 	private Integer visitAttributeId;
diff --git a/api/src/main/java/org/openmrs/VisitType.java b/api/src/main/java/org/openmrs/VisitType.java
index 34edae0d2585..71ec486642de 100644
--- a/api/src/main/java/org/openmrs/VisitType.java
+++ b/api/src/main/java/org/openmrs/VisitType.java
@@ -9,12 +9,15 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
+
 /**
  * Represents the assortment of visit types available to an implementation. These could include
  * items like "Initial HIV Clinic Visit", "Return TB Clinic Visit", and "Hospitalization".
  * 
  * @since 1.9
  */
+@Audited
 public class VisitType extends BaseChangeableOpenmrsMetadata{
 	
 	private static final long serialVersionUID = 1L;
diff --git a/api/src/main/java/org/openmrs/api/db/hibernate/envers/OpenMRSRevisionEntity.java b/api/src/main/java/org/openmrs/api/db/hibernate/envers/OpenMRSRevisionEntity.java
new file mode 100644
index 000000000000..0fc095399462
--- /dev/null
+++ b/api/src/main/java/org/openmrs/api/db/hibernate/envers/OpenMRSRevisionEntity.java
@@ -0,0 +1,46 @@
+/**
+ * This Source Code Form is subject to the terms of the Mozilla Public License,
+ * v. 2.0. If a copy of the MPL was not distributed with this file, You can
+ * obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
+ * the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
+ *
+ * Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
+ * graphic logo is a trademark of OpenMRS Inc.
+ */
+
+package org.openmrs.api.db.hibernate.envers;
+
+import org.hibernate.envers.DefaultRevisionEntity;
+import org.hibernate.envers.RevisionEntity;
+
+import javax.persistence.Entity;
+import java.util.Date;
+
+/**
+ * Custom revision entity for OpenMRS application
+ * Can be used to store revision metadata 
+ */
+@RevisionEntity(OpenMRSRevisionEntityListener.class)
+@Entity
+public class OpenMRSRevisionEntity extends DefaultRevisionEntity {
+
+	private Integer changedBy;
+	
+	private Date changedOn;
+
+	public Integer getChangedBy() {
+		return changedBy;
+	}
+
+	public void setChangedBy(Integer userId) {
+		this.changedBy = userId;
+	}
+
+	public Date getChangedOn() {
+		return changedOn;
+	}
+
+	public void setChangedOn(Date changedOn) {
+		this.changedOn = changedOn;
+	}
+}
diff --git a/api/src/main/java/org/openmrs/api/db/hibernate/envers/OpenMRSRevisionEntityListener.java b/api/src/main/java/org/openmrs/api/db/hibernate/envers/OpenMRSRevisionEntityListener.java
new file mode 100644
index 000000000000..2b2928057bed
--- /dev/null
+++ b/api/src/main/java/org/openmrs/api/db/hibernate/envers/OpenMRSRevisionEntityListener.java
@@ -0,0 +1,31 @@
+/**
+ * This Source Code Form is subject to the terms of the Mozilla Public License,
+ * v. 2.0. If a copy of the MPL was not distributed with this file, You can
+ * obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
+ * the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
+ *
+ * Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
+ * graphic logo is a trademark of OpenMRS Inc.
+ */
+
+package org.openmrs.api.db.hibernate.envers;
+
+import org.hibernate.envers.RevisionListener;
+import org.openmrs.api.context.Context;
+import org.openmrs.api.context.Daemon;
+
+import java.util.Date;
+
+public class OpenMRSRevisionEntityListener implements RevisionListener {
+	@Override
+	public void newRevision(Object o) {
+		OpenMRSRevisionEntity customRevisionEntity = (OpenMRSRevisionEntity) o;
+		if(Context.getUserContext().isAuthenticated()) {
+			customRevisionEntity.setChangedBy(Context.getUserContext().getAuthenticatedUser().getUserId());
+		}
+		else if(Daemon.getDaemonThreadUser() != null) {
+			customRevisionEntity.setChangedBy(Daemon.getDaemonThreadUser().getUserId());
+		}
+		customRevisionEntity.setChangedOn(new Date());
+	}
+}
diff --git a/api/src/main/java/org/openmrs/notification/Alert.java b/api/src/main/java/org/openmrs/notification/Alert.java
index 630f54aad477..26d42b3c4fe4 100644
--- a/api/src/main/java/org/openmrs/notification/Alert.java
+++ b/api/src/main/java/org/openmrs/notification/Alert.java
@@ -15,6 +15,7 @@
 import java.util.HashSet;
 import java.util.Set;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.Auditable;
 import org.openmrs.BaseOpenmrsObject;
 import org.openmrs.User;
@@ -25,6 +26,7 @@
  * to attribute the alert to. Alerts are not intended to be sent from user to user and a user cannot
  * send a "reply alert"
  */
+@Audited
 public class Alert extends BaseOpenmrsObject implements Auditable, Serializable {
 	
 	private static final long serialVersionUID = -507111111109152L;
diff --git a/api/src/main/java/org/openmrs/notification/AlertRecipient.java b/api/src/main/java/org/openmrs/notification/AlertRecipient.java
index 4fa30dd578e7..7929f0cb70bb 100644
--- a/api/src/main/java/org/openmrs/notification/AlertRecipient.java
+++ b/api/src/main/java/org/openmrs/notification/AlertRecipient.java
@@ -11,6 +11,7 @@
 
 import java.util.Date;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.BaseOpenmrsObject;
 import org.openmrs.User;
 
@@ -30,6 +31,7 @@
  */
 @Entity
 @Table(name = "notification_alert_recipient")
+@Audited
 public class AlertRecipient extends BaseOpenmrsObject {
 	
 	private static final long serialVersionUID = -507111109155L;
diff --git a/api/src/main/resources/hibernate.default.properties b/api/src/main/resources/hibernate.default.properties
index 253719630e9c..b4e66128d827 100644
--- a/api/src/main/resources/hibernate.default.properties
+++ b/api/src/main/resources/hibernate.default.properties
@@ -10,7 +10,7 @@ hibernate.connection.url=jdbc:mysql://localhost:3306/openmrs?autoReconnect=true
 hibernate.show_sql=false
 hibernate.format_sql=true
 hibernate.lazy=true
-hibernate.dialect=org.hibernate.dialect.MySQLDialect
+hibernate.dialect=org.hibernate.dialect.MySQL5Dialect
 
 # Hibernate specific connection pool properties		
 hibernate.c3p0.max_size=50
@@ -40,3 +40,7 @@ hibernate.order_updates=true
 
 #For Backward Compatibility of Sequences after Hibernate 5
 hibernate.id.new_generator_mappings=false
+
+# Hibernate envers options
+hibernate.integration.envers.enabled=false
+org.hibernate.envers.revision_listener=org.openmrs.api.db.hibernate.envers.OpenMRSRevisionEntityListener
diff --git a/api/src/main/resources/org/openmrs/api/db/hibernate/ConceptDescription.hbm.xml b/api/src/main/resources/org/openmrs/api/db/hibernate/ConceptDescription.hbm.xml
index 3d7b4057ae70..d78a95c179dd 100644
--- a/api/src/main/resources/org/openmrs/api/db/hibernate/ConceptDescription.hbm.xml
+++ b/api/src/main/resources/org/openmrs/api/db/hibernate/ConceptDescription.hbm.xml
@@ -29,7 +29,7 @@
 			class="Concept"
 		not-null="true"/>
 		
-		<property name="description" type="java.lang.String" length="65535" not-null="true"/>
+		<property name="description" type="text" length="65535" not-null="true"/>
 		<property name="locale" type="java.util.Locale" length="50" not-null="true"/>
 		<property name="dateCreated" type="java.util.Date" column="date_created" not-null="true"/>
 		<many-to-one name="creator" class="User" column="creator" not-null="true"/>
diff --git a/api/src/main/resources/org/openmrs/api/db/hibernate/ConceptName.hbm.xml b/api/src/main/resources/org/openmrs/api/db/hibernate/ConceptName.hbm.xml
index c7636012c0b5..aeb2e83f422d 100644
--- a/api/src/main/resources/org/openmrs/api/db/hibernate/ConceptName.hbm.xml
+++ b/api/src/main/resources/org/openmrs/api/db/hibernate/ConceptName.hbm.xml
@@ -29,7 +29,7 @@
 			class="Concept"
 			not-null="true"/>
 
-		<property name="name" type="java.lang.String" length="65535" not-null="true" />
+		<property name="name" type="java.lang.String" length="255" not-null="true" />
 		<property name="locale" type="java.util.Locale" length="50" not-null="true"/>
 		
 		<property name="dateCreated" type="java.util.Date" column="date_created" not-null="true"/>
diff --git a/api/src/main/resources/org/openmrs/api/db/hibernate/ConceptNameTag.hbm.xml b/api/src/main/resources/org/openmrs/api/db/hibernate/ConceptNameTag.hbm.xml
index 0ee4c6eb2caa..cb13ee6c1f97 100644
--- a/api/src/main/resources/org/openmrs/api/db/hibernate/ConceptNameTag.hbm.xml
+++ b/api/src/main/resources/org/openmrs/api/db/hibernate/ConceptNameTag.hbm.xml
@@ -24,7 +24,7 @@
 		</id>
 		
 		<property name="tag" type="java.lang.String" length="50" not-null="true" />
-		<property name="description" type="java.lang.String" length="65535"/>
+		<property name="description" type="text" length="65535"/>
 		
 		<property name="dateCreated" type="java.util.Date" column="date_created" not-null="true"/>
 		<many-to-one name="creator" class="User" column="creator" not-null="true"/>
diff --git a/api/src/main/resources/org/openmrs/api/db/hibernate/Field.hbm.xml b/api/src/main/resources/org/openmrs/api/db/hibernate/Field.hbm.xml
index a0e47c97f7d6..2be5c7bed175 100644
--- a/api/src/main/resources/org/openmrs/api/db/hibernate/Field.hbm.xml
+++ b/api/src/main/resources/org/openmrs/api/db/hibernate/Field.hbm.xml
@@ -31,7 +31,7 @@
 		<property name="name" type="java.lang.String"
 			length="255" not-null="true"/>
 		
-		<property name="description" type="java.lang.String" length="65535" />
+		<property name="description" type="text" length="65535" />
 
 		<many-to-one name="fieldType" class="FieldType" not-null="true">
 			<column name="field_type" />
@@ -45,7 +45,7 @@
 		<property name="attributeName" type="java.lang.String"
 			column="attribute_name" length="50" />
 		
-		<property name="defaultValue" type="java.lang.String"
+		<property name="defaultValue" type="text"
 			column="default_value" length="65535" />
 
 		<property name="selectMultiple" type="boolean"
diff --git a/api/src/main/resources/org/openmrs/api/db/hibernate/FormResource.hbm.xml b/api/src/main/resources/org/openmrs/api/db/hibernate/FormResource.hbm.xml
index 96c9efb978cb..37a765870a78 100644
--- a/api/src/main/resources/org/openmrs/api/db/hibernate/FormResource.hbm.xml
+++ b/api/src/main/resources/org/openmrs/api/db/hibernate/FormResource.hbm.xml
@@ -32,7 +32,7 @@
 
 		<property name="name" type="java.lang.String" not-null="false" length="255"/>
 
-		<property name="valueReference" type="java.lang.String" access="field" column="value_reference"
+		<property name="valueReference" type="text" access="field" column="value_reference"
 			not-null="false" length="65535"/>
 
         <property name="datatypeClassname" type="java.lang.String" column="datatype" length="255" />
diff --git a/api/src/main/resources/org/openmrs/api/db/hibernate/GlobalProperty.hbm.xml b/api/src/main/resources/org/openmrs/api/db/hibernate/GlobalProperty.hbm.xml
index f254bdd91541..e67ea95d39e6 100644
--- a/api/src/main/resources/org/openmrs/api/db/hibernate/GlobalProperty.hbm.xml
+++ b/api/src/main/resources/org/openmrs/api/db/hibernate/GlobalProperty.hbm.xml
@@ -23,10 +23,10 @@
 			<generator class="assigned" />
 		</id>
 
-		<property name="propertyValue" type="java.lang.String" column="property_value"
+		<property name="propertyValue" type="text" column="property_value"
 			not-null="false" length="65535"/>
 		
-		<property name="description" type="java.lang.String" not-null="false" length="65535"/>
+		<property name="description" type="text" not-null="false" length="65535"/>
 
         <property name="datatypeClassname" type="java.lang.String" column="datatype" length="255" />
         
diff --git a/api/src/main/resources/org/openmrs/api/db/hibernate/Obs.hbm.xml b/api/src/main/resources/org/openmrs/api/db/hibernate/Obs.hbm.xml
index 428211f8b41c..caafce676d92 100644
--- a/api/src/main/resources/org/openmrs/api/db/hibernate/Obs.hbm.xml
+++ b/api/src/main/resources/org/openmrs/api/db/hibernate/Obs.hbm.xml
@@ -42,7 +42,7 @@
 			column="value_numeric" length="22" />
 		<property name="valueModifier" type="java.lang.String"
 			column="value_modifier" length="2" />
-		<property name="valueText" type="java.lang.String"
+		<property name="valueText" type="text"
 			column="value_text" length="65535" />
 		<property name="valueComplex" type="java.lang.String"
 		    column="value_complex" length="1000" />
diff --git a/api/src/main/resources/org/openmrs/api/db/hibernate/Order.hbm.xml b/api/src/main/resources/org/openmrs/api/db/hibernate/Order.hbm.xml
index 95a52f72f9fd..3a3fba31ca0a 100644
--- a/api/src/main/resources/org/openmrs/api/db/hibernate/Order.hbm.xml
+++ b/api/src/main/resources/org/openmrs/api/db/hibernate/Order.hbm.xml
@@ -28,7 +28,7 @@
 		<property name="uuid" type="java.lang.String"
 			column="uuid" length="38" unique="true" />
 
-		<property name="instructions" type="java.lang.String" column="instructions" length="65535"/>
+		<property name="instructions" type="text" column="instructions" length="65535"/>
 		<property name="dateActivated" type="java.util.Date" column="date_activated" length="19" not-null="true"/>
 		<property name="autoExpireDate" type="java.util.Date" column="auto_expire_date" length="19"/>
 		<property name="dateStopped" type="java.util.Date" column="date_stopped" length="19" access="field"/>
@@ -116,7 +116,7 @@
 			<many-to-one name="drug" class="org.openmrs.Drug" not-null="false" column="drug_inventory_id" access="field"/>
             <property name="dosingType" type="java.lang.Class" column="dosing_type"  length="255"/>
             <property name="numRefills" type="int" column="num_refills" />
-            <property name="dosingInstructions" type="java.lang.String" column="dosing_instructions" length="65535"/>
+            <property name="dosingInstructions" type="text" column="dosing_instructions" length="65535"/>
             <property name="duration" type="int" column="duration"/>
             <many-to-one name="durationUnits" class="org.openmrs.Concept" column="duration_units" />
             <many-to-one name="route" class="org.openmrs.Concept" />
@@ -137,7 +137,7 @@
                     <param name="useNamed">true</param>
                 </type>
             </property>
-            <property name="clinicalHistory" type="java.lang.String" column="clinical_history" length="65535" />
+            <property name="clinicalHistory" type="text" column="clinical_history" length="65535" />
             <property name="numberOfRepeats" type="int" column="number_of_repeats"/>
             <many-to-one name="frequency" class="org.openmrs.OrderFrequency" />
             <many-to-one name="location" class="org.openmrs.Concept" />
@@ -156,7 +156,7 @@
                     <param name="useNamed">true</param>
                 </type>
             </property>
-            <property name="clinicalHistory" type="java.lang.String" column="clinical_history" length="65535" />
+            <property name="clinicalHistory" type="text" column="clinical_history" length="65535" />
             <property name="numberOfRepeats" type="int" column="number_of_repeats"/>
             <many-to-one name="frequency" class="org.openmrs.OrderFrequency" />
 			<many-to-one name="location" class="org.openmrs.Concept" />
diff --git a/api/src/main/resources/org/openmrs/api/db/hibernate/OrderSetMember.hbm.xml b/api/src/main/resources/org/openmrs/api/db/hibernate/OrderSetMember.hbm.xml
index 6b036c67cbc8..8f4a7b4bdd1f 100644
--- a/api/src/main/resources/org/openmrs/api/db/hibernate/OrderSetMember.hbm.xml
+++ b/api/src/main/resources/org/openmrs/api/db/hibernate/OrderSetMember.hbm.xml
@@ -33,7 +33,7 @@
             <column name="order_set_id"/>
         </many-to-one>
 
-        <property name="orderTemplate" type="java.lang.String"
+        <property name="orderTemplate" type="text"
                   column="order_template" length="65535"/>
         <property name="orderTemplateType" type="java.lang.String"
                   column="order_template_type" length="1024"/>
diff --git a/api/src/main/resources/org/openmrs/api/db/hibernate/Role.hbm.xml b/api/src/main/resources/org/openmrs/api/db/hibernate/Role.hbm.xml
index 7bcdfe236b79..0db83faf8626 100644
--- a/api/src/main/resources/org/openmrs/api/db/hibernate/Role.hbm.xml
+++ b/api/src/main/resources/org/openmrs/api/db/hibernate/Role.hbm.xml
@@ -19,7 +19,7 @@
 
 		<cache usage="read-write"/>
 
-		<id name="role" type="java.lang.String" column="role">
+		<id name="role" type="java.lang.String" column="role" length="50">
 			<generator class="assigned" />
 		</id>
 
diff --git a/api/src/test/java/org/openmrs/util/databasechange/ValidateHibernateMappingsDatabaseIT.java b/api/src/test/java/org/openmrs/util/databasechange/ValidateHibernateMappingsDatabaseIT.java
index 6f11558114a3..d202c231f985 100644
--- a/api/src/test/java/org/openmrs/util/databasechange/ValidateHibernateMappingsDatabaseIT.java
+++ b/api/src/test/java/org/openmrs/util/databasechange/ValidateHibernateMappingsDatabaseIT.java
@@ -19,6 +19,7 @@
 import org.hibernate.cfg.Environment;
 import org.junit.jupiter.api.Test;
 import org.openmrs.api.OrderServiceTest;
+import org.openmrs.api.db.hibernate.envers.OpenMRSRevisionEntity;
 import org.openmrs.liquibase.ChangeLogVersionFinder;
 import org.openmrs.util.H2DatabaseIT;
 import org.openmrs.util.OpenmrsClassScanner;
@@ -81,9 +82,8 @@ private SessionFactory buildSessionFactory() {
 		Configuration configuration = new Configuration().configure();
 		
 		Set<Class<?>> entityClasses = OpenmrsClassScanner.getInstance().getClassesWithAnnotation(Entity.class);
-		if (entityClasses.contains(OrderServiceTest.SomeTestOrder.class)) {
-			entityClasses.remove(OrderServiceTest.SomeTestOrder.class);
-		}
+		entityClasses.remove(OrderServiceTest.SomeTestOrder.class);
+		entityClasses.remove(OpenMRSRevisionEntity.class);
 		for (Class<?> clazz : entityClasses) {
 			configuration.addAnnotatedClass(clazz);
 		}
@@ -94,7 +94,7 @@ private SessionFactory buildSessionFactory() {
 		configuration.setProperty(Environment.PASS, PASSWORD);
 		configuration.setProperty(Environment.USE_SECOND_LEVEL_CACHE, "false");
 		configuration.setProperty(Environment.USE_QUERY_CACHE, "false");
-		
+		configuration.setProperty("hibernate.integration.envers.enabled", "false");
 		// Validate HBMs against the actual schema
 		configuration.setProperty(Environment.HBM2DDL_AUTO, "validate");
 		
diff --git a/pom.xml b/pom.xml
index c3ab2cc4fae0..84f1d0719e75 100644
--- a/pom.xml
+++ b/pom.xml
@@ -246,6 +246,11 @@
 				<artifactId>hibernate-search-orm</artifactId>
 				<version>${hibernateSearchVersion}</version>
 			</dependency>
+			<dependency>
+				<groupId>org.hibernate</groupId>
+				<artifactId>hibernate-envers</artifactId>
+				<version>${hibernateVersion}</version>
+			</dependency>
 			<dependency>
 				<groupId>org.apache.lucene</groupId>
 				<artifactId>lucene-queryparser</artifactId>
diff --git a/webapp/src/main/webapp/WEB-INF/view/scripts/jquery/autocomplete/OpenmrsAutoComplete.js b/webapp/src/main/webapp/WEB-INF/view/scripts/jquery/autocomplete/OpenmrsAutoComplete.js
index 61a02c504b1a..4d667ceeeb30 100644
--- a/webapp/src/main/webapp/WEB-INF/view/scripts/jquery/autocomplete/OpenmrsAutoComplete.js
+++ b/webapp/src/main/webapp/WEB-INF/view/scripts/jquery/autocomplete/OpenmrsAutoComplete.js
@@ -388,4 +388,4 @@ function CreateCallback(options) {
 		
 		return { label: textShown, value: value, object: item};
 	}; };
-}
\ No newline at end of file
+}

From 28820e573f03eadbd6b356a014686c995f02aded Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 17 Jun 2024 01:04:32 +0300
Subject: [PATCH 033/163] maven(deps): bump
 org.apache.maven.plugins:maven-surefire-plugin (#4664)

Bumps [org.apache.maven.plugins:maven-surefire-plugin](https://github.com/apache/maven-surefire) from 3.2.5 to 3.3.0.
- [Release notes](https://github.com/apache/maven-surefire/releases)
- [Commits](https://github.com/apache/maven-surefire/compare/surefire-3.2.5...surefire-3.3.0)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-surefire-plugin
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pom.xml b/pom.xml
index 84f1d0719e75..4bb2d2fd8b4e 100644
--- a/pom.xml
+++ b/pom.xml
@@ -603,7 +603,7 @@
 				<plugin>
 					<groupId>org.apache.maven.plugins</groupId>
 					<artifactId>maven-surefire-plugin</artifactId>
-					<version>3.2.5</version>
+					<version>3.3.0</version>
 				</plugin>
 				<plugin>
 					<groupId>org.apache.maven.plugins</groupId>
@@ -935,7 +935,7 @@
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-surefire-plugin</artifactId>
-				<version>3.2.5</version>
+				<version>3.3.0</version>
 				<configuration>
 					<failIfNoTests>false</failIfNoTests>
 					<useSystemClassLoader>false</useSystemClassLoader>

From 26163bbb092dcc33d77a465997a3ec97660d3cf5 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 17 Jun 2024 21:36:08 +0300
Subject: [PATCH 034/163] maven(deps): bump
 org.apache.maven.plugins:maven-release-plugin (#4667)

Bumps [org.apache.maven.plugins:maven-release-plugin](https://github.com/apache/maven-release) from 3.0.1 to 3.1.0.
- [Release notes](https://github.com/apache/maven-release/releases)
- [Commits](https://github.com/apache/maven-release/compare/maven-release-3.0.1...maven-release-3.1.0)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-release-plugin
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 4bb2d2fd8b4e..f2ca9ebbaad2 100644
--- a/pom.xml
+++ b/pom.xml
@@ -705,7 +705,7 @@
 				<plugin>
 					<groupId>org.apache.maven.plugins</groupId>
 					<artifactId>maven-release-plugin</artifactId>
-					<version>3.0.1</version>
+					<version>3.1.0</version>
 					<configuration>
 						<preparationGoals>clean install</preparationGoals>
 						<autoVersionSubmodules>true</autoVersionSubmodules>

From 8b769a733729bd3013854cfefb62c18c8cfa1d42 Mon Sep 17 00:00:00 2001
From: Michael Seaton <mseaton@pih.org>
Date: Mon, 17 Jun 2024 15:54:36 -0400
Subject: [PATCH 035/163] TRUNK-6244 - Obs with numeric concept with
 `allowDecimal = false` shows value as decimal instead of int (#4666)

---
 api/src/main/java/org/openmrs/Obs.java | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/api/src/main/java/org/openmrs/Obs.java b/api/src/main/java/org/openmrs/Obs.java
index 1e650363c36e..7f2648588ca5 100644
--- a/api/src/main/java/org/openmrs/Obs.java
+++ b/api/src/main/java/org/openmrs/Obs.java
@@ -25,6 +25,7 @@
 import org.openmrs.annotation.AllowDirectAccess;
 import org.openmrs.api.APIException;
 import org.openmrs.api.context.Context;
+import org.openmrs.api.db.hibernate.HibernateUtil;
 import org.openmrs.obs.ComplexData;
 import org.openmrs.obs.ComplexObsHandler;
 import org.openmrs.util.Format;
@@ -980,8 +981,9 @@ public String getValueAsString(Locale locale) {
 				if (getValueNumeric() == null) {
 					return "";
 				} else {
-					if (getConcept() instanceof ConceptNumeric) {
-						ConceptNumeric cn = (ConceptNumeric) getConcept();
+					Concept deproxiedConcept = HibernateUtil.getRealObjectFromProxy(getConcept());
+					if (deproxiedConcept instanceof ConceptNumeric) {
+						ConceptNumeric cn = (ConceptNumeric) deproxiedConcept;
 						if (!cn.getAllowDecimal()) {
 							double d = getValueNumeric();
 							int i = (int) d;

From 0ce2587784f22d515c757ae6617d84c4fd4018f1 Mon Sep 17 00:00:00 2001
From: Wikum Weerakutti <wikum@linuxdeveloper.space>
Date: Tue, 18 Jun 2024 14:25:43 +0530
Subject: [PATCH 036/163] OMRS-131: Detailed Audit Logging (#4665)

Enabled logging to the tables that we did not include in last PR.
---
 api/src/main/java/org/openmrs/ConceptNumeric.java            | 2 ++
 api/src/main/java/org/openmrs/ConceptProposal.java           | 2 ++
 api/src/main/java/org/openmrs/ConceptStateConversion.java    | 3 +++
 api/src/main/java/org/openmrs/ConceptStopWord.java           | 2 ++
 api/src/main/java/org/openmrs/TestOrder.java                 | 3 +++
 .../main/java/org/openmrs/api/db/ClobDatatypeStorage.java    | 2 ++
 api/src/main/java/org/openmrs/api/db/SerializedObject.java   | 2 ++
 api/src/main/java/org/openmrs/hl7/HL7InArchive.java          | 3 +++
 api/src/main/java/org/openmrs/hl7/HL7InError.java            | 2 ++
 api/src/main/java/org/openmrs/hl7/HL7InQueue.java            | 3 +++
 api/src/main/java/org/openmrs/hl7/HL7Source.java             | 2 ++
 api/src/main/java/org/openmrs/notification/Template.java     | 2 ++
 api/src/main/java/org/openmrs/scheduler/TaskDefinition.java  | 5 +++++
 13 files changed, 33 insertions(+)

diff --git a/api/src/main/java/org/openmrs/ConceptNumeric.java b/api/src/main/java/org/openmrs/ConceptNumeric.java
index 5426ca06befa..82d1de6df6d5 100644
--- a/api/src/main/java/org/openmrs/ConceptNumeric.java
+++ b/api/src/main/java/org/openmrs/ConceptNumeric.java
@@ -13,6 +13,7 @@
 import java.util.TreeSet;
 
 import org.codehaus.jackson.annotate.JsonIgnore;
+import org.hibernate.envers.Audited;
 import org.hibernate.search.annotations.Indexed;
 
 /**
@@ -21,6 +22,7 @@
  * @see Concept
  */
 @Indexed
+@Audited
 public class ConceptNumeric extends Concept {
 	
 	public static final long serialVersionUID = 47323L;
diff --git a/api/src/main/java/org/openmrs/ConceptProposal.java b/api/src/main/java/org/openmrs/ConceptProposal.java
index ab7c25215c9e..6e28be510834 100644
--- a/api/src/main/java/org/openmrs/ConceptProposal.java
+++ b/api/src/main/java/org/openmrs/ConceptProposal.java
@@ -11,6 +11,7 @@
 
 import java.util.Date;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.util.OpenmrsConstants;
 
 /**
@@ -20,6 +21,7 @@
  * encounter that prompted this proposal is updated with a new observation pointing at the new (or
  * edited) concept.
  */
+@Audited
 public class ConceptProposal extends BaseOpenmrsObject {
 	
 	public static final long serialVersionUID = 57344L;
diff --git a/api/src/main/java/org/openmrs/ConceptStateConversion.java b/api/src/main/java/org/openmrs/ConceptStateConversion.java
index 2d08c9c066d3..d29e8257bf30 100644
--- a/api/src/main/java/org/openmrs/ConceptStateConversion.java
+++ b/api/src/main/java/org/openmrs/ConceptStateConversion.java
@@ -9,9 +9,12 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
+
 /**
  * ConceptStateConversion
  */
+@Audited
 public class ConceptStateConversion extends BaseOpenmrsObject {
 	
 	public static final long serialVersionUID = 3214511L;
diff --git a/api/src/main/java/org/openmrs/ConceptStopWord.java b/api/src/main/java/org/openmrs/ConceptStopWord.java
index dd59c386b7ff..d49508ac9883 100644
--- a/api/src/main/java/org/openmrs/ConceptStopWord.java
+++ b/api/src/main/java/org/openmrs/ConceptStopWord.java
@@ -11,6 +11,7 @@
 
 import java.util.Locale;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.api.context.Context;
 import org.springframework.util.StringUtils;
 
@@ -21,6 +22,7 @@
  * 
  * @since 1.8
  */
+@Audited
 public class ConceptStopWord extends BaseOpenmrsObject {
 	
 	private static final long serialVersionUID = 3671020002642184656L;
diff --git a/api/src/main/java/org/openmrs/TestOrder.java b/api/src/main/java/org/openmrs/TestOrder.java
index d1a6c3a101fa..e74588894ca5 100644
--- a/api/src/main/java/org/openmrs/TestOrder.java
+++ b/api/src/main/java/org/openmrs/TestOrder.java
@@ -9,12 +9,15 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
+
 /**
  * This is a type of order that adds tests specific attributes like: laterality, clinical history,
  * etc.
  * 
  * @since 1.9.2, 1.10
  */
+@Audited
 public class TestOrder extends ServiceOrder {
 	
 	public static final long serialVersionUID = 1L;
diff --git a/api/src/main/java/org/openmrs/api/db/ClobDatatypeStorage.java b/api/src/main/java/org/openmrs/api/db/ClobDatatypeStorage.java
index d7e6200e0b91..01df85a5c8b0 100644
--- a/api/src/main/java/org/openmrs/api/db/ClobDatatypeStorage.java
+++ b/api/src/main/java/org/openmrs/api/db/ClobDatatypeStorage.java
@@ -9,6 +9,7 @@
  */
 package org.openmrs.api.db;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.BaseOpenmrsObject;
 
 /**
@@ -16,6 +17,7 @@
  * 
  * @since 1.9
  */
+@Audited
 public class ClobDatatypeStorage extends BaseOpenmrsObject {
 	
 	private Integer id;
diff --git a/api/src/main/java/org/openmrs/api/db/SerializedObject.java b/api/src/main/java/org/openmrs/api/db/SerializedObject.java
index d357e3a2a834..7c0aff5026a8 100644
--- a/api/src/main/java/org/openmrs/api/db/SerializedObject.java
+++ b/api/src/main/java/org/openmrs/api/db/SerializedObject.java
@@ -11,6 +11,7 @@
 
 import org.hibernate.annotations.GenericGenerator;
 import org.hibernate.annotations.Parameter;
+import org.hibernate.envers.Audited;
 import org.openmrs.BaseChangeableOpenmrsMetadata;
 import org.openmrs.serialization.OpenmrsSerializer;
 
@@ -26,6 +27,7 @@
  */
 @Entity
 @Table(name = "serialized_object")
+@Audited
 public class SerializedObject extends BaseChangeableOpenmrsMetadata {
 
 	@Id
diff --git a/api/src/main/java/org/openmrs/hl7/HL7InArchive.java b/api/src/main/java/org/openmrs/hl7/HL7InArchive.java
index 21ecba83b6c5..fa03afb1f529 100644
--- a/api/src/main/java/org/openmrs/hl7/HL7InArchive.java
+++ b/api/src/main/java/org/openmrs/hl7/HL7InArchive.java
@@ -9,12 +9,15 @@
  */
 package org.openmrs.hl7;
 
+import org.hibernate.envers.Audited;
+
 /**
  * Represents a successfully processed hl7 message.
  * 
  * @see HL7InQueue
  * @see HL7Service
  */
+@Audited
 public class HL7InArchive extends HL7QueueItem {
 	
 	private int hl7InArchiveId;
diff --git a/api/src/main/java/org/openmrs/hl7/HL7InError.java b/api/src/main/java/org/openmrs/hl7/HL7InError.java
index d5641891794e..a2eb90dfdaca 100644
--- a/api/src/main/java/org/openmrs/hl7/HL7InError.java
+++ b/api/src/main/java/org/openmrs/hl7/HL7InError.java
@@ -9,6 +9,7 @@
  */
 package org.openmrs.hl7;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.api.APIException;
 
 /**
@@ -17,6 +18,7 @@
  * @see HL7InQueue
  * @see HL7Service
  */
+@Audited
 public class HL7InError extends HL7QueueItem {
 	
 	private static final int MAX_ERROR_DETAILS_LENGTH = 16777215;
diff --git a/api/src/main/java/org/openmrs/hl7/HL7InQueue.java b/api/src/main/java/org/openmrs/hl7/HL7InQueue.java
index 705d31f8a3f2..7eaefe43d24a 100644
--- a/api/src/main/java/org/openmrs/hl7/HL7InQueue.java
+++ b/api/src/main/java/org/openmrs/hl7/HL7InQueue.java
@@ -9,11 +9,14 @@
  */
 package org.openmrs.hl7;
 
+import org.hibernate.envers.Audited;
+
 /**
  * Represents an hl7 message that has yet to be processed.
  * 
  * @see HL7Service
  */
+@Audited
 public class HL7InQueue extends HL7QueueItem {
 	
 	private static final long serialVersionUID = 8882704913734764446L;
diff --git a/api/src/main/java/org/openmrs/hl7/HL7Source.java b/api/src/main/java/org/openmrs/hl7/HL7Source.java
index c95c2fa71a9c..f6674b359456 100644
--- a/api/src/main/java/org/openmrs/hl7/HL7Source.java
+++ b/api/src/main/java/org/openmrs/hl7/HL7Source.java
@@ -9,11 +9,13 @@
  */
 package org.openmrs.hl7;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.BaseChangeableOpenmrsMetadata;
 
 /**
  * Names a unique location that hl7 messages could be coming from.
  */
+@Audited
 public class HL7Source extends BaseChangeableOpenmrsMetadata {
 	                                  
 	private static final long serialVersionUID = 3062136520728193223L;
diff --git a/api/src/main/java/org/openmrs/notification/Template.java b/api/src/main/java/org/openmrs/notification/Template.java
index d6e6a592f6b9..691232f41b16 100644
--- a/api/src/main/java/org/openmrs/notification/Template.java
+++ b/api/src/main/java/org/openmrs/notification/Template.java
@@ -11,8 +11,10 @@
 
 import java.util.Map;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.BaseOpenmrsObject;
 
+@Audited
 public class Template extends BaseOpenmrsObject {
 	
 	/**
diff --git a/api/src/main/java/org/openmrs/scheduler/TaskDefinition.java b/api/src/main/java/org/openmrs/scheduler/TaskDefinition.java
index 2cb37356380b..5c07e02be5e5 100644
--- a/api/src/main/java/org/openmrs/scheduler/TaskDefinition.java
+++ b/api/src/main/java/org/openmrs/scheduler/TaskDefinition.java
@@ -13,6 +13,8 @@
 import java.util.HashMap;
 import java.util.Map;
 
+import org.hibernate.envers.Audited;
+import org.hibernate.envers.NotAudited;
 import org.openmrs.BaseChangeableOpenmrsMetadata;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -20,6 +22,7 @@
 /**
  * Represents the metadata for a task that can be scheduled.
  */
+@Audited
 public class TaskDefinition extends BaseChangeableOpenmrsMetadata {
 	
 	private static final Logger log = LoggerFactory.getLogger(TaskDefinition.class);
@@ -49,6 +52,7 @@ public class TaskDefinition extends BaseChangeableOpenmrsMetadata {
 	private Boolean started;
 	
 	// Relationships
+	@NotAudited
 	private Map<String, String> properties;
 	
 	/**
@@ -98,6 +102,7 @@ public void setId(Integer id) {
 	 * 
 	 * @return the data map
 	 */
+	@NotAudited
 	public Map<String, String> getProperties() {
 		return this.properties;
 	}

From 3a7925a3484c098078db6e70f9b6f4a6cbb4e884 Mon Sep 17 00:00:00 2001
From: Ryan McCauley <32387857+k4pran@users.noreply.github.com>
Date: Tue, 18 Jun 2024 21:43:54 +0100
Subject: [PATCH 037/163] TRUNK-6208: Upgrade 2.7 Platform to Liquibase 4.27.0
 (#4637)

* TRUNK-6208: Upgrade 2.7 Platform to Liquibase 4.27.0

* TRUNK-6208 remove h2 changeset

* TRUNK-6208 update changeset count after remove h2 changeset

* TRUNK-6208 change type from int(11) to int

---------

Co-authored-by: dkayiwa <dkayiwa@openmrs.org>
---
 .../db/hibernate/HibernateEncounterDAO.java   |   3 --
 .../openmrs/liquibase/ChangeLogDetective.java |  21 +++++++--
 .../liquibase/LiquibaseScopeHandling.java     |  33 +++++++++++++
 .../OpenmrsClassLoaderResourceAccessor.java   |  23 +++++++--
 .../org/openmrs/util/DatabaseUpdater.java     |  44 +++++++++++++++---
 .../org/openmrs/util/OpenmrsConstants.java    |   4 ++
 .../liquibase-update-to-latest-2.0.x.xml      |   2 +
 .../liquibase-update-to-latest-2.2.x.xml      |   2 +-
 .../Database1_9_7UpgradeIT.java               |  16 +++----
 .../util/databasechange/openmrs-1.9.7.h2.db   | Bin 6303744 -> 3110912 bytes
 .../org/openmrs/util/testLiquibase.xml        |   2 +-
 liquibase/pom.xml                             |   2 +-
 liquibase/src/main/resources/log4j2.xml       |   1 +
 pom.xml                                       |   2 +-
 webapp/src/main/resources/log4j2.xml          |   1 +
 15 files changed, 126 insertions(+), 30 deletions(-)
 create mode 100644 api/src/main/java/org/openmrs/liquibase/LiquibaseScopeHandling.java

diff --git a/api/src/main/java/org/openmrs/api/db/hibernate/HibernateEncounterDAO.java b/api/src/main/java/org/openmrs/api/db/hibernate/HibernateEncounterDAO.java
index 407d3f727329..1aef8c39cfa2 100644
--- a/api/src/main/java/org/openmrs/api/db/hibernate/HibernateEncounterDAO.java
+++ b/api/src/main/java/org/openmrs/api/db/hibernate/HibernateEncounterDAO.java
@@ -19,7 +19,6 @@
 import javax.persistence.criteria.Predicate;
 import javax.persistence.criteria.Root;
 import java.util.ArrayList;
-import java.util.Collection;
 import java.util.Collections;
 import java.util.Date;
 import java.util.HashMap;
@@ -27,13 +26,11 @@
 import java.util.Map;
 import java.util.stream.Collectors;
 
-import liquibase.pro.packaged.Q;
 import org.apache.commons.lang3.StringUtils;
 import org.hibernate.FlushMode;
 import org.hibernate.SQLQuery;
 import org.hibernate.Session;
 import org.hibernate.SessionFactory;
-import org.hibernate.criterion.Order;
 import org.openmrs.Cohort;
 import org.openmrs.Encounter;
 import org.openmrs.EncounterProvider;
diff --git a/api/src/main/java/org/openmrs/liquibase/ChangeLogDetective.java b/api/src/main/java/org/openmrs/liquibase/ChangeLogDetective.java
index c8b9673934e3..f08df226397b 100644
--- a/api/src/main/java/org/openmrs/liquibase/ChangeLogDetective.java
+++ b/api/src/main/java/org/openmrs/liquibase/ChangeLogDetective.java
@@ -17,6 +17,7 @@
 import liquibase.LabelExpression;
 import liquibase.Liquibase;
 import liquibase.changelog.ChangeSet;
+import liquibase.command.core.StatusCommandStep;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -85,9 +86,16 @@ public String getInitialLiquibaseSnapshotVersion(String context, LiquibaseProvid
 			Liquibase liquibase = null;
 			try {
 				for (String filename : changeSets) {
+					String scopeId = LiquibaseScopeHandling.enterLiquibaseUILoggingService();
+					
 					liquibase = liquibaseProvider.getLiquibase(filename);
-					List<ChangeSet> rawUnrunChangeSets = liquibase.listUnrunChangeSets(new Contexts(context),
-					    new LabelExpression());
+					
+					List<ChangeSet> rawUnrunChangeSets = new StatusCommandStep()
+						.listUnrunChangeSets(new Contexts(context), 
+							new LabelExpression(), liquibase.getDatabaseChangeLog(), liquibase.getDatabase());
+
+					
+					LiquibaseScopeHandling.exitLiquibaseScope(scopeId);
 					liquibase.close();
 					
 					List<ChangeSet> refinedUnrunChangeSets = excludeVintageChangeSets(filename, rawUnrunChangeSets);
@@ -141,9 +149,14 @@ public List<String> getUnrunLiquibaseUpdateFileNames(String snapshotVersion, Str
 		Liquibase liquibase = null;
 		try {
 			for (String filename : updateFileNames) {
+				String scopeId = LiquibaseScopeHandling.enterLiquibaseUILoggingService();
 				liquibase = liquibaseProvider.getLiquibase(filename);
-				List<ChangeSet> unrunChangeSets = liquibase.listUnrunChangeSets(new Contexts(context),
-				    new LabelExpression());
+
+				List<ChangeSet> unrunChangeSets = new StatusCommandStep()
+					.listUnrunChangeSets(new Contexts(context),
+						new LabelExpression(), liquibase.getDatabaseChangeLog(), liquibase.getDatabase());
+
+				LiquibaseScopeHandling.exitLiquibaseScope(scopeId);
 				liquibase.close();
 				
 				log.info("file '{}' contains {} un-run change sets", filename, unrunChangeSets.size());
diff --git a/api/src/main/java/org/openmrs/liquibase/LiquibaseScopeHandling.java b/api/src/main/java/org/openmrs/liquibase/LiquibaseScopeHandling.java
new file mode 100644
index 000000000000..971cf4c72294
--- /dev/null
+++ b/api/src/main/java/org/openmrs/liquibase/LiquibaseScopeHandling.java
@@ -0,0 +1,33 @@
+/**
+ * This Source Code Form is subject to the terms of the Mozilla Public License,
+ * v. 2.0. If a copy of the MPL was not distributed with this file, You can
+ * obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
+ * the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
+ *
+ * Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
+ * graphic logo is a trademark of OpenMRS Inc.
+ */
+package org.openmrs.liquibase;
+
+import java.util.Collections;
+import java.util.Map;
+import java.util.logging.Level;
+
+import liquibase.Scope;
+import liquibase.ui.LoggerUIService;
+
+public class LiquibaseScopeHandling {
+	
+	public static String enterLiquibaseUILoggingService() throws Exception {
+		// Temp workaround to silence liquibase writing to stdout - https://github.com/liquibase/liquibase/issues/2396,
+		// https://github.com/liquibase/liquibase/issues/3651
+		LoggerUIService loggerUIService = new LoggerUIService();
+		loggerUIService.setStandardLogLevel(Level.FINE);
+		Map<String, Object> m = Collections.singletonMap(Scope.Attr.ui.name(), loggerUIService);
+		return Scope.enter(m);
+	}
+	
+	public static void exitLiquibaseScope(String scopeId) throws Exception {
+		Scope.exit(scopeId);
+	}
+}
diff --git a/api/src/main/java/org/openmrs/liquibase/OpenmrsClassLoaderResourceAccessor.java b/api/src/main/java/org/openmrs/liquibase/OpenmrsClassLoaderResourceAccessor.java
index dd859362de9c..92a621525c57 100644
--- a/api/src/main/java/org/openmrs/liquibase/OpenmrsClassLoaderResourceAccessor.java
+++ b/api/src/main/java/org/openmrs/liquibase/OpenmrsClassLoaderResourceAccessor.java
@@ -11,16 +11,21 @@
 
 import liquibase.resource.ClassLoaderResourceAccessor;
 import liquibase.resource.InputStreamList;
+import liquibase.resource.Resource;
 import org.openmrs.util.OpenmrsClassLoader;
 
 import java.io.IOException;
-import java.io.InputStream;
 import java.net.URI;
+import java.util.List;
 
 /**
  * A customization of Liquibase's {@link ClassLoaderResourceAccessor} which defaults to the OpenMRS ClassLoader and has
  * special handling for our liquibase.xml files, which occur multiple times on the classpath.
+ * @deprecated As of 2.7.0, replaced by the usage of {@link #search(String, boolean)} or {@link #getAll(String)},
+ * as this provides a better handling of paths that map to multiple resources using Liquibase's DUPLICATE_FILE_MODE.
+ * Refer to {@link liquibase.GlobalConfiguration#DUPLICATE_FILE_MODE} for the configuration and usage details.
  */
+@Deprecated
 public class OpenmrsClassLoaderResourceAccessor extends ClassLoaderResourceAccessor {
 
 	public OpenmrsClassLoaderResourceAccessor() {
@@ -33,15 +38,23 @@ public OpenmrsClassLoaderResourceAccessor(ClassLoader classLoader) {
 
 	@Override
 	public InputStreamList openStreams(String relativeTo, String streamPath) throws IOException {
-		InputStreamList result = super.openStreams(relativeTo, streamPath);
-		if (result != null && !result.isEmpty() && result.size() > 1) {
+		List<Resource> resources = super.getAll(streamPath);
+		InputStreamList result = new InputStreamList();
+		if (resources == null || resources.isEmpty()) {
+			return result;
+		}
+
+		for (Resource resource : resources) {
+			result.add(resource.getUri(), resource.openInputStream());
+		}
+		if (!result.isEmpty() && result.size() > 1) {
 			try (InputStreamList oldResult = result) {
 				URI uri = oldResult.getURIs().get(0);
 				result = new InputStreamList(uri, uri.toURL().openStream());
 			}
-			
+
 		}
-		
+
 		return result;
 	}
 }
diff --git a/api/src/main/java/org/openmrs/util/DatabaseUpdater.java b/api/src/main/java/org/openmrs/util/DatabaseUpdater.java
index b7a6dcb7009e..101850fcbf4b 100644
--- a/api/src/main/java/org/openmrs/util/DatabaseUpdater.java
+++ b/api/src/main/java/org/openmrs/util/DatabaseUpdater.java
@@ -10,6 +10,7 @@
 package org.openmrs.util;
 
 import liquibase.Contexts;
+import liquibase.GlobalConfiguration;
 import liquibase.LabelExpression;
 import liquibase.Liquibase;
 import liquibase.RuntimeEnvironment;
@@ -23,6 +24,7 @@
 import liquibase.changelog.filter.DbmsChangeSetFilter;
 import liquibase.changelog.filter.ShouldRunChangeSetFilter;
 import liquibase.changelog.visitor.UpdateVisitor;
+import liquibase.command.core.StatusCommandStep;
 import liquibase.database.Database;
 import liquibase.database.DatabaseFactory;
 import liquibase.database.jvm.JdbcConnection;
@@ -33,6 +35,7 @@
 import liquibase.resource.CompositeResourceAccessor;
 import liquibase.resource.FileSystemResourceAccessor;
 import liquibase.resource.ResourceAccessor;
+import liquibase.ui.LoggerUIService;
 import org.apache.commons.io.IOUtils;
 import org.openmrs.annotation.Authorized;
 import org.openmrs.api.context.Context;
@@ -40,6 +43,7 @@
 import org.openmrs.liquibase.ChangeLogVersionFinder;
 import org.openmrs.liquibase.ChangeSetExecutorCallback;
 import org.openmrs.liquibase.LiquibaseProvider;
+import org.openmrs.liquibase.LiquibaseScopeHandling;
 import org.openmrs.liquibase.OpenmrsClassLoaderResourceAccessor;
 import org.openmrs.module.ModuleClassLoader;
 import org.slf4j.Logger;
@@ -68,6 +72,7 @@
 import java.util.Map;
 import java.util.Properties;
 import java.util.Set;
+import java.util.logging.Level;
 
 /**
  * This class uses Liquibase to update the database. <br>
@@ -214,8 +219,13 @@ public static List<String> executeChangelog(String changeLogFile, Contexts conte
 		
 		log.debug("Setting up liquibase object to run changelog: {}", changeLogFile);
 		Liquibase liquibase = getLiquibase(changeLogFile, cl);
-		
-		int numChangeSetsToRun = liquibase.listUnrunChangeSets(contexts, new LabelExpression()).size();
+
+		String scopeId = LiquibaseScopeHandling.enterLiquibaseUILoggingService();
+		int numChangeSetsToRun = new StatusCommandStep()
+			.listUnrunChangeSets(contexts,
+				new LabelExpression(), liquibase.getDatabaseChangeLog(), liquibase.getDatabase()).size();
+		LiquibaseScopeHandling.exitLiquibaseScope(scopeId);
+
 		Database database = null;
 		LockService lockHandler = null;
 		
@@ -233,7 +243,7 @@ public static List<String> executeChangelog(String changeLogFile, Contexts conte
 			
 			// ensure that the change log history service is initialised
 			//
-			ChangeLogHistoryServiceFactory.getInstance().getChangeLogService(database).init();
+			Scope.getCurrentScope().getSingleton(ChangeLogHistoryServiceFactory.class).getChangeLogService(database).init();
 			
 			logIterator.run(new OpenmrsUpdateVisitor(database, callback, numChangeSetsToRun),
 			    new RuntimeEnvironment(database, contexts, new LabelExpression()));
@@ -426,8 +436,13 @@ private static Liquibase getLiquibase(String changeLogFile, ClassLoader cl) thro
 				changeLogFile = EMPTY_CHANGE_LOG_FILE;
 			}
 
+			configureLiquibaseDuplicateFileMode();
+
 			// ensure that the change log history service is initialised
-			ChangeLogHistoryServiceFactory.getInstance().getChangeLogService(database).init();
+			Scope.getCurrentScope()
+				.getSingleton(ChangeLogHistoryServiceFactory.class)
+				.getChangeLogService(database)
+				.init();
 			return new Liquibase(changeLogFile, getCompositeResourceAccessor(cl), database);
 		}
 		catch (Exception e) {
@@ -604,6 +619,7 @@ public static List<OpenMRSChangeSet> getDatabaseChanges() throws Exception {
 		Liquibase liquibase = null;
 		try {
 			for (String filename : changeLogFileNames) {
+				String scopeId = LiquibaseScopeHandling.enterLiquibaseUILoggingService();
 				liquibase = getLiquibase(filename);
 				List<ChangeSet> changeSets = liquibase.getDatabaseChangeLog().getChangeSets();
 				
@@ -611,6 +627,7 @@ public static List<OpenMRSChangeSet> getDatabaseChanges() throws Exception {
 					OpenMRSChangeSet openMRSChangeSet = new OpenMRSChangeSet(changeSet, liquibase.getDatabase());
 					result.add(openMRSChangeSet);
 				}
+				LiquibaseScopeHandling.exitLiquibaseScope(scopeId);
 				liquibase.close();
 			}
 		}
@@ -669,18 +686,22 @@ public static List<OpenMRSChangeSet> getUnrunDatabaseChanges(String... changeLog
 			
 			List<OpenMRSChangeSet> results = new ArrayList<>();
 			
+			String scopeId = LiquibaseScopeHandling.enterLiquibaseUILoggingService();
 			for (String changelogFile : changeLogFilenames) {
 				Liquibase liquibase = getLiquibase(changelogFile, null);
 				database = liquibase.getDatabase();
 				
-				List<ChangeSet> changeSets = liquibase.listUnrunChangeSets(new Contexts(CONTEXT), new LabelExpression());
-				
+				List<ChangeSet> changeSets = new StatusCommandStep()
+					.listUnrunChangeSets(new Contexts(CONTEXT),
+						new LabelExpression(), liquibase.getDatabaseChangeLog(), liquibase.getDatabase());
+
 				for (ChangeSet changeSet : changeSets) {
 					OpenMRSChangeSet omrschangeset = new OpenMRSChangeSet(changeSet, database);
 					results.add(omrschangeset);
 				}
 			}
 			
+			LiquibaseScopeHandling.exitLiquibaseScope(scopeId);
 			return results;
 			
 		}
@@ -884,4 +905,15 @@ private static CompositeResourceAccessor getCompositeResourceAccessor(ClassLoade
 		ResourceAccessor fsFO = new FileSystemResourceAccessor(OpenmrsUtil.getApplicationDataDirectoryAsFile());
 		return new CompositeResourceAccessor(openmrsFO, fsFO);
 	}
+	
+	private static void configureLiquibaseDuplicateFileMode() {
+		final String dupFlagModeKey = GlobalConfiguration.DUPLICATE_FILE_MODE.getKey();
+		final String dupFlagMode = Context.getRuntimeProperties().getProperty(dupFlagModeKey);
+
+		if (dupFlagMode != null) {
+			System.setProperty(dupFlagModeKey, dupFlagMode);
+		} else if (System.getProperty(dupFlagModeKey) == null) {
+			System.setProperty(dupFlagModeKey, OpenmrsConstants.LIQUIBASE_DUPLICATE_FILE_MODE_DEFAULT);
+		}
+	}
 }
diff --git a/api/src/main/java/org/openmrs/util/OpenmrsConstants.java b/api/src/main/java/org/openmrs/util/OpenmrsConstants.java
index 94294a8c3984..c692dea0debc 100644
--- a/api/src/main/java/org/openmrs/util/OpenmrsConstants.java
+++ b/api/src/main/java/org/openmrs/util/OpenmrsConstants.java
@@ -20,6 +20,7 @@
 import java.util.Map;
 import java.util.Properties;
 
+import liquibase.GlobalConfiguration;
 import org.apache.commons.io.IOUtils;
 import org.openmrs.GlobalProperty;
 import org.openmrs.api.context.Context;
@@ -1314,6 +1315,9 @@ public static enum PERSON_TYPE {
 	/** Value for the long person name format */
 	public static final String PERSON_NAME_FORMAT_LONG = "long";
 	
+	// Liquibase Constants
+	public static final String LIQUIBASE_DUPLICATE_FILE_MODE_DEFAULT = GlobalConfiguration.DuplicateFileMode.WARN.name();
+	
 	private OpenmrsConstants() {
 	}
 	
diff --git a/api/src/main/resources/org/openmrs/liquibase/updates/liquibase-update-to-latest-2.0.x.xml b/api/src/main/resources/org/openmrs/liquibase/updates/liquibase-update-to-latest-2.0.x.xml
index e319301c2a4a..d3c8f368363e 100644
--- a/api/src/main/resources/org/openmrs/liquibase/updates/liquibase-update-to-latest-2.0.x.xml
+++ b/api/src/main/resources/org/openmrs/liquibase/updates/liquibase-update-to-latest-2.0.x.xml
@@ -1790,6 +1790,7 @@
 		<validCheckSum>1b6141be59a8a243b9e56d0aad952af</validCheckSum> <!-- checksum from before idExceptions added -->
 		<validCheckSum>89cc7a14b0582f157ea2dbb9de092fd</validCheckSum> <!-- current checksum with idExceptions param added -->
 		<validCheckSum><comment>Changes to new concept_reference tables</comment>3:4edd135921eb263d4811cf1c22ef4846</validCheckSum>
+		<validCheckSum><comment>Account for trailing whitespace</comment>9:5d41399f930d6de5c0030986b78f35e5</validCheckSum>
 		<preConditions onFail="MARK_RAN">
 			<not>
 				<or>
@@ -3521,6 +3522,7 @@
 		<validCheckSum><comment>After changing to boolean</comment>3:b57c0f651ed477457fd16e503eaf51a4</validCheckSum>
 		<validCheckSum>3:002108aacdf55731f4fd472d5308c5c8</validCheckSum>
         <validCheckSum>3:6a72bbb390155596e52da4e8d065d1a2</validCheckSum>
+        <validCheckSum><comment>Account for trailing whitespace</comment>9:f41906e41efde3f7473abaa52fa161dc</validCheckSum>
         <validCheckSum><comment>Fixing TRUNK-4040</comment>3:74026cd4543ebbf561999a81c276224d</validCheckSum>
 		<preConditions onFail="MARK_RAN">
 			<not>
diff --git a/api/src/main/resources/org/openmrs/liquibase/updates/liquibase-update-to-latest-2.2.x.xml b/api/src/main/resources/org/openmrs/liquibase/updates/liquibase-update-to-latest-2.2.x.xml
index 823ddfe4e95d..45d9d6084430 100644
--- a/api/src/main/resources/org/openmrs/liquibase/updates/liquibase-update-to-latest-2.2.x.xml
+++ b/api/src/main/resources/org/openmrs/liquibase/updates/liquibase-update-to-latest-2.2.x.xml
@@ -63,7 +63,7 @@
                 <column name="retired" type="boolean" defaultValueBoolean="false">
                     <constraints nullable="false" />
                 </column>
-                <column name="retired_by" type="int(11)" />
+                <column name="retired_by" type="int" />
                 <column name="date_retired" type="datetime" />
                 <column name="retire_reason" type="varchar(255)" defaultValue="null" />
                 <column name="uuid" type="char(38)">
diff --git a/api/src/test/java/org/openmrs/util/databasechange/Database1_9_7UpgradeIT.java b/api/src/test/java/org/openmrs/util/databasechange/Database1_9_7UpgradeIT.java
index cb10a0c119b2..86b81dcee28e 100644
--- a/api/src/test/java/org/openmrs/util/databasechange/Database1_9_7UpgradeIT.java
+++ b/api/src/test/java/org/openmrs/util/databasechange/Database1_9_7UpgradeIT.java
@@ -157,7 +157,7 @@ public void shouldUpgradeFromClean1_9To1_10() throws IOException, SQLException {
 	public void shouldFailMigratingDrugOrdersIfUnitsToConceptsMappingsIsNotSet() throws IOException, SQLException {
 		upgradeTestUtil.executeDataset(STANDARD_TEST_1_9_7_DATASET);
 		createOrderEntryUpgradeFileWithTestData("");
-		String errorMsgSubString1 = "liquibase.exception.MigrationFailedException: Migration failed for change set liquibase-update-to-latest.xml::201401101647-TRUNK-4187::wyclif";
+		String errorMsgSubString1 = "liquibase.exception.CommandExecutionException: liquibase.exception.LiquibaseException: liquibase.exception.MigrationFailedException: Migration failed for changeset liquibase-update-to-latest.xml::201401101647-TRUNK-4187::wyclif";
 		String errorMsgSubString2 = Context.getMessageSourceService().getMessage("upgrade.settings.file.not.have.mapping",
 		    new Object[] { "mg" }, null);
 		IOException exception = assertThrows(IOException.class, () -> upgradeTestUtil.upgrade());
@@ -174,7 +174,7 @@ public void shouldFailMigratingDrugOrdersIfUnitsToConceptsMappingsDoesNotPointTo
 		    "mg=111\ntab(s)=112\n1/day\\ x\\ 7\\ days/week=113\n2/day\\ x\\ 7\\ days/week=114");
 		createOrderEntryUpgradeFileWithTestData("mg=111\ntab(s)=invalid");
 		
-		String errorMsgSubString1 = "liquibase.exception.MigrationFailedException: Migration failed for change set liquibase-update-to-latest.xml::201401101647-TRUNK-4187::wyclif";
+		String errorMsgSubString1 = "liquibase.exception.CommandExecutionException: liquibase.exception.LiquibaseException: liquibase.exception.MigrationFailedException: Migration failed for changeset liquibase-update-to-latest.xml::201401101647-TRUNK-4187::wyclif";
 		IOException exception = assertThrows(IOException.class, () -> upgradeTestUtil.upgrade());
 		assertThat(exception.getMessage(), containsString(errorMsgSubString1));
 		assertThat(exception.getMessage(), containsString("For input string: \"invalid\""));
@@ -224,7 +224,7 @@ public void shouldFailIfAnyDrugOrderUnitsNotMappedToConceptsAreFound() throws Ex
 		//map the frequencies only
 		createOrderEntryUpgradeFileWithTestData("1/day\\ x\\ 7\\ days/week=113\n2/day\\ x\\ 7\\ days/week=114");
 		
-		String errorMsgSubString1 = "liquibase.exception.MigrationFailedException: Migration failed for change set liquibase-update-to-latest.xml::201401101647-TRUNK-4187::wyclif";
+		String errorMsgSubString1 = "liquibase.exception.CommandExecutionException: liquibase.exception.LiquibaseException: liquibase.exception.MigrationFailedException: Migration failed for changeset liquibase-update-to-latest.xml::201401101647-TRUNK-4187::wyclif";
 		IOException exception = assertThrows(IOException.class, () -> upgradeTestUtil.upgrade());
 		assertThat(exception.getMessage(), containsString(errorMsgSubString1));
 	}
@@ -240,7 +240,7 @@ public void shouldFailIfAnyDrugOrderFrequenciesNotMappedToConceptsAreFound() thr
 		//map the dose units only
 		createOrderEntryUpgradeFileWithTestData("mg=111\ntab(s)=112");
 		
-		String errorMsgSubString1 = "liquibase.exception.MigrationFailedException: Migration failed for change set liquibase-update-to-latest.xml::201401101647-TRUNK-4187::wyclif";
+		String errorMsgSubString1 = "liquibase.exception.CommandExecutionException: liquibase.exception.LiquibaseException: liquibase.exception.MigrationFailedException: Migration failed for changeset liquibase-update-to-latest.xml::201401101647-TRUNK-4187::wyclif";
 		
 		IOException exception = assertThrows(IOException.class, () -> upgradeTestUtil.upgrade());
 		assertThat(exception.getMessage(), containsString(errorMsgSubString1));
@@ -344,7 +344,7 @@ public void shouldFailIfThereAreDrugsWithDoseStrengthAndNoNullUnits() throws IOE
 		createOrderEntryUpgradeFileWithTestData(
 		    "mg=111\ntab(s)=112\n1/day\\ x\\ 7\\ days/week=113\n2/day\\ x\\ 7\\ days/week=114");
 		
-		String errorMsgSubString = "liquibase.exception.MigrationFailedException: Migration failed for change set liquibase-update-to-latest.xml::201403262140-TRUNK-4265::wyclif";
+		String errorMsgSubString = "liquibase.exception.CommandExecutionException: liquibase.exception.LiquibaseException: liquibase.exception.MigrationFailedException: Migration failed for changeset liquibase-update-to-latest.xml::201403262140-TRUNK-4265::wyclif";
 		IOException exception = assertThrows(IOException.class, () -> upgradeTestUtil.upgrade());
 		assertThat(exception.getMessage(), containsString(errorMsgSubString));
 	}
@@ -357,7 +357,7 @@ public void shouldFailIfThereAreDrugsWithDoseStrengthAndNoBlankUnits() throws IO
 		createOrderEntryUpgradeFileWithTestData(
 		    "mg=111\ntab(s)=112\n1/day\\ x\\ 7\\ days/week=113\n2/day\\ x\\ 7\\ days/week=114");
 		
-		String errorMsgSubString = "liquibase.exception.MigrationFailedException: Migration failed for change set liquibase-update-to-latest.xml::201403262140-TRUNK-4265::wyclif";
+		String errorMsgSubString = "liquibase.exception.CommandExecutionException: liquibase.exception.LiquibaseException: liquibase.exception.MigrationFailedException: Migration failed for changeset liquibase-update-to-latest.xml::201403262140-TRUNK-4265::wyclif";
 		IOException exception = assertThrows(IOException.class, () -> upgradeTestUtil.upgrade());
 		assertThat(exception.getMessage(), containsString(errorMsgSubString));
 	}
@@ -371,7 +371,7 @@ public void shouldFailIfThereAreAnyOrderTypesInTheDatabaseOtherThanDrugOrderType
 		createOrderEntryUpgradeFileWithTestData(
 		    "mg=111\ntab(s)=112\n1/day\\ x\\ 7\\ days/week=113\n2/day\\ x\\ 7\\ days/week=114");
 		
-		String errorMsgSubString = "liquibase.exception.MigrationFailedException: Migration failed for change set liquibase-update-to-latest.xml::201404091110::wyclif";
+		String errorMsgSubString = "liquibase.exception.CommandExecutionException: liquibase.exception.LiquibaseException: liquibase.exception.MigrationFailedException: Migration failed for changeset liquibase-update-to-latest.xml::201404091110::wyclif";
 		IOException exception = assertThrows(IOException.class, () -> upgradeTestUtil.upgrade());
 		assertThat(exception.getLocalizedMessage(), containsString(errorMsgSubString));
 	}
@@ -428,7 +428,7 @@ public void shouldFailIfThereAreOrderersWithNoAssociatedProviderAccounts() throw
 		createOrderEntryUpgradeFileWithTestData(
 		    "mg=111\ntab(s)=112\n1/day\\ x\\ 7\\ days/week=113\n2/day\\ x\\ 7\\ days/week=114");
 		
-		String errorMsgSubString = "liquibase.exception.MigrationFailedException: Migration failed for change set liquibase-update-to-latest.xml::201406262016::wyclif";
+		String errorMsgSubString = "liquibase.exception.CommandExecutionException: liquibase.exception.LiquibaseException: liquibase.exception.MigrationFailedException: Migration failed for changeset liquibase-update-to-latest.xml::201406262016::wyclif";
 		IOException exception = assertThrows(IOException.class, () -> upgradeTestUtil.upgrade());
 		assertThat(exception.getMessage(), containsString(errorMsgSubString));
 	}
diff --git a/api/src/test/resources/org/openmrs/util/databasechange/openmrs-1.9.7.h2.db b/api/src/test/resources/org/openmrs/util/databasechange/openmrs-1.9.7.h2.db
index 0ea1f8d346191f8ed5e4f6627bdbd0033cac54ae..a0f2f833eea9766c2575703871401f03ab6e68f7 100644
GIT binary patch
delta 83253
zcmbTe2Ut``7dOt_JNI5-L0JVWDrLn+*`+NgmbFErbY$0P#D!hdSU^Q%-b4kvv4JSZ
z*rJIw)=eWZvBj8T1-r4w7B#lSXpHUq-DM&Ae((SJp6Ac=aL%4HbI+VPGjrxlxwr6Q
zp;&ltJ6qx2pl8z1`)<y^*B1kYxw(mV@qfQu`;*Ua%KsyIeuIqCT@8jY<}h_s<_Fa7
z@ur)`&5bQ{a}#>@0qF4o0~~rmg$vgSfQP1vkgokjg>N0^fZM;70PBAt<H3uo6u@~q
z6o+ZOqSMx&42|;7yL-C1GbLA$4~X*XT>4RxI?H^!!rQrv-#Sc-M9-E%nx}<}ZhqO)
zjVu<+7|#|#nqOV?cC)1mX)Kl)&yXO^J{PmK+48Pu^B~RVE}Aky>w+}1U9_BOdB-z2
zNVDJtIfahxV;Sce6r_3nyo!!Yw-kE@25Bl>^!y}CadYhtEvvQl@K8p1%EvWwmX~zW
zTN+f0U#-pi`iR@L<$6o~`$9>IM#Hs1nypW&<SlyBQljBLL7Flb<8FUTiDv|A^-ooX
zKK(6|=<|M-N!l=En&hmin_CZ?-D;y9Z&)JeKm9Cv&(I)EVO1J!dBZZnvrUlZx1uVu
zw0Xla%(FE#cF{$BEv25Vf;3;b=&KgXlnCubLJK8~ba(UE%anJ1Wb(D2ncQ?gldK0B
z&pgb;4=S0^^C)9Gjx(lrm>8pjJuGu6u7_n-`O)r{Fh-glmSFPgZrNV`sH;W8D733(
zJH64x@)K?EY$>JC&X(!H+SONF<;Y(%#qtf4`)_B`%$<zCznh7d_Audv!*o`lPA1E*
zG^dkgz2M!7wq7;+QE^90K505x#?hh<mZLPkz2zxgOt7pA*803zEpii+&uxK72b1zX
zWBk)EnD|q9wMg#-%g@xXo#iH_wS{8lc*|`%5N9c(1xCv-(!^QHgSCN6t3|D3@`;a`
z+-^0Kmak=!-+IPpY+zz%hpCxZ-Zj?JozbQk%N(i~W0^@qqb<wmhbYUE^7)aL)~t{3
zlb(>%eiC<UuAEY~Dl?UArJdp{-<E%nKa|JGsd8&sl+H+>OLHW<)IqAp@A9Ac3O<gf
z@Rr<7JS95BnW9yU7wZVOgztrA!dM~MVfu%$ZuGHa31QyU>xwx9ZLob4P%sI1fx>9%
z3v)=TA$~ezZj8+qlWPr&w(7IPqO<k3u<W=fTbSM!lM@q}8)uJ;u`Xn!54VH}-!QUu
z0G`e$vn52w&_)Jw6Qf0Oz=s(P?GF3_qc<Xe=P*iY13Z(_@K(SdGcrcwvGKGj7^pE_
zyJ-#)9E=*Z1^G6O2|%WujQVy0*^%DkK&|NDJ!IO$=x-Cqbb7ruP#4mvRWs8pA0UbT
zzKA-#MlEGfEhrsNu!w~^5dCPO))GRsnp#>gBefO4dWR?w<*a6O9?A$`GaAs|5)!P{
z+N#@gAydW@lmGmH$<a%gG<+H3^FCx^iNiEPr1uS$=k$@@a-P16uymjsdW#<g=q&~G
zINY+6hJ{-uQ$?8N{fWL$e}KF*Q@EQ+Ijwx7EKz1C7NxTiq12XN$Y<n(@|W^TdA2-C
z&Xl{$O{B-tQRzFWOd29}lbZ5>_!(Z#=kt-g7uSg|#9zc6;wEvi_`Wz?G>axNOl&54
z3un;YTZP5K6ya@Qm@q(SD>Pt#uuJR+`=J)wz*evlR>Vd!E9+5W`UVzl$}J6gbx9j;
z9WpF@^zefGto*!D1*Vti!Fi(#dcH(k#}o`sOm*hZw~ikDcHSskw?rqIJ1TE@GF2#+
zM&Yj|IXO0a_LxB|by(h@Avxir3#_9G>^3pIiX3hoVY3$Gje4h&5gdR{IPP=_0m4zH
zdWE146H|~ed{|zNwO~lzi1CR|%0AXUtcWE!e_P+l8&lBAQk^3_cZhwM4aK}O%sz|J
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
z%0D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

literal 6303744
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%0AFL)uOI){CEyse
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%0DZ*2
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%0AT-7J|=en<qZI^|9COpU26a+X#jxz
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
zfAR&q@VF#DF}Y`cr%yc7nP2z|R<?0s1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0
z009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{
z1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009IL
zKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~
z0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**
z5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0
z009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{
z1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009IL
zKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~
z0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**
z5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0
z009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{
z1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009IL
zKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~
z0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**
z5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0
z009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{
z1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009IL
zKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~
z0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**
z5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0
z009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{
z1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009IL
zKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~
z0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**
z5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0
z009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{
z1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009IL
zKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~0R#|0009ILKmY**5I_I{1Q0*~
e0R#|0009ILKmY**5I_I{1Q0*~0R+xM;Qs+D7UPrv

diff --git a/api/src/test/resources/org/openmrs/util/testLiquibase.xml b/api/src/test/resources/org/openmrs/util/testLiquibase.xml
index 8a294bd267a8..d381a13071aa 100644
--- a/api/src/test/resources/org/openmrs/util/testLiquibase.xml
+++ b/api/src/test/resources/org/openmrs/util/testLiquibase.xml
@@ -25,7 +25,7 @@
 	</changeSet>
 	
 	<changeSet id="testSqlFile" author="OpenMRS" runAlways="true">
-		<sqlFile endDelimiter=";" path="sql/testSqlFile.sql" relativeToChangelogFile="true" stripComments="true" />
+		<sqlFile endDelimiter=";" path="org/openmrs/util/sql/testSqlFile.sql" relativeToChangelogFile="false" stripComments="true" />
 	</changeSet>
 	
 </databaseChangeLog>
diff --git a/liquibase/pom.xml b/liquibase/pom.xml
index 753ea855d0de..d25eaf59a237 100644
--- a/liquibase/pom.xml
+++ b/liquibase/pom.xml
@@ -74,7 +74,7 @@
 			<plugin>
 				<groupId>org.liquibase</groupId>
 				<artifactId>liquibase-maven-plugin</artifactId>
-				<version>4.8.0</version>
+				<version>4.27.0</version>
 				<configuration>
 					<changeLogFile>snapshots/${changelogfile}</changeLogFile>
 					<diffTypes>${diffTypes}</diffTypes>
diff --git a/liquibase/src/main/resources/log4j2.xml b/liquibase/src/main/resources/log4j2.xml
index f5ac70012362..0a4547a922cd 100644
--- a/liquibase/src/main/resources/log4j2.xml
+++ b/liquibase/src/main/resources/log4j2.xml
@@ -19,6 +19,7 @@
 	</Appenders>
 	<Loggers>
 		<Logger name="org.openmrs.liquibase" level="INFO" />
+		<Logger name="liquibase.resource.CompositeResourceAccessor" level="ERROR" additivity="false"/>
 		<Root level="OFF">
 			<AppenderRef ref="CONSOLE" />
 		</Root>
diff --git a/pom.xml b/pom.xml
index f2ca9ebbaad2..73770ed2e911 100644
--- a/pom.xml
+++ b/pom.xml
@@ -274,7 +274,7 @@
 			<dependency>
 				<groupId>org.liquibase</groupId>
 				<artifactId>liquibase-core</artifactId>
-				<version>4.8.0</version>
+				<version>4.27.0</version>
 				<exclusions>
 					<exclusion>
 						<groupId>ch.qos.logback</groupId>
diff --git a/webapp/src/main/resources/log4j2.xml b/webapp/src/main/resources/log4j2.xml
index b1fd757d9478..c3fe8d98b0db 100644
--- a/webapp/src/main/resources/log4j2.xml
+++ b/webapp/src/main/resources/log4j2.xml
@@ -47,6 +47,7 @@
 		<Logger name="org.springframework" level="WARN" />
 		<Logger name="org.openmrs" level="WARN" />
 		<Logger name="liquibase" level="INFO" />
+		<Logger name="liquibase.resource.CompositeResourceAccessor" level="ERROR" additivity="false"/>
 		<!-- 
 			This controls the LoggingAdvice class that wraps around the OpenMRS services 
 			WARN == don't log anything special for the services

From 8eec7b22165e896358e004750bd3cfbab954cac5 Mon Sep 17 00:00:00 2001
From: Wikum Weerakutti <wikum@linuxdeveloper.space>
Date: Wed, 19 Jun 2024 19:35:12 +0530
Subject: [PATCH 038/163] Removed the Schedule class (#4670)

---
 .../java/org/openmrs/scheduler/Schedule.java  | 240 ------------------
 .../openmrs/scheduler/db/SchedulerDAO.java    |   9 -
 .../db/hibernate/HibernateSchedulerDAO.java   |  19 --
 .../scheduler/db/hibernate/Schedule.hbm.xml   |  35 ---
 4 files changed, 303 deletions(-)
 delete mode 100644 api/src/main/java/org/openmrs/scheduler/Schedule.java
 delete mode 100644 api/src/main/resources/org/openmrs/scheduler/db/hibernate/Schedule.hbm.xml

diff --git a/api/src/main/java/org/openmrs/scheduler/Schedule.java b/api/src/main/java/org/openmrs/scheduler/Schedule.java
deleted file mode 100644
index a1e498660057..000000000000
--- a/api/src/main/java/org/openmrs/scheduler/Schedule.java
+++ /dev/null
@@ -1,240 +0,0 @@
-/**
- * This Source Code Form is subject to the terms of the Mozilla Public License,
- * v. 2.0. If a copy of the MPL was not distributed with this file, You can
- * obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
- * the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
- *
- * Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
- * graphic logo is a trademark of OpenMRS Inc.
- */
-package org.openmrs.scheduler;
-
-import java.text.DateFormat;
-import java.text.SimpleDateFormat;
-import java.util.Date;
-
-/**
- * Describes when to start a task and how often it should be executed.
- */
-public class Schedule {
-	
-	/**
-	 * Schedule identifier
-	 */
-	private Integer id;
-	
-	/**
-	 * Name of the schedule
-	 */
-	private String name;
-	
-	/**
-	 * Description of the schedule
-	 */
-	private String description;
-	
-	/**
-	 * Date and time to start the task
-	 */
-	private Date startTime;
-	
-	/**
-	 * Interval used to determine the next execution time
-	 */
-	private long repeatInterval;
-	
-	/**
-	 * Flag that indicates whether to begin as soon as the scheduler starts.
-	 */
-	private boolean startOnStartup;
-	
-	/**
-	 * The date format pattern used to set the start date when start date is passed in as a string
-	 */
-	private String dateFormat;
-	
-	/**
-	 * Default TODO Move to constants or properties
-	 */
-	public static final String DEFAULT_DATE_FORMAT = "MM-dd-yyyy hh:mm:ss";
-	
-	/**
-	 * Date formatter used to format a date specified by a string
-	 */
-	private transient DateFormat dateFormatter;
-	
-	/**
-	 * Constants
-	 */
-	public static final int MILLISECONDS_PER_SECOND = 1000;
-	
-	public static final int SECONDS_PER_MINUTE = 60;
-	
-	public static final int MINUTES_PER_HOUR = 60;
-	
-	public static final int HOURS_PER_DAY = 24;
-	
-	public static final int DAYS_PER_WEEK = 7;
-	
-	public static final int DAILY = MILLISECONDS_PER_SECOND * SECONDS_PER_MINUTE * MINUTES_PER_HOUR;
-	
-	public static final int WEEKLY = DAILY * DAYS_PER_WEEK;
-	
-	/**
-	 * Public no-arg constructor.
-	 */
-	public Schedule() {
-		this(null, null, new Date(), 0);
-	}
-	
-	/**
-	 * Public constructor
-	 * 
-	 * @param startTime Date for when to start the task (does not need to be in the future if the
-	 *            interval is specified).
-	 * @param repeatInterval interval time in seconds to wait between executing task (&lt;= 0 indicates
-	 *            that it should only be run once)
-	 */
-	public Schedule(Date startTime, long repeatInterval) {
-		this(null, null, startTime, repeatInterval);
-	}
-	
-	/**
-	 * Public constructor
-	 * 
-	 * @param name
-	 * @param description
-	 * @param startTime Date for when to start the task (does not need to be in the future if the
-	 *            interval is specified).
-	 * @param repeatInterval interval time in seconds to wait between executing task (&lt;= 0 indicates
-	 *            that it should only be run once)
-	 */
-	public Schedule(String name, String description, Date startTime, long repeatInterval) {
-		this.name = name;
-		this.description = description;
-		this.startTime = startTime;
-		this.repeatInterval = repeatInterval;
-		this.dateFormatter = new SimpleDateFormat(DEFAULT_DATE_FORMAT);
-	}
-	
-	/**
-	 * Gets the identifier of the schedule.
-	 * 
-	 * @return the identifier of the schedule
-	 */
-	public Integer getId() {
-		return this.id;
-	}
-	
-	/**
-	 * Sets the identifier of the schedule.
-	 * 
-	 * @param id the identifier of the schedule
-	 */
-	public void setId(Integer id) {
-		this.id = id;
-	}
-	
-	/**
-	 * Gets the name of the schedule.
-	 * 
-	 * @return the name of the schedule
-	 */
-	public String getName() {
-		return this.name;
-	}
-	
-	/**
-	 * Sets the name of the schedule.
-	 * 
-	 * @param name the name of the schedule
-	 */
-	public void setName(String name) {
-		this.name = name;
-	}
-	
-	/**
-	 * Gets the description of the schedule.
-	 * 
-	 * @return the description of the schedule
-	 */
-	public String getDescription() {
-		return this.description;
-	}
-	
-	/**
-	 * Sets the description of the schedule.
-	 * 
-	 * @param description the description of the schedule
-	 */
-	public void setDescription(String description) {
-		this.description = description;
-	}
-	
-	/**
-	 * Get the start time for when the task should be executed.
-	 * 
-	 * @return long start time
-	 */
-	public Date getStartTime() {
-		return startTime;
-	}
-	
-	/**
-	 * Set the start time for when the task should be executed. For instance, use "new Date()", if
-	 * you want it to start now.
-	 * 
-	 * @param startTime start time for the task
-	 */
-	public void setStartTime(Date startTime) {
-		this.startTime = startTime;
-	}
-	
-	/**
-	 * Gets the number of seconds until task is executed again.
-	 * 
-	 * @return long number of seconds.
-	 */
-	public long getRepeatInterval() {
-		return repeatInterval;
-	}
-	
-	/**
-	 * Sets the number of seconds until task is executed again.
-	 * 
-	 * @param repeatInterval
-	 */
-	public void setRepeatInterval(long repeatInterval) {
-		this.repeatInterval = repeatInterval;
-	}
-	
-	/**
-	 * Get the date format used to set the start time.
-	 */
-	public String getDateFormat() {
-		return this.dateFormat;
-	}
-	
-	/**
-	 * Sets the date format used to set the start time.
-	 */
-	public void setDateFormat(String dateFormat) {
-		this.dateFormat = dateFormat;
-		this.dateFormatter = new SimpleDateFormat(dateFormat);
-	}
-	
-	/**
-	 * Gets the flag that indicates whether we start on scheduler startup.
-	 */
-	public Boolean getStartOnStartup() {
-		return this.startOnStartup;
-	}
-	
-	/**
-	 * Sets the flag that indicates whether we start on scheduler startup.
-	 */
-	public void setStartOnStartup(Boolean startOnStartup) {
-		this.startOnStartup = startOnStartup;
-	}
-	
-}
diff --git a/api/src/main/java/org/openmrs/scheduler/db/SchedulerDAO.java b/api/src/main/java/org/openmrs/scheduler/db/SchedulerDAO.java
index 16614f80a5d0..968bfa5efaab 100644
--- a/api/src/main/java/org/openmrs/scheduler/db/SchedulerDAO.java
+++ b/api/src/main/java/org/openmrs/scheduler/db/SchedulerDAO.java
@@ -12,7 +12,6 @@
 import java.util.List;
 
 import org.openmrs.api.db.DAOException;
-import org.openmrs.scheduler.Schedule;
 import org.openmrs.scheduler.TaskDefinition;
 
 /**
@@ -77,14 +76,6 @@ public interface SchedulerDAO {
 	 */
 	public void deleteTask(Integer taskId) throws DAOException;
 	
-	/**
-	 * Get schedule by internal identifier
-	 * 
-	 * @param scheduleId internal schedule identifier
-	 * @return schedule with given internal identifier
-	 * @throws DAOException
-	 */
-	public Schedule getSchedule(Integer scheduleId) throws DAOException;
 	
 	/**
 	 * Get task by public name.
diff --git a/api/src/main/java/org/openmrs/scheduler/db/hibernate/HibernateSchedulerDAO.java b/api/src/main/java/org/openmrs/scheduler/db/hibernate/HibernateSchedulerDAO.java
index e1ebe191bc8f..db50250650d4 100644
--- a/api/src/main/java/org/openmrs/scheduler/db/hibernate/HibernateSchedulerDAO.java
+++ b/api/src/main/java/org/openmrs/scheduler/db/hibernate/HibernateSchedulerDAO.java
@@ -18,7 +18,6 @@
 import org.hibernate.SessionFactory;
 import org.openmrs.api.db.DAOException;
 import org.openmrs.api.db.hibernate.HibernateUtil;
-import org.openmrs.scheduler.Schedule;
 import org.openmrs.scheduler.TaskDefinition;
 import org.openmrs.scheduler.db.SchedulerDAO;
 import org.slf4j.Logger;
@@ -159,24 +158,6 @@ public void deleteTask(TaskDefinition taskConfig) throws DAOException {
 		sessionFactory.getCurrentSession().delete(taskConfig);
 	}
 	
-	/**
-	 * Get schedule by internal identifier
-	 * 
-	 * @param scheduleId internal schedule identifier
-	 * @return schedule with given internal identifier
-	 * @throws DAOException
-	 */
-	@Override
-	public Schedule getSchedule(Integer scheduleId) throws DAOException {
-		Schedule schedule = sessionFactory.getCurrentSession().get(Schedule.class, scheduleId);
-		
-		if (schedule == null) {
-			log.error("Schedule '" + scheduleId + "' not found");
-			throw new ObjectRetrievalFailureException(Schedule.class, scheduleId);
-		}
-		return schedule;
-	}
-
 	/**
 	 * 
 	 * @see org.openmrs.scheduler.db.SchedulerDAO#getTaskByUuid(java.lang.String)
diff --git a/api/src/main/resources/org/openmrs/scheduler/db/hibernate/Schedule.hbm.xml b/api/src/main/resources/org/openmrs/scheduler/db/hibernate/Schedule.hbm.xml
deleted file mode 100644
index 7a8296130f22..000000000000
--- a/api/src/main/resources/org/openmrs/scheduler/db/hibernate/Schedule.hbm.xml
+++ /dev/null
@@ -1,35 +0,0 @@
-<?xml version="1.0"?>
-<!--
-
-    This Source Code Form is subject to the terms of the Mozilla Public License,
-    v. 2.0. If a copy of the MPL was not distributed with this file, You can
-    obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
-    the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
-
-    Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
-    graphic logo is a trademark of OpenMRS Inc.
-
--->
-<!DOCTYPE hibernate-mapping PUBLIC
-    "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
-    "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">
-<hibernate-mapping package="org.openmrs.scheduler">
-
-	<class name="Schedule" table="scheduler_schedule">
-		<id name="id" type="int" column="schedule_id" unsaved-value="0">
-			<generator class="native">
-				<param name="sequence">scheduler_schedule_schedule_id_seq</param>
-			</generator>
-		</id>
-		<discriminator column="schedule_id" insert="false" />
-		
-		<property name="name" type="java.lang.String" column="name" not-null="true" length="50" />
-		<property name="description" type="java.lang.String" column="description" length="1024" />
-		<property name="repeatInterval" type="long" column="repeat_interval" />
-		<property name="startTime" type="java.util.Date" column="start_time" />
-		
-		<!--
-		<property name="startOnStartup" type="java.lang.Boolean" column="start_on_startup" length="1" not-null="true"/>
-		-->
-	</class>
-</hibernate-mapping>

From 6d0637fb79ae5ee02c0faecb1bd0645d3ea8773b Mon Sep 17 00:00:00 2001
From: Wikum Weerakutti <wikum@linuxdeveloper.space>
Date: Wed, 19 Jun 2024 20:23:25 +0530
Subject: [PATCH 039/163] OMRS-131: Detailed Audit Logging (#4668)

Enabled logging to the tables that we did not include in last PR.
---
 api/src/main/java/org/openmrs/ConceptAttributeType.java     | 2 ++
 api/src/main/java/org/openmrs/VisitAttributeType.java       | 2 ++
 ...penMRSRevisionEntity.java => OpenmrsRevisionEntity.java} | 6 ++++--
 ...tityListener.java => OpenmrsRevisionEntityListener.java} | 4 ++--
 api/src/main/java/org/openmrs/person/PersonMergeLog.java    | 2 ++
 api/src/main/resources/hibernate.default.properties         | 2 +-
 .../databasechange/ValidateHibernateMappingsDatabaseIT.java | 4 ++--
 7 files changed, 15 insertions(+), 7 deletions(-)
 rename api/src/main/java/org/openmrs/api/db/hibernate/envers/{OpenMRSRevisionEntity.java => OpenmrsRevisionEntity.java} (85%)
 rename api/src/main/java/org/openmrs/api/db/hibernate/envers/{OpenMRSRevisionEntityListener.java => OpenmrsRevisionEntityListener.java} (89%)

diff --git a/api/src/main/java/org/openmrs/ConceptAttributeType.java b/api/src/main/java/org/openmrs/ConceptAttributeType.java
index 31067563eb34..5537b842fdb6 100644
--- a/api/src/main/java/org/openmrs/ConceptAttributeType.java
+++ b/api/src/main/java/org/openmrs/ConceptAttributeType.java
@@ -9,9 +9,11 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.attribute.AttributeType;
 import org.openmrs.attribute.BaseAttributeType;
 
+@Audited
 public class ConceptAttributeType extends BaseAttributeType<Concept> implements AttributeType<Concept> {
 	
 	private Integer conceptAttributeTypeId;
diff --git a/api/src/main/java/org/openmrs/VisitAttributeType.java b/api/src/main/java/org/openmrs/VisitAttributeType.java
index d0880a45c8bc..8d8ca0e44902 100644
--- a/api/src/main/java/org/openmrs/VisitAttributeType.java
+++ b/api/src/main/java/org/openmrs/VisitAttributeType.java
@@ -9,6 +9,7 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.attribute.AttributeType;
 import org.openmrs.attribute.BaseAttributeType;
 
@@ -25,6 +26,7 @@
  */
 @Entity
 @Table(name = "visit_attribute_type")
+@Audited
 public class VisitAttributeType extends BaseAttributeType<Visit> implements AttributeType<Visit> {
 
 	@Id
diff --git a/api/src/main/java/org/openmrs/api/db/hibernate/envers/OpenMRSRevisionEntity.java b/api/src/main/java/org/openmrs/api/db/hibernate/envers/OpenmrsRevisionEntity.java
similarity index 85%
rename from api/src/main/java/org/openmrs/api/db/hibernate/envers/OpenMRSRevisionEntity.java
rename to api/src/main/java/org/openmrs/api/db/hibernate/envers/OpenmrsRevisionEntity.java
index 0fc095399462..9afb8ded4b04 100644
--- a/api/src/main/java/org/openmrs/api/db/hibernate/envers/OpenMRSRevisionEntity.java
+++ b/api/src/main/java/org/openmrs/api/db/hibernate/envers/OpenmrsRevisionEntity.java
@@ -14,15 +14,17 @@
 import org.hibernate.envers.RevisionEntity;
 
 import javax.persistence.Entity;
+import javax.persistence.Table;
 import java.util.Date;
 
 /**
  * Custom revision entity for OpenMRS application
  * Can be used to store revision metadata 
  */
-@RevisionEntity(OpenMRSRevisionEntityListener.class)
+@RevisionEntity(OpenmrsRevisionEntityListener.class)
 @Entity
-public class OpenMRSRevisionEntity extends DefaultRevisionEntity {
+@Table(name = "revision_entity")
+public class OpenmrsRevisionEntity extends DefaultRevisionEntity {
 
 	private Integer changedBy;
 	
diff --git a/api/src/main/java/org/openmrs/api/db/hibernate/envers/OpenMRSRevisionEntityListener.java b/api/src/main/java/org/openmrs/api/db/hibernate/envers/OpenmrsRevisionEntityListener.java
similarity index 89%
rename from api/src/main/java/org/openmrs/api/db/hibernate/envers/OpenMRSRevisionEntityListener.java
rename to api/src/main/java/org/openmrs/api/db/hibernate/envers/OpenmrsRevisionEntityListener.java
index 2b2928057bed..df36374d03d9 100644
--- a/api/src/main/java/org/openmrs/api/db/hibernate/envers/OpenMRSRevisionEntityListener.java
+++ b/api/src/main/java/org/openmrs/api/db/hibernate/envers/OpenmrsRevisionEntityListener.java
@@ -16,10 +16,10 @@
 
 import java.util.Date;
 
-public class OpenMRSRevisionEntityListener implements RevisionListener {
+public class OpenmrsRevisionEntityListener implements RevisionListener {
 	@Override
 	public void newRevision(Object o) {
-		OpenMRSRevisionEntity customRevisionEntity = (OpenMRSRevisionEntity) o;
+		OpenmrsRevisionEntity customRevisionEntity = (OpenmrsRevisionEntity) o;
 		if(Context.getUserContext().isAuthenticated()) {
 			customRevisionEntity.setChangedBy(Context.getUserContext().getAuthenticatedUser().getUserId());
 		}
diff --git a/api/src/main/java/org/openmrs/person/PersonMergeLog.java b/api/src/main/java/org/openmrs/person/PersonMergeLog.java
index 8f7fbe0bee4d..a6853a7eeab7 100644
--- a/api/src/main/java/org/openmrs/person/PersonMergeLog.java
+++ b/api/src/main/java/org/openmrs/person/PersonMergeLog.java
@@ -9,6 +9,7 @@
  */
 package org.openmrs.person;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.BaseChangeableOpenmrsData;
 import org.openmrs.Person;
 import org.openmrs.api.PersonService;
@@ -25,6 +26,7 @@
  * @see PersonService#savePersonMergeLog(PersonMergeLog)
  * @since 1.9
  */
+@Audited
 public class PersonMergeLog extends BaseChangeableOpenmrsData {
 	
 	private static final long serialVersionUID = 1L;
diff --git a/api/src/main/resources/hibernate.default.properties b/api/src/main/resources/hibernate.default.properties
index b4e66128d827..2984484e89ff 100644
--- a/api/src/main/resources/hibernate.default.properties
+++ b/api/src/main/resources/hibernate.default.properties
@@ -43,4 +43,4 @@ hibernate.id.new_generator_mappings=false
 
 # Hibernate envers options
 hibernate.integration.envers.enabled=false
-org.hibernate.envers.revision_listener=org.openmrs.api.db.hibernate.envers.OpenMRSRevisionEntityListener
+org.hibernate.envers.revision_listener=org.openmrs.api.db.hibernate.envers.OpenmrsRevisionEntityListener
diff --git a/api/src/test/java/org/openmrs/util/databasechange/ValidateHibernateMappingsDatabaseIT.java b/api/src/test/java/org/openmrs/util/databasechange/ValidateHibernateMappingsDatabaseIT.java
index d202c231f985..453e5c614edf 100644
--- a/api/src/test/java/org/openmrs/util/databasechange/ValidateHibernateMappingsDatabaseIT.java
+++ b/api/src/test/java/org/openmrs/util/databasechange/ValidateHibernateMappingsDatabaseIT.java
@@ -19,7 +19,7 @@
 import org.hibernate.cfg.Environment;
 import org.junit.jupiter.api.Test;
 import org.openmrs.api.OrderServiceTest;
-import org.openmrs.api.db.hibernate.envers.OpenMRSRevisionEntity;
+import org.openmrs.api.db.hibernate.envers.OpenmrsRevisionEntity;
 import org.openmrs.liquibase.ChangeLogVersionFinder;
 import org.openmrs.util.H2DatabaseIT;
 import org.openmrs.util.OpenmrsClassScanner;
@@ -83,7 +83,7 @@ private SessionFactory buildSessionFactory() {
 		
 		Set<Class<?>> entityClasses = OpenmrsClassScanner.getInstance().getClassesWithAnnotation(Entity.class);
 		entityClasses.remove(OrderServiceTest.SomeTestOrder.class);
-		entityClasses.remove(OpenMRSRevisionEntity.class);
+		entityClasses.remove(OpenmrsRevisionEntity.class);
 		for (Class<?> clazz : entityClasses) {
 			configuration.addAnnotatedClass(clazz);
 		}

From e70bed4b3b4c33a919031aeb38e746cf6ca9f934 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 21 Jun 2024 01:50:10 +0300
Subject: [PATCH 040/163] maven(deps): bump
 org.apache.maven.plugins:maven-jar-plugin (#4672)

Bumps [org.apache.maven.plugins:maven-jar-plugin](https://github.com/apache/maven-jar-plugin) from 3.4.1 to 3.4.2.
- [Release notes](https://github.com/apache/maven-jar-plugin/releases)
- [Commits](https://github.com/apache/maven-jar-plugin/compare/maven-jar-plugin-3.4.1...maven-jar-plugin-3.4.2)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-jar-plugin
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 73770ed2e911..ba707d76879a 100644
--- a/pom.xml
+++ b/pom.xml
@@ -623,7 +623,7 @@
 				<plugin>
 					<groupId>org.apache.maven.plugins</groupId>
 					<artifactId>maven-jar-plugin</artifactId>
-					<version>3.4.1</version>
+					<version>3.4.2</version>
 					<configuration>
 						<archive>
 							<manifestEntries>

From c2d68673d0183ee94fc360ef502edc4f01a1a7c2 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 22 Jun 2024 22:09:05 +0300
Subject: [PATCH 041/163] maven(deps): bump
 org.apache.maven.plugins:maven-dependency-plugin (#4673)

Bumps [org.apache.maven.plugins:maven-dependency-plugin](https://github.com/apache/maven-dependency-plugin) from 3.7.0 to 3.7.1.
- [Release notes](https://github.com/apache/maven-dependency-plugin/releases)
- [Commits](https://github.com/apache/maven-dependency-plugin/compare/maven-dependency-plugin-3.7.0...maven-dependency-plugin-3.7.1)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-dependency-plugin
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index ba707d76879a..8863a3af5c4f 100644
--- a/pom.xml
+++ b/pom.xml
@@ -947,7 +947,7 @@
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-dependency-plugin</artifactId>
-				<version>3.7.0</version>
+				<version>3.7.1</version>
 			</plugin>
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>

From cca287a2bf631d1ff6d6cfbcc393fb6bdef8a5c0 Mon Sep 17 00:00:00 2001
From: dkayiwa <dkayiwa@openmrs.org>
Date: Sun, 23 Jun 2024 11:38:59 +0300
Subject: [PATCH 042/163] Add valid checksum for TRUNK-6208: Upgrade Liquibase
 4.27.0

---
 .../liquibase/updates/liquibase-update-to-latest-2.2.x.xml       | 1 +
 1 file changed, 1 insertion(+)

diff --git a/api/src/main/resources/org/openmrs/liquibase/updates/liquibase-update-to-latest-2.2.x.xml b/api/src/main/resources/org/openmrs/liquibase/updates/liquibase-update-to-latest-2.2.x.xml
index 45d9d6084430..491018d833b7 100644
--- a/api/src/main/resources/org/openmrs/liquibase/updates/liquibase-update-to-latest-2.2.x.xml
+++ b/api/src/main/resources/org/openmrs/liquibase/updates/liquibase-update-to-latest-2.2.x.xml
@@ -30,6 +30,7 @@
 	-->
 
 	<changeSet id="TRUNK-4755" author="Rahul,Swathi">
+			<validCheckSum><comment>Account for changing retired_by from int(11) to int</comment>8:b962b54a962ca69892c933c7fb863a91</validCheckSum>
             <preConditions onFail="MARK_RAN">
                 <not>
                     <tableExists tableName="program_attribute_type" />

From 9241104a9b601e4a2a7b16a24ac9f146b27f73f1 Mon Sep 17 00:00:00 2001
From: Isaiah Muli <48686606+dicksonmulli@users.noreply.github.com>
Date: Wed, 26 Jun 2024 21:39:12 +0300
Subject: [PATCH 043/163] TRUNK-6235: auto deactivate users after XX days of
 inactivity (#4650)

* TRUNK-6235 - auto deactivate users

* --- (#4643)

updated-dependencies:
- dependency-name: org.codehaus.mojo:build-helper-maven-plugin
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Update to Tomcat 9

* --- (#4647)

updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* --- (#4648)

updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy-agent
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Updating tests

* Changes from Pull request

* Reverting refactor

* Adding property in core global property

* Using matchers in place of empty string

* Adding licence

* Adding tests for auto-retire

* Changing an access modifier

* Improving documentation

* Updating tests

* escaping superusers while auto retiring users

* Code refactor

* Improving tests

* Improving tests

* Code refactor

* Using TimeUnit for time conversion

* Changing method modifiers to private

* Fixing a failing build

* making a static variable private

* Using exact retire reason in tests

* Fixing tests

* correcting the expected values

* Removing import of a constant

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: Isaiah <isaiah.dickson@equitybank.co.ke>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Ian <52504170+ibacher@users.noreply.github.com>
Co-authored-by: Isaiah Muli <isaiahmuli@Isaiahs-Magic-Pro.local>
---
 .../java/org/openmrs/api/UserService.java     |   9 +
 .../main/java/org/openmrs/api/db/UserDAO.java |   5 +
 .../api/db/hibernate/HibernateContextDAO.java |  14 +-
 .../api/db/hibernate/HibernateUserDAO.java    |  10 +-
 .../org/openmrs/api/impl/UserServiceImpl.java |   7 +
 .../scheduler/tasks/AutoRetireUsersTask.java  |  99 +++++++++++
 .../org/openmrs/util/OpenmrsConstants.java    |  16 +-
 .../java/org/openmrs/api/UserServiceTest.java |  51 +++++-
 .../tasks/AutoRetireUsersTaskTest.java        | 161 ++++++++++++++++++
 9 files changed, 364 insertions(+), 8 deletions(-)
 create mode 100644 api/src/main/java/org/openmrs/scheduler/tasks/AutoRetireUsersTask.java
 create mode 100644 api/src/test/java/org/openmrs/scheduler/tasks/AutoRetireUsersTaskTest.java

diff --git a/api/src/main/java/org/openmrs/api/UserService.java b/api/src/main/java/org/openmrs/api/UserService.java
index 932f261206b7..a6ff1dc70c11 100644
--- a/api/src/main/java/org/openmrs/api/UserService.java
+++ b/api/src/main/java/org/openmrs/api/UserService.java
@@ -578,4 +578,13 @@ public List<User> getUsers(String name, List<Role> roles, boolean includeRetired
 	 * @since 2.3.6, 2.4.6, 2.5.4, 2.6.0
 	 */
 	Locale getDefaultLocaleForUser(User user);
+
+	/**
+	 * Retrieves the last login time of the user in Unix Timestamp
+	 * 
+	 * @param user the subject user
+	 * @return timestamp representing last login time (e.g. 1717414410587)
+	 * @since 2.7.0
+	 */
+	String getLastLoginTime(User user);
 }
diff --git a/api/src/main/java/org/openmrs/api/db/UserDAO.java b/api/src/main/java/org/openmrs/api/db/UserDAO.java
index 32beeff4dc63..f3fb80beb543 100644
--- a/api/src/main/java/org/openmrs/api/db/UserDAO.java
+++ b/api/src/main/java/org/openmrs/api/db/UserDAO.java
@@ -211,4 +211,9 @@ public List<User> getUsers(String name, List<Role> roles, boolean includeRetired
 	 * @see UserService#setUserActivationKey(LoginCredential)
 	 */
 	public void setUserActivationKey(LoginCredential credentials);
+
+	/**
+	 * @see UserService#getLastLoginTime(User)
+	 */
+	String getLastLoginTime(User user);
 }
diff --git a/api/src/main/java/org/openmrs/api/db/hibernate/HibernateContextDAO.java b/api/src/main/java/org/openmrs/api/db/hibernate/HibernateContextDAO.java
index addccd760f74..b01a8deadbeb 100644
--- a/api/src/main/java/org/openmrs/api/db/hibernate/HibernateContextDAO.java
+++ b/api/src/main/java/org/openmrs/api/db/hibernate/HibernateContextDAO.java
@@ -143,7 +143,7 @@ public User authenticate(String login, String password) throws ContextAuthentica
 				// to now and make them wait another x mins
 				final Long unlockTime = getUnlockTimeMs();
 				if (System.currentTimeMillis() - lockoutTime > unlockTime) {
-					candidateUser.setUserProperty(OpenmrsConstants.USER_PROPERTY_LOGIN_ATTEMPTS, "0");
+					candidateUser.setUserProperty(OpenmrsConstants.USER_PROPERTY_LOGIN_ATTEMPTS, OpenmrsConstants.ZERO_LOGIN_ATTEMPTS_VALUE);
 					candidateUser.removeUserProperty(OpenmrsConstants.USER_PROPERTY_LOCKOUT_TIMESTAMP);
 					saveUserProperties(candidateUser);
 				} else {
@@ -172,10 +172,11 @@ public User authenticate(String login, String password) throws ContextAuthentica
 				// only clean up if the were some login failures, otherwise all should be clean
 				int attempts = getUsersLoginAttempts(candidateUser);
 				if (attempts > 0) {
-					candidateUser.setUserProperty(OpenmrsConstants.USER_PROPERTY_LOGIN_ATTEMPTS, "0");
+					candidateUser.setUserProperty(OpenmrsConstants.USER_PROPERTY_LOGIN_ATTEMPTS, OpenmrsConstants.ZERO_LOGIN_ATTEMPTS_VALUE);
 					candidateUser.removeUserProperty(OpenmrsConstants.USER_PROPERTY_LOCKOUT_TIMESTAMP);
-					saveUserProperties(candidateUser);
 				}
+				setLastLoginTime(candidateUser);
+				saveUserProperties(candidateUser);
 
 				// skip out of the method early (instead of throwing the exception)
 				// to indicate that this is the valid user
@@ -215,6 +216,13 @@ public User authenticate(String login, String password) throws ContextAuthentica
 		throw new ContextAuthenticationException(errorMsg);
 	}
 	
+	private void setLastLoginTime(User candidateUser) {
+		candidateUser.setUserProperty(
+			OpenmrsConstants.USER_PROPERTY_LAST_LOGIN_TIMESTAMP,
+			String.valueOf(System.currentTimeMillis())
+		);
+	}
+	
 	private Long getUnlockTimeMs() {
 		String unlockTimeGPValue = Context.getAdministrationService().getGlobalProperty(
 				OpenmrsConstants.GP_UNLOCK_ACCOUNT_WAITING_TIME);
diff --git a/api/src/main/java/org/openmrs/api/db/hibernate/HibernateUserDAO.java b/api/src/main/java/org/openmrs/api/db/hibernate/HibernateUserDAO.java
index dccd01526616..f28963bb0797 100644
--- a/api/src/main/java/org/openmrs/api/db/hibernate/HibernateUserDAO.java
+++ b/api/src/main/java/org/openmrs/api/db/hibernate/HibernateUserDAO.java
@@ -368,7 +368,7 @@ private void updateUserPassword(String newHashedPassword, String salt, Integer c
 		
 		// reset lockout 
 		changeForUser.setUserProperty(OpenmrsConstants.USER_PROPERTY_LOCKOUT_TIMESTAMP, "");
-		changeForUser.setUserProperty(OpenmrsConstants.USER_PROPERTY_LOGIN_ATTEMPTS, "0");
+		changeForUser.setUserProperty(OpenmrsConstants.USER_PROPERTY_LOGIN_ATTEMPTS, OpenmrsConstants.ZERO_LOGIN_ATTEMPTS_VALUE);
 		saveUser(changeForUser, null);
 	}
 	
@@ -710,4 +710,12 @@ private Query createUserSearchQuery(String name, List<Role> roles, boolean inclu
 	public void setUserActivationKey(LoginCredential credentials) {		
 			sessionFactory.getCurrentSession().merge(credentials);	
 	}
+
+	/**
+	 * @see org.openmrs.api.db.UserDAO#getLastLoginTime(org.openmrs.User)
+	 */
+	@Override
+	public String getLastLoginTime(User user) {
+		return user.getUserProperty(OpenmrsConstants.USER_PROPERTY_LAST_LOGIN_TIMESTAMP);
+	}
 }
diff --git a/api/src/main/java/org/openmrs/api/impl/UserServiceImpl.java b/api/src/main/java/org/openmrs/api/impl/UserServiceImpl.java
index 6f51cdf0f0c9..9abf2a4ba781 100644
--- a/api/src/main/java/org/openmrs/api/impl/UserServiceImpl.java
+++ b/api/src/main/java/org/openmrs/api/impl/UserServiceImpl.java
@@ -808,4 +808,11 @@ public void changePasswordUsingActivationKey(String activationKey, String newPas
 		
 		updatePassword(user, newPassword);
 	}
+
+	/**
+	 * @see org.openmrs.api.UserService#getLastLoginTime(User)
+	 */
+	public String getLastLoginTime(User user) {
+		return dao.getLastLoginTime(user);
+	}
 }
diff --git a/api/src/main/java/org/openmrs/scheduler/tasks/AutoRetireUsersTask.java b/api/src/main/java/org/openmrs/scheduler/tasks/AutoRetireUsersTask.java
new file mode 100644
index 000000000000..0d7285a4eeab
--- /dev/null
+++ b/api/src/main/java/org/openmrs/scheduler/tasks/AutoRetireUsersTask.java
@@ -0,0 +1,99 @@
+/**
+ * This Source Code Form is subject to the terms of the Mozilla Public License,
+ * v. 2.0. If a copy of the MPL was not distributed with this file, You can
+ * obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
+ * the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
+ *
+ * Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
+ * graphic logo is a trademark of OpenMRS Inc.
+ */
+package org.openmrs.scheduler.tasks;
+
+import org.apache.commons.lang.StringUtils;
+import org.openmrs.User;
+import org.openmrs.api.UserService;
+import org.openmrs.api.context.Context;
+import org.openmrs.util.OpenmrsConstants;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import java.util.Collections;
+import java.util.Date;
+import java.util.List;
+import java.util.Set;
+import java.util.concurrent.TimeUnit;
+import java.util.stream.Collectors;
+
+/**
+ * A scheduled task that automatically retires users after the set number of days of inactivity. 
+ * The inactivity duration is set as a global property. 
+ * <a href="https://openmrs.atlassian.net/wiki/spaces/docs/pages/101318663/Creating+Auto-Deactivating+User+Task">Documentation</a>
+ * {@link OpenmrsConstants#GP_NUMBER_OF_DAYS_TO_AUTO_RETIRE_USERS}
+ * 
+ * @since 2.7.0
+ */
+public class AutoRetireUsersTask extends AbstractTask {
+	
+	private static final Logger log = LoggerFactory.getLogger(AutoRetireUsersTask.class);
+	private static final String AUTO_RETIRE_REASON = "User retired due to inactivity";
+
+	/**
+	 * @see org.openmrs.scheduler.tasks.AbstractTask#execute()
+	 */
+	@Override
+	public void execute() {
+		if (!isExecuting) {
+			log.debug("Auto-retiring users task Started");
+			
+			startExecuting();
+			
+			try {
+				UserService userService = Context.getUserService();
+				Set<User> usersToRetire = getUsersToRetire(userService);
+				
+				usersToRetire.forEach(user -> userService.retireUser(user, AUTO_RETIRE_REASON));
+			} catch (Exception e) {
+				log.error("Error occurred while auto-retiring users: ", e);
+			} finally {
+				log.debug("Auto-retiring users task ended");
+				stopExecuting();
+			}
+		}
+	}
+
+	private Set<User> getUsersToRetire(UserService userService) {
+		final List<User> allUsers = userService.getAllUsers();
+		String numberOfDaysToRetire = Context.getAdministrationService().getGlobalProperty(OpenmrsConstants.GP_NUMBER_OF_DAYS_TO_AUTO_RETIRE_USERS);
+		
+		if (StringUtils.isBlank(numberOfDaysToRetire)) {
+			return Collections.emptySet();
+		}
+		
+		long numberOfMillisecondsToRetire = TimeUnit.DAYS.toMillis(Long.parseLong(numberOfDaysToRetire));
+
+		return allUsers.stream()
+			.filter(user -> !user.isSuperUser() 
+				&& !user.isRetired() 
+				&& userInactivityExceedsDaysToRetire(user, numberOfMillisecondsToRetire)
+			)
+			.collect(Collectors.toSet());
+	}
+
+	private boolean userInactivityExceedsDaysToRetire(User user, long numberOfMillisecondsToRetire) {
+		String lastLoginTimeString = Context.getUserService().getLastLoginTime(user);
+
+		if (StringUtils.isNotBlank(lastLoginTimeString)) {
+			long lastLoginTime = Long.parseLong(lastLoginTimeString);
+
+			return System.currentTimeMillis() - lastLoginTime >= numberOfMillisecondsToRetire;
+		} else {
+			Date dateCreated = user.getDateCreated();
+			
+			if (dateCreated != null) {
+				return System.currentTimeMillis() - dateCreated.getTime() >= numberOfMillisecondsToRetire;
+			}
+		}
+		
+		return false;
+	}
+}
diff --git a/api/src/main/java/org/openmrs/util/OpenmrsConstants.java b/api/src/main/java/org/openmrs/util/OpenmrsConstants.java
index c692dea0debc..efafb19c10ed 100644
--- a/api/src/main/java/org/openmrs/util/OpenmrsConstants.java
+++ b/api/src/main/java/org/openmrs/util/OpenmrsConstants.java
@@ -23,7 +23,6 @@
 import liquibase.GlobalConfiguration;
 import org.apache.commons.io.IOUtils;
 import org.openmrs.GlobalProperty;
-import org.openmrs.api.context.Context;
 import org.openmrs.api.handler.ExistingVisitAssignmentHandler;
 import org.openmrs.customdatatype.datatype.BooleanDatatype;
 import org.openmrs.customdatatype.datatype.FreeTextDatatype;
@@ -636,6 +635,11 @@ public static final Collection<String> AUTO_ROLES() {
 	 * Global property that stores the base url for the password reset.
 	 */
 	public static final String GP_PASSWORD_RESET_URL = "security.passwordResetUrl";
+
+	/**
+	 * Global property that stores the number of days for users to be deactivated.
+	 */
+	public static final String GP_NUMBER_OF_DAYS_TO_AUTO_RETIRE_USERS = "users.numberOfDaysToRetire";
 	
 	/**
 	 * At OpenMRS startup these global properties/default values/descriptions are inserted into the
@@ -1185,6 +1189,11 @@ public static final Collection<String> CONCEPT_PROPOSAL_STATES() {
 	 * <code>proficientLocales = en_US, en_GB, en, fr_RW</code>
 	 */
 	public static final String USER_PROPERTY_PROFICIENT_LOCALES = "proficientLocales";
+
+	/**
+ 	 * Name of the user_property that stores user's last login time
+	 */
+	public static final String USER_PROPERTY_LAST_LOGIN_TIMESTAMP = "lastLoginTimestamp";
 	
 	// Used for differences between windows/linux upload capabilities)
 	// Used for determining where to find runtime properties
@@ -1314,9 +1323,12 @@ public static enum PERSON_TYPE {
 	
 	/** Value for the long person name format */
 	public static final String PERSON_NAME_FORMAT_LONG = "long";
-	
+
 	// Liquibase Constants
 	public static final String LIQUIBASE_DUPLICATE_FILE_MODE_DEFAULT = GlobalConfiguration.DuplicateFileMode.WARN.name();
+
+	/** Value for zero login attempts */
+	public static final String ZERO_LOGIN_ATTEMPTS_VALUE = "0";
 	
 	private OpenmrsConstants() {
 	}
diff --git a/api/src/test/java/org/openmrs/api/UserServiceTest.java b/api/src/test/java/org/openmrs/api/UserServiceTest.java
index af2f6b6324dd..f8246682c4e2 100644
--- a/api/src/test/java/org/openmrs/api/UserServiceTest.java
+++ b/api/src/test/java/org/openmrs/api/UserServiceTest.java
@@ -10,9 +10,13 @@
 package org.openmrs.api;
 
 import static org.hamcrest.MatcherAssert.assertThat;
+import static org.hamcrest.Matchers.emptyString;
 import static org.hamcrest.Matchers.greaterThanOrEqualTo;
 import static org.hamcrest.Matchers.hasSize;
 import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.lessThanOrEqualTo;
+import static org.hamcrest.Matchers.not;
+import static org.hamcrest.Matchers.notNullValue;
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertFalse;
 import static org.junit.jupiter.api.Assertions.assertNotNull;
@@ -32,7 +36,9 @@
 import java.util.Map;
 import java.util.Properties;
 import java.util.Set;
+import java.util.stream.Collectors;
 
+import org.apache.commons.lang3.StringUtils;
 import org.apache.commons.lang3.reflect.FieldUtils;
 import org.junit.jupiter.api.AfterAll;
 import org.junit.jupiter.api.BeforeEach;
@@ -45,7 +51,9 @@
 import org.openmrs.Role;
 import org.openmrs.User;
 import org.openmrs.api.context.Context;
+import org.openmrs.api.context.Credentials;
 import org.openmrs.api.context.UserContext;
+import org.openmrs.api.context.UsernamePasswordCredentials;
 import org.openmrs.api.db.DAOException;
 import org.openmrs.api.db.LoginCredential;
 import org.openmrs.api.db.UserDAO;
@@ -1326,7 +1334,7 @@ public void saveUserProperty_shouldAddNewPropertyToExistingUserProperties() {
 		Context.authenticate(user.getUsername(), "testUser1234");
 		
 		final int numberOfUserProperties = user.getUserProperties().size();
-		assertEquals(2, user.getUserProperties().size());
+		assertEquals(3, user.getUserProperties().size());
 		final String USER_PROPERTY_KEY = "test-key";
 		final String USER_PROPERTY_VALUE = "test-value";
 		
@@ -1662,7 +1670,14 @@ public void saveUserProperty_shouldAddANewPropertyWithAVeryLargeStringWithoutRun
 		final String USER_PROPERTY_KEY = liquibase.util.StringUtil.repeat("emrapi.lastViewedPatientIds,",10);
 		final String USER_PROPERTY_VALUE = liquibase.util.StringUtil.repeat("52345",9899);
 		User updatedUser = userService.saveUserProperty(USER_PROPERTY_KEY, USER_PROPERTY_VALUE);
-		assertEquals(280, updatedUser.getUserProperties().keySet().iterator().next().length());
+
+		Set<String> emrApiPropertyKeys = updatedUser.getUserProperties()
+			.keySet()
+			.stream()
+			.filter(key -> key.contains("emrapi.lastViewedPatientIds"))
+			.collect(Collectors.toSet());
+
+		assertEquals(280, emrApiPropertyKeys.stream().findFirst().orElse("").length());
 		assertEquals(49495, updatedUser.getUserProperties().get(USER_PROPERTY_KEY).length());
 	}
 	
@@ -1693,6 +1708,38 @@ public void getDefaultLocaleForUser_shouldReturnDefaultLocaleForUserIfAlreadySet
 		assertEquals(Locale.FRENCH, locale);
 	}
 
+	@Test
+	public void getLastLoginTimeForUser_shouldReturnEmptyStringOnLastLoginTimeIfPropertyNotSet() {
+		User createdUser = createTestUser();
+		assertThat(createdUser.getUserProperty(OpenmrsConstants.USER_PROPERTY_LAST_LOGIN_TIMESTAMP), emptyString());
+		assertThat(Context.getUserService().getLastLoginTime(createdUser), emptyString());
+	}
+
+	@Test
+	public void getLastLoginTimeForUser_shouldReturnEmptyStringOnLastLoginTimeIfADifferentUserIsLoggedIn() {
+		executeDataSet(XML_FILENAME);
+		User createdUser = createTestUser();
+		Context.authenticate(getTestUserCredentials());
+		
+		assertThat(createdUser.getUserProperty(OpenmrsConstants.USER_PROPERTY_LAST_LOGIN_TIMESTAMP), emptyString());
+		assertThat(Context.getUserService().getLastLoginTime(createdUser), emptyString());
+	}
+	
+	@Test
+	public void getLastLoginTimeForUser_shouldNotBeEmptyIfUserIsAuthenticated() {
+		executeDataSet(XML_FILENAME);
+		User createdUser = createTestUser();
+		Context.authenticate(new UsernamePasswordCredentials("bwolfe", "Openmr5xy"));
+
+		assertThat(createdUser.getUserProperty(OpenmrsConstants.USER_PROPERTY_LAST_LOGIN_TIMESTAMP), notNullValue());
+		assertThat(createdUser.getUserProperty(OpenmrsConstants.USER_PROPERTY_LAST_LOGIN_TIMESTAMP), not(emptyString()));
+		assertThat(Context.getUserService().getLastLoginTime(createdUser), not(emptyString()));
+	}
+
+	private Credentials getTestUserCredentials() {
+		return new UsernamePasswordCredentials("test", "testUser1234");
+	}
+
 	private User createTestUser() {
 		User u = new User();
 		u.setPerson(new Person());
diff --git a/api/src/test/java/org/openmrs/scheduler/tasks/AutoRetireUsersTaskTest.java b/api/src/test/java/org/openmrs/scheduler/tasks/AutoRetireUsersTaskTest.java
new file mode 100644
index 000000000000..e8dc4b05e5db
--- /dev/null
+++ b/api/src/test/java/org/openmrs/scheduler/tasks/AutoRetireUsersTaskTest.java
@@ -0,0 +1,161 @@
+/**
+ * This Source Code Form is subject to the terms of the Mozilla Public License,
+ * v. 2.0. If a copy of the MPL was not distributed with this file, You can
+ * obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
+ * the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
+ *
+ * Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
+ * graphic logo is a trademark of OpenMRS Inc.
+ */
+package org.openmrs.scheduler.tasks;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.openmrs.GlobalProperty;
+import org.openmrs.User;
+import org.openmrs.api.AdministrationService;
+import org.openmrs.api.UserService;
+import org.openmrs.api.context.Context;
+import org.openmrs.test.jupiter.BaseContextSensitiveTest;
+import org.openmrs.util.OpenmrsConstants;
+
+import java.util.Date;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+class AutoRetireUsersTaskTest extends BaseContextSensitiveTest {
+	private static final long ONE_DAY_IN_MILLISECONDS = 24 * 60 * 60 * 1000;
+	private static final long TWENTY_THREE_HOURS_IN_MILLISECONDS = 23 * 60 * 60 * 1000;
+	private static final long TWO_DAYS_IN_MILLISECONDS = 2 * ONE_DAY_IN_MILLISECONDS;
+	private static final String ONE_DAY_PROPERTY_VALUE = "1";
+	private static final String TWO_DAYS_PROPERTY_VALUE = "2";
+	private static final String AUTO_RETIRE_REASON = "User retired due to inactivity";
+
+	private UserService userService;
+	private AdministrationService administrationService;
+	private AutoRetireUsersTask autoRetireUsersTask;
+
+	@BeforeEach
+	public void setup() {
+		administrationService = Context.getAdministrationService();
+		autoRetireUsersTask = new AutoRetireUsersTask();
+		userService = Context.getUserService();
+	}
+
+	@Test
+	public void shouldRetireUsersWhoseInactivityExceedNumberOfDaysToRetire() {
+		administrationService.saveGlobalProperty(new GlobalProperty(OpenmrsConstants.GP_NUMBER_OF_DAYS_TO_AUTO_RETIRE_USERS, ONE_DAY_PROPERTY_VALUE));
+
+		User user = getDefaultUser();
+		userService.setUserProperty(
+			user,
+			OpenmrsConstants.USER_PROPERTY_LAST_LOGIN_TIMESTAMP,
+			String.valueOf((System.currentTimeMillis() - TWO_DAYS_IN_MILLISECONDS))
+		);
+
+		user.getAllRoles().forEach(user::removeRole);
+
+		autoRetireUsersTask.execute();
+
+		assertTrue(user.isRetired());
+		assertEquals(AUTO_RETIRE_REASON, user.getRetireReason());
+	}
+
+	@Test
+	public void shouldNotRetireUsersWhoseInactivityDoNotExceedNumberOfDaysToRetire() {
+		administrationService.saveGlobalProperty(new GlobalProperty(OpenmrsConstants.GP_NUMBER_OF_DAYS_TO_AUTO_RETIRE_USERS, TWO_DAYS_PROPERTY_VALUE));
+
+		User user = getDefaultUser();
+		userService.setUserProperty(
+			user,
+			OpenmrsConstants.USER_PROPERTY_LAST_LOGIN_TIMESTAMP,
+			String.valueOf((System.currentTimeMillis() - ONE_DAY_IN_MILLISECONDS))
+		);
+
+		user.getAllRoles().forEach(user::removeRole);
+
+		autoRetireUsersTask.execute();
+
+		assertFalse(user.isRetired());
+	}
+
+	@Test
+	public void shouldNotRetireAlreadyRetiredUsers() {
+		administrationService.saveGlobalProperty(new GlobalProperty(OpenmrsConstants.GP_NUMBER_OF_DAYS_TO_AUTO_RETIRE_USERS, ONE_DAY_PROPERTY_VALUE));
+
+		final String RETIRE_REASON = "Retire Test users";
+
+		User retiredUser = userService.getUser(1);
+		userService.setUserProperty(
+			retiredUser,
+			OpenmrsConstants.USER_PROPERTY_LAST_LOGIN_TIMESTAMP,
+			String.valueOf((System.currentTimeMillis() - TWO_DAYS_IN_MILLISECONDS))
+		);
+
+		retiredUser.getAllRoles().forEach(retiredUser::removeRole);
+
+		retiredUser.setRetired(true);
+		retiredUser.setRetireReason(RETIRE_REASON);
+		
+		userService.saveUser(retiredUser);
+
+		autoRetireUsersTask.execute();
+
+		User fetchedUser = userService.getUser(retiredUser.getUserId());
+		assertTrue(fetchedUser.isRetired(), "User should remain retired after the task runs");
+		assertEquals(RETIRE_REASON, fetchedUser.getRetireReason());
+	}
+
+	@Test
+	public void shouldNotRetireUsersThatAreInactiveSinceCreationAndInactivityDoesNotExceedNumberOfDaysToRetire() {
+		administrationService.saveGlobalProperty(new GlobalProperty(OpenmrsConstants.GP_NUMBER_OF_DAYS_TO_AUTO_RETIRE_USERS, ONE_DAY_PROPERTY_VALUE));
+
+		User user = getDefaultUser();
+
+		user.getAllRoles().forEach(user::removeRole);
+
+		user.setDateCreated(new Date(System.currentTimeMillis() - TWENTY_THREE_HOURS_IN_MILLISECONDS));
+
+		autoRetireUsersTask.execute();
+
+		assertFalse(user.isRetired());
+	}
+
+	@Test
+	public void shouldRetireUsersThatAreInactiveSinceCreationAndInactivityExceedsNumberOfDaysToRetire() {
+		administrationService.saveGlobalProperty(new GlobalProperty(OpenmrsConstants.GP_NUMBER_OF_DAYS_TO_AUTO_RETIRE_USERS, ONE_DAY_PROPERTY_VALUE));
+
+		User user = getDefaultUser();
+
+		user.getAllRoles().forEach(user::removeRole);
+
+		user.setDateCreated(new Date(System.currentTimeMillis() - TWO_DAYS_IN_MILLISECONDS));
+
+		autoRetireUsersTask.execute();
+
+		assertTrue(user.isRetired());
+		assertEquals(AUTO_RETIRE_REASON, user.getRetireReason());
+	}
+
+	@Test
+	public void shouldNotRetireSuperUsers() {
+		administrationService.saveGlobalProperty(new GlobalProperty(OpenmrsConstants.GP_NUMBER_OF_DAYS_TO_AUTO_RETIRE_USERS, ONE_DAY_PROPERTY_VALUE));
+		
+		User adminUser = userService.getUser(1);
+		userService.setUserProperty(
+			adminUser, 
+			OpenmrsConstants.USER_PROPERTY_LAST_LOGIN_TIMESTAMP,
+			String.valueOf((System.currentTimeMillis() - TWO_DAYS_IN_MILLISECONDS))
+		);
+
+		autoRetireUsersTask.execute();
+		
+		assertFalse(adminUser.isRetired());
+	}
+
+	private User getDefaultUser() {
+		return userService.getUser(1);
+	}
+}

From 95051a01502c36e3b93177eae4c9a30e80759eed Mon Sep 17 00:00:00 2001
From: Wikum Weerakutti <wikum@linuxdeveloper.space>
Date: Thu, 27 Jun 2024 01:06:27 +0530
Subject: [PATCH 044/163] TRUNK-6203: Global properties access should be
 privileged (#4601)

* TRUNK-6203: Global properties access should be privileged

* TRUNK-6203: Global properties access should be privileged

* TRUNK-6203: Global properties access should be privileged

* TRUNK-6203: Global properties access should be privileged

* TRUNK-6203: Global properties access should be privileged

* TRUNK-6203: Global properties access should be privileged

* TRUNK-6203: Global properties access should be privileged

* TRUNK-6203: Global properties access should be privileged

* TRUNK-6203: Global properties access should be privileged

* TRUNK-6203: Global properties access should be privileged

* TRUNK-6203: Global properties access should be privileged

* TRUNK-6203: Global properties access should be privileged

* TRUNK-6203: Global properties access should be privileged

* TRUNK-6203: Global properties access should be privileged

* TRUNK-6203: Global properties access should be privileged

* TRUNK-6203: Global properties access should be privileged

* TRUNK-6203: Global properties access should be privileged

* TRUNK-6203: Global properties access should be privileged

* Removing random changes

* Removing random changes
---
 .../openmrs/api/AdministrationService.java    |  9 +++++++
 .../annotation/StartModuleAnnotationTest.java |  6 ++---
 .../openmrs/aop/AuthorizationAdviceTest.java  |  2 +-
 .../api/AdministrationServiceTest.java        | 26 +++++++++----------
 .../java/org/openmrs/api/UserServiceTest.java | 19 +++++++-------
 .../org/openmrs/api/db/ContextDAOTest.java    | 10 ++++++-
 .../test/StartModuleExecutionListener.java    |  5 ++++
 .../jupiter/StartModuleExecutionListener.java |  6 +++++
 ...nistrationServiceTest-globalproperties.xml |  4 +--
 9 files changed, 58 insertions(+), 29 deletions(-)

diff --git a/api/src/main/java/org/openmrs/api/AdministrationService.java b/api/src/main/java/org/openmrs/api/AdministrationService.java
index de1466f38e8d..f25d2c7c1e9c 100644
--- a/api/src/main/java/org/openmrs/api/AdministrationService.java
+++ b/api/src/main/java/org/openmrs/api/AdministrationService.java
@@ -56,6 +56,7 @@ public interface AdministrationService extends OpenmrsService {
 	 * <strong>Should</strong> find object given valid uuid
 	 * <strong>Should</strong> return null if no object found with given uuid
 	 */
+	@Authorized(PrivilegeConstants.GET_GLOBAL_PROPERTIES)
 	public GlobalProperty getGlobalPropertyByUuid(String uuid);
 	
 	/**
@@ -90,6 +91,7 @@ public interface AdministrationService extends OpenmrsService {
 	 * <strong>Should</strong> get property value given valid property name
 	 * <strong>Should</strong> get property in case insensitive way
 	 */
+	@Authorized(PrivilegeConstants.GET_GLOBAL_PROPERTIES)
 	public String getGlobalProperty(String propertyName);
 	
 	/**
@@ -106,6 +108,7 @@ public interface AdministrationService extends OpenmrsService {
 	 * <strong>Should</strong> return default value if property name does not exist
 	 * <strong>Should</strong> not fail with null default value
 	 */
+	@Authorized(PrivilegeConstants.GET_GLOBAL_PROPERTIES)
 	public String getGlobalProperty(String propertyName, String defaultValue);
 	
 	/**
@@ -115,6 +118,7 @@ public interface AdministrationService extends OpenmrsService {
 	 * @return the global property that matches the given <code>propertyName</code>
 	 * <strong>Should</strong> return null when no global property match given property name
 	 */
+	@Authorized(PrivilegeConstants.GET_GLOBAL_PROPERTIES)
 	public GlobalProperty getGlobalPropertyObject(String propertyName);
 	
 	/**
@@ -125,6 +129,7 @@ public interface AdministrationService extends OpenmrsService {
 	 * @since 1.5
 	 * <strong>Should</strong> return all relevant global properties in the database
 	 */
+	@Authorized(PrivilegeConstants.GET_GLOBAL_PROPERTIES)
 	public List<GlobalProperty> getGlobalPropertiesByPrefix(String prefix);
 	
 	/**
@@ -135,6 +140,7 @@ public interface AdministrationService extends OpenmrsService {
 	 * @since 1.6
 	 * <strong>Should</strong> return all relevant global properties in the database
 	 */
+	@Authorized(PrivilegeConstants.GET_GLOBAL_PROPERTIES)
 	public List<GlobalProperty> getGlobalPropertiesBySuffix(String suffix);
 	
 	/**
@@ -189,6 +195,7 @@ public interface AdministrationService extends OpenmrsService {
 	 * <strong>Should</strong> overwrite global property if exists
 	 * <strong>Should</strong> save a global property whose typed value is handled by a custom datatype
 	 */
+	@Authorized(PrivilegeConstants.MANAGE_GLOBAL_PROPERTIES)
 	public void setGlobalProperty(String propertyName, String propertyValue);
 	
 	/**
@@ -202,6 +209,7 @@ public interface AdministrationService extends OpenmrsService {
 	 * <strong>Should</strong> fail if global property being updated does not already exist
 	 * <strong>Should</strong> update a global property whose typed value is handled by a custom datatype
 	 */
+	@Authorized(PrivilegeConstants.MANAGE_GLOBAL_PROPERTIES)
 	public void updateGlobalProperty(String propertyName, String propertyValue);
 	
 	/**
@@ -313,6 +321,7 @@ public interface AdministrationService extends OpenmrsService {
 	 * @return property value in the type of the default value
 	 * @since 1.7
 	 */
+	@Authorized(PrivilegeConstants.GET_GLOBAL_PROPERTIES)
 	public <T> T getGlobalPropertyValue(String propertyName, T defaultValue);
 	
 	/**
diff --git a/api/src/test/java/org/openmrs/annotation/StartModuleAnnotationTest.java b/api/src/test/java/org/openmrs/annotation/StartModuleAnnotationTest.java
index 573149df7ebc..6c092ea2d2f4 100644
--- a/api/src/test/java/org/openmrs/annotation/StartModuleAnnotationTest.java
+++ b/api/src/test/java/org/openmrs/annotation/StartModuleAnnotationTest.java
@@ -9,12 +9,12 @@
  */
 package org.openmrs.annotation;
 
-import static org.junit.jupiter.api.Assertions.assertNotNull;
-
 import org.junit.jupiter.api.Test;
 import org.openmrs.api.context.Context;
-import org.openmrs.test.jupiter.BaseContextSensitiveTest;
 import org.openmrs.test.StartModule;
+import org.openmrs.test.jupiter.BaseContextSensitiveTest;
+
+import static org.junit.jupiter.api.Assertions.assertNotNull;
 
 @StartModule({ "org/openmrs/module/include/test1-1.0-SNAPSHOT.omod", "org/openmrs/module/include/test2-1.0-SNAPSHOT.omod" })
 public class StartModuleAnnotationTest extends BaseContextSensitiveTest {
diff --git a/api/src/test/java/org/openmrs/aop/AuthorizationAdviceTest.java b/api/src/test/java/org/openmrs/aop/AuthorizationAdviceTest.java
index 851de73e36bf..b60798c05503 100644
--- a/api/src/test/java/org/openmrs/aop/AuthorizationAdviceTest.java
+++ b/api/src/test/java/org/openmrs/aop/AuthorizationAdviceTest.java
@@ -65,7 +65,7 @@ public void before_shouldNotifyListenersAboutCheckedPrivileges() {
 		Context.getConceptService().saveConcept(concept);
 		
 		String[] privileges = { PrivilegeConstants.MANAGE_CONCEPTS, PrivilegeConstants.GET_OBS,
-		        PrivilegeConstants.GET_CONCEPT_ATTRIBUTE_TYPES };
+		        PrivilegeConstants.GET_CONCEPT_ATTRIBUTE_TYPES, PrivilegeConstants.GET_GLOBAL_PROPERTIES };
 		assertThat("listener1", listener1.hasPrivileges, containsInAnyOrder(privileges));
 		assertThat("listener2", listener2.hasPrivileges, containsInAnyOrder(privileges));
 		assertThat(listener1.lacksPrivileges, empty());
diff --git a/api/src/test/java/org/openmrs/api/AdministrationServiceTest.java b/api/src/test/java/org/openmrs/api/AdministrationServiceTest.java
index 27c59f3f63ac..9227815970ea 100644
--- a/api/src/test/java/org/openmrs/api/AdministrationServiceTest.java
+++ b/api/src/test/java/org/openmrs/api/AdministrationServiceTest.java
@@ -20,7 +20,6 @@
 import static org.junit.jupiter.api.Assertions.assertNull;
 import static org.junit.jupiter.api.Assertions.assertThrows;
 import static org.junit.jupiter.api.Assertions.assertTrue;
-import static org.junit.jupiter.api.Assertions.fail;
 import static org.mockito.Mockito.mock;
 
 import java.util.ArrayList;
@@ -40,7 +39,6 @@
 import org.openmrs.User;
 import org.openmrs.api.context.Context;
 import org.openmrs.api.context.Credentials;
-import org.openmrs.api.context.UserContext;
 import org.openmrs.api.context.UsernamePasswordCredentials;
 import org.openmrs.customdatatype.datatype.BooleanDatatype;
 import org.openmrs.customdatatype.datatype.DateDatatype;
@@ -554,7 +552,7 @@ public void filterGlobalPropertiesByViewPrivilege_shouldFilterGlobalPropertiesIf
 		GlobalProperty property = new GlobalProperty();
 		property.setProperty("test_property");
 		property.setPropertyValue("test_property_value");
-		property.setViewPrivilege(Context.getUserService().getPrivilege("Some Privilege For View Global Properties"));
+		property.setViewPrivilege(Context.getUserService().getPrivilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES));
 		adminService.saveGlobalProperty(property);
 		// assert new test global property is saved properly
 		List<GlobalProperty> properties = adminService.getAllGlobalProperties();
@@ -588,9 +586,8 @@ public void getGlobalProperty_shouldFailIfUserHasNoPrivileges() {
 		Context.logout();
 		Context.authenticate(getTestUserCredentials());
 		
-		APIException exception = assertThrows(APIException.class, () -> adminService.getGlobalProperty(property.getProperty()));
-		assertEquals(exception.getMessage(), String.format("Privilege: %s, required to view globalProperty: %s",
-			property.getViewPrivilege(), property.getProperty()));
+		APIAuthenticationException exception = assertThrows(APIAuthenticationException.class, () -> adminService.getGlobalProperty(property.getProperty()));
+		assertEquals(exception.getMessage(), String.format("Privileges required: %s", property.getViewPrivilege()));
 	}
 	
 	/**
@@ -608,7 +605,6 @@ public void getGlobalProperty_shouldReturnGlobalPropertyIfUserIsAllowedToView()
 		Role role = Context.getUserService().getRole("Provider");
 		role.addPrivilege(property.getViewPrivilege());
 		Context.getAuthenticatedUser().addRole(role);
-		
 		assertNotNull(adminService.getGlobalProperty(property.getProperty()));
 	}
 
@@ -625,8 +621,8 @@ public void getGlobalPropertyObject_shouldFailIfUserHasNoPrivileges() {
 		Context.authenticate(getTestUserCredentials());
 
 		APIException exception = assertThrows(APIException.class, () -> adminService.getGlobalPropertyObject(property.getProperty()));
-		assertEquals(exception.getMessage(), String.format("Privilege: %s, required to view globalProperty: %s",
-			property.getViewPrivilege(), property.getProperty()));
+		assertEquals(exception.getMessage(), String.format("Privileges required: %s",
+			property.getViewPrivilege()));
 	}
 
 	/**
@@ -662,8 +658,8 @@ public void updateGlobalProperty_shouldFailIfUserIsNotAllowedToEditGlobalPropert
 		Context.authenticate(getTestUserCredentials());
 		
 		APIException exception = assertThrows(APIException.class, () -> adminService.updateGlobalProperty(property.getProperty(), "new-value"));
-		assertEquals(exception.getMessage(), String.format("Privilege: %s, required to edit globalProperty: %s",
-			property.getEditPrivilege(), property.getProperty()));
+		assertEquals(exception.getMessage(), String.format("Privileges required: %s",
+			property.getEditPrivilege()));
 	}
 	
 	/**
@@ -673,6 +669,7 @@ public void updateGlobalProperty_shouldFailIfUserIsNotAllowedToEditGlobalPropert
 	public void updateGlobalProperty_shouldUpdateIfUserIsAllowedToEditGlobalProperty() {
 		executeDataSet(ADMIN_INITIAL_DATA_XML);
 		GlobalProperty property = getGlobalPropertyWithEditPrivilege();
+		GlobalProperty globalPropertyWithViewPrivilege = getGlobalPropertyWithViewPrivilege();
 		assertEquals("anothervalue", property.getPropertyValue());
 
 		// authenticate new user without privileges
@@ -681,6 +678,9 @@ public void updateGlobalProperty_shouldUpdateIfUserIsAllowedToEditGlobalProperty
 		// add required privilege to user
 		Role role = Context.getUserService().getRole("Provider");
 		role.addPrivilege(property.getEditPrivilege());
+
+		role.addPrivilege(globalPropertyWithViewPrivilege.getViewPrivilege());
+		
 		Context.getAuthenticatedUser().addRole(role);
 		
 		adminService.updateGlobalProperty(property.getProperty(), "new-value");
@@ -735,7 +735,7 @@ private GlobalProperty getGlobalPropertyWithViewPrivilege() {
 		GlobalProperty property = adminService.getGlobalPropertyObject("another-global-property");
 		assertNotNull(property);
 		
-		Privilege viewPrivilege = Context.getUserService().getPrivilege("Some Privilege For View Global Properties");
+		Privilege viewPrivilege = Context.getUserService().getPrivilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES);
 		property.setViewPrivilege(viewPrivilege);
 		property = adminService.saveGlobalProperty(property);
 		assertNotNull(property.getViewPrivilege());
@@ -752,7 +752,7 @@ private GlobalProperty getGlobalPropertyWithEditPrivilege() {
 		GlobalProperty property = adminService.getGlobalPropertyObject("another-global-property");
 		assertNotNull(property);
 		
-		Privilege editPrivilege = Context.getUserService().getPrivilege("Some Privilege For Edit Global Properties");
+		Privilege editPrivilege = Context.getUserService().getPrivilege(PrivilegeConstants.MANAGE_GLOBAL_PROPERTIES);
 		property.setEditPrivilege(editPrivilege);
 		property = adminService.saveGlobalProperty(property);
 		assertNotNull(property.getEditPrivilege());
diff --git a/api/src/test/java/org/openmrs/api/UserServiceTest.java b/api/src/test/java/org/openmrs/api/UserServiceTest.java
index f8246682c4e2..fe27de4a187b 100644
--- a/api/src/test/java/org/openmrs/api/UserServiceTest.java
+++ b/api/src/test/java/org/openmrs/api/UserServiceTest.java
@@ -268,6 +268,7 @@ public void createUser_shouldNotAllowCreatingUserWithPrivilegeCurrentUserDoesNot
 		Role userRole = new Role("User Adder");
 		userRole.setRole(RoleConstants.AUTHENTICATED);
 		userRole.addPrivilege(new Privilege("Add Users"));
+		userRole.addPrivilege(new Privilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES));
 		currentUser.addRole(userRole);
 		// setup our expected exception
 		// we expect this to fail because the currently logged-in user lacks a privilege to be
@@ -301,6 +302,7 @@ public void createUser_shouldNotAllowCreatingUserWithPrivilegesCurrentUserDoesNo
 		Role userRole = new Role("User Adder");
 		userRole.setRole(RoleConstants.AUTHENTICATED);
 		userRole.addPrivilege(new Privilege("Add Users"));
+		userRole.addPrivilege(new Privilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES));
 		currentUser.addRole(userRole);
 		// setup our expected exception
 		// we expect this to fail because the currently logged-in user lacks a privilege to be
@@ -335,8 +337,8 @@ public void createUser_shouldNotAllowAssigningSuperUserRoleIfCurrentUserDoesNotH
 		Role userRole = new Role("User Adder");
 		userRole.setRole(RoleConstants.AUTHENTICATED);
 		userRole.addPrivilege(new Privilege("Add Users"));
+		userRole.addPrivilege(new Privilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES));
 		currentUser.addRole(userRole);
-
 		// setup our expected exception
 		// we expect this to fail because the currently logged-in user lacks a privilege to be
 		// assigned to the new user
@@ -502,9 +504,8 @@ public void changePassword_shouldMatchOnIncorrectlyHashedSha1StoredPassword() {
 		executeDataSet(XML_FILENAME);
 		Context.logout();
 		Context.authenticate("incorrectlyhashedSha1", "test");
-
+		Context.addProxyPrivilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES);
 		userService.changePassword("test", "Tester12");
-
 		Context.logout(); // so that the next test reauthenticates
 	}
 
@@ -544,9 +545,8 @@ public void changePassword_shouldMatchOnCorrectlyHashedSha1StoredPassword() {
 		executeDataSet(XML_FILENAME);
 		Context.logout();
 		Context.authenticate("correctlyhashedSha1", "test");
-
+		Context.addProxyPrivilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES);
 		userService.changePassword("test", "Tester12");
-
 		Context.logout(); // so that the next test reauthenticates
 	}
 
@@ -572,9 +572,8 @@ public void changePassword_shouldMatchOnSha512HashedPassword() {
 		executeDataSet(XML_FILENAME);
 		Context.logout();
 		Context.authenticate("userWithSha512Hash", "test");
-
+		Context.addProxyPrivilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES);
 		userService.changePassword("test", "Tester12");
-
 		Context.logout(); // so that the next test reauthenticates
 	}
 
@@ -1520,9 +1519,9 @@ public void changePasswordUsingSecretAnswer_shouldUpdatePasswordIfSecretIsCorrec
 		User user = userService.getUser(6001);
 		assertFalse(user.hasPrivilege(PrivilegeConstants.EDIT_USER_PASSWORDS));
 		Context.authenticate(user.getUsername(), "userServiceTest");
-		
+		Context.addProxyPrivilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES);
 		userService.changePasswordUsingSecretAnswer("answer", "userServiceTest2");
-		
+		Context.removeProxyPrivilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES);
 		Context.authenticate(user.getUsername(), "userServiceTest2");
 	}
 
@@ -1614,7 +1613,9 @@ public void changePasswordUsingActivationKey_shouldUpdatePasswordIfActivationKey
 		
 		final String PASSWORD = "Admin123";
 		Context.authenticate(createdUser.getUsername(), "Openmr5xy");
+		Context.addProxyPrivilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES);
 		userService.changePasswordUsingActivationKey(key, PASSWORD);
+		Context.removeProxyPrivilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES);
 		Context.authenticate(createdUser.getUsername(), PASSWORD);
 		
 	}
diff --git a/api/src/test/java/org/openmrs/api/db/ContextDAOTest.java b/api/src/test/java/org/openmrs/api/db/ContextDAOTest.java
index 688c5cfbf3f3..540df393407e 100644
--- a/api/src/test/java/org/openmrs/api/db/ContextDAOTest.java
+++ b/api/src/test/java/org/openmrs/api/db/ContextDAOTest.java
@@ -32,6 +32,7 @@
 import org.openmrs.api.context.ContextAuthenticationException;
 import org.openmrs.api.db.hibernate.HibernateContextDAO;
 import org.openmrs.test.jupiter.BaseContextSensitiveTest;
+import org.openmrs.util.PrivilegeConstants;
 import org.springframework.stereotype.Component;
 
 /**
@@ -279,6 +280,7 @@ public void authenticate_shouldPassRegressionTestFor1580() {
 		Context.logout();
 		
 		// first we fail a login attempt
+		Context.addProxyPrivilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES);
 		try {
 			dao.authenticate("admin", "not the right password");
 			fail("Not sure why this username/password combo worked");
@@ -309,7 +311,13 @@ public void authenticate_shouldPassRegressionTestFor1580() {
 		
 		// those were the first eight, now the ninth request 
 		// (with the same user and right pw) should fail
-		assertThrows(ContextAuthenticationException.class, () -> dao.authenticate("admin", "test"));
+		assertThrows(ContextAuthenticationException.class, () -> {
+			Context.addProxyPrivilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES);
+			dao.authenticate("admin", "test");
+			Context.removeProxyPrivilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES);
+		});
+
+		Context.removeProxyPrivilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES);
 	}
 	
 	@Test
diff --git a/api/src/test/java/org/openmrs/test/StartModuleExecutionListener.java b/api/src/test/java/org/openmrs/test/StartModuleExecutionListener.java
index 86498b7212a5..ce724b21e748 100644
--- a/api/src/test/java/org/openmrs/test/StartModuleExecutionListener.java
+++ b/api/src/test/java/org/openmrs/test/StartModuleExecutionListener.java
@@ -27,6 +27,7 @@
 import org.openmrs.module.ModuleInteroperabilityTest;
 import org.openmrs.module.ModuleUtil;
 import org.openmrs.util.OpenmrsClassLoader;
+import org.openmrs.util.PrivilegeConstants;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.beans.factory.config.BeanDefinition;
@@ -89,12 +90,16 @@ public void prepareTestInstance(TestContext testContext) throws Exception {
 				Properties props = BaseContextSensitiveTest.runtimeProperties;
 				props.setProperty(ModuleConstants.RUNTIMEPROPERTY_MODULE_LIST_TO_LOAD, modulesToLoad);
 				try {
+					Context.addProxyPrivilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES);
 					ModuleUtil.startup(props);
 				}
 				catch (Exception e) {
 					log.error("Error while starting modules: ", e);
 					throw e;
 				}
+				finally {
+					Context.removeProxyPrivilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES);
+				}
 				assertTrue("Some of the modules did not start successfully for "
 				        + testContext.getTestClass().getSimpleName() + ". Only " + ModuleFactory.getStartedModules().size()
 				        + " modules started instead of " + startModuleAnnotation.value().length, startModuleAnnotation
diff --git a/api/src/test/java/org/openmrs/test/jupiter/StartModuleExecutionListener.java b/api/src/test/java/org/openmrs/test/jupiter/StartModuleExecutionListener.java
index 7d15c3e53b0f..1a0dd45e2dd1 100644
--- a/api/src/test/java/org/openmrs/test/jupiter/StartModuleExecutionListener.java
+++ b/api/src/test/java/org/openmrs/test/jupiter/StartModuleExecutionListener.java
@@ -28,6 +28,7 @@
 import org.openmrs.module.ModuleUtil;
 import org.openmrs.test.StartModule;
 import org.openmrs.util.OpenmrsClassLoader;
+import org.openmrs.util.PrivilegeConstants;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.beans.factory.config.BeanDefinition;
@@ -78,6 +79,7 @@ public void prepareTestInstance(TestContext testContext) throws Exception {
 				if (!Context.isSessionOpen())
 					Context.openSession();
 				
+				
 				ModuleUtil.shutdown();
 				
 				// load the omods that the dev defined for this class
@@ -86,12 +88,16 @@ public void prepareTestInstance(TestContext testContext) throws Exception {
 				Properties props = BaseContextSensitiveTest.runtimeProperties;
 				props.setProperty(ModuleConstants.RUNTIMEPROPERTY_MODULE_LIST_TO_LOAD, modulesToLoad);
 				try {
+					Context.addProxyPrivilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES);
 					ModuleUtil.startup(props);
 				}
 				catch (Exception e) {
 					log.error("Error while starting modules: ", e);
 					throw e;
 				}
+				finally {
+					Context.removeProxyPrivilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES);
+				}
 				assertTrue("Some of the modules did not start successfully for "
 					+ testContext.getTestClass().getSimpleName() + ". Only " + ModuleFactory.getStartedModules().size()
 					+ " modules started instead of " + startModuleAnnotation.value().length, startModuleAnnotation
diff --git a/api/src/test/resources/org/openmrs/api/include/AdministrationServiceTest-globalproperties.xml b/api/src/test/resources/org/openmrs/api/include/AdministrationServiceTest-globalproperties.xml
index 71261c02d13f..3d248f93b442 100644
--- a/api/src/test/resources/org/openmrs/api/include/AdministrationServiceTest-globalproperties.xml
+++ b/api/src/test/resources/org/openmrs/api/include/AdministrationServiceTest-globalproperties.xml
@@ -21,8 +21,8 @@
   <global_property property="valid.integer" property_value="1234" uuid="b7225607-d0c4-4e44-8be5-31e1ac7e1fda"/>
   <global_property property="valid.double" property_value="1234.54" uuid="b7225607-d0c4-4e44-8be6-31e1ac7e1fda"/>
 
-	<privilege privilege="Some Privilege For View Global Properties" description="This is a test privilege for view global properties" uuid="d979d066-15e6-467c-9d4b-cb575ef12345"/>
-	<privilege privilege="Some Privilege For Edit Global Properties" description="This is a test privilege for edit global properties" uuid="d979d066-15e6-467c-9d4b-cb575ef54321"/>
+	<privilege privilege="Get Global Properties" description="This is a test privilege for view global properties" uuid="d979d066-15e6-467c-9d4b-cb575ef12345"/>
+	<privilege privilege="Manage Global Properties" description="This is a test privilege for edit global properties" uuid="d979d066-15e6-467c-9d4b-cb575ef54321"/>
 	<privilege privilege="Some Privilege For Delete Global Properties" description="This is a test privilege for delete global properties" uuid="d979d066-15e6-467c-9d4b-cb575ef67890"/>
 	<users user_id="5506" person_id="501" system_id="7-5" username="test_user" password="4a1750c8607d0fa237de36c6305715c223415189" salt="c788c6ad82a157b712392ca695dfcf2eed193d7f" secret_question="" creator="1" date_created="2008-08-15 15:57:09.0" changed_by="1" date_changed="2008-08-18 11:51:56.0" retired="false" retire_reason="" uuid="06d05314-e132-11de-babe-001e37123456"/>
 </dataset>

From 4df6afd0355b5dddbb93eb71bbcb76514b6efa34 Mon Sep 17 00:00:00 2001
From: dkayiwa <dkayiwa@openmrs.org>
Date: Thu, 27 Jun 2024 00:04:35 +0300
Subject: [PATCH 045/163] TRUNK-6203: Global properties access should be
 privileged

---
 web/src/main/java/org/openmrs/web/filter/GZIPFilter.java | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/web/src/main/java/org/openmrs/web/filter/GZIPFilter.java b/web/src/main/java/org/openmrs/web/filter/GZIPFilter.java
index 1f3f22c4f6aa..83886055ced8 100644
--- a/web/src/main/java/org/openmrs/web/filter/GZIPFilter.java
+++ b/web/src/main/java/org/openmrs/web/filter/GZIPFilter.java
@@ -19,6 +19,7 @@
 import org.openmrs.api.APIException;
 import org.openmrs.api.context.Context;
 import org.openmrs.util.OpenmrsConstants;
+import org.openmrs.util.PrivilegeConstants;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.web.filter.OncePerRequestFilter;
@@ -124,6 +125,8 @@ private boolean isGZIPEnabled() {
 		}
 		
 		try {
+			Context.addProxyPrivilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES);
+			
 			String gzipEnabled = Context.getAdministrationService().getGlobalProperty(
 			    OpenmrsConstants.GLOBAL_PROPERTY_GZIP_ENABLED, "");
 
@@ -137,6 +140,9 @@ private boolean isGZIPEnabled() {
 			
 			return false;
 		}
+		finally {
+			Context.removeProxyPrivilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES);
+		}
 	}
 	
 	/**

From 2586624dbca17138658d4dd821b1355226106dca Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 27 Jun 2024 22:45:25 +0300
Subject: [PATCH 046/163] maven(deps): bump junitVersion from 5.10.2 to 5.10.3
 (#4679)

Bumps `junitVersion` from 5.10.2 to 5.10.3.

Updates `org.junit.jupiter:junit-jupiter-api` from 5.10.2 to 5.10.3
- [Release notes](https://github.com/junit-team/junit5/releases)
- [Commits](https://github.com/junit-team/junit5/compare/r5.10.2...r5.10.3)

Updates `org.junit.jupiter:junit-jupiter-engine` from 5.10.2 to 5.10.3
- [Release notes](https://github.com/junit-team/junit5/releases)
- [Commits](https://github.com/junit-team/junit5/compare/r5.10.2...r5.10.3)

Updates `org.junit.jupiter:junit-jupiter-params` from 5.10.2 to 5.10.3
- [Release notes](https://github.com/junit-team/junit5/releases)
- [Commits](https://github.com/junit-team/junit5/compare/r5.10.2...r5.10.3)

Updates `org.junit.vintage:junit-vintage-engine` from 5.10.2 to 5.10.3
- [Release notes](https://github.com/junit-team/junit5/releases)
- [Commits](https://github.com/junit-team/junit5/compare/r5.10.2...r5.10.3)

---
updated-dependencies:
- dependency-name: org.junit.jupiter:junit-jupiter-api
  dependency-type: direct:development
  update-type: version-update:semver-patch
- dependency-name: org.junit.jupiter:junit-jupiter-engine
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: org.junit.jupiter:junit-jupiter-params
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: org.junit.vintage:junit-vintage-engine
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 8863a3af5c4f..0f4719e8e8e6 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1217,7 +1217,7 @@
 		<luceneVersion>5.5.5</luceneVersion>
 		<aspectjVersion>1.9.22.1</aspectjVersion>
 		<jacksonVersion>2.17.1</jacksonVersion>
-		<junitVersion>5.10.2</junitVersion>
+		<junitVersion>5.10.3</junitVersion>
 		<mockitoVersion>3.12.4</mockitoVersion>
 		<hamcrestVersion>2.2</hamcrestVersion>
 

From dec07a0c4771d8344608f98c5bcc6b0331930e63 Mon Sep 17 00:00:00 2001
From: dkayiwa <dkayiwa@openmrs.org>
Date: Mon, 1 Jul 2024 17:12:27 +0300
Subject: [PATCH 047/163] O3-3518 Unable to End Visits with
 visits.allowOverlappingVisits=false

---
 .../org/openmrs/validator/VisitValidator.java    |  3 +++
 .../java/org/openmrs/api/VisitServiceTest.java   | 16 ++++++++++++++++
 .../org/openmrs/include/standardTestDataset.xml  |  4 ++--
 3 files changed, 21 insertions(+), 2 deletions(-)

diff --git a/api/src/main/java/org/openmrs/validator/VisitValidator.java b/api/src/main/java/org/openmrs/validator/VisitValidator.java
index 41674b204c3c..e0a312171f69 100644
--- a/api/src/main/java/org/openmrs/validator/VisitValidator.java
+++ b/api/src/main/java/org/openmrs/validator/VisitValidator.java
@@ -109,6 +109,9 @@ public void validate(Object target, Errors errors) {
 		if (disallowOverlappingVisits()) {
 			List<Visit> otherVisitList = Context.getVisitService().getVisitsByPatient(visit.getPatient());
 			for (Visit otherVisit : otherVisitList) {
+				if (visit.equals(otherVisit)) {
+					continue;
+				}
 				validateStartDatetime(visit, otherVisit, errors);
 				validateStopDatetime(visit, otherVisit, errors);
 			}
diff --git a/api/src/test/java/org/openmrs/api/VisitServiceTest.java b/api/src/test/java/org/openmrs/api/VisitServiceTest.java
index d66ffce97e74..65514ce74cba 100644
--- a/api/src/test/java/org/openmrs/api/VisitServiceTest.java
+++ b/api/src/test/java/org/openmrs/api/VisitServiceTest.java
@@ -781,6 +781,22 @@ public void endVisit_shouldFailIfValidationErrorsAreFound() {
 		assertThrows(APIException.class, () -> visitService.endVisit(visit, cal.getTime()));
 	}
 	
+	/**
+	 * @see VisitService#endVisit(Visit,Date)
+	 */
+	@Test
+	public void endVisit_shouldNotFailIfAllowOverlappingVisitsIsFalse() {
+		
+		Context.getAdministrationService().setGlobalProperty("visits.allowOverlappingVisits", "false");
+		
+		Visit visit = visitService.getVisit(1);
+		assertNull(visit.getStopDatetime());
+		
+		visitService.endVisit(visit, null);
+		
+		assertNotNull(visit.getStopDatetime());
+	}
+	
 	/**
 	 * @see VisitService#purgeVisit(Visit)
 	 */
diff --git a/api/src/test/resources/org/openmrs/include/standardTestDataset.xml b/api/src/test/resources/org/openmrs/include/standardTestDataset.xml
index 6af982e5c0a9..c7f58371d138 100644
--- a/api/src/test/resources/org/openmrs/include/standardTestDataset.xml
+++ b/api/src/test/resources/org/openmrs/include/standardTestDataset.xml
@@ -440,8 +440,8 @@
   <visit_type visit_type_id="2" name="Return TB Clinic Visit" description="Return TB Clinic Visit Description" creator="1" date_created="2005-01-01 00:00:00.0" retired="false" uuid="759799ab-c9a5-435e-b671-77773ada74e4"/>
   <visit_type visit_type_id="3" name="Hospitalization" description="Hospitalization Description" creator="1" date_created="2005-01-01 00:00:00.0" retired="true" retire_reason="Some Retire Reason" uuid="759799ab-c9a5-435e-b671-77773ada74e6"/> 
   <visit visit_id="1" patient_id="2" visit_type_id="1" date_started="2005-01-01 00:00:00.0" location_id="1" indication_concept_id="5497" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="1e5d5d48-6b78-11e0-93c3-18a905e044dc" />
-  <visit visit_id="2" patient_id="2" visit_type_id="1" date_started="2005-01-01 00:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="4e663d66-6b78-11e0-93c3-18a905e044dc" />
-  <visit visit_id="3" patient_id="2" visit_type_id="2" date_started="2005-01-01 00:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="6f85b2a6-6b78-11e0-93c3-18a905e044dc" />
+  <visit visit_id="2" patient_id="2" visit_type_id="1" date_started="2005-01-02 00:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="4e663d66-6b78-11e0-93c3-18a905e044dc" />
+  <visit visit_id="3" patient_id="2" visit_type_id="2" date_started="2005-01-03 00:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="6f85b2a6-6b78-11e0-93c3-18a905e044dc" />
   <visit visit_id="4" patient_id="6" visit_type_id="1" date_started="2005-01-01 00:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="7d8c1980-6b78-11e0-93c3-18a905e044dc" />
   <visit visit_id="5" patient_id="6" visit_type_id="1" date_started="2005-01-01 00:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="8cfda6ae-6b78-11e0-93c3-18a905e044dc" />
   <visit visit_id="6" patient_id="2" visit_type_id="1" date_started="2005-01-01 00:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="1" voided_by="1" date_voided="2005-01-01 00:00:00.0" void_reason="no reason" uuid="e1428fea-6b78-11e0-93c3-18a905e044dc" />

From 3933fb312cafe98c56924eb7e63ebf53f29e8a6a Mon Sep 17 00:00:00 2001
From: Ian <52504170+ibacher@users.noreply.github.com>
Date: Mon, 1 Jul 2024 16:49:56 -0400
Subject: [PATCH 048/163] Fix the image release jobs

---
 bamboo-specs/bamboo.yml | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/bamboo-specs/bamboo.yml b/bamboo-specs/bamboo.yml
index 5787c46261c2..4d55d529895b 100644
--- a/bamboo-specs/bamboo.yml
+++ b/bamboo-specs/bamboo.yml
@@ -337,14 +337,14 @@ Release JDK 11 image:
                       #!/bin/bash -eux
                       
                       set +x
+
+                      export JDK_IMAGE="amazoncorretto-11"
+                      export RUNTIME_JDK="jdk11-corretto"
                       
                       export OMRS_VERSION=${bamboo.maven.release.version}
-                      export IMAGE_NIGHTLY=${bamboo.docker.image.name}:${bamboo.docker.image.tag}-${JDK_IMAGE}
-                      
+					  export IMAGE_NIGHTLY=${bamboo.docker.image.name}:${bamboo.docker.image.tag}
                       export IMAGE=${bamboo.docker.image.name}:${OMRS_VERSION}
                       export DEV_IMAGE=${bamboo.docker.image.name}:${OMRS_VERSION}-dev
-                      export JDK_IMAGE="amazoncorretto-11"
-                      export RUNTIME_JDK="jdk11-corretto"
                       
                       docker login -u ${bamboo.dockerhub.username} -p ${bamboo.dockerhub.password}
                       
@@ -380,14 +380,14 @@ Release JDK 17 image:
                       #!/bin/bash -eux
                       
                       set +x
+
+	                  export JDK_IMAGE="amazoncorretto-17"
+                      export RUNTIME_JDK="jdk17-corretto"
                       
                       export OMRS_VERSION=${bamboo.maven.release.version}
-                      export IMAGE_NIGHTLY=${bamboo.docker.image.name}:${bamboo.docker.image.tag}-${JDK_IMAGE}
-                      
+                      export IMAGE_NIGHTLY=${bamboo.docker.image.name}:${bamboo.docker.image.tag}
                       export IMAGE=${bamboo.docker.image.name}:${OMRS_VERSION}
-                      export DEV_IMAGE=${bamboo.docker.image.name}:${OMRS_VERSION}-dev
-                      export JDK_IMAGE="amazoncorretto-17"
-                      export RUNTIME_JDK="jdk17-corretto"
+                      export DEV_IMAGE=${bamboo.docker.image.name}:${OMRS_VERSION}
                       
                       docker login -u ${bamboo.dockerhub.username} -p ${bamboo.dockerhub.password}
                       

From 758715f819a712b06a554a8cba91cbaf31f63267 Mon Sep 17 00:00:00 2001
From: dkayiwa <dkayiwa@openmrs.org>
Date: Tue, 2 Jul 2024 15:04:48 +0300
Subject: [PATCH 049/163] SDK-330: bumping sdk version

---
 Dockerfile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Dockerfile b/Dockerfile
index ad00abcba1ad..f9a9fe651a3d 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -19,7 +19,7 @@ RUN yum -y update && yum -y install git && yum clean all
 WORKDIR /openmrs_core
 
 ENV OMRS_SDK_PLUGIN="org.openmrs.maven.plugins:openmrs-sdk-maven-plugin"
-ENV OMRS_SDK_PLUGIN_VERSION="4.5.0"
+ENV OMRS_SDK_PLUGIN_VERSION="5.11.0"
 
 COPY docker-pom.xml .
 

From 5701af169e433dcff3ebf14f8af9f928536263cc Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 3 Jul 2024 23:55:53 +0300
Subject: [PATCH 050/163] maven(deps): bump
 org.codehaus.cargo:cargo-maven3-plugin (#4681)

Bumps org.codehaus.cargo:cargo-maven3-plugin from 1.10.13 to 1.10.14.

---
updated-dependencies:
- dependency-name: org.codehaus.cargo:cargo-maven3-plugin
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 webapp/pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/webapp/pom.xml b/webapp/pom.xml
index 9cf2fffb1b34..af686ea059c5 100644
--- a/webapp/pom.xml
+++ b/webapp/pom.xml
@@ -237,7 +237,7 @@
 		  <plugin>
               <groupId>org.codehaus.cargo</groupId>
               <artifactId>cargo-maven3-plugin</artifactId>
-              <version>1.10.13</version>
+              <version>1.10.14</version>
               <configuration>
                   <container>
                       <containerId>tomcat9x</containerId>

From de6c77f431f9eb767fd7637ef75c644865fe5321 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 8 Jul 2024 22:06:38 +0300
Subject: [PATCH 051/163] maven(deps): bump jacksonVersion from 2.17.1 to
 2.17.2 (#4683)

Bumps `jacksonVersion` from 2.17.1 to 2.17.2.

Updates `com.fasterxml.jackson.core:jackson-core` from 2.17.1 to 2.17.2
- [Commits](https://github.com/FasterXML/jackson-core/compare/jackson-core-2.17.1...jackson-core-2.17.2)

Updates `com.fasterxml.jackson.core:jackson-annotations` from 2.17.1 to 2.17.2
- [Commits](https://github.com/FasterXML/jackson/commits)

Updates `com.fasterxml.jackson.core:jackson-databind` from 2.17.1 to 2.17.2
- [Commits](https://github.com/FasterXML/jackson/commits)

Updates `com.fasterxml.jackson.datatype:jackson-datatype-jsr310` from 2.17.1 to 2.17.2

---
updated-dependencies:
- dependency-name: com.fasterxml.jackson.core:jackson-core
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: com.fasterxml.jackson.core:jackson-annotations
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: com.fasterxml.jackson.core:jackson-databind
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: com.fasterxml.jackson.datatype:jackson-datatype-jsr310
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 0f4719e8e8e6..dd437e631fe8 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1216,7 +1216,7 @@
 		<hibernateSearchVersion>5.11.12.Final</hibernateSearchVersion>
 		<luceneVersion>5.5.5</luceneVersion>
 		<aspectjVersion>1.9.22.1</aspectjVersion>
-		<jacksonVersion>2.17.1</jacksonVersion>
+		<jacksonVersion>2.17.2</jacksonVersion>
 		<junitVersion>5.10.3</junitVersion>
 		<mockitoVersion>3.12.4</mockitoVersion>
 		<hamcrestVersion>2.2</hamcrestVersion>

From 8ea5c0576270c1074d093b2d5d7c79385986dd4d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 9 Jul 2024 21:55:40 +0300
Subject: [PATCH 052/163] maven(deps): bump net.bytebuddy:byte-buddy from
 1.14.17 to 1.14.18 (#4685)

Bumps [net.bytebuddy:byte-buddy](https://github.com/raphw/byte-buddy) from 1.14.17 to 1.14.18.
- [Release notes](https://github.com/raphw/byte-buddy/releases)
- [Changelog](https://github.com/raphw/byte-buddy/blob/master/release-notes.md)
- [Commits](https://github.com/raphw/byte-buddy/compare/byte-buddy-1.14.17...byte-buddy-1.14.18)

---
updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index dd437e631fe8..3e8015220375 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1129,7 +1129,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy</artifactId>
-						<version>1.14.17</version>
+						<version>1.14.18</version>
 					</dependency>
 					<dependency>
 						<groupId>net.bytebuddy</groupId>

From 18b97aec8f8dc12358b9ca72154c3e5def86d65f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 9 Jul 2024 21:56:13 +0300
Subject: [PATCH 053/163] maven(deps): bump net.bytebuddy:byte-buddy-agent from
 1.14.17 to 1.14.18 (#4686)

Bumps [net.bytebuddy:byte-buddy-agent](https://github.com/raphw/byte-buddy) from 1.14.17 to 1.14.18.
- [Release notes](https://github.com/raphw/byte-buddy/releases)
- [Changelog](https://github.com/raphw/byte-buddy/blob/master/release-notes.md)
- [Commits](https://github.com/raphw/byte-buddy/compare/byte-buddy-1.14.17...byte-buddy-1.14.18)

---
updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy-agent
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 3e8015220375..70a77cfd9e54 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1134,7 +1134,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy-agent</artifactId>
-						<version>1.14.17</version>
+						<version>1.14.18</version>
 					</dependency>
 				</dependencies>
 			</dependencyManagement>

From 20d402efd0d5317a7639aec1f170d6e5f8a06418 Mon Sep 17 00:00:00 2001
From: dkayiwa <dkayiwa@openmrs.org>
Date: Thu, 11 Jul 2024 21:02:11 +0300
Subject: [PATCH 054/163] TRUNK-6208 upgrade liquibase to 4.28.0

---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 70a77cfd9e54..45edc734127f 100644
--- a/pom.xml
+++ b/pom.xml
@@ -274,7 +274,7 @@
 			<dependency>
 				<groupId>org.liquibase</groupId>
 				<artifactId>liquibase-core</artifactId>
-				<version>4.27.0</version>
+				<version>4.28.0</version>
 				<exclusions>
 					<exclusion>
 						<groupId>ch.qos.logback</groupId>

From b4426232e5a97f7035c7e70f4b22f5e12e19680b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 11 Jul 2024 23:06:37 +0300
Subject: [PATCH 055/163] maven(deps): bump
 org.apache.maven.plugins:maven-surefire-plugin (#4689)

Bumps [org.apache.maven.plugins:maven-surefire-plugin](https://github.com/apache/maven-surefire) from 3.3.0 to 3.3.1.
- [Release notes](https://github.com/apache/maven-surefire/releases)
- [Commits](https://github.com/apache/maven-surefire/compare/surefire-3.3.0...surefire-3.3.1)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-surefire-plugin
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pom.xml b/pom.xml
index 45edc734127f..e4ed86cf1e72 100644
--- a/pom.xml
+++ b/pom.xml
@@ -603,7 +603,7 @@
 				<plugin>
 					<groupId>org.apache.maven.plugins</groupId>
 					<artifactId>maven-surefire-plugin</artifactId>
-					<version>3.3.0</version>
+					<version>3.3.1</version>
 				</plugin>
 				<plugin>
 					<groupId>org.apache.maven.plugins</groupId>
@@ -935,7 +935,7 @@
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-surefire-plugin</artifactId>
-				<version>3.3.0</version>
+				<version>3.3.1</version>
 				<configuration>
 					<failIfNoTests>false</failIfNoTests>
 					<useSystemClassLoader>false</useSystemClassLoader>

From 2df2e48066fd903c4bf48ca34b935e0435370ce1 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 15 Jul 2024 22:28:46 +0300
Subject: [PATCH 056/163] maven(deps): bump
 org.apache.maven.plugins:maven-release-plugin (#4692)

Bumps [org.apache.maven.plugins:maven-release-plugin](https://github.com/apache/maven-release) from 3.1.0 to 3.1.1.
- [Release notes](https://github.com/apache/maven-release/releases)
- [Commits](https://github.com/apache/maven-release/compare/maven-release-3.1.0...maven-release-3.1.1)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-release-plugin
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index e4ed86cf1e72..c50b3c653b85 100644
--- a/pom.xml
+++ b/pom.xml
@@ -705,7 +705,7 @@
 				<plugin>
 					<groupId>org.apache.maven.plugins</groupId>
 					<artifactId>maven-release-plugin</artifactId>
-					<version>3.1.0</version>
+					<version>3.1.1</version>
 					<configuration>
 						<preparationGoals>clean install</preparationGoals>
 						<autoVersionSubmodules>true</autoVersionSubmodules>

From 2b11fc2648ff4e631ddaccbc46029c0340029c99 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 17 Jul 2024 22:42:58 +0300
Subject: [PATCH 057/163] maven(deps-dev): bump org.testcontainers:postgresql
 (#4695)

Bumps [org.testcontainers:postgresql](https://github.com/testcontainers/testcontainers-java) from 1.19.8 to 1.20.0.
- [Release notes](https://github.com/testcontainers/testcontainers-java/releases)
- [Changelog](https://github.com/testcontainers/testcontainers-java/blob/main/CHANGELOG.md)
- [Commits](https://github.com/testcontainers/testcontainers-java/compare/1.19.8...1.20.0)

---
updated-dependencies:
- dependency-name: org.testcontainers:postgresql
  dependency-type: direct:development
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index c50b3c653b85..b232d7e7df89 100644
--- a/pom.xml
+++ b/pom.xml
@@ -591,7 +591,7 @@
 			<dependency>
 				<groupId>org.testcontainers</groupId>
 				<artifactId>postgresql</artifactId>
-				<version>1.19.8</version>
+				<version>1.20.0</version>
 				<scope>test</scope>
 			</dependency>
 		</dependencies>

From 1087fcdc91e0c0e5c78816a762aa88e0b97c9417 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 17 Jul 2024 22:43:39 +0300
Subject: [PATCH 058/163] maven(deps-dev): bump org.testcontainers:mysql from
 1.19.8 to 1.20.0 (#4696)

Bumps [org.testcontainers:mysql](https://github.com/testcontainers/testcontainers-java) from 1.19.8 to 1.20.0.
- [Release notes](https://github.com/testcontainers/testcontainers-java/releases)
- [Changelog](https://github.com/testcontainers/testcontainers-java/blob/main/CHANGELOG.md)
- [Commits](https://github.com/testcontainers/testcontainers-java/compare/1.19.8...1.20.0)

---
updated-dependencies:
- dependency-name: org.testcontainers:mysql
  dependency-type: direct:development
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index b232d7e7df89..3c7b650429ae 100644
--- a/pom.xml
+++ b/pom.xml
@@ -585,7 +585,7 @@
 			<dependency>
 				<groupId>org.testcontainers</groupId>
 				<artifactId>mysql</artifactId>
-				<version>1.19.8</version>
+				<version>1.20.0</version>
 				<scope>test</scope>
 			</dependency>
 			<dependency>

From 46557608da16ecdacf8fd040b9023768d4e48ca8 Mon Sep 17 00:00:00 2001
From: Yasindu Dissanayake <23ug1-0099@sltc.ac.lk>
Date: Thu, 18 Jul 2024 21:43:53 +0530
Subject: [PATCH 059/163] (chore) O3-3551: Use latest Actions in GH Actions
 (#4690)

---
 .github/workflows/scorecard.yml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/scorecard.yml b/.github/workflows/scorecard.yml
index d61d7aa8b491..7340047b43f4 100644
--- a/.github/workflows/scorecard.yml
+++ b/.github/workflows/scorecard.yml
@@ -27,12 +27,12 @@ jobs:
 
     steps:
       - name: "Checkout code"
-        uses: actions/checkout@v4.1.1
+        uses: actions/checkout@v4
         with:
           persist-credentials: false
 
       - name: "Run analysis"
-        uses: ossf/scorecard-action@v2.3.3
+        uses: ossf/scorecard-action@v2
         with:
           results_file: results.sarif
           results_format: sarif
@@ -50,6 +50,6 @@ jobs:
       # Upload the results to GitHub's code scanning dashboard (optional).
       # Commenting out will disable upload of results to your repo's Code Scanning dashboard
       - name: "Upload to code-scanning"
-        uses: github/codeql-action/upload-sarif@v3.24.9
+        uses: github/codeql-action/upload-sarif@v3
         with:
           sarif_file: results.sarif

From 255884274b0d3ef90c7af45de83f6dbbbb3d0e0a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 18 Jul 2024 21:49:06 +0300
Subject: [PATCH 060/163] maven(deps): bump org.apache.commons:commons-lang3
 from 3.14.0 to 3.15.0 (#4698)

Bumps org.apache.commons:commons-lang3 from 3.14.0 to 3.15.0.

---
updated-dependencies:
- dependency-name: org.apache.commons:commons-lang3
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 3c7b650429ae..aeb3c5288f11 100644
--- a/pom.xml
+++ b/pom.xml
@@ -177,7 +177,7 @@
 			<dependency>
 				<groupId>org.apache.commons</groupId>
 				<artifactId>commons-lang3</artifactId>
-				<version>3.14.0</version>
+				<version>3.15.0</version>
 			</dependency>
 			<dependency>
 				<groupId>org.springframework</groupId>

From f412f327571bea6ef32603cd7a837fb51e9edcde Mon Sep 17 00:00:00 2001
From: Yasindu Dissanayake <23ug1-0099@sltc.ac.lk>
Date: Fri, 19 Jul 2024 18:30:06 +0530
Subject: [PATCH 061/163] (chore) Revert ossf/scorecard-action version (#4697)

---
 .github/workflows/scorecard.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/scorecard.yml b/.github/workflows/scorecard.yml
index 7340047b43f4..dbab4d374d4c 100644
--- a/.github/workflows/scorecard.yml
+++ b/.github/workflows/scorecard.yml
@@ -32,7 +32,7 @@ jobs:
           persist-credentials: false
 
       - name: "Run analysis"
-        uses: ossf/scorecard-action@v2
+        uses: ossf/scorecard-action@v2.3.3
         with:
           results_file: results.sarif
           results_format: sarif

From 3ffb8971c8d93c20539f25d92b3625627cd01715 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 22 Jul 2024 23:19:33 +0300
Subject: [PATCH 062/163] maven(deps): bump
 org.apache.maven.plugins:maven-javadoc-plugin (#4699)

Bumps [org.apache.maven.plugins:maven-javadoc-plugin](https://github.com/apache/maven-javadoc-plugin) from 3.7.0 to 3.8.0.
- [Release notes](https://github.com/apache/maven-javadoc-plugin/releases)
- [Commits](https://github.com/apache/maven-javadoc-plugin/compare/maven-javadoc-plugin-3.7.0...maven-javadoc-plugin-3.8.0)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-javadoc-plugin
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pom.xml b/pom.xml
index aeb3c5288f11..4c7797d630ad 100644
--- a/pom.xml
+++ b/pom.xml
@@ -730,7 +730,7 @@
 				<plugin>
 					<groupId>org.apache.maven.plugins</groupId>
 					<artifactId>maven-javadoc-plugin</artifactId>
-					<version>3.7.0</version>
+					<version>3.8.0</version>
 					<configuration>
 						<!-- For some reason some packages from org.springframework are being
 						included and causing errors. -->
@@ -1147,7 +1147,7 @@
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-javadoc-plugin</artifactId>
-				<version>3.7.0</version>
+				<version>3.8.0</version>
 				<configuration>
 					<docfilessubdirs>true</docfilessubdirs>
 					<bottom>&lt;em&gt;&lt;small&gt; Generated ${TIMESTAMP} NOTE - these libraries are in active development and subject to change&lt;/small&gt;&lt;/em&gt;</bottom>

From 0181f2ec5c7419bdad3461882e488d448767b480 Mon Sep 17 00:00:00 2001
From: dkayiwa <dkayiwa@openmrs.org>
Date: Tue, 23 Jul 2024 16:29:16 +0300
Subject: [PATCH 063/163] TRUNK-6249 Add ability to get orders by visit

---
 .../api/db/hibernate/HibernateOrderDAO.java   |  3 ++
 .../parameter/OrderSearchCriteria.java        | 32 +++++++++++++++++--
 .../parameter/OrderSearchCriteriaBuilder.java | 14 +++++++-
 .../org/openmrs/api/OrderServiceTest.java     | 15 +++++++++
 .../openmrs/include/standardTestDataset.xml   | 22 ++++++-------
 5 files changed, 72 insertions(+), 14 deletions(-)

diff --git a/api/src/main/java/org/openmrs/api/db/hibernate/HibernateOrderDAO.java b/api/src/main/java/org/openmrs/api/db/hibernate/HibernateOrderDAO.java
index 7769381287db..d0e9c07ba759 100644
--- a/api/src/main/java/org/openmrs/api/db/hibernate/HibernateOrderDAO.java
+++ b/api/src/main/java/org/openmrs/api/db/hibernate/HibernateOrderDAO.java
@@ -190,6 +190,9 @@ public List<Order> getOrders(OrderSearchCriteria searchCriteria) {
 		if (searchCriteria.getAccessionNumber() != null) {
 			predicates.add(cb.equal(cb.lower(root.get("accessionNumber")), searchCriteria.getAccessionNumber().toLowerCase()));
 		}
+		if (searchCriteria.getVisit() != null && searchCriteria.getVisit().getVisitId() != null) {
+			predicates.add(cb.equal(root.get("encounter").get("visit"), searchCriteria.getVisit()));
+		}
 		if (searchCriteria.getActivatedOnOrBeforeDate() != null) {
 			// set the date's time to the last millisecond of the date
 			Calendar cal = Calendar.getInstance();
diff --git a/api/src/main/java/org/openmrs/parameter/OrderSearchCriteria.java b/api/src/main/java/org/openmrs/parameter/OrderSearchCriteria.java
index 97cd4660f7ca..67c90f70da0a 100644
--- a/api/src/main/java/org/openmrs/parameter/OrderSearchCriteria.java
+++ b/api/src/main/java/org/openmrs/parameter/OrderSearchCriteria.java
@@ -14,6 +14,7 @@
 import org.openmrs.Order;
 import org.openmrs.OrderType;
 import org.openmrs.Patient;
+import org.openmrs.Visit;
 
 import java.util.Collection;
 import java.util.Date;
@@ -35,6 +36,8 @@ public class OrderSearchCriteria {
 
 	private final Collection<OrderType> orderTypes;
 
+	private final Visit visit;
+	
 	/**
 	 * Accession Number to match on; performs an exact match, case-insensitive
 	 */
@@ -93,7 +96,7 @@ public class OrderSearchCriteria {
 	private final boolean excludeCanceledAndExpired;
 
 	private final boolean excludeDiscontinueOrders;
-
+	
 	/**
 	 * Instead of calling this constructor directly, it is recommended to use {@link OrderSearchCriteriaBuilder}.
 	 * @param patient the patient the order is for
@@ -106,6 +109,23 @@ public class OrderSearchCriteria {
 	 * @param activatedOnOrAfterDate orders must have dateActivated on or after this date
 	 * @param includeVoided whether to include the voided orders or not
 	 */
+	public OrderSearchCriteria(Patient patient, CareSetting careSetting, Collection<Concept> concepts,
+			   Collection<OrderType> orderTypes, String accessionNumber, String orderNumber,
+			   Date activatedOnOrBeforeDate, Date activatedOnOrAfterDate, boolean isStopped,
+			   Date autoExpireOnOrBeforeDate,
+			   Date canceledOrExpiredOnOrBeforeDate,
+			   Order.Action action,
+			   Order.FulfillerStatus fulfillerStatus,
+			   Boolean includeNullFulfillerStatus,
+			   boolean excludeCanceledAndExpired,
+			   boolean excludeDiscontinueOrders,
+			   boolean includeVoided) {
+		
+		this(patient, careSetting, concepts, orderTypes, null, null,
+				activatedOnOrBeforeDate, activatedOnOrAfterDate, isStopped, autoExpireOnOrBeforeDate, canceledOrExpiredOnOrBeforeDate,
+				action, fulfillerStatus, includeNullFulfillerStatus, excludeCanceledAndExpired, excludeDiscontinueOrders, includeVoided, null);
+	}
+
 	public OrderSearchCriteria(Patient patient, CareSetting careSetting, Collection<Concept> concepts,
 							   Collection<OrderType> orderTypes, String accessionNumber, String orderNumber,
 							   Date activatedOnOrBeforeDate, Date activatedOnOrAfterDate, boolean isStopped,
@@ -116,7 +136,8 @@ public OrderSearchCriteria(Patient patient, CareSetting careSetting, Collection<
 							   Boolean includeNullFulfillerStatus,
 							   boolean excludeCanceledAndExpired,
 							   boolean excludeDiscontinueOrders,
-							   boolean includeVoided) {
+							   boolean includeVoided,
+							   Visit visit) {
 		this.patient = patient;
 		this.careSetting = careSetting;
 		this.concepts = concepts;
@@ -134,6 +155,7 @@ public OrderSearchCriteria(Patient patient, CareSetting careSetting, Collection<
 		this.excludeCanceledAndExpired = excludeCanceledAndExpired;
 		this.excludeDiscontinueOrders = excludeDiscontinueOrders;
 		this.includeVoided = includeVoided;
+		this.visit = visit;
 	}
 
 	/**
@@ -185,6 +207,12 @@ public OrderSearchCriteria(Patient patient, CareSetting careSetting, Collection<
 	 */
 	public Collection<OrderType> getOrderTypes() { return orderTypes; }
 
+	/**
+	 * @return the visit the order is for
+	 * @since 2.7.0
+	 */
+	public Visit getVisit() { return visit; }
+	
 	/**
 	 * @return the accession number to match on; must be case-insensitive exact-match
 	 * @since 2.3.1
diff --git a/api/src/main/java/org/openmrs/parameter/OrderSearchCriteriaBuilder.java b/api/src/main/java/org/openmrs/parameter/OrderSearchCriteriaBuilder.java
index d4b05daa05f2..31b51f4dd51b 100644
--- a/api/src/main/java/org/openmrs/parameter/OrderSearchCriteriaBuilder.java
+++ b/api/src/main/java/org/openmrs/parameter/OrderSearchCriteriaBuilder.java
@@ -29,6 +29,8 @@ public class OrderSearchCriteriaBuilder {
 
 	private Collection<OrderType> orderTypes;
 	
+	private Visit visit;
+	
 	private String accessionNumber;
 	
 	private String orderNumber;
@@ -63,6 +65,16 @@ public OrderSearchCriteriaBuilder setPatient(Patient patient) {
 		this.patient = patient;
 		return (this);
 	}
+	
+	/**
+	 * @param visit the visit the order is for
+	 * @return this builder instance
+	 * @since 2.7.0
+	 */
+	public OrderSearchCriteriaBuilder setVisit(Visit visit) {
+		this.visit = visit;
+		return (this);
+	}
 
 	/**
 	 * @param careSetting the care setting to match on
@@ -213,7 +225,7 @@ public OrderSearchCriteriaBuilder setIncludeVoided(boolean includeVoided) {
 	public OrderSearchCriteria build() {
 		return new OrderSearchCriteria(patient, careSetting, concepts, orderTypes, accessionNumber, orderNumber, activatedOnOrBeforeDate,  
 			activatedOnOrAfterDate, isStopped, autoExpireOnOrBeforeDate, canceledOrExpiredOnOrBeforeDate,
-				action, fulfillerStatus, includeNullFulfillerStatus, excludeCanceledAndExpired, excludeDiscontinueOrders, includeVoided);
+				action, fulfillerStatus, includeNullFulfillerStatus, excludeCanceledAndExpired, excludeDiscontinueOrders, includeVoided, visit);
 	}
 }
 
diff --git a/api/src/test/java/org/openmrs/api/OrderServiceTest.java b/api/src/test/java/org/openmrs/api/OrderServiceTest.java
index cbb56999954a..d7b721be49c8 100644
--- a/api/src/test/java/org/openmrs/api/OrderServiceTest.java
+++ b/api/src/test/java/org/openmrs/api/OrderServiceTest.java
@@ -157,6 +157,9 @@ public class OrderServiceTest extends BaseContextSensitiveTest {
 	@Autowired
 	private MessageSourceService messageSourceService;
 	
+	@Autowired
+	private VisitService visitService;
+	
 	@BeforeEach
 	public void setUp(){
 		executeDataSet(ORDER_ATTRIBUTES);
@@ -2090,6 +2093,18 @@ public void getOrders_shouldGetOrdersByPatient() {
 		List<Order> orders = orderService.getOrders(orderSearchCriteria);
 		assertEquals(11, orders.size());
 	}
+	
+	/**
+	 * @see OrderService#(OrderSearchCriteria)
+	 */
+	@Test
+	public void getOrders_shouldGetOrdersByVisit() {
+		Visit visit = visitService.getVisit(6);
+		OrderSearchCriteria orderSearchCriteria = new OrderSearchCriteriaBuilder().setVisit(visit).build();
+		List<Order> orders = orderService.getOrders(orderSearchCriteria);
+		assertEquals(11, orders.size());
+	}
+
 
 	/**
 	 * @see OrderService#(OrderSearchCriteria)
diff --git a/api/src/test/resources/org/openmrs/include/standardTestDataset.xml b/api/src/test/resources/org/openmrs/include/standardTestDataset.xml
index c7f58371d138..ed9317681904 100644
--- a/api/src/test/resources/org/openmrs/include/standardTestDataset.xml
+++ b/api/src/test/resources/org/openmrs/include/standardTestDataset.xml
@@ -322,13 +322,23 @@
   <encounter_type encounter_type_id="2" name="Emergency" description="Emergency visit" creator="1" date_created="2005-02-24 00:00:00.0" retired="false" uuid="07000be2-26b6-4cce-8b40-866d8435b613"/>
   <encounter_type encounter_type_id="6" name="Laboratory" description="Visit to the laboratory" creator="1" date_created="2008-08-15 15:39:55.0" retired="true" retired_by="1" date_retired="2008-08-15 00:00:00.0" retire_reason="for testing" uuid="02c533ab-b74b-4ee4-b6e5-ffb6d09a0ac8"/>
   <provider provider_id="1" person_id="1" identifier="Test" creator="1" date_created="2005-01-01 00:00:00.0" retired="false" uuid="c2299800-cca9-11e0-9572-0800200c9a66" />
+  <visit_type visit_type_id="1" name="Initial HIV Clinic Visit" description="Initial HIV Clinic Visit Description" creator="1" date_created="2005-01-01 00:00:00.0" retired="false" uuid="c0c579b0-8e59-401d-8a4a-976a0b183519"/>
+  <visit_type visit_type_id="2" name="Return TB Clinic Visit" description="Return TB Clinic Visit Description" creator="1" date_created="2005-01-01 00:00:00.0" retired="false" uuid="759799ab-c9a5-435e-b671-77773ada74e4"/>
+  <visit_type visit_type_id="3" name="Hospitalization" description="Hospitalization Description" creator="1" date_created="2005-01-01 00:00:00.0" retired="true" retire_reason="Some Retire Reason" uuid="759799ab-c9a5-435e-b671-77773ada74e6"/> 
+  <visit visit_id="1" patient_id="2" visit_type_id="1" date_started="2005-01-01 00:00:00.0" location_id="1" indication_concept_id="5497" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="1e5d5d48-6b78-11e0-93c3-18a905e044dc" />
+  <visit visit_id="2" patient_id="2" visit_type_id="1" date_started="2005-01-02 00:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="4e663d66-6b78-11e0-93c3-18a905e044dc" />
+  <visit visit_id="3" patient_id="2" visit_type_id="2" date_started="2005-01-03 00:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="6f85b2a6-6b78-11e0-93c3-18a905e044dc" />
+  <visit visit_id="4" patient_id="6" visit_type_id="1" date_started="2005-01-01 00:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="7d8c1980-6b78-11e0-93c3-18a905e044dc" />
+  <visit visit_id="5" patient_id="6" visit_type_id="1" date_started="2005-01-01 00:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="8cfda6ae-6b78-11e0-93c3-18a905e044dc" />
+  <visit visit_id="6" patient_id="2" visit_type_id="1" date_started="2005-01-01 00:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="1" voided_by="1" date_voided="2005-01-01 00:00:00.0" void_reason="no reason" uuid="e1428fea-6b78-11e0-93c3-18a905e044dc" />
+  <visit_attribute_type visit_attribute_type_id="1" name="Audit Date" datatype="org.openmrs.customdatatype.datatype.DateDatatype" min_occurs="0" max_occurs="1" creator="1" date_created="2005-01-01 00:00:00.0" retired="0" uuid="8770f6d6-7673-11e0-8f03-001e378eb67e" />
   <encounter encounter_id="3" encounter_type="2" patient_id="7" location_id="1" form_id="1" encounter_datetime="2008-08-01 00:00:00.0" creator="1" date_created="2008-08-18 14:09:05.0" voided="false" uuid="6519d653-393b-4118-9c83-a3715b82d4ac"/>
   <encounter_provider encounter_provider_id="1" encounter_id="3" provider_id="1" encounter_role_id="1" creator="1" date_created="2006-03-11 15:57:35.0" voided="false" uuid="19e0aae8-20ee-46b7-ade6-9e68f897b7a9" />
   <encounter encounter_id="4" encounter_type="1" patient_id="7" location_id="1" form_id="1" encounter_datetime="2008-08-15 00:00:00.0" creator="1" date_created="2008-08-18 14:22:17.0" voided="false" uuid="eec646cb-c847-45a7-98bc-91c8c4f70add"/>
   <encounter_provider encounter_provider_id="2" encounter_id="4" provider_id="1" encounter_role_id="1" creator="1" date_created="2006-03-11 15:57:35.0" voided="false" uuid="1609ac3f-090c-4b1c-a497-4c307e24c5dd" />
   <encounter encounter_id="5" encounter_type="1" patient_id="7" location_id="2" form_id="1" encounter_datetime="2008-08-19 00:00:00.0" creator="1" date_created="2008-08-19 12:34:40.0" voided="false" uuid="e403fafb-e5e4-42d0-9d11-4f52e89d148c"/>
   <encounter_provider encounter_provider_id="3" encounter_id="5" provider_id="1" encounter_role_id="1" creator="1" date_created="2006-03-11 15:57:35.0" voided="false" uuid="2417c6c5-77a4-41b0-b7eb-564e163e55e4" />
-  <encounter encounter_id="6" encounter_type="1" patient_id="2" location_id="2" form_id="1" encounter_datetime="2008-08-19 00:00:00.1" creator="1" date_created="2008-08-19 12:34:40.0" voided="false" uuid="y403fafb-e5e4-42d0-9d11-4f52e89d123r"/>
+  <encounter encounter_id="6" encounter_type="1" patient_id="2" location_id="2" form_id="1" visit_id="6" encounter_datetime="2008-08-19 00:00:00.1" creator="1" date_created="2008-08-19 12:34:40.0" voided="false" uuid="y403fafb-e5e4-42d0-9d11-4f52e89d123r"/>
   <encounter_provider encounter_provider_id="4" encounter_id="6" provider_id="1" encounter_role_id="1" creator="1" date_created="2008-08-19 00:00:00.0" voided="false" uuid="4527c6c5-77a4-41b0-b7eb-564e163e55e5" />
   <concept_proposal concept_proposal_id="1" original_text="I want this concept but I can't have it" state="REJECT" encounter_id="3" obs_concept_id="4" creator="1" date_created="2009-06-03 13:55:12.0" uuid="57a68666-5067-11de-80cb-001e378eb67e"/>
   <concept_proposal concept_proposal_id="2" original_text="unmapped concept proposal" state="UNMAPPED" encounter_id="3" creator="1" date_created="2010-12-21 08:41:10.0" uuid="af4ae460-0e2b-11e0-a94b-469c3c5a0c2f"/>
@@ -436,14 +446,4 @@
   <test_order order_id="7" number_of_repeats="2" />
   <test_order order_id="8" />
   <test_order order_id="9" />
-  <visit_type visit_type_id="1" name="Initial HIV Clinic Visit" description="Initial HIV Clinic Visit Description" creator="1" date_created="2005-01-01 00:00:00.0" retired="false" uuid="c0c579b0-8e59-401d-8a4a-976a0b183519"/>
-  <visit_type visit_type_id="2" name="Return TB Clinic Visit" description="Return TB Clinic Visit Description" creator="1" date_created="2005-01-01 00:00:00.0" retired="false" uuid="759799ab-c9a5-435e-b671-77773ada74e4"/>
-  <visit_type visit_type_id="3" name="Hospitalization" description="Hospitalization Description" creator="1" date_created="2005-01-01 00:00:00.0" retired="true" retire_reason="Some Retire Reason" uuid="759799ab-c9a5-435e-b671-77773ada74e6"/> 
-  <visit visit_id="1" patient_id="2" visit_type_id="1" date_started="2005-01-01 00:00:00.0" location_id="1" indication_concept_id="5497" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="1e5d5d48-6b78-11e0-93c3-18a905e044dc" />
-  <visit visit_id="2" patient_id="2" visit_type_id="1" date_started="2005-01-02 00:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="4e663d66-6b78-11e0-93c3-18a905e044dc" />
-  <visit visit_id="3" patient_id="2" visit_type_id="2" date_started="2005-01-03 00:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="6f85b2a6-6b78-11e0-93c3-18a905e044dc" />
-  <visit visit_id="4" patient_id="6" visit_type_id="1" date_started="2005-01-01 00:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="7d8c1980-6b78-11e0-93c3-18a905e044dc" />
-  <visit visit_id="5" patient_id="6" visit_type_id="1" date_started="2005-01-01 00:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="8cfda6ae-6b78-11e0-93c3-18a905e044dc" />
-  <visit visit_id="6" patient_id="2" visit_type_id="1" date_started="2005-01-01 00:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="1" voided_by="1" date_voided="2005-01-01 00:00:00.0" void_reason="no reason" uuid="e1428fea-6b78-11e0-93c3-18a905e044dc" />
-  <visit_attribute_type visit_attribute_type_id="1" name="Audit Date" datatype="org.openmrs.customdatatype.datatype.DateDatatype" min_occurs="0" max_occurs="1" creator="1" date_created="2005-01-01 00:00:00.0" retired="0" uuid="8770f6d6-7673-11e0-8f03-001e378eb67e" />
 </dataset>

From b66c022b2424b9e13519ac80d4aa3b7f05b07857 Mon Sep 17 00:00:00 2001
From: dkayiwa <dkayiwa@openmrs.org>
Date: Tue, 23 Jul 2024 23:54:45 +0300
Subject: [PATCH 064/163] TRUNK-6250 Add ability to get observations by visit

---
 .../main/java/org/openmrs/api/ObsService.java | 25 ++++++++++++
 .../main/java/org/openmrs/api/db/ObsDAO.java  | 23 +++++++++++
 .../api/db/hibernate/HibernateObsDAO.java     | 38 +++++++++++++++++--
 .../org/openmrs/api/impl/ObsServiceImpl.java  | 36 +++++++++++++++++-
 .../java/org/openmrs/api/ObsServiceTest.java  | 29 ++++++++++++++
 .../org/openmrs/api/PatientServiceTest.java   |  2 +
 .../org/openmrs/api/VisitServiceTest.java     |  9 +++--
 .../openmrs/include/standardTestDataset.xml   |  3 +-
 8 files changed, 155 insertions(+), 10 deletions(-)

diff --git a/api/src/main/java/org/openmrs/api/ObsService.java b/api/src/main/java/org/openmrs/api/ObsService.java
index 4c8ac7783676..6675515e4177 100644
--- a/api/src/main/java/org/openmrs/api/ObsService.java
+++ b/api/src/main/java/org/openmrs/api/ObsService.java
@@ -19,6 +19,7 @@
 import org.openmrs.Location;
 import org.openmrs.Obs;
 import org.openmrs.Person;
+import org.openmrs.Visit;
 import org.openmrs.annotation.Authorized;
 import org.openmrs.api.db.ObsDAO;
 import org.openmrs.obs.ComplexObsHandler;
@@ -497,5 +498,29 @@ public Integer getObservationCount(List<Person> whom, List<Encounter> encounters
 	 */
 	@Authorized(PrivilegeConstants.GET_OBS)
 	public Integer getObservationCount(List<ConceptName> conceptNames, boolean includeVoided);
+
+	/**
+	 * @see org.openmrs.api.ObsService#getObservations(java.util.List, java.util.List,
+	 *      java.util.List, java.util.List, List, List, java.util.List, java.util.List, java.lang.Integer,
+	 *      java.lang.Integer, java.util.Date, java.util.Date, boolean, java.lang.String)
+	 *      
+	 * @since 2.7.0
+	 */
+	public List<Obs> getObservations(List<Person> whom, List<Encounter> encounters, List<Concept> questions,
+			List<Concept> answers, List<PERSON_TYPE> personTypes, List<Location> locations, List<String> sort,
+			List<Visit> visits, Integer mostRecentN, Integer obsGroupId, Date fromDate, Date toDate,
+			boolean includeVoidedObs, String accessionNumber) throws APIException;
+
+	/**
+	 * @see org.openmrs.api.ObsService#getObservationCount(java.util.List, java.util.List,
+	 *      java.util.List, java.util.List, java.util.List, java.util.List, java.util.List, java.lang.Integer,
+	 *      java.util.Date, java.util.Date, boolean, java.lang.String)
+	 *      
+	 * @since 2.7.0
+	 */
+	public Integer getObservationCount(List<Person> whom, List<Encounter> encounters, List<Concept> questions,
+			List<Concept> answers, List<PERSON_TYPE> personTypes, List<Location> locations, List<Visit> visits,
+			Integer obsGroupId, Date fromDate, Date toDate, boolean includeVoidedObs, String accessionNumber)
+			throws APIException;
 	
 }
diff --git a/api/src/main/java/org/openmrs/api/db/ObsDAO.java b/api/src/main/java/org/openmrs/api/db/ObsDAO.java
index 9c58a2db445b..9ed65cf25c7d 100644
--- a/api/src/main/java/org/openmrs/api/db/ObsDAO.java
+++ b/api/src/main/java/org/openmrs/api/db/ObsDAO.java
@@ -18,6 +18,7 @@
 import org.openmrs.Location;
 import org.openmrs.Obs;
 import org.openmrs.Person;
+import org.openmrs.Visit;
 import org.openmrs.api.ObsService;
 import org.openmrs.util.OpenmrsConstants.PERSON_TYPE;
 
@@ -86,5 +87,27 @@ public Long getObservationCount(List<Person> whom, List<Encounter> encounters, L
 	 * @since 2.1.0
 	 */
 	public Obs.Status getSavedStatus(Obs obs);
+
+	/**
+	 * @see org.openmrs.api.ObsService#getObservations(java.util.List, java.util.List,
+	 *      java.util.List, java.util.List, java.util.List, java.util.List, java.util.List, java.util.List,
+	 *      java.lang.Integer, java.lang.Integer, java.util.Date, java.util.Date, boolean,
+	 *      java.lang.String)
+	 */
+	public List<Obs> getObservations(List<Person> whom, List<Encounter> encounters, List<Concept> questions,
+			List<Concept> answers, List<PERSON_TYPE> personTypes, List<Location> locations, List<String> sortList,
+			List<Visit> visits, Integer mostRecentN, Integer obsGroupId, Date fromDate, Date toDate,
+			boolean includeVoidedObs, String accessionNumber) throws DAOException;
+
+	/**
+	 * @see org.openmrs.api.ObsService#getObservationCount(java.util.List, java.util.List,
+	 *      java.util.List, java.util.List, java.util.List, java.util.List, java.lang.Integer,
+	 *      java.util.Date, java.util.Date, java.util.List, java.util.List, boolean, java.lang.String)
+	 * @see ObsService#getObservationCount(List, boolean)
+	 */
+	public Long getObservationCount(List<Person> whom, List<Encounter> encounters, List<Concept> questions,
+			List<Concept> answers, List<PERSON_TYPE> personTypes, List<Location> locations, Integer obsGroupId,
+			Date fromDate, Date toDate, List<ConceptName> valueCodedNameAnswers, List<Visit> visits,
+			boolean includeVoidedObs, String accessionNumber) throws DAOException;
 	
 }
diff --git a/api/src/main/java/org/openmrs/api/db/hibernate/HibernateObsDAO.java b/api/src/main/java/org/openmrs/api/db/hibernate/HibernateObsDAO.java
index d62719b3677d..5dd542490776 100644
--- a/api/src/main/java/org/openmrs/api/db/hibernate/HibernateObsDAO.java
+++ b/api/src/main/java/org/openmrs/api/db/hibernate/HibernateObsDAO.java
@@ -35,6 +35,7 @@
 import org.openmrs.Patient;
 import org.openmrs.Person;
 import org.openmrs.User;
+import org.openmrs.Visit;
 import org.openmrs.api.db.DAOException;
 import org.openmrs.api.db.ObsDAO;
 import org.openmrs.util.OpenmrsConstants.PERSON_TYPE;
@@ -105,13 +106,27 @@ public List<Obs> getObservations(List<Person> whom, List<Encounter> encounters,
 	        List<Concept> answers, List<PERSON_TYPE> personTypes, List<Location> locations, List<String> sortList,
 	        Integer mostRecentN, Integer obsGroupId, Date fromDate, Date toDate, boolean includeVoidedObs,
 	        String accessionNumber) throws DAOException {
+		
+		return this.getObservations(whom, encounters, questions, answers, personTypes, locations, sortList, null, mostRecentN, obsGroupId, 
+				fromDate, toDate, includeVoidedObs, accessionNumber);
+	}
+	
+	/**
+	 * @see org.openmrs.api.db.ObsDAO#getObservations(List, List, List, List, List, List, List, List,
+	 *      Integer, Integer, Date, Date, boolean, String)
+	 */
+	@Override
+	public List<Obs> getObservations(List<Person> whom, List<Encounter> encounters, List<Concept> questions,
+	        List<Concept> answers, List<PERSON_TYPE> personTypes, List<Location> locations, List<String> sortList, List<Visit> visits,
+	        Integer mostRecentN, Integer obsGroupId, Date fromDate, Date toDate, boolean includeVoidedObs,
+	        String accessionNumber) throws DAOException {
 		Session session = sessionFactory.getCurrentSession();
 		CriteriaBuilder cb = session.getCriteriaBuilder();
 		CriteriaQuery<Obs> cq = cb.createQuery(Obs.class);
 		Root<Obs> root = cq.from(Obs.class);
 
 		List<Predicate> predicates = createGetObservationsCriteria(cb, root, whom, encounters, questions, answers, personTypes, locations,
-			obsGroupId, fromDate, toDate, null, includeVoidedObs, accessionNumber);
+			obsGroupId, fromDate, toDate, null, visits, includeVoidedObs, accessionNumber);
 
 		cq.where(predicates.toArray(new Predicate[]{}));
 
@@ -134,6 +149,19 @@ public Long getObservationCount(List<Person> whom, List<Encounter> encounters, L
 	        List<Concept> answers, List<PERSON_TYPE> personTypes, List<Location> locations, Integer obsGroupId,
 	        Date fromDate, Date toDate, List<ConceptName> valueCodedNameAnswers, boolean includeVoidedObs,
 	        String accessionNumber) throws DAOException {
+		
+		return this.getObservationCount(whom, encounters, questions, answers, personTypes, locations, obsGroupId, 
+				fromDate, toDate, valueCodedNameAnswers, null, includeVoidedObs, accessionNumber);
+	}
+	
+	/**
+	 * @see org.openmrs.api.db.ObsDAO#getObservationCount(List, List, List, List, List, List, Integer, Date, Date, List, List, boolean, String)
+	 */
+	@Override
+	public Long getObservationCount(List<Person> whom, List<Encounter> encounters, List<Concept> questions,
+	        List<Concept> answers, List<PERSON_TYPE> personTypes, List<Location> locations, Integer obsGroupId,
+	        Date fromDate, Date toDate, List<ConceptName> valueCodedNameAnswers, List<Visit> visits, boolean includeVoidedObs,
+	        String accessionNumber) throws DAOException {
 		Session session = sessionFactory.getCurrentSession();
 		CriteriaBuilder cb = session.getCriteriaBuilder();
 		CriteriaQuery<Long> criteriaQuery = cb.createQuery(Long.class);
@@ -143,7 +171,7 @@ public Long getObservationCount(List<Person> whom, List<Encounter> encounters, L
 
 		List<Predicate> predicates = createGetObservationsCriteria(cb, root, whom, encounters, questions, answers,
 			personTypes, locations, obsGroupId, fromDate, toDate,
-			valueCodedNameAnswers, includeVoidedObs, accessionNumber);
+			valueCodedNameAnswers, visits, includeVoidedObs, accessionNumber);
 
 		criteriaQuery.where(predicates.toArray(new Predicate[]{}));
 
@@ -170,7 +198,7 @@ public Long getObservationCount(List<Person> whom, List<Encounter> encounters, L
 	 */
 	private List<Predicate> createGetObservationsCriteria(CriteriaBuilder cb, Root<Obs> root, List<Person> whom, List<Encounter> encounters, List<Concept> questions,
 	        List<Concept> answers, List<PERSON_TYPE> personTypes, List<Location> locations, Integer obsGroupId, Date fromDate, Date toDate, List<ConceptName> valueCodedNameAnswers,
-	        boolean includeVoidedObs, String accessionNumber) {
+	        List<Visit> visits, boolean includeVoidedObs, String accessionNumber) {
 		
 		List<Predicate> predicates = new ArrayList<>();
 
@@ -197,6 +225,10 @@ private List<Predicate> createGetObservationsCriteria(CriteriaBuilder cb, Root<O
 		if (CollectionUtils.isNotEmpty(locations)) {
 			predicates.add(root.get("location").in(locations));
 		}
+		
+		if (CollectionUtils.isNotEmpty(visits)) {
+			predicates.add(root.get("encounter").get("visit").in(visits));
+		}
 
 		if (obsGroupId != null) {
 			predicates.add(cb.equal(root.get("obsGroup").get("obsId"), obsGroupId));
diff --git a/api/src/main/java/org/openmrs/api/impl/ObsServiceImpl.java b/api/src/main/java/org/openmrs/api/impl/ObsServiceImpl.java
index 834d3889a47e..57d6b28e64fa 100644
--- a/api/src/main/java/org/openmrs/api/impl/ObsServiceImpl.java
+++ b/api/src/main/java/org/openmrs/api/impl/ObsServiceImpl.java
@@ -23,6 +23,7 @@
 import org.openmrs.Obs;
 import org.openmrs.Patient;
 import org.openmrs.Person;
+import org.openmrs.Visit;
 import org.openmrs.aop.RequiredDataAdvice;
 import org.openmrs.api.APIException;
 import org.openmrs.api.EncounterService;
@@ -361,6 +362,22 @@ public List<Obs> getObservations(List<Person> whom, List<Encounter> encounters,
 	                                 List<String> sort, Integer mostRecentN, Integer obsGroupId, Date fromDate, Date toDate,
 	                                 boolean includeVoidedObs, String accessionNumber) throws APIException {
 		
+		return this.getObservations(whom, encounters, questions, answers, personTypes, locations, sort, null,
+				mostRecentN, obsGroupId, fromDate, toDate, includeVoidedObs, accessionNumber);
+	}
+	
+	/**
+	 * @see org.openmrs.api.ObsService#getObservations(java.util.List, java.util.List,
+	 *      java.util.List, java.util.List, List, List, java.util.List, java.util.List, java.lang.Integer,
+	 *      java.lang.Integer, java.util.Date, java.util.Date, boolean, java.lang.String)
+	 */
+	@Override
+	@Transactional(readOnly = true)
+	public List<Obs> getObservations(List<Person> whom, List<Encounter> encounters, List<Concept> questions,
+	                                 List<Concept> answers, List<PERSON_TYPE> personTypes, List<Location> locations,
+	                                 List<String> sort, List<Visit> visits, Integer mostRecentN, Integer obsGroupId, Date fromDate, Date toDate,
+	                                 boolean includeVoidedObs, String accessionNumber) throws APIException {
+		
 		if (sort == null) {
 			sort = new ArrayList<>();
 		}
@@ -368,7 +385,7 @@ public List<Obs> getObservations(List<Person> whom, List<Encounter> encounters,
 			sort.add("obsDatetime");
 		}
 		
-		return dao.getObservations(whom, encounters, questions, answers, personTypes, locations, sort, mostRecentN,
+		return dao.getObservations(whom, encounters, questions, answers, personTypes, locations, sort, visits, mostRecentN,
 		    obsGroupId, fromDate, toDate, includeVoidedObs, accessionNumber);
 	}
 	
@@ -398,8 +415,23 @@ public Integer getObservationCount(List<Person> whom, List<Encounter> encounters
 	                                   List<Concept> answers, List<PERSON_TYPE> personTypes, List<Location> locations,
 	                                   Integer obsGroupId, Date fromDate, Date toDate, boolean includeVoidedObs,
 	                                   String accessionNumber) throws APIException {
+		return this.getObservationCount(whom, encounters, questions, answers, personTypes, locations, null, obsGroupId,
+				fromDate, toDate, includeVoidedObs, accessionNumber);
+	}
+	
+	/**
+	 * @see org.openmrs.api.ObsService#getObservationCount(java.util.List, java.util.List,
+	 *      java.util.List, java.util.List, java.util.List, java.util.List, java.util.List, java.lang.Integer,
+	 *      java.util.Date, java.util.Date, boolean, java.lang.String)
+	 */
+	@Override
+	@Transactional(readOnly = true)
+	public Integer getObservationCount(List<Person> whom, List<Encounter> encounters, List<Concept> questions,
+	                                   List<Concept> answers, List<PERSON_TYPE> personTypes, List<Location> locations, List<Visit> visits,
+	                                   Integer obsGroupId, Date fromDate, Date toDate, boolean includeVoidedObs,
+	                                   String accessionNumber) throws APIException {
 		return OpenmrsUtil.convertToInteger(dao.getObservationCount(whom, encounters, questions, answers, personTypes,
-		    locations, obsGroupId, fromDate, toDate, null, includeVoidedObs, accessionNumber));
+		    locations, obsGroupId, fromDate, toDate, null, visits, includeVoidedObs, accessionNumber));
 	}
 	
 	/**
diff --git a/api/src/test/java/org/openmrs/api/ObsServiceTest.java b/api/src/test/java/org/openmrs/api/ObsServiceTest.java
index efa5eda86be9..cf4b09ff6e8b 100644
--- a/api/src/test/java/org/openmrs/api/ObsServiceTest.java
+++ b/api/src/test/java/org/openmrs/api/ObsServiceTest.java
@@ -51,6 +51,7 @@
 import org.openmrs.Order;
 import org.openmrs.Patient;
 import org.openmrs.Person;
+import org.openmrs.Visit;
 import org.openmrs.api.context.Context;
 import org.openmrs.api.impl.ObsServiceImpl;
 import org.openmrs.obs.ComplexData;
@@ -840,6 +841,34 @@ public void getObservationCount_shouldGetCountOfObsAssignedToGivenEncounters() {
 		assertEquals(6, count.intValue());
 	}
 	
+	/**
+	 * @see ObsService#getObservations(List,List,List,List,List,List,List,Integer,Integer,Date,Date,boolean)
+	 * @see ObsService#getObservations(List,List,List,List,List,List,List,List,Integer,Integer,Date,Date,boolean,String)
+	 */
+	@Test
+	public void getObservations_shouldGetAllObsInGivenVisits() {
+		ObsService obsService = Context.getObsService();
+		
+		List<Obs> obss = obsService.getObservations(null, null, null, null, null,
+		    null, null, Collections.singletonList(new Visit(8)), null, null, null, null, false, null);
+		
+		assertEquals(2, obss.size());
+	}
+	
+	/**
+	 * @see ObsService#getObservationCount(List,List,List,List,List,List,Integer,Date,Date,boolean)
+	 * @see ObsService#getObservationCount(List,List,List,List,List,List,List,Integer,Date,Date,boolean,String)
+	 */
+	@Test
+	public void getObservationCount_shouldGetCountOfObsInGivenVisits() {
+		ObsService obsService = Context.getObsService();
+		
+		Integer count = obsService.getObservationCount(null, null, null, null, null,
+		    null, Collections.singletonList(new Visit(8)), null, null, null, false, null);
+		
+		assertEquals(2, count.intValue());
+	}
+	
 	/**
 	 * @see ObsService#getObservations(List,List,List,List,List,List,List,Integer,Integer,Date,Date,boolean)
 	 * @see ObsService#getObservations(List,List,List,List,List,List,List,Integer,Integer,Date,Date,boolean,String)
diff --git a/api/src/test/java/org/openmrs/api/PatientServiceTest.java b/api/src/test/java/org/openmrs/api/PatientServiceTest.java
index f0b352892568..ced6ec5e5e26 100644
--- a/api/src/test/java/org/openmrs/api/PatientServiceTest.java
+++ b/api/src/test/java/org/openmrs/api/PatientServiceTest.java
@@ -2515,6 +2515,7 @@ public void mergePatients_shouldAuditPriorDateOfBirth() throws Exception {
 		cDate.setTime(new Date());
 		//milliseconds are not serialized into the database. they will be ignored in the test
 		cDate.set(Calendar.MILLISECOND, 0);
+		cDate.set(Calendar.YEAR, 2000);
 		Patient preferred = patientService.getPatient(999);
 		preferred.setBirthdate(cDate.getTime());
 		preferred.addName(new PersonName("givenName", "middleName", "familyName"));
@@ -2533,6 +2534,7 @@ public void mergePatients_shouldAuditPriorDateOfBirthEstimated() throws Exceptio
 		//retrieve preferred patient and set a date of birth
 		GregorianCalendar cDate = new GregorianCalendar();
 		cDate.setTime(new Date());
+		cDate.set(Calendar.YEAR, 2000);
 		Patient preferred = patientService.getPatient(999);
 		preferred.setBirthdate(cDate.getTime());
 		preferred.setBirthdateEstimated(true);
diff --git a/api/src/test/java/org/openmrs/api/VisitServiceTest.java b/api/src/test/java/org/openmrs/api/VisitServiceTest.java
index 65514ce74cba..ca2e119bd31b 100644
--- a/api/src/test/java/org/openmrs/api/VisitServiceTest.java
+++ b/api/src/test/java/org/openmrs/api/VisitServiceTest.java
@@ -221,7 +221,7 @@ public void purgeVisitType_shouldDeleteGivenVisitType() {
 	 */
 	@Test
 	public void getAllVisits_shouldReturnAllUnvoidedVisits() {
-		assertEquals(5, visitService.getAllVisits().size());
+		assertEquals(6, visitService.getAllVisits().size());
 	}
 	
 	/**
@@ -488,7 +488,7 @@ public void getVisits_shouldGetVisitsByLocations() {
 	public void getVisits_shouldGetVisitsByVisitType() {
 		List<VisitType> visitTypes = new ArrayList<>();
 		visitTypes.add(new VisitType(1));
-		assertEquals(4, visitService.getVisits(visitTypes, null, null, null, null, null, null, null, null,
+		assertEquals(5, visitService.getVisits(visitTypes, null, null, null, null, null, null, null, null,
 		    true, false).size());
 	}
 	
@@ -518,12 +518,13 @@ public void getVisits_shouldGetVisitsThatAreStillOpenEvenIfMinStartDatetimeIsSpe
 		// this should get all open non-voided visits (which are ids 1, 2, 3, 4, 5 in standardTestDataset)
 		List<Visit> visits = visitService.getVisits(null, null, null, null, null, null, minEndDatetime, null,
 		    null, true, false);
-		assertEquals(5, visits.size());
+		assertEquals(6, visits.size());
 		assertTrue(TestUtil.containsId(visits, 1));
 		assertTrue(TestUtil.containsId(visits, 2));
 		assertTrue(TestUtil.containsId(visits, 3));
 		assertTrue(TestUtil.containsId(visits, 4));
 		assertTrue(TestUtil.containsId(visits, 5));
+		assertTrue(TestUtil.containsId(visits, 8));
 	}
 	
 	@Test
@@ -542,7 +543,7 @@ public void getVisits_shouldGetVisitsStartedBetweenTheGivenStartDates() {
 	
 	@Test
 	public void getVisits_shouldReturnAllVisitsIfIncludeVoidedIsSetToTrue() {
-		assertEquals(6, getNumberOfAllVisitsIncludingVoided());
+		assertEquals(7, getNumberOfAllVisitsIncludingVoided());
 	}
 	
 	@Test
diff --git a/api/src/test/resources/org/openmrs/include/standardTestDataset.xml b/api/src/test/resources/org/openmrs/include/standardTestDataset.xml
index ed9317681904..b6b7827e21e4 100644
--- a/api/src/test/resources/org/openmrs/include/standardTestDataset.xml
+++ b/api/src/test/resources/org/openmrs/include/standardTestDataset.xml
@@ -331,8 +331,9 @@
   <visit visit_id="4" patient_id="6" visit_type_id="1" date_started="2005-01-01 00:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="7d8c1980-6b78-11e0-93c3-18a905e044dc" />
   <visit visit_id="5" patient_id="6" visit_type_id="1" date_started="2005-01-01 00:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="8cfda6ae-6b78-11e0-93c3-18a905e044dc" />
   <visit visit_id="6" patient_id="2" visit_type_id="1" date_started="2005-01-01 00:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="1" voided_by="1" date_voided="2005-01-01 00:00:00.0" void_reason="no reason" uuid="e1428fea-6b78-11e0-93c3-18a905e044dc" />
+  <visit visit_id="8" patient_id="7" visit_type_id="1" date_started="2006-01-01 00:00:00.0" creator="1" date_created="2006-01-01 00:00:00.0" voided="0" uuid="a2428fea-6b78-11e0-93c3-18a905e044dc" />
   <visit_attribute_type visit_attribute_type_id="1" name="Audit Date" datatype="org.openmrs.customdatatype.datatype.DateDatatype" min_occurs="0" max_occurs="1" creator="1" date_created="2005-01-01 00:00:00.0" retired="0" uuid="8770f6d6-7673-11e0-8f03-001e378eb67e" />
-  <encounter encounter_id="3" encounter_type="2" patient_id="7" location_id="1" form_id="1" encounter_datetime="2008-08-01 00:00:00.0" creator="1" date_created="2008-08-18 14:09:05.0" voided="false" uuid="6519d653-393b-4118-9c83-a3715b82d4ac"/>
+  <encounter encounter_id="3" encounter_type="2" patient_id="7" location_id="1" form_id="1" visit_id="8" encounter_datetime="2008-08-01 00:00:00.0" creator="1" date_created="2008-08-18 14:09:05.0" voided="false" uuid="6519d653-393b-4118-9c83-a3715b82d4ac"/>
   <encounter_provider encounter_provider_id="1" encounter_id="3" provider_id="1" encounter_role_id="1" creator="1" date_created="2006-03-11 15:57:35.0" voided="false" uuid="19e0aae8-20ee-46b7-ade6-9e68f897b7a9" />
   <encounter encounter_id="4" encounter_type="1" patient_id="7" location_id="1" form_id="1" encounter_datetime="2008-08-15 00:00:00.0" creator="1" date_created="2008-08-18 14:22:17.0" voided="false" uuid="eec646cb-c847-45a7-98bc-91c8c4f70add"/>
   <encounter_provider encounter_provider_id="2" encounter_id="4" provider_id="1" encounter_role_id="1" creator="1" date_created="2006-03-11 15:57:35.0" voided="false" uuid="1609ac3f-090c-4b1c-a497-4c307e24c5dd" />

From 7ad3eb6336044f0137309c81513fe7a602cc6736 Mon Sep 17 00:00:00 2001
From: dkayiwa <dkayiwa@openmrs.org>
Date: Wed, 24 Jul 2024 00:16:36 +0300
Subject: [PATCH 065/163] TRUNK-6250 get observations by visit privilege and
 documentation fix

---
 .../main/java/org/openmrs/api/ObsService.java  | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/api/src/main/java/org/openmrs/api/ObsService.java b/api/src/main/java/org/openmrs/api/ObsService.java
index 6675515e4177..dc2970ae53a2 100644
--- a/api/src/main/java/org/openmrs/api/ObsService.java
+++ b/api/src/main/java/org/openmrs/api/ObsService.java
@@ -501,11 +501,18 @@ public Integer getObservationCount(List<Person> whom, List<Encounter> encounters
 
 	/**
 	 * @see org.openmrs.api.ObsService#getObservations(java.util.List, java.util.List,
-	 *      java.util.List, java.util.List, List, List, java.util.List, java.util.List, java.lang.Integer,
+	 *      java.util.List, java.util.List, List, List, java.util.List, java.lang.Integer,
 	 *      java.lang.Integer, java.util.Date, java.util.Date, boolean, java.lang.String)
 	 *      
+	 * This method works exactly the same; it only adds visits to the search criteria.
+	 * It effectively surpasses the above method; the old one is however kept for backward
+	 * compatibility reasons.
+	 * 
+	 * @param visits List&lt;Visit&gt; to restrict obs to (optional)
+	 *      
 	 * @since 2.7.0
 	 */
+	@Authorized(PrivilegeConstants.GET_OBS)
 	public List<Obs> getObservations(List<Person> whom, List<Encounter> encounters, List<Concept> questions,
 			List<Concept> answers, List<PERSON_TYPE> personTypes, List<Location> locations, List<String> sort,
 			List<Visit> visits, Integer mostRecentN, Integer obsGroupId, Date fromDate, Date toDate,
@@ -513,11 +520,18 @@ public List<Obs> getObservations(List<Person> whom, List<Encounter> encounters,
 
 	/**
 	 * @see org.openmrs.api.ObsService#getObservationCount(java.util.List, java.util.List,
-	 *      java.util.List, java.util.List, java.util.List, java.util.List, java.util.List, java.lang.Integer,
+	 *      java.util.List, java.util.List, java.util.List, java.util.List, java.lang.Integer,
 	 *      java.util.Date, java.util.Date, boolean, java.lang.String)
 	 *      
+	 * This method works exactly the same; it only adds visits to the search criteria.
+	 * It effectively surpasses the above method; the old one is however kept for backward
+	 * compatibility reasons.
+	 * 
+	 * @param visits List&lt;Visit&gt; to restrict obs to (optional)
+	 *      
 	 * @since 2.7.0
 	 */
+	@Authorized(PrivilegeConstants.GET_OBS)
 	public Integer getObservationCount(List<Person> whom, List<Encounter> encounters, List<Concept> questions,
 			List<Concept> answers, List<PERSON_TYPE> personTypes, List<Location> locations, List<Visit> visits,
 			Integer obsGroupId, Date fromDate, Date toDate, boolean includeVoidedObs, String accessionNumber)

From d41449768cd1881e1121faed73e683f0e84a44d4 Mon Sep 17 00:00:00 2001
From: dkayiwa <dkayiwa@openmrs.org>
Date: Wed, 24 Jul 2024 14:27:37 +0300
Subject: [PATCH 066/163] TRUNK-6249 Add visit param to getOrders and
 getActiveOrders methods

---
 .../java/org/openmrs/api/OrderService.java    | 33 +++++++++++++
 .../java/org/openmrs/api/db/OrderDAO.java     | 15 ++++++
 .../api/db/hibernate/HibernateOrderDAO.java   | 30 ++++++++++--
 .../openmrs/api/impl/OrderServiceImpl.java    | 24 ++++++++-
 .../org/openmrs/api/OrderServiceTest.java     | 49 +++++++++++++++++++
 5 files changed, 146 insertions(+), 5 deletions(-)

diff --git a/api/src/main/java/org/openmrs/api/OrderService.java b/api/src/main/java/org/openmrs/api/OrderService.java
index fb8ef6e31274..3c346c07381d 100644
--- a/api/src/main/java/org/openmrs/api/OrderService.java
+++ b/api/src/main/java/org/openmrs/api/OrderService.java
@@ -12,6 +12,7 @@
 import org.openmrs.OrderAttribute;
 import org.openmrs.OrderAttributeType;
 import org.openmrs.Provider;
+import org.openmrs.Visit;
 import org.openmrs.OrderGroup;
 import org.openmrs.OrderGroupAttribute;
 import org.openmrs.OrderGroupAttributeType;
@@ -1064,4 +1065,36 @@ public Order discontinueOrder(Order orderToDiscontinue, String reasonNonCoded, D
 	 */
 	@Authorized(PrivilegeConstants.GET_ORDERS)
 	OrderAttribute getOrderAttributeByUuid(String uuid) throws APIException;
+
+	/**
+	 * @see org.openmrs.api.OrderService#getActiveOrders(org.openmrs.Patient, org.openmrs.OrderType,
+	 *      org.openmrs.CareSetting, java.util.Date)
+	 *      
+	 * This method works exactly the same; it only adds visit to the search criteria.
+	 * It effectively surpasses the above method; the old one is however kept for backward
+	 * compatibility reasons.
+	 * 
+	 * @param visit the {@link Visit} to restrict active orders (optional)
+	 *      
+	 * @since 2.7.0
+	 */
+	@Authorized(PrivilegeConstants.GET_ORDERS)
+	public List<Order> getActiveOrders(Patient patient, Visit visit, OrderType orderType, CareSetting careSetting,
+			Date asOfDate);
+
+	/**
+	 * @see OrderService#getOrders(org.openmrs.Patient, org.openmrs.CareSetting,
+	 *      org.openmrs.OrderType, boolean)
+	 *      
+	 * This method works exactly the same; it only adds visit to the search criteria.
+	 * It effectively surpasses the above method; the old one is however kept for backward
+	 * compatibility reasons.
+	 * 
+	 * @param visit the {@link Visit} to restrict orders (optional)
+	 *      
+	 * @since 2.7.0
+	 */
+	@Authorized(PrivilegeConstants.GET_ORDERS)
+	public List<Order> getOrders(Patient patient, Visit visit, CareSetting careSetting, OrderType orderType,
+			boolean includeVoided);
 }
diff --git a/api/src/main/java/org/openmrs/api/db/OrderDAO.java b/api/src/main/java/org/openmrs/api/db/OrderDAO.java
index 77d4a01319dc..a37e778c2475 100644
--- a/api/src/main/java/org/openmrs/api/db/OrderDAO.java
+++ b/api/src/main/java/org/openmrs/api/db/OrderDAO.java
@@ -25,6 +25,7 @@
 import org.openmrs.OrderGroupAttributeType;
 import org.openmrs.Patient;
 import org.openmrs.User;
+import org.openmrs.Visit;
 import org.openmrs.OrderFrequency;
 import org.openmrs.api.APIException;
 import org.openmrs.parameter.OrderSearchCriteria;
@@ -342,4 +343,18 @@ public List<OrderFrequency> getOrderFrequencies(String searchPhrase, Locale loca
 	 * @see org.openmrs.api.OrderService#getOrderAttributeTypeByName(String)
 	 */
 	OrderAttributeType getOrderAttributeTypeByName(String name)throws DAOException;
+
+	/**
+	 * @see org.openmrs.api.OrderService#getActiveOrders(org.openmrs.Patient, org.openmrs.Visit, java.util.List,
+	 *      org.openmrs.CareSetting, java.util.Date)
+	 */
+	public List<Order> getActiveOrders(Patient patient, Visit visit, List<OrderType> orderTypes, CareSetting careSetting,
+			Date asOfDate);
+
+	/**
+	 * @see org.openmrs.api.OrderService#getOrders(org.openmrs.Patient, org.openmrs.Visit, org.openmrs.CareSetting, java.util.List,
+	 *      boolean, boolean)
+	 */
+	public List<Order> getOrders(Patient patient, Visit visit, CareSetting careSetting, List<OrderType> orderTypes,
+			boolean includeVoided, boolean includeDiscontinuationOrders);
 }
diff --git a/api/src/main/java/org/openmrs/api/db/hibernate/HibernateOrderDAO.java b/api/src/main/java/org/openmrs/api/db/hibernate/HibernateOrderDAO.java
index d0e9c07ba759..1e383549b220 100644
--- a/api/src/main/java/org/openmrs/api/db/hibernate/HibernateOrderDAO.java
+++ b/api/src/main/java/org/openmrs/api/db/hibernate/HibernateOrderDAO.java
@@ -33,6 +33,7 @@
 import org.openmrs.api.db.OrderDAO;
 import org.openmrs.parameter.OrderSearchCriteria;
 import org.openmrs.User;
+import org.openmrs.Visit;
 import org.openmrs.util.OpenmrsConstants;
 import org.openmrs.util.OpenmrsUtil;
 import org.slf4j.Logger;
@@ -282,12 +283,23 @@ public List<Order> getOrders(OrderSearchCriteria searchCriteria) {
 	@Override
 	public List<Order> getOrders(Patient patient, CareSetting careSetting, List<OrderType> orderTypes, boolean includeVoided,
 	        boolean includeDiscontinuationOrders) {
+		
+		return this.getOrders(patient, null, careSetting, orderTypes, includeVoided, includeDiscontinuationOrders);
+	}
+	
+	/**
+	 * @see OrderDAO#getOrders(org.openmrs.Patient, org.openmrs.Visit, org.openmrs.CareSetting, java.util.List,
+	 *      boolean, boolean)
+	 */
+	@Override
+	public List<Order> getOrders(Patient patient, Visit visit, CareSetting careSetting, List<OrderType> orderTypes, boolean includeVoided,
+	        boolean includeDiscontinuationOrders) {
 		Session session = sessionFactory.getCurrentSession();
 		CriteriaBuilder cb = session.getCriteriaBuilder();
 		CriteriaQuery<Order> cq = cb.createQuery(Order.class);
 		Root<Order> root = cq.from(Order.class);
 
-		List<Predicate> predicates = createOrderCriteria(cb, root, patient, careSetting, orderTypes, includeVoided, includeDiscontinuationOrders);
+		List<Predicate> predicates = createOrderCriteria(cb, root, patient, visit, careSetting, orderTypes, includeVoided, includeDiscontinuationOrders);
 
 		cq.where(predicates.toArray(new Predicate[]{}));
 
@@ -447,12 +459,21 @@ public Long getNextOrderNumberSeedSequenceValue() {
 	 */
 	@Override
 	public List<Order> getActiveOrders(Patient patient, List<OrderType> orderTypes, CareSetting careSetting, Date asOfDate) {
+		return this.getActiveOrders(patient, null, orderTypes, careSetting, asOfDate);
+	}
+	
+	/**
+	 * @see org.openmrs.api.db.OrderDAO#getActiveOrders(org.openmrs.Patient, org.openmrs.Visit, java.util.List,
+	 *      org.openmrs.CareSetting, java.util.Date)
+	 */
+	@Override
+	public List<Order> getActiveOrders(Patient patient, Visit visit, List<OrderType> orderTypes, CareSetting careSetting, Date asOfDate) {
 		Session session = sessionFactory.getCurrentSession();
 		CriteriaBuilder cb = session.getCriteriaBuilder();
 		CriteriaQuery<Order> cq = cb.createQuery(Order.class);
 		Root<Order> root = cq.from(Order.class);
 
-		List<Predicate> predicates = createOrderCriteria(cb, root, patient, careSetting, orderTypes, false, false);
+		List<Predicate> predicates = createOrderCriteria(cb, root, patient, visit, careSetting, orderTypes, false, false);
 
 		predicates.add(cb.lessThanOrEqualTo(root.get("dateActivated"), asOfDate));
 
@@ -481,7 +502,7 @@ public List<Order> getActiveOrders(Patient patient, List<OrderType> orderTypes,
 	 * @param includeDiscontinuationOrders
 	 * @return
 	 */
-	private List<Predicate> createOrderCriteria(CriteriaBuilder cb, Root<Order> root, Patient patient,
+	private List<Predicate> createOrderCriteria(CriteriaBuilder cb, Root<Order> root, Patient patient, Visit visit,
 	        CareSetting careSetting, List<OrderType> orderTypes, boolean includeVoided,
 	        boolean includeDiscontinuationOrders) {
 		List<Predicate> predicates = new ArrayList<>();
@@ -489,6 +510,9 @@ private List<Predicate> createOrderCriteria(CriteriaBuilder cb, Root<Order> root
 		if (patient != null) {
 			predicates.add(cb.equal(root.get("patient"), patient));
 		}
+		if (visit != null) {
+			predicates.add(cb.equal(root.get("encounter").get("visit"), visit));
+		}
 		if (careSetting != null) {
 			predicates.add(cb.equal(root.get("careSetting"), careSetting));
 		}
diff --git a/api/src/main/java/org/openmrs/api/impl/OrderServiceImpl.java b/api/src/main/java/org/openmrs/api/impl/OrderServiceImpl.java
index 8561bad09636..e84d03b1265b 100644
--- a/api/src/main/java/org/openmrs/api/impl/OrderServiceImpl.java
+++ b/api/src/main/java/org/openmrs/api/impl/OrderServiceImpl.java
@@ -30,6 +30,7 @@
 import org.openmrs.OrderGroupAttribute;
 import org.openmrs.OrderGroupAttributeType;
 import org.openmrs.TestOrder;
+import org.openmrs.Visit;
 import org.openmrs.api.APIException;
 import org.openmrs.api.AmbiguousOrderException;
 import org.openmrs.api.CannotDeleteObjectInUseException;
@@ -561,6 +562,15 @@ public Order getOrder(Integer orderId) throws APIException {
 	 */
 	@Override
 	public List<Order> getOrders(Patient patient, CareSetting careSetting, OrderType orderType, boolean includeVoided) {
+		return this.getOrders(patient, null, careSetting, orderType, includeVoided);
+	}
+	
+	/**
+	 * @see OrderService#getOrders(org.openmrs.Patient, org.openmrs.Visit, org.openmrs.CareSetting,
+	 *      org.openmrs.OrderType, boolean)
+	 */
+	@Override
+	public List<Order> getOrders(Patient patient, Visit visit, CareSetting careSetting, OrderType orderType, boolean includeVoided) {
 		if (patient == null) {
 			throw new IllegalArgumentException("Patient is required");
 		}
@@ -573,7 +583,7 @@ public List<Order> getOrders(Patient patient, CareSetting careSetting, OrderType
 			orderTypes.add(orderType);
 			orderTypes.addAll(getSubtypes(orderType, true));
 		}
-		return dao.getOrders(patient, careSetting, orderTypes, includeVoided, false);
+		return dao.getOrders(patient, visit, careSetting, orderTypes, includeVoided, false);
 	}
 	
 	/**
@@ -686,6 +696,16 @@ public List<Order> getOrderHistoryByOrderNumber(String orderNumber) {
 	@Override
 	@Transactional(readOnly = true)
 	public List<Order> getActiveOrders(Patient patient, OrderType orderType, CareSetting careSetting, Date asOfDate) {
+		return this.getActiveOrders(patient, null, orderType, careSetting, asOfDate);
+	}
+	
+	/**
+	 * @see org.openmrs.api.OrderService#getActiveOrders(org.openmrs.Patient, org.openmrs.Visit, org.openmrs.OrderType,
+	 *      org.openmrs.CareSetting, java.util.Date)
+	 */
+	@Override
+	@Transactional(readOnly = true)
+	public List<Order> getActiveOrders(Patient patient, Visit visit, OrderType orderType, CareSetting careSetting, Date asOfDate) {
 		if (patient == null) {
 			throw new IllegalArgumentException("Patient is required when fetching active orders");
 		}
@@ -698,7 +718,7 @@ public List<Order> getActiveOrders(Patient patient, OrderType orderType, CareSet
 			orderTypes.add(orderType);
 			orderTypes.addAll(getSubtypes(orderType, true));
 		}
-		return dao.getActiveOrders(patient, orderTypes, careSetting, asOfDate);
+		return dao.getActiveOrders(patient, visit, orderTypes, careSetting, asOfDate);
 	}
 	
 	/**
diff --git a/api/src/test/java/org/openmrs/api/OrderServiceTest.java b/api/src/test/java/org/openmrs/api/OrderServiceTest.java
index d7b721be49c8..207b7c2cbed0 100644
--- a/api/src/test/java/org/openmrs/api/OrderServiceTest.java
+++ b/api/src/test/java/org/openmrs/api/OrderServiceTest.java
@@ -429,6 +429,26 @@ public void getActiveOrders_shouldReturnAllActiveOrdersForTheSpecifiedPatient()
 		assertTrue(OrderUtilTest.isActiveOrder(orders.get(3), null));
 		assertTrue(OrderUtilTest.isActiveOrder(orders.get(4), null));
 	}
+	
+	/**
+	 * @see OrderService#getActiveOrders(org.openmrs.Patient, org.openmrs.Visit, org.openmrs.OrderType,
+	 * org.openmrs.CareSetting, java.util.Date)
+	 */
+	@Test
+	public void getActiveOrders_shouldReturnAllActiveOrdersForTheSpecifiedVisit() {
+		Patient patient = Context.getPatientService().getPatient(2);
+		List<Order> orders = orderService.getActiveOrders(patient, new Visit(6), null, null, null);
+		assertEquals(5, orders.size());
+		Order[] expectedOrders = {orderService.getOrder(222), orderService.getOrder(3), orderService.getOrder(444),
+			orderService.getOrder(5), orderService.getOrder(7)};
+		assertThat(orders, hasItems(expectedOrders));
+
+		assertTrue(OrderUtilTest.isActiveOrder(orders.get(0), null));
+		assertTrue(OrderUtilTest.isActiveOrder(orders.get(1), null));
+		assertTrue(OrderUtilTest.isActiveOrder(orders.get(2), null));
+		assertTrue(OrderUtilTest.isActiveOrder(orders.get(3), null));
+		assertTrue(OrderUtilTest.isActiveOrder(orders.get(4), null));
+	}
 
 	/**
 	 * @see OrderService#getActiveOrders(org.openmrs.Patient, org.openmrs.OrderType,
@@ -2034,6 +2054,35 @@ public void getOrders_shouldGetTheOrdersThatMatchAllTheArguments() {
 		List<Order> inPatientDrugOrders = orderService.getOrders(patient, inPatient, drugOrderType, false);
 		assertEquals(222, inPatientDrugOrders.get(0).getOrderId().intValue());
 	}
+	
+	/**
+	 * @see OrderService#getOrders(org.openmrs.Patient, org.openmrs.Visit, org.openmrs.CareSetting,
+	 * org.openmrs.OrderType, boolean)
+	 */
+	@Test
+	public void getOrders_shouldGetTheOrdersThatMatchAllTheArgumentsIncludingVisit() {
+		Patient patient = patientService.getPatient(2);
+		CareSetting outPatient = orderService.getCareSetting(1);
+		OrderType testOrderType = orderService.getOrderType(2);
+		List<Order> testOrders = orderService.getOrders(patient, new Visit(6), outPatient, testOrderType, false);
+		assertEquals(3, testOrders.size());
+		TestUtil.containsId(testOrders, 6);
+		TestUtil.containsId(testOrders, 7);
+		TestUtil.containsId(testOrders, 9);
+
+		OrderType drugOrderType = orderService.getOrderType(1);
+		List<Order> drugOrders = orderService.getOrders(patient, new Visit(6), outPatient, drugOrderType, false);
+		assertEquals(5, drugOrders.size());
+		TestUtil.containsId(drugOrders, 2);
+		TestUtil.containsId(drugOrders, 3);
+		TestUtil.containsId(drugOrders, 44);
+		TestUtil.containsId(drugOrders, 444);
+		TestUtil.containsId(drugOrders, 5);
+
+		CareSetting inPatient = orderService.getCareSetting(2);
+		List<Order> inPatientDrugOrders = orderService.getOrders(patient, new Visit(6), inPatient, drugOrderType, false);
+		assertEquals(222, inPatientDrugOrders.get(0).getOrderId().intValue());
+	}
 
 	/**
 	 * @see OrderService#getOrders(org.openmrs.Patient, org.openmrs.CareSetting,

From 8893c22a95c4c9ed74ab9c94f60b54054b118256 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 27 Jul 2024 22:46:57 +0300
Subject: [PATCH 067/163] github-actions(deps): bump ossf/scorecard-action from
 2.3.3 to 2.4.0 (#4700)

Bumps [ossf/scorecard-action](https://github.com/ossf/scorecard-action) from 2.3.3 to 2.4.0.
- [Release notes](https://github.com/ossf/scorecard-action/releases)
- [Changelog](https://github.com/ossf/scorecard-action/blob/main/RELEASE.md)
- [Commits](https://github.com/ossf/scorecard-action/compare/v2.3.3...v2.4.0)

---
updated-dependencies:
- dependency-name: ossf/scorecard-action
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/scorecard.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/scorecard.yml b/.github/workflows/scorecard.yml
index dbab4d374d4c..4819dd3de494 100644
--- a/.github/workflows/scorecard.yml
+++ b/.github/workflows/scorecard.yml
@@ -32,7 +32,7 @@ jobs:
           persist-credentials: false
 
       - name: "Run analysis"
-        uses: ossf/scorecard-action@v2.3.3
+        uses: ossf/scorecard-action@v2.4.0
         with:
           results_file: results.sarif
           results_format: sarif

From 941269dc5cfd0498fba5bdc7102bf214e14a432d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 31 Jul 2024 22:26:01 +0300
Subject: [PATCH 068/163] maven(deps-dev): bump org.testcontainers:mysql from
 1.20.0 to 1.20.1 (#4701)

Bumps [org.testcontainers:mysql](https://github.com/testcontainers/testcontainers-java) from 1.20.0 to 1.20.1.
- [Release notes](https://github.com/testcontainers/testcontainers-java/releases)
- [Changelog](https://github.com/testcontainers/testcontainers-java/blob/main/CHANGELOG.md)
- [Commits](https://github.com/testcontainers/testcontainers-java/compare/1.20.0...1.20.1)

---
updated-dependencies:
- dependency-name: org.testcontainers:mysql
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 4c7797d630ad..5f74ab21ff30 100644
--- a/pom.xml
+++ b/pom.xml
@@ -585,7 +585,7 @@
 			<dependency>
 				<groupId>org.testcontainers</groupId>
 				<artifactId>mysql</artifactId>
-				<version>1.20.0</version>
+				<version>1.20.1</version>
 				<scope>test</scope>
 			</dependency>
 			<dependency>

From 6e43defc403de51799946497e76efa86207b73a6 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 31 Jul 2024 22:26:28 +0300
Subject: [PATCH 069/163] maven(deps-dev): bump org.testcontainers:postgresql
 (#4702)

Bumps [org.testcontainers:postgresql](https://github.com/testcontainers/testcontainers-java) from 1.20.0 to 1.20.1.
- [Release notes](https://github.com/testcontainers/testcontainers-java/releases)
- [Changelog](https://github.com/testcontainers/testcontainers-java/blob/main/CHANGELOG.md)
- [Commits](https://github.com/testcontainers/testcontainers-java/compare/1.20.0...1.20.1)

---
updated-dependencies:
- dependency-name: org.testcontainers:postgresql
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 5f74ab21ff30..388681683ce1 100644
--- a/pom.xml
+++ b/pom.xml
@@ -591,7 +591,7 @@
 			<dependency>
 				<groupId>org.testcontainers</groupId>
 				<artifactId>postgresql</artifactId>
-				<version>1.20.0</version>
+				<version>1.20.1</version>
 				<scope>test</scope>
 			</dependency>
 		</dependencies>

From 4babcd6cec0614270ab977a87c611303cb774094 Mon Sep 17 00:00:00 2001
From: rkorytkowski <rafal.korytkowski@gmail.com>
Date: Thu, 1 Aug 2024 17:14:32 +0200
Subject: [PATCH 070/163] TRUNK-6253 Add missing privilege check in FormService

---
 api/src/main/java/org/openmrs/api/FormService.java | 1 +
 1 file changed, 1 insertion(+)

diff --git a/api/src/main/java/org/openmrs/api/FormService.java b/api/src/main/java/org/openmrs/api/FormService.java
index 4eb520b078f5..89cea3977a5f 100644
--- a/api/src/main/java/org/openmrs/api/FormService.java
+++ b/api/src/main/java/org/openmrs/api/FormService.java
@@ -75,6 +75,7 @@ public interface FormService extends OpenmrsService {
 	 * <strong>Should</strong> find object given valid uuid
 	 * <strong>Should</strong> return null if no object found with given uuid
 	 */
+	@Authorized(PrivilegeConstants.GET_FORMS)
 	public Form getFormByUuid(String uuid) throws APIException;
 	
 	/**

From 0d44725f863288c274a61a3fd59720f4ee9efb2a Mon Sep 17 00:00:00 2001
From: rkorytkowski <rafal.korytkowski@gmail.com>
Date: Thu, 1 Aug 2024 17:27:21 +0200
Subject: [PATCH 071/163] TRUNK-6254 Require authorization for AlertService

---
 .../main/java/org/openmrs/notification/AlertService.java    | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/api/src/main/java/org/openmrs/notification/AlertService.java b/api/src/main/java/org/openmrs/notification/AlertService.java
index 07e0c486a957..63858bb0be34 100644
--- a/api/src/main/java/org/openmrs/notification/AlertService.java
+++ b/api/src/main/java/org/openmrs/notification/AlertService.java
@@ -57,6 +57,7 @@ public interface AlertService extends OpenmrsService {
 	 * @return alert with given internal identifier
 	 * @throws APIException
 	 */
+	@Authorized
 	public Alert getAlert(Integer alertId) throws APIException;
 	
 	/**
@@ -76,6 +77,7 @@ public interface AlertService extends OpenmrsService {
 	 * @see #getAlerts(User, boolean, boolean)
 	 * @throws APIException
 	 */
+	@Authorized
 	public List<Alert> getAllActiveAlerts(User user) throws APIException;
 	
 	/**
@@ -88,6 +90,7 @@ public interface AlertService extends OpenmrsService {
 	 * @return alerts that are unread and not expired
 	 * @throws APIException
 	 */
+	@Authorized
 	public List<Alert> getAlertsByUser(User user) throws APIException;
 	
 	/**
@@ -99,6 +102,7 @@ public interface AlertService extends OpenmrsService {
 	 * @return alerts for this user with these options
 	 * @throws APIException
 	 */
+	@Authorized
 	public List<Alert> getAlerts(User user, boolean includeRead, boolean includeExpired) throws APIException;
 	
 	/**
@@ -107,6 +111,7 @@ public interface AlertService extends OpenmrsService {
 	 * @return list of unexpired alerts
 	 * @throws APIException
 	 */
+	@Authorized
 	public List<Alert> getAllAlerts() throws APIException;
 	
 	/**
@@ -116,6 +121,7 @@ public interface AlertService extends OpenmrsService {
 	 * @return list of alerts
 	 * @throws APIException
 	 */
+	@Authorized
 	public List<Alert> getAllAlerts(boolean includeExpired) throws APIException;
 	
 	/**

From 441376ca9257ee57d9fdef9b3d045ec60e4cd2ec Mon Sep 17 00:00:00 2001
From: rkorytkowski <rafal.korytkowski@gmail.com>
Date: Thu, 1 Aug 2024 17:38:42 +0200
Subject: [PATCH 072/163] TRUNK-6255 Add missing privilege checks for
 ConceptService

(cherry picked from commit 027e75a62ad21a651936bbba6eb95b4261473999)
---
 .../main/java/org/openmrs/api/ConceptService.java    | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/api/src/main/java/org/openmrs/api/ConceptService.java b/api/src/main/java/org/openmrs/api/ConceptService.java
index 29405d851bad..2ce3fb97c855 100644
--- a/api/src/main/java/org/openmrs/api/ConceptService.java
+++ b/api/src/main/java/org/openmrs/api/ConceptService.java
@@ -789,6 +789,7 @@ public interface ConceptService extends OpenmrsService {
 	 * 
 	 * @throws ConceptsLockedException
 	 */
+	@Authorized(PrivilegeConstants.GET_CONCEPTS)
 	public void checkIfLocked() throws ConceptsLockedException;
 	
 	/**
@@ -856,6 +857,7 @@ public interface ConceptService extends OpenmrsService {
 	 * @return set of used Locales
 	 * <strong>Should</strong> return a list of matching locales
 	 */
+	@Authorized(PrivilegeConstants.GET_CONCEPTS)
 	public Set<Locale> getLocalesOfConceptNames();
 	
 	/**
@@ -936,6 +938,7 @@ public interface ConceptService extends OpenmrsService {
 	 * @return highest concept-id
 	 * <strong>Should</strong> give the maximum concept-id
 	 */
+	@Authorized(PrivilegeConstants.GET_CONCEPTS)
 	public Integer getMaxConceptId();
 	
 	/**
@@ -1066,6 +1069,7 @@ public interface ConceptService extends OpenmrsService {
 	 * @return a list of the concept name tags stored in the dataset
 	 * <strong>Should</strong> return a list of all concept name tags
 	 */
+	@Authorized(PrivilegeConstants.GET_CONCEPTS)
 	public List<ConceptNameTag> getAllConceptNameTags();
 	
 	/**
@@ -1145,6 +1149,7 @@ public interface ConceptService extends OpenmrsService {
 	 * @return true concept
 	 * <strong>Should</strong> return the true concept
 	 */
+	@Authorized(PrivilegeConstants.GET_CONCEPTS)
 	public Concept getTrueConcept();
 	
 	/**
@@ -1153,6 +1158,7 @@ public interface ConceptService extends OpenmrsService {
 	 * @return false concept
 	 * <strong>Should</strong> return the false concept
 	 */
+	@Authorized(PrivilegeConstants.GET_CONCEPTS)
 	public Concept getFalseConcept();
 	
 	/**
@@ -1161,6 +1167,7 @@ public interface ConceptService extends OpenmrsService {
 	 * @return unknown concept
 	 * <strong>Should</strong> return the unknown concept
 	 */
+	@Authorized(PrivilegeConstants.GET_CONCEPTS)
 	public Concept getUnknownConcept();
 	
 	/**
@@ -1341,6 +1348,7 @@ public List<Drug> getDrugs(String drugName, Concept concept, boolean searchKeywo
 	 * <strong>Should</strong> return default Locale <code>ConceptStopWord</code> if Locale is null
 	 * @since 1.8
 	 */
+	@Authorized(PrivilegeConstants.GET_CONCEPTS)
 	public List<String> getConceptStopWords(Locale locale);
 	
 	/**
@@ -1383,6 +1391,7 @@ public List<Drug> getDrugs(String drugName, Concept concept, boolean searchKeywo
 	 * <strong>Should</strong> return empty list if nothing found
 	 * @since 1.8
 	 */
+	@Authorized(PrivilegeConstants.GET_CONCEPTS)
 	public List<ConceptStopWord> getAllConceptStopWords();
 	
 	/**
@@ -1395,6 +1404,7 @@ public List<Drug> getDrugs(String drugName, Concept concept, boolean searchKeywo
 	 * <strong>Should</strong> raise exception if no concept is given
 	 * @since 1.10
 	 */
+	@Authorized(PrivilegeConstants.GET_CONCEPTS)
 	public List<Drug> getDrugsByIngredient(Concept ingredient);
 	
 	/**
@@ -1762,6 +1772,7 @@ public Integer getCountOfConceptReferenceTerms(String query, ConceptSource conce
 	 * @return true if it is a duplicate name
 	 * @since 1.11
 	 */
+	@Authorized(PrivilegeConstants.GET_CONCEPTS)
 	public boolean isConceptNameDuplicate(ConceptName name);
 	
 	/**
@@ -1850,6 +1861,7 @@ public Drug getDrugByMapping(String code, ConceptSource conceptSource,
 	 * <strong>Should</strong> get orderable concepts
 	 * <strong>Should</strong> return an empty list if no concept search result is found
 	 */
+	@Authorized(PrivilegeConstants.GET_CONCEPTS)
 	public List<ConceptSearchResult> getOrderableConcepts(String phrase, List<Locale> locales, boolean includeRetired,
 	        Integer start, Integer length);
 			

From 056ee1eafbbdaf27358b316c250259e4e1e3442c Mon Sep 17 00:00:00 2001
From: rkorytkowski <rafal.korytkowski@gmail.com>
Date: Thu, 1 Aug 2024 18:14:37 +0200
Subject: [PATCH 073/163] Fixing tests

---
 api/src/test/java/org/openmrs/aop/AuthorizationAdviceTest.java | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/api/src/test/java/org/openmrs/aop/AuthorizationAdviceTest.java b/api/src/test/java/org/openmrs/aop/AuthorizationAdviceTest.java
index b60798c05503..ac4592808054 100644
--- a/api/src/test/java/org/openmrs/aop/AuthorizationAdviceTest.java
+++ b/api/src/test/java/org/openmrs/aop/AuthorizationAdviceTest.java
@@ -65,7 +65,8 @@ public void before_shouldNotifyListenersAboutCheckedPrivileges() {
 		Context.getConceptService().saveConcept(concept);
 		
 		String[] privileges = { PrivilegeConstants.MANAGE_CONCEPTS, PrivilegeConstants.GET_OBS,
-		        PrivilegeConstants.GET_CONCEPT_ATTRIBUTE_TYPES, PrivilegeConstants.GET_GLOBAL_PROPERTIES };
+		        PrivilegeConstants.GET_CONCEPT_ATTRIBUTE_TYPES, PrivilegeConstants.GET_GLOBAL_PROPERTIES, 
+				PrivilegeConstants.GET_CONCEPTS };
 		assertThat("listener1", listener1.hasPrivileges, containsInAnyOrder(privileges));
 		assertThat("listener2", listener2.hasPrivileges, containsInAnyOrder(privileges));
 		assertThat(listener1.lacksPrivileges, empty());

From 4510cb29a7c7d0ddf402b016196d9855a78f7c37 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 1 Aug 2024 21:47:37 +0300
Subject: [PATCH 074/163] maven(deps): bump hamcrestVersion from 2.2 to 3.0
 (#4704)

Bumps `hamcrestVersion` from 2.2 to 3.0.

Updates `org.hamcrest:hamcrest-core` from 2.2 to 3.0
- [Release notes](https://github.com/hamcrest/JavaHamcrest/releases)
- [Changelog](https://github.com/hamcrest/JavaHamcrest/blob/master/CHANGES.md)
- [Commits](https://github.com/hamcrest/JavaHamcrest/compare/v2.2...v3.0)

Updates `org.hamcrest:hamcrest` from 2.2 to 3.0
- [Release notes](https://github.com/hamcrest/JavaHamcrest/releases)
- [Changelog](https://github.com/hamcrest/JavaHamcrest/blob/master/CHANGES.md)
- [Commits](https://github.com/hamcrest/JavaHamcrest/compare/v2.2...v3.0)

---
updated-dependencies:
- dependency-name: org.hamcrest:hamcrest-core
  dependency-type: direct:production
  update-type: version-update:semver-major
- dependency-name: org.hamcrest:hamcrest
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 388681683ce1..90b408915b6a 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1219,7 +1219,7 @@
 		<jacksonVersion>2.17.2</jacksonVersion>
 		<junitVersion>5.10.3</junitVersion>
 		<mockitoVersion>3.12.4</mockitoVersion>
-		<hamcrestVersion>2.2</hamcrestVersion>
+		<hamcrestVersion>3.0</hamcrestVersion>
 
 		<slf4jVersion>1.7.36</slf4jVersion>
 		<log4jVersion>2.22.1</log4jVersion>

From e52c2a15d6ea3fa72e7e3a4600705514b14a8757 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 3 Aug 2024 23:12:39 +0300
Subject: [PATCH 075/163] maven(deps): bump org.owasp.encoder:encoder from
 1.2.3 to 1.3.0 (#4705)

Bumps [org.owasp.encoder:encoder](https://github.com/owasp/owasp-java-encoder) from 1.2.3 to 1.3.0.
- [Release notes](https://github.com/owasp/owasp-java-encoder/releases)
- [Commits](https://github.com/owasp/owasp-java-encoder/compare/v1.2.3...v1.3.0)

---
updated-dependencies:
- dependency-name: org.owasp.encoder:encoder
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 web/pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/web/pom.xml b/web/pom.xml
index 39e195719517..0e9e2ce38b1f 100644
--- a/web/pom.xml
+++ b/web/pom.xml
@@ -126,7 +126,7 @@
       <dependency>
          <groupId>org.owasp.encoder</groupId>
          <artifactId>encoder</artifactId>
-         <version>1.2.3</version>
+         <version>1.3.0</version>
       </dependency>
 	   <dependency>
 		   <groupId>org.apache.tomcat</groupId>

From f4d8a38bc9203ecbde28bbb1807962b49bf19612 Mon Sep 17 00:00:00 2001
From: Tusha <mujuzimoses@gmail.com>
Date: Mon, 5 Aug 2024 21:35:30 +0300
Subject: [PATCH 076/163] TRUNK-6047: Add utility methods to invalidate
 database caches (#4421)

---
 .../java/org/openmrs/api/context/Context.java | 30 +++++++
 .../java/org/openmrs/api/db/ContextDAO.java   | 25 ++++++
 .../api/db/hibernate/HibernateContextDAO.java | 27 +++++++
 .../org/openmrs/api/context/ContextTest.java  | 80 +++++++++++++++++++
 4 files changed, 162 insertions(+)

diff --git a/api/src/main/java/org/openmrs/api/context/Context.java b/api/src/main/java/org/openmrs/api/context/Context.java
index 154bbaa39813..79e5d3573443 100644
--- a/api/src/main/java/org/openmrs/api/context/Context.java
+++ b/api/src/main/java/org/openmrs/api/context/Context.java
@@ -11,8 +11,10 @@
 
 import org.aopalliance.aop.Advice;
 import org.apache.commons.lang3.StringUtils;
+import org.hibernate.SessionFactory;
 import org.openmrs.Allergen;
 import org.openmrs.GlobalProperty;
+import org.openmrs.OpenmrsObject;
 import org.openmrs.PersonName;
 import org.openmrs.Privilege;
 import org.openmrs.Role;
@@ -890,6 +892,34 @@ public static void evictFromSession(Object obj) {
 		getContextDAO().evictFromSession(obj);
 	}
 
+	/**
+	 * Evicts the entity data for a particular entity instance.
+	 *
+	 * @param object entity instance to evict from the DB cache
+	 */
+	public static void evictEntity(OpenmrsObject object) {
+		log.debug("Clearing DB cache for entity: {} with id: {}", object.getClass(), object.getId());
+		getContextDAO().evictEntity(object);
+	}
+	
+	/**
+	 * Evicts all entity data of a particular class from the given region.
+	 * 
+	 * @param entityClass entity class to evict from the DB cache
+	 */
+	public static void evictAllEntities(Class<?> entityClass) {
+		log.debug("Clearing DB cache for entities of type: {}", entityClass);
+		getContextDAO().evictAllEntities(entityClass);
+	}
+	
+	/**
+	 * Evicts data from all cache regions.
+	 */
+	public static void clearEntireCache() {
+		log.debug("Clearing DB cache from all regions");
+		getContextDAO().clearEntireCache();
+	}
+	
 	/**
 	 * Starts the OpenMRS System Should be called prior to any kind of activity
 	 *
diff --git a/api/src/main/java/org/openmrs/api/db/ContextDAO.java b/api/src/main/java/org/openmrs/api/db/ContextDAO.java
index a26ae3ed3f2f..ae5835b62ddf 100644
--- a/api/src/main/java/org/openmrs/api/db/ContextDAO.java
+++ b/api/src/main/java/org/openmrs/api/db/ContextDAO.java
@@ -14,6 +14,8 @@
 import java.util.Properties;
 import java.util.concurrent.Future;
 
+import org.hibernate.SessionFactory;
+import org.openmrs.OpenmrsObject;
 import org.openmrs.User;
 import org.openmrs.api.context.Context;
 import org.openmrs.api.context.ContextAuthenticationException;
@@ -120,6 +122,29 @@ public interface ContextDAO {
 	 */
 	public void evictFromSession(Object obj);
 
+	/**
+	 * Evicts the entity data for a particular entity instance.
+	 *
+	 * @param object entity instance to evict from the DB cache
+	 * @see org.openmrs.api.context.Context#evictEntity(OpenmrsObject)   
+	 */
+	public void evictEntity(OpenmrsObject object);
+
+	/**
+	 * Evicts all entity data of a particular class from the given region.
+	
+	 * @param entityClass entity class to evict from the DB cache
+	 * @see org.openmrs.api.context.Context#evictAllEntities(Class)
+	 */
+	public void evictAllEntities(Class<?> entityClass);
+
+	/**
+	 * Evicts data from all cache regions.
+	 *
+	 * @see org.openmrs.api.context.Context#clearEntireCache()
+	 */
+	public void clearEntireCache();
+
 	/**
 	 * Used to re-read the state of the given instance from the underlying database.
 	 * @since 2.0
diff --git a/api/src/main/java/org/openmrs/api/db/hibernate/HibernateContextDAO.java b/api/src/main/java/org/openmrs/api/db/hibernate/HibernateContextDAO.java
index b01a8deadbeb..8686db9da031 100644
--- a/api/src/main/java/org/openmrs/api/db/hibernate/HibernateContextDAO.java
+++ b/api/src/main/java/org/openmrs/api/db/hibernate/HibernateContextDAO.java
@@ -21,6 +21,7 @@
 import org.hibernate.stat.Statistics;
 import org.hibernate.type.StandardBasicTypes;
 import org.openmrs.GlobalProperty;
+import org.openmrs.OpenmrsObject;
 import org.openmrs.User;
 import org.openmrs.api.context.Context;
 import org.openmrs.api.context.ContextAuthenticationException;
@@ -371,6 +372,32 @@ public void clearSession() {
 	public void evictFromSession(Object obj) {
 		sessionFactory.getCurrentSession().evict(obj);
 	}
+
+	/**
+	 * @see org.openmrs.api.db.ContextDAO#evictEntity(OpenmrsObject)
+	 */
+	@Override
+	public void evictEntity(OpenmrsObject obj) {
+		sessionFactory.getCache().evictEntity(obj.getClass(), obj.getId());
+	}
+
+	/**
+	 * @see org.openmrs.api.db.ContextDAO#evictAllEntities(Class)
+	 */
+	@Override
+	public void evictAllEntities(Class<?> entityClass) {
+		sessionFactory.getCache().evictEntityRegion(entityClass);
+		sessionFactory.getCache().evictCollectionRegions();
+		sessionFactory.getCache().evictQueryRegions();
+	}
+
+	/**
+	 * @see org.openmrs.api.db.ContextDAO#clearEntireCache()
+	 */
+	@Override
+	public void clearEntireCache() {
+		sessionFactory.getCache().evictAllRegions();
+	}
 	
 	/**
 	 * @see org.openmrs.api.db.ContextDAO#refreshEntity(Object)
diff --git a/api/src/test/java/org/openmrs/api/context/ContextTest.java b/api/src/test/java/org/openmrs/api/context/ContextTest.java
index a68d0d28f02d..7c5ec7e20673 100644
--- a/api/src/test/java/org/openmrs/api/context/ContextTest.java
+++ b/api/src/test/java/org/openmrs/api/context/ContextTest.java
@@ -20,9 +20,12 @@
 import java.util.Locale;
 import java.util.Map;
 
+import org.hibernate.SessionFactory;
 import org.junit.jupiter.api.AfterAll;
 import org.junit.jupiter.api.Test;
 import org.openmrs.Location;
+import org.openmrs.OpenmrsObject;
+import org.openmrs.Patient;
 import org.openmrs.Person;
 import org.openmrs.PersonName;
 import org.openmrs.User;
@@ -34,6 +37,7 @@
 import org.openmrs.test.jupiter.BaseContextSensitiveTest;
 import org.openmrs.util.LocaleUtility;
 import org.openmrs.util.OpenmrsConstants;
+import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.validation.Validator;
 
 /**
@@ -43,6 +47,13 @@
  */
 public class ContextTest extends BaseContextSensitiveTest {
 	
+	private static final Class PERSON_NAME_CLASS = PersonName.class;
+	private static final Integer PERSON_NAME_ID_2 = 2;
+	private static final Integer PERSON_NAME_ID_8 = 8;
+
+	@Autowired
+	private SessionFactory sf;
+	
 	/**
 	 * Methods in this class might authenticate with a different user, so log that user out after
 	 * this whole junit class is done.
@@ -273,4 +284,73 @@ public void becomeUser_shouldChangeLocaleWhenBecomeAnotherUser() {
 		
 		Context.logout();
 	}
+
+	/**
+	 * @see org.openmrs.api.context.Context#evictEntity(OpenmrsObject) 
+	 */
+	@Test
+	public void evictEntity_shouldClearTheEntityFromCaches() {
+		// Load the person so that the names are also stored in the cache
+		PersonName name = Context.getPersonService().getPersonName(PERSON_NAME_ID_2);
+		Context.getPersonService().getPersonName(PERSON_NAME_ID_8);
+		
+		// Assert that the names have been added to cache
+		assertTrue(sf.getCache().containsEntity(PERSON_NAME_CLASS, PERSON_NAME_ID_2));
+		assertTrue(sf.getCache().containsEntity(PERSON_NAME_CLASS, PERSON_NAME_ID_8));
+
+		// evictEntity
+		Context.evictEntity(name);
+
+		// Assert that the entity name has been removed from cache
+		assertFalse(sf.getCache().containsEntity(PERSON_NAME_CLASS, PERSON_NAME_ID_2));
+		assertTrue(sf.getCache().containsEntity(PERSON_NAME_CLASS, PERSON_NAME_ID_8));
+	}
+
+	/**
+	 * @see org.openmrs.api.context.Context#evictAllEntities(Class)
+	 */
+	@Test
+	public void evictAllEntities_shouldClearAllEntityFromCaches() {
+		// Load the person and patient so that they are stored in the cache
+		Context.getPersonService().getPersonName(PERSON_NAME_ID_2);
+		Context.getPersonService().getPersonName(PERSON_NAME_ID_8);
+		Context.getPatientService().getPatient(PERSON_NAME_ID_2);
+		
+		// Assert that the entities have been added to cache
+		assertTrue(sf.getCache().containsEntity(PERSON_NAME_CLASS, PERSON_NAME_ID_2));
+		assertTrue(sf.getCache().containsEntity(PERSON_NAME_CLASS, PERSON_NAME_ID_8));
+		assertTrue(sf.getCache().containsEntity(Patient.class, PERSON_NAME_ID_2));
+
+		// evictAllEntities
+		Context.evictAllEntities(PERSON_NAME_CLASS);
+
+		// Assert that the class entities have been removed from cache
+		assertFalse(sf.getCache().containsEntity(PERSON_NAME_CLASS, PERSON_NAME_ID_2));
+		assertFalse(sf.getCache().containsEntity(PERSON_NAME_CLASS, PERSON_NAME_ID_8));
+		assertTrue(sf.getCache().containsEntity(Patient.class, PERSON_NAME_ID_2));
+	}
+
+	/**
+	 * @see org.openmrs.api.context.Context#clearEntireCache()
+	 */
+	@Test
+	public void clearEntireCache_shouldClearEntireCache() {
+		// Load the person and patient so that they are stored in the cache
+		Context.getPersonService().getPersonName(PERSON_NAME_ID_2);
+		Context.getPersonService().getPersonName(PERSON_NAME_ID_8);
+		Context.getPatientService().getPatient(PERSON_NAME_ID_2);
+		
+		// Assert that the entities have been added to cache
+		assertTrue(sf.getCache().containsEntity(PERSON_NAME_CLASS, PERSON_NAME_ID_2));
+		assertTrue(sf.getCache().containsEntity(PERSON_NAME_CLASS, PERSON_NAME_ID_8));
+		assertTrue(sf.getCache().containsEntity(Patient.class, PERSON_NAME_ID_2));
+
+		// clearEntireCache
+		Context.clearEntireCache();
+
+		// Assert that all entities have been removed from cache
+		assertFalse(sf.getCache().containsEntity(PERSON_NAME_CLASS, PERSON_NAME_ID_2));
+		assertFalse(sf.getCache().containsEntity(PERSON_NAME_CLASS, PERSON_NAME_ID_8));
+		assertFalse(sf.getCache().containsEntity(Patient.class, PERSON_NAME_ID_2));
+	}
 }

From f8232475bb13a912e52dec34d9d344d5506892f5 Mon Sep 17 00:00:00 2001
From: Rafal Korytkowski <rafal.korytkowski@gmail.com>
Date: Tue, 6 Aug 2024 16:01:10 +0200
Subject: [PATCH 077/163] TRUNK-6188 Upgrade xstream and migrate to
 whitelisting (#4377)

---
 .../openmrs/api/AdministrationService.java    |  19 +++
 .../api/impl/AdministrationServiceImpl.java   |  42 +++++-
 .../SimpleXStreamSerializer.java              | 122 +++++++++++++++---
 .../resources/applicationContext-service.xml  |   2 +-
 .../api/AdministrationServiceTest.java        |  54 ++++++++
 .../SimpleXStreamSerializerTest.java          |  89 ++++++++++++-
 pom.xml                                       |   2 +-
 7 files changed, 305 insertions(+), 25 deletions(-)

diff --git a/api/src/main/java/org/openmrs/api/AdministrationService.java b/api/src/main/java/org/openmrs/api/AdministrationService.java
index f25d2c7c1e9c..64b5f32bbe1b 100644
--- a/api/src/main/java/org/openmrs/api/AdministrationService.java
+++ b/api/src/main/java/org/openmrs/api/AdministrationService.java
@@ -41,6 +41,10 @@
  */
 public interface AdministrationService extends OpenmrsService {
 	
+	public static final String GP_SUFFIX_SERIALIZER_WHITELIST_TYPES = ".serializer.whitelist.types";
+	
+	public static final String GP_SERIALIZER_WHITELIST_HIERARCHY_TYPES_PREFIX = "hierarchyOf:";
+	
 	/**
 	 * Used by Spring to set the specific/chosen database access implementation
 	 * 
@@ -401,4 +405,19 @@ public interface AdministrationService extends OpenmrsService {
 	 * @since 2.4
 	 */
 	public void updatePostgresSequence();
+	
+	/**
+	 * Returns a list of packages and/or individual classes including hierarchy of OpenmrsObject, OpenmmrsMetadata,
+	 * OpenmrsData and other common OpenMRS classes as well as any whitelists defined through GPs with the 
+	 * '.serializer.whitelist.types' suffix that are considered to be safe for deserializing.
+	 *
+	 * It is the responsibility of the serializer to block any unlisted classes from being deserialized and posing
+	 * security risk. It is especially important for serializers using XStream.
+	 *
+	 * @since 2.7.0, 2.6.2, 2.5.13 
+	 * @return a list of packages and/or classes
+	 * <strong>Should</strong> return packages and individual classes defined in GPs
+	 * <strong>Should</strong> return default common classes if no GPs defined
+	 */
+	List<String> getSerializerWhitelistTypes();
 }
diff --git a/api/src/main/java/org/openmrs/api/impl/AdministrationServiceImpl.java b/api/src/main/java/org/openmrs/api/impl/AdministrationServiceImpl.java
index 91f9b5180b40..9ade8296d71a 100644
--- a/api/src/main/java/org/openmrs/api/impl/AdministrationServiceImpl.java
+++ b/api/src/main/java/org/openmrs/api/impl/AdministrationServiceImpl.java
@@ -14,6 +14,7 @@
 import java.net.UnknownHostException;
 import java.text.SimpleDateFormat;
 import java.util.ArrayList;
+import java.util.Arrays;
 import java.util.Calendar;
 import java.util.Collection;
 import java.util.HashMap;
@@ -33,6 +34,8 @@
 import org.openmrs.ConceptSource;
 import org.openmrs.GlobalProperty;
 import org.openmrs.ImplementationId;
+import org.openmrs.OpenmrsData;
+import org.openmrs.OpenmrsMetadata;
 import org.openmrs.OpenmrsObject;
 import org.openmrs.Privilege;
 import org.openmrs.User;
@@ -42,10 +45,19 @@
 import org.openmrs.api.GlobalPropertyListener;
 import org.openmrs.api.context.Context;
 import org.openmrs.api.db.AdministrationDAO;
+import org.openmrs.customdatatype.CustomDatatype;
 import org.openmrs.customdatatype.CustomDatatypeUtil;
+import org.openmrs.customdatatype.CustomValueDescriptor;
+import org.openmrs.customdatatype.Customizable;
+import org.openmrs.customdatatype.SingleCustomValue;
+import org.openmrs.layout.LayoutSupport;
+import org.openmrs.layout.LayoutTemplate;
+import org.openmrs.messagesource.PresentationMessage;
 import org.openmrs.module.Module;
 import org.openmrs.module.ModuleFactory;
 import org.openmrs.module.ModuleUtil;
+import org.openmrs.obs.ComplexData;
+import org.openmrs.person.PersonMergeLogData;
 import org.openmrs.util.HttpClient;
 import org.openmrs.util.LocaleUtility;
 import org.openmrs.util.OpenmrsConstants;
@@ -941,5 +953,33 @@ public boolean isDatabaseStringComparisonCaseSensitive() {
 	public void updatePostgresSequence() {
 		dao.updatePostgresSequence();
 	}
-	
+
+	@Override
+	public List<String> getSerializerWhitelistTypes() {
+		List<String> whitelistTypes = new ArrayList<>();
+		List<Class<?>> hierarchyTypes = getSerializerDefaultWhitelistHierarchyTypes();
+		for (Class<?> hierarchyType: hierarchyTypes) {
+			whitelistTypes.add(GP_SERIALIZER_WHITELIST_HIERARCHY_TYPES_PREFIX + hierarchyType.getName());
+		}
+
+		List<GlobalProperty> gpTypes = getGlobalPropertiesBySuffix(
+			AdministrationService.GP_SUFFIX_SERIALIZER_WHITELIST_TYPES);
+		for (GlobalProperty gpType: gpTypes) {
+			String[] types = gpType.getPropertyValue().split(",");
+			for (String type: types) {
+				if(!StringUtils.isBlank(type)) {
+					whitelistTypes.add(type.trim());
+				}
+			}
+		}
+
+		return whitelistTypes;
+	}
+	public static List<Class<?>> getSerializerDefaultWhitelistHierarchyTypes() {
+		List<Class<?>> types = Arrays.asList(OpenmrsObject.class, OpenmrsMetadata.class, OpenmrsData.class, 
+			CustomDatatype.class, SingleCustomValue.class, CustomValueDescriptor.class, Customizable.class,
+			LayoutTemplate.class, LayoutSupport.class, ComplexData.class, PresentationMessage.class,
+			PersonMergeLogData.class);
+		return types;
+	}
 }
diff --git a/api/src/main/java/org/openmrs/serialization/SimpleXStreamSerializer.java b/api/src/main/java/org/openmrs/serialization/SimpleXStreamSerializer.java
index c1489ec4d85c..2a8675d6a0b1 100644
--- a/api/src/main/java/org/openmrs/serialization/SimpleXStreamSerializer.java
+++ b/api/src/main/java/org/openmrs/serialization/SimpleXStreamSerializer.java
@@ -19,6 +19,14 @@
 import com.thoughtworks.xstream.converters.extended.DynamicProxyConverter;
 import com.thoughtworks.xstream.io.HierarchicalStreamReader;
 import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
+import org.openmrs.api.AdministrationService;
+import org.openmrs.api.impl.AdministrationServiceImpl;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Component;
+
+import java.util.List;
 
 /**
  * This serializer uses the xstream library to serialize and deserialize objects.
@@ -40,10 +48,16 @@
  * </code>
  *
  */
+@Component("simpleXStreamSerializer")
 public class SimpleXStreamSerializer implements OpenmrsSerializer {
+
+	protected static final Logger log = LoggerFactory.getLogger(SimpleXStreamSerializer.class);
+	
+	private volatile XStream xstream;
 	
-	// cached xstream object
-	public XStream xstream = null;
+	private final XStream customXStream;
+	
+	private AdministrationService adminService;
 	
 	/**
 	 * Default Constructor
@@ -51,28 +65,83 @@ public class SimpleXStreamSerializer implements OpenmrsSerializer {
 	 * @throws SerializationException
 	 */
 	public SimpleXStreamSerializer() throws SerializationException {
-		this(null);
+		this(null, null);
 	}
-	
+
 	/**
-	 * Constructor that takes a custom XStream object
-	 * @param customXstream
+	 * Constructor that takes a custom XStream object. 
+	 * 
+	 * Please note that it is deprecated since it now requires AdministrationService to fully configure
+	 * whitelists defined via GPs.
+	 * 
+	 * @deprecated since 2.7.0, 2.6.2, 2.5.13 use SimpleXStreamSerializer(XStream, AdministrationService)
+	 * @param customXStream
 	 * @throws SerializationException
 	 */
-	public SimpleXStreamSerializer(XStream customXstream) throws SerializationException {
-		if (customXstream == null) {
-			
-			xstream = new XStream();
-			
+	public SimpleXStreamSerializer(XStream customXStream) throws SerializationException {
+		this(customXStream, null);
+	}
+	
+	public SimpleXStreamSerializer(XStream customXStream, AdministrationService adminService) throws SerializationException {
+		this.customXStream = customXStream;
+		this.adminService = adminService;
+	}
+	
+	@Autowired
+	public SimpleXStreamSerializer(AdministrationService adminService) {
+		this.customXStream = null;
+		this.adminService = adminService;
+	}
+
+	/**
+	 * Setups XStream security using AdministrationService.getSerializerWhitelistTypes()
+	 * 
+	 * @since 2.7.0, 2.6.2, 2.5.13 
+	 * @param newXStream
+	 * @param adminService
+	 */
+	public static void setupXStreamSecurity(XStream newXStream, AdministrationService adminService) {
+		if (adminService != null) {
+			List<String> serializerWhitelistTypes = adminService.getSerializerWhitelistTypes();
+			int prefixLength = AdministrationService.GP_SERIALIZER_WHITELIST_HIERARCHY_TYPES_PREFIX.length();
+			for (String type: serializerWhitelistTypes) {
+				if (type.startsWith(AdministrationService.GP_SERIALIZER_WHITELIST_HIERARCHY_TYPES_PREFIX)) {
+					try {
+						Class<?> aClass = Class.forName(type.substring(prefixLength));
+						newXStream.allowTypeHierarchy(aClass);
+					} catch (ClassNotFoundException e) {
+						log.warn("XStream serializer not configured to whitelist hierarchy of " + type, e);
+					}
+				} else if (type.contains("*")) {
+					newXStream.allowTypesByWildcard(new String[] {type});
+				} else {
+					newXStream.allowTypes(new String[] {type});
+				}
+			}
 		} else {
-			this.xstream = customXstream;
+			log.warn("XStream serializer not configured with whitelists defined in GPs suffixed " +
+				"with '.serializer.whitelist.types' due to adminService not being set.");
+			List<Class<?>> types = AdministrationServiceImpl.getSerializerDefaultWhitelistHierarchyTypes();
+			for (Class<?> type: types) {
+				newXStream.allowTypeHierarchy(type);
+			}
 		}
-		xstream.registerConverter(new OpenmrsDynamicProxyConverter(), XStream.PRIORITY_VERY_HIGH);
-		
-		//this is added to read the prior simpleframework-serialized values.
-		// TODO find a better way to do this.
-		this.xstream.useAttributeFor(ImplementationId.class, "implementationId");
+	}
+
+	/**
+	 * Setups permissions and default attributes.
+	 *
+	 * @since 2.7.0, 2.6.2, 2.5.13 
+	 * @param newXStream
+	 */
+	public void initXStream(XStream newXStream) {
+		setupXStreamSecurity(newXStream, adminService);
 		
+		newXStream.registerConverter(new OpenmrsDynamicProxyConverter(), XStream.PRIORITY_VERY_HIGH);
+
+		//This is added to read the prior simpleframework-serialized values.
+		//TODO: find a better way to do this.
+		newXStream.useAttributeFor(ImplementationId.class, "implementationId");
 	}
 	
 	/**
@@ -81,6 +150,15 @@ public SimpleXStreamSerializer(XStream customXstream) throws SerializationExcept
 	 * @return xstream can be configured by module
 	 */
 	public XStream getXstream() {
+		if (xstream == null) {
+			//Lazy-init so that GPs are completely populated for initXStream
+			XStream newXStream = customXStream;
+			if (newXStream == null) {	
+				newXStream = new XStream();
+			}
+			initXStream(newXStream);
+			xstream = newXStream;
+		}
 		return xstream;
 	}
 	
@@ -90,21 +168,23 @@ public XStream getXstream() {
 	 */
 	@Override
 	public String serialize(Object o) throws SerializationException {
-		
-		return xstream.toXML(o);
+		return getXstream().toXML(o);
 	}
 	
 	/**
 	 * @see OpenmrsSerializer#deserialize(String, Class)
 	 * <strong>Should</strong> not deserialize proxies
 	 * <strong>Should</strong> ignore entities
+	 * <strong>Should</strong> not deserialize classes that are not whitelisted
+	 * <strong>Should</strong> deserialize whitelisted packages
+	 * <strong>Should</strong> deserialize whitelisted classes and packages
+	 * <strong>Should</strong> deserialize whitelisted hierarchies
 	 */
 	@Override
 	@SuppressWarnings("unchecked")
 	public <T> T deserialize(String serializedObject, Class<? extends T> clazz) throws SerializationException {
-		
 		try {
-			return (T) xstream.fromXML(serializedObject);
+			return (T) getXstream().fromXML(serializedObject);
 		}
 		catch (XStreamException e) {
 			throw new SerializationException("Unable to deserialize class: " + clazz.getName(), e);
diff --git a/api/src/main/resources/applicationContext-service.xml b/api/src/main/resources/applicationContext-service.xml
index 790b0d3b3136..d3912a3dd7c6 100644
--- a/api/src/main/resources/applicationContext-service.xml
+++ b/api/src/main/resources/applicationContext-service.xml
@@ -324,7 +324,7 @@
 	<bean id="serializationServiceTarget" class="org.openmrs.api.impl.SerializationServiceImpl">
 		<property name="serializers">
 			<list>
-				<bean class="org.openmrs.serialization.SimpleXStreamSerializer"/>
+				<ref bean="simpleXStreamSerializer" />
 			</list>
 		</property>
 	</bean>
diff --git a/api/src/test/java/org/openmrs/api/AdministrationServiceTest.java b/api/src/test/java/org/openmrs/api/AdministrationServiceTest.java
index 9227815970ea..92e12ce4c796 100644
--- a/api/src/test/java/org/openmrs/api/AdministrationServiceTest.java
+++ b/api/src/test/java/org/openmrs/api/AdministrationServiceTest.java
@@ -10,10 +10,16 @@
 package org.openmrs.api;
 
 import static org.hamcrest.CoreMatchers.containsString;
+import static org.hamcrest.CoreMatchers.equalTo;
 import static org.hamcrest.CoreMatchers.hasItem;
+import static org.hamcrest.CoreMatchers.hasItems;
+import static org.hamcrest.CoreMatchers.is;
 import static org.hamcrest.CoreMatchers.not;
 import static org.hamcrest.CoreMatchers.nullValue;
 import static org.hamcrest.MatcherAssert.assertThat;
+import static org.hamcrest.Matchers.contains;
+import static org.hamcrest.Matchers.containsInAnyOrder;
+import static org.hamcrest.Matchers.emptyIterable;
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertFalse;
 import static org.junit.jupiter.api.Assertions.assertNotNull;
@@ -23,6 +29,7 @@
 import static org.mockito.Mockito.mock;
 
 import java.util.ArrayList;
+import java.util.Arrays;
 import java.util.Date;
 import java.util.List;
 import java.util.Locale;
@@ -1106,4 +1113,51 @@ private Cache.ValueWrapper getCacheForCurrentUser(){
 	private List<Locale> getCachedSearchLocalesForCurrentUser() {
 		return (List<Locale>) getCacheForCurrentUser().get();
 	}
+
+	@Test
+	public void getSerializerWhitelistTypes_shouldReturnPackagesAndIndividualClassesDefinedInGPS() {
+		//given
+		adminService.saveGlobalProperty(
+			new GlobalProperty("reporting.serializer.whitelist.types", 
+				"org.hibernate.*, org.hibernate.mapping.**"));
+		adminService.saveGlobalProperty(
+			new GlobalProperty("serialization.xstream.serializer.whitelist.types",
+				"org.hibernate.mapping.Column, org.hibernate.mapping.**"));
+
+		//when
+		List<String> serializerWhitelistTypes = adminService.getSerializerWhitelistTypes();
+
+		//then
+		assertThat(serializerWhitelistTypes, containsInAnyOrder("org.hibernate.*", "org.hibernate.mapping.**", 
+			"org.hibernate.mapping.Column", "org.hibernate.mapping.**", "hierarchyOf:org.openmrs.OpenmrsObject", 
+			"hierarchyOf:org.openmrs.OpenmrsMetadata", "hierarchyOf:org.openmrs.OpenmrsData", 
+			"hierarchyOf:org.openmrs.customdatatype.CustomDatatype", 
+			"hierarchyOf:org.openmrs.customdatatype.SingleCustomValue", 
+			"hierarchyOf:org.openmrs.customdatatype.CustomValueDescriptor", 
+			"hierarchyOf:org.openmrs.customdatatype.Customizable", "hierarchyOf:org.openmrs.layout.LayoutTemplate", 
+			"hierarchyOf:org.openmrs.layout.LayoutSupport", "hierarchyOf:org.openmrs.obs.ComplexData", 
+			"hierarchyOf:org.openmrs.messagesource.PresentationMessage", 
+			"hierarchyOf:org.openmrs.person.PersonMergeLogData"));
+	}
+
+	@Test
+	public void getSerializerWhitelistTypes_shouldReturnDefaultCommonClassesIfNoGPS() {
+		//given
+		List<GlobalProperty> gps = adminService.getGlobalPropertiesByPrefix(".serializer.whitelist.types");
+		assertThat(gps, is(emptyIterable()));
+		
+		//when
+		List<String> serializerWhitelistTypes = adminService.getSerializerWhitelistTypes();
+
+		//then
+		assertThat(serializerWhitelistTypes, containsInAnyOrder("hierarchyOf:org.openmrs.OpenmrsObject",
+			"hierarchyOf:org.openmrs.OpenmrsMetadata", "hierarchyOf:org.openmrs.OpenmrsData",
+			"hierarchyOf:org.openmrs.customdatatype.CustomDatatype",
+			"hierarchyOf:org.openmrs.customdatatype.SingleCustomValue",
+			"hierarchyOf:org.openmrs.customdatatype.CustomValueDescriptor",
+			"hierarchyOf:org.openmrs.customdatatype.Customizable", "hierarchyOf:org.openmrs.layout.LayoutTemplate",
+			"hierarchyOf:org.openmrs.layout.LayoutSupport", "hierarchyOf:org.openmrs.obs.ComplexData",
+			"hierarchyOf:org.openmrs.messagesource.PresentationMessage",
+			"hierarchyOf:org.openmrs.person.PersonMergeLogData"));
+	}
 }
diff --git a/api/src/test/java/org/openmrs/serialization/SimpleXStreamSerializerTest.java b/api/src/test/java/org/openmrs/serialization/SimpleXStreamSerializerTest.java
index 1e901ef1de67..7988192eac19 100644
--- a/api/src/test/java/org/openmrs/serialization/SimpleXStreamSerializerTest.java
+++ b/api/src/test/java/org/openmrs/serialization/SimpleXStreamSerializerTest.java
@@ -12,20 +12,30 @@
 import static org.hamcrest.MatcherAssert.assertThat;
 import static org.hamcrest.Matchers.hasSize;
 import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
 import static org.junit.jupiter.api.Assertions.assertThrows;
 import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
 
 import java.beans.EventHandler;
 import java.lang.reflect.Proxy;
 import java.util.ArrayList;
+import java.util.Arrays;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
 
 import com.thoughtworks.xstream.XStreamException;
 import org.apache.commons.lang3.StringUtils;
+import org.hibernate.collection.internal.PersistentList;
+import org.hibernate.loader.PropertyPath;
+import org.hibernate.mapping.Column;
+import org.hibernate.type.OrderedMapType;
 import org.junit.jupiter.api.Test;
+import org.openmrs.GlobalProperty;
 import org.openmrs.OpenmrsObject;
+import org.openmrs.api.AdministrationService;
 
 public class SimpleXStreamSerializerTest {
 	
@@ -77,7 +87,9 @@ public void deserialize_shouldDeserializeStringToClassInstance() throws Serializ
 		        + "      <int>30</int>\n" + "      <string>bar</string>\n" + "    </entry>\n" + "  </attributeMap>\n"
 		        + "</org.openmrs.serialization.Foo>";
 		
-		OpenmrsSerializer serializer = new SimpleXStreamSerializer();
+		SimpleXStreamSerializer serializer = new SimpleXStreamSerializer();
+		
+		serializer.getXstream().allowTypeHierarchy(Foo.class);
 		
 		Foo foo = serializer.deserialize(serializedFoo, Foo.class);
 		
@@ -133,4 +145,79 @@ public void serialize_shouldNotSerializeProxies() throws SerializationException
 		Object proxy = Proxy.newProxyInstance(this.getClass().getClassLoader(), new Class[] { OpenmrsObject.class }, h);
 		assertThrows(XStreamException.class, () -> new SimpleXStreamSerializer().serialize(proxy));
 	}
+
+	/**
+	 * @throws SerializationException
+	 * @see SimpleXStreamSerializer#deserialize(String,Class)
+	 */
+	@Test
+	public void deserialize_shouldNotDeserializeClassesThatAreNotWhitelisted() throws SerializationException {
+		//given
+		AdministrationService adminService = mock(AdministrationService.class);
+		when(adminService.getSerializerWhitelistTypes()).thenReturn(Arrays.asList("org.hibernate.*"));
+		SimpleXStreamSerializer serializer = new SimpleXStreamSerializer(adminService);
+		Column column = new Column();
+		String columnXml = serializer.serialize(column);
+		
+		//when/then
+		assertThrows(SerializationException.class, () -> serializer.deserialize(columnXml, Column.class));
+		assertThrows(SerializationException.class, () -> new SimpleXStreamSerializer().deserialize(columnXml, Column.class));
+	}
+
+	/**
+	 * @throws SerializationException
+	 * @see SimpleXStreamSerializer#deserialize(String,Class)
+	 */
+	@Test
+	public void deserialize_shouldDeserializeWhitelistedPackages() throws SerializationException {
+		//given
+		Column column = new Column();
+		AdministrationService adminService = mock(AdministrationService.class);
+		when(adminService.getSerializerWhitelistTypes()).thenReturn(Arrays.asList("org.hibernate.**"));
+		SimpleXStreamSerializer serializer = new SimpleXStreamSerializer(adminService);
+		
+		String columnXml = serializer.serialize(column);
+		String propertyPath = serializer.serialize(new PropertyPath());
+		
+		//when/then
+		assertNotNull(serializer.deserialize(columnXml, Column.class));
+		assertNotNull(serializer.deserialize(propertyPath, PropertyPath.class));
+	}
+
+	/**
+	 * @throws SerializationException
+	 * @see SimpleXStreamSerializer#deserialize(String,Class)
+	 */
+	@Test
+	public void deserialize_shouldDeserializeWhitelistedClassesAndPackages() throws SerializationException {
+		//given
+		Column column = new Column();
+		AdministrationService adminService = mock(AdministrationService.class);
+		when(adminService.getSerializerWhitelistTypes()).thenReturn(Arrays.asList("org.hibernate.loader.PropertyPath", 
+				"org.hibernate.mapping.*", "org.hibernate.collection.**"));
+		SimpleXStreamSerializer serializer = new SimpleXStreamSerializer(adminService);
+		String columnXml = serializer.serialize(column);
+		String propertyPath = serializer.serialize(new PropertyPath());
+		String persistentList = serializer.serialize(new PersistentList());
+		String orderedMapType = serializer.serialize(new OrderedMapType("role", "ref"));
+		
+		//when/then
+		assertNotNull(serializer.deserialize(columnXml, Column.class));
+		assertNotNull(serializer.deserialize(propertyPath, PropertyPath.class));
+		assertNotNull(serializer.deserialize(persistentList, PersistentList.class));
+		assertThrows(SerializationException.class, () -> serializer.deserialize(orderedMapType, OrderedMapType.class));
+	}
+
+	@Test
+	public void deserialize_shouldDeserializeWhitelistedHierarchies() throws SerializationException {
+		//given
+		AdministrationService adminService = mock(AdministrationService.class);
+		when(adminService.getSerializerWhitelistTypes()).thenReturn(Arrays.asList(
+			"hierarchyOf:org.hibernate.type.MapType"));
+		SimpleXStreamSerializer serializer = new SimpleXStreamSerializer(adminService);
+		String orderedMapType = serializer.serialize(new OrderedMapType("role", "ref"));
+
+		//when/then
+		assertNotNull(serializer.deserialize(orderedMapType, OrderedMapType.class));
+	}
 }
diff --git a/pom.xml b/pom.xml
index 90b408915b6a..0ffc9a924349 100644
--- a/pom.xml
+++ b/pom.xml
@@ -361,7 +361,7 @@
 			<dependency>
 				<groupId>com.thoughtworks.xstream</groupId>
 				<artifactId>xstream</artifactId>
-				<version>1.4.17</version>
+				<version>1.4.20</version>
 			</dependency>
 			<dependency>
 				<groupId>javax.mail</groupId>

From f560cd83659eddb29dc2e398842f76bb467d4c4d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 7 Aug 2024 22:08:05 +0300
Subject: [PATCH 078/163] maven(deps): bump org.apache.commons:commons-lang3
 from 3.15.0 to 3.16.0 (#4707)

Bumps org.apache.commons:commons-lang3 from 3.15.0 to 3.16.0.

---
updated-dependencies:
- dependency-name: org.apache.commons:commons-lang3
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 0ffc9a924349..b8e4010e2ef5 100644
--- a/pom.xml
+++ b/pom.xml
@@ -177,7 +177,7 @@
 			<dependency>
 				<groupId>org.apache.commons</groupId>
 				<artifactId>commons-lang3</artifactId>
-				<version>3.15.0</version>
+				<version>3.16.0</version>
 			</dependency>
 			<dependency>
 				<groupId>org.springframework</groupId>

From d1aae84266a86df7b7dc8cc27ef826c6143bb6e8 Mon Sep 17 00:00:00 2001
From: Ian <52504170+ibacher@users.noreply.github.com>
Date: Fri, 9 Aug 2024 14:34:33 -0400
Subject: [PATCH 079/163] Do not append spaces when creating EXTRA_PROPERTIES

---
 startup-init.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/startup-init.sh b/startup-init.sh
index e6e8deea890f..f475648b728f 100644
--- a/startup-init.sh
+++ b/startup-init.sh
@@ -151,7 +151,7 @@ if [[ -n "${EXTRA_VARS+x}" ]]; then
 	  var=$(echo "${i#OMRS_EXTRA_}" | tr [:upper:] [:lower:])
 	  var=${var//_/.}
 	  var=${var//../_}
-	  EXTRA_PROPERTIES+="${var}=${!i} \n"
+	  EXTRA_PROPERTIES+="${var}=${!i}\n"
 	done
 	
 	echo -e "$EXTRA_PROPERTIES" >> "$OMRS_SERVER_PROPERTIES_FILE"

From 78b573cac2d5d7548404a63999f0ef3c2d3a0b86 Mon Sep 17 00:00:00 2001
From: rkorytkowski <rafal.korytkowski@gmail.com>
Date: Wed, 14 Aug 2024 12:39:01 +0200
Subject: [PATCH 080/163] TRUNK-6258: Fix privilege checks for DatabaseUpdater

(cherry picked from commit 61634fbb8d197754f78ebcf04f2c935bd6f8b56e)
---
 api/src/main/java/org/openmrs/util/DatabaseUpdater.java | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/api/src/main/java/org/openmrs/util/DatabaseUpdater.java b/api/src/main/java/org/openmrs/util/DatabaseUpdater.java
index 101850fcbf4b..9b2aff606b27 100644
--- a/api/src/main/java/org/openmrs/util/DatabaseUpdater.java
+++ b/api/src/main/java/org/openmrs/util/DatabaseUpdater.java
@@ -37,7 +37,6 @@
 import liquibase.resource.ResourceAccessor;
 import liquibase.ui.LoggerUIService;
 import org.apache.commons.io.IOUtils;
-import org.openmrs.annotation.Authorized;
 import org.openmrs.api.context.Context;
 import org.openmrs.liquibase.ChangeLogDetective;
 import org.openmrs.liquibase.ChangeLogVersionFinder;
@@ -602,8 +601,8 @@ public void setId(String id) {
 	 * 
 	 * @return list of change sets that both have and haven't been run
 	 */
-	@Authorized(PrivilegeConstants.GET_DATABASE_CHANGES)
 	public static List<OpenMRSChangeSet> getDatabaseChanges() throws Exception {
+		Context.requirePrivilege(PrivilegeConstants.GET_DATABASE_CHANGES);
 		List<OpenMRSChangeSet> result = new ArrayList<>();
 		
 		String initialSnapshotVersion = changeLogDetective.getInitialLiquibaseSnapshotVersion(CONTEXT,
@@ -651,8 +650,8 @@ public static List<OpenMRSChangeSet> getDatabaseChanges() throws Exception {
 	 * @param liquibaseProvider provides access to a Liquibase instance
 	 * @return list of change sets that were not run yet.
 	 */
-	@Authorized(PrivilegeConstants.GET_DATABASE_CHANGES)
 	public static List<OpenMRSChangeSet> getUnrunDatabaseChanges(LiquibaseProvider liquibaseProvider) throws Exception {
+		Context.requirePrivilege(PrivilegeConstants.GET_DATABASE_CHANGES);
 		String initialSnapshotVersion = changeLogDetective.getInitialLiquibaseSnapshotVersion(CONTEXT, liquibaseProvider);
 		log.debug("initial snapshot version is '{}'", initialSnapshotVersion);
 		
@@ -674,8 +673,8 @@ public static List<OpenMRSChangeSet> getUnrunDatabaseChanges(LiquibaseProvider l
 	 * @param changeLogFilenames the filenames of all files to search for unrun changesets
 	 * @return list of change sets
 	 */
-	@Authorized(PrivilegeConstants.GET_DATABASE_CHANGES)
 	public static List<OpenMRSChangeSet> getUnrunDatabaseChanges(String... changeLogFilenames) {
+		Context.requirePrivilege(PrivilegeConstants.GET_DATABASE_CHANGES);
 		log.debug("looking for un-run change sets in '{}'", Arrays.toString(changeLogFilenames));
 		
 		Database database = null;

From 0b8035be0c39b8254929ac59bae4691f9f244353 Mon Sep 17 00:00:00 2001
From: rkorytkowski <rafal.korytkowski@gmail.com>
Date: Wed, 14 Aug 2024 13:21:52 +0200
Subject: [PATCH 081/163] TRUNK-6258: Fix tests

---
 .../main/java/org/openmrs/util/DatabaseUpdater.java  | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/api/src/main/java/org/openmrs/util/DatabaseUpdater.java b/api/src/main/java/org/openmrs/util/DatabaseUpdater.java
index 9b2aff606b27..7aa7dc884c6a 100644
--- a/api/src/main/java/org/openmrs/util/DatabaseUpdater.java
+++ b/api/src/main/java/org/openmrs/util/DatabaseUpdater.java
@@ -602,7 +602,9 @@ public void setId(String id) {
 	 * @return list of change sets that both have and haven't been run
 	 */
 	public static List<OpenMRSChangeSet> getDatabaseChanges() throws Exception {
-		Context.requirePrivilege(PrivilegeConstants.GET_DATABASE_CHANGES);
+		if (Context.isSessionOpen()) { // Do not check privileges if not run in webapp context (e.g. in tests)
+			Context.requirePrivilege(PrivilegeConstants.GET_DATABASE_CHANGES);
+		}
 		List<OpenMRSChangeSet> result = new ArrayList<>();
 		
 		String initialSnapshotVersion = changeLogDetective.getInitialLiquibaseSnapshotVersion(CONTEXT,
@@ -651,7 +653,9 @@ public static List<OpenMRSChangeSet> getDatabaseChanges() throws Exception {
 	 * @return list of change sets that were not run yet.
 	 */
 	public static List<OpenMRSChangeSet> getUnrunDatabaseChanges(LiquibaseProvider liquibaseProvider) throws Exception {
-		Context.requirePrivilege(PrivilegeConstants.GET_DATABASE_CHANGES);
+		if (Context.isSessionOpen()) { // Do not check privileges if not run in webapp context (e.g. in tests)
+			Context.requirePrivilege(PrivilegeConstants.GET_DATABASE_CHANGES);
+		}
 		String initialSnapshotVersion = changeLogDetective.getInitialLiquibaseSnapshotVersion(CONTEXT, liquibaseProvider);
 		log.debug("initial snapshot version is '{}'", initialSnapshotVersion);
 		
@@ -674,7 +678,9 @@ public static List<OpenMRSChangeSet> getUnrunDatabaseChanges(LiquibaseProvider l
 	 * @return list of change sets
 	 */
 	public static List<OpenMRSChangeSet> getUnrunDatabaseChanges(String... changeLogFilenames) {
-		Context.requirePrivilege(PrivilegeConstants.GET_DATABASE_CHANGES);
+		if (Context.isSessionOpen()) { // Do not check privileges if not run in webapp context (e.g. in tests)
+			Context.requirePrivilege(PrivilegeConstants.GET_DATABASE_CHANGES);
+		}
 		log.debug("looking for un-run change sets in '{}'", Arrays.toString(changeLogFilenames));
 		
 		Database database = null;

From 02149b3b950f6d9e5400fdd13cb90141554471bb Mon Sep 17 00:00:00 2001
From: Ian <52504170+ibacher@users.noreply.github.com>
Date: Wed, 14 Aug 2024 15:02:46 -0400
Subject: [PATCH 082/163] Remove reference to local m2 files

---
 docker-compose.override.yml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docker-compose.override.yml b/docker-compose.override.yml
index 17d70db434c1..7b8e4e422fd9 100644
--- a/docker-compose.override.yml
+++ b/docker-compose.override.yml
@@ -35,6 +35,5 @@ services:
             OMRS_BUILD_GOALS: ${OMRS_BUILD_GOALS:-}
             OMRS_BUILD_ARGS: ${OMRS_BUILD_ARGS:-}
         volumes:
-            - ~/.m2:/root/.m2
             - ./:/openmrs_core
         restart: "no"

From 3e7df3dcc42ae0c60b7dbdc5c72c2d39ace561fd Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 15 Aug 2024 14:16:45 +0300
Subject: [PATCH 083/163] maven(deps): bump junitVersion from 5.10.3 to 5.11.0
 (#4715)

Bumps `junitVersion` from 5.10.3 to 5.11.0.

Updates `org.junit.jupiter:junit-jupiter-api` from 5.10.3 to 5.11.0
- [Release notes](https://github.com/junit-team/junit5/releases)
- [Commits](https://github.com/junit-team/junit5/compare/r5.10.3...r5.11.0)

Updates `org.junit.jupiter:junit-jupiter-engine` from 5.10.3 to 5.11.0
- [Release notes](https://github.com/junit-team/junit5/releases)
- [Commits](https://github.com/junit-team/junit5/compare/r5.10.3...r5.11.0)

Updates `org.junit.jupiter:junit-jupiter-params` from 5.10.3 to 5.11.0
- [Release notes](https://github.com/junit-team/junit5/releases)
- [Commits](https://github.com/junit-team/junit5/compare/r5.10.3...r5.11.0)

Updates `org.junit.vintage:junit-vintage-engine` from 5.10.3 to 5.11.0
- [Release notes](https://github.com/junit-team/junit5/releases)
- [Commits](https://github.com/junit-team/junit5/compare/r5.10.3...r5.11.0)

---
updated-dependencies:
- dependency-name: org.junit.jupiter:junit-jupiter-api
  dependency-type: direct:development
  update-type: version-update:semver-minor
- dependency-name: org.junit.jupiter:junit-jupiter-engine
  dependency-type: direct:production
  update-type: version-update:semver-minor
- dependency-name: org.junit.jupiter:junit-jupiter-params
  dependency-type: direct:production
  update-type: version-update:semver-minor
- dependency-name: org.junit.vintage:junit-vintage-engine
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index b8e4010e2ef5..7650f292f0df 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1217,7 +1217,7 @@
 		<luceneVersion>5.5.5</luceneVersion>
 		<aspectjVersion>1.9.22.1</aspectjVersion>
 		<jacksonVersion>2.17.2</jacksonVersion>
-		<junitVersion>5.10.3</junitVersion>
+		<junitVersion>5.11.0</junitVersion>
 		<mockitoVersion>3.12.4</mockitoVersion>
 		<hamcrestVersion>3.0</hamcrestVersion>
 

From fe8ebe1ede53c1373b31512a74f36eba3f71f68e Mon Sep 17 00:00:00 2001
From: Mark Goodrich <mgoodrich@pih.org>
Date: Thu, 15 Aug 2024 12:06:06 -0400
Subject: [PATCH 084/163] TRUNK-6247: Merging Patients should not copy Patient
 Programs on "losing" patients (#4703)

---
 .../openmrs/api/impl/PatientServiceImpl.java  |  9 ++--
 .../openmrs/person/PersonMergeLogData.java    | 23 ++++++++++
 .../org/openmrs/api/PatientServiceTest.java   | 46 ++++++++++++-------
 .../org/openmrs/api/PersonServiceTest.java    |  2 +-
 4 files changed, 57 insertions(+), 23 deletions(-)

diff --git a/api/src/main/java/org/openmrs/api/impl/PatientServiceImpl.java b/api/src/main/java/org/openmrs/api/impl/PatientServiceImpl.java
index af1f5d203875..e0f2a0399f21 100644
--- a/api/src/main/java/org/openmrs/api/impl/PatientServiceImpl.java
+++ b/api/src/main/java/org/openmrs/api/impl/PatientServiceImpl.java
@@ -630,11 +630,10 @@ private void mergeProgramEnrolments(Patient preferred, Patient notPreferred, Per
 		ProgramWorkflowService programService = Context.getProgramWorkflowService();
 		for (PatientProgram pp : programService.getPatientPrograms(notPreferred, null, null, null, null, null, false)) {
 			if (!pp.getVoided()) {
-				PatientProgram enroll = pp.copy();
-				enroll.setPatient(preferred);
-				log.debug("Copying patientProgram {} to {}", pp.getPatientProgramId(), preferred.getPatientId());
-				PatientProgram persisted = programService.savePatientProgram(enroll);
-				mergedData.addCreatedProgram(persisted.getUuid());
+				pp.setPatient(preferred);
+				log.debug("Moving patientProgram {} to {}", pp.getPatientProgramId(), preferred.getPatientId());
+				PatientProgram persisted = programService.savePatientProgram(pp);
+				mergedData.addMovedProgram(persisted.getUuid());
 			}
 		}
 	}
diff --git a/api/src/main/java/org/openmrs/person/PersonMergeLogData.java b/api/src/main/java/org/openmrs/person/PersonMergeLogData.java
index f53efe1f5408..bacffb0cd08d 100644
--- a/api/src/main/java/org/openmrs/person/PersonMergeLogData.java
+++ b/api/src/main/java/org/openmrs/person/PersonMergeLogData.java
@@ -39,8 +39,15 @@ public class PersonMergeLogData {
 	
 	/**
 	 * List of UUIDs of patient programs copied from non-preferred to preferred
+	 * (Deprecated in 2.6.8 and 2.7.0+, as we now move programs)
 	 */
+	@Deprecated
 	private List<String> createdPrograms;
+
+	/**
+	 * List of UUIDs of patient programs moved from non-preferred to preferred
+	 */
+	private List<String> movedPrograms;
 	
 	/**
 	 * List of UUIDs of voided relationships
@@ -143,16 +150,29 @@ public void addMovedEncounter(String uuid) {
 		movedEncounters.add(uuid);
 	}
 	
+	@Deprecated
 	public List<String> getCreatedPrograms() {
 		return createdPrograms;
 	}
 	
+	@Deprecated
 	public void addCreatedProgram(String uuid) {
 		if (createdPrograms == null) {
 			createdPrograms = new ArrayList<>();
 		}
 		createdPrograms.add(uuid);
 	}
+
+	public List<String> getMovedPrograms() {
+		return movedPrograms;
+	}
+
+	public void addMovedProgram(String uuid) {
+		if (movedPrograms == null) {
+			movedPrograms = new ArrayList<>();
+		}
+		movedPrograms.add(uuid);
+	}
 	
 	public List<String> getVoidedRelationships() {
 		return voidedRelationships;
@@ -326,6 +346,9 @@ public int computeHashValue() {
 		if (getCreatedPrograms() != null) {
 			str += getCreatedPrograms().toString();
 		}
+		if (getMovedPrograms() != null) {
+			str += getMovedPrograms().toString();
+		}
 		if (getCreatedRelationships() != null) {
 			str += getCreatedRelationships().toString();
 		}
diff --git a/api/src/test/java/org/openmrs/api/PatientServiceTest.java b/api/src/test/java/org/openmrs/api/PatientServiceTest.java
index ced6ec5e5e26..45ef5c0ee78e 100644
--- a/api/src/test/java/org/openmrs/api/PatientServiceTest.java
+++ b/api/src/test/java/org/openmrs/api/PatientServiceTest.java
@@ -2350,32 +2350,44 @@ public void mergePatients_shouldAuditCreatedNames() throws Exception {
 	/**
 	 * @see PatientService#mergePatients(Patient,Patient)
 	 */
+
 	@Test
-	public void mergePatients_shouldAuditCreatedPatientPrograms() throws Exception {
+	public void mergePatients_shouldCopyProgramsFromNonPreferredPatient() throws Exception {
 		//retrieve preferred  and notPreferredPatient patient
 		Patient preferred = patientService.getPatient(999);
 		Patient notPreferred = patientService.getPatient(2);
 		voidOrders(Collections.singleton(notPreferred));
-		
+
 		//retrieve program for notProferred patient
-		PatientProgram program = Context.getProgramWorkflowService()
-		        .getPatientPrograms(notPreferred, null, null, null, null, null, false).get(0);
+		List<PatientProgram> nonPreferredPrograms = Context.getProgramWorkflowService()
+			.getPatientPrograms(notPreferred, null, null, null, null, null, false);
+
+		//retrieve program for preferred patient
+		List<PatientProgram> preferredPrograms = Context.getProgramWorkflowService()
+			.getPatientPrograms(preferred, null, null, null, null, null, false);
+
 		
-		//merge the two patients and retrieve the audit object
+		assertEquals(2, nonPreferredPrograms.size());  // sanity check, non preferred patient had 2 programs at time of writing test
+		assertEquals(0, preferredPrograms.size());  // sanity check, preferred patient had 0 programs at time of writing test
+		
+		List<String> programUuids =  nonPreferredPrograms.stream().map(PatientProgram::getUuid).collect(Collectors.toList());
+
 		PersonMergeLog audit = mergeAndRetrieveAudit(preferred, notPreferred);
+
+		//retrieve updated program for notProferred patient
+		List<PatientProgram> updatedNonPreferredPrograms = Context.getProgramWorkflowService()
+			.getPatientPrograms(notPreferred, null, null, null, null, null, false);
+
+		//retrieve program for preferred patient
+		List<PatientProgram> updatedPreferredPrograms = Context.getProgramWorkflowService()
+			.getPatientPrograms(preferred, null, null, null, null, null, false);
 		
-		//find the UUID of the program to which the preferred patient was enrolled as a result of the merge
-		String enrolledProgramUuid = null;
-		List<PatientProgram> programs = Context.getProgramWorkflowService().getPatientPrograms(preferred, null, null, null,
-		    null, null, false);
-		for (PatientProgram p : programs) {
-			if (p.getDateCreated().equals(program.getDateCreated())) {
-				enrolledProgramUuid = p.getUuid();
-			}
-		}
-		assertNotNull("expected enrolled program was not found for the preferred patient after the merge",
-			enrolledProgramUuid);
-		assertTrue(isValueInList(enrolledProgramUuid, audit.getPersonMergeLogData().getCreatedPrograms()), "program enrollment not audited");
+		// programs should be copied from nonPreferred to preferred
+		assertEquals(0, updatedNonPreferredPrograms.size());  
+		assertEquals(2, updatedPreferredPrograms.size()); 
+		
+		assertTrue(updatedPreferredPrograms.stream().map(PatientProgram::getUuid).allMatch(programUuids::contains));
+		assertTrue(audit.getPersonMergeLogData().getMovedPrograms().stream().allMatch(programUuids::contains));
 	}
 	
 	/**
diff --git a/api/src/test/java/org/openmrs/api/PersonServiceTest.java b/api/src/test/java/org/openmrs/api/PersonServiceTest.java
index 7c5caa422fce..d0359500a066 100644
--- a/api/src/test/java/org/openmrs/api/PersonServiceTest.java
+++ b/api/src/test/java/org/openmrs/api/PersonServiceTest.java
@@ -1454,7 +1454,7 @@ private PersonMergeLog getTestPersonMergeLog() {
 		data.addCreatedIdentifier("3");
 		data.addCreatedName("4");
 		data.addCreatedOrder("5");
-		data.addCreatedProgram("6");
+		data.addMovedProgram("6");
 		data.addCreatedRelationship("7");
 		data.addMovedEncounter("8");
 		data.addMovedIndependentObservation("9");

From b479e6dde85ced44473f95503c424e37dfa0da6f Mon Sep 17 00:00:00 2001
From: Ian <52504170+ibacher@users.noreply.github.com>
Date: Thu, 15 Aug 2024 14:48:04 -0400
Subject: [PATCH 085/163] TRUNK-6261: Set the appropriate MIME-type for files
 served by initialization filter (#4717)

---
 .../org/openmrs/web/filter/StartupFilter.java | 25 ++++++++++++++++---
 1 file changed, 22 insertions(+), 3 deletions(-)

diff --git a/web/src/main/java/org/openmrs/web/filter/StartupFilter.java b/web/src/main/java/org/openmrs/web/filter/StartupFilter.java
index ef2e65df6b19..b2bd17ff1952 100644
--- a/web/src/main/java/org/openmrs/web/filter/StartupFilter.java
+++ b/web/src/main/java/org/openmrs/web/filter/StartupFilter.java
@@ -16,6 +16,7 @@
 import java.io.InputStreamReader;
 import java.lang.reflect.Field;
 import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
 import java.nio.file.Path;
 import java.nio.file.Paths;
 import java.util.Collections;
@@ -63,6 +64,7 @@
 import org.openmrs.web.filter.util.LocalizationTool;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
+import org.springframework.http.MediaType;
 
 /**
  * Abstract class used when a small wizard is needed before Spring, jsp, etc has been started up.
@@ -125,9 +127,10 @@ else if (skipFilter((HttpServletRequest) request)) {
 			if (servletPath.startsWith("/images") || servletPath.startsWith("/initfilter/scripts")) {
 				// strip out the /initfilter part
 				servletPath = servletPath.replaceFirst("/initfilter", "/WEB-INF/view");
-				// writes the actual image file path to the response
+				// writes the actual file path to the response
 				Path filePath = Paths.get(filterConfig.getServletContext().getRealPath(servletPath)).normalize();
 				Path fullFilePath = filePath;
+				
 				if (httpRequest.getPathInfo() != null) {
 					fullFilePath = fullFilePath.resolve(httpRequest.getPathInfo());
 					if (!(fullFilePath.normalize().startsWith(filePath))) {
@@ -136,8 +139,24 @@ else if (skipFilter((HttpServletRequest) request)) {
 					}
 				}
 				
-				try (InputStream imageFileInputStream = new FileInputStream(fullFilePath.normalize().toFile())) {
-					OpenmrsUtil.copyFile(imageFileInputStream, httpResponse.getOutputStream());
+				String contentType = httpRequest.getServletContext().getMimeType(fullFilePath.toString());
+				if (contentType == null || contentType.isEmpty()) {
+					try {
+						contentType = Files.probeContentType(fullFilePath);
+					} catch (IOException ignored) {}
+				}
+
+				MediaType mediaType;
+				if (contentType != null && !contentType.isEmpty()) {
+					mediaType = MediaType.parseMediaType(contentType);
+				} else {
+					mediaType = MediaType.APPLICATION_OCTET_STREAM;
+				}
+				
+				response.setContentType(mediaType.toString());
+				
+				try (InputStream fis = new FileInputStream(fullFilePath.normalize().toFile())) {
+					OpenmrsUtil.copyFile(fis, httpResponse.getOutputStream());
 				}
 				catch (FileNotFoundException e) {
 					log.error("Unable to find file: {}", filePath, e);

From 2741e8c8f876777fbf3ffc893ab72f4bf09a9c96 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 17 Aug 2024 23:09:20 +0300
Subject: [PATCH 086/163] maven(deps): bump net.bytebuddy:byte-buddy from
 1.14.18 to 1.14.19 (#4719)

Bumps [net.bytebuddy:byte-buddy](https://github.com/raphw/byte-buddy) from 1.14.18 to 1.14.19.
- [Release notes](https://github.com/raphw/byte-buddy/releases)
- [Changelog](https://github.com/raphw/byte-buddy/blob/master/release-notes.md)
- [Commits](https://github.com/raphw/byte-buddy/compare/byte-buddy-1.14.18...byte-buddy-1.14.19)

---
updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 7650f292f0df..7db8c99e6429 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1129,7 +1129,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy</artifactId>
-						<version>1.14.18</version>
+						<version>1.14.19</version>
 					</dependency>
 					<dependency>
 						<groupId>net.bytebuddy</groupId>

From 98e968cc4d000ebd907a206dbd458693f996c1ca Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 17 Aug 2024 23:09:56 +0300
Subject: [PATCH 087/163] maven(deps): bump net.bytebuddy:byte-buddy-agent from
 1.14.18 to 1.14.19 (#4720)

Bumps [net.bytebuddy:byte-buddy-agent](https://github.com/raphw/byte-buddy) from 1.14.18 to 1.14.19.
- [Release notes](https://github.com/raphw/byte-buddy/releases)
- [Changelog](https://github.com/raphw/byte-buddy/blob/master/release-notes.md)
- [Commits](https://github.com/raphw/byte-buddy/compare/byte-buddy-1.14.18...byte-buddy-1.14.19)

---
updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy-agent
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 7db8c99e6429..0ffe53645846 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1134,7 +1134,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy-agent</artifactId>
-						<version>1.14.18</version>
+						<version>1.14.19</version>
 					</dependency>
 				</dependencies>
 			</dependencyManagement>

From 3063693b68bbd8d70f2a1fca7f592c459d6584f3 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 19 Aug 2024 23:23:59 +0300
Subject: [PATCH 088/163] maven(deps): bump com.google.guava:guava from
 33.2.1-jre to 33.3.0-jre (#4721)

Bumps [com.google.guava:guava](https://github.com/google/guava) from 33.2.1-jre to 33.3.0-jre.
- [Release notes](https://github.com/google/guava/releases)
- [Commits](https://github.com/google/guava/commits)

---
updated-dependencies:
- dependency-name: com.google.guava:guava
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 0ffe53645846..529498e9f806 100644
--- a/pom.xml
+++ b/pom.xml
@@ -563,7 +563,7 @@
 			<dependency>
 				<groupId>com.google.guava</groupId>
 				<artifactId>guava</artifactId>
-				<version>33.2.1-jre</version>
+				<version>33.3.0-jre</version>
 			</dependency>
 			<dependency>
 			    <groupId>jakarta.xml.bind</groupId>

From 751f66a53244bdbbc418dd2fcb777dde94cf4051 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 19 Aug 2024 23:24:52 +0300
Subject: [PATCH 089/163] maven(deps): bump
 org.apache.maven.plugins:maven-surefire-plugin (#4722)

Bumps [org.apache.maven.plugins:maven-surefire-plugin](https://github.com/apache/maven-surefire) from 3.3.1 to 3.4.0.
- [Release notes](https://github.com/apache/maven-surefire/releases)
- [Commits](https://github.com/apache/maven-surefire/compare/surefire-3.3.1...surefire-3.4.0)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-surefire-plugin
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pom.xml b/pom.xml
index 529498e9f806..2996811d95eb 100644
--- a/pom.xml
+++ b/pom.xml
@@ -603,7 +603,7 @@
 				<plugin>
 					<groupId>org.apache.maven.plugins</groupId>
 					<artifactId>maven-surefire-plugin</artifactId>
-					<version>3.3.1</version>
+					<version>3.4.0</version>
 				</plugin>
 				<plugin>
 					<groupId>org.apache.maven.plugins</groupId>
@@ -935,7 +935,7 @@
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-surefire-plugin</artifactId>
-				<version>3.3.1</version>
+				<version>3.4.0</version>
 				<configuration>
 					<failIfNoTests>false</failIfNoTests>
 					<useSystemClassLoader>false</useSystemClassLoader>

From ea178dc1acb24f80c872b2d01fc2c7cbe3c7a580 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 21 Aug 2024 02:12:56 +0300
Subject: [PATCH 090/163] maven(deps): bump org.owasp.encoder:encoder from
 1.3.0 to 1.3.1 (#4724)

Bumps [org.owasp.encoder:encoder](https://github.com/owasp/owasp-java-encoder) from 1.3.0 to 1.3.1.
- [Release notes](https://github.com/owasp/owasp-java-encoder/releases)
- [Commits](https://github.com/owasp/owasp-java-encoder/compare/v1.3.0...v1.3.1)

---
updated-dependencies:
- dependency-name: org.owasp.encoder:encoder
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 web/pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/web/pom.xml b/web/pom.xml
index 0e9e2ce38b1f..911a7c16a865 100644
--- a/web/pom.xml
+++ b/web/pom.xml
@@ -126,7 +126,7 @@
       <dependency>
          <groupId>org.owasp.encoder</groupId>
          <artifactId>encoder</artifactId>
-         <version>1.3.0</version>
+         <version>1.3.1</version>
       </dependency>
 	   <dependency>
 		   <groupId>org.apache.tomcat</groupId>

From 43b7946eafcc6280e596128c0049f510e032933c Mon Sep 17 00:00:00 2001
From: Jayasanka Weerasinghe <33048395+jayasanka-sack@users.noreply.github.com>
Date: Thu, 22 Aug 2024 15:11:03 +0100
Subject: [PATCH 091/163] TRUNK-6257: Fix visit overlapping logic and improve
 performance (#4709)

---
 .../java/org/openmrs/api/VisitService.java    |   14 +
 .../java/org/openmrs/api/db/VisitDAO.java     |   13 +
 .../api/db/hibernate/HibernateVisitDAO.java   |   61 +
 .../openmrs/api/impl/VisitServiceImpl.java    |    9 +
 .../parameter/VisitSearchCriteria.java        |  253 +
 .../parameter/VisitSearchCriteriaBuilder.java |  191 +
 .../org/openmrs/validator/VisitValidator.java |   71 +-
 api/src/main/resources/messages.properties    |    2 +-
 api/src/main/resources/messages_ar.properties |    2 +-
 api/src/main/resources/messages_de.properties |    2 +-
 api/src/main/resources/messages_el.properties |    2 +-
 api/src/main/resources/messages_hi.properties | 5500 ++++++++---------
 api/src/main/resources/messages_ht.properties |    2 +-
 api/src/main/resources/messages_hy.properties |    2 +-
 .../main/resources/messages_id_ID.properties  |    2 +-
 api/src/main/resources/messages_ku.properties |    2 +-
 api/src/main/resources/messages_lt.properties |    2 +-
 api/src/main/resources/messages_pl.properties |    2 +-
 api/src/main/resources/messages_ru.properties |    2 +-
 api/src/main/resources/messages_sw.properties |    2 +-
 api/src/main/resources/messages_te.properties |    2 +-
 .../org/openmrs/api/VisitServiceTest.java     |   10 +-
 .../java/org/openmrs/api/db/VisitDAOTest.java |    4 +-
 .../openmrs/validator/VisitValidatorTest.java |  194 +-
 .../PersonServiceTest-encountersForVisits.xml |    4 +-
 .../include/VisitServiceTest-otherVisits.xml  |   13 +-
 .../openmrs/include/standardTestDataset.xml   |    2 +-
 .../validator/include/VisitValidatorTest.xml  |    5 +-
 28 files changed, 3507 insertions(+), 2863 deletions(-)
 create mode 100644 api/src/main/java/org/openmrs/parameter/VisitSearchCriteria.java
 create mode 100644 api/src/main/java/org/openmrs/parameter/VisitSearchCriteriaBuilder.java

diff --git a/api/src/main/java/org/openmrs/api/VisitService.java b/api/src/main/java/org/openmrs/api/VisitService.java
index ae53f561e540..dc9cb22c6676 100644
--- a/api/src/main/java/org/openmrs/api/VisitService.java
+++ b/api/src/main/java/org/openmrs/api/VisitService.java
@@ -22,6 +22,7 @@
 import org.openmrs.VisitAttributeType;
 import org.openmrs.VisitType;
 import org.openmrs.annotation.Authorized;
+import org.openmrs.parameter.VisitSearchCriteria;
 import org.openmrs.util.OpenmrsConstants;
 import org.openmrs.util.PrivilegeConstants;
 
@@ -258,6 +259,19 @@ public List<Visit> getVisits(Collection<VisitType> visitTypes, Collection<Patien
 	        Date minEndDatetime, Date maxEndDatetime, Map<VisitAttributeType, Object> attributeValues,
 	        boolean includeInactive, boolean includeVoided) throws APIException;
 	
+	/**
+	 * Gets the visits matching the specified search criteria
+	 * 
+ 	 * @param visitSearchCriteria
+	 * @return
+	 * @throws APIException
+	 * 
+	 * @since 2.6.8
+	 * @since 2.7.0
+	 */	
+	@Authorized(PrivilegeConstants.GET_VISITS)
+	public List<Visit> getVisits(VisitSearchCriteria visitSearchCriteria) throws APIException;
+	
 	/**
 	 * Gets all unvoided visits for the specified patient
 	 * 
diff --git a/api/src/main/java/org/openmrs/api/db/VisitDAO.java b/api/src/main/java/org/openmrs/api/db/VisitDAO.java
index 4bd17e9b02ec..78145fe2150f 100644
--- a/api/src/main/java/org/openmrs/api/db/VisitDAO.java
+++ b/api/src/main/java/org/openmrs/api/db/VisitDAO.java
@@ -23,6 +23,7 @@
 import org.openmrs.VisitType;
 import org.openmrs.api.APIException;
 import org.openmrs.api.VisitService;
+import org.openmrs.parameter.VisitSearchCriteria;
 
 /**
  * Database access functions for visits.
@@ -113,6 +114,18 @@ public List<Visit> getVisits(Collection<VisitType> visitTypes, Collection<Patien
 	        Date minEndDatetime, Date maxEndDatetime, Map<VisitAttributeType, String> serializedAttributeValues,
 	        boolean includeInactive, boolean includeVoided) throws DAOException;
 	
+	/**
+	 * Gets the visits matching the specified search criteria
+	 * 
+	 * @param criteria the search criteria
+	 * @return a list of visits
+	 * @throws DAOException
+	 * 
+	 * @since 2.6.8
+	 * @since 2.7.0
+	 */
+	public List<Visit> getVisits(VisitSearchCriteria criteria) throws DAOException;
+	
 	/**
 	 * @see VisitService#getAllVisitAttributeTypes()
 	 */
diff --git a/api/src/main/java/org/openmrs/api/db/hibernate/HibernateVisitDAO.java b/api/src/main/java/org/openmrs/api/db/hibernate/HibernateVisitDAO.java
index 55a1e3181e53..9f75a731b694 100644
--- a/api/src/main/java/org/openmrs/api/db/hibernate/HibernateVisitDAO.java
+++ b/api/src/main/java/org/openmrs/api/db/hibernate/HibernateVisitDAO.java
@@ -31,6 +31,7 @@
 import org.openmrs.VisitType;
 import org.openmrs.api.db.DAOException;
 import org.openmrs.api.db.VisitDAO;
+import org.openmrs.parameter.VisitSearchCriteria;
 import org.springframework.transaction.annotation.Transactional;
 
 /**
@@ -240,6 +241,66 @@ public List<Visit> getVisits(Collection<VisitType> visitTypes, Collection<Patien
 
 		return visits;
 	}
+
+	/**
+	 * @see org.openmrs.api.db.VisitDAO#getVisits(org.openmrs.parameter.VisitSearchCriteria)
+	 */
+	@Override
+	public List<Visit> getVisits(VisitSearchCriteria criteria) throws DAOException {
+		Session session = sessionFactory.getCurrentSession();
+		CriteriaBuilder cb = session.getCriteriaBuilder();
+		CriteriaQuery<Visit> cq = cb.createQuery(Visit.class);
+		Root<Visit> root = cq.from(Visit.class);
+		
+		List<Predicate> predicates = new ArrayList<>();
+		
+		if (criteria.getVisitTypes() != null && !criteria.getVisitTypes().isEmpty()) {
+			predicates.add(root.get("visitType").in(criteria.getVisitTypes()));
+		}
+		if (criteria.getPatients() != null && !criteria.getPatients().isEmpty()) {
+			predicates.add(root.get("patient").in(criteria.getPatients()));
+		}
+		if (criteria.getLocations() != null && !criteria.getLocations().isEmpty()) {
+			predicates.add(root.get("location").in(criteria.getLocations()));
+		}
+		if (criteria.getIndications() != null && !criteria.getIndications().isEmpty()) {
+			predicates.add(root.get("indication").in(criteria.getIndications()));
+		}
+		if (criteria.getMinStartDatetime() != null) {
+			predicates.add(cb.greaterThanOrEqualTo(root.get("startDatetime"), criteria.getMinStartDatetime()));
+		}
+		if (criteria.getMaxStartDatetime() != null) {
+			predicates.add(cb.lessThanOrEqualTo(root.get("startDatetime"), criteria.getMaxStartDatetime()));
+		}
+		
+		if (!criteria.isIncludeInactive()) {
+			predicates.add(cb.or(cb.isNull(root.get("stopDatetime")), cb.greaterThan(root.get("stopDatetime"), new Date())));
+		} else {
+			if (criteria.getMinEndDatetime() != null) {
+				predicates.add(cb.or(cb.isNull(root.get("stopDatetime")), cb.greaterThanOrEqualTo(root.get("stopDatetime"),
+					criteria.getMinEndDatetime())));
+			}
+			if (criteria.getMaxEndDatetime() != null) {
+				predicates.add(cb.lessThanOrEqualTo(root.get("stopDatetime"), criteria.getMaxEndDatetime()));
+			}
+		}
+		
+		if (!criteria.isIncludeVoided()) {
+			predicates.add(cb.isFalse(root.get("voided")));
+		}
+		
+		cq.where(predicates.toArray(new Predicate[]{}))
+			.orderBy(cb.desc(root.get("startDatetime")), cb.desc(root.get("visitId")));
+		
+		List<Visit> visits = session.createQuery(cq).getResultList();
+		
+		if (criteria.getSerializedAttributeValues() != null) {
+			CollectionUtils.filter(visits, new AttributeMatcherPredicate<Visit, VisitAttributeType>(
+				criteria.getSerializedAttributeValues()));
+		}
+		
+		return visits;
+	}
 	
 	/**
 	 * @see org.openmrs.api.db.VisitDAO#getAllVisitAttributeTypes()
diff --git a/api/src/main/java/org/openmrs/api/impl/VisitServiceImpl.java b/api/src/main/java/org/openmrs/api/impl/VisitServiceImpl.java
index c6932f90c46c..da2e24a08559 100644
--- a/api/src/main/java/org/openmrs/api/impl/VisitServiceImpl.java
+++ b/api/src/main/java/org/openmrs/api/impl/VisitServiceImpl.java
@@ -30,6 +30,7 @@
 import org.openmrs.api.context.Context;
 import org.openmrs.api.db.VisitDAO;
 import org.openmrs.customdatatype.CustomDatatypeUtil;
+import org.openmrs.parameter.VisitSearchCriteria;
 import org.openmrs.util.OpenmrsConstants;
 import org.openmrs.util.PrivilegeConstants;
 import org.openmrs.validator.ValidateUtil;
@@ -238,6 +239,14 @@ public List<Visit> getVisits(Collection<VisitType> visitTypes, Collection<Patien
 		    minEndDatetime, maxEndDatetime, serializedAttributeValues, includeInactive, includeVoided);
 	}
 	
+	/**
+	 * @see org.openmrs.api.VisitService#getVisits(VisitSearchCriteria)
+	 */
+	@Override
+	public List<Visit> getVisits(VisitSearchCriteria visitSearchCriteria) throws APIException {
+		return dao.getVisits(visitSearchCriteria);
+	}
+	
 	/**
 	 * @see org.openmrs.api.VisitService#getVisitsByPatient(org.openmrs.Patient)
 	 */
diff --git a/api/src/main/java/org/openmrs/parameter/VisitSearchCriteria.java b/api/src/main/java/org/openmrs/parameter/VisitSearchCriteria.java
new file mode 100644
index 000000000000..658ecce335ce
--- /dev/null
+++ b/api/src/main/java/org/openmrs/parameter/VisitSearchCriteria.java
@@ -0,0 +1,253 @@
+/**
+ * This Source Code Form is subject to the terms of the Mozilla Public License,
+ * v. 2.0. If a copy of the MPL was not distributed with this file, You can
+ * obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
+ * the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
+ *
+ * Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
+ * graphic logo is a trademark of OpenMRS Inc.
+ */
+package org.openmrs.parameter;
+
+import org.openmrs.Concept;
+import org.openmrs.Location;
+import org.openmrs.Patient;
+import org.openmrs.VisitAttributeType;
+import org.openmrs.VisitType;
+
+import java.util.Collection;
+import java.util.Date;
+import java.util.Map;
+
+/**
+ * The VisitSearchCriteria class encapsulates the criteria used for searching visits in the system.
+ * It includes various fields that allow filtering visits based on different parameters such as visit type,
+ * patient, location, and date ranges. It also provides options to include or exclude inactive and voided visits.
+ * 
+ * @since 2.6.8
+ * @since 2.7.0
+ */
+public class VisitSearchCriteria {
+	
+	private Collection<VisitType> visitTypes;
+	private Collection<Patient> patients;
+	private Collection<Location> locations;
+	private Collection<Concept> indications;
+	private Date minStartDatetime;
+	private Date maxStartDatetime;
+	private Date minEndDatetime;
+	private Date maxEndDatetime;
+	private Map<VisitAttributeType, String> serializedAttributeValues;
+	private boolean includeInactive = true;
+	private boolean includeVoided = false;
+	
+	/**
+	 * Constructs a VisitSearchCriteria with the specified parameters. 
+	 * Instead of calling this constructor directly, it is recommended to use {@link VisitSearchCriteriaBuilder}.
+	 *
+	 * @param visitTypes               the types of visits to include in the search
+	 * @param patients                 the patients associated with the visits to include in the search
+	 * @param locations                the locations associated with the visits to include in the search
+	 * @param indications              the indications associated with the visits to include in the search
+	 * @param minStartDatetime         the minimum start date of visits to include in the search
+	 * @param maxStartDatetime         the maximum start date of visits to include in the search
+	 * @param minEndDatetime           the minimum end date of visits to include in the search
+	 * @param maxEndDatetime           the maximum end date of visits to include in the search
+	 * @param serializedAttributeValues a map of serialized attribute values to filter visits by
+	 * @param includeInactive          whether to include inactive visits in the search
+	 * @param includeVoided            whether to include voided visits in the search
+	 */
+	public VisitSearchCriteria(Collection<VisitType> visitTypes, Collection<Patient> patients,
+		Collection<Location> locations, Collection<Concept> indications,
+		Date minStartDatetime, Date maxStartDatetime, Date minEndDatetime,
+		Date maxEndDatetime, Map<VisitAttributeType, String> serializedAttributeValues,
+		boolean includeInactive, boolean includeVoided) {
+		this.visitTypes = visitTypes;
+		this.patients = patients;
+		this.locations = locations;
+		this.indications = indications;
+		this.minStartDatetime = minStartDatetime;
+		this.maxStartDatetime = maxStartDatetime;
+		this.minEndDatetime = minEndDatetime;
+		this.maxEndDatetime = maxEndDatetime;
+		this.serializedAttributeValues = serializedAttributeValues;
+		this.includeInactive = includeInactive;
+		this.includeVoided = includeVoided;
+	}
+	
+	/**
+	 * @return the collection of visit types included in the search criteria.
+	 */
+	public Collection<VisitType> getVisitTypes() {
+		return visitTypes;
+	}
+	
+	/**
+	 * Sets the collection of visit types to be included in the search criteria.
+	 *
+	 * @param visitTypes the collection of visit types to set.
+	 */
+	public void setVisitTypes(Collection<VisitType> visitTypes) {
+		this.visitTypes = visitTypes;
+	}
+	
+	/**
+	 * @return the collection of patients included in the search criteria.
+	 */
+	public Collection<Patient> getPatients() {
+		return patients;
+	}
+	
+	/**
+	 * Sets the collection of patients to be included in the search criteria.
+	 *
+	 * @param patients the collection of patients to set.
+	 */
+	public void setPatients(Collection<Patient> patients) {
+		this.patients = patients;
+	}
+	
+	/**
+	 * @return the collection of locations included in the search criteria.
+	 */
+	public Collection<Location> getLocations() {
+		return locations;
+	}
+	
+	/**
+	 * Sets the collection of locations to be included in the search criteria.
+	 *
+	 * @param locations the collection of locations to set.
+	 */
+	public void setLocations(Collection<Location> locations) {
+		this.locations = locations;
+	}
+	
+	/**
+	 * @return the collection of indications included in the search criteria.
+	 */
+	public Collection<Concept> getIndications() {
+		return indications;
+	}
+	
+	/**
+	 * Sets the collection of indications to be included in the search criteria.
+	 *
+	 * @param indications the collection of indications to set.
+	 */
+	public void setIndications(Collection<Concept> indications) {
+		this.indications = indications;
+	}
+	
+	/**
+	 * @return the minimum start datetime included in the search criteria.
+	 */
+	public Date getMinStartDatetime() {
+		return minStartDatetime;
+	}
+	
+	/**
+	 * Sets the minimum start datetime to be included in the search criteria.
+	 *
+	 * @param minStartDatetime the minimum start datetime to set.
+	 */
+	public void setMinStartDatetime(Date minStartDatetime) {
+		this.minStartDatetime = minStartDatetime;
+	}
+	
+	/**
+	 * @return the maximum start datetime included in the search criteria.
+	 */
+	public Date getMaxStartDatetime() {
+		return maxStartDatetime;
+	}
+	
+	/**
+	 * Sets the maximum start datetime to be included in the search criteria.
+	 *
+	 * @param maxStartDatetime the maximum start datetime to set.
+	 */
+	public void setMaxStartDatetime(Date maxStartDatetime) {
+		this.maxStartDatetime = maxStartDatetime;
+	}
+	
+	/**
+	 * @return the minimum end datetime included in the search criteria.
+	 */
+	public Date getMinEndDatetime() {
+		return minEndDatetime;
+	}
+	
+	/**
+	 * Sets the minimum end datetime to be included in the search criteria.
+	 *
+	 * @param minEndDatetime the minimum end datetime to set.
+	 */
+	public void setMinEndDatetime(Date minEndDatetime) {
+		this.minEndDatetime = minEndDatetime;
+	}
+	
+	/**
+	 * @return the maximum end datetime included in the search criteria.
+	 */
+	public Date getMaxEndDatetime() {
+		return maxEndDatetime;
+	}
+	
+	/**
+	 * Sets the maximum end datetime to be included in the search criteria.
+	 *
+	 * @param maxEndDatetime the maximum end datetime to set.
+	 */
+	public void setMaxEndDatetime(Date maxEndDatetime) {
+		this.maxEndDatetime = maxEndDatetime;
+	}
+	
+	/**
+	 * @return a map of serialized attribute values included in the search criteria.
+	 */
+	public Map<VisitAttributeType, String> getSerializedAttributeValues() {
+		return serializedAttributeValues;
+	}
+	
+	/**
+	 * Sets the map of serialized attribute values to be included in the search criteria.
+	 *
+	 * @param serializedAttributeValues the map of serialized attribute values to set.
+	 */
+	public void setSerializedAttributeValues(Map<VisitAttributeType, String> serializedAttributeValues) {
+		this.serializedAttributeValues = serializedAttributeValues;
+	}
+	
+	/**
+	 * @return true if inactive visits are included in the search criteria, false otherwise.
+	 */
+	public boolean isIncludeInactive() {
+		return includeInactive;
+	}
+	
+	/**
+	 * Sets whether inactive visits should be included in the search criteria.
+	 *
+	 * @param includeInactive true to include inactive visits, false otherwise.
+	 */
+	public void setIncludeInactive(boolean includeInactive) {
+		this.includeInactive = includeInactive;
+	}
+	
+	/**
+	 * @return true if voided visits are included in the search criteria, false otherwise.
+	 */
+	public boolean isIncludeVoided() {
+		return includeVoided;
+	}
+	
+	/**
+	 * Sets whether voided visits should be included in the search criteria.
+	 *
+	 * @param includeVoided true to include voided visits, false otherwise.
+	 */
+	public void setIncludeVoided(boolean includeVoided) {
+		this.includeVoided = includeVoided;
+	}
+}
diff --git a/api/src/main/java/org/openmrs/parameter/VisitSearchCriteriaBuilder.java b/api/src/main/java/org/openmrs/parameter/VisitSearchCriteriaBuilder.java
new file mode 100644
index 000000000000..9c2f90ac73d5
--- /dev/null
+++ b/api/src/main/java/org/openmrs/parameter/VisitSearchCriteriaBuilder.java
@@ -0,0 +1,191 @@
+/**
+ * This Source Code Form is subject to the terms of the Mozilla Public License,
+ * v. 2.0. If a copy of the MPL was not distributed with this file, You can
+ * obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
+ * the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
+ *
+ * Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
+ * graphic logo is a trademark of OpenMRS Inc.
+ */
+package org.openmrs.parameter;
+
+import org.openmrs.Concept;
+import org.openmrs.Location;
+import org.openmrs.Patient;
+import org.openmrs.VisitAttributeType;
+import org.openmrs.VisitType;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.Date;
+import java.util.Map;
+
+/**
+ * A builder class for constructing instances of {@link VisitSearchCriteria}.
+ * This builder allows for the flexible creation of {@link VisitSearchCriteria}
+ * objects by providing a simple interface to set various fields.
+ * 
+ * @since 2.6.8
+ * @since 2.7.0
+ */
+public class VisitSearchCriteriaBuilder {
+	
+	private Collection<VisitType> visitTypes;
+	private Collection<Patient> patients;
+	private Collection<Location> locations;
+	private Collection<Concept> indications;
+	private Date minStartDatetime;
+	private Date maxStartDatetime;
+	private Date minEndDatetime;
+	private Date maxEndDatetime;
+	private Map<VisitAttributeType, String> serializedAttributeValues;
+	private boolean includeInactive = true;
+	private boolean includeVoided = false;
+	
+	/**
+	 * Constructs a new {@link VisitSearchCriteriaBuilder} instance.
+	 */
+	public VisitSearchCriteriaBuilder() {}
+	
+	/**
+	 * Sets the visit types to include in the search criteria.
+	 *
+	 * @param visitTypes the collection of {@link VisitType} to include.
+	 * @return the current instance of {@link VisitSearchCriteriaBuilder} for method chaining.
+	 */
+	public VisitSearchCriteriaBuilder visitTypes(Collection<VisitType> visitTypes) {
+		this.visitTypes = visitTypes;
+		return this;
+	}
+	
+	/**
+	 * Sets the patients to include in the search criteria.
+	 *
+	 * @param patients the collection of {@link Patient} to include.
+	 * @return the current instance of {@link VisitSearchCriteriaBuilder} for method chaining.
+	 */
+	public VisitSearchCriteriaBuilder patients(Collection<Patient> patients) {
+		this.patients = patients;
+		return this;
+	}
+	
+	/**
+	 * Sets a single patient to include in the search criteria.
+	 * 
+	 * @param patient the {@link Patient} to include.
+	 * @return the current instance of {@link VisitSearchCriteriaBuilder} for method chaining.
+	 */
+	public VisitSearchCriteriaBuilder patient(Patient patient){
+		this.patients = Collections.singletonList(patient);
+		return this;
+	}
+	
+	/**
+	 * Sets the locations to include in the search criteria.
+	 *
+	 * @param locations the collection of {@link Location} to include.
+	 * @return the current instance of {@link VisitSearchCriteriaBuilder} for method chaining.
+	 */
+	public VisitSearchCriteriaBuilder locations(Collection<Location> locations) {
+		this.locations = locations;
+		return this;
+	}
+	
+	/**
+	 * Sets the indications to include in the search criteria.
+	 *
+	 * @param indications the collection of {@link Concept} to include.
+	 * @return the current instance of {@link VisitSearchCriteriaBuilder} for method chaining.
+	 */
+	public VisitSearchCriteriaBuilder indications(Collection<Concept> indications) {
+		this.indications = indications;
+		return this;
+	}
+	
+	/**
+	 * Sets the minimum start datetime for visits to include in the search criteria.
+	 *
+	 * @param minStartDatetime the minimum start {@link Date}.
+	 * @return the current instance of {@link VisitSearchCriteriaBuilder} for method chaining.
+	 */
+	public VisitSearchCriteriaBuilder minStartDatetime(Date minStartDatetime) {
+		this.minStartDatetime = minStartDatetime;
+		return this;
+	}
+	
+	/**
+	 * Sets the maximum start datetime for visits to include in the search criteria.
+	 *
+	 * @param maxStartDatetime the maximum start {@link Date}.
+	 * @return the current instance of {@link VisitSearchCriteriaBuilder} for method chaining.
+	 */
+	public VisitSearchCriteriaBuilder maxStartDatetime(Date maxStartDatetime) {
+		this.maxStartDatetime = maxStartDatetime;
+		return this;
+	}
+	
+	/**
+	 * Sets the minimum end datetime for visits to include in the search criteria.
+	 *
+	 * @param minEndDatetime the minimum end {@link Date}.
+	 * @return the current instance of {@link VisitSearchCriteriaBuilder} for method chaining.
+	 */
+	public VisitSearchCriteriaBuilder minEndDatetime(Date minEndDatetime) {
+		this.minEndDatetime = minEndDatetime;
+		return this;
+	}
+	
+	/**
+	 * Sets the maximum end datetime for visits to include in the search criteria.
+	 *
+	 * @param maxEndDatetime the maximum end {@link Date}.
+	 * @return the current instance of {@link VisitSearchCriteriaBuilder} for method chaining.
+	 */
+	public VisitSearchCriteriaBuilder maxEndDatetime(Date maxEndDatetime) {
+		this.maxEndDatetime = maxEndDatetime;
+		return this;
+	}
+	
+	/**
+	 * Sets the serialized attribute values to filter visits by in the search criteria.
+	 *
+	 * @param serializedAttributeValues a map of {@link VisitAttributeType} to their corresponding serialized values.
+	 * @return the current instance of {@link VisitSearchCriteriaBuilder} for method chaining.
+	 */
+	public VisitSearchCriteriaBuilder serializedAttributeValues(Map<VisitAttributeType, String> serializedAttributeValues) {
+		this.serializedAttributeValues = serializedAttributeValues;
+		return this;
+	}
+	
+	/**
+	 * Sets whether inactive visits should be included in the search criteria.
+	 *
+	 * @param includeInactive true to include inactive visits, false otherwise.
+	 * @return the current instance of {@link VisitSearchCriteriaBuilder} for method chaining.
+	 */
+	public VisitSearchCriteriaBuilder includeInactive(boolean includeInactive) {
+		this.includeInactive = includeInactive;
+		return this;
+	}
+	
+	/**
+	 * Sets whether voided visits should be included in the search criteria.
+	 *
+	 * @param includeVoided true to include voided visits, false otherwise.
+	 * @return the current instance of {@link VisitSearchCriteriaBuilder} for method chaining.
+	 */
+	public VisitSearchCriteriaBuilder includeVoided(boolean includeVoided) {
+		this.includeVoided = includeVoided;
+		return this;
+	}
+	
+	/**
+	 * Builds and returns a {@link VisitSearchCriteria} instance based on the current state of the builder.
+	 *
+	 * @return a new instance of {@link VisitSearchCriteria}.
+	 */
+	public VisitSearchCriteria build() {
+		return new VisitSearchCriteria(visitTypes, patients, locations, indications, minStartDatetime, maxStartDatetime,
+			minEndDatetime, maxEndDatetime, serializedAttributeValues, includeInactive, includeVoided);
+	}
+}
diff --git a/api/src/main/java/org/openmrs/validator/VisitValidator.java b/api/src/main/java/org/openmrs/validator/VisitValidator.java
index e0a312171f69..19c54d34e12b 100644
--- a/api/src/main/java/org/openmrs/validator/VisitValidator.java
+++ b/api/src/main/java/org/openmrs/validator/VisitValidator.java
@@ -10,6 +10,7 @@
 package org.openmrs.validator;
 
 import java.util.Calendar;
+import java.util.Collections;
 import java.util.Date;
 import java.util.List;
 
@@ -18,6 +19,8 @@
 import org.openmrs.Visit;
 import org.openmrs.annotation.Handler;
 import org.openmrs.api.context.Context;
+import org.openmrs.parameter.VisitSearchCriteria;
+import org.openmrs.parameter.VisitSearchCriteriaBuilder;
 import org.openmrs.util.OpenmrsConstants;
 import org.openmrs.util.OpenmrsUtil;
 import org.springframework.validation.Errors;
@@ -105,15 +108,26 @@ public void validate(Object target, Errors errors) {
 		// check attributes
 		super.validateAttributes(visit, errors, Context.getVisitService().getAllVisitAttributeTypes());
 		
-		// check start and end dates
-		if (disallowOverlappingVisits()) {
-			List<Visit> otherVisitList = Context.getVisitService().getVisitsByPatient(visit.getPatient());
-			for (Visit otherVisit : otherVisitList) {
-				if (visit.equals(otherVisit)) {
-					continue;
-				}
-				validateStartDatetime(visit, otherVisit, errors);
-				validateStopDatetime(visit, otherVisit, errors);
+		// Skipping validation if the patient is not set or not yet persisted
+		boolean nonExistingPatient = visit.getPatient() == null || visit.getPatient().getId() == null;
+		
+		// check for overlapping visits
+		if (!nonExistingPatient && disallowOverlappingVisits()) {
+			VisitSearchCriteria visitSearchCriteria = new VisitSearchCriteriaBuilder()
+				.patient(visit.getPatient())
+				.maxStartDatetime(visit.getStopDatetime())
+				.minEndDatetime(visit.getStartDatetime())
+				.includeVoided(false)
+				.includeInactive(true)
+				.build();
+			
+			List<Visit> overLappingVisits = Context.getVisitService().getVisits(visitSearchCriteria);
+			
+			boolean overlappingSameVisit = overLappingVisits.size() == 1 && overLappingVisits.get(0).getId().equals(visit.getId());
+					
+			if (!overlappingSameVisit && !overLappingVisits.isEmpty()) {
+				errors.rejectValue("startDatetime", "Visit.visitCannotOverlapAnotherVisitOfTheSamePatient",
+					"This visit overlaps with another visit of the same patient.");
 			}
 		}
 		
@@ -132,45 +146,6 @@ private boolean allowOverlappingVisits() {
 		    OpenmrsConstants.GLOBAL_PROPERTY_ALLOW_OVERLAPPING_VISITS, "true"));
 	}
 	
-	private void validateStartDatetime(Visit visit, Visit otherVisit, Errors errors) {
-		
-		if (visit.getStartDatetime() != null && otherVisit.getStartDatetime() != null
-		        && visit.getStartDatetime().equals(otherVisit.getStartDatetime())) {
-			errors.rejectValue("startDatetime", "Visit.startCannotBeTheSameAsOtherStartDateOfTheSamePatient",
-			    "This visit has the same start date and time as another visit of this patient.");
-		}
-		
-		if (visit.getStartDatetime() != null && otherVisit.getStartDatetime() != null
-		        && otherVisit.getStopDatetime() != null && visit.getStartDatetime().after(otherVisit.getStartDatetime())
-		        && visit.getStartDatetime().before(otherVisit.getStopDatetime())) {
-			errors.rejectValue("startDatetime", "Visit.startDateCannotFallIntoAnotherVisitOfTheSamePatient",
-			    "This visit has a start date that falls into another visit of the same patient.");
-		}
-	}
-	
-	private void validateStopDatetime(Visit visit, Visit otherVisit, Errors errors) {
-		
-		if (visit.getStopDatetime() != null && otherVisit.getStartDatetime() != null && otherVisit.getStopDatetime() != null
-		        && visit.getStopDatetime().after(otherVisit.getStartDatetime())
-		        && visit.getStopDatetime().before(otherVisit.getStopDatetime())) {
-			errors.rejectValue("stopDatetime", "Visit.stopDateCannotFallIntoAnotherVisitOfTheSamePatient",
-			    "This visit has a stop date that falls into another visit of the same patient.");
-			
-		}
-		
-		if (visit.getStartDatetime() != null && visit.getStopDatetime() != null && otherVisit.getStartDatetime() != null
-		        && otherVisit.getStopDatetime() != null && visit.getStartDatetime().before(otherVisit.getStartDatetime())
-		        && visit.getStopDatetime().after(otherVisit.getStopDatetime())) {
-
-			String message = "This visit contains another visit of the same patient, "
-					+ "i.e. its start date is before the start date of the other visit "
-					+ "and its stop date is after the stop date of the other visit.";
-
-			errors.rejectValue("stopDatetime", "Visit.visitCannotContainAnotherVisitOfTheSamePatient", message);
-		}
-		
-	}
-	
 	private void validateVisitStartedBeforePatientBirthdate(Visit visit, Errors errors) {
 		if (visit.getPatient() == null || visit.getPatient().getBirthdate() == null || visit.getStartDatetime() == null) {
 			return;
diff --git a/api/src/main/resources/messages.properties b/api/src/main/resources/messages.properties
index 7d5561d5118a..ed04c69e602a 100644
--- a/api/src/main/resources/messages.properties
+++ b/api/src/main/resources/messages.properties
@@ -2770,7 +2770,7 @@ Visit.ended=Visit <b>{0}</b> Ended
 Visit.startCannotBeTheSameAsOtherStartDateOfTheSamePatient=Cannot start two different visits at the same time.
 Visit.startDateCannotFallIntoAnotherVisitOfTheSamePatient=This visit has a start date that falls into another visit of the same patient.
 Visit.stopDateCannotFallIntoAnotherVisitOfTheSamePatient=This visit has a stop date that falls into another visit of the same patient.
-Visit.visitCannotContainAnotherVisitOfTheSamePatient=This visit contains another visit of the same patient, i.e. its start date is before the start date of the other visit and its stop date is after the stop date of the other visit.
+Visit.visitCannotOverlapAnotherVisitOfTheSamePatient=This visit overlaps with another visit of the same patient.
 Visit.encountersCannotBeBeforeStartDate=Cannot contain encounters whose dates are before the start of the visit.
 Visit.encountersCannotBeAfterStopDate=Cannot contain encounters whose dates are after the stop of the visit.
 Visit.find.encounters.error=An error occurred while fetching encounters or could not connect to server
diff --git a/api/src/main/resources/messages_ar.properties b/api/src/main/resources/messages_ar.properties
index 451a532d5710..90eb3c22e581 100644
--- a/api/src/main/resources/messages_ar.properties
+++ b/api/src/main/resources/messages_ar.properties
@@ -2735,7 +2735,7 @@ Visit.to=إلى
 # Visit.startCannotBeTheSameAsOtherStartDateOfTheSamePatient=Cannot start two different visits at the same time.
 # Visit.startDateCannotFallIntoAnotherVisitOfTheSamePatient=This visit has a start date that falls into another visit of the same patient.
 # Visit.stopDateCannotFallIntoAnotherVisitOfTheSamePatient=This visit has a stop date that falls into another visit of the same patient.
-# Visit.visitCannotContainAnotherVisitOfTheSamePatient=This visit contains another visit of the same patient, i.e. its start date is before the start date of the other visit and its stop date is after the stop date of the other visit.
+# Visit.visitCannotOverlapAnotherVisitOfTheSamePatient=This visit contains another visit of the same patient, i.e. its start date is before the start date of the other visit and its stop date is after the stop date of the other visit.
 # Visit.encountersCannotBeBeforeStartDate=Cannot contain encounters whose dates are before the start of the visit.
 # Visit.encountersCannotBeAfterStopDate=Cannot contain encounters whose dates are after the stop of the visit.
 # Visit.find.encounters.error=An error occurred while fetching encounters or could not connect to server
diff --git a/api/src/main/resources/messages_de.properties b/api/src/main/resources/messages_de.properties
index fc0600e58247..9a94c8726ea5 100644
--- a/api/src/main/resources/messages_de.properties
+++ b/api/src/main/resources/messages_de.properties
@@ -2724,7 +2724,7 @@ Visit.ended=Visite <b>{0}</b> beendet
 Visit.startCannotBeTheSameAsOtherStartDateOfTheSamePatient=Zwei unterschiedliche Visiten können nicht gleichzeitig gestartet werden
 Visit.startDateCannotFallIntoAnotherVisitOfTheSamePatient=Diese Visite besitzt ein Startdatum, welches während einer weiteren Visite des gleichen Patienten beginnt
 Visit.stopDateCannotFallIntoAnotherVisitOfTheSamePatient=Diese Visite hat eine Enddatum, welches während einer weiteren Visite des gleichen Patienten endet
-Visit.visitCannotContainAnotherVisitOfTheSamePatient=Diese Visite enthält eine weitere Visite des gleichen Patienten, d. h. ihr Startdatum ist vor dem Startdatum der anderen Visite und ihr Enddatum nach dem Enddatum der anderer Visite.
+Visit.visitCannotOverlapAnotherVisitOfTheSamePatient=Diese Visite enthält eine weitere Visite des gleichen Patienten, d. h. ihr Startdatum ist vor dem Startdatum der anderen Visite und ihr Enddatum nach dem Enddatum der anderer Visite.
 Visit.encountersCannotBeBeforeStartDate=Kann keine Begegnungen enthalten, deren Termine vor dem Beginn der Visite liegen
 Visit.encountersCannotBeAfterStopDate=Kann keine Begegnungen enthalten, deren Termine nach dem Ende der Visite liegen
 Visit.find.encounters.error=Beim Abrufen der Begegnungen ist ein Fehler aufgetreten oder es konnte keine Verbindung zum Server aufgebaut werden
diff --git a/api/src/main/resources/messages_el.properties b/api/src/main/resources/messages_el.properties
index f1323c60ba53..cc337ad6fa1a 100644
--- a/api/src/main/resources/messages_el.properties
+++ b/api/src/main/resources/messages_el.properties
@@ -2735,7 +2735,7 @@ Visit.startedOnDatetime=ξεκίνησε στις
 # Visit.startCannotBeTheSameAsOtherStartDateOfTheSamePatient=Cannot start two different visits at the same time.
 # Visit.startDateCannotFallIntoAnotherVisitOfTheSamePatient=This visit has a start date that falls into another visit of the same patient.
 # Visit.stopDateCannotFallIntoAnotherVisitOfTheSamePatient=This visit has a stop date that falls into another visit of the same patient.
-# Visit.visitCannotContainAnotherVisitOfTheSamePatient=This visit contains another visit of the same patient, i.e. its start date is before the start date of the other visit and its stop date is after the stop date of the other visit.
+# Visit.visitCannotOverlapAnotherVisitOfTheSamePatient=This visit contains another visit of the same patient, i.e. its start date is before the start date of the other visit and its stop date is after the stop date of the other visit.
 # Visit.encountersCannotBeBeforeStartDate=Cannot contain encounters whose dates are before the start of the visit.
 # Visit.encountersCannotBeAfterStopDate=Cannot contain encounters whose dates are after the stop of the visit.
 # Visit.find.encounters.error=An error occurred while fetching encounters or could not connect to server
diff --git a/api/src/main/resources/messages_hi.properties b/api/src/main/resources/messages_hi.properties
index 801f1c4dd63e..f3cd8f709da5 100644
--- a/api/src/main/resources/messages_hi.properties
+++ b/api/src/main/resources/messages_hi.properties
@@ -1,2298 +1,2298 @@
 #This line must not be removed, because it contains BOM to indicate the UTF-8 encoding.
 openmrs.title=OpenMRS
-index.title=OpenMRS - घर
-login.title=OpenMRS - लॉग इन
-forgotPassword.title=OpenMRS - पहचान का शब्द भूल गये
-patientDashboard.title=OpenMRS - रोगी का डैशबोर्ड
-personDashboard.title=OpenMRS - व्यक्ति का डैशबोर्ड
-findPatient.title=OpenMRS - रोगी खोजें
-optionsForm.title=OpenMRS - उपयोगकर्ता के विकल्प
-dictionary.titlebar=OpenMRS - शब्दकोश
-dictionary.title=सिद्धान्त के शब्दकोश का रखरखाव
-admin.titlebar=OpenMRS - प्रशासन
-person.title=OpenMRS - व्यक्ति
-encounter.title=OpenMRS - समाना
-location.title=OpenMRS - स्थान
-dictionary.header=संकल्पना शब्दकोश रखरखाव 
-CohortBuilder.title=OpenMRS - पलटन बिल्डर
-admin.header=प्रशासन
-Navigation.home=निवास
-Navigation.findPatient=रोगी को खोजे 
-Navigation.findCreatePatient=रोगी खोजे/बनाये
-Navigation.dictionary=शब्दकोश
-Navigation.administration=प्रशासन
-Navigation.options=मेरा प्रालेख
-Navigation.calendar=तिथिपत्र
-fix.error=<div class="error">सभी त्रुटियों को ठीक करें और फिर कोशिश करें.</div>
-fix.error.plain=सभी त्रुटियों को ठीक करें और फिर कोशिश करें..
-error.general=फ़ॉर्म जमा करते वक्त त्रुटि
-error.null=खाली या रिक्त नहीं हो सकता 
-error.inuse=यह मूल्य अन्य ऑब्जेक्ट द्वारा उपयोग में है 
-error.object.inuse.cannot.purge=यह ऑब्जेक्ट संदर्भित किया जा रहा है और निकला नहीं जा सकता.  
-error.name=अमान्य नाम
-error.description=अमान्य विवरण
-error.checkdigit=के लिए अमान्य चेकअंक
-error.checkdigits={0} के लिए अमान्य चेकअंक
-error.checkdigits.verbose=यह चेकअंक {0} अमान्य है. कृपया रोगी की दुबारा जाँच करे .
-error.checkdigits.unallowed=पहचानकर्ता {0} सत्यापनकर्ता {1} के लिए अनुमति नहीं है
-error.concept=अमान्य सिद्धान्त
-error.drugAndOrderConcept.mismatch = आदेश अवधारणा एवं औषधि संकल्पना के बीच बेमेल
-error.drug.noConcept = दवा कोई अवधारणा को परिभाषित किया गया
-error.character.invalid=अमान्य वर्ण ` {0} ` गैर checkdigit पहचानकर्ता में पाया {1}
-error.date=अमान्य तिथि
-error.number=यह संख्या मान्य नहीं है 
-error.numberOutsideRange=संख्या स्वीकार्य सीमा के बाहर है.
-error.patientSearchNoChars=आप वर्ण आवश्य डाले 
-error.preferredIdentifier=कृपया पसंदीदा पहचान को चुने 
-error.reportObject.type.required=अमान्य प्रकार
-error.reportObject.subType.required=अमान्य उपप्रकार 
-error.date.future=भविष्य की कोई दिनांक की कोई दिनांक को ना चुने 
-error.date.nonsensical=अतर्कसंगत दिनांक, कृपया जाचे.
-error.deathdate.before.birthdate=मौत की तारीख जन्म दिनांक के बाद होना चाहिए
-error.programWorkflow=अमान्य कार्यक्रम कार्यप्रवाह
-error.programWorkflowState=अमान्य कार्यक्रम कार्यप्रवाह स्थिति
-error.identifier.formatInvalid=पहचानकर्ता {0} अमान्य है,  उन्हे कुछ इस प्रकार होना चाहिए : {1}
-error.beforeDateCreated=निर्माण तिथि से बाद में नहीं कर सकते
-error.required={0} जरूरी है
-error.trailingSpaces=शुरुआत या अंत में अतिरिक्त रिक्त स्थान की अनुमति नहीं हैं
-error.configurationRequired=सभी विन्यास पैरामीटर पहले इस मॉड्यूल का उपयोग करने के लिए निर्दिष्ट किया जाना चाहिए
-error.dwr.stacktrace=इस त्रुटि के लिए पूर्ण स्टैक ट्रेस आमतौर पर अपने सर्वर त्रुटि लॉग में पाया जा सकता है ।
-error.dwr=एक जावास्क्रिप्ट त्रुटि हुई है:
-error.dwr.hide=त्रुटि छुपाएँ
-error.outOfRange.low.obs.valueNumeric=सवाल को वैध होने के लिए यह मान बहुत कम है
-error.outOfRange.high.obs.valueNumeric=सवाल को वैध होने के लिए यह मान बहुत अधिक है
-error.exceededMaxLengthOfField=यह मान इस क्षेत्र की अनुमति दी हुई अधिकतम लंबाई से अधिक है!
-error.failed.validation=मान्यता त्रुटियों पाया
-errors.patientId.cannotBeNull=रोगी आईडी रिक्त नहीं हो सकता
-error.foundValidationErrors=मान्यकरण त्रुटिया पायी गयी 
-error.invalid=अमान्य
-error.privilegesRequired=विशेषाधिकार की आवश्यकता: {0}
-error.extraPrivilegesRequired=अतिरिक्त विशेषाधिकारों की आवश्यकता
-error.insufficientPrivileges=अपर्याप्त विशेषाधिकार
-error.aunthenticationRequired=मूलभूत प्रमाणीकरण की आवश्यकता
-error.failedToSendRequest=अनुरोध भेजने में विफल
-error.description.required=विवरण आवश्यक है
-error.duplicateIdentifierTypes= मरीज को एक दिया पहचानकर्ता प्रकार के लिए एक से अधिक पहचानकर्ता नहीं हो सकता
-fieldtype.duplicate.name=निर्दिष्ट फ़ील्ड प्रकार का नाम पहले से ही , एक और निर्दिष्ट कृपया मौजूद
-identifierType.duplicate.name=निर्दिष्ट पहचानकर्ता प्रकार नाम पहले से ही , एक और निर्दिष्ट कृपया मौजूद
-location.duplicate.name=निर्दिष्ट स्थान का नाम पहले से ही , एक और निर्दिष्ट कृपया मौजूद
-conceptclass.duplicate.name=निर्दिष्ट संकल्पना कक्षा नाम पहले से ही , एक और निर्दिष्ट कृपया मौजूद
-duplicate.relationshipType=रिश्ते के प्रकार पहले से ही , एक और निर्दिष्ट कृपया मौजूद
-error.patientProgram.enrolledDateShouldBeBeforecompletionDate=दाखिला तिथि पूरा होने की तारीख से पहले किया जाना चाहिए
-error.patientProgram.enrolledDateEmpty=दाखिला तिथि खाली है , एक दाखिला तिथि का चयन करें
-error.patientProgram.enrolledDateDateCannotBeInFuture=दाखिला तिथि भविष्य में नहीं हो सकता , पर या आज से पहले एक तिथि का चयन करें
-error.patientProgram.completionDateCannotBeInFuture=पूरे किए तारीख भविष्य में नहीं हो सकता , पर या आज से पहले एक तिथि का चयन करें
-general.at=पर
-general.with=संग
-general.select=चयन
-general.selectOrUnselectAll=का चयन करें / रद्द करें सभी
-general.name=नाम
-general.description=विवरण
-general.creator=निर्माता
-general.createdBy=द्वारा बनाया गया
-general.dateCreated=बनाई गयी तिथि
-general.voidInfo=शून्य सूचना
-general.voided=शून्यता
-general.voidedBy=शून्यता द्वारा
-general.voidReason=शून्य कारण
-general.voidReason.empty=शून्य कारण खाली नहीं हो सकता
-general.voidReasonQuestion=हटाये जाने का कारण
-general.dateVoided=मिटाने के तारीख 
-general.changedBy=बदलने वाला 
-general.dateChanged=बदलने की तारीख 
-general.delete=हटाना
+index.title=OpenMRS - घर
+login.title=OpenMRS - लॉग इन
+forgotPassword.title=OpenMRS - पहचान का शब्द भूल गये
+patientDashboard.title=OpenMRS - रोगी का डैशबोर्ड
+personDashboard.title=OpenMRS - व्यक्ति का डैशबोर्ड
+findPatient.title=OpenMRS - रोगी खोजें
+optionsForm.title=OpenMRS - उपयोगकर्ता के विकल्प
+dictionary.titlebar=OpenMRS - शब्दकोश
+dictionary.title=सिद्धान्त के शब्दकोश का रखरखाव
+admin.titlebar=OpenMRS - प्रशासन
+person.title=OpenMRS - व्यक्ति
+encounter.title=OpenMRS - समाना
+location.title=OpenMRS - स्थान
+dictionary.header=संकल्पना शब्दकोश रखरखाव 
+CohortBuilder.title=OpenMRS - पलटन बिल्डर
+admin.header=प्रशासन
+Navigation.home=निवास
+Navigation.findPatient=रोगी को खोजे 
+Navigation.findCreatePatient=रोगी खोजे/बनाये
+Navigation.dictionary=शब्दकोश
+Navigation.administration=प्रशासन
+Navigation.options=मेरा प्रालेख
+Navigation.calendar=तिथिपत्र
+fix.error=<div class="error">सभी त्रुटियों को ठीक करें और फिर कोशिश करें.</div>
+fix.error.plain=सभी त्रुटियों को ठीक करें और फिर कोशिश करें..
+error.general=फ़ॉर्म जमा करते वक्त त्रुटि
+error.null=खाली या रिक्त नहीं हो सकता 
+error.inuse=यह मूल्य अन्य ऑब्जेक्ट द्वारा उपयोग में है 
+error.object.inuse.cannot.purge=यह ऑब्जेक्ट संदर्भित किया जा रहा है और निकला नहीं जा सकता.  
+error.name=अमान्य नाम
+error.description=अमान्य विवरण
+error.checkdigit=के लिए अमान्य चेकअंक
+error.checkdigits={0} के लिए अमान्य चेकअंक
+error.checkdigits.verbose=यह चेकअंक {0} अमान्य है. कृपया रोगी की दुबारा जाँच करे .
+error.checkdigits.unallowed=पहचानकर्ता {0} सत्यापनकर्ता {1} के लिए अनुमति नहीं है
+error.concept=अमान्य सिद्धान्त
+error.drugAndOrderConcept.mismatch = आदेश अवधारणा एवं औषधि संकल्पना के बीच बेमेल
+error.drug.noConcept = दवा कोई अवधारणा को परिभाषित किया गया
+error.character.invalid=अमान्य वर्ण ` {0} ` गैर checkdigit पहचानकर्ता में पाया {1}
+error.date=अमान्य तिथि
+error.number=यह संख्या मान्य नहीं है 
+error.numberOutsideRange=संख्या स्वीकार्य सीमा के बाहर है.
+error.patientSearchNoChars=आप वर्ण आवश्य डाले 
+error.preferredIdentifier=कृपया पसंदीदा पहचान को चुने 
+error.reportObject.type.required=अमान्य प्रकार
+error.reportObject.subType.required=अमान्य उपप्रकार 
+error.date.future=भविष्य की कोई दिनांक की कोई दिनांक को ना चुने 
+error.date.nonsensical=अतर्कसंगत दिनांक, कृपया जाचे.
+error.deathdate.before.birthdate=मौत की तारीख जन्म दिनांक के बाद होना चाहिए
+error.programWorkflow=अमान्य कार्यक्रम कार्यप्रवाह
+error.programWorkflowState=अमान्य कार्यक्रम कार्यप्रवाह स्थिति
+error.identifier.formatInvalid=पहचानकर्ता {0} अमान्य है,  उन्हे कुछ इस प्रकार होना चाहिए : {1}
+error.beforeDateCreated=निर्माण तिथि से बाद में नहीं कर सकते
+error.required={0} जरूरी है
+error.trailingSpaces=शुरुआत या अंत में अतिरिक्त रिक्त स्थान की अनुमति नहीं हैं
+error.configurationRequired=सभी विन्यास पैरामीटर पहले इस मॉड्यूल का उपयोग करने के लिए निर्दिष्ट किया जाना चाहिए
+error.dwr.stacktrace=इस त्रुटि के लिए पूर्ण स्टैक ट्रेस आमतौर पर अपने सर्वर त्रुटि लॉग में पाया जा सकता है ।
+error.dwr=एक जावास्क्रिप्ट त्रुटि हुई है:
+error.dwr.hide=त्रुटि छुपाएँ
+error.outOfRange.low.obs.valueNumeric=सवाल को वैध होने के लिए यह मान बहुत कम है
+error.outOfRange.high.obs.valueNumeric=सवाल को वैध होने के लिए यह मान बहुत अधिक है
+error.exceededMaxLengthOfField=यह मान इस क्षेत्र की अनुमति दी हुई अधिकतम लंबाई से अधिक है!
+error.failed.validation=मान्यता त्रुटियों पाया
+errors.patientId.cannotBeNull=रोगी आईडी रिक्त नहीं हो सकता
+error.foundValidationErrors=मान्यकरण त्रुटिया पायी गयी 
+error.invalid=अमान्य
+error.privilegesRequired=विशेषाधिकार की आवश्यकता: {0}
+error.extraPrivilegesRequired=अतिरिक्त विशेषाधिकारों की आवश्यकता
+error.insufficientPrivileges=अपर्याप्त विशेषाधिकार
+error.aunthenticationRequired=मूलभूत प्रमाणीकरण की आवश्यकता
+error.failedToSendRequest=अनुरोध भेजने में विफल
+error.description.required=विवरण आवश्यक है
+error.duplicateIdentifierTypes= मरीज को एक दिया पहचानकर्ता प्रकार के लिए एक से अधिक पहचानकर्ता नहीं हो सकता
+fieldtype.duplicate.name=निर्दिष्ट फ़ील्ड प्रकार का नाम पहले से ही , एक और निर्दिष्ट कृपया मौजूद
+identifierType.duplicate.name=निर्दिष्ट पहचानकर्ता प्रकार नाम पहले से ही , एक और निर्दिष्ट कृपया मौजूद
+location.duplicate.name=निर्दिष्ट स्थान का नाम पहले से ही , एक और निर्दिष्ट कृपया मौजूद
+conceptclass.duplicate.name=निर्दिष्ट संकल्पना कक्षा नाम पहले से ही , एक और निर्दिष्ट कृपया मौजूद
+duplicate.relationshipType=रिश्ते के प्रकार पहले से ही , एक और निर्दिष्ट कृपया मौजूद
+error.patientProgram.enrolledDateShouldBeBeforecompletionDate=दाखिला तिथि पूरा होने की तारीख से पहले किया जाना चाहिए
+error.patientProgram.enrolledDateEmpty=दाखिला तिथि खाली है , एक दाखिला तिथि का चयन करें
+error.patientProgram.enrolledDateDateCannotBeInFuture=दाखिला तिथि भविष्य में नहीं हो सकता , पर या आज से पहले एक तिथि का चयन करें
+error.patientProgram.completionDateCannotBeInFuture=पूरे किए तारीख भविष्य में नहीं हो सकता , पर या आज से पहले एक तिथि का चयन करें
+general.at=पर
+general.with=संग
+general.select=चयन
+general.selectOrUnselectAll=का चयन करें / रद्द करें सभी
+general.name=नाम
+general.description=विवरण
+general.creator=निर्माता
+general.createdBy=द्वारा बनाया गया
+general.dateCreated=बनाई गयी तिथि
+general.voidInfo=शून्य सूचना
+general.voided=शून्यता
+general.voidedBy=शून्यता द्वारा
+general.voidReason=शून्य कारण
+general.voidReason.empty=शून्य कारण खाली नहीं हो सकता
+general.voidReasonQuestion=हटाये जाने का कारण
+general.dateVoided=मिटाने के तारीख 
+general.changedBy=बदलने वाला 
+general.dateChanged=बदलने की तारीख 
+general.delete=हटाना
 general.deleteLink=[x]
-general.deleted=हटाए गए
-general.cannot.delete=हटाया नहीं जा सकता
-general.purge=हमेशा के लिए हटाएँ
+general.deleted=हटाए गए
+general.cannot.delete=हटाया नहीं जा सकता
+general.purge=हमेशा के लिए हटाएँ
 general.purged=purged
-general.changed=बदलना 
-general.cannot.change=बदला नहीं जा सकता
-general.retire=निवृत्त होना
-general.retired=सेवानिवृत्त
-general.retiredReason=सेवानिवृत्त होने का कारण
-general.retiredBy=द्वारा सेवानिवृत्त
-general.dateRetired=तिथि सेवानिवृत्त
-general.retiredReason.empty=सेवानिवृत्त होने का कारण खाली नहीं हो सकता
-general.cannot.retire=सेवानिवृत्त नहीं किया जा सकता है
-general.cannot.unretire=इंनको दुबारा से सेवा मे नहीं लिया जा सकता 
-general.unretire=सेवा मे वापस ले 
-general.add=जोड़े
-general.addAnother=एक अन्य जोड़ें
-general.new=नया
-general.edit=संपादित करें
-general.save=सुरक्षित करना
-general.saved=सुरक्षित हो गया 
-general.saveAs=इस रूप में सहेजें
-general.saving=सुरक्षित हो रहा है  {0}
-general.startedAt=पर शुरू कर दिया
-general.completedAt=पर पूरा
-general.remove=हटाना
-general.view=देखें
-general.move_up=ऊपर जाए
-general.move_down=नीचे जाए
-general.search=खोजे 
-general.searchButton=खोजे
-general.change=परिवर्तन
+general.changed=बदलना 
+general.cannot.change=बदला नहीं जा सकता
+general.retire=निवृत्त होना
+general.retired=सेवानिवृत्त
+general.retiredReason=सेवानिवृत्त होने का कारण
+general.retiredBy=द्वारा सेवानिवृत्त
+general.dateRetired=तिथि सेवानिवृत्त
+general.retiredReason.empty=सेवानिवृत्त होने का कारण खाली नहीं हो सकता
+general.cannot.retire=सेवानिवृत्त नहीं किया जा सकता है
+general.cannot.unretire=इंनको दुबारा से सेवा मे नहीं लिया जा सकता 
+general.unretire=सेवा मे वापस ले 
+general.add=जोड़े
+general.addAnother=एक अन्य जोड़ें
+general.new=नया
+general.edit=संपादित करें
+general.save=सुरक्षित करना
+general.saved=सुरक्षित हो गया 
+general.saveAs=इस रूप में सहेजें
+general.saving=सुरक्षित हो रहा है  {0}
+general.startedAt=पर शुरू कर दिया
+general.completedAt=पर पूरा
+general.remove=हटाना
+general.view=देखें
+general.move_up=ऊपर जाए
+general.move_down=नीचे जाए
+general.search=खोजे 
+general.searchButton=खोजे
+general.change=परिवर्तन
 general.id=Id
-general.continue=जारी रखें
-general.previous=पीछे जाये 
-general.next=अगला 
-general.true=सही 
-general.false=गलत 
-general.search.hint=संकेत: कृप्या पहले कुछ वर्ण लिखे
-general.cancel=रद्द करें
-general.canceled=कार्रवाई रद्द
-general.refresh=ताज़ा करे 
-general.preferred=पसंदीदा
-general.submit=प्रस्तुत करे 
-general.answer=जवाब
-general.download=डाउनलोड
-general.start=प्रारंभ
-general.end=अंत
-general.format=प्रारूप
-general.yes=हां
-general.no=नहीं 
-general.choose=चुनें
-general.clear=साफ
-general.type=प्रकार 
-general.subType=उपप्रकार 
-general.toggle.description=टॉगल विवरण
-general.toggle.voided=टॉगल शून्य करे 
-general.toggle.verbose=टॉगल वाचाल करे
-general.toggle.retired=टॉगल सेवानिवृत्त करे
-general.or=या
-general.and=और
-general.andOr=और/या
-general.value=मूल्य
-general.none=कोई नहीं
-general.instructions=निर्देश
-general.discontinued=बंद
-general.discontinuedBy=ने बंद किया 
-general.discontinuedReason=बंद करने का कारण
-general.dateStart=प्रारंभ करने की दिनांक 
-general.dateAutoExpire=अपने आप समाप्त करने के तारीख
-general.dateDiscontinued=समाप्त करने के तारीख
-general.locale=स्थान
-general.nMore={0} अधिक
-general.nLess={0} कम
-general.optional=वैकल्पिक
-general.onDate=प्रारंभ
-general.hide=छुपाये
-general.drop=हटाये 
-general.close=बंद करे
-general.reason=कारण
-general.void=खाली
-general.unvoid=खाली स्थान को भरे
-general.loading=कृप्या थोडा इंतजार करे...
-general.fromDate=से
-general.toDate=जब तक
-general.unknown=अज्ञात
-general.readonly=केवल पढ़ने के लिए
-general.atLocation=पर
-general.byPerson=द्वारा
-general.printedOn=इस दिन छापा गया
-general.notYetImplemented=<font color='red'>अभी तक क्रियान्वित नहीं</font>
-general.closeWindow=विंडो बंद करे
-general.navigateBack=पीछे जाये
-general.back=पीछे
-general.action=कार्रवाई
-general.author=लेखक
-general.version=संस्करण
-general.includeVoided=खाली को भी शामिल करें
-general.dateConstraints=तिथि सीमा
-general.since=के बाद से
-general.nWeeks={0} सप्ताह (s)
-general.displayingXtoYofZ= प्रदशि॔त{0} से {1} तक {2}
-general.file=फ़ाइल
-general.allOptions=कोई भी
-general.dataEntryError=जानकारी में गलती है
-general.showAll=सरे जानकारे दिखाए
-general.parameters=पैरामीटर्स
-general.class=वर्ग
-general.key=कुंजी
-general.error.nameAlreadyInUse=आपके द्वारा दर्ज नाम पहले से उपयोग में है, एक अनन्य नाम दर्ज करें.
-general.invalid=अमान्य
-general.properties=गुण
-general.default=चूक
-general.default.voidReason=उपयोगकर्ता इंटरफ़ेस से हटाया
-general.voidReasonWithArgument=इसे करने के लिए संपादित किया गया था , क्योंकि यह शून्य कर दिया गया था: {0}
-general.default.changeReason=उपयोगकर्ता इंटरफ़ेस से बदला गया 
-general.to=से
-general.of=की
+general.continue=जारी रखें
+general.previous=पीछे जाये 
+general.next=अगला 
+general.true=सही 
+general.false=गलत 
+general.search.hint=संकेत: कृप्या पहले कुछ वर्ण लिखे
+general.cancel=रद्द करें
+general.canceled=कार्रवाई रद्द
+general.refresh=ताज़ा करे 
+general.preferred=पसंदीदा
+general.submit=प्रस्तुत करे 
+general.answer=जवाब
+general.download=डाउनलोड
+general.start=प्रारंभ
+general.end=अंत
+general.format=प्रारूप
+general.yes=हां
+general.no=नहीं 
+general.choose=चुनें
+general.clear=साफ
+general.type=प्रकार 
+general.subType=उपप्रकार 
+general.toggle.description=टॉगल विवरण
+general.toggle.voided=टॉगल शून्य करे 
+general.toggle.verbose=टॉगल वाचाल करे
+general.toggle.retired=टॉगल सेवानिवृत्त करे
+general.or=या
+general.and=और
+general.andOr=और/या
+general.value=मूल्य
+general.none=कोई नहीं
+general.instructions=निर्देश
+general.discontinued=बंद
+general.discontinuedBy=ने बंद किया 
+general.discontinuedReason=बंद करने का कारण
+general.dateStart=प्रारंभ करने की दिनांक 
+general.dateAutoExpire=अपने आप समाप्त करने के तारीख
+general.dateDiscontinued=समाप्त करने के तारीख
+general.locale=स्थान
+general.nMore={0} अधिक
+general.nLess={0} कम
+general.optional=वैकल्पिक
+general.onDate=प्रारंभ
+general.hide=छुपाये
+general.drop=हटाये 
+general.close=बंद करे
+general.reason=कारण
+general.void=खाली
+general.unvoid=खाली स्थान को भरे
+general.loading=कृप्या थोडा इंतजार करे...
+general.fromDate=से
+general.toDate=जब तक
+general.unknown=अज्ञात
+general.readonly=केवल पढ़ने के लिए
+general.atLocation=पर
+general.byPerson=द्वारा
+general.printedOn=इस दिन छापा गया
+general.notYetImplemented=<font color='red'>अभी तक क्रियान्वित नहीं</font>
+general.closeWindow=विंडो बंद करे
+general.navigateBack=पीछे जाये
+general.back=पीछे
+general.action=कार्रवाई
+general.author=लेखक
+general.version=संस्करण
+general.includeVoided=खाली को भी शामिल करें
+general.dateConstraints=तिथि सीमा
+general.since=के बाद से
+general.nWeeks={0} सप्ताह (s)
+general.displayingXtoYofZ= प्रदशि॔त{0} से {1} तक {2}
+general.file=फ़ाइल
+general.allOptions=कोई भी
+general.dataEntryError=जानकारी में गलती है
+general.showAll=सरे जानकारे दिखाए
+general.parameters=पैरामीटर्स
+general.class=वर्ग
+general.key=कुंजी
+general.error.nameAlreadyInUse=आपके द्वारा दर्ज नाम पहले से उपयोग में है, एक अनन्य नाम दर्ज करें.
+general.invalid=अमान्य
+general.properties=गुण
+general.default=चूक
+general.default.voidReason=उपयोगकर्ता इंटरफ़ेस से हटाया
+general.voidReasonWithArgument=इसे करने के लिए संपादित किया गया था , क्योंकि यह शून्य कर दिया गया था: {0}
+general.default.changeReason=उपयोगकर्ता इंटरफ़ेस से बदला गया 
+general.to=से
+general.of=की
 general.yearsOldAbbrev=yo
-general.noMatchesFound=कोई मिलान नहीं मिले {0} के लिए
-general.noMatchesFoundInLocale=कोई मिलान नहीं मिले {0} स्थान में {1}
-general.confirm.purge=क्या आप यकीन है कि आप इस वस्तु को पर्ज करना चाहते हैं? यह स्थायी रूप से सिस्टम से हटा दिया जाएगा.
-general.default.retireReason=उपयोगकर्ता इंटरफ़ेस से सेवानिवृत्त
-general.patient=रोगी
-general.done=पूरा हुआ
-general.restore=पुनर्स्थापित
-general.purge.confirmation=हमेशा के लिए पुष्टि हटाएं
-general.delete.confirmation=पुष्टि हटाएं
-general.retire.confirmation=पुष्टि रिटायर
+general.noMatchesFound=कोई मिलान नहीं मिले {0} के लिए
+general.noMatchesFoundInLocale=कोई मिलान नहीं मिले {0} स्थान में {1}
+general.confirm.purge=क्या आप यकीन है कि आप इस वस्तु को पर्ज करना चाहते हैं? यह स्थायी रूप से सिस्टम से हटा दिया जाएगा.
+general.default.retireReason=उपयोगकर्ता इंटरफ़ेस से सेवानिवृत्त
+general.patient=रोगी
+general.done=पूरा हुआ
+general.restore=पुनर्स्थापित
+general.purge.confirmation=हमेशा के लिए पुष्टि हटाएं
+general.delete.confirmation=पुष्टि हटाएं
+general.retire.confirmation=पुष्टि रिटायर
 general.uuid=UUID
-general.show=दिखाओ
-general.changes.toSave=आप परिवर्तन किए हैं। <br/> परिवर्तन सहेजें या वापस लाएं
-general.today=आज
-general.yesterday=बीते कल
-general.unableToViewPage=क्षमा करें, आप इस पृष्ठ को देखने या इस क्रिया को निष्पादित करने में सक्षम नहीं हैं।
-general.accountHasNoPrivilege=आपके उपयोगकर्ता खाते इस पेज को देखने की आवश्यकता विशेषाधिकार (एस ) के पास नहीं है । 
-general.sendAlertToAdminMessage=क्या आप विशेषाधिकार (एस ) होना चाहिए लगता है, तो हम इतना कह अपने सिस्टम प्रशासक के लिए एक संदेश भेज सकते हैं।
-general.loginWithAnotherAccountMessage=यदि आप अधिक विशेषाधिकारों के साथ किसी अन्य उपयोगकर्ता खाता है, तो आप उस के साथ में लॉग इन करें और फिर से आपरेशन की कोशिश कर सकते हैं।
-general.loginWithAnotherAccount=एक और खाते के साथ में प्रवेश करें
-general.alert.requestPrivilegesForPage=प्रयोक्ता {0} विशेषाधिकार (एस ) का अनुरोध किया है [{ 1} ], वे पृष्ठ का उपयोग करने की कोशिश कर रहे थे जब : {2}
-general.alert.requestUnKnownPrivilegesForPage=प्रयोक्ता {0} , विशेषाधिकार (एस ) से अनुरोध किया है कि वे पृष्ठ का उपयोग करने की कोशिश कर रहे थे जब : { 1}
-general.alert.requestPrivileges=प्रयोक्ता {0} का अनुरोध किया है विशेषाधिकार (एस ) [ {1} ], वे एक पृष्ठ का उपयोग करने की कोशिश कर रहे थे जब
-general.alert.privilegesForPageOnException={0} , प्रयोक्ता {1} था लापता इन या वे पृष्ठ का उपयोग करने की कोशिश कर रहे थे जब कुछ विशेषाधिकार : {2}
-general.alertSystemAdmin=चेतावनी प्रणाली प्रशासक
-general.alertSent=चेतावनी भेजा गया
-general.noresult=कोई परिणाम नहीं
-general.passwordLength=पासवर्ड {0} वर्ण लंबा होना चाहिए
-general.shouldHave=और होना चाहिए
+general.show=दिखाओ
+general.changes.toSave=आप परिवर्तन किए हैं। <br/> परिवर्तन सहेजें या वापस लाएं
+general.today=आज
+general.yesterday=बीते कल
+general.unableToViewPage=क्षमा करें, आप इस पृष्ठ को देखने या इस क्रिया को निष्पादित करने में सक्षम नहीं हैं।
+general.accountHasNoPrivilege=आपके उपयोगकर्ता खाते इस पेज को देखने की आवश्यकता विशेषाधिकार (एस ) के पास नहीं है । 
+general.sendAlertToAdminMessage=क्या आप विशेषाधिकार (एस ) होना चाहिए लगता है, तो हम इतना कह अपने सिस्टम प्रशासक के लिए एक संदेश भेज सकते हैं।
+general.loginWithAnotherAccountMessage=यदि आप अधिक विशेषाधिकारों के साथ किसी अन्य उपयोगकर्ता खाता है, तो आप उस के साथ में लॉग इन करें और फिर से आपरेशन की कोशिश कर सकते हैं।
+general.loginWithAnotherAccount=एक और खाते के साथ में प्रवेश करें
+general.alert.requestPrivilegesForPage=प्रयोक्ता {0} विशेषाधिकार (एस ) का अनुरोध किया है [{ 1} ], वे पृष्ठ का उपयोग करने की कोशिश कर रहे थे जब : {2}
+general.alert.requestUnKnownPrivilegesForPage=प्रयोक्ता {0} , विशेषाधिकार (एस ) से अनुरोध किया है कि वे पृष्ठ का उपयोग करने की कोशिश कर रहे थे जब : { 1}
+general.alert.requestPrivileges=प्रयोक्ता {0} का अनुरोध किया है विशेषाधिकार (एस ) [ {1} ], वे एक पृष्ठ का उपयोग करने की कोशिश कर रहे थे जब
+general.alert.privilegesForPageOnException={0} , प्रयोक्ता {1} था लापता इन या वे पृष्ठ का उपयोग करने की कोशिश कर रहे थे जब कुछ विशेषाधिकार : {2}
+general.alertSystemAdmin=चेतावनी प्रणाली प्रशासक
+general.alertSent=चेतावनी भेजा गया
+general.noresult=कोई परिणाम नहीं
+general.passwordLength=पासवर्ड {0} वर्ण लंबा होना चाहिए
+general.shouldHave=और होना चाहिए
 
 ##### SEARCH WIDGET MESSAGES ######
 # Don't overwrite the text in uppercase letters starting and ending with underscores e.g _REQUIRED_NUMBER_,
 # because they are place holders but you can change their positions in the phrase to preserve the meaning.
 searchWidget.sInfoLabel=Showing _START_ to _END_ of _TOTAL_ entries
-searchWidget.viewingResults=देखने के लिए परिणाम _SEARCH_TEXT_
-searchWidget.loadingWithPlaceHolder=लोडिंग _NUMBER_OF_PAGES_ results
+searchWidget.viewingResults=देखने के लिए परिणाम _SEARCH_TEXT_
+searchWidget.loadingWithPlaceHolder=लोडिंग _NUMBER_OF_PAGES_ results
 searchWidget.minCharRequired=Enter at least _REQUIRED_NUMBER_ characters
 searchWidget.pagesWithPlaceHolder=_NUMBER_OF_PAGES_ pages
-searchWidget.first=पहला 
-searchWidget.previous=पिछला
-searchWidget.next=अगला
-searchWidget.last=अंतिम
-searchWidget.noMatchesFound=कोई मिलान रिकॉर्ड नहीं मिला
-searchWidget.OnePage=1 पेज
-searchWidget.searchPhraseCannotBeNull=खोज वाक्यांश रिक्त या खाली नहीं किया जा सकता
-searchWidget.showVerbose=विवरण दिखाएँ
-searchWidget.viewingAll=सभी को देखने
-searchWidget.showNumberOfEntries=दिखाएँ {0} प्रविष्टियों
-searchWidget.noResultsFoundFor=कोई परिणाम नहीं मिले के लिए : <b>{0}</b>, यहां के लिए आंशिक मिलान हैं: <b>{1}</b>
+searchWidget.first=पहला 
+searchWidget.previous=पिछला
+searchWidget.next=अगला
+searchWidget.last=अंतिम
+searchWidget.noMatchesFound=कोई मिलान रिकॉर्ड नहीं मिला
+searchWidget.OnePage=1 पेज
+searchWidget.searchPhraseCannotBeNull=खोज वाक्यांश रिक्त या खाली नहीं किया जा सकता
+searchWidget.showVerbose=विवरण दिखाएँ
+searchWidget.viewingAll=सभी को देखने
+searchWidget.showNumberOfEntries=दिखाएँ {0} प्रविष्टियों
+searchWidget.noResultsFoundFor=कोई परिणाम नहीं मिले के लिए : <b>{0}</b>, यहां के लिए आंशिक मिलान हैं: <b>{1}</b>
 
 #### JSP page messages ######
 
-admin.title.short=प्रशासन
-admin.title=प्रबंधन/प्रशासन
-
-auth.logged.out=आप लोग आउट हो चुके है
-auth.session.expired=आपका सत्र समाप्त हो चूका है .
-auth.login=लोग  इन
-auth.login.tooManyAttempts=अपने लोग इन करने के बहुत सरे प्रयास कर लिए है, कृपया थोड़े देर में प्रयास करे|
-auth.password.invalid=अवैध उपयोक्तानाम / शब्दकूट. फिर कोशिश करें.
-auth.password.help=अपना पासवर्ड रिसेट करने के लिए रीसेट वाले बॉक्स को चेक करे और "मैं अपना पासवर्ड भूल गया हु" को क्लिक करे 
-auth.answer.invalid=अमान्य प्रयोक्तानाम और गुप्त उत्तर संयोजन. फिर कोशिश करें.
-auth.question.empty=अमान्य उपयोगकर्ता या गुप्त प्रश्न सेट नहीं किया गया. कृपया अपना पासवर्ड रीसेट करने में मदद के लिए एक प्रशासक से संपर्क करें.
-auth.question.fill=अपने जवाब में गुप्त प्रश्न को भरने के लिए
-auth.password.reset=आपका पासवर्ड रीसेट किया गया था. अपने नए पासवर्ड के लिए बक्से में भरें.
-auth.invalid=अमान्य सत्र वस्तु. फिर से लॉग इन करें.
-auth.forgotPassword.tooManyAttempts=अपने अपना पासवर्ड रीसेट करने के लिए कई बार प्रयास किया है. कृपया बाद में पुन: प्रयास करें.
-
-forgotPassword.help=अपने  प्रयोक्ता नाम भरें (और फिर बाद में अपने गुप्त प्रश्न का उत्तर) अपना पासवर्ड रीसेट करने के लिए 
-forgotPassword.showSecretQuestion=गुप्त प्रश्न दिखाए 
-forgotPassword.resetPassword=पासवर्ड रीसेट करें
-
-calendar.patient.lastVisit=अंतिम ज्ञात यात्रा 
-
-diagnosis.title=एक निदान का चयन करें
-conceptAnswer.title=एक उत्तर चुनें
+admin.title.short=प्रशासन
+admin.title=प्रबंधन/प्रशासन
+
+auth.logged.out=आप लोग आउट हो चुके है
+auth.session.expired=आपका सत्र समाप्त हो चूका है .
+auth.login=लोग  इन
+auth.login.tooManyAttempts=अपने लोग इन करने के बहुत सरे प्रयास कर लिए है, कृपया थोड़े देर में प्रयास करे|
+auth.password.invalid=अवैध उपयोक्तानाम / शब्दकूट. फिर कोशिश करें.
+auth.password.help=अपना पासवर्ड रिसेट करने के लिए रीसेट वाले बॉक्स को चेक करे और "मैं अपना पासवर्ड भूल गया हु" को क्लिक करे 
+auth.answer.invalid=अमान्य प्रयोक्तानाम और गुप्त उत्तर संयोजन. फिर कोशिश करें.
+auth.question.empty=अमान्य उपयोगकर्ता या गुप्त प्रश्न सेट नहीं किया गया. कृपया अपना पासवर्ड रीसेट करने में मदद के लिए एक प्रशासक से संपर्क करें.
+auth.question.fill=अपने जवाब में गुप्त प्रश्न को भरने के लिए
+auth.password.reset=आपका पासवर्ड रीसेट किया गया था. अपने नए पासवर्ड के लिए बक्से में भरें.
+auth.invalid=अमान्य सत्र वस्तु. फिर से लॉग इन करें.
+auth.forgotPassword.tooManyAttempts=अपने अपना पासवर्ड रीसेट करने के लिए कई बार प्रयास किया है. कृपया बाद में पुन: प्रयास करें.
+
+forgotPassword.help=अपने  प्रयोक्ता नाम भरें (और फिर बाद में अपने गुप्त प्रश्न का उत्तर) अपना पासवर्ड रीसेट करने के लिए 
+forgotPassword.showSecretQuestion=गुप्त प्रश्न दिखाए 
+forgotPassword.resetPassword=पासवर्ड रीसेट करें
+
+calendar.patient.lastVisit=अंतिम ज्ञात यात्रा 
+
+diagnosis.title=एक निदान का चयन करें
+conceptAnswer.title=एक उत्तर चुनें
 conceptAnswer.forConcept=
-dictionary.title.short=शब्दकोश
-dictionary.searchBox=वाक्यांश: खोजे 
-dictionary.includeRetired=सेवानिवृत्त अवधारणाओं शामिल करे 
-dictionary.verboseListing=वर्बोज़ लिस्टिंग
-dictionary.download.link=अवधारणा शब्दकोश को डाउनलोड करे 
-dictionary.download.description=CSV प्रारूप में ( CSV फ़ाइल गतिशील बनाता है जिसमें शब्दकोश नियम अवधारणाओं मौजूद होती है ) 
-dictionary.error.needName=आप एक स्थान के भीतर एक छोटी नाम या एक वर्णन निर्दिष्ट नहीं कर सकते जब तक आप नाम निर्दिष्ट नहीं करते 
-dictionary.questionsAnswered=प्रश्नों के उत्तर दिए
-dictionary.numobs=इस अवधारणा के लिए ओ बीएस : {0}
-dictionary.forms=का प्रयोग प्रपत्र <br/>इस अवधारणा
-dictionary.drugs=इस अवधारणा का उपयोग ड्रग्स
-dictionary.personattributetypes=व्यक्ति इस अवधारणा का उपयोग प्रकार गुण
-dictionary.programs=इस अवधारणा का उपयोग प्रोग्राम्स
-dictionary.programworkflows=इस अवधारणा का उपयोग कार्यक्रम वर्कफ़्लोज़
-dictionary.programworkflowstates=इस अवधारणा का उपयोग कार्यक्रम कार्यप्रवाह राज्य अमेरिका
-dictionary.resources=संसाधन
-dictionary.similarConcepts=समान अवधारणाओं
+dictionary.title.short=शब्दकोश
+dictionary.searchBox=वाक्यांश: खोजे 
+dictionary.includeRetired=सेवानिवृत्त अवधारणाओं शामिल करे 
+dictionary.verboseListing=वर्बोज़ लिस्टिंग
+dictionary.download.link=अवधारणा शब्दकोश को डाउनलोड करे 
+dictionary.download.description=CSV प्रारूप में ( CSV फ़ाइल गतिशील बनाता है जिसमें शब्दकोश नियम अवधारणाओं मौजूद होती है ) 
+dictionary.error.needName=आप एक स्थान के भीतर एक छोटी नाम या एक वर्णन निर्दिष्ट नहीं कर सकते जब तक आप नाम निर्दिष्ट नहीं करते 
+dictionary.questionsAnswered=प्रश्नों के उत्तर दिए
+dictionary.numobs=इस अवधारणा के लिए ओ बीएस : {0}
+dictionary.forms=का प्रयोग प्रपत्र <br/>इस अवधारणा
+dictionary.drugs=इस अवधारणा का उपयोग ड्रग्स
+dictionary.personattributetypes=व्यक्ति इस अवधारणा का उपयोग प्रकार गुण
+dictionary.programs=इस अवधारणा का उपयोग प्रोग्राम्स
+dictionary.programworkflows=इस अवधारणा का उपयोग कार्यक्रम वर्कफ़्लोज़
+dictionary.programworkflowstates=इस अवधारणा का उपयोग कार्यक्रम कार्यप्रवाह राज्य अमेरिका
+dictionary.resources=संसाधन
+dictionary.similarConcepts=समान अवधारणाओं
 dictionary.merriam=Merriam Webster
-dictionary.google=गूगल
+dictionary.google=गूगल
 dictionary.upToDate=UpToDate
 dictionary.dictionaryCom=Dictionary.com
-dictionary.testsOnline=लैब ऑनलाइन टेस्ट
-dictionary.containedInSets=सेट में निहित
-
-feedback.title=प्रतिपुष्टि
-feedback.success=आपकी प्रतिक्रिया सफलतापूर्वक प्रस्तुत किया गया है
-feedback.error=प्रतिक्रिया सबमिट करने में त्रुटि थी. बाद में पुन: प्रयास करें
-feedback.email=आपका ईमेल पता
-feedback.subject=विषय
-feedback.message=संदेश
-feedback.send=प्रतिक्रिया भेजें
-
-header.logged.in=वर्तमान में रूप में लॉग इन
-header.logged.out=लॉग इन नहीं है 
-header.login=लॉगिन
-header.logout=बाहर प्रवेश करें
-header.help=मदद
-
-help.about.text=OpenMRS को {0} उच्च स्तरीय परिचय {1}
-help.administrator.text=व्यवस्थापक की मार्गदर्शिका
-help.contact.text=OpenMRS टीम के साथ संपर्क में आने की आवश्यकता है? निम्नलिखित ओउत्लेट की जाँच करें.
-help.developer.text=डेवलपर की मार्गदर्शिका
-help.getting.started.guide.text=OpenMRS के साथ प्रारंभ करना
-help.guides.text=OpenMRS गाइड
-help.irc.text=OpenMRS टीम {0} इंटरनेट रिले चैट का उपयोग करने के साथ चैट. {1}
-help.mailing.text=एक {0} मेलिंग सूची में शामिल हो {1} जो सबसे अच्छा OpenMRS के आपके उपयोग फिट बैठती  है.
-help.modules.text=मॉड्यूल गाइड
-help.overview.text=OpenMRS अवलोकन
-help.technical.text={0} तकनीकी अवलोकन OpenMRS {1}
-help.title=OpenMRS मदद
-help.troubleshoot.text=समस्या निवारण मार्गदर्शिका
-help.user.text=उपयोगकर्ता के गाइड
-help.wiki.text=OpenMRS साथ एक मुद्दा रहा है? व्यापक, कभी OpenMRS समुदाय के साथ जुड़ें  {0}Wiki{1} 
-
-options.title=उपयोगकर्ता के विकल्प
-options.default.legend=डिफ़ॉल्ट्स
-options.default.location=डिफ़ॉल्ट स्थान
-options.default.locale=डिफ़ॉल्ट भाषा
-options.proficient.locales=प्रवीण स्थलों
-options.default.verbose=वर्बोज़ पर प्रदर्शन
-options.showRetiredMessage=सेवानिवृत्त संदेश दिखाएँ?
-options.login.legend=लॉगिन जानकारी बदलें
-options.login.username=प्रयोक्ता नाम
-options.login.password.old=पुराना पासवर्ड
-options.login.password.new=नया पासवर्ड
-options.login.password.confirm=नए पासवर्ड की पुष्टि
-options.login.secretQuestion.about=आप अपने गुप्त प्रश्न को संपादित या नीचे बदल सकते है. गुप्त प्रश्न आप अपना पासवर्ड भूल घटना में इस्तेमाल किया जा सकता है.
-options.login.secretQuestionNew=गुप्त प्रश्न
-options.login.secretAnswerNew=नई गुप्त जवाब
-options.login.secretAnswerConfirm=गुप्त उत्तर की पुष्टि
-options.login.password.minCharacterCount=कम से कम { 0} अक्षर का होना जरूरी
-options.login.password.containUpperCase=एक ऊपरी मामले वर्ण
-options.login.password.containNumber=कम से कम एक संख्या में होते हैं
-options.login.password.containNonNumber=कम से कम एक गैर संख्या में होते हैं
-options.login.password.cannotMatchUsername=उपयोगकर्ता नाम से मेल नहीं कर सकते
-options.login.password.null=पासवर्ड खाली या रिक्त नहीं हो सकता
-options.notify.legend=अधिसूचनाएं
-options.notify.internalOnly=प्रणाली के भीतर ही
-options.notify.internal=प्रणाली के भीतर है, लेकिन नए संदेशों के लिए ईमेल द्वारा सूचित करे 
-options.notify.internalProtected=जब संभव ईमेल करे, सुरक्षित डेटा के लिए प्रणाली का उपयोग करे
-options.notify.email=हमेशा ईमेल द्वारा
-options.notify.notificationAddress=इन्हें भेजें
-
-options.save=विकल्प को सहेजें
-options.saved=विकल्प सहेजा
-options.not.saved=बचाया नहीं विकल्प
-error.options.secretAnswer.match=जवाब नहीं मिलते 
-error.options.secretAnswer.empty=उत्तर खाली नहीं होना चाहिए
-error.options.secretQuestion.empty=प्रश्न खाली नहीं होना चाहिए
-error.username.weak=अमान्य प्रयोक्तानाम. कम से कम 6 अक्षरों का होना चाहिए
-error.username.invalid=अमान्य प्रयोक्तानाम. अक्षरांकीय उपयोगकर्ता नाम हो सकता है और एक नंबर के साथ शुरू नहीं करना चाहिए
+dictionary.testsOnline=लैब ऑनलाइन टेस्ट
+dictionary.containedInSets=सेट में निहित
+
+feedback.title=प्रतिपुष्टि
+feedback.success=आपकी प्रतिक्रिया सफलतापूर्वक प्रस्तुत किया गया है
+feedback.error=प्रतिक्रिया सबमिट करने में त्रुटि थी. बाद में पुन: प्रयास करें
+feedback.email=आपका ईमेल पता
+feedback.subject=विषय
+feedback.message=संदेश
+feedback.send=प्रतिक्रिया भेजें
+
+header.logged.in=वर्तमान में रूप में लॉग इन
+header.logged.out=लॉग इन नहीं है 
+header.login=लॉगिन
+header.logout=बाहर प्रवेश करें
+header.help=मदद
+
+help.about.text=OpenMRS को {0} उच्च स्तरीय परिचय {1}
+help.administrator.text=व्यवस्थापक की मार्गदर्शिका
+help.contact.text=OpenMRS टीम के साथ संपर्क में आने की आवश्यकता है? निम्नलिखित ओउत्लेट की जाँच करें.
+help.developer.text=डेवलपर की मार्गदर्शिका
+help.getting.started.guide.text=OpenMRS के साथ प्रारंभ करना
+help.guides.text=OpenMRS गाइड
+help.irc.text=OpenMRS टीम {0} इंटरनेट रिले चैट का उपयोग करने के साथ चैट. {1}
+help.mailing.text=एक {0} मेलिंग सूची में शामिल हो {1} जो सबसे अच्छा OpenMRS के आपके उपयोग फिट बैठती  है.
+help.modules.text=मॉड्यूल गाइड
+help.overview.text=OpenMRS अवलोकन
+help.technical.text={0} तकनीकी अवलोकन OpenMRS {1}
+help.title=OpenMRS मदद
+help.troubleshoot.text=समस्या निवारण मार्गदर्शिका
+help.user.text=उपयोगकर्ता के गाइड
+help.wiki.text=OpenMRS साथ एक मुद्दा रहा है? व्यापक, कभी OpenMRS समुदाय के साथ जुड़ें  {0}Wiki{1} 
+
+options.title=उपयोगकर्ता के विकल्प
+options.default.legend=डिफ़ॉल्ट्स
+options.default.location=डिफ़ॉल्ट स्थान
+options.default.locale=डिफ़ॉल्ट भाषा
+options.proficient.locales=प्रवीण स्थलों
+options.default.verbose=वर्बोज़ पर प्रदर्शन
+options.showRetiredMessage=सेवानिवृत्त संदेश दिखाएँ?
+options.login.legend=लॉगिन जानकारी बदलें
+options.login.username=प्रयोक्ता नाम
+options.login.password.old=पुराना पासवर्ड
+options.login.password.new=नया पासवर्ड
+options.login.password.confirm=नए पासवर्ड की पुष्टि
+options.login.secretQuestion.about=आप अपने गुप्त प्रश्न को संपादित या नीचे बदल सकते है. गुप्त प्रश्न आप अपना पासवर्ड भूल घटना में इस्तेमाल किया जा सकता है.
+options.login.secretQuestionNew=गुप्त प्रश्न
+options.login.secretAnswerNew=नई गुप्त जवाब
+options.login.secretAnswerConfirm=गुप्त उत्तर की पुष्टि
+options.login.password.minCharacterCount=कम से कम { 0} अक्षर का होना जरूरी
+options.login.password.containUpperCase=एक ऊपरी मामले वर्ण
+options.login.password.containNumber=कम से कम एक संख्या में होते हैं
+options.login.password.containNonNumber=कम से कम एक गैर संख्या में होते हैं
+options.login.password.cannotMatchUsername=उपयोगकर्ता नाम से मेल नहीं कर सकते
+options.login.password.null=पासवर्ड खाली या रिक्त नहीं हो सकता
+options.notify.legend=अधिसूचनाएं
+options.notify.internalOnly=प्रणाली के भीतर ही
+options.notify.internal=प्रणाली के भीतर है, लेकिन नए संदेशों के लिए ईमेल द्वारा सूचित करे 
+options.notify.internalProtected=जब संभव ईमेल करे, सुरक्षित डेटा के लिए प्रणाली का उपयोग करे
+options.notify.email=हमेशा ईमेल द्वारा
+options.notify.notificationAddress=इन्हें भेजें
+
+options.save=विकल्प को सहेजें
+options.saved=विकल्प सहेजा
+options.not.saved=बचाया नहीं विकल्प
+error.options.secretAnswer.match=जवाब नहीं मिलते 
+error.options.secretAnswer.empty=उत्तर खाली नहीं होना चाहिए
+error.options.secretQuestion.empty=प्रश्न खाली नहीं होना चाहिए
+error.username.weak=अमान्य प्रयोक्तानाम. कम से कम 6 अक्षरों का होना चाहिए
+error.username.invalid=अमान्य प्रयोक्तानाम. अक्षरांकीय उपयोगकर्ता नाम हो सकता है और एक नंबर के साथ शुरू नहीं करना चाहिए
 error.username.email=Invalid username.  Username must be a valid e-mail.
-error.retired.requireMetadata=कौन इसे सेवानिवृत्त किया और क्यों?
-error.options.notificationAddress.invalid=अवैध सूचनाएं ईमेल पते
-error.options.notificationAddress.empty=ई-मेल पता निर्दिष्ट नहीं सूचनाएं
-
-changePassword.hint.password.length= पासवर्ड कम से कम {0} चरित्र होना चाहिए
-changePassword.hint.password.bothCasesRequired=दोनों ऊपरी और लोअरकेस अक्षर
-changePassword.hint.password.digitRequired=कम से कम एक अंक
-changePassword.hint.password.nonDigitRequired=कम से कम एक गैर अंक
-
-patientDashboard.overview=अवलोकन
-patientDashboard.summary=सारांश
-patientDashboard.regimens=रेगिमेंस 
-patientDashboard.encounters=सामना
-patientDashboard.demographics=जनसांख्यिकी
-patientDashboard.deceased=मृतक
-patientDashboard.graphs=रेखाचित्र
-patientDashboard.graphs.title=समय पर
-patientDashboard.graphs.hide=ग्राफ छिपाएँ
-patientDashboard.graphs.show=ग्राफ दिखाये 
-patientDashboard.formEntry=प्रपत्र एंट्री
-patientDashboard.viewDashboard=रोगी डैशबोर्ड दिखाये
-patientDashboard.showMoreIdentifers=अधिक पहचानकर्ता दिखाएँ
-patientDashboard.mostRecentObs=सबसे हाल ही की टिप्पणियो दिखाए 
-PatientDashboard.backToPatientDashboard=वापस रोगी डैशबोर्ड में जाये 
-patientDashboard.visits=दौरे 
-patientDashboard.visits.showing.pages=के पृष्ठ {0} दिखा रहा है {1}
-patientDashboard.noPatientWithId=आईडी के साथ कोई रोगी नहीं है : {0}
-
-patientGraphs.addNewGraph=नया ग्राफ जोड़ें
-
-provider.title=एक प्रदाता का चयन करें
-provider.missing=Matata! मैं किसी भी प्रदाताओं को खोजने में असमर्थ था ।  कृपया <a href="javascript:reloadPage()">पुनः प्रयास करें</a>.  इस समस्या बनी रहती है, तो तुरंत उस अनुकूल व्यवस्थापक से संपर्क करें!
-provider.chw.id=ऑकोम्पग्नतेउर आईडी 
-provider.chw.names=ऑकोम्पग्नतेउर का पूरा नाम 
-
-require.login=आपको जारी रखने के लिए लॉगिन करना होगा.
-require.unauthorized=आप इस पेज को देखने के लिए अधिकृत नहीं हैं.
-require.ip_addr=अमान्य सत्र वस्तु.
-
-typeMismatch.java.util.Date={0} एक अमान्य तिथि है
-typeMismatch.java.lang.Integer={0} एक मान्य पूर्णांक मान नहीं है
-typeMismatch.java.lang.Long={0}एक वैध मूल्य नहीं है. दशमलव या वर्ण का उपयोग नहीं करें.
-
-welcome=आपका स्वागत है <span class="webappName">{0}</span>. आगे बढ़ने के लिए कृपया लॉग इन करें.
-welcomeUser=नमस्कार, {0}. आपका स्वागत है  <span class\="webappName">{1}</span>. 
+error.retired.requireMetadata=कौन इसे सेवानिवृत्त किया और क्यों?
+error.options.notificationAddress.invalid=अवैध सूचनाएं ईमेल पते
+error.options.notificationAddress.empty=ई-मेल पता निर्दिष्ट नहीं सूचनाएं
+
+changePassword.hint.password.length= पासवर्ड कम से कम {0} चरित्र होना चाहिए
+changePassword.hint.password.bothCasesRequired=दोनों ऊपरी और लोअरकेस अक्षर
+changePassword.hint.password.digitRequired=कम से कम एक अंक
+changePassword.hint.password.nonDigitRequired=कम से कम एक गैर अंक
+
+patientDashboard.overview=अवलोकन
+patientDashboard.summary=सारांश
+patientDashboard.regimens=रेगिमेंस 
+patientDashboard.encounters=सामना
+patientDashboard.demographics=जनसांख्यिकी
+patientDashboard.deceased=मृतक
+patientDashboard.graphs=रेखाचित्र
+patientDashboard.graphs.title=समय पर
+patientDashboard.graphs.hide=ग्राफ छिपाएँ
+patientDashboard.graphs.show=ग्राफ दिखाये 
+patientDashboard.formEntry=प्रपत्र एंट्री
+patientDashboard.viewDashboard=रोगी डैशबोर्ड दिखाये
+patientDashboard.showMoreIdentifers=अधिक पहचानकर्ता दिखाएँ
+patientDashboard.mostRecentObs=सबसे हाल ही की टिप्पणियो दिखाए 
+PatientDashboard.backToPatientDashboard=वापस रोगी डैशबोर्ड में जाये 
+patientDashboard.visits=दौरे 
+patientDashboard.visits.showing.pages=के पृष्ठ {0} दिखा रहा है {1}
+patientDashboard.noPatientWithId=आईडी के साथ कोई रोगी नहीं है : {0}
+
+patientGraphs.addNewGraph=नया ग्राफ जोड़ें
+
+provider.title=एक प्रदाता का चयन करें
+provider.missing=Matata! मैं किसी भी प्रदाताओं को खोजने में असमर्थ था ।  कृपया <a href="javascript:reloadPage()">पुनः प्रयास करें</a>.  इस समस्या बनी रहती है, तो तुरंत उस अनुकूल व्यवस्थापक से संपर्क करें!
+provider.chw.id=ऑकोम्पग्नतेउर आईडी 
+provider.chw.names=ऑकोम्पग्नतेउर का पूरा नाम 
+
+require.login=आपको जारी रखने के लिए लॉगिन करना होगा.
+require.unauthorized=आप इस पेज को देखने के लिए अधिकृत नहीं हैं.
+require.ip_addr=अमान्य सत्र वस्तु.
+
+typeMismatch.java.util.Date={0} एक अमान्य तिथि है
+typeMismatch.java.lang.Integer={0} एक मान्य पूर्णांक मान नहीं है
+typeMismatch.java.lang.Long={0}एक वैध मूल्य नहीं है. दशमलव या वर्ण का उपयोग नहीं करें.
+
+welcome=आपका स्वागत है <span class="webappName">{0}</span>. आगे बढ़ने के लिए कृपया लॉग इन करें.
+welcomeUser=नमस्कार, {0}. आपका स्वागत है  <span class\="webappName">{1}</span>. 
 
 #
 #### Openmrs POJO messages #### 
 #
-Alert.mark=पढ़ें के रूप में इस चेतावनी को चिन्हित करे 
-Alert.markAsRead=पढ़ा हुआ चिन्हित करे 
-Alert.markAllAsRead=पढ़ें के रूप में सभी के निशान
-Alert.markAllAlertsAsRead=पढ़ें के रूप में सभी अलर्ट मार्क
-Alert.mark.satisfiedByAny=इस चेतावनी  को पढना सभी प्राप्तकर्ताओं के पढने के बराबर है 
-Alert.unreadAlert=आप के पास <span id="unreadAlertSize">1</span> अपठित चेतावनी है
-Alert.unreadAlerts= आप के पास<span id="unreadAlertSize">{0}</span> अपठित चेतावनी है
-Alert.assignedTo=को सोपा है 
-Alert.assignedTo.recipients={0} प्राप्तकर्ताओं
-Alert.assignedTo.recipient=एक प्राप्तकर्ता
-Alert.recipients=प्राप्तकर्ता
-Alert.roles=भूमिकाओं
-Alert.text=चेतावनी का पाठ 
-Alert.text.required=चेतावनी पाठ की आवश्यकता है
-Alert.dateToExpire=निश्वासन तिथि
-Alert.satisfiedByAny=किसी से संतुष्ट
-Alert.satisfiedByAny.description=चेतावनी सभी प्राप्तकर्ताओं के लिए पढ़ी चिह्नित की जायगे, जब एक बार एक प्राप्तकर्ता इसे पढ़ा हुआ चिन्हित कर देगा.
-Alert.manage.titlebar=चेतावनी प्रबंधन - OpenMRS
-Alert.manage.title=चेतावनी प्रबंधन
-Alert.add=चेतावनी जोड़ें
-Alert.list.title=चेतावनियाँ
-Alert.expire=चयनित अलर्ट को निश्वासीट करे निश्वासन
-Alert.includeExpired=निश्वासीट शामिल करे 
-Alert.save=चेतावनी को सहेजें
-Alert.recipientRequired=कम - से - कम एक प्राप्तकर्ता की आवश्यकता है
-Alert.manage=चेतावनी प्रबंधन 
-Alert.expired={0} चेतावनी (ओं) को सफलतापूर्वक समाप्त हो गई किया गया है 
-Alert.addRole=रोल जोड़ें
-Alert.select=आपको कम से कम एक चेतावनी का चयन करना होगा.
-
-Concept=अवधारणा
-Concept.header=अवधारणाओं
-Concept.manage=शब्दकोश अवधारणयहे देखे 
-Concept.title=अवधारणा प्रपत्र
-Concept.conceptId.help=इस अवधारणा के लिए एक आंतरिक अद्वितीय पहचान
-Concept.conceptClass=वर्ग
-Concept.shortName=संक्षिप्त नाम
-Concept.datatype=डेटा प्रकार
+Alert.mark=पढ़ें के रूप में इस चेतावनी को चिन्हित करे 
+Alert.markAsRead=पढ़ा हुआ चिन्हित करे 
+Alert.markAllAsRead=पढ़ें के रूप में सभी के निशान
+Alert.markAllAlertsAsRead=पढ़ें के रूप में सभी अलर्ट मार्क
+Alert.mark.satisfiedByAny=इस चेतावनी  को पढना सभी प्राप्तकर्ताओं के पढने के बराबर है 
+Alert.unreadAlert=आप के पास <span id="unreadAlertSize">1</span> अपठित चेतावनी है
+Alert.unreadAlerts= आप के पास<span id="unreadAlertSize">{0}</span> अपठित चेतावनी है
+Alert.assignedTo=को सोपा है 
+Alert.assignedTo.recipients={0} प्राप्तकर्ताओं
+Alert.assignedTo.recipient=एक प्राप्तकर्ता
+Alert.recipients=प्राप्तकर्ता
+Alert.roles=भूमिकाओं
+Alert.text=चेतावनी का पाठ 
+Alert.text.required=चेतावनी पाठ की आवश्यकता है
+Alert.dateToExpire=निश्वासन तिथि
+Alert.satisfiedByAny=किसी से संतुष्ट
+Alert.satisfiedByAny.description=चेतावनी सभी प्राप्तकर्ताओं के लिए पढ़ी चिह्नित की जायगे, जब एक बार एक प्राप्तकर्ता इसे पढ़ा हुआ चिन्हित कर देगा.
+Alert.manage.titlebar=चेतावनी प्रबंधन - OpenMRS
+Alert.manage.title=चेतावनी प्रबंधन
+Alert.add=चेतावनी जोड़ें
+Alert.list.title=चेतावनियाँ
+Alert.expire=चयनित अलर्ट को निश्वासीट करे निश्वासन
+Alert.includeExpired=निश्वासीट शामिल करे 
+Alert.save=चेतावनी को सहेजें
+Alert.recipientRequired=कम - से - कम एक प्राप्तकर्ता की आवश्यकता है
+Alert.manage=चेतावनी प्रबंधन 
+Alert.expired={0} चेतावनी (ओं) को सफलतापूर्वक समाप्त हो गई किया गया है 
+Alert.addRole=रोल जोड़ें
+Alert.select=आपको कम से कम एक चेतावनी का चयन करना होगा.
+
+Concept=अवधारणा
+Concept.header=अवधारणाओं
+Concept.manage=शब्दकोश अवधारणयहे देखे 
+Concept.title=अवधारणा प्रपत्र
+Concept.conceptId.help=इस अवधारणा के लिए एक आंतरिक अद्वितीय पहचान
+Concept.conceptClass=वर्ग
+Concept.shortName=संक्षिप्त नाम
+Concept.datatype=डेटा प्रकार
 Concept.icd10=ICD10
 Concept.loinc=LOINC
-Concept.suggestions=सुझाव
-Concept.synonym.add=समानार्थी शब्द जोड़ें
-Concept.synonyms=समानार्थी
-Concept.answers=जवाब
-Concept.version=संस्करण
-Concept.conceptSets=सदस्य सेट
-Concept.conceptSets.help=अवधारणाओं जो की वर्तमान अवधारणा के तहत पैक हो सकते है
-Concept.conceptSets.empty=(खाली समूह)
-Concept.save=अवधारणा सहेजें
-Concept.saveAndContinue=सहेजें और जारी रखें
-Concept.cancel=रद्द करना
-Concept.delete=अवधारणा हटाएँ
-Concept.find=अवधारणाओं को खोजें
-Concept.retiredMessage=यह अवधारणा सेवानिवृत्त है
-Concept.name=अवधारणा का नाम
-Concept.name.atLeastOneRequired=कम से कम एक गैर खाली नाम की आवश्यकता है
-Concept.shortName.help=पाठ रिपोर्ट हेडर और अन्य स्थानों पर जहां स्थान सीमित है में दिखाया गया है.
-Concept.datatype.help=यदि इस अवधारणा के भीतर डेटा संग्रहीत किया जाता है, यह बताता है कि यह क्या की तरह दिखेगा.
-Concept.datatype.coded.help=उत्तर अवधारणा (ओं) के मामले में इस अवधारणा को एक सवाल है
-Concept.datatype.numeric.help=संख्यात्मक मूल्य पर्वतमाला
-Concept.datatype.complex.help=अवलोकन डेटा इस अवधारणा में संग्रहीत किया जाता है. इस अवधारणा के डेटा प्रकार को अब बदला नहीं जा सकता.
-Concept.datatype.readonly=अवलोकन डेटा इस अवधारणा का उपयोग करके संग्रहीत किया गया है . इस अवधारणा के डेटाप्रकार अब बदला नहीं जा सकता..
-Concept.synonyms.help=कोई लेबल या नाम जो एक प्राथमिक अवधारणा को संदर्भित करता है.
-Concept.synonyms.voidReasonRequired=एक कारण वोइदेद समानार्थी शब्द के लिए आवश्यक है.
-Concept.synonyms.textRequired=एक खाली समानार्थी की अनुमति नहीं है
-Concept.description.help=लंबा पाठ का उपयोग करके इस अवधारणा का वर्णन किया गया है और कैसे यह प्रयोग किया जाता है.
-Concept.conceptClass.help=चिकित्सा अवधारणा का वर्गीकरण
-Concept.saved=अवधारणा सफलतापूर्वक सहेजा गया
-Concept.cannot.save=अवधारणा को संरक्षित नहीं किया जा सकता
-Concept.concepts.locked=अवधारणा संपादन बंद कर दिया है. कोई संपादन की अनुमति नहीं है.
-Concept.deleted=अवधारणा सफलतापूर्वक हटाया गया
-Concept.cannot.delete=अवधारणा को हटा नहीं सकते. डेटाबेस बाधाओं का उल्लंघन होगा क्योंकि इस अवधारणा को अन्य वस्तुओं के द्वारा उपयोग में लिया जा रहा है.
-Concept.resources=संसाधन
-Concept.forms=इस अवधारणा का उपयोग करने वाले फॉर्म्स
-Concept.add=नई अवधारणा जोड़ें
-Concept.id=अवधारणा आईडी
-Concept.set=क्या सेट
-Concept.checkClassAndDatatype=कृपया सुनिश्चित करें कि इस अवधारणा वर्ग का डेटाप्रकार सही हैं. (class\=Question should typically not be datatype\=N/A.) 
-Concept.search=नाम या आईडी टाइप करके एक अवधारणा का पता लगाएं
-Concept.search.placeholder=अवधारणा नाम या आईडी दर्ज करें
-Concept.view.title=अवधारणा देखना : {0}
-Concept.view.titlebar=OpenMRS - अवधारणा देखना {0}
-Concept.edit.titlebar=OpenMRS - अवधारणा संपादन {0}
-Concept.edit.title=अवधारणा संपादन : {0}
+Concept.suggestions=सुझाव
+Concept.synonym.add=समानार्थी शब्द जोड़ें
+Concept.synonyms=समानार्थी
+Concept.answers=जवाब
+Concept.version=संस्करण
+Concept.conceptSets=सदस्य सेट
+Concept.conceptSets.help=अवधारणाओं जो की वर्तमान अवधारणा के तहत पैक हो सकते है
+Concept.conceptSets.empty=(खाली समूह)
+Concept.save=अवधारणा सहेजें
+Concept.saveAndContinue=सहेजें और जारी रखें
+Concept.cancel=रद्द करना
+Concept.delete=अवधारणा हटाएँ
+Concept.find=अवधारणाओं को खोजें
+Concept.retiredMessage=यह अवधारणा सेवानिवृत्त है
+Concept.name=अवधारणा का नाम
+Concept.name.atLeastOneRequired=कम से कम एक गैर खाली नाम की आवश्यकता है
+Concept.shortName.help=पाठ रिपोर्ट हेडर और अन्य स्थानों पर जहां स्थान सीमित है में दिखाया गया है.
+Concept.datatype.help=यदि इस अवधारणा के भीतर डेटा संग्रहीत किया जाता है, यह बताता है कि यह क्या की तरह दिखेगा.
+Concept.datatype.coded.help=उत्तर अवधारणा (ओं) के मामले में इस अवधारणा को एक सवाल है
+Concept.datatype.numeric.help=संख्यात्मक मूल्य पर्वतमाला
+Concept.datatype.complex.help=अवलोकन डेटा इस अवधारणा में संग्रहीत किया जाता है. इस अवधारणा के डेटा प्रकार को अब बदला नहीं जा सकता.
+Concept.datatype.readonly=अवलोकन डेटा इस अवधारणा का उपयोग करके संग्रहीत किया गया है . इस अवधारणा के डेटाप्रकार अब बदला नहीं जा सकता..
+Concept.synonyms.help=कोई लेबल या नाम जो एक प्राथमिक अवधारणा को संदर्भित करता है.
+Concept.synonyms.voidReasonRequired=एक कारण वोइदेद समानार्थी शब्द के लिए आवश्यक है.
+Concept.synonyms.textRequired=एक खाली समानार्थी की अनुमति नहीं है
+Concept.description.help=लंबा पाठ का उपयोग करके इस अवधारणा का वर्णन किया गया है और कैसे यह प्रयोग किया जाता है.
+Concept.conceptClass.help=चिकित्सा अवधारणा का वर्गीकरण
+Concept.saved=अवधारणा सफलतापूर्वक सहेजा गया
+Concept.cannot.save=अवधारणा को संरक्षित नहीं किया जा सकता
+Concept.concepts.locked=अवधारणा संपादन बंद कर दिया है. कोई संपादन की अनुमति नहीं है.
+Concept.deleted=अवधारणा सफलतापूर्वक हटाया गया
+Concept.cannot.delete=अवधारणा को हटा नहीं सकते. डेटाबेस बाधाओं का उल्लंघन होगा क्योंकि इस अवधारणा को अन्य वस्तुओं के द्वारा उपयोग में लिया जा रहा है.
+Concept.resources=संसाधन
+Concept.forms=इस अवधारणा का उपयोग करने वाले फॉर्म्स
+Concept.add=नई अवधारणा जोड़ें
+Concept.id=अवधारणा आईडी
+Concept.set=क्या सेट
+Concept.checkClassAndDatatype=कृपया सुनिश्चित करें कि इस अवधारणा वर्ग का डेटाप्रकार सही हैं. (class\=Question should typically not be datatype\=N/A.) 
+Concept.search=नाम या आईडी टाइप करके एक अवधारणा का पता लगाएं
+Concept.search.placeholder=अवधारणा नाम या आईडी दर्ज करें
+Concept.view.title=अवधारणा देखना : {0}
+Concept.view.titlebar=OpenMRS - अवधारणा देखना {0}
+Concept.edit.titlebar=OpenMRS - अवधारणा संपादन {0}
+Concept.edit.title=अवधारणा संपादन : {0}
 Concept.view.header=Viewing Concept {0}
 Concept.edit.header=Editing Concept {0}
-Concept.name.duplicate=पूरी तरह से निर्दिष्ट या पसंदीदा नाम नकली है
-Concept.name.tag.duplicate=संकल्पना का नाम पहले से ही इस निर्दिष्ट अवधारणा नाम टैग है
-Concept.boolean.add.answer=दूसरा उत्तर जोड़ें
-Concept.boolean.warning.irreversible=यह अपरिवर्तनीय है
-Concept.boolean.change.tooltip=बूलीयन अवधारणा में अन्य संभावित जवाब जोड़ने के लिए अनुमति देता है
-Concept.boolean.confirm.add.answer=क्या आप सुनिश्चित करते है कि आप एक और जवाब जोड़ना चाहते हैं?
-Concept.name.localePreferred=पसंदीदा 
-Concept.name.localePreferred.help=क्या यह नाम अपनी भाषा में पसंदीदा नाम है और डिफ़ॉल्ट रूप से लौटा दिया जायगा जैसे की रिपोर्ट्स में.
-Concept.name.help=यदि कोई हो स्थान में पसंदीदा नाम, अन्यथा पूरी तरह से नाम निर्दिष्ट करे 
-Concept.id.help=सिस्टम अद्वितीय आईडी उत्पन्न
-Concept.uiid.help=सिस्टम अद्वितीय ID उत्पन्न
-Concept.locale.help=स्थान जिसमें अवधारणा नाम के अंतर्गत आता है
-Concept.retired.help=क्या अवधारणा उपयोग में नहीं रह गया है
-Concept.isSet.help=यह अवधारणा सेट है या नहीं.
-Concept.version.help=अवधारणा के लिए संस्करण संख्या
-Concept.error.multipleLocalePreferredNames=केवल एक पसंदीदा नाम प्रत्येक स्थान के लिए आनुमानित है  
-Concept.error.multipleFullySpecifiedNames=केवल एक पूरी तरह से निर्दिष्ट नाम प्रत्येक स्थान के लिए आनुमानित है  
-Concept.error.preferredName.is.indexTerm=एक सूचकांक शब्द पसंदीदा नाम नहीं हो सकता है
-Concept.error.multipleShortNames=केवल एक छोटा नाम प्रत्येक स्थान के लिए अनुमानित है 
-Concept.error.no.FullySpecifiedName=इस अवधारणा के लिए निर्दिष्ट नहीं पूरी तरह से नाम
-Concept.error.invalid.locale=आप केवल उन्ही लोकेल का उपयोग करे जो अनुमति लोकेल की सूचि में है.
-Concept.no.fullySpecifiedName.found=- <i>नाम निर्दिष्ट नहीं पूरी तरह से इस अवधारणा के लिए पाया</>
-Concept.indexTerms=खोज नियम
-Concept.indexTerm.add=खोज शब्द जोड़ें
-Concept.indexTerms.help=कोई लेबल या नाम है जो एक प्राथमिक अवधारणा को संदर्भित करता है जैसे स्पेल्लिंग में गलती 
-Concept.indexTerms.voidReasonRequired=एक कारण खाली खोज शब्दों के लिए आवश्यक है
-Concept.indexTerms.textRequired=एक खाली खोज शब्द की अनुमति नहीं है
-Concept.error.preferredName.is.shortName=एक छोटा नाम पसंदीदा नाम नहीं हो सकता है
-Concept.error.preferredName.is.voided=एक खाली अवधारणा नाम पसंदीदा नाम नहीं हो सकता है
-Concept.error.fullySpecifiedName.is.voided=एक खाली अवधारणा का नाम पूरी तरह से निर्दिष्ट नहीं किया जा सकता
-Concept.error.fullySpecifiedName.notUnique=पूरी तरह से निर्दिष्ट नाम अद्वितीय होना चाहिए। इस नाम के साथ एक अवधारणा वहां पहले से ही है ।
-Concept.voided.help=क्या अवधारणा का नाम प्रयोग में नहीं रह गया है
-Concept.fullySpecified.help=नाम जिसका उपयोग फॉर्म और रिपोर्ट आदि में हो सकता है अगर वोह किसी पसंदीदा नाम के लिए सेट नहीं है 
-Concept.fullySpecifiedName=पूरी तरह से निर्दिष्ट नाम
-Concept.localesWithErrors=निम्नलिखित लोकेल (ओं) में त्रुटियां मिली:
-Concept.name.empty=नाम खाली या सफेद स्थान चरित्र (ओं) ही नहीं होना चाहिए
-Concept.fullySpecified.textRequired=पूरी तरह से खाली निर्दिष्ट नाम की अनुमति नहीं है
-Concept.delete.hasNameInUse=एक अवधारणा जिसका कुछ अवलोकन (ओं) में इस्तेमाल किया जा रहा है उसको हटाया नहीं जा सकता 
-Concept.name.voidReason.nameChanged=नाम के परिवर्तन के कारण खाली 
-Concept.search.error=अवधारणाओं को खोजने का प्रयास करते समय त्रुटि
-Concept.concept.retired.successFully=अवधारणा सफलतापूर्वक सेवानिवृत्त
-Concept.concept.unRetired.successFully=अवधारणा सफलतापूर्वक अनसेवानिवृत्त 
-Concept.concepts.locked.unRetire=अवधारणा बंद कर दिया है.अनसेवानिवृत्त की अनुमति नहीं है.
-Concept.drugFormulations=इस अवधारणा के लिए दवा फार्मूलों
-Concept.manageDrugFormulary=ड्रग फार्मूलरी प्रबंधित
-
-ConceptStopWord.manage=अवधारणा स्टॉप शब्द प्रबंधन
-ConceptStopWord.title=अवधारणा स्टॉप शब्द
-ConceptStopWord.add=नई अवधारणा स्टॉप शब्द जोड़ें
-ConceptStopWord.list.title=वर्तमान अवधारणा रोक शब्दों
-ConceptStopWord.delete=चयनित अवधारणा रोक शब्दों हटाएँ
-ConceptStopWord.save=अवधारणा स्टॉप शब्द सहेजें
-ConceptStopWord.saved=अवधारणा बंद करो शब्द को सहेजा 
-ConceptStopWord.duplicated=अवधारणा बंद करो शब्द पहले से मौजूद है
-ConceptStopWord.notSaved=अवधारणा बंद करो शब्द नहीं बचाया गया
-ConceptStopWord.error.value.empty=अवधारणा स्टॉप शब्द खाली नहीं हो सकता
-ConceptStopWord.error.notfound=अवधारणा बंद करो शब्द पहले से ही नष्ट कर दिया है या नहीं है 
-ConceptStopWord.error.notSelect=कोई अवधारणा स्टॉप (ओं) शब्द चयनित नहीं है 
-
-Concept.stats.titlebar=OpenMRS - अवधारणा के लिए सांख्यिकी {0}
-Concept.stats.title=अवधारणा के लिए सांख्यिकी {0}
-Concept.stats.header=संकल्पना के लिए सांख्यिकी {0}
-Concept.creatingNewConcept.title=OpenMRS - नई अवधारणा बनाने
-Concept.noConceptSelected=अवधारणाओं नहीं पाई गयी  - अवैध अवधारणा आईडी
-Concept.creatingNewConcept.titlebar=OpenMRS - नई अवधारणा बनाना 
-Concept.creatingNewConcept=नई अवधारणा बनाना 
-Concept.confirmDelete=क्या आप सुनिश्चित करें कि आप इस पूरी अवधारणा को हटाना चाहते हैं?
-Concept.mappings=मैपिंग
-Concept.mappings.help=इस अवधारणा से अन्य अवधारणा स्रोतों की किसी भी संख्या के लिए मैपिंग को परिभाषित करता है (ICD9, SNOMED, etc)
-Concept.mapping.add=मैपिंग जोड़ें
-Concept.map.termRequired=संदर्भ अवधि के लिए आवश्यक है
-Concept.map.typeRequired=अवधारणा नक्शा प्रकार आवश्यक है
-Concept.mappings.type=मानचित्र के प्रकार
-Concept.mappings.relationship=संबंध
-Concept.mapping.sourceUnavailable=कोई अवधारणा स्रोत नक्शा करने के लिए उपलब्ध है
-Concept.mapping.sourceAdd=स्रोत जोड़ें
-Concept.mappings.sourceCodeRequired=सोर्स कोड की आवश्यकता है
-Concept.wikipedia=विकिपीडिया
-Concept.newLocale=इस अवधारणा के लिए जोड़ने के लिए एक नया लोकेल निर्दिष्ट करे.
-Concept.newLocale.label=लोकेल विनिर्देश (example en_GB)
-Concept.usage=संकल्पना उपयोग
-
-Concept.stats=आँकड़े
-Concept.stats.numberObsAnsweredByConcept=अवलोकन अवधारणा ने उत्तर
-Concept.stats.numberObs=अवलोकन की संख्या
-Concept.stats.minValue=न्यूनतम
-Concept.stats.maxValue=अधिकतम
-Concept.stats.meanValue=माध्य
-Concept.stats.medianValue=मंझला
-Concept.stats.histogram=आयतचित्र
-Concept.stats.timePlot=समय प्लॉट
-Concept.stats.histogramDomainAxisTitle=मूल्य
-Concept.stats.histogramRangeAxisTitle=घटनाओं
-Concept.stats.lineChartDomainAxisLabel=समय
-Concept.stats.lineChartRangeAxisLabel=मूल्य
-Concept.stats.histogramOutliers=आयतचित्र (औत्लिएर के बिना )
-Concept.stats.histogram.showOutliers=उत्लिएर्स दिखाएँ
-Concept.stats.histogram.hideOutliers=उत्लिएर्स छिपाना
-Concept.stats.timeSeriesDomainAxisLabel=तारीख
-Concept.stats.timeSeriesRangeAxisLabel=मूल्य
-Concept.stats.timeSeries=काल श्रेणी
-Concept.stats.notDisplayable=आँकड़े इस अवधारणा के लिए उपलब्ध नहीं हैं. केवल संख्यात्मक, कोडित, और बूलियन आँकड़े वर्तमान में उपलब्ध हैं.
-Concept.stats.codedPieChart=कोडित उत्तर पाई चार्ट
-Concept.stats.booleanPieChart=बूलियन उत्तर पाई चार्ट
-
-ConceptClass.manage=अवधारणा क्लासेस प्रबंधन
-ConceptClass.manage.title=अवधारणा क्लास प्रबंधन
-ConceptClass.title=अवधारणा क्लास फार्म
-ConceptClass.save=अवधारणा क्लास सहेजें
-ConceptClass.add=अवधारणा क्लास जोड़ें
-ConceptClass.list.title=वर्तमान अवधारणा क्लासेस
-ConceptClass.delete=चयनित अवधारणा श्रेणी हटाएं
-ConceptClass.saved=अवधारणा क्लास को बचाया
-ConceptClass.deleted=अवधारणा कक्षा हटाया
-ConceptClass.cannot.delete=अवधारणा वर्ग को नष्ट नहीं किया जा सकता. डेटाबेस बाधाओं का उल्लंघन किया जाएगा.
-ConceptClass.select=आपको कम से कम एक अवधारणा वर्ग का चयन करना होगा.
-
-ConceptDatatype.manage=अवधारणा डेटाटाइप प्रबंधन
-ConceptDatatype.manage.title=अवधारणा डाटाटाइप प्रबंधन
-ConceptDatatype.title=अवधारणा डाटाटाइप प्रपत्र
-ConceptDatatype.save=अवधारणा डाटाटाइप सहेजें
-ConceptDatatype.add=अवधारणा डाटाटाइप जोड़ें
-ConceptDatatype.list.title=वर्तमान अवधारणा डेटाटाइप
-ConceptDatatype.delete=चयनित अवधारणा डेटाटाइप हटाएं
-ConceptDatatype.saved=अवधारणा डाटाटाइप को बचाया
-ConceptDatatype.deleted=अवधारणा डाटाटाइप हटाया
-ConceptDatatype.hl7Abbreviation=HL7 संक्षिप्तीकरण
-
-ConceptDrug.manage=अवधारणा ड्रग्स प्रबंधन
-ConceptDrug.manage.title=अवधारणा औषध प्रबंधन
-ConceptDrug.title=अवधारणा औषध प्रपत्र
-ConceptDrug.save=अवधारणा औषध सहेजें
-ConceptDrug.add=अवधारणा औषध जोड़ें
-ConceptDrug.saved=अवधारणा औषध को बचाया
-ConceptDrug.find=खोजे अवधारणा ड्रग्स
-ConceptDrug.search=अवधारणा दवा के नाम पर खोजें
-ConceptDrug.concept=अवधारणा
-ConceptDrug.combination=संयोजन
-ConceptDrug.dosageForm=खुराक फार्म
-ConceptDrug.doseStrength=खुराक शक्ति
-ConceptDrug.minimumDailyDose=अल्पतम मात्रा
-ConceptDrug.maximumDailyDose=महतम मात्रा
-ConceptDrug.route=मार्ग
-ConceptDrug.units=इकाइयों
-ConceptDrug.strength=शक्ति
-ConceptDrug.list.empty=वर्तमान में, कोई परिभाषित दवाओं नहीं है 
-ConceptDrug.retiredMessage=इस दवा से सेवानिवृत्त है इनकी द्वारा 
-ConceptDrug.retireDrug=इस दवा को सेवानिवृत्त करे 
-ConceptDrug.unretireDrug=इस दवा को अनसेवानिवृत्त करे 
-ConceptDrug.retire.reason.empty=रिटायर कारण खाली नहीं हो सकता
-ConceptDrug.retiredSuccessfully=दवाये सफलतापूर्वक सेवानिवृत्त
-ConceptDrug.unretiredSuccessfully=दवाये सफलतापूर्वक अनसेवानिवृत्त
-ConceptDrug.error.conceptRequired=एक खाली अवधारणा की अनुमति नहीं है
-ConceptDrug.enterName=दवा का नाम दर्ज
-ConceptDrug.noDrugs=कोई ड्रग्स
-ConceptDrug.ingredients=दवा सामग्री
-
-ConceptProposal.manage=प्रस्तावित अवधारणाओं प्रबंधन
-ConceptProposal.manage.title=प्रस्तावित अवधारणा प्रबंधन
-ConceptProposal.title=प्रस्तावित अवधारणा प्रपत्र
-ConceptProposal.list.title=वर्तमान प्रस्तावित अवधारणा
-ConceptProposal.saved=प्रस्तावित अवधारणा को बचाया
-ConceptProposal.encounter=सामना
-ConceptProposal.originalText=मूल पाठ
-ConceptProposal.finalText=अंतिम पाठ
-ConceptProposal.comments=टिप्पणियां
-ConceptProposal.commentsDescription=यह टिप्पणियों प्रत्येक प्रस्तावक को भेजी जायगे 
-ConceptProposal.obs=अवलोकन
-ConceptProposal.obsConcept=अवलोकन अवधारणा
-ConceptProposal.mappedConcept=मैप अवधारणा
-ConceptProposal.mappedConcept.error=एक अवधारणा अगर संचित करते है तो अवधारणा या पर्याय के रूप में चुना जाना चाहिए
-ConceptProposal.proposedBy=द्वारा प्रस्तावित
-ConceptProposal.includeCompleted=पूर्ण शामिल
-ConceptProposal.propose.new=संभावित नई अवधारणा है?
-ConceptProposal.proposeWarning=इस पाठ को अस्थायी रूप से बचाया जाएगा जब तक एक प्रशासक यह समीक्षा करके इसे सूची में जोड़ते हैं.
-ConceptProposal.proposeDuplicate=इन अवधारणाओं का प्रस्ताव किया गया और एक ही पाठ के साथ स्वीकार किए जाते हैं.
-ConceptProposal.proposeInfo=फार्म पर लिखा गया था प्रदान करें. अतिरिक्त टिप्पणी प्रदान करने के लिए सराहना की जाएगी.
-ConceptProposal.propose=अवधारणा सबमिट करें
-ConceptProposal.saveAsConcept=अवधारणा के रूप में सहेजें
-ConceptProposal.saveAsSynonym=पर्यायवाची के रूप में सहेजें
-ConceptProposal.update=प्रस्तावित अवधारणा अद्यतन
-ConceptProposal.state=राज्य
-ConceptProposal.state.error=चुने हुए राज्य और सहेजें बटन क्लिक किया गया था वो अमान्य संयोजन है 
-ConceptProposal.state.CONCEPT=अवधारणा
-ConceptProposal.state.UNMAPPED=तुच्छ
-ConceptProposal.state.REJECT=अस्वीकार
-ConceptProposal.state.SYNONYM=पर्याय
-ConceptProposal.possibleConcepts=संभव अवधारणाओं
-ConceptProposal.occurences=घटनाओं
-ConceptProposal.sortOn=सॉर्ट पर
-ConceptProposal.sortOrder=सॉर्ट क्रम
-ConceptProposal.sortOrder.asc=आरोही
-ConceptProposal.sortOrder.desc=अवरोही
-ConceptProposal.proposeNewConcept=नई अवधारणा का प्रस्ताव
-ConceptProposal.proposed=अवधारणा सफलतापूर्वक प्रस्तावित किया गया है
-ConceptProposal.ignore=प्रस्ताव पर ध्यान न दें
-ConceptProposal.alert.mappedTo=प्रस्तावित अवधारणा "{0}" मैप किया गया "{1}".  {2}
-ConceptProposal.alert.ignored=प्रस्तावित अवधारणा "{0}" विश्लेषण किया गया है.  {1}
-ConceptProposal.update.note=नोट: यह अद्यतन असर होगा {0} अन्य अवधारणा प्रस्ताव पर 
-ConceptProposal.update.note.plural=यो 
-ConceptProposal.saveAsMapped=के रूप में मैप सहेजें
-ConceptProposal.actionToTake=कार्रवाई करने के लिए
-ConceptProposal.save.fail=अवधारणा प्रस्ताव को बचाने के लिए असफल हो , तो आप मैप की गई अवधारणा के लिए एक नकली पर्याय जोड़कर नहीं कर रहे हैं सुनिश्चित
-ConceptProposal.alert.synonymAdded=पर्याय "{0} " की अवधारणा को जोड़ दिया गया है "{1}". {2}
-
-ConceptNumeric.name=सांख्यिक
-ConceptNumeric.absoluteHigh=निरपेक्ष उच्च
-ConceptNumeric.absoluteLow=कम निरपेक्ष
-ConceptNumeric.criticalHigh=उच्च गंभीर
-ConceptNumeric.criticalLow=कम गंभीर
-ConceptNumeric.normalHigh=उच्च सामान्य
-ConceptNumeric.normalLow=कम सामान्य
-ConceptNumeric.invalid.msg=सांख्यिक के लिए अमान्य मान
-ConceptNumeric.units=इकाइयों
-ConceptNumeric.allowDecimal=दशमलव अनुमति दें?
-ConceptNumeric.displayPrecision=प्रदर्शन प्रेसिजन
-ConceptNumeric.precise=सटीक?
-ConceptNumeric.inclusive=रेंज मान शामिल हैं
-
-ConceptSource.manage=अवधारणा स्रोतों का प्रबंध
-ConceptSource.title=अवधारणा स्रोत के रूप
-ConceptSource.sourceIdSetup=स्रोत आईडी सेटअप
-ConceptSource.sourceId=स्रोत पहचान
-ConceptSource.name.help=अपनी स्थापना में प्रदर्शित करने के लिए कुछ हद तक कम इस स्रोत के लिए वर्णनात्मक नाम
-ConceptSource.hl7Code=HL7 कोड
-ConceptSource.hl7Code.help=5-20 वर्ण कोड इस स्रोत के लिए शासी निकाय द्वारा परिभाषित किया गया है.वैकल्पिक रूप से, यह "कार्यान्वयन आईडी" एक और OpenMRS स्थापना से इस्तेमाल करने के लिए अपनी अवधारणाओं और रूपों को परिभाषित कोड हो सकता है.
-ConceptSource.description.help=अपनी पसंद का एक लंबा पाठ वर्णन अन्य उपयोगकर्ताओं के लिए इस स्रोत का वर्णन करने के लिए.
-ConceptSource.saved=संकल्पना स्रोत को बचाया
-ConceptSource.retired=संकल्पना स्रोत सेवानिवृत्त
-ConceptSource.restored=संकल्पना स्रोत बहाल
-ConceptSource.purged=संकल्पना स्रोत हमेशा के लिए हटा
-ConceptSource.save=संकल्पना स्रोत सहेजें
-ConceptSource.isImplementationId=इस अवधारणा स्रोत इस सर्वर के लिए कार्यान्वयन आईडी के रूप में परिभाषित किया गया है
-ConceptSource.add=नई अवधारणा स्रोत जोड़ें
-ConceptSource.retire=चयनित संकल्पना सूत्रों को सेवानिवृत्त करे 
-ConceptSource.list.title=वर्तमान अवधारणा सूत्
-ConceptSource.cannotBeEdited=नोट: एक अवधारणा स्रोत संपादित नहीं हो सकता है अगर एक बार यह बन जाये. अगर आपको ज़रूरी चाहिए, तो इस अवधारणा के स्रोत को हटाये और एक नया बनाये 
-ConceptSource.hl7Code.required=Hl7 कोड एक अवधारणा स्रोत के लिए आवश्यक है
-
-ImplementationId.implementationId=कार्यान्वयन आईडी
-ImplementationId.name=कार्यान्वयन नाम
-ImplementationId.name.help=इस कार्यान्वयन के लिए एक वर्णनात्मक नाम (जैसे Eldoret में AMRS स्थापना, केन्या)
-ImplementationId.invalidIdorPassphrase=अपने कार्यान्वयन आईडी अन्य स्थापना द्वारा प्रयोग में है.  एक अन्य स्रोत कुंजी को चुन सकते हैं या इस स्रोत आईडी के लिए कूटशब्द वैध दर्ज करें.  नोट\: सर्वर दुआर संग्रहीत पास वाक्यांश का वर्णन है  \: {0}   
-ImplementationId.validatedId=अपने कार्यान्वयन आईडी सफलतापूर्वक मान्य किया गया है.
-ImplementationId.set=कार्यान्वयन सेट आईडी
-ImplementationId.setup=कार्यान्वयन आईडी सेटअप
-ImplementationId.saved=कार्यान्वयन आईडी बचाया
-ImplementationId.save=सहेजें और कार्यान्वयन पहचान का सत्यापन
-ImplementationId.dateValidated=मान्य दिनांक
-ImplementationId.sourceId.help=यह इस कार्यान्वयन के लिए अद्वितीय पहचान है. HL7_CODE के रूप में प्रयुक्त. 20 वर्ण और संख्या को सीमित किया जाना चाहिए. अक्षर "^" और  | "की अनुमति नहीं है.
-ImplementationId.description.help=इस कार्यान्वयन का वर्णन पाठ. (उदाहरण के लिए केन्या में AMPATH कार्यक्रम के लिए स्रोत पॉल Biondich द्वारा बनाया गया)
-ImplementationId.passphrase=कूटशब्द
-ImplementationId.passphrase.help=यह पाठ एक लंबी पाठ स्ट्रिंग है जो यह पता करने के काम आता है की कौन कार्यान्वयन आईडी का उपयोग करता है. Openmrs के कई प्रतिष्ठानों एक ही कार्यान्वयन आईडी का उपयोग कर सकते हैं, लेकिन वे सभी पास वाक्यांश पता होना चाहिए.(ध्यान दें कि यदि एक कार्यान्वयन आईडी साझा किया जाता है, यह माना जाता है कि उन प्रतिष्ठानों को एक ही कार्यान्वयन कर रहे हैं).
-ImplementationId.connectionError=त्रुटि जबकि कार्यान्वयन आईडी सर्वर कार्यान्वयन पहचान का सत्यापन करने के लिए जुडी  {0}
-ImplementationId.name.empty=कार्यान्वयन नाम अनिवार्य है।
-ImplementationId.implementationId.empty=कार्यान्वयन आईडी खाली नहीं हो सकता ।
-ImplementationId.passphrase.empty=पास वाक्यांश खाली नहीं हो सकता
-ImplementationId.description.empty=विवरण खाली नहीं हो सकता
-ImplementationId.implementationId.invalidCharacter=वर्ण "^ " और " |" की अनुमति नहीं है
-ImplementationId.null=कार्यान्वयन पहचानकर्ता रिक्त नहीं हो सकता
-
-ConceptWord.title=संकल्पना सूचकांक संग्रहण अद्यतन
-ConceptWord.instructions=एक विशिष्ट अवधारणा के लिए एक अवधारणा आईडी इनपुट.342-453 एक विशिष्ट श्रेणी के लिए. या खाली छोड़ने के लिए ताकि पूरी अवधारणा सूचकांक डेटाबेस (काफी CPU समय की मांग कर सकते हैं) अद्यतन हो  सके. 
-ConceptWord.manage=संकल्पना सूचकांक अद्यतन
-ConceptWord.updated=संकल्पना सूचकांक सफलतापूर्वक अद्यतन.
-ConceptWord.updateInProgress=संकल्पना सूचकांक अद्यतन प्रगति में है और 5-10 मिनट ले सकता है. जब यह खत्म हो जायगा तब 'अद्यतन संकल्पना सूचकांक' शेड्यूल्ड रूप 'बंद'  कार्य चिह्नित किया जाएगा.
-ConceptWord.rangeError=आप अवैध श्रृंखला विशिष्ट की है.. मान्य इनपुट या n या n-m
-ConceptWord.conceptId=संकल्पना क्रं:
-ConceptWord.conceptId.optional=(वैकल्पिक)
-
-ConceptComplex.name=जटिल
-ConceptComplex.handler=संचालक
-ConceptComplex.handler.manage=जटिल संकल्पना प्रबंधन
-ConceptComplex.handler.manage.title=जटिल संकल्पना प्रबंधन
-ConceptComplex.handler.list.title=संकल्पना जटिल हैंडलर
-ConceptComplex.handler.title=संकल्पना जटिल हैंडलर
-ConceptComplex.handler.class=हेन्डलर क्लास
-ConceptComplex.handler.save=परिसर हेन्डलर सहेजें
-ConceptComplex.handler.add=परिसर हैंडलर जोड़ें
-ConceptComplex.handler.delete=परिसर हेन्डलर हटाएँ
-
-Concept.mappings.termRequired=मैप की अवधि के लिए आवश्यक है
-Concept.mappings.selectSource=एक अवधारणा के स्रोत का चयन करें
-
-ConceptMapType=अवधारणा नक्शा टाइप
-ConceptMapType.manage=अवधारणा नक्शा प्रकार के प्रबंधन
-ConceptMapType.title=अवधारणा नक्शा टाइप प्रबंधन
-ConceptMapType.form.title=अवधारणा नक्शा प्रकार फार्म
-ConceptMapType.saved=अवधारणा नक्शा प्रकार बचाया
-ConceptMapType.add=नई अवधारणा नक्शा प्रकार जोड़ें
-ConceptMapType.hidden=छिपा हुआ है
-ConceptMapType.hidden.help=सही में सेट हालांकि उपयोग के लिए इस अवधारणा नक्शा प्रकार संयुक्त राष्ट्र उपलब्ध कर देगा , यह सेवानिवृत्त नहीं किया जाएगा।
-ConceptMapType.retired=अवधारणा नक्शा प्रकार सेवानिवृत्त कर दिया गया है
-ConceptMapType.unretired=अवधारणा नक्शा प्रकार से बहाल कर दिया गया है
-ConceptMapType.retiredMessage=अवधारणा नक्शा प्रकार सेवानिवृत्त है
-ConceptMapType.list.title=संकल्पना मानचित्र प्रकार
-ConceptMapType.retire.error=त्रुटि अवधारणा नक्शा प्रकार रिटायर करने के लिए प्रयास कर रहा है
-ConceptMapType.unretire.error=त्रुटि अवधारणा नक्शा प्रकार बहाल करने के लिए प्रयास कर रहा है
-ConceptMapType.error.nameRequired=नाम आवश्यक है
-ConceptMapType.save.error=त्रुटि अवधारणा नक्शा प्रकार को बचाने के लिए प्रयास कर रहा है
-ConceptMapType.duplicate.name=डुप्लीकेट अवधारणा नक्शा प्रकार का नाम
-ConceptMapType.purged=अवधारणा नक्शा प्रकार हमेशा के लिए हटा
-ConceptMapType.purge.error=त्रुटि स्थायी रूप से अवधारणा नक्शा प्रकार को नष्ट करने का प्रयास करते समय
-ConceptMapType.details=अवधारणा नक्शा टाइप विवरण
-ConceptMapType.hidden.message=धूसर नक्शा प्रकार छिपा रहे हैं
-ConceptMapType.inUse=अवधारणा नक्शा प्रकार प्रयोग में है
-
-ConceptReferenceTerm=संदर्भ अवधि
-ConceptReferenceTerm.manage=संदर्भ शर्तें प्रबंधित
-ConceptReferenceTerm.title=संदर्भ अवधि के प्रबंधन
-ConceptReferenceTerm.form.title=संदर्भ अवधि पर्चा
-ConceptReferenceTerm.saved=संदर्भ अवधि को बचाया
-ConceptReferenceTerm.code=कोड
-ConceptReferenceTerm.name=टर्म नाम
-ConceptReferenceTerm.relatedTerms=संबंधित नियम
-ConceptReferenceTerm.source=स्रोत
-ConceptReferenceTerm.add=नए संदर्भ शब्द जोड़ें
-ConceptReferenceTerm.retired=संदर्भ अवधि सेवानिवृत्त कर दिया गया है
-ConceptReferenceTerm.unretired=संदर्भ अवधि बहाल कर दिया गया है
-ConceptReferenceTerm.retire.error=त्रुटि संदर्भ अवधि रिटायर करने के लिए प्रयास कर रहा है
-ConceptReferenceTerm.unretire.error=त्रुटि संदर्भ अवधि को बहाल करने का प्रयास करते समय
-ConceptReferenceTerm.retiredMessage=संदर्भ अवधि सेवानिवृत्त है
-ConceptReferenceTerm.error.nameRequired=नाम आवश्यक है
-ConceptReferenceTerm.error.codeRequired=कोड आवश्यक है
-ConceptReferenceTerm.error.sourceRequired=संकल्पना स्रोत की आवश्यकता है
-ConceptReferenceTerm.save.error=त्रुटि संदर्भ अवधि को बचाने के लिए प्रयास कर रहा है
-ConceptReferenceTerm.duplicate.name=अपनी अवधारणा स्रोत में संदर्भ अवधि नाम डुप्लिकेट
-ConceptReferenceTerm.duplicate.code=अपनी अवधारणा स्रोत में संदर्भ अवधि कोड डुप्लिकेट
-ConceptReferenceTerm.find=खोजें संदर्भ अवधि (ओं)
-ConceptReferenceTerm.search=नाम या कोड द्वारा संदर्भ शर्तें खोजें: 
-ConceptReferenceTerm.search.error=त्रुटि संदर्भ अवधि (ओं) को खोजने के लिए प्रयास कर रहा है
-ConceptReferenceTerm.error.mapTypeRequired=मानचित्र प्रकार आवश्यक है
-ConceptReferenceTerm.source.notInDatabase=केवल मौजूदा अवधारणा संदर्भ स्रोतों का इस्तेमाल किया जा सकता है
-ConceptReferenceTerm.mapType.notInDatabase=केवल मौजूदा अवधारणा नक्शा प्रकार किया जा सकता है
-ConceptReferenceTerm.error.termBRequired=मैप की अवधि के लिए आवश्यक है
-ConceptReferenceTerm.term.notInDatabase=केवल मौजूदा संदर्भ शर्तें मैप किया जा सकता
-ConceptReferenceTerm.map.sameTerm=खुद के लिए एक संदर्भ अवधि मैप नहीं कर सकता
-ConceptReferenceTerm.purged=संदर्भ अवधि हमेशा के लिए हटा
-ConceptReferenceTerm.purge.error=त्रुटि स्थायी रूप से संदर्भ अवधि को हटाने का प्रयास करते हुए
-ConceptReferenceTerm.details=संदर्भ अवधि विवरण
-ConceptReferenceTerm.termsWithMappingsToThis=इस पद के लिए मैपिंग के साथ शर्तें
-ConceptReferenceTerm.searchAllSources=सभी स्रोतों खोजें
-ConceptReferenceTerm.searchBox.placeholder=कोड या नाम दर्ज
-ConceptReferenceTerm.createNewTerm=नई टर्म बनाएँ
-ConceptReferenceTerm.createNew.help=इस पृष्ठ छोड़ने के बिना एक नया संदर्भ अवधि बनाएँ
-ConceptReferenceTerm.newTermForm=नए संदर्भ टर्म पर्चा
-ConceptReferenceTerm.term.alreadyMapped=इसी अवधारणा के लिए एक संदर्भ अवधि कई बार मैप नहीं कर सकता
-ConceptRefereceTerm.inUse=संदर्भ अवधि के उपयोग में है
-ConceptReferenceTerm.termToTerm.alreadyMapped=इसी संदर्भ अवधि के लिए एक संदर्भ अवधि कई बार मैप नहीं कर सकता
-ConceptReferenceTerm.foundMultipleTermsWithCodeInSource=कोड के साथ मिला एकाधिक संदर्भ शर्तें: {0} में अवधारणा स्रोत {1}
-ConceptReferenceTerm.foundMultipleTermsWithNameInSource=नाम के साथ मिला एकाधिक संदर्भ शर्तें: {0} में अवधारणा स्रोत {1}
-
-Drug.drugReferenceMap.mappedDrug=ड्रग दवा संदर्भ मानचित्र पर आवश्यक है
-Drug.drugReferenceMap.conceptReferenceTerm=संकल्पना संदर्भ अवधि दवा संदर्भ मानचित्र पर आवश्यक है
-Drug.drugReferenceMap.conceptMapType=अवधारणा नक्शा प्रकार दवा संदर्भ मानचित्र पर आवश्यक है
-Drug.drugReferenceMap.termAlreadyMapped=इसी संदर्भ अवधि के लिए एक दवा कई बार मैप नहीं कर सकता
-
-DrugOrder.dose=खुराक
-DrugOrder.units=इकाइयों
-DrugOrder.frequency=आवृत्ति
+Concept.name.duplicate=पूरी तरह से निर्दिष्ट या पसंदीदा नाम नकली है
+Concept.name.tag.duplicate=संकल्पना का नाम पहले से ही इस निर्दिष्ट अवधारणा नाम टैग है
+Concept.boolean.add.answer=दूसरा उत्तर जोड़ें
+Concept.boolean.warning.irreversible=यह अपरिवर्तनीय है
+Concept.boolean.change.tooltip=बूलीयन अवधारणा में अन्य संभावित जवाब जोड़ने के लिए अनुमति देता है
+Concept.boolean.confirm.add.answer=क्या आप सुनिश्चित करते है कि आप एक और जवाब जोड़ना चाहते हैं?
+Concept.name.localePreferred=पसंदीदा 
+Concept.name.localePreferred.help=क्या यह नाम अपनी भाषा में पसंदीदा नाम है और डिफ़ॉल्ट रूप से लौटा दिया जायगा जैसे की रिपोर्ट्स में.
+Concept.name.help=यदि कोई हो स्थान में पसंदीदा नाम, अन्यथा पूरी तरह से नाम निर्दिष्ट करे 
+Concept.id.help=सिस्टम अद्वितीय आईडी उत्पन्न
+Concept.uiid.help=सिस्टम अद्वितीय ID उत्पन्न
+Concept.locale.help=स्थान जिसमें अवधारणा नाम के अंतर्गत आता है
+Concept.retired.help=क्या अवधारणा उपयोग में नहीं रह गया है
+Concept.isSet.help=यह अवधारणा सेट है या नहीं.
+Concept.version.help=अवधारणा के लिए संस्करण संख्या
+Concept.error.multipleLocalePreferredNames=केवल एक पसंदीदा नाम प्रत्येक स्थान के लिए आनुमानित है  
+Concept.error.multipleFullySpecifiedNames=केवल एक पूरी तरह से निर्दिष्ट नाम प्रत्येक स्थान के लिए आनुमानित है  
+Concept.error.preferredName.is.indexTerm=एक सूचकांक शब्द पसंदीदा नाम नहीं हो सकता है
+Concept.error.multipleShortNames=केवल एक छोटा नाम प्रत्येक स्थान के लिए अनुमानित है 
+Concept.error.no.FullySpecifiedName=इस अवधारणा के लिए निर्दिष्ट नहीं पूरी तरह से नाम
+Concept.error.invalid.locale=आप केवल उन्ही लोकेल का उपयोग करे जो अनुमति लोकेल की सूचि में है.
+Concept.no.fullySpecifiedName.found=- <i>नाम निर्दिष्ट नहीं पूरी तरह से इस अवधारणा के लिए पाया</>
+Concept.indexTerms=खोज नियम
+Concept.indexTerm.add=खोज शब्द जोड़ें
+Concept.indexTerms.help=कोई लेबल या नाम है जो एक प्राथमिक अवधारणा को संदर्भित करता है जैसे स्पेल्लिंग में गलती 
+Concept.indexTerms.voidReasonRequired=एक कारण खाली खोज शब्दों के लिए आवश्यक है
+Concept.indexTerms.textRequired=एक खाली खोज शब्द की अनुमति नहीं है
+Concept.error.preferredName.is.shortName=एक छोटा नाम पसंदीदा नाम नहीं हो सकता है
+Concept.error.preferredName.is.voided=एक खाली अवधारणा नाम पसंदीदा नाम नहीं हो सकता है
+Concept.error.fullySpecifiedName.is.voided=एक खाली अवधारणा का नाम पूरी तरह से निर्दिष्ट नहीं किया जा सकता
+Concept.error.fullySpecifiedName.notUnique=पूरी तरह से निर्दिष्ट नाम अद्वितीय होना चाहिए। इस नाम के साथ एक अवधारणा वहां पहले से ही है ।
+Concept.voided.help=क्या अवधारणा का नाम प्रयोग में नहीं रह गया है
+Concept.fullySpecified.help=नाम जिसका उपयोग फॉर्म और रिपोर्ट आदि में हो सकता है अगर वोह किसी पसंदीदा नाम के लिए सेट नहीं है 
+Concept.fullySpecifiedName=पूरी तरह से निर्दिष्ट नाम
+Concept.localesWithErrors=निम्नलिखित लोकेल (ओं) में त्रुटियां मिली:
+Concept.name.empty=नाम खाली या सफेद स्थान चरित्र (ओं) ही नहीं होना चाहिए
+Concept.fullySpecified.textRequired=पूरी तरह से खाली निर्दिष्ट नाम की अनुमति नहीं है
+Concept.delete.hasNameInUse=एक अवधारणा जिसका कुछ अवलोकन (ओं) में इस्तेमाल किया जा रहा है उसको हटाया नहीं जा सकता 
+Concept.name.voidReason.nameChanged=नाम के परिवर्तन के कारण खाली 
+Concept.search.error=अवधारणाओं को खोजने का प्रयास करते समय त्रुटि
+Concept.concept.retired.successFully=अवधारणा सफलतापूर्वक सेवानिवृत्त
+Concept.concept.unRetired.successFully=अवधारणा सफलतापूर्वक अनसेवानिवृत्त 
+Concept.concepts.locked.unRetire=अवधारणा बंद कर दिया है.अनसेवानिवृत्त की अनुमति नहीं है.
+Concept.drugFormulations=इस अवधारणा के लिए दवा फार्मूलों
+Concept.manageDrugFormulary=ड्रग फार्मूलरी प्रबंधित
+
+ConceptStopWord.manage=अवधारणा स्टॉप शब्द प्रबंधन
+ConceptStopWord.title=अवधारणा स्टॉप शब्द
+ConceptStopWord.add=नई अवधारणा स्टॉप शब्द जोड़ें
+ConceptStopWord.list.title=वर्तमान अवधारणा रोक शब्दों
+ConceptStopWord.delete=चयनित अवधारणा रोक शब्दों हटाएँ
+ConceptStopWord.save=अवधारणा स्टॉप शब्द सहेजें
+ConceptStopWord.saved=अवधारणा बंद करो शब्द को सहेजा 
+ConceptStopWord.duplicated=अवधारणा बंद करो शब्द पहले से मौजूद है
+ConceptStopWord.notSaved=अवधारणा बंद करो शब्द नहीं बचाया गया
+ConceptStopWord.error.value.empty=अवधारणा स्टॉप शब्द खाली नहीं हो सकता
+ConceptStopWord.error.notfound=अवधारणा बंद करो शब्द पहले से ही नष्ट कर दिया है या नहीं है 
+ConceptStopWord.error.notSelect=कोई अवधारणा स्टॉप (ओं) शब्द चयनित नहीं है 
+
+Concept.stats.titlebar=OpenMRS - अवधारणा के लिए सांख्यिकी {0}
+Concept.stats.title=अवधारणा के लिए सांख्यिकी {0}
+Concept.stats.header=संकल्पना के लिए सांख्यिकी {0}
+Concept.creatingNewConcept.title=OpenMRS - नई अवधारणा बनाने
+Concept.noConceptSelected=अवधारणाओं नहीं पाई गयी  - अवैध अवधारणा आईडी
+Concept.creatingNewConcept.titlebar=OpenMRS - नई अवधारणा बनाना 
+Concept.creatingNewConcept=नई अवधारणा बनाना 
+Concept.confirmDelete=क्या आप सुनिश्चित करें कि आप इस पूरी अवधारणा को हटाना चाहते हैं?
+Concept.mappings=मैपिंग
+Concept.mappings.help=इस अवधारणा से अन्य अवधारणा स्रोतों की किसी भी संख्या के लिए मैपिंग को परिभाषित करता है (ICD9, SNOMED, etc)
+Concept.mapping.add=मैपिंग जोड़ें
+Concept.map.termRequired=संदर्भ अवधि के लिए आवश्यक है
+Concept.map.typeRequired=अवधारणा नक्शा प्रकार आवश्यक है
+Concept.mappings.type=मानचित्र के प्रकार
+Concept.mappings.relationship=संबंध
+Concept.mapping.sourceUnavailable=कोई अवधारणा स्रोत नक्शा करने के लिए उपलब्ध है
+Concept.mapping.sourceAdd=स्रोत जोड़ें
+Concept.mappings.sourceCodeRequired=सोर्स कोड की आवश्यकता है
+Concept.wikipedia=विकिपीडिया
+Concept.newLocale=इस अवधारणा के लिए जोड़ने के लिए एक नया लोकेल निर्दिष्ट करे.
+Concept.newLocale.label=लोकेल विनिर्देश (example en_GB)
+Concept.usage=संकल्पना उपयोग
+
+Concept.stats=आँकड़े
+Concept.stats.numberObsAnsweredByConcept=अवलोकन अवधारणा ने उत्तर
+Concept.stats.numberObs=अवलोकन की संख्या
+Concept.stats.minValue=न्यूनतम
+Concept.stats.maxValue=अधिकतम
+Concept.stats.meanValue=माध्य
+Concept.stats.medianValue=मंझला
+Concept.stats.histogram=आयतचित्र
+Concept.stats.timePlot=समय प्लॉट
+Concept.stats.histogramDomainAxisTitle=मूल्य
+Concept.stats.histogramRangeAxisTitle=घटनाओं
+Concept.stats.lineChartDomainAxisLabel=समय
+Concept.stats.lineChartRangeAxisLabel=मूल्य
+Concept.stats.histogramOutliers=आयतचित्र (औत्लिएर के बिना )
+Concept.stats.histogram.showOutliers=उत्लिएर्स दिखाएँ
+Concept.stats.histogram.hideOutliers=उत्लिएर्स छिपाना
+Concept.stats.timeSeriesDomainAxisLabel=तारीख
+Concept.stats.timeSeriesRangeAxisLabel=मूल्य
+Concept.stats.timeSeries=काल श्रेणी
+Concept.stats.notDisplayable=आँकड़े इस अवधारणा के लिए उपलब्ध नहीं हैं. केवल संख्यात्मक, कोडित, और बूलियन आँकड़े वर्तमान में उपलब्ध हैं.
+Concept.stats.codedPieChart=कोडित उत्तर पाई चार्ट
+Concept.stats.booleanPieChart=बूलियन उत्तर पाई चार्ट
+
+ConceptClass.manage=अवधारणा क्लासेस प्रबंधन
+ConceptClass.manage.title=अवधारणा क्लास प्रबंधन
+ConceptClass.title=अवधारणा क्लास फार्म
+ConceptClass.save=अवधारणा क्लास सहेजें
+ConceptClass.add=अवधारणा क्लास जोड़ें
+ConceptClass.list.title=वर्तमान अवधारणा क्लासेस
+ConceptClass.delete=चयनित अवधारणा श्रेणी हटाएं
+ConceptClass.saved=अवधारणा क्लास को बचाया
+ConceptClass.deleted=अवधारणा कक्षा हटाया
+ConceptClass.cannot.delete=अवधारणा वर्ग को नष्ट नहीं किया जा सकता. डेटाबेस बाधाओं का उल्लंघन किया जाएगा.
+ConceptClass.select=आपको कम से कम एक अवधारणा वर्ग का चयन करना होगा.
+
+ConceptDatatype.manage=अवधारणा डेटाटाइप प्रबंधन
+ConceptDatatype.manage.title=अवधारणा डाटाटाइप प्रबंधन
+ConceptDatatype.title=अवधारणा डाटाटाइप प्रपत्र
+ConceptDatatype.save=अवधारणा डाटाटाइप सहेजें
+ConceptDatatype.add=अवधारणा डाटाटाइप जोड़ें
+ConceptDatatype.list.title=वर्तमान अवधारणा डेटाटाइप
+ConceptDatatype.delete=चयनित अवधारणा डेटाटाइप हटाएं
+ConceptDatatype.saved=अवधारणा डाटाटाइप को बचाया
+ConceptDatatype.deleted=अवधारणा डाटाटाइप हटाया
+ConceptDatatype.hl7Abbreviation=HL7 संक्षिप्तीकरण
+
+ConceptDrug.manage=अवधारणा ड्रग्स प्रबंधन
+ConceptDrug.manage.title=अवधारणा औषध प्रबंधन
+ConceptDrug.title=अवधारणा औषध प्रपत्र
+ConceptDrug.save=अवधारणा औषध सहेजें
+ConceptDrug.add=अवधारणा औषध जोड़ें
+ConceptDrug.saved=अवधारणा औषध को बचाया
+ConceptDrug.find=खोजे अवधारणा ड्रग्स
+ConceptDrug.search=अवधारणा दवा के नाम पर खोजें
+ConceptDrug.concept=अवधारणा
+ConceptDrug.combination=संयोजन
+ConceptDrug.dosageForm=खुराक फार्म
+ConceptDrug.doseStrength=खुराक शक्ति
+ConceptDrug.minimumDailyDose=अल्पतम मात्रा
+ConceptDrug.maximumDailyDose=महतम मात्रा
+ConceptDrug.route=मार्ग
+ConceptDrug.units=इकाइयों
+ConceptDrug.strength=शक्ति
+ConceptDrug.list.empty=वर्तमान में, कोई परिभाषित दवाओं नहीं है 
+ConceptDrug.retiredMessage=इस दवा से सेवानिवृत्त है इनकी द्वारा 
+ConceptDrug.retireDrug=इस दवा को सेवानिवृत्त करे 
+ConceptDrug.unretireDrug=इस दवा को अनसेवानिवृत्त करे 
+ConceptDrug.retire.reason.empty=रिटायर कारण खाली नहीं हो सकता
+ConceptDrug.retiredSuccessfully=दवाये सफलतापूर्वक सेवानिवृत्त
+ConceptDrug.unretiredSuccessfully=दवाये सफलतापूर्वक अनसेवानिवृत्त
+ConceptDrug.error.conceptRequired=एक खाली अवधारणा की अनुमति नहीं है
+ConceptDrug.enterName=दवा का नाम दर्ज
+ConceptDrug.noDrugs=कोई ड्रग्स
+ConceptDrug.ingredients=दवा सामग्री
+
+ConceptProposal.manage=प्रस्तावित अवधारणाओं प्रबंधन
+ConceptProposal.manage.title=प्रस्तावित अवधारणा प्रबंधन
+ConceptProposal.title=प्रस्तावित अवधारणा प्रपत्र
+ConceptProposal.list.title=वर्तमान प्रस्तावित अवधारणा
+ConceptProposal.saved=प्रस्तावित अवधारणा को बचाया
+ConceptProposal.encounter=सामना
+ConceptProposal.originalText=मूल पाठ
+ConceptProposal.finalText=अंतिम पाठ
+ConceptProposal.comments=टिप्पणियां
+ConceptProposal.commentsDescription=यह टिप्पणियों प्रत्येक प्रस्तावक को भेजी जायगे 
+ConceptProposal.obs=अवलोकन
+ConceptProposal.obsConcept=अवलोकन अवधारणा
+ConceptProposal.mappedConcept=मैप अवधारणा
+ConceptProposal.mappedConcept.error=एक अवधारणा अगर संचित करते है तो अवधारणा या पर्याय के रूप में चुना जाना चाहिए
+ConceptProposal.proposedBy=द्वारा प्रस्तावित
+ConceptProposal.includeCompleted=पूर्ण शामिल
+ConceptProposal.propose.new=संभावित नई अवधारणा है?
+ConceptProposal.proposeWarning=इस पाठ को अस्थायी रूप से बचाया जाएगा जब तक एक प्रशासक यह समीक्षा करके इसे सूची में जोड़ते हैं.
+ConceptProposal.proposeDuplicate=इन अवधारणाओं का प्रस्ताव किया गया और एक ही पाठ के साथ स्वीकार किए जाते हैं.
+ConceptProposal.proposeInfo=फार्म पर लिखा गया था प्रदान करें. अतिरिक्त टिप्पणी प्रदान करने के लिए सराहना की जाएगी.
+ConceptProposal.propose=अवधारणा सबमिट करें
+ConceptProposal.saveAsConcept=अवधारणा के रूप में सहेजें
+ConceptProposal.saveAsSynonym=पर्यायवाची के रूप में सहेजें
+ConceptProposal.update=प्रस्तावित अवधारणा अद्यतन
+ConceptProposal.state=राज्य
+ConceptProposal.state.error=चुने हुए राज्य और सहेजें बटन क्लिक किया गया था वो अमान्य संयोजन है 
+ConceptProposal.state.CONCEPT=अवधारणा
+ConceptProposal.state.UNMAPPED=तुच्छ
+ConceptProposal.state.REJECT=अस्वीकार
+ConceptProposal.state.SYNONYM=पर्याय
+ConceptProposal.possibleConcepts=संभव अवधारणाओं
+ConceptProposal.occurences=घटनाओं
+ConceptProposal.sortOn=सॉर्ट पर
+ConceptProposal.sortOrder=सॉर्ट क्रम
+ConceptProposal.sortOrder.asc=आरोही
+ConceptProposal.sortOrder.desc=अवरोही
+ConceptProposal.proposeNewConcept=नई अवधारणा का प्रस्ताव
+ConceptProposal.proposed=अवधारणा सफलतापूर्वक प्रस्तावित किया गया है
+ConceptProposal.ignore=प्रस्ताव पर ध्यान न दें
+ConceptProposal.alert.mappedTo=प्रस्तावित अवधारणा "{0}" मैप किया गया "{1}".  {2}
+ConceptProposal.alert.ignored=प्रस्तावित अवधारणा "{0}" विश्लेषण किया गया है.  {1}
+ConceptProposal.update.note=नोट: यह अद्यतन असर होगा {0} अन्य अवधारणा प्रस्ताव पर 
+ConceptProposal.update.note.plural=यो 
+ConceptProposal.saveAsMapped=के रूप में मैप सहेजें
+ConceptProposal.actionToTake=कार्रवाई करने के लिए
+ConceptProposal.save.fail=अवधारणा प्रस्ताव को बचाने के लिए असफल हो , तो आप मैप की गई अवधारणा के लिए एक नकली पर्याय जोड़कर नहीं कर रहे हैं सुनिश्चित
+ConceptProposal.alert.synonymAdded=पर्याय "{0} " की अवधारणा को जोड़ दिया गया है "{1}". {2}
+
+ConceptNumeric.name=सांख्यिक
+ConceptNumeric.absoluteHigh=निरपेक्ष उच्च
+ConceptNumeric.absoluteLow=कम निरपेक्ष
+ConceptNumeric.criticalHigh=उच्च गंभीर
+ConceptNumeric.criticalLow=कम गंभीर
+ConceptNumeric.normalHigh=उच्च सामान्य
+ConceptNumeric.normalLow=कम सामान्य
+ConceptNumeric.invalid.msg=सांख्यिक के लिए अमान्य मान
+ConceptNumeric.units=इकाइयों
+ConceptNumeric.allowDecimal=दशमलव अनुमति दें?
+ConceptNumeric.displayPrecision=प्रदर्शन प्रेसिजन
+ConceptNumeric.precise=सटीक?
+ConceptNumeric.inclusive=रेंज मान शामिल हैं
+
+ConceptSource.manage=अवधारणा स्रोतों का प्रबंध
+ConceptSource.title=अवधारणा स्रोत के रूप
+ConceptSource.sourceIdSetup=स्रोत आईडी सेटअप
+ConceptSource.sourceId=स्रोत पहचान
+ConceptSource.name.help=अपनी स्थापना में प्रदर्शित करने के लिए कुछ हद तक कम इस स्रोत के लिए वर्णनात्मक नाम
+ConceptSource.hl7Code=HL7 कोड
+ConceptSource.hl7Code.help=5-20 वर्ण कोड इस स्रोत के लिए शासी निकाय द्वारा परिभाषित किया गया है.वैकल्पिक रूप से, यह "कार्यान्वयन आईडी" एक और OpenMRS स्थापना से इस्तेमाल करने के लिए अपनी अवधारणाओं और रूपों को परिभाषित कोड हो सकता है.
+ConceptSource.description.help=अपनी पसंद का एक लंबा पाठ वर्णन अन्य उपयोगकर्ताओं के लिए इस स्रोत का वर्णन करने के लिए.
+ConceptSource.saved=संकल्पना स्रोत को बचाया
+ConceptSource.retired=संकल्पना स्रोत सेवानिवृत्त
+ConceptSource.restored=संकल्पना स्रोत बहाल
+ConceptSource.purged=संकल्पना स्रोत हमेशा के लिए हटा
+ConceptSource.save=संकल्पना स्रोत सहेजें
+ConceptSource.isImplementationId=इस अवधारणा स्रोत इस सर्वर के लिए कार्यान्वयन आईडी के रूप में परिभाषित किया गया है
+ConceptSource.add=नई अवधारणा स्रोत जोड़ें
+ConceptSource.retire=चयनित संकल्पना सूत्रों को सेवानिवृत्त करे 
+ConceptSource.list.title=वर्तमान अवधारणा सूत्
+ConceptSource.cannotBeEdited=नोट: एक अवधारणा स्रोत संपादित नहीं हो सकता है अगर एक बार यह बन जाये. अगर आपको ज़रूरी चाहिए, तो इस अवधारणा के स्रोत को हटाये और एक नया बनाये 
+ConceptSource.hl7Code.required=Hl7 कोड एक अवधारणा स्रोत के लिए आवश्यक है
+
+ImplementationId.implementationId=कार्यान्वयन आईडी
+ImplementationId.name=कार्यान्वयन नाम
+ImplementationId.name.help=इस कार्यान्वयन के लिए एक वर्णनात्मक नाम (जैसे Eldoret में AMRS स्थापना, केन्या)
+ImplementationId.invalidIdorPassphrase=अपने कार्यान्वयन आईडी अन्य स्थापना द्वारा प्रयोग में है.  एक अन्य स्रोत कुंजी को चुन सकते हैं या इस स्रोत आईडी के लिए कूटशब्द वैध दर्ज करें.  नोट\: सर्वर दुआर संग्रहीत पास वाक्यांश का वर्णन है  \: {0}   
+ImplementationId.validatedId=अपने कार्यान्वयन आईडी सफलतापूर्वक मान्य किया गया है.
+ImplementationId.set=कार्यान्वयन सेट आईडी
+ImplementationId.setup=कार्यान्वयन आईडी सेटअप
+ImplementationId.saved=कार्यान्वयन आईडी बचाया
+ImplementationId.save=सहेजें और कार्यान्वयन पहचान का सत्यापन
+ImplementationId.dateValidated=मान्य दिनांक
+ImplementationId.sourceId.help=यह इस कार्यान्वयन के लिए अद्वितीय पहचान है. HL7_CODE के रूप में प्रयुक्त. 20 वर्ण और संख्या को सीमित किया जाना चाहिए. अक्षर "^" और  | "की अनुमति नहीं है.
+ImplementationId.description.help=इस कार्यान्वयन का वर्णन पाठ. (उदाहरण के लिए केन्या में AMPATH कार्यक्रम के लिए स्रोत पॉल Biondich द्वारा बनाया गया)
+ImplementationId.passphrase=कूटशब्द
+ImplementationId.passphrase.help=यह पाठ एक लंबी पाठ स्ट्रिंग है जो यह पता करने के काम आता है की कौन कार्यान्वयन आईडी का उपयोग करता है. Openmrs के कई प्रतिष्ठानों एक ही कार्यान्वयन आईडी का उपयोग कर सकते हैं, लेकिन वे सभी पास वाक्यांश पता होना चाहिए.(ध्यान दें कि यदि एक कार्यान्वयन आईडी साझा किया जाता है, यह माना जाता है कि उन प्रतिष्ठानों को एक ही कार्यान्वयन कर रहे हैं).
+ImplementationId.connectionError=त्रुटि जबकि कार्यान्वयन आईडी सर्वर कार्यान्वयन पहचान का सत्यापन करने के लिए जुडी  {0}
+ImplementationId.name.empty=कार्यान्वयन नाम अनिवार्य है।
+ImplementationId.implementationId.empty=कार्यान्वयन आईडी खाली नहीं हो सकता ।
+ImplementationId.passphrase.empty=पास वाक्यांश खाली नहीं हो सकता
+ImplementationId.description.empty=विवरण खाली नहीं हो सकता
+ImplementationId.implementationId.invalidCharacter=वर्ण "^ " और " |" की अनुमति नहीं है
+ImplementationId.null=कार्यान्वयन पहचानकर्ता रिक्त नहीं हो सकता
+
+ConceptWord.title=संकल्पना सूचकांक संग्रहण अद्यतन
+ConceptWord.instructions=एक विशिष्ट अवधारणा के लिए एक अवधारणा आईडी इनपुट.342-453 एक विशिष्ट श्रेणी के लिए. या खाली छोड़ने के लिए ताकि पूरी अवधारणा सूचकांक डेटाबेस (काफी CPU समय की मांग कर सकते हैं) अद्यतन हो  सके. 
+ConceptWord.manage=संकल्पना सूचकांक अद्यतन
+ConceptWord.updated=संकल्पना सूचकांक सफलतापूर्वक अद्यतन.
+ConceptWord.updateInProgress=संकल्पना सूचकांक अद्यतन प्रगति में है और 5-10 मिनट ले सकता है. जब यह खत्म हो जायगा तब 'अद्यतन संकल्पना सूचकांक' शेड्यूल्ड रूप 'बंद'  कार्य चिह्नित किया जाएगा.
+ConceptWord.rangeError=आप अवैध श्रृंखला विशिष्ट की है.. मान्य इनपुट या n या n-m
+ConceptWord.conceptId=संकल्पना क्रं:
+ConceptWord.conceptId.optional=(वैकल्पिक)
+
+ConceptComplex.name=जटिल
+ConceptComplex.handler=संचालक
+ConceptComplex.handler.manage=जटिल संकल्पना प्रबंधन
+ConceptComplex.handler.manage.title=जटिल संकल्पना प्रबंधन
+ConceptComplex.handler.list.title=संकल्पना जटिल हैंडलर
+ConceptComplex.handler.title=संकल्पना जटिल हैंडलर
+ConceptComplex.handler.class=हेन्डलर क्लास
+ConceptComplex.handler.save=परिसर हेन्डलर सहेजें
+ConceptComplex.handler.add=परिसर हैंडलर जोड़ें
+ConceptComplex.handler.delete=परिसर हेन्डलर हटाएँ
+
+Concept.mappings.termRequired=मैप की अवधि के लिए आवश्यक है
+Concept.mappings.selectSource=एक अवधारणा के स्रोत का चयन करें
+
+ConceptMapType=अवधारणा नक्शा टाइप
+ConceptMapType.manage=अवधारणा नक्शा प्रकार के प्रबंधन
+ConceptMapType.title=अवधारणा नक्शा टाइप प्रबंधन
+ConceptMapType.form.title=अवधारणा नक्शा प्रकार फार्म
+ConceptMapType.saved=अवधारणा नक्शा प्रकार बचाया
+ConceptMapType.add=नई अवधारणा नक्शा प्रकार जोड़ें
+ConceptMapType.hidden=छिपा हुआ है
+ConceptMapType.hidden.help=सही में सेट हालांकि उपयोग के लिए इस अवधारणा नक्शा प्रकार संयुक्त राष्ट्र उपलब्ध कर देगा , यह सेवानिवृत्त नहीं किया जाएगा।
+ConceptMapType.retired=अवधारणा नक्शा प्रकार सेवानिवृत्त कर दिया गया है
+ConceptMapType.unretired=अवधारणा नक्शा प्रकार से बहाल कर दिया गया है
+ConceptMapType.retiredMessage=अवधारणा नक्शा प्रकार सेवानिवृत्त है
+ConceptMapType.list.title=संकल्पना मानचित्र प्रकार
+ConceptMapType.retire.error=त्रुटि अवधारणा नक्शा प्रकार रिटायर करने के लिए प्रयास कर रहा है
+ConceptMapType.unretire.error=त्रुटि अवधारणा नक्शा प्रकार बहाल करने के लिए प्रयास कर रहा है
+ConceptMapType.error.nameRequired=नाम आवश्यक है
+ConceptMapType.save.error=त्रुटि अवधारणा नक्शा प्रकार को बचाने के लिए प्रयास कर रहा है
+ConceptMapType.duplicate.name=डुप्लीकेट अवधारणा नक्शा प्रकार का नाम
+ConceptMapType.purged=अवधारणा नक्शा प्रकार हमेशा के लिए हटा
+ConceptMapType.purge.error=त्रुटि स्थायी रूप से अवधारणा नक्शा प्रकार को नष्ट करने का प्रयास करते समय
+ConceptMapType.details=अवधारणा नक्शा टाइप विवरण
+ConceptMapType.hidden.message=धूसर नक्शा प्रकार छिपा रहे हैं
+ConceptMapType.inUse=अवधारणा नक्शा प्रकार प्रयोग में है
+
+ConceptReferenceTerm=संदर्भ अवधि
+ConceptReferenceTerm.manage=संदर्भ शर्तें प्रबंधित
+ConceptReferenceTerm.title=संदर्भ अवधि के प्रबंधन
+ConceptReferenceTerm.form.title=संदर्भ अवधि पर्चा
+ConceptReferenceTerm.saved=संदर्भ अवधि को बचाया
+ConceptReferenceTerm.code=कोड
+ConceptReferenceTerm.name=टर्म नाम
+ConceptReferenceTerm.relatedTerms=संबंधित नियम
+ConceptReferenceTerm.source=स्रोत
+ConceptReferenceTerm.add=नए संदर्भ शब्द जोड़ें
+ConceptReferenceTerm.retired=संदर्भ अवधि सेवानिवृत्त कर दिया गया है
+ConceptReferenceTerm.unretired=संदर्भ अवधि बहाल कर दिया गया है
+ConceptReferenceTerm.retire.error=त्रुटि संदर्भ अवधि रिटायर करने के लिए प्रयास कर रहा है
+ConceptReferenceTerm.unretire.error=त्रुटि संदर्भ अवधि को बहाल करने का प्रयास करते समय
+ConceptReferenceTerm.retiredMessage=संदर्भ अवधि सेवानिवृत्त है
+ConceptReferenceTerm.error.nameRequired=नाम आवश्यक है
+ConceptReferenceTerm.error.codeRequired=कोड आवश्यक है
+ConceptReferenceTerm.error.sourceRequired=संकल्पना स्रोत की आवश्यकता है
+ConceptReferenceTerm.save.error=त्रुटि संदर्भ अवधि को बचाने के लिए प्रयास कर रहा है
+ConceptReferenceTerm.duplicate.name=अपनी अवधारणा स्रोत में संदर्भ अवधि नाम डुप्लिकेट
+ConceptReferenceTerm.duplicate.code=अपनी अवधारणा स्रोत में संदर्भ अवधि कोड डुप्लिकेट
+ConceptReferenceTerm.find=खोजें संदर्भ अवधि (ओं)
+ConceptReferenceTerm.search=नाम या कोड द्वारा संदर्भ शर्तें खोजें: 
+ConceptReferenceTerm.search.error=त्रुटि संदर्भ अवधि (ओं) को खोजने के लिए प्रयास कर रहा है
+ConceptReferenceTerm.error.mapTypeRequired=मानचित्र प्रकार आवश्यक है
+ConceptReferenceTerm.source.notInDatabase=केवल मौजूदा अवधारणा संदर्भ स्रोतों का इस्तेमाल किया जा सकता है
+ConceptReferenceTerm.mapType.notInDatabase=केवल मौजूदा अवधारणा नक्शा प्रकार किया जा सकता है
+ConceptReferenceTerm.error.termBRequired=मैप की अवधि के लिए आवश्यक है
+ConceptReferenceTerm.term.notInDatabase=केवल मौजूदा संदर्भ शर्तें मैप किया जा सकता
+ConceptReferenceTerm.map.sameTerm=खुद के लिए एक संदर्भ अवधि मैप नहीं कर सकता
+ConceptReferenceTerm.purged=संदर्भ अवधि हमेशा के लिए हटा
+ConceptReferenceTerm.purge.error=त्रुटि स्थायी रूप से संदर्भ अवधि को हटाने का प्रयास करते हुए
+ConceptReferenceTerm.details=संदर्भ अवधि विवरण
+ConceptReferenceTerm.termsWithMappingsToThis=इस पद के लिए मैपिंग के साथ शर्तें
+ConceptReferenceTerm.searchAllSources=सभी स्रोतों खोजें
+ConceptReferenceTerm.searchBox.placeholder=कोड या नाम दर्ज
+ConceptReferenceTerm.createNewTerm=नई टर्म बनाएँ
+ConceptReferenceTerm.createNew.help=इस पृष्ठ छोड़ने के बिना एक नया संदर्भ अवधि बनाएँ
+ConceptReferenceTerm.newTermForm=नए संदर्भ टर्म पर्चा
+ConceptReferenceTerm.term.alreadyMapped=इसी अवधारणा के लिए एक संदर्भ अवधि कई बार मैप नहीं कर सकता
+ConceptRefereceTerm.inUse=संदर्भ अवधि के उपयोग में है
+ConceptReferenceTerm.termToTerm.alreadyMapped=इसी संदर्भ अवधि के लिए एक संदर्भ अवधि कई बार मैप नहीं कर सकता
+ConceptReferenceTerm.foundMultipleTermsWithCodeInSource=कोड के साथ मिला एकाधिक संदर्भ शर्तें: {0} में अवधारणा स्रोत {1}
+ConceptReferenceTerm.foundMultipleTermsWithNameInSource=नाम के साथ मिला एकाधिक संदर्भ शर्तें: {0} में अवधारणा स्रोत {1}
+
+Drug.drugReferenceMap.mappedDrug=ड्रग दवा संदर्भ मानचित्र पर आवश्यक है
+Drug.drugReferenceMap.conceptReferenceTerm=संकल्पना संदर्भ अवधि दवा संदर्भ मानचित्र पर आवश्यक है
+Drug.drugReferenceMap.conceptMapType=अवधारणा नक्शा प्रकार दवा संदर्भ मानचित्र पर आवश्यक है
+Drug.drugReferenceMap.termAlreadyMapped=इसी संदर्भ अवधि के लिए एक दवा कई बार मैप नहीं कर सकता
+
+DrugOrder.dose=खुराक
+DrugOrder.units=इकाइयों
+DrugOrder.frequency=आवृत्ति
 DrugOrder.prn=PRN
-DrugOrder.asNeeded=जरूरत के रूप में
-DrugOrder.complex=जटिल
-DrugOrder.quantity=मात्रा
-DrugOrder.quantityUnits=मात्रा की इकाई
-DrugOrder.drug=दवा
-DrugOrder.regimens.current=वर्तमान और भविष्य रहन-सहन एवं आहार सम्बन्धी नियम
-DrugOrder.regimens.add=जुड़े रहन-सहन एवं आहार सम्बन्धी नियम
-DrugOrder.regimens.addStandard=एक मानक दवा/रहन-सहन एवं आहार सम्बन्धी नियम जोड़ें
-DrugOrder.regimens.addCustom=अपनी खुद की दवा/रहन-सहन एवं आहार सम्बन्धी नियम जोड़ें 
-DrugOrder.regimens.completed=पूरा रहन-सहन एवं आहार सम्बन्धी नियम
-DrugOrder.regimens.addOrChange=जोड़ें / बदलें रहन - सहन एवं आहार सम्बन्धी नियम
-DrugOrder.discontinuedDate=समाप्ति की तिथि 
-DrugOrder.discontinuedReason=रोकने के लिए कारण
-DrugOrder.autoExpireDate=ऑटो तिथि समाप्त
-DrugOrder.actualStopDate=वास्तविक समाप्त तिथि
-DrugOrder.scheduledStopDate=अनुसूचित स्टॉप तिथि
-DrugOrder.list.showAll=सभी दवा आदेश दिखाएं
-DrugOrder.frequency.day=दिन
-DrugOrder.frequency.days=दिन
-DrugOrder.frequency.week=सप्ताह
-DrugOrder.frequency.everyDay=प्रतिदिन
-DrugOrder.list.noOrders=कोई आदेश नहीं 
-DrugOrder.header.otherRegimens=अन्य रहन-सहन एवं आहार सम्बन्धी नियम
-DrugOrder.regimen.addAndReplace=जोड़ें बदलें
-DrugOrder.regimen.action.choose=एक कार्रवाई का चयन करें ...
-DrugOrder.regimen.action.discontinue=जोडें और वर्तमान बंद करो {0}
-DrugOrder.regimen.action.void=जोडें और मौजूदा हटाएँ{0}
-DrugOrder.regimen.action.addToCurrent=वर्तमान सहन एवं आहार सम्बन्धी नियम में जोड़ें
-DrugOrder.dateStopped=तिथि रूका
-DrugOrder.discontinue=रोक
-DrugOrder.void=हटाना
-DrugOrder.discontinueGroup=इस श्रेणी रोकें
-DrugOrder.voidGroup=इस श्रेणी हटाएँ
-DrugOrder.discontinue.reason.toxicity=विषैलापन
-DrugOrder.discontinue.reason.failure=विफलता
-DrugOrder.discontinue.reason.pregnancy=गर्भावस्था
-DrugOrder.discontinue.reason.interactionTB=टीबी के इलाज साथ सहभागिता
-DrugOrder.discontinue.reason.outOfStock=स्टाक में नहीं
-DrugOrder.discontinue.reason.patientRefusal=रोगी द्वारा इनकार
-DrugOrder.discontinue.reason.other=अन्य
-DrugOrder.void.reason.dateError=तिथि त्रुटि
-DrugOrder.void.reason.error=त्रुटि
-DrugOrder.void.reason.other=अन्य
-DrugOrder.regimen.action.discontinue.allCurrent=सभी मौजूदा रहन-सहन एवं आहार सम्बन्धी नियम बंद करो और जोडें  
-DrugOrder.regimen.action.void.allCurrent=सभी वर्तमान जोड़ें और सभी मौजूदा रहन - सहन एवं आहार सम्बन्धी नियम हटाएँ.
-DrugOrder.drugSet.discontinue.error.noDate=तारीख जिस पर बंद किया गया था इस सहन एवं आहार सम्बन्धी नियम या सेट को उसको देना होगा.
-
-DrugOrder.add.error.missingDrug=आप एक वैध दवा का चयन करे.
-DrugOrder.add.error.missingDose=आप एक वैध खुराक आपूर्ति दे 
-DrugOrder.add.error.missingUnits=आप मान्य इकाइयों की आपूर्ति करना
-DrugOrder.add.error.missingFrequency=आप एक वैध दैनिक और / या साप्ताहिक आवृत्ति आपूर्ति करना 
-DrugOrder.add.error.missingStartDate=आप एक मान्य प्रारंभ तिथि की आपूर्ति करे
-DrugOrder.add.error.missingFrequency.interactions=स्थित करे {0} ग्लोबल प्रोपर्टी को 
-
-DrugOrder.error.unitsNotSetWhenDoseOrQuantitySpecified=इकाइयों खुराक या मात्रा या तो निर्दिष्ट किया जाता है , जब सेट किया जाना चाहिए
-DrugOrder.error.notAmongAllowedConcepts=इकाइयों अवधारणा की अनुमति दी अवधारणाओं के बीच होना चाहिए
-DrugOrder.error.durationUnitsRequiredWithDuration=अवधियां इकाइयों अवधि निर्दिष्ट किया जाता है जब आवश्यकता होती है
-DrugOrder.error.quantityUnitsRequiredWithQuantity=मात्रा इकाइयों मात्रा निर्दिष्ट किया जाता है जब आवश्यकता होती है
-DrugOrder.error.doseUnitsRequiredWithDose=खुराक इकाइयों खुराक निर्दिष्ट किया जाता है जब आवश्यकता होती है
-DrugOrder.error.numRefillsIsNullForOutPatient=केवल एक बार की संख्या में बाहर मरीज ​​दवा के आदेश के लिए आवश्यक है
-DrugOrder.error.quantityIsNullForOutPatient=मात्रा बाहर मरीज ​​दवा के आदेश के लिए आवश्यक है
-DrugOrder.error.doseIsNullForDosingTypeSimple=खुराक साधारण खुराक प्रकार के लिए आवश्यक है
-DrugOrder.error.doseUnitsIsNullForDosingTypeSimple=खुराक इकाइयों सरल खुराक प्रकार के लिए आवश्यक है
-DrugOrder.error.routeIsNullForDosingTypeSimple=मार्ग सरल खुराक प्रकार के लिए आवश्यक है
-DrugOrder.error.frequencyIsNullForDosingTypeSimple=फ्रीक्वेंसी सरल खुराक प्रकार के लिए आवश्यक है
-DrugOrder.error.instructionIsNullForDosingTypeFreeText=निर्देश मुक्त पाठ खुराक प्रकार के लिए आवश्यक है
-DrugOrder.error.dosingInstructionsIsNullForDosingTypeFreeText=खुराक प्रकार नि: शुल्क पाठ्य अगर खुराक आईएनजी निर्देश आवश्यक हैं
-DrugOrder.error.routeNotAmongAllowedConcepts=Order.drugRoutesConceptUuid वैश्विक संपत्ति द्वारा निर्दिष्ट मार्ग अवधारणा की अनुमति दी अवधारणाओं के बीच होना चाहिए
-DrugOrder.error.drugIsRequired=ड्रग आवश्यक है
-DrugOrder.error.durationUnitsNotMappedToSnomedCtDurationCode=अवधि इकाइयों एक ही रूप में सेट करने के लिए नक्शे के प्रकार के साथ SNOMED सीटी अवधि कोड के लिए मैप किया जाना चाहिए
-
-TestOrder.error.specimenSourceNotAmongAllowedConcepts=Order.testSpecimenSourcesConceptUuid वैश्विक संपत्ति के द्वारा निर्दिष्ट के रूप में नमूना स्रोत अवधारणा की अनुमति दी अवधारणाओं के बीच होना चाहिए
-
-Encounter.header=सामना
-Encounter.manage=प्रबंधन का सामना 
-Encounter.manage.title=मुठभेड़ प्रबंधन
-Encounter.title=सामना
-Encounter.patient=रोगी
-Encounter.form=प्रपत्र
-Encounter.type.retired=सेवानिवृत्त
-Encounter.location=स्थान
-Encounter.provider=प्रदाता
-Encounter.provider.find=प्रदाता खोज
-Encounter.datetime=सामना की तिथि
-Encounter.find=सामना खोजें
-Encounter.search=सामना आईडी, रोगी पहचानकर्ता या नाम से खोजें:
-Encounter.search.placeholder=आईडी, रोगी का नाम या आईडी सामना दर्ज करे 
-Encounter.edit=सामना संपादित करे
-Encounter.view=देखें मुठभेड़
-Encounter.save=सामना सहेजें
-Encounter.add=सामना जोड़ें
-Encounter.list.title=वर्तमान सामने 
-Encounter.delete=चयनित सामना हटाएँ
-Encounter.saved=सामना सुरक्षित
-Encounter.deleted=सामना नष्ट
-Encounter.observations=टिप्पणियों
-Encounter.observations.view=इस सामने के लिए टिप्पणियों देखें
-Encounter.summary=सारांश सामना 
-Encounter.enterer=दर्ज किया
-Encounter.id=सामना आईडी
-Encounter.no.previous=कोई पिछला सामना नहीं 
-Encounter.last.encounters=आखरी टीम सामने
-Encounter.last.definedNumberOfEncounters=पिछले { 0} मुठभेड़ों
-Encounter.noFormDefined=(कोई परिभाषित फार्म नहीं)
-Encounter.page=पन्ना  {0}
-Encounter.type=सामने की प्रकार 
-Encounter.searchPhraseCannotBeNull=खोज वाक्यांश अशक्त नहीं हो सकता है
-Encounter.noMatchesFound=कोई मेल नहीं मिला  <b>{0} के लिए</b>
-Encounter.search.error=त्रुटि जब सामना खोजने का प्रयास
-Encounter.visit=भेंट
-Encounter.visit.patients.dontMatch=सामना और उस से जुड़े यात्रा एक ही रोगी के अंतर्गत आने चाहिए
-Encounter.patientIdCannotBeNull=रोगी आईडी रिक्त नहीं हो सकता है
-Encounter.error.patient.required=रोगी की आवश्यकता है
-Encounter.error.encounterIdCannotBeNull=सामना आईडी रिक्त नहीं हो सकता
-Encounter.error.duplicateProviderEncounterRole=प्रदाता एक ही मुठभेड़ भूमिका के लिए एक बार से अधिक नहीं जोड़ा जा सकता
-Encounter.error.encounterType.required=मुठभेड़ प्रकार आवश्यक है
-Encounter.cannot.save=सत्यापन त्रुटियों के कारण सामना सहेज नहीं सकता
-
-Encounter.open=खुली
-Encounter.datetimeShouldBeInVisitDatesRange=मुठभेड़ समयदिनाँक शुरू करने और तारीखों को रोकने की यात्रा के बीच होना चाहिए ।
-Encounter.datetimeShouldBeBeforeCurrent=मुठभेड़ समयदिनाँक आज की तारीख से पहले किया जाना चाहिए।
-Encounter.visits.enable=दौरा सक्षम करें
-Encounter.visits.handler.choose=स्वचालित रूप से दौरा करने के लिए मुठभेड़ों आवंटित करने के लिए इस्तेमाल किया जाएगा जो भेंट हैंडलर मुठभेड़ चुनें
-Encounter.error.visits.handler.empty=तुम यात्रा हैंडलर मुठभेड़ का चयन करना होगा
-Encounter.visits.configuration.savedSuccessfully=भेंट विन्यास को सहेज
-Encounter.provider.failedToAddProvider=प्रदाता जोड़ने में विफल
-Encounter.provider.failedToRemoveProvider=प्रदाता को दूर करने में विफल
-Encounter.provider.selectEncounterRole=एक मुठभेड़ भूमिका का चयन करें
-Encounter.provider.selectProvider=एक प्रदाता का चयन करें
-Encounter.provider.deleteProviderConfirm=क्या तुम सच में प्रदाता हटाना चाहते हैं :
-Encounter.noEncounters=अभी तक कोई मुठभेड़ों
-Encounter.provider.atleastOneProviderRequired=कम से कम एक प्रदाता के लिए आवश्यक है
-Encounter.datetime.required=मुठभेड़ दिनांक आवश्यक है
-EncounterRole.error.name.required=नाम की आवश्यकता है
-EncounterRole.saved=मुठभेड़ भूमिका को बचाया
-EncounterRole.manage=मुठभेड़ भूमिकाएँ प्रबंधित करें
-EncounterRole.manage.title=मुठभेड़ भूमिका प्रबंधन
-EncounterRole.create=मुठभेड़ भूमिका बनाएँ
-EncounterRole.edit=संपादित मुठभेड़ भूमिका
-EncounterRole.title=मुठभेड़ भूमिका
-EncounterRole.save=मुठभेड़ भूमिका सहेजें
-EncounterRole.add=मुठभेड़ भूमिका जोड़ें
-EncounterRole.list.title=वर्तमान मुठभेड़ भूमिकाएँ
-EncounterRole.delete=मुठभेड़ भूमिका हटाएं
-EncounterRole.retireEncounterRole=मुठभेड़ भूमिका रिटायर
-EncounterRole.retiredSuccessfully=मुठभेड़ भूमिका सफलतापूर्वक सेवानिवृत्त
-EncounterRole.unretire=संयुक्त राष्ट्र मुठभेड़ भूमिका रिटायर
-EncounterRole.unretired=मुठभेड़ भूमिका सफलतापूर्वक संयुक्त राष्ट्र के सेवानिवृत्त
-EncounterRole.purgedSuccessfully=मुठभेड़ भूमिका सफलतापूर्वक हमेशा के लिए हटा
-EncounterRole.purgeEncounterRole=हमेशा के लिए मुठभेड़ भूमिका हटाएं
-EncounterRole.error.duplicateEncounterRoleNameSpecified=मुठभेड़ भूमिका का नाम पहले से ही , एक और निर्दिष्ट कृपया मौजूद
-
-EncounterType.manage=सामना के प्रकार प्रबंधन
-EncounterType.manage.title=सामना के प्रकार प्रबंधन
-EncounterType.title=सामना के प्रकार
-EncounterType.save=सामना के प्रकार सहेजें 
-EncounterType.add=सामना के प्रकार जोड़ें
-EncounterType.list.title=वर्तमान सामना के प्रकार
-EncounterType.delete=चयनित सामना के प्रकार हटाएं
-EncounterType.saved=सामना के प्रकार सहेजें
-EncounterType.deleted=सामना के प्रकार नष्ट कर दिया
-EncounterType.cannot.delete=सामना के प्रकार को नष्ट नहीं किया जा सकता. डेटाबेस बाधाओं का उल्लंघन होगा. 
-EncounterType.select=आप को कम से कम एक सामना के प्रकार का चयन करना होगा.
-EncounterType.retireEncounterType=प्रकार सामना सेवानिवृत्त
-EncounterType.retiredSuccessfully=सामना के प्रकार सफलतापूर्वक सेवानिवृत्त
-EncounterType.retire=चयनित सामना के प्रकार रिटायर करे 
-EncounterType.purgedSuccessfully=सामना के प्रकार सफलतापूर्वक पुर्गेद 
-EncounterType.purgeEncounterType=सामना के प्रकार पुर्गेद 
-EncounterType.viewPrivilege=देखें प्रिविलेज
-EncounterType.viewPrivilege.help=एक उपयोगकर्ता द्वारा की जरूरत विशेषाधिकार इस प्रकार की मुठभेड़ों देखने के लिए
-EncounterType.editPrivilege=संपादित विशेषाधिकार
-EncounterType.editPrivilege.help=संपादित विशेषाधिकार
-EncounterType.privilege.disclaimer=आप सभी मुठभेड़ों डेटा को देखने की अनुमति नहीं है, इसलिए कुछ जानकारी प्रदर्शित नहीं किया जा सकता है।
-EncounterType.encounterTypes.locked=अनुमति नहीं है संपादन मुठभेड़ प्रकार , मुठभेड़ प्रकार बंद कर रहे हैं
-EncounterType.error.duplicateEncounterTypeNameSpecified=मुठभेड़ प्रकार नाम पहले से ही , एक और निर्दिष्ट कृपया मौजूद
-
-Form.header=प्रपत्र
-Form.manage=प्रपत्र प्रबंधन
-Form.fieldType=प्रपत्र
-Form.nonedeleted=कोई प्रपत्र को नष्ट नहीं किया गया 
-Form.edit=प्रपत्र संपादित करें
-Form.list.title=प्रपत्र
-Form.edit.title=मेटाडाटा संपादित करें
-Form.edit.resources=पर्चा संसाधन
-Form.design.title=स्कीमा डिजाइन
-Form.add=प्रपत्र जोड़ें
-Form.delete=प्रपत्र हटाएं
-Form.deleted=प्रपत्र सफलतापूर्वक नष्ट कर दिया
-Form.cannot.delete=प्रपत्र को नष्ट नहीं कर सकते. डेटाबेस प्रतिबंध यह रोक रहे हैं.
-Form.version=संस्करण
-Form.version.invalid=संस्करण एक संख्या के साथ शुरू करना चाहिए
-Form.save=प्रपत्र सहेजें
-Form.create.duplicate=प्रपत्र बनाएँ और स्कीमा डुप्लिकेट करे 
-Form.saved=प्रपत्र बचाया
-Form.not.saved=प्रपत्र सहेजा नहीं गया था
-Form.build=निर्माण करना
-Form.editProperties=मेटाडाटा संपादित करें
-Form.designSchema=डिजाइन स्कीमा
-Form.retiredMessage=यह फार्म सेवानिवृत्त है.
-Form.published=प्रकाशित
-Form.unpublished=अप्रकाशित
+DrugOrder.asNeeded=जरूरत के रूप में
+DrugOrder.complex=जटिल
+DrugOrder.quantity=मात्रा
+DrugOrder.quantityUnits=मात्रा की इकाई
+DrugOrder.drug=दवा
+DrugOrder.regimens.current=वर्तमान और भविष्य रहन-सहन एवं आहार सम्बन्धी नियम
+DrugOrder.regimens.add=जुड़े रहन-सहन एवं आहार सम्बन्धी नियम
+DrugOrder.regimens.addStandard=एक मानक दवा/रहन-सहन एवं आहार सम्बन्धी नियम जोड़ें
+DrugOrder.regimens.addCustom=अपनी खुद की दवा/रहन-सहन एवं आहार सम्बन्धी नियम जोड़ें 
+DrugOrder.regimens.completed=पूरा रहन-सहन एवं आहार सम्बन्धी नियम
+DrugOrder.regimens.addOrChange=जोड़ें / बदलें रहन - सहन एवं आहार सम्बन्धी नियम
+DrugOrder.discontinuedDate=समाप्ति की तिथि 
+DrugOrder.discontinuedReason=रोकने के लिए कारण
+DrugOrder.autoExpireDate=ऑटो तिथि समाप्त
+DrugOrder.actualStopDate=वास्तविक समाप्त तिथि
+DrugOrder.scheduledStopDate=अनुसूचित स्टॉप तिथि
+DrugOrder.list.showAll=सभी दवा आदेश दिखाएं
+DrugOrder.frequency.day=दिन
+DrugOrder.frequency.days=दिन
+DrugOrder.frequency.week=सप्ताह
+DrugOrder.frequency.everyDay=प्रतिदिन
+DrugOrder.list.noOrders=कोई आदेश नहीं 
+DrugOrder.header.otherRegimens=अन्य रहन-सहन एवं आहार सम्बन्धी नियम
+DrugOrder.regimen.addAndReplace=जोड़ें बदलें
+DrugOrder.regimen.action.choose=एक कार्रवाई का चयन करें ...
+DrugOrder.regimen.action.discontinue=जोडें और वर्तमान बंद करो {0}
+DrugOrder.regimen.action.void=जोडें और मौजूदा हटाएँ{0}
+DrugOrder.regimen.action.addToCurrent=वर्तमान सहन एवं आहार सम्बन्धी नियम में जोड़ें
+DrugOrder.dateStopped=तिथि रूका
+DrugOrder.discontinue=रोक
+DrugOrder.void=हटाना
+DrugOrder.discontinueGroup=इस श्रेणी रोकें
+DrugOrder.voidGroup=इस श्रेणी हटाएँ
+DrugOrder.discontinue.reason.toxicity=विषैलापन
+DrugOrder.discontinue.reason.failure=विफलता
+DrugOrder.discontinue.reason.pregnancy=गर्भावस्था
+DrugOrder.discontinue.reason.interactionTB=टीबी के इलाज साथ सहभागिता
+DrugOrder.discontinue.reason.outOfStock=स्टाक में नहीं
+DrugOrder.discontinue.reason.patientRefusal=रोगी द्वारा इनकार
+DrugOrder.discontinue.reason.other=अन्य
+DrugOrder.void.reason.dateError=तिथि त्रुटि
+DrugOrder.void.reason.error=त्रुटि
+DrugOrder.void.reason.other=अन्य
+DrugOrder.regimen.action.discontinue.allCurrent=सभी मौजूदा रहन-सहन एवं आहार सम्बन्धी नियम बंद करो और जोडें  
+DrugOrder.regimen.action.void.allCurrent=सभी वर्तमान जोड़ें और सभी मौजूदा रहन - सहन एवं आहार सम्बन्धी नियम हटाएँ.
+DrugOrder.drugSet.discontinue.error.noDate=तारीख जिस पर बंद किया गया था इस सहन एवं आहार सम्बन्धी नियम या सेट को उसको देना होगा.
+
+DrugOrder.add.error.missingDrug=आप एक वैध दवा का चयन करे.
+DrugOrder.add.error.missingDose=आप एक वैध खुराक आपूर्ति दे 
+DrugOrder.add.error.missingUnits=आप मान्य इकाइयों की आपूर्ति करना
+DrugOrder.add.error.missingFrequency=आप एक वैध दैनिक और / या साप्ताहिक आवृत्ति आपूर्ति करना 
+DrugOrder.add.error.missingStartDate=आप एक मान्य प्रारंभ तिथि की आपूर्ति करे
+DrugOrder.add.error.missingFrequency.interactions=स्थित करे {0} ग्लोबल प्रोपर्टी को 
+
+DrugOrder.error.unitsNotSetWhenDoseOrQuantitySpecified=इकाइयों खुराक या मात्रा या तो निर्दिष्ट किया जाता है , जब सेट किया जाना चाहिए
+DrugOrder.error.notAmongAllowedConcepts=इकाइयों अवधारणा की अनुमति दी अवधारणाओं के बीच होना चाहिए
+DrugOrder.error.durationUnitsRequiredWithDuration=अवधियां इकाइयों अवधि निर्दिष्ट किया जाता है जब आवश्यकता होती है
+DrugOrder.error.quantityUnitsRequiredWithQuantity=मात्रा इकाइयों मात्रा निर्दिष्ट किया जाता है जब आवश्यकता होती है
+DrugOrder.error.doseUnitsRequiredWithDose=खुराक इकाइयों खुराक निर्दिष्ट किया जाता है जब आवश्यकता होती है
+DrugOrder.error.numRefillsIsNullForOutPatient=केवल एक बार की संख्या में बाहर मरीज ​​दवा के आदेश के लिए आवश्यक है
+DrugOrder.error.quantityIsNullForOutPatient=मात्रा बाहर मरीज ​​दवा के आदेश के लिए आवश्यक है
+DrugOrder.error.doseIsNullForDosingTypeSimple=खुराक साधारण खुराक प्रकार के लिए आवश्यक है
+DrugOrder.error.doseUnitsIsNullForDosingTypeSimple=खुराक इकाइयों सरल खुराक प्रकार के लिए आवश्यक है
+DrugOrder.error.routeIsNullForDosingTypeSimple=मार्ग सरल खुराक प्रकार के लिए आवश्यक है
+DrugOrder.error.frequencyIsNullForDosingTypeSimple=फ्रीक्वेंसी सरल खुराक प्रकार के लिए आवश्यक है
+DrugOrder.error.instructionIsNullForDosingTypeFreeText=निर्देश मुक्त पाठ खुराक प्रकार के लिए आवश्यक है
+DrugOrder.error.dosingInstructionsIsNullForDosingTypeFreeText=खुराक प्रकार नि: शुल्क पाठ्य अगर खुराक आईएनजी निर्देश आवश्यक हैं
+DrugOrder.error.routeNotAmongAllowedConcepts=Order.drugRoutesConceptUuid वैश्विक संपत्ति द्वारा निर्दिष्ट मार्ग अवधारणा की अनुमति दी अवधारणाओं के बीच होना चाहिए
+DrugOrder.error.drugIsRequired=ड्रग आवश्यक है
+DrugOrder.error.durationUnitsNotMappedToSnomedCtDurationCode=अवधि इकाइयों एक ही रूप में सेट करने के लिए नक्शे के प्रकार के साथ SNOMED सीटी अवधि कोड के लिए मैप किया जाना चाहिए
+
+TestOrder.error.specimenSourceNotAmongAllowedConcepts=Order.testSpecimenSourcesConceptUuid वैश्विक संपत्ति के द्वारा निर्दिष्ट के रूप में नमूना स्रोत अवधारणा की अनुमति दी अवधारणाओं के बीच होना चाहिए
+
+Encounter.header=सामना
+Encounter.manage=प्रबंधन का सामना 
+Encounter.manage.title=मुठभेड़ प्रबंधन
+Encounter.title=सामना
+Encounter.patient=रोगी
+Encounter.form=प्रपत्र
+Encounter.type.retired=सेवानिवृत्त
+Encounter.location=स्थान
+Encounter.provider=प्रदाता
+Encounter.provider.find=प्रदाता खोज
+Encounter.datetime=सामना की तिथि
+Encounter.find=सामना खोजें
+Encounter.search=सामना आईडी, रोगी पहचानकर्ता या नाम से खोजें:
+Encounter.search.placeholder=आईडी, रोगी का नाम या आईडी सामना दर्ज करे 
+Encounter.edit=सामना संपादित करे
+Encounter.view=देखें मुठभेड़
+Encounter.save=सामना सहेजें
+Encounter.add=सामना जोड़ें
+Encounter.list.title=वर्तमान सामने 
+Encounter.delete=चयनित सामना हटाएँ
+Encounter.saved=सामना सुरक्षित
+Encounter.deleted=सामना नष्ट
+Encounter.observations=टिप्पणियों
+Encounter.observations.view=इस सामने के लिए टिप्पणियों देखें
+Encounter.summary=सारांश सामना 
+Encounter.enterer=दर्ज किया
+Encounter.id=सामना आईडी
+Encounter.no.previous=कोई पिछला सामना नहीं 
+Encounter.last.encounters=आखरी टीम सामने
+Encounter.last.definedNumberOfEncounters=पिछले { 0} मुठभेड़ों
+Encounter.noFormDefined=(कोई परिभाषित फार्म नहीं)
+Encounter.page=पन्ना  {0}
+Encounter.type=सामने की प्रकार 
+Encounter.searchPhraseCannotBeNull=खोज वाक्यांश अशक्त नहीं हो सकता है
+Encounter.noMatchesFound=कोई मेल नहीं मिला  <b>{0} के लिए</b>
+Encounter.search.error=त्रुटि जब सामना खोजने का प्रयास
+Encounter.visit=भेंट
+Encounter.visit.patients.dontMatch=सामना और उस से जुड़े यात्रा एक ही रोगी के अंतर्गत आने चाहिए
+Encounter.patientIdCannotBeNull=रोगी आईडी रिक्त नहीं हो सकता है
+Encounter.error.patient.required=रोगी की आवश्यकता है
+Encounter.error.encounterIdCannotBeNull=सामना आईडी रिक्त नहीं हो सकता
+Encounter.error.duplicateProviderEncounterRole=प्रदाता एक ही मुठभेड़ भूमिका के लिए एक बार से अधिक नहीं जोड़ा जा सकता
+Encounter.error.encounterType.required=मुठभेड़ प्रकार आवश्यक है
+Encounter.cannot.save=सत्यापन त्रुटियों के कारण सामना सहेज नहीं सकता
+
+Encounter.open=खुली
+Encounter.datetimeShouldBeInVisitDatesRange=मुठभेड़ समयदिनाँक शुरू करने और तारीखों को रोकने की यात्रा के बीच होना चाहिए ।
+Encounter.datetimeShouldBeBeforeCurrent=मुठभेड़ समयदिनाँक आज की तारीख से पहले किया जाना चाहिए।
+Encounter.visits.enable=दौरा सक्षम करें
+Encounter.visits.handler.choose=स्वचालित रूप से दौरा करने के लिए मुठभेड़ों आवंटित करने के लिए इस्तेमाल किया जाएगा जो भेंट हैंडलर मुठभेड़ चुनें
+Encounter.error.visits.handler.empty=तुम यात्रा हैंडलर मुठभेड़ का चयन करना होगा
+Encounter.visits.configuration.savedSuccessfully=भेंट विन्यास को सहेज
+Encounter.provider.failedToAddProvider=प्रदाता जोड़ने में विफल
+Encounter.provider.failedToRemoveProvider=प्रदाता को दूर करने में विफल
+Encounter.provider.selectEncounterRole=एक मुठभेड़ भूमिका का चयन करें
+Encounter.provider.selectProvider=एक प्रदाता का चयन करें
+Encounter.provider.deleteProviderConfirm=क्या तुम सच में प्रदाता हटाना चाहते हैं :
+Encounter.noEncounters=अभी तक कोई मुठभेड़ों
+Encounter.provider.atleastOneProviderRequired=कम से कम एक प्रदाता के लिए आवश्यक है
+Encounter.datetime.required=मुठभेड़ दिनांक आवश्यक है
+EncounterRole.error.name.required=नाम की आवश्यकता है
+EncounterRole.saved=मुठभेड़ भूमिका को बचाया
+EncounterRole.manage=मुठभेड़ भूमिकाएँ प्रबंधित करें
+EncounterRole.manage.title=मुठभेड़ भूमिका प्रबंधन
+EncounterRole.create=मुठभेड़ भूमिका बनाएँ
+EncounterRole.edit=संपादित मुठभेड़ भूमिका
+EncounterRole.title=मुठभेड़ भूमिका
+EncounterRole.save=मुठभेड़ भूमिका सहेजें
+EncounterRole.add=मुठभेड़ भूमिका जोड़ें
+EncounterRole.list.title=वर्तमान मुठभेड़ भूमिकाएँ
+EncounterRole.delete=मुठभेड़ भूमिका हटाएं
+EncounterRole.retireEncounterRole=मुठभेड़ भूमिका रिटायर
+EncounterRole.retiredSuccessfully=मुठभेड़ भूमिका सफलतापूर्वक सेवानिवृत्त
+EncounterRole.unretire=संयुक्त राष्ट्र मुठभेड़ भूमिका रिटायर
+EncounterRole.unretired=मुठभेड़ भूमिका सफलतापूर्वक संयुक्त राष्ट्र के सेवानिवृत्त
+EncounterRole.purgedSuccessfully=मुठभेड़ भूमिका सफलतापूर्वक हमेशा के लिए हटा
+EncounterRole.purgeEncounterRole=हमेशा के लिए मुठभेड़ भूमिका हटाएं
+EncounterRole.error.duplicateEncounterRoleNameSpecified=मुठभेड़ भूमिका का नाम पहले से ही , एक और निर्दिष्ट कृपया मौजूद
+
+EncounterType.manage=सामना के प्रकार प्रबंधन
+EncounterType.manage.title=सामना के प्रकार प्रबंधन
+EncounterType.title=सामना के प्रकार
+EncounterType.save=सामना के प्रकार सहेजें 
+EncounterType.add=सामना के प्रकार जोड़ें
+EncounterType.list.title=वर्तमान सामना के प्रकार
+EncounterType.delete=चयनित सामना के प्रकार हटाएं
+EncounterType.saved=सामना के प्रकार सहेजें
+EncounterType.deleted=सामना के प्रकार नष्ट कर दिया
+EncounterType.cannot.delete=सामना के प्रकार को नष्ट नहीं किया जा सकता. डेटाबेस बाधाओं का उल्लंघन होगा. 
+EncounterType.select=आप को कम से कम एक सामना के प्रकार का चयन करना होगा.
+EncounterType.retireEncounterType=प्रकार सामना सेवानिवृत्त
+EncounterType.retiredSuccessfully=सामना के प्रकार सफलतापूर्वक सेवानिवृत्त
+EncounterType.retire=चयनित सामना के प्रकार रिटायर करे 
+EncounterType.purgedSuccessfully=सामना के प्रकार सफलतापूर्वक पुर्गेद 
+EncounterType.purgeEncounterType=सामना के प्रकार पुर्गेद 
+EncounterType.viewPrivilege=देखें प्रिविलेज
+EncounterType.viewPrivilege.help=एक उपयोगकर्ता द्वारा की जरूरत विशेषाधिकार इस प्रकार की मुठभेड़ों देखने के लिए
+EncounterType.editPrivilege=संपादित विशेषाधिकार
+EncounterType.editPrivilege.help=संपादित विशेषाधिकार
+EncounterType.privilege.disclaimer=आप सभी मुठभेड़ों डेटा को देखने की अनुमति नहीं है, इसलिए कुछ जानकारी प्रदर्शित नहीं किया जा सकता है।
+EncounterType.encounterTypes.locked=अनुमति नहीं है संपादन मुठभेड़ प्रकार , मुठभेड़ प्रकार बंद कर रहे हैं
+EncounterType.error.duplicateEncounterTypeNameSpecified=मुठभेड़ प्रकार नाम पहले से ही , एक और निर्दिष्ट कृपया मौजूद
+
+Form.header=प्रपत्र
+Form.manage=प्रपत्र प्रबंधन
+Form.fieldType=प्रपत्र
+Form.nonedeleted=कोई प्रपत्र को नष्ट नहीं किया गया 
+Form.edit=प्रपत्र संपादित करें
+Form.list.title=प्रपत्र
+Form.edit.title=मेटाडाटा संपादित करें
+Form.edit.resources=पर्चा संसाधन
+Form.design.title=स्कीमा डिजाइन
+Form.add=प्रपत्र जोड़ें
+Form.delete=प्रपत्र हटाएं
+Form.deleted=प्रपत्र सफलतापूर्वक नष्ट कर दिया
+Form.cannot.delete=प्रपत्र को नष्ट नहीं कर सकते. डेटाबेस प्रतिबंध यह रोक रहे हैं.
+Form.version=संस्करण
+Form.version.invalid=संस्करण एक संख्या के साथ शुरू करना चाहिए
+Form.save=प्रपत्र सहेजें
+Form.create.duplicate=प्रपत्र बनाएँ और स्कीमा डुप्लिकेट करे 
+Form.saved=प्रपत्र बचाया
+Form.not.saved=प्रपत्र सहेजा नहीं गया था
+Form.build=निर्माण करना
+Form.editProperties=मेटाडाटा संपादित करें
+Form.designSchema=डिजाइन स्कीमा
+Form.retiredMessage=यह फार्म सेवानिवृत्त है.
+Form.published=प्रकाशित
+Form.unpublished=अप्रकाशित
 Form.xslt=XSLT
-Form.xslt.view=XSLT देखें
-Form.xslt.upload=नई अपलोड
-Form.duplicate.or=या प्रपत्र प्रतिलिपि
-Form.duplicate=प्रतिलिपि
-Form.duplicated=प्रपत्र सफलतापूर्वक दोहराया
-Form.cannot.duplicate=फार्म का नकल नहीं कर सकते
-Form.design.disabled=प्रपत्र स्कीमा संपादन निष्क्रिय किया जाता है क्योंकि यह प्रपत्र प्रकाशित किया गया है
-Form.preview=पूर्वावलोकन: (प्रपत्र पेड़ में संपादित करने के लिए क्लिक करें)
-Form.formSchema=प्रपत्र स्कीमा
-Form.updateSortOrder=अद्यतन तत्व सॉर्ट क्रम
-Form.javascriptRequired=जावास्क्रिप्ट स्कीमा संपादक का उपयोग करने के लिए सक्षम होना चाहिए.
-Form.confirmation=क्या आप यकीन है कि आप इस पूरे फार्म और स्कीमा हटाना चाहते हैं?
-Form.auditSuccess={0} डुप्लिकेट कासफलतापूर्वक विलयन 
-Form.auditError=डुप्लिकेट का सफलतापूर्वक विलयन असफल हो गया है
-Form.manageResources=संसाधनों का प्रबंधन
-Form.resources.title=पर्चा संसाधन
-Form.resources.existing=मौजूदा संसाधनों
-Form.resource.name=नाम
-Form.resource.value=संसाधन मूल्य
-Form.resource.datatype=डेटा प्रकार
-Form.resource.add=संसाधन जोड़ें
-Form.addResource.title=एक संसाधन जोड़ें
-Form.addResource.chooseHandler=इस संसाधन के लिए एक यूआई हैंडलर चुनें
-forms.locked=प्रपत्र बंद कर रहे हैं
-
-FormField.add=फॉर्म फील्ड जोड़ें
-FormField.fieldNumber=क्षेत्र \# 
-FormField.fieldPart=फील्ड भाग 
-FormField.pageNumber=पेज \# 
-FormField.minOccurs=न्यूनतम 
-FormField.maxOccurs=अधिकतम
-FormField.maxOccurs.help=-1 अनंत के लिए 
-FormField.parent=माता - पिता
-FormField.required=अपेक्षित?
-FormField.field=क्षेत्र
-FormField.id=प्रपत्र फ़ील्ड आईडी
-FormField.edit=प्रपत्र फ़ील्ड संपादित करें
-FormField.audit=डुप्लिकेट फार्म क्षेत्रों में पाया क्षेत्रों को मजबूत करने के लिए बटन 'डुप्लिकेट मर्ज फ़ील्ड' पर क्लिक करें. डुप्लिकेट क्षेत्रों हटा दिया जाएगा और फार्म तो समेकित क्षेत्र संदर्भ जाएगा.
-FormField.auditButton=फील्ड्स डुप्लिकेट मर्ज
-FormField.auditConfirm=इस आपरेशन को उलट नहीं किया जा सकता.
-FormViewXSLT.closeWindow=विंडो बंद
-
-Field.manage=फील्ड्स प्रबंधन
-Field.name=फ़ील्ड का नाम
-Field.type=फ़ील्ड प्रकार
-Field.concept=संकल्पना
-Field.tableName=तालिका
-Field.attributeName=विशेषता
-Field.selectMultiple=बहु का चयन करें?
-Field.forms=# फॉर्म्स :
-Field.database=डेटाबेस
-Field.editForThisForm=इस फार्म के लिए संपादित करें
-Field.editForAllForms=सभी रूपों के लिए संपादित करें
-Field.addNewField=नई फील्ड जोड़ें
-Field.title=फील्ड्स
-Field.search=फील्ड्स नाम से खोज.:
-Field.saved=फील्ड सहेजा
-Field.add=नई फील्ड जोड़ें
-Field.find=फील्ड तत्वों को खोजे 
-Field.defaultValue=डिफ़ॉल्ट मान
-Field.editWarning=इस क्षेत्र विजेट अन्य रूपों पर इस्तेमाल किया जा रहा है. संपादन समस्याएं पैदा कर सकता है.
-Field.editWarning.allForms=सभी रूपों के लिए संपादित करें
-Field.editWarning.thisForm=इस फार्म के लिए ही संपादित करें
-Field.deleteWarning=इस क्षेत्र को हटाना, इसको स्थायी रूप से डेटाबेस से निकाल देंगे. जारी रखें?
-Field.formTableTitle=इस क्षेत्र का उपयोग कर प्रपत्र
-
-FieldAnswer.manage=फील्ड उत्तरों को प्रबंधित करें
-
-FieldType.manage=फ़ील्ड प्रकार का प्रबंधन
-FieldType.fieldType=फ़ील्ड प्रकार
-FieldType.nonedeleted=कोई फ़ील्ड प्रकार नष्ट नहीं
-FieldType.edit=फ़ील्ड प्रकार संपादित करें
-FieldType.list.title=फ़ील्ड प्रकार
-FieldType.isSet=एक सेट है
-FieldType.add=फ़ील्ड प्रकार जोड़ें
-FieldType.delete=चयनित क्षेत्र प्रकार हटाएं
-FieldType.save=	फ़ील्ड प्रकार सहेजें
-FieldType.saved=फ़ील्ड प्रकार को बचाया
-FieldType.cannot.delete=फ़ील्ड प्रकार को नष्ट नहीं किया जा सकता। इस क्षेत्र प्रकार अन्य वस्तुओं के द्वारा प्रयोग में है क्योंकि डाटाबेस बाधाओं का उल्लंघन किया जाएगा।
-
-GlobalProperty.manage=ग्लोबल संपत्तियों का प्रबंधन
-GlobalProperty.manage.title=ग्लोबल संपत्तियों
-GlobalProperty.list.title=वर्तमान संपत्तियों
-GlobalProperty.list.save=इन संपत्तियों को बचाओ
-GlobalProperty.remove=निकालें?
-GlobalProperty.property=संपत्ति
-GlobalProperty.property.deleted="{0}" संपत्ति नष्ट कर दिया
-GlobalProperty.property.notDeleted="{0}" संपत्ति को नष्ट नहीं किया जा सका
-GlobalProperty.add=जोड़ें संपत्ति
-GlobalProperty.error.name.required=नाम नई वैश्विक संपत्ति के लिए आवश्यक है
-GlobalProperty.saved=ग्लोबल गुण बचाई
-GlobalProperty.not.saved=ग्लोबल गुण नहीं बचाया
-GlobalProperty.toDelete=हटाने के लिए चिह्नित की गईं!
-
-ServerLog.view=सर्वेर  लोग देखे
-ServerLog.view.title=सर्वेर  लोग 
-
-Location.header=स्थान.
-Location.manage=स्थान प्रबंधित करें.
-Location.manage.title=स्थान प्रबंधन.
-Location.list.title=वर्तमान स्थान
-Location.title=स्थान
-Location.save=सहेजें स्थान
-Location.add=जोड़ें स्थान
-Location.delete=हटाएँ स्थान
-Location.address1=पता
-Location.address2=2 पता
-Location.cityVillage=सिटी / ग्राम
-Location.townVillage=टाउन / ग्राम
-Location.city=शहर
-Location.village=ग्राम
-Location.stateProvince=राज्य / प्रांत
-Location.state=राज्य
-Location.province=प्रांत
-Location.postalCode=पोस्टल कोड
-Location.country=देश
-Location.latitude अक्षांश=
-Location.longitude देशांतर=
-Location.saved=स्थान बचाया
-Location.deleted=स्थान नष्ट कर दिया
-Location.missing=किसी स्थान को खोजने में असमर्थ था.
-Location.district=जिला
-Location.sector=सेक्टर
-Location.cell=सेल
-Location.zipCode=ज़िप कोड
-Location.rwandanNeighborhood=rwandan पड़ोस
-Location.communityCouncil=समुदाय परिषद
-Location.location=स्थान
-Location.sublocation=सुब्लोकातिओं
-Location.sectionHomestead=धारा / होमेस्टाद
-Location.division=डिवीजन
-Location.township=टाउनशिप
-Location.county=काउंटी
-Location.estateNearestCentre=एस्टेट / निकटतम केंद्र
-Location.ward=वार्ड
-Location.villageStreet=ग्राम / स्ट्रीट
-Location.region=क्षेत्र
-Location.neighborhood=पड़ोस
-Location.traditionalAuthority=पारंपरिक प्राधिकरण
-Location.cannot.delete=स्थान नहीं मिटा सकता. डेटाबेस बाधाओं का उल्लंघन किया जाएगा.
-Location.select=आप कम से कम एक स्थान का चयन करना चाहिए.
-Location.retireLocation=इस स्थान को रिटायर
-Location.unretireLocation=इस स्थान अनसेनानिर्वित्र
-Location.retiredList=सेवानिवृत्त
-Location.retired=स्थान सफलतापूर्वक सेवानिवृत्त
-Location.unretired=स्थान सफलतापूर्वक अनसेनानिर्वित्र
-Location.parentLocation=जनक स्थान
-Location.childLocations=बाल स्थान
-Location.tags=टैग
-Location.search.error=स्थानों को खोजने का प्रयास करते समय त्रुटि
-Location.noLocationsFound=कोई भी स्थान मिला. कृपया फिर से खोज.
-Location.get.error=स्थानों को प्राप्त करने का प्रयास करते समय त्रुटि
-
-Location.hierarchy=स्थान पदानुक्रम
-Location.hierarchy.view=स्थान पदानुक्रम देखें
-Location.hierarchy.heading=सभी स्थान
-Location.hierarchy.chooseWidgetHeader=स्थान के लिए आवेदन में उपयोग विजेट
-Location.hierarchy.chooseWidgetStyle=शैली
-Location.hierarchy.widget.default=सरल
-Location.hierarchy.widget.tree=ट्री
-Location.hierarchy.example=नमूना
-Location.hierarchy.exampleLabel=स्थान चुनें
-
-LocationTag.manage=स्थान प्रबंधन टैग
-LocationTag.list.title=वर्तमान स्थान टैग
-LocationTag.edit.title=संपादन स्थान टैग
-LocationTag.add=जोड़ें स्थान टैग
-LocationTag.name=नाम
-LocationTag.description=विवरण
-LocationTag.saved=को बचाया
-LocationTag.purged=स्थान टैग purged
-LocationTag.retired=स्थान टैग सेवानिवृत्त
-LocationTag.unretired=स्थान टैग संयुक्त राष्ट्र के सेवानिवृत्त
-LocationTag.error.name.required=नाम की आवश्यकता है
-LocationTag.error.name.duplicate=वहां नाम पहले से ही उस एक टैग  के साथ है
-LocationTag.purge.allowed=इस टैग उपयोग में नहीं है, तो आप यह नहीं शुद्ध कर सकते हैं  
-LocationTag.cannot.purge.in.use=इस टैग को उपयोग में है, तो आप यह नहीं शुद्ध कर सकते हैं
-LocationTag.purgeRetire=हटाएँ/ रिटायर
-LocationTag.locationsWithTag=इस स्थान के साथ टैग 
-LocationTag.name.error=नाम आवश्यक है
-
-LocationAttributeType.manage=प्रदाता गुण प्रकार के प्रबंधन
-LocationAttributeType.manage.title=स्थान गुण प्रकार के प्रबंधन
-LocationAttributeType.add=स्थान गुण प्रकार जोड़ें
-LocationAttributeType.list.title=वर्तमान स्थान एट्रीब्यूट
-LocationAttributeType.add.title=स्थान गुण प्रकार जोड़ें
-LocationAttributeType.edit.title=स्थान संपादित करें गुण प्रकार
-LocationAttributeType.save=स्थान गुण प्रकार बचा
-LocationAttributeType.retire=स्थान गुण प्रकार रिटायर
-LocationAttributeType.purge=स्थान हमेशा के लिए प्रकार की विशेषता हटाएं
-LocationAttributeType.saved=सहेजे गए स्थान गुण प्रकार
-LocationAttributeType.retired=सेवानिवृत्त स्थान गुण प्रकार
-LocationAttributeType.unretired=संयुक्त राष्ट्र के सेवानिवृत्त स्थान गुण प्रकार
-LocationAttributeType.purgedSuccessfully=हटाए गए स्थान गुण को स्थायी रूप से टाइप
-LocationAttributeType.error.nameEmpty=एक गैर खाली अद्वितीय नाम दर्ज करें।
-LocationAttributeType.error.nameAlreadyInUse=आपके द्वारा दर्ज नाम पहले से ही प्रयोग में , एक अद्वितीय नाम दर्ज करें कृपया है ।
-
-Obs.person=व्यक्ति
-Obs.search=रोगी पहचानकर्ता द्वारा खोजें:
-Obs.save=सहेजें अवलोकन
-Obs.saved=अवलोकन बचाया
-Obs.numericAnswer=संख्यात्मक उत्तर
-Obs.value=मूल्य
-Obs.valueDrug=मूल्य औषध 
-Obs.order=आदेश
-Obs.header=अवलोकन
-Obs.manage=अवलोकन प्रबंधन
-Obs.manage.title=अवलोकन प्रबंधन
-Obs.title=अवलोकन
-Obs.location=स्थान
-Obs.datetime=अवलोकन तिथि
-Obs.find=अवलोकन खोजें
-Obs.add=जोड़ें अवलोकन
-Obs.list.title=वर्तमान अवलोकन 
-Obs.delete=हटाएँ चयनित अवलोकन
-Obs.deleted=अवलोकन नष्ट कर दिया
-Obs.encounter=मुठभेड़
-Obs.concept=प्रश्न संकल्पना
-Obs.complexAnswer=परिसर मूल्य
-Obs.textAnswer=पाठ उत्तर
-Obs.codedAnswer=उत्तर संकल्पना
-Obs.booleanAnswer=बूलियन उत्तर
-Obs.datetimeAnswer=उत्तर दिनांक / समय
-Obs.timeAnswer=बार जवाब
-Obs.dateAnswer=दिनांक जवाब
-Obs.accessionNumber=परिग्रहण संख्या
-Obs.groupId=ओ बीएस समूह ईद
-Obs.valueGroupId=मूल्य समूह ईद
-Obs.valueBoolean=मूल्य बूलियन
-Obs.valueCoded=मूल्य कोडित
-Obs.valueDatetime=मूल्य दिनांक - समय
-Obs.valueNumeric=मूल्य संख्यात्मक
-Obs.valueModifier=मूल्य संशोधक
-Obs.valueText=मान पाठ
-Obs.valueComplex.uploadNew=नई मूल्य अपलोड
-Obs.viewCurrentComplexValue=एक नई विंडो में वर्तमान जटिल मूल्य देखें
-Obs.downloadCurrentComplexValue=वर्तमान जटिल मूल्य डाउनलोड
-Obs.valueInvalid.description=अवैध संकल्पना चयनित!
-Obs.valueInvalid.didYouMean=आप होना अवधारणा मतलब है: 
-Obs.dateStarted=तिथि प्रारंभ
-Obs.dateStopped=तिथि रूका
-Obs.comment=कमेंट
-Obs.edit=संपादित टिप्पणियों
-Obs.edited=इस अवलोकन संपादित किया गया है
-Obs.afterEncounter.created=इस अवलोकन मुठभेड़ की मूल रचना के बाद जोड़ा गया है 
-Obs.edit.description=टिप्पणियों को संपादित करने के लिए, पहली मुठभेड़ के द्वारा खोज
-Obs.edit.reason.empty=संपादित कारण खाली नहीं हो सकता
-Obs.edit.reason=संपादित कारण
-Obs.creator.or.changedBy=निर्माता / द्वारा बदला
-Obs.form=प्रपत्र
-Obs.date=अवलोकन तारीख
-Obs.encounterDate=मुठभेड़ की तारीख
-Obs.error.groupContainsItself=ओ बीएस समूह बारी बारी से ही होता है
-Obs.error.inGroupMember=इस OBS समूह के एक सदस्य एक त्रुटि है
-Obs.error.noValue=ओ बीएस कोई मूल्य नहीं है
-Obs.unvoidObs=इस अवलोकन पुनर्स्थापित
-Obs.voidObs=इस अवलोकन हटाएं
-Obs.voidReason="कारण हटाने के लिए"
-Obs.void.reason.empty=कारण खाली नहीं हो सकता नष्ट करने के लिए
-Obs.void.reason=कारण हटाना
-Obs.voidedSuccessfully=ओ बीएस सफलतापूर्वक नष्ट कर दिया
-Obs.unvoidedSuccessfully=ओ बीएस सफलतापूर्वक बहाल
-Obs.answer.drug=उत्तर औषध
-Obs.error.invalidDrug=दवा के लिए जुड़े जवाब अवधारणा और इस अवधारणा से मेल खाना चाहिए
-Obs.drug.search.placeholder=दवा का नाम दर्ज
-Obs.invalidImage=संलग्न फाइल में एक वैध छवि फ़ाइल होना चाहिए
-Obs.namespaceAndPathTooLong=प्रपत्र फ़ील्ड के लिए नाम स्थान और पथ की संयुक्त लंबाई 254 अक्षरों से अधिक नहीं होना चाहिए
-Obs.namespaceAndPathNotContainSeparator=प्रपत्र फ़ील्ड के लिए नाम स्थान और पथ charet चरित्र को शामिल नहीं करना चाहिए
-
-OrderType.manage=आदेश प्रबंधन के प्रकार
-OrderType.manage.title आदेश=प्रकार प्रबंधन
-OrderType.title=आदेश प्रकार
-OrderType.save=आदेश प्रकार सहेजें
-OrderType.add=आदेश प्रकार जोड़ें
-OrderType.list.title=वर्तमान आदेश प्रकार
-OrderType.delete=हटाएँ चयनित आदेश के प्रकार
-OrderType.saved=आदेश प्रकार को बचाया
-OrderType.deleted आदेश=नष्ट कर दिया प्रकार
-OrderType.list.empty=वर्तमान में, वहाँ कोई आदेश प्रकार परिभाषित कर रहे हैं
-OrderType.cannot.delete=आदेश प्रकार नष्ट नहीं कर सकते. डेटाबेस बाधाओं का उल्लंघन किया जाएगा.
-OrderType.select=आप कम से कम एक आदेश प्रकार का चयन करना होगा.
-OrderType.duplicate.name={0} एक नकली आदेश प्रकार का नाम है
-OrderType.duplicate={0} पहले से ही एक अन्य आदेश टाइप करने के लिए जुड़ा हुआ है : { 1}
-OrderType.parent.amongDescendants=एक आदेश प्रकार {0} के लिए एक माता पिता भी अपने पूर्वज नहीं किया जा सकता
-
-Order.header=आदेश
-Order.manage=प्रबंधन आदेश
-Order.manage.title=आदेश प्रबंधन
-Order.title=आदेश
-Order.save=सहेजें आदेश
-Order.add=जोड़ने के क्रम
-Order.place=आदेश दे 
-Order.list.title=वर्तमान आदेश
-Order.list.empty=वर्तमान में, वहाँ कोई आदेश नहीं
-Order.list.saved=आदेशों को बचाया
-Order.delete=हटाएँ चयनित आदेश
-Order.void=शून्य चयनित आदेश
-Order.voidOrder=इस आदेश को शून्य करे.
-Order.unvoidOrder=इस आदेश को अनशून्य करे.
-Order.discontinueOrder=इस आदेश के बंद करे 
-Order.undiscontinueOrder=इस आदेश को दुबरा चालू करे.
-Order.saved=आदेश बचाया
-Order.voidedSuccessfully=आदेश सफलतापूर्वक शून्य
-Order.unvoidedSuccessfully=आदेश सफलतापूर्वक अनशून्य
-Order.discontinuedSuccessfully=आदेश सफलतापूर्वक बंद कर दिया.
-Order.undiscontinuedSuccessfully=आदेश अनसफलतापूर्वक बंद कर दिया.
-Order.deleted=आदेश हटाया गया
-Order.concept=संबंधित संकल्पना
-Order.conceptDrug=दवा
-Order.patient=रोगी
-Order.encounter=संबंधित सामना 
-Order.orderable=सक्षम आदेश
-Order.orderer=आदेश देने वाला 
-Order.orderType=आदेश प्रकार
-Order.item.ordered=आइटम का आदेश दिया
-Order.view.mine=देखें आदेश
-Order.list.patient=रोगी द्वारा देखें दवा/आदेश
-Order.list.patient.choose=एक मरीज का चयन करें
-Order.list.patient.title=रोगी के लिए दवाओं के आदेश #{0} ({1}, {2})
-Order.drug.add=जोड़ें औषध आदेश
-Order.drug.manage=औषध प्रबंधन आदेश
-Order.drug.manage.title औषध=आदेश प्रबंधन
-Order.drug.list.title=मौजूदा दवा आदेश
-Order.drug.list.empty=वर्तमान में, कोई दवा आदेश
-Order.drug.list.saved=औषध आदेश बचाई
-Order.drug.header=औषध आदेश
-Order.drug.title=संपादित करें ड्रग आदेश
-Order.drug.save=सहेजें औषध आदेश
-Order.drug.delete=हटाएँ चयनित औषध आदेश
-Order.drug.saved=औषध आदेश बचाया
-Order.drug.deleted=औषध आदेश हटाया गया
-Order.drug.place.patient=इस रोगी के लिए आदेश दे 
-Order.error.encounterPatientMismatch=मुठभेड़ के लिए इस आदेश के इस आदेश के लिए रोगी का होना चाहिए
-Order.error.startDateAfterDiscontinuedDate=प्रारंभ दिनांक बंद की तारीख से पहले होने चाहिए 
-Order.error.startDateAfterAutoExpireDate=प्रारंभ दिनांक से पहले तिथि ऑटो समय सीमा समाप्त हो होना चाहिए
-Order.error.dateActivatedAfterDiscontinuedDate=सक्रिय तिथि से पहले की तारीख बंद किया जाना चाहिए
-Order.error.dateActivatedAfterAutoExpireDate=तारीख ऑटो एक्सपायर पहले सक्रिय तिथि होना चाहिए
-Orderable.search.placeholder=आदेश में सक्षम दर्ज
-Order.error.dateActivatedInFuture=सक्रिय तिथि भविष्य में नहीं हो सकता
-Order.error.scheduledDateNullForOnScheduledDateUrgency=तात्कालिकता निर्धारित तिथि पर करने के लिए सेट कर दिया जाता है जब अनुसूचित दिनांक आवश्यक है
-Order.error.urgencyNotOnScheduledDate=तात्कालिकता निर्धारित तिथि पर करने के लिए सेट नहीं है जब अनुसूचित तिथि निर्धारित नहीं की जानी चाहिए
-Order.error.encounterDatetimeAfterDateActivated=सक्रिय तिथि जुड़े मुठभेड़ के उस से पहले नहीं हो सकता
-Order.error.orderTypeClassMismatchesOrderClass=एक आदेश के जावा प्रकार जुड़े क्रम प्रकार पर कि सेट से मेल खाना चाहिए
-
-Patient.header=मरीजों
-Patient.title=रोगी
-Patient.search=रोगी खोज
-Patient.searchBox=रोगी पहचानकर्ता या रोगी का नाम:
-Patient.searchBox.placeholder=रोगी का नाम या आईडी दर्ज करें
-Patient.find=रोगी खोजें (ओं)
-Patient.findBy=नाम या पहचानकर्ता द्वारा एक मरीज का पता लगाएं:
-Patient.manage=प्रबंधन मरीजों
-Patient.identifier=पहचानकर्ता
-error.identifier=अमान्य पहचानकर्ता
-Patient.identifiers=रोगी पहचानकर्ता
-Patient.edit=इस रोगी संपादित करें
-Patient.edit.short=इस रोगी (संक्षिप्त रूप) संपादित करें
-Patient.create=एक नए मरीज बनाएँ
-Patient.verboseListing=वर्बोज़ लिस्टिंग
-Patient.dashboard.title=रोगी डैशबोर्ड
-Patient.patientDeceased=इस मरीज मृतक
-Patient.gender=लिंग
-Patient.gender.male=पुरुष
-Patient.gender.female=महिला
-Patient.regimen=रहन - सहन एवं आहार सम्बन्धी नियम
-Patient.weight=वजन
-Patient.height=ऊँचाई
+Form.xslt.view=XSLT देखें
+Form.xslt.upload=नई अपलोड
+Form.duplicate.or=या प्रपत्र प्रतिलिपि
+Form.duplicate=प्रतिलिपि
+Form.duplicated=प्रपत्र सफलतापूर्वक दोहराया
+Form.cannot.duplicate=फार्म का नकल नहीं कर सकते
+Form.design.disabled=प्रपत्र स्कीमा संपादन निष्क्रिय किया जाता है क्योंकि यह प्रपत्र प्रकाशित किया गया है
+Form.preview=पूर्वावलोकन: (प्रपत्र पेड़ में संपादित करने के लिए क्लिक करें)
+Form.formSchema=प्रपत्र स्कीमा
+Form.updateSortOrder=अद्यतन तत्व सॉर्ट क्रम
+Form.javascriptRequired=जावास्क्रिप्ट स्कीमा संपादक का उपयोग करने के लिए सक्षम होना चाहिए.
+Form.confirmation=क्या आप यकीन है कि आप इस पूरे फार्म और स्कीमा हटाना चाहते हैं?
+Form.auditSuccess={0} डुप्लिकेट कासफलतापूर्वक विलयन 
+Form.auditError=डुप्लिकेट का सफलतापूर्वक विलयन असफल हो गया है
+Form.manageResources=संसाधनों का प्रबंधन
+Form.resources.title=पर्चा संसाधन
+Form.resources.existing=मौजूदा संसाधनों
+Form.resource.name=नाम
+Form.resource.value=संसाधन मूल्य
+Form.resource.datatype=डेटा प्रकार
+Form.resource.add=संसाधन जोड़ें
+Form.addResource.title=एक संसाधन जोड़ें
+Form.addResource.chooseHandler=इस संसाधन के लिए एक यूआई हैंडलर चुनें
+forms.locked=प्रपत्र बंद कर रहे हैं
+
+FormField.add=फॉर्म फील्ड जोड़ें
+FormField.fieldNumber=क्षेत्र \# 
+FormField.fieldPart=फील्ड भाग 
+FormField.pageNumber=पेज \# 
+FormField.minOccurs=न्यूनतम 
+FormField.maxOccurs=अधिकतम
+FormField.maxOccurs.help=-1 अनंत के लिए 
+FormField.parent=माता - पिता
+FormField.required=अपेक्षित?
+FormField.field=क्षेत्र
+FormField.id=प्रपत्र फ़ील्ड आईडी
+FormField.edit=प्रपत्र फ़ील्ड संपादित करें
+FormField.audit=डुप्लिकेट फार्म क्षेत्रों में पाया क्षेत्रों को मजबूत करने के लिए बटन 'डुप्लिकेट मर्ज फ़ील्ड' पर क्लिक करें. डुप्लिकेट क्षेत्रों हटा दिया जाएगा और फार्म तो समेकित क्षेत्र संदर्भ जाएगा.
+FormField.auditButton=फील्ड्स डुप्लिकेट मर्ज
+FormField.auditConfirm=इस आपरेशन को उलट नहीं किया जा सकता.
+FormViewXSLT.closeWindow=विंडो बंद
+
+Field.manage=फील्ड्स प्रबंधन
+Field.name=फ़ील्ड का नाम
+Field.type=फ़ील्ड प्रकार
+Field.concept=संकल्पना
+Field.tableName=तालिका
+Field.attributeName=विशेषता
+Field.selectMultiple=बहु का चयन करें?
+Field.forms=# फॉर्म्स :
+Field.database=डेटाबेस
+Field.editForThisForm=इस फार्म के लिए संपादित करें
+Field.editForAllForms=सभी रूपों के लिए संपादित करें
+Field.addNewField=नई फील्ड जोड़ें
+Field.title=फील्ड्स
+Field.search=फील्ड्स नाम से खोज.:
+Field.saved=फील्ड सहेजा
+Field.add=नई फील्ड जोड़ें
+Field.find=फील्ड तत्वों को खोजे 
+Field.defaultValue=डिफ़ॉल्ट मान
+Field.editWarning=इस क्षेत्र विजेट अन्य रूपों पर इस्तेमाल किया जा रहा है. संपादन समस्याएं पैदा कर सकता है.
+Field.editWarning.allForms=सभी रूपों के लिए संपादित करें
+Field.editWarning.thisForm=इस फार्म के लिए ही संपादित करें
+Field.deleteWarning=इस क्षेत्र को हटाना, इसको स्थायी रूप से डेटाबेस से निकाल देंगे. जारी रखें?
+Field.formTableTitle=इस क्षेत्र का उपयोग कर प्रपत्र
+
+FieldAnswer.manage=फील्ड उत्तरों को प्रबंधित करें
+
+FieldType.manage=फ़ील्ड प्रकार का प्रबंधन
+FieldType.fieldType=फ़ील्ड प्रकार
+FieldType.nonedeleted=कोई फ़ील्ड प्रकार नष्ट नहीं
+FieldType.edit=फ़ील्ड प्रकार संपादित करें
+FieldType.list.title=फ़ील्ड प्रकार
+FieldType.isSet=एक सेट है
+FieldType.add=फ़ील्ड प्रकार जोड़ें
+FieldType.delete=चयनित क्षेत्र प्रकार हटाएं
+FieldType.save=	फ़ील्ड प्रकार सहेजें
+FieldType.saved=फ़ील्ड प्रकार को बचाया
+FieldType.cannot.delete=फ़ील्ड प्रकार को नष्ट नहीं किया जा सकता। इस क्षेत्र प्रकार अन्य वस्तुओं के द्वारा प्रयोग में है क्योंकि डाटाबेस बाधाओं का उल्लंघन किया जाएगा।
+
+GlobalProperty.manage=ग्लोबल संपत्तियों का प्रबंधन
+GlobalProperty.manage.title=ग्लोबल संपत्तियों
+GlobalProperty.list.title=वर्तमान संपत्तियों
+GlobalProperty.list.save=इन संपत्तियों को बचाओ
+GlobalProperty.remove=निकालें?
+GlobalProperty.property=संपत्ति
+GlobalProperty.property.deleted="{0}" संपत्ति नष्ट कर दिया
+GlobalProperty.property.notDeleted="{0}" संपत्ति को नष्ट नहीं किया जा सका
+GlobalProperty.add=जोड़ें संपत्ति
+GlobalProperty.error.name.required=नाम नई वैश्विक संपत्ति के लिए आवश्यक है
+GlobalProperty.saved=ग्लोबल गुण बचाई
+GlobalProperty.not.saved=ग्लोबल गुण नहीं बचाया
+GlobalProperty.toDelete=हटाने के लिए चिह्नित की गईं!
+
+ServerLog.view=सर्वेर  लोग देखे
+ServerLog.view.title=सर्वेर  लोग 
+
+Location.header=स्थान.
+Location.manage=स्थान प्रबंधित करें.
+Location.manage.title=स्थान प्रबंधन.
+Location.list.title=वर्तमान स्थान
+Location.title=स्थान
+Location.save=सहेजें स्थान
+Location.add=जोड़ें स्थान
+Location.delete=हटाएँ स्थान
+Location.address1=पता
+Location.address2=2 पता
+Location.cityVillage=सिटी / ग्राम
+Location.townVillage=टाउन / ग्राम
+Location.city=शहर
+Location.village=ग्राम
+Location.stateProvince=राज्य / प्रांत
+Location.state=राज्य
+Location.province=प्रांत
+Location.postalCode=पोस्टल कोड
+Location.country=देश
+Location.latitude अक्षांश=
+Location.longitude देशांतर=
+Location.saved=स्थान बचाया
+Location.deleted=स्थान नष्ट कर दिया
+Location.missing=किसी स्थान को खोजने में असमर्थ था.
+Location.district=जिला
+Location.sector=सेक्टर
+Location.cell=सेल
+Location.zipCode=ज़िप कोड
+Location.rwandanNeighborhood=rwandan पड़ोस
+Location.communityCouncil=समुदाय परिषद
+Location.location=स्थान
+Location.sublocation=सुब्लोकातिओं
+Location.sectionHomestead=धारा / होमेस्टाद
+Location.division=डिवीजन
+Location.township=टाउनशिप
+Location.county=काउंटी
+Location.estateNearestCentre=एस्टेट / निकटतम केंद्र
+Location.ward=वार्ड
+Location.villageStreet=ग्राम / स्ट्रीट
+Location.region=क्षेत्र
+Location.neighborhood=पड़ोस
+Location.traditionalAuthority=पारंपरिक प्राधिकरण
+Location.cannot.delete=स्थान नहीं मिटा सकता. डेटाबेस बाधाओं का उल्लंघन किया जाएगा.
+Location.select=आप कम से कम एक स्थान का चयन करना चाहिए.
+Location.retireLocation=इस स्थान को रिटायर
+Location.unretireLocation=इस स्थान अनसेनानिर्वित्र
+Location.retiredList=सेवानिवृत्त
+Location.retired=स्थान सफलतापूर्वक सेवानिवृत्त
+Location.unretired=स्थान सफलतापूर्वक अनसेनानिर्वित्र
+Location.parentLocation=जनक स्थान
+Location.childLocations=बाल स्थान
+Location.tags=टैग
+Location.search.error=स्थानों को खोजने का प्रयास करते समय त्रुटि
+Location.noLocationsFound=कोई भी स्थान मिला. कृपया फिर से खोज.
+Location.get.error=स्थानों को प्राप्त करने का प्रयास करते समय त्रुटि
+
+Location.hierarchy=स्थान पदानुक्रम
+Location.hierarchy.view=स्थान पदानुक्रम देखें
+Location.hierarchy.heading=सभी स्थान
+Location.hierarchy.chooseWidgetHeader=स्थान के लिए आवेदन में उपयोग विजेट
+Location.hierarchy.chooseWidgetStyle=शैली
+Location.hierarchy.widget.default=सरल
+Location.hierarchy.widget.tree=ट्री
+Location.hierarchy.example=नमूना
+Location.hierarchy.exampleLabel=स्थान चुनें
+
+LocationTag.manage=स्थान प्रबंधन टैग
+LocationTag.list.title=वर्तमान स्थान टैग
+LocationTag.edit.title=संपादन स्थान टैग
+LocationTag.add=जोड़ें स्थान टैग
+LocationTag.name=नाम
+LocationTag.description=विवरण
+LocationTag.saved=को बचाया
+LocationTag.purged=स्थान टैग purged
+LocationTag.retired=स्थान टैग सेवानिवृत्त
+LocationTag.unretired=स्थान टैग संयुक्त राष्ट्र के सेवानिवृत्त
+LocationTag.error.name.required=नाम की आवश्यकता है
+LocationTag.error.name.duplicate=वहां नाम पहले से ही उस एक टैग  के साथ है
+LocationTag.purge.allowed=इस टैग उपयोग में नहीं है, तो आप यह नहीं शुद्ध कर सकते हैं  
+LocationTag.cannot.purge.in.use=इस टैग को उपयोग में है, तो आप यह नहीं शुद्ध कर सकते हैं
+LocationTag.purgeRetire=हटाएँ/ रिटायर
+LocationTag.locationsWithTag=इस स्थान के साथ टैग 
+LocationTag.name.error=नाम आवश्यक है
+
+LocationAttributeType.manage=प्रदाता गुण प्रकार के प्रबंधन
+LocationAttributeType.manage.title=स्थान गुण प्रकार के प्रबंधन
+LocationAttributeType.add=स्थान गुण प्रकार जोड़ें
+LocationAttributeType.list.title=वर्तमान स्थान एट्रीब्यूट
+LocationAttributeType.add.title=स्थान गुण प्रकार जोड़ें
+LocationAttributeType.edit.title=स्थान संपादित करें गुण प्रकार
+LocationAttributeType.save=स्थान गुण प्रकार बचा
+LocationAttributeType.retire=स्थान गुण प्रकार रिटायर
+LocationAttributeType.purge=स्थान हमेशा के लिए प्रकार की विशेषता हटाएं
+LocationAttributeType.saved=सहेजे गए स्थान गुण प्रकार
+LocationAttributeType.retired=सेवानिवृत्त स्थान गुण प्रकार
+LocationAttributeType.unretired=संयुक्त राष्ट्र के सेवानिवृत्त स्थान गुण प्रकार
+LocationAttributeType.purgedSuccessfully=हटाए गए स्थान गुण को स्थायी रूप से टाइप
+LocationAttributeType.error.nameEmpty=एक गैर खाली अद्वितीय नाम दर्ज करें।
+LocationAttributeType.error.nameAlreadyInUse=आपके द्वारा दर्ज नाम पहले से ही प्रयोग में , एक अद्वितीय नाम दर्ज करें कृपया है ।
+
+Obs.person=व्यक्ति
+Obs.search=रोगी पहचानकर्ता द्वारा खोजें:
+Obs.save=सहेजें अवलोकन
+Obs.saved=अवलोकन बचाया
+Obs.numericAnswer=संख्यात्मक उत्तर
+Obs.value=मूल्य
+Obs.valueDrug=मूल्य औषध 
+Obs.order=आदेश
+Obs.header=अवलोकन
+Obs.manage=अवलोकन प्रबंधन
+Obs.manage.title=अवलोकन प्रबंधन
+Obs.title=अवलोकन
+Obs.location=स्थान
+Obs.datetime=अवलोकन तिथि
+Obs.find=अवलोकन खोजें
+Obs.add=जोड़ें अवलोकन
+Obs.list.title=वर्तमान अवलोकन 
+Obs.delete=हटाएँ चयनित अवलोकन
+Obs.deleted=अवलोकन नष्ट कर दिया
+Obs.encounter=मुठभेड़
+Obs.concept=प्रश्न संकल्पना
+Obs.complexAnswer=परिसर मूल्य
+Obs.textAnswer=पाठ उत्तर
+Obs.codedAnswer=उत्तर संकल्पना
+Obs.booleanAnswer=बूलियन उत्तर
+Obs.datetimeAnswer=उत्तर दिनांक / समय
+Obs.timeAnswer=बार जवाब
+Obs.dateAnswer=दिनांक जवाब
+Obs.accessionNumber=परिग्रहण संख्या
+Obs.groupId=ओ बीएस समूह ईद
+Obs.valueGroupId=मूल्य समूह ईद
+Obs.valueBoolean=मूल्य बूलियन
+Obs.valueCoded=मूल्य कोडित
+Obs.valueDatetime=मूल्य दिनांक - समय
+Obs.valueNumeric=मूल्य संख्यात्मक
+Obs.valueModifier=मूल्य संशोधक
+Obs.valueText=मान पाठ
+Obs.valueComplex.uploadNew=नई मूल्य अपलोड
+Obs.viewCurrentComplexValue=एक नई विंडो में वर्तमान जटिल मूल्य देखें
+Obs.downloadCurrentComplexValue=वर्तमान जटिल मूल्य डाउनलोड
+Obs.valueInvalid.description=अवैध संकल्पना चयनित!
+Obs.valueInvalid.didYouMean=आप होना अवधारणा मतलब है: 
+Obs.dateStarted=तिथि प्रारंभ
+Obs.dateStopped=तिथि रूका
+Obs.comment=कमेंट
+Obs.edit=संपादित टिप्पणियों
+Obs.edited=इस अवलोकन संपादित किया गया है
+Obs.afterEncounter.created=इस अवलोकन मुठभेड़ की मूल रचना के बाद जोड़ा गया है 
+Obs.edit.description=टिप्पणियों को संपादित करने के लिए, पहली मुठभेड़ के द्वारा खोज
+Obs.edit.reason.empty=संपादित कारण खाली नहीं हो सकता
+Obs.edit.reason=संपादित कारण
+Obs.creator.or.changedBy=निर्माता / द्वारा बदला
+Obs.form=प्रपत्र
+Obs.date=अवलोकन तारीख
+Obs.encounterDate=मुठभेड़ की तारीख
+Obs.error.groupContainsItself=ओ बीएस समूह बारी बारी से ही होता है
+Obs.error.inGroupMember=इस OBS समूह के एक सदस्य एक त्रुटि है
+Obs.error.noValue=ओ बीएस कोई मूल्य नहीं है
+Obs.unvoidObs=इस अवलोकन पुनर्स्थापित
+Obs.voidObs=इस अवलोकन हटाएं
+Obs.voidReason="कारण हटाने के लिए"
+Obs.void.reason.empty=कारण खाली नहीं हो सकता नष्ट करने के लिए
+Obs.void.reason=कारण हटाना
+Obs.voidedSuccessfully=ओ बीएस सफलतापूर्वक नष्ट कर दिया
+Obs.unvoidedSuccessfully=ओ बीएस सफलतापूर्वक बहाल
+Obs.answer.drug=उत्तर औषध
+Obs.error.invalidDrug=दवा के लिए जुड़े जवाब अवधारणा और इस अवधारणा से मेल खाना चाहिए
+Obs.drug.search.placeholder=दवा का नाम दर्ज
+Obs.invalidImage=संलग्न फाइल में एक वैध छवि फ़ाइल होना चाहिए
+Obs.namespaceAndPathTooLong=प्रपत्र फ़ील्ड के लिए नाम स्थान और पथ की संयुक्त लंबाई 254 अक्षरों से अधिक नहीं होना चाहिए
+Obs.namespaceAndPathNotContainSeparator=प्रपत्र फ़ील्ड के लिए नाम स्थान और पथ charet चरित्र को शामिल नहीं करना चाहिए
+
+OrderType.manage=आदेश प्रबंधन के प्रकार
+OrderType.manage.title आदेश=प्रकार प्रबंधन
+OrderType.title=आदेश प्रकार
+OrderType.save=आदेश प्रकार सहेजें
+OrderType.add=आदेश प्रकार जोड़ें
+OrderType.list.title=वर्तमान आदेश प्रकार
+OrderType.delete=हटाएँ चयनित आदेश के प्रकार
+OrderType.saved=आदेश प्रकार को बचाया
+OrderType.deleted आदेश=नष्ट कर दिया प्रकार
+OrderType.list.empty=वर्तमान में, वहाँ कोई आदेश प्रकार परिभाषित कर रहे हैं
+OrderType.cannot.delete=आदेश प्रकार नष्ट नहीं कर सकते. डेटाबेस बाधाओं का उल्लंघन किया जाएगा.
+OrderType.select=आप कम से कम एक आदेश प्रकार का चयन करना होगा.
+OrderType.duplicate.name={0} एक नकली आदेश प्रकार का नाम है
+OrderType.duplicate={0} पहले से ही एक अन्य आदेश टाइप करने के लिए जुड़ा हुआ है : { 1}
+OrderType.parent.amongDescendants=एक आदेश प्रकार {0} के लिए एक माता पिता भी अपने पूर्वज नहीं किया जा सकता
+
+Order.header=आदेश
+Order.manage=प्रबंधन आदेश
+Order.manage.title=आदेश प्रबंधन
+Order.title=आदेश
+Order.save=सहेजें आदेश
+Order.add=जोड़ने के क्रम
+Order.place=आदेश दे 
+Order.list.title=वर्तमान आदेश
+Order.list.empty=वर्तमान में, वहाँ कोई आदेश नहीं
+Order.list.saved=आदेशों को बचाया
+Order.delete=हटाएँ चयनित आदेश
+Order.void=शून्य चयनित आदेश
+Order.voidOrder=इस आदेश को शून्य करे.
+Order.unvoidOrder=इस आदेश को अनशून्य करे.
+Order.discontinueOrder=इस आदेश के बंद करे 
+Order.undiscontinueOrder=इस आदेश को दुबरा चालू करे.
+Order.saved=आदेश बचाया
+Order.voidedSuccessfully=आदेश सफलतापूर्वक शून्य
+Order.unvoidedSuccessfully=आदेश सफलतापूर्वक अनशून्य
+Order.discontinuedSuccessfully=आदेश सफलतापूर्वक बंद कर दिया.
+Order.undiscontinuedSuccessfully=आदेश अनसफलतापूर्वक बंद कर दिया.
+Order.deleted=आदेश हटाया गया
+Order.concept=संबंधित संकल्पना
+Order.conceptDrug=दवा
+Order.patient=रोगी
+Order.encounter=संबंधित सामना 
+Order.orderable=सक्षम आदेश
+Order.orderer=आदेश देने वाला 
+Order.orderType=आदेश प्रकार
+Order.item.ordered=आइटम का आदेश दिया
+Order.view.mine=देखें आदेश
+Order.list.patient=रोगी द्वारा देखें दवा/आदेश
+Order.list.patient.choose=एक मरीज का चयन करें
+Order.list.patient.title=रोगी के लिए दवाओं के आदेश #{0} ({1}, {2})
+Order.drug.add=जोड़ें औषध आदेश
+Order.drug.manage=औषध प्रबंधन आदेश
+Order.drug.manage.title औषध=आदेश प्रबंधन
+Order.drug.list.title=मौजूदा दवा आदेश
+Order.drug.list.empty=वर्तमान में, कोई दवा आदेश
+Order.drug.list.saved=औषध आदेश बचाई
+Order.drug.header=औषध आदेश
+Order.drug.title=संपादित करें ड्रग आदेश
+Order.drug.save=सहेजें औषध आदेश
+Order.drug.delete=हटाएँ चयनित औषध आदेश
+Order.drug.saved=औषध आदेश बचाया
+Order.drug.deleted=औषध आदेश हटाया गया
+Order.drug.place.patient=इस रोगी के लिए आदेश दे 
+Order.error.encounterPatientMismatch=मुठभेड़ के लिए इस आदेश के इस आदेश के लिए रोगी का होना चाहिए
+Order.error.startDateAfterDiscontinuedDate=प्रारंभ दिनांक बंद की तारीख से पहले होने चाहिए 
+Order.error.startDateAfterAutoExpireDate=प्रारंभ दिनांक से पहले तिथि ऑटो समय सीमा समाप्त हो होना चाहिए
+Order.error.dateActivatedAfterDiscontinuedDate=सक्रिय तिथि से पहले की तारीख बंद किया जाना चाहिए
+Order.error.dateActivatedAfterAutoExpireDate=तारीख ऑटो एक्सपायर पहले सक्रिय तिथि होना चाहिए
+Orderable.search.placeholder=आदेश में सक्षम दर्ज
+Order.error.dateActivatedInFuture=सक्रिय तिथि भविष्य में नहीं हो सकता
+Order.error.scheduledDateNullForOnScheduledDateUrgency=तात्कालिकता निर्धारित तिथि पर करने के लिए सेट कर दिया जाता है जब अनुसूचित दिनांक आवश्यक है
+Order.error.urgencyNotOnScheduledDate=तात्कालिकता निर्धारित तिथि पर करने के लिए सेट नहीं है जब अनुसूचित तिथि निर्धारित नहीं की जानी चाहिए
+Order.error.encounterDatetimeAfterDateActivated=सक्रिय तिथि जुड़े मुठभेड़ के उस से पहले नहीं हो सकता
+Order.error.orderTypeClassMismatchesOrderClass=एक आदेश के जावा प्रकार जुड़े क्रम प्रकार पर कि सेट से मेल खाना चाहिए
+
+Patient.header=मरीजों
+Patient.title=रोगी
+Patient.search=रोगी खोज
+Patient.searchBox=रोगी पहचानकर्ता या रोगी का नाम:
+Patient.searchBox.placeholder=रोगी का नाम या आईडी दर्ज करें
+Patient.find=रोगी खोजें (ओं)
+Patient.findBy=नाम या पहचानकर्ता द्वारा एक मरीज का पता लगाएं:
+Patient.manage=प्रबंधन मरीजों
+Patient.identifier=पहचानकर्ता
+error.identifier=अमान्य पहचानकर्ता
+Patient.identifiers=रोगी पहचानकर्ता
+Patient.edit=इस रोगी संपादित करें
+Patient.edit.short=इस रोगी (संक्षिप्त रूप) संपादित करें
+Patient.create=एक नए मरीज बनाएँ
+Patient.verboseListing=वर्बोज़ लिस्टिंग
+Patient.dashboard.title=रोगी डैशबोर्ड
+Patient.patientDeceased=इस मरीज मृतक
+Patient.gender=लिंग
+Patient.gender.male=पुरुष
+Patient.gender.female=महिला
+Patient.regimen=रहन - सहन एवं आहार सम्बन्धी नियम
+Patient.weight=वजन
+Patient.height=ऊँचाई
 Patient.bmi=BMI
 Patient.cd4=CD4
-Patient.returnVisit=वापसी यात्रा 
-Patient.encounters=मुठभेड़ों
-Patient.lastEncounter=अंतिम मुठभेड़
-Patient.addNew=नए रोगी जोड़ें
-Patient.findOrCreate=खोजें / एक रोगी बनाएँ
-Patient.info.general=सामान्य जानकारी
-Patient.info.regimen=वर्तमान रहन - सहन एवं आहार सम्बन्धी नियम
-Patient.info.history.regimen=पथ्यापथ्य इतिहास
-Patient.info.weight=वजन इतिहास
-Patient.info.cd4=CD4 गणना इतिहास
-Patient.info.alerts=रोगी अलर्ट
-Patient.info.notes=नैदानिक ​​नोट्स
-Patient.info.vitalsAndLabs=महत्वपूर्ण संकेत है और लैब सूचना
-Patient.outcome.exitType=निकास के प्रकार
-Patient.outcome.exitFromCare=देखभाल से बाहर निकलें रोगी
-Patient.outcome.resumeCare=पुनरारंभ केयर
-Patient.outcome.resumeCareReason.required=देखभाल शुरू करने के लिए एक कारण प्रदान करें
-Patient.outcome.exitDate=तिथि बाहर निकलने के 
-Patient.outcome.error.noType=निकास के लिए इक वैध प्रकार चूने 
-Patient.outcome.error.noDate=निकास के लिए इक वैध दिनांक चूने  
-Patient.outcome.error.noCauseOfDeath=एक वैध करना दी अगर मरीज कर्र गया है तो 
-Patient.outcome.readyToSubmit=आप निम्नलिखित कारण के लिए और निम्न दिनांक पर इस रोगी के लिए रोगी की देखभाल को समाप्त करने के लिए चुना है - आप सुनिश्चित करें कि आप आगे बढ़ना चाहते हैं?
-Patient.outcome.exit.cancelReason=देखभाल शुरू करने के लिए क्या कारण है?
-Patient.groups=रोगी समूह
-Patient.addresses=रोगी पते 
-Patient.names=रोगी नाम
-Patient.actions=रोगी प्रक्रिया
-Patient.information=रोगी सूचना
-Patient.addNewIdentifier=जोड़ें नई पहचानकर्ता
-Patient.addNewName=नया नाम जोड़ें
-Patient.addNewAddress=नया पता जोड़ें
-Patient.removeThisIdentifier=इस पहचानकर्ता निकालें
-Patient.removeThisName=इस नाम निकालें
-Patient.removeThisAddress=इस पते निकालें
-Patient.name=रोगी नाम
-Patient.patientExitedCare=यह रोगी की देखभाल से बाहर निकले गया था
-Patient.patientCareExitDate=बाहर निकलें दिनांक
-Patient.patientCareExitReason=बाहर निकलें कारण
-patient.birthdate=जन्म तिथि
-patient.deathDate=मौत की तारीख
-
-error.names.length=1 या अधिक वर्ण से नामों को परिभाषित करे
-error.addresses.length=1 या अधिक वर्ण से पते परिभाषित करे
-error.identifiers.length=1 या अधिक वर्ण से पहचानकर्ता के परिभाषित
-Patient.names.required.given.family=आपका और परिवार के नाम को परिभाषित करना होगा
-Patient.search.error=रोगियों को खोजने का प्रयास करते समय त्रुटि
-
-Patient.save=सहेजें रोगी
-Patient.saved=रोगी को बचाया
-Patient.delete=हटाएँ रोगी
-Patient.deleted=रोगी नष्ट कर दिया
-Patient.cannot.delete=इस मरीज हटाया नहीं जा सकता
-Patient.voided=रोगी शून्य
-Patient.error.void.reasonEmpty=हटाएँ कारण खाली नहीं हो सकता
-Patient.unvoided=रोगी अनशून्य 
-Patient.other.identifiers=अन्य पहचानकर्ता
-Patient.other.addresses=अन्य पते
-Patient.other.names=अन्य नाम
-Patient.select=एक रोगी का चयन करें
-Patient.returned=मरीजों को वापस आ गए
-Patient.merge=मर्ज मरीजों
-Patient.merge.tabLabelPrefix=रोगी
-Patient.mergeThis=दूसरे के साथ मर्ज इस मरीज
-Patient.merge.fail=रोगी मर्ज में विफल रहा है
-Patient.merge.find=खोजें मरीजों को मर्ज
-Patient.merge.search_on=पर खोज
-Patient.merge.minimum=दो विशेषताओं का एक न्यूनतम चुनें
-Patient.merge.title=मर्ज मरीजों
-Patient.merge.select=रोगियों की एक जोड़ी का चयन करें आगे बढ़ने के लिए 
-Patient.merge.warning=रोगियों के विलय को हल्के से नहीं लिया जाना चाहिए कि कुछ है। रही हे <b>अत्यंत</b> पूर्ववत करने के लिए कठिन है और काफी संभवतः <i>असंभव</i>. <br/><br/>आप तभी आगे बढ़ें <u>सकारात्मक 100%</u> ये वही रोगियों हैं ।
-Patient.merge.preferred=पसंदीदा
-Patient.merge.notPreferred=पसंद नहीं
-Patient.merge.includeVoided=शामिल शून्य
-Patient.merged=मरीजों का सफलतापूर्वक विलयन
-Patient.id=रोगी आईडी
-Patient.voidedMessage=इस मरीज को हटा दिया गया है.
-Patient.delete.warningMessage=<b><i>आप ऐसा करना चाहते हैं आप यकीन कर रहे हैं?</i></b><br/><br/>इस सिस्टम को पूरी तरह से इस मरीज को नष्ट करने का प्रयास करेंगे । यह आमतौर पर ऐसा करने के लिए गलत बात है : यदि आप चाहते हैं &quot;delete&quot; एक मरीज को तो आप चाहिए &quot;Void&quot; ऊपर दिए गए चेक बॉक्स के साथ उन्हें ।
-Patient.delete.finalWarning=क्या आपको यकीन है की अप्प इस रोगे को शून्य करना चाहते है ?
-Patient.warning.minimalSearchResults=न्यूनतम रोगियों लौटे. परिणाम  के लिए : <b>{0}</b>
-Patient.warning.inValidIdentifier=चेतावनी: पहचानकर्ता गलत तरीके से लिखा है! पहचानकर्ता की दुबारा जाँच करें.
-Patient.message.validIdentifier=यह पहचानकर्ता सही ढंग से दर्ज किया गया है, लेकिन अभी तक कोई रोगियों को पाया गया है.
-Patient.void=शून्य रोगी
-Patient.unvoid=रोगी अन्शुनाये
-PatientForm.default.voidReason=रोगे फॉर्म से शुन्य
-
-PatientIdentifier.title.endUser=आईडी नंबर (ओं)
-PatientIdentifier.identifier=पहचानकर्ता
-PatientIdentifier.location=स्थान
-PatientIdentifier.location.identifier=पहचानकर्ता स्थान
-PatientIdentifier.location.null=पहचानकर्ता स्थान अशक्त के लिए नहीं किया जा सकता {0}
-PatientIdentifier.location.notApplicable=लागू नहीं 
-PatientIdentifier.identifierType=पहचानकर्ता प्रकार
-PatientIdentifier.identifierType.null=पहचानकर्ता प्रकार अशक्त के लिए नहीं किया जा सकता {0}
-PatientIdentifier.add=जोड़ें पहचानकर्ता
-PatientIdentifier.identifier.invalid=अमान्य पहचानकर्ता {0, स्ट्रिंग}
-PatientIdentifier.error.null=रोगी पहचानकर्ता रिक्त नहीं हो सकता
-PatientIdentifier.error.nullOrBlank=पहचानकर्ता अशक्त या रिक्त नहीं हो सकता
-PatientIdentifier.validCheckDigit=मान्य डिजिट जाँचें
-PatientIdentifier.error.formatInvalid=रोगी पहचानकर्ता प्रारूप अमान्य है
-PatientIdentifier.error.checkDigit=रोगी पहचानकर्ता अंकों अमान्य है, कृपया जाचे.
-PatientIdentifier.error.checkDigitWithParameter=अमान्य पहचानकर्ता के लिए अंकों की जांच: {0}
-PatientIdentifier.error.notUnique=रोगी पहचानकर्ता अन्य रोगी द्वारा प्रयोग में पहले से ही है
-PatientIdentifier.error.notUniqueWithParameter अन्य रोगी द्वारा प्रयोग में पहले से ही=पहचानकर्ता {0}
-PatientIdentifier.error.duplicate=मरीज ​​पहले से ही इस पहचानकर्ता है
-PatientIdentifier.error.general=रोगी पहचानकर्ता के साथ गैर विशिष्ट त्रुटि
-PatientIdentifier.error.insufficientIdentifiers=कम से कम एक रोगी पहचानकर्ता प्रत्येक रोगी के लिए आवश्यक है
-PatientIdentifier.error.invalidFormat=पहचानकर्ता [{0}] मैच नहीं करता है आवश्यक प्रारूप: {1}
-PatientIdentifier.error.unallowedIdentifier=पहचानकर्ता {0} मान्यता योजना के लिए उपयुक्त नहीं है {1}
-PatientIdentifier.type=रोगी पहचानकर्ता प्रकार
-
-PatientIdentifierType.manage=पहचानकर्ता प्रबंधन के प्रकार
- PatientIdentifierType.manage.title=रोगी पहचानकर्ता प्रकार प्रबंधन
-PatientIdentifierType.title=रोगी पहचानकर्ता प्रकार फार्म 
-PatientIdentifierType.format=Regex प्रारूप
-PatientIdentifierType.save=सहेजें पहचानकर्ता प्रकार
-PatientIdentifierType.add=रोगी पहचानकर्ता प्रकार जोड़ें  
- PatientIdentifierType.list.title=वर्तमान रोगी पहचानकर्ता प्रकार
-PatientIdentifierType.delete=चयनितकोमिटाएँ पहचानकर्ता प्रकार
-PatientIdentifierType.saved=पहचानकर्ता प्रकार को बचाया
-PatientIdentifierType.deleted=पहचानकर्ता प्रकार हटाया गया
-PatientIdentifierType.checkDigit=डिजिट की जाँच करें
-PatientIdentifierType.null=पहचानकर्ता प्रकार रिक्त नहीं हो सकता
-PatientIdentifierType.required=की आवश्यकता है
-PatientIdentifierType.formatDescription=प्रारूप का विवरण (गाइड उपयोगकर्ता की मदद के लिए)
-PatientIdentifierType.validator=पहचानकर्ता सत्यापनकर्ता
-PatientIdentifierType.locationBehavior=स्थान व्यवहार
-PatientIdentifierType.locationBehavior.NOT_USED=नहीं किया 
-PatientIdentifierType.locationBehavior.REQUIRED=आवश्यक
-PatientIdentifierType.cannot.delete=रोगी पहचानकर्ता प्रकार नष्ट नहीं कर सकते. डेटाबेस बाधाओं का उल्लंघन किया जाएगा.
-PatientIdentifierType.select=आप कम से कम एक रोगी पहचानकर्ता प्रकार का चयन करना होगा.
-PatientIdentifierType.retirePatientIdentifierType=रोगी पहचानकर्ता प्रकार रिटायर
-PatientIdentifierType.unretirePatientIdentifierType=रोगी पहचानकर्ता प्रकार Unretire
-PatientIdentifierType.retiredSuccessfully=रोगी पहचानकर्ता प्रकार सफलतापूर्वक सेवानिवृत्त
-PatientIdentifierType.unretiredSuccessfully=सफलतापूर्वक unretired करने के लिए रोगी पहचानकर्ता
-PatientIdentifierType.purgePatientIdentifierType=शुद्ध रोगी पहचानकर्ता प्रकार
-PatientIdentifierType.purgedSuccessfully=रोगी पहचानकर्ता प्रकार सफलतापूर्वक समाप्त 
-PatientIdentifierType.uniquenessBehavior=अद्वितीयता व्यवहार
-PatientIdentifierType.uniquenessBehavior.UNIQUE=अजूबा
-PatientIdentifierType.uniquenessBehavior.NON_UNIQUE=गैर अनोखा
-PatientIdentifierType.uniquenessBehavior.LOCATION=स्थान
-PatientIdentifierType.locked=रोगी पहचानकर्ता प्रकार बंद कर रहे हैं , जबकि आप एक मरीज पहचानकर्ता प्रकार संपादित करने की कोशिश की
-
-PatientSummary.manage=रोगी सारांश देखें
-
-Summary.returnVisitDate=वापसी यात्रा तिथि:
-Summary.start=प्रारंभ
-Summary.end=अंत
-Summary.andOr=और / या
-Summary.lastLocation=अंतिम स्थान
-Summary.lastLocation.encounter=रोगी पिछले मुठभेड़ स्थान
-Summary.identifier=पहचानकर्ता
-Summary.identifier.description=एक पंक्ति प्रति रोगी पहचानकर्ता
-Summary.button.submit=उत्पन्न
-
-
-Person.title=व्यक्ति
-Person.manage=व्यक्तियों का प्रबंधन
-Person.create=व्यक्ति बनाएँ
-Person.create.user=उपयोक्ता बनायें
-Person.create.patient=रोगी बनाएँ
-Person.find=एक व्यक्ति का पता लगाएं
-Person.add=एक व्यक्ति जोड़ना
-Person.add.user=एक उपयोगकर्ता को जोड़ने
-Person.add.patient=एक रोगी जोड़ना
-Person.age=आयु
-Person.header=व्यक्ति
-Person.search.instructions=एक नया व्यक्ति बनाना है, व्यक्ति का नाम और अन्य जानकारी के नीचे पहली बार प्रवेश करने के लिए डबल की जाँच करें कि वे पहले से ही इस प्रणाली में एक रिकॉर्ड नहीं है.
-Person.search.notFoundInstructions=यदि आप जिस व्यक्ति को खोज रहे है उपरोक्त सूची में नहीं दिख रहा है, तो उन्हें बना ले. (यह करने से पहले अच्छी तरह से खोज करने के लिए सुनिश्चित करें.)
-Person.search.similarPerson=इसी तरह के लोगों ने पाया
-Person.search.similarPersonInstructions=यहाँ  एक सूची है <br/> अगर व्यक्ति को आप पहले से ही मौजूद है बनाने की प्रक्रिया में हैं, उन्हें नीचे दी गई सूची में से चयन. अन्यथा नीचे दिए गए बटन क्लिक करने के लिए एक नए व्यक्ति का निर्माण जारी रखने के लिए.
-Person.search.similarPersonNotOnList=सूची पर व्यक्ति में नहीं मिल सकता है
-Person.search.placeholder=व्यक्ति का नाम या आईडी दर्ज करें
-
-Person.name=नाम
-Person.name.invalid=अवैध नाम
-Person.name.required=एक नाम का चयन करें
-Person.names=नाम
-Person.names.length=आप कम से कम एक नाम को परिभाषित करना होगा
-Person.address=पता
-Person.addresses=पते
-Person.addresses.length=व्यक्तियों को पता होना चाहिए
-Person.information=सामान्य व्यक्ति की जानकारी
-Person.gender=लिंग
-Person.gender.choose=चुनें
-Person.gender.male=पुरुष
-Person.gender.female=महिला
-Person.gender.required=कृपया कोई लिंग चुनें
+Patient.returnVisit=वापसी यात्रा 
+Patient.encounters=मुठभेड़ों
+Patient.lastEncounter=अंतिम मुठभेड़
+Patient.addNew=नए रोगी जोड़ें
+Patient.findOrCreate=खोजें / एक रोगी बनाएँ
+Patient.info.general=सामान्य जानकारी
+Patient.info.regimen=वर्तमान रहन - सहन एवं आहार सम्बन्धी नियम
+Patient.info.history.regimen=पथ्यापथ्य इतिहास
+Patient.info.weight=वजन इतिहास
+Patient.info.cd4=CD4 गणना इतिहास
+Patient.info.alerts=रोगी अलर्ट
+Patient.info.notes=नैदानिक ​​नोट्स
+Patient.info.vitalsAndLabs=महत्वपूर्ण संकेत है और लैब सूचना
+Patient.outcome.exitType=निकास के प्रकार
+Patient.outcome.exitFromCare=देखभाल से बाहर निकलें रोगी
+Patient.outcome.resumeCare=पुनरारंभ केयर
+Patient.outcome.resumeCareReason.required=देखभाल शुरू करने के लिए एक कारण प्रदान करें
+Patient.outcome.exitDate=तिथि बाहर निकलने के 
+Patient.outcome.error.noType=निकास के लिए इक वैध प्रकार चूने 
+Patient.outcome.error.noDate=निकास के लिए इक वैध दिनांक चूने  
+Patient.outcome.error.noCauseOfDeath=एक वैध करना दी अगर मरीज कर्र गया है तो 
+Patient.outcome.readyToSubmit=आप निम्नलिखित कारण के लिए और निम्न दिनांक पर इस रोगी के लिए रोगी की देखभाल को समाप्त करने के लिए चुना है - आप सुनिश्चित करें कि आप आगे बढ़ना चाहते हैं?
+Patient.outcome.exit.cancelReason=देखभाल शुरू करने के लिए क्या कारण है?
+Patient.groups=रोगी समूह
+Patient.addresses=रोगी पते 
+Patient.names=रोगी नाम
+Patient.actions=रोगी प्रक्रिया
+Patient.information=रोगी सूचना
+Patient.addNewIdentifier=जोड़ें नई पहचानकर्ता
+Patient.addNewName=नया नाम जोड़ें
+Patient.addNewAddress=नया पता जोड़ें
+Patient.removeThisIdentifier=इस पहचानकर्ता निकालें
+Patient.removeThisName=इस नाम निकालें
+Patient.removeThisAddress=इस पते निकालें
+Patient.name=रोगी नाम
+Patient.patientExitedCare=यह रोगी की देखभाल से बाहर निकले गया था
+Patient.patientCareExitDate=बाहर निकलें दिनांक
+Patient.patientCareExitReason=बाहर निकलें कारण
+patient.birthdate=जन्म तिथि
+patient.deathDate=मौत की तारीख
+
+error.names.length=1 या अधिक वर्ण से नामों को परिभाषित करे
+error.addresses.length=1 या अधिक वर्ण से पते परिभाषित करे
+error.identifiers.length=1 या अधिक वर्ण से पहचानकर्ता के परिभाषित
+Patient.names.required.given.family=आपका और परिवार के नाम को परिभाषित करना होगा
+Patient.search.error=रोगियों को खोजने का प्रयास करते समय त्रुटि
+
+Patient.save=सहेजें रोगी
+Patient.saved=रोगी को बचाया
+Patient.delete=हटाएँ रोगी
+Patient.deleted=रोगी नष्ट कर दिया
+Patient.cannot.delete=इस मरीज हटाया नहीं जा सकता
+Patient.voided=रोगी शून्य
+Patient.error.void.reasonEmpty=हटाएँ कारण खाली नहीं हो सकता
+Patient.unvoided=रोगी अनशून्य 
+Patient.other.identifiers=अन्य पहचानकर्ता
+Patient.other.addresses=अन्य पते
+Patient.other.names=अन्य नाम
+Patient.select=एक रोगी का चयन करें
+Patient.returned=मरीजों को वापस आ गए
+Patient.merge=मर्ज मरीजों
+Patient.merge.tabLabelPrefix=रोगी
+Patient.mergeThis=दूसरे के साथ मर्ज इस मरीज
+Patient.merge.fail=रोगी मर्ज में विफल रहा है
+Patient.merge.find=खोजें मरीजों को मर्ज
+Patient.merge.search_on=पर खोज
+Patient.merge.minimum=दो विशेषताओं का एक न्यूनतम चुनें
+Patient.merge.title=मर्ज मरीजों
+Patient.merge.select=रोगियों की एक जोड़ी का चयन करें आगे बढ़ने के लिए 
+Patient.merge.warning=रोगियों के विलय को हल्के से नहीं लिया जाना चाहिए कि कुछ है। रही हे <b>अत्यंत</b> पूर्ववत करने के लिए कठिन है और काफी संभवतः <i>असंभव</i>. <br/><br/>आप तभी आगे बढ़ें <u>सकारात्मक 100%</u> ये वही रोगियों हैं ।
+Patient.merge.preferred=पसंदीदा
+Patient.merge.notPreferred=पसंद नहीं
+Patient.merge.includeVoided=शामिल शून्य
+Patient.merged=मरीजों का सफलतापूर्वक विलयन
+Patient.id=रोगी आईडी
+Patient.voidedMessage=इस मरीज को हटा दिया गया है.
+Patient.delete.warningMessage=<b><i>आप ऐसा करना चाहते हैं आप यकीन कर रहे हैं?</i></b><br/><br/>इस सिस्टम को पूरी तरह से इस मरीज को नष्ट करने का प्रयास करेंगे । यह आमतौर पर ऐसा करने के लिए गलत बात है : यदि आप चाहते हैं &quot;delete&quot; एक मरीज को तो आप चाहिए &quot;Void&quot; ऊपर दिए गए चेक बॉक्स के साथ उन्हें ।
+Patient.delete.finalWarning=क्या आपको यकीन है की अप्प इस रोगे को शून्य करना चाहते है ?
+Patient.warning.minimalSearchResults=न्यूनतम रोगियों लौटे. परिणाम  के लिए : <b>{0}</b>
+Patient.warning.inValidIdentifier=चेतावनी: पहचानकर्ता गलत तरीके से लिखा है! पहचानकर्ता की दुबारा जाँच करें.
+Patient.message.validIdentifier=यह पहचानकर्ता सही ढंग से दर्ज किया गया है, लेकिन अभी तक कोई रोगियों को पाया गया है.
+Patient.void=शून्य रोगी
+Patient.unvoid=रोगी अन्शुनाये
+PatientForm.default.voidReason=रोगे फॉर्म से शुन्य
+
+PatientIdentifier.title.endUser=आईडी नंबर (ओं)
+PatientIdentifier.identifier=पहचानकर्ता
+PatientIdentifier.location=स्थान
+PatientIdentifier.location.identifier=पहचानकर्ता स्थान
+PatientIdentifier.location.null=पहचानकर्ता स्थान अशक्त के लिए नहीं किया जा सकता {0}
+PatientIdentifier.location.notApplicable=लागू नहीं 
+PatientIdentifier.identifierType=पहचानकर्ता प्रकार
+PatientIdentifier.identifierType.null=पहचानकर्ता प्रकार अशक्त के लिए नहीं किया जा सकता {0}
+PatientIdentifier.add=जोड़ें पहचानकर्ता
+PatientIdentifier.identifier.invalid=अमान्य पहचानकर्ता {0, स्ट्रिंग}
+PatientIdentifier.error.null=रोगी पहचानकर्ता रिक्त नहीं हो सकता
+PatientIdentifier.error.nullOrBlank=पहचानकर्ता अशक्त या रिक्त नहीं हो सकता
+PatientIdentifier.validCheckDigit=मान्य डिजिट जाँचें
+PatientIdentifier.error.formatInvalid=रोगी पहचानकर्ता प्रारूप अमान्य है
+PatientIdentifier.error.checkDigit=रोगी पहचानकर्ता अंकों अमान्य है, कृपया जाचे.
+PatientIdentifier.error.checkDigitWithParameter=अमान्य पहचानकर्ता के लिए अंकों की जांच: {0}
+PatientIdentifier.error.notUnique=रोगी पहचानकर्ता अन्य रोगी द्वारा प्रयोग में पहले से ही है
+PatientIdentifier.error.notUniqueWithParameter अन्य रोगी द्वारा प्रयोग में पहले से ही=पहचानकर्ता {0}
+PatientIdentifier.error.duplicate=मरीज ​​पहले से ही इस पहचानकर्ता है
+PatientIdentifier.error.general=रोगी पहचानकर्ता के साथ गैर विशिष्ट त्रुटि
+PatientIdentifier.error.insufficientIdentifiers=कम से कम एक रोगी पहचानकर्ता प्रत्येक रोगी के लिए आवश्यक है
+PatientIdentifier.error.invalidFormat=पहचानकर्ता [{0}] मैच नहीं करता है आवश्यक प्रारूप: {1}
+PatientIdentifier.error.unallowedIdentifier=पहचानकर्ता {0} मान्यता योजना के लिए उपयुक्त नहीं है {1}
+PatientIdentifier.type=रोगी पहचानकर्ता प्रकार
+
+PatientIdentifierType.manage=पहचानकर्ता प्रबंधन के प्रकार
+ PatientIdentifierType.manage.title=रोगी पहचानकर्ता प्रकार प्रबंधन
+PatientIdentifierType.title=रोगी पहचानकर्ता प्रकार फार्म 
+PatientIdentifierType.format=Regex प्रारूप
+PatientIdentifierType.save=सहेजें पहचानकर्ता प्रकार
+PatientIdentifierType.add=रोगी पहचानकर्ता प्रकार जोड़ें  
+ PatientIdentifierType.list.title=वर्तमान रोगी पहचानकर्ता प्रकार
+PatientIdentifierType.delete=चयनितकोमिटाएँ पहचानकर्ता प्रकार
+PatientIdentifierType.saved=पहचानकर्ता प्रकार को बचाया
+PatientIdentifierType.deleted=पहचानकर्ता प्रकार हटाया गया
+PatientIdentifierType.checkDigit=डिजिट की जाँच करें
+PatientIdentifierType.null=पहचानकर्ता प्रकार रिक्त नहीं हो सकता
+PatientIdentifierType.required=की आवश्यकता है
+PatientIdentifierType.formatDescription=प्रारूप का विवरण (गाइड उपयोगकर्ता की मदद के लिए)
+PatientIdentifierType.validator=पहचानकर्ता सत्यापनकर्ता
+PatientIdentifierType.locationBehavior=स्थान व्यवहार
+PatientIdentifierType.locationBehavior.NOT_USED=नहीं किया 
+PatientIdentifierType.locationBehavior.REQUIRED=आवश्यक
+PatientIdentifierType.cannot.delete=रोगी पहचानकर्ता प्रकार नष्ट नहीं कर सकते. डेटाबेस बाधाओं का उल्लंघन किया जाएगा.
+PatientIdentifierType.select=आप कम से कम एक रोगी पहचानकर्ता प्रकार का चयन करना होगा.
+PatientIdentifierType.retirePatientIdentifierType=रोगी पहचानकर्ता प्रकार रिटायर
+PatientIdentifierType.unretirePatientIdentifierType=रोगी पहचानकर्ता प्रकार Unretire
+PatientIdentifierType.retiredSuccessfully=रोगी पहचानकर्ता प्रकार सफलतापूर्वक सेवानिवृत्त
+PatientIdentifierType.unretiredSuccessfully=सफलतापूर्वक unretired करने के लिए रोगी पहचानकर्ता
+PatientIdentifierType.purgePatientIdentifierType=शुद्ध रोगी पहचानकर्ता प्रकार
+PatientIdentifierType.purgedSuccessfully=रोगी पहचानकर्ता प्रकार सफलतापूर्वक समाप्त 
+PatientIdentifierType.uniquenessBehavior=अद्वितीयता व्यवहार
+PatientIdentifierType.uniquenessBehavior.UNIQUE=अजूबा
+PatientIdentifierType.uniquenessBehavior.NON_UNIQUE=गैर अनोखा
+PatientIdentifierType.uniquenessBehavior.LOCATION=स्थान
+PatientIdentifierType.locked=रोगी पहचानकर्ता प्रकार बंद कर रहे हैं , जबकि आप एक मरीज पहचानकर्ता प्रकार संपादित करने की कोशिश की
+
+PatientSummary.manage=रोगी सारांश देखें
+
+Summary.returnVisitDate=वापसी यात्रा तिथि:
+Summary.start=प्रारंभ
+Summary.end=अंत
+Summary.andOr=और / या
+Summary.lastLocation=अंतिम स्थान
+Summary.lastLocation.encounter=रोगी पिछले मुठभेड़ स्थान
+Summary.identifier=पहचानकर्ता
+Summary.identifier.description=एक पंक्ति प्रति रोगी पहचानकर्ता
+Summary.button.submit=उत्पन्न
+
+
+Person.title=व्यक्ति
+Person.manage=व्यक्तियों का प्रबंधन
+Person.create=व्यक्ति बनाएँ
+Person.create.user=उपयोक्ता बनायें
+Person.create.patient=रोगी बनाएँ
+Person.find=एक व्यक्ति का पता लगाएं
+Person.add=एक व्यक्ति जोड़ना
+Person.add.user=एक उपयोगकर्ता को जोड़ने
+Person.add.patient=एक रोगी जोड़ना
+Person.age=आयु
+Person.header=व्यक्ति
+Person.search.instructions=एक नया व्यक्ति बनाना है, व्यक्ति का नाम और अन्य जानकारी के नीचे पहली बार प्रवेश करने के लिए डबल की जाँच करें कि वे पहले से ही इस प्रणाली में एक रिकॉर्ड नहीं है.
+Person.search.notFoundInstructions=यदि आप जिस व्यक्ति को खोज रहे है उपरोक्त सूची में नहीं दिख रहा है, तो उन्हें बना ले. (यह करने से पहले अच्छी तरह से खोज करने के लिए सुनिश्चित करें.)
+Person.search.similarPerson=इसी तरह के लोगों ने पाया
+Person.search.similarPersonInstructions=यहाँ  एक सूची है <br/> अगर व्यक्ति को आप पहले से ही मौजूद है बनाने की प्रक्रिया में हैं, उन्हें नीचे दी गई सूची में से चयन. अन्यथा नीचे दिए गए बटन क्लिक करने के लिए एक नए व्यक्ति का निर्माण जारी रखने के लिए.
+Person.search.similarPersonNotOnList=सूची पर व्यक्ति में नहीं मिल सकता है
+Person.search.placeholder=व्यक्ति का नाम या आईडी दर्ज करें
+
+Person.name=नाम
+Person.name.invalid=अवैध नाम
+Person.name.required=एक नाम का चयन करें
+Person.names=नाम
+Person.names.length=आप कम से कम एक नाम को परिभाषित करना होगा
+Person.address=पता
+Person.addresses=पते
+Person.addresses.length=व्यक्तियों को पता होना चाहिए
+Person.information=सामान्य व्यक्ति की जानकारी
+Person.gender=लिंग
+Person.gender.choose=चुनें
+Person.gender.male=पुरुष
+Person.gender.female=महिला
+Person.gender.required=कृपया कोई लिंग चुनें
 Person.age.years=yrs
 Person.age.year=yr
-Person.age.unknown=आयु अज्ञात
-Person.age.yearsOld={0} (ओं) साल पुराने
-Person.age.or=या उम्र
-Person.age.required=आयु की आवश्यकता है
-Person.age.error=उम्र में त्रुटि
-
-Person.birthdate.required=एक वैध जन्मतिथि या उम्र का चयन करें
-Person.birthdate=जन्मतिथि
-Person.birthdateEstimated=अनुमानित
-Person.dead=मृतक
-Person.dead.checkboxInstructions=जाँच करें कि अगर यह व्यक्ति मृत है
-Person.dead.causeOfDeathNull=मौत का कारण मृतक लोगो के लिए खाले नहीं हो सकता
-Person.deathDate=मौत की तिथि
-Person.causeOfDeath=मौत का कारण
-Person.searchBox=व्यक्ति नाम
-Person.addNew=नए व्यक्ति जोड़ें
-Person.addNew.msg=यदि कोई परिणाम नहीं पाए जाते हैं, एक नए व्यक्ति को जोड़ने.
-Person.allObservations=सभी टिप्पणियों
-Person.allObservationsForConcept={0} के लिए सभी टिप्पणियों
-Person.findBy=नाम या पहचानकर्ता द्वारा एक व्यक्ति का पता लगाएं:
-Person.search.error=जब लोगों को खोजने का प्रयास किया गया तब त्रुटि आये
-
-Person.addNewName=नया नाम जोड़ें
-Person.addNewAddress=नया पता जोड़ें
-Person.removeThisName=इस नाम निकालें
-Person.removeThisAddress=इस पते निकालें
-Person.save=सहेजें व्यक्ति
-Person.saved=व्यक्ति को बचाया
-Person.delete=हमेशा के लिए व्यक्ति को हटाना
-Person.delete.warningMessage=<b><i>आप ऐसा करना चाहते हैं आप यकीन कर रहे हैं?</i></b><br/><br/>इस सिस्टम को पूरी तरह से इस व्यक्ति को नष्ट करने का प्रयास करेंगे । यह आमतौर पर ऐसा करने के लिए गलत बात है : यदि आप चाहते हैं &quot;delete&quot; एक व्यक्ति तो आप चाहिए &quot;Delete&quot; नीचे दिए गए बटन के साथ उन्हें.
-Person.delete.finalWarning=आप इस पूरे व्यक्ति शुद्ध करने के लिए चाहते हैं आप यकीन कर रहे हैं?
-Person.deleted=व्यक्ति को हमेशा के लिए नष्ट कर दिया
-Person.cannot.delete=इस व्यक्ति को पर्ज नहीं किया जा सकता
-Person.cannot.delete.linkedTo.users=उपयोगकर्ता से जुड़ा हुआ है क्योंकि इस व्यक्ति को हमेशा के लिए नष्ट नहीं किया जा सकता है:
-Person.cannot.delete.linkedTo.providers=प्रदाता से जुड़ा हुआ है क्योंकि इस व्यक्ति को हमेशा के लिए नष्ट नहीं किया जा सकता है:
-Person.cannot.void.linkedTo.providers=प्रदाता से जुड़ा हुआ है क्योंकि इस व्यक्ति को नष्ट नहीं किया जा सकता है:
-Person.voided=व्यक्ति हटाए गए
-Person.voidedMessage=इस व्यक्ति को हटा दिया गया है ।
-Person.unvoided=व्यक्ति बहाल
-Person.void=व्यक्ति को हटाना
-Person.unvoid=व्यक्ति पुनर्स्थापित
-Person.shouldHaveAtleastOneNonVoidedName=व्यक्ति कम से कम एक गैर हटाए गए नाम होना चाहिए
-Person.notFoundCreate=नहीं मिला: एक नए व्यक्ति को रिकॉर्ड बनाने
-PersonForm.default.voidReason=व्यक्ति फार्म से हटाए गए
-
-Patient.save.error=जब रोगी की जानकारी सहजने की कोशिश की तब त्रुटी आइये.
-Patient.duplicateName={0} एक रोगी के लिए एक डुप्लिकेट नाम है
-Patient.duplicateAddress={0} एक ही रोगी के लिए एक डुप्लिकेट पता है
-
-PersonName.givenName=पहला नाम
-PersonName.middleName=मध्य
-PersonName.firstName=प्रथम नाम
-PersonName.secondName=दूसरा नाम
-PersonName.familyNamePrefix=परिवार का नाम उपसर्ग
-PersonName.familyName=परिवार का नाम
-PersonName.familyName1=परिवार 1 नाम
-PersonName.familyName2=परिवार 2 नाम
-PersonName.familyNameSuffix परिवार=नाम प्रत्यय
-PersonName.degree=डिग्री
-PersonName.prefix=उपसर्ग
-
-PersonAddress.address1=पता
-PersonAddress.address2=पता 2
-PersonAddress.cityVillage=सिटी / ग्राम
-PersonAddress.stateProvince=राज्य / प्रांत
-PersonAddress.country=देश
-PersonAddress.postalCode=पोस्टल कोड
-PersonAddress.latitude=अक्षांश
-PersonAddress.longitude=देशांतर
-PersonAddress.city=शहर
-PersonAddress.village=ग्राम
-PersonAddress.state=राज्य
-PersonAddress.province=प्रांत
-PersonAddress.isActive=सक्रिय
-PersonAddress.startDate=प्रारंभ दिनांक
-PersonAddress.endDate=समाप्ति तिथि
-PersonAddress.error.endDateBeforeStartDate=पता {0} के लिए 'अंत' तारीख 'शुरुआत' तारीख से पहले नहीं होना चाहिए
-PersonAddress.error.startDateInFuture=पता {0} के लिए 'शुरुआत तिथि भविष्य में है
-PersonAddress.error.endDateInFuture=पता {0} के लिए  'अंतिम तिथि नहीं' भविष्य में है
-
-PersonAttributeType.manage=व्यक्ति प्रबंधन एट्रीब्यूट
-PersonAttributeType.manage.title=व्यक्ति ऐट्रिब्यूट मैनेजमैंट
-PersonAttributeType.save=व्यक्ति गुण प्रकार सहेजें
-PersonAttributeType.saved=व्यक्ति के गुण प्रकार को बचाया
-PersonAttributeType.delete=हटाएँ व्यक्ति ऐट्रिब्यूट
-PersonAttributeType.searchable=खोजा
-PersonAttributeType.searchable.help=क्या इस प्रकार पर खोजा जा सकता है या नहीं
-PersonAttributeType.format=प्रारूप
-PersonAttributeType.format.help=नाम जावा क्लास का
-PersonAttributeType.foreignKey=विदेशी कुंजी
-PersonAttributeType.foreignKey.help='प्रारूप' द्वारा निर्दिष्ट ऑब्जेक्ट के पूर्णांक आईडी
-PersonAttributeType.add=नए व्यक्ति के गुण प्रकार जोड़ें
-PersonAttributeType.list.title=एट्रीब्यूट
-PersonAttributeType.title=व्यक्ति गुण प्रकार
-PersonAttributeType.viewingListing.title=लिस्टिंग और व्यक्ति एट्रीब्यूट के देखने
-PersonAttributeType.viewingListing.saved=लिस्टिंग और देखने के व्यक्ति का श्रेय बचाया
-PersonAttributeType.viewingListing.help=कॉमा व्यक्ति विशेषता नाम अलग
-PersonAttributeType.patient.listing=रोगी लिस्टिंग गुण 
-PersonAttributeType.patient.listing.help=गुणधर्मों को दिखाया गया जब रोगियों को एक सूची में प्रदर्शित कर रहे हैं
-PersonAttributeType.patient.viewing=रोगी देखने गुण 
-PersonAttributeType.patient.viewing.help=गुणधर्मों को दिखाया गया है जब एक रोगी के मेटाडाटा को देखने
-PersonAttributeType.patient.header=रोगी हैडर गुण
-PersonAttributeType.patient.header.help=गुण रोगी डैशबोर्ड के शीर्षक में दिखाया
-PersonAttributeType.user.listing=उपयोगकर्ता लिस्टिंग गुण
-PersonAttributeType.user.listing.help=गुणधर्मों को दिखाया गया जब उपयोगकर्ताओं को एक सूची में प्रदर्शित कर रहे हैं
-PersonAttributeType.user.viewing=उपयोगकर्ता को देखने के गुण
-PersonAttributeType.user.viewing.help=गुणधर्मों को दिखाया गया है जब एक उपयोगकर्ता के मेटाडाटा को देखने
-PersonAttributeType.editPrivilege=संपादित करें विशेषाधिकार
-PersonAttributeType.editPrivilege.help=एक उपयोगकर्ता द्वारा आवश्यक विशेषाधिकार इस व्यक्ति की विशेषता को संपादित करने के लिए
-PersonAttributeType.select=आप कम से कम एक व्यक्ति के गुण प्रकार का चयन करना होगा.
-PersonAttributeType.error.nameEmpty=एक अरिक्त अद्वितीय नाम दर्ज करें.
-PersonAttributeType.error.formatEmpty=एक गैर खाली प्रारूप का चयन करें
-PersonAttributeType.error.nameAlreadyInUse=आपके द्वारा दर्ज किया गया नाम पहले से प्रयोग में है, कृपया एक अद्वितीय नाम दर्ज करें.
-PersonAttributeType.moveup=ऊपर ले जाएँ
-PersonAttributeType.movedown=नीचे ले जाएँ
-PersonAttributeType.retirePersonAttributeType=व्यक्ति गुण प्रकार रिटायर
-PersonAttributeType.retiredSuccessfully=व्यक्ति गुण प्रकार सफलतापूर्वक सेवानिवृत्त
-PersonAttributeType.purgePersonAttributeType=शुद्ध व्यक्ति गुण प्रकार
-PersonAttributeType.purgedSuccessfully=व्यक्ति गुण प्रकार सफलतापूर्वक खाली
-PersonAttributeType.unretiredSuccessfully=व्यक्ति ऐट्रिब्यूट सफलतापूर्वक अन्सेवानिर्वित्र
-PersonAttributeType.UnretirePersonAttributeType=अन्सेवानिर्वित्र व्यक्ति गुण प्रकार
-PersonAttributeType.UnretirePersonAtrributeMessage=क्या आप यकीन है कि आप इस वस्तु अन्सेवानिर्वित्र चाहते हैं? यह तो प्रणाली को बहाल किया जाएगा
-PersonAttributeType.java.util.Date.warning=डेटा के कारण होता है जो आप java.util.Date चुनने के लिए अनुमति दी OpenMRS , के पुराने संस्करणों में एक बग उपयोगकर्ता की तारीख प्रारूप में संग्रहीत किया जाना है। इसका मतलब है कि किसी को डीडी / माह / वर्ष में एक तारीख दर्ज की गई है और आप इसे देखने के लिए या तो चीजें टूट जाएगा dd / mm / YYYY प्रारूप में इसे संपादित करने का प्रयास है। आप तो यह संदेश देख रहे हैं, तो आप एक व्यक्ति जिसका प्रारूप java.util.Date को तैयार है। अपने डेटाबेस में प्रकार की विशेषता है <br/> <br/> आप इस मैन्युअल के लिए person_attribute तालिका में संग्रहीत सभी डेटा को बदलने की जरूरत YYYY -MM-DD प्रारूप करने के लिए टाइप करें, और उसके बाद एक AttributableDate होने के लिए प्रकार की विशेषता इस व्यक्ति का स्वरूप बदल जाते हैं।
-PersonAttributeType.locked=व्यक्ति प्रकार बंद कर रहे हैं विशेषता है, जबकि आप एक व्यक्ति विशेषता प्रकार संपादित करने की कोशिश की
-
-PersonAttributeType.Mother'sName=माता का नाम
-PersonAttributeType.HealthCenter=स्वास्थ्य केंद्र
-PersonAttributeType.Birthplace=जन्मस्थान
-PersonAttributeType.Citizenship=नागरिकता
-PersonAttributeType.CivilStatus=सिविल स्थिति
-PersonAttributeType.HealthDistrict=स्वास्थ्य जिला 
-PersonAttributeType.Race=रेस
-
-Privilege.manage=प्रबंधन विशेषाधिकार
-Privilege.manage.titlebar=विशेषाधिकार प्रबंधन - OpenMRS
-Privilege.manage.title=विशेषाधिकार प्रबंधन
-Privilege.title=विशेषाधिकार प्रपत्र
-Privilege.manage.header=विशेषाधिकार प्रबंधन
-Privilege.privilege=विशेषाधिकार नाम
-error.privilege=विशेषाधिकार खाली नहीं हो सकता
-Privilege.save=विशेषाधिकार सहेजें
-Privilege.add=जोड़ें विशेषाधिकार
-Privilege.list.title=वर्तमान विशेषाधिकार
-Privilege.delete=चयनित विशेषाधिकार हटाएँ
-Privilege.saved=विशेषाधिकार बचाया
-Privilege.deleted=विशेषाधिकार नष्ट कर दिया
-Privilege.cannot.delete=विशेषाधिकार नहीं मिटा सकता. डेटाबेस बाधाओं का उल्लंघन होगा.
-Privilege.select=आप पहले विशेषाधिकार का चयन करना होगा.
-
-CohortBuilder.header=पलटन बिल्डर
-
-Relationship.portlet.title=रिश्ते
-Relationship.manage=प्रबंधित रिश्ते
-Relationship.manage.title=संबंध प्रबंधन
-Relationship.title=रिश्ता प्रपत्र
-Relationship.add=एक नया संबंध जोड़ें
-Relationship.save=रिश्ते को बचाने के
-Relationship.saved=रिश्ता बचाया
-Relationship.list.title=वर्तमान रिश्ते
-Relationship.void=चयनित रिश्ते शून्य करे
-Relationship.unvoid=चयनित रिश्ते शून्य
-Relationship.delete=चयनितकोमिटाएँ रिश्ते
-Relationship.deleted=रिश्ता नष्ट कर दिया
-Relationship.missing=रिश्ता याद आ रही है
-Relationship.select=एक रिश्ते का चयन करें
-Relationship.patient=रोगी
-Relationship.user=पयोगकर्ता
-Relationship.relationship=रिश्ता
-Relationship.relationships=रिश्ते
-Relationship.relationshipType=रिश्ते के प्रकार
-Relationship.relative=सापेक्ष 
-Relationship.remove=हटाएँ रिश्ता
-Relationship.person=व्यक्ति
-Relationship.possessive='ओ
-Relationship.patient.providers=प्रदाता
-Relationship.instructions.select.accompagnateur=नीचे एक अक्कोम्पग्नतेउर का नाम टाइप करें:
-Relationship.instructions.select=एक {0} के नाम के नीचे प्रकार:
-Relationship.error.everything=आप एक व्यक्ति और एक संबंध प्रकार निर्दिष्ट चाहिए
-Relationship.error.same=आप एक व्यक्ति और उसके बीच एक संबंध नहीं बना सकते
-Relationship.whatType=रिश्ते की किस प्रकार?
-Relationship.target=है:
-Relationship.startDateQuestion=जब रिश्ता (वैकल्पिक) शुरू किया था?
-Relationship.startDateLong=रिश्ता प्रारंभ दिनांक
-Relationship.endDateLong=रिश्ता समाप्ति तिथि
-Relationship.startDate=प्रारंभ दिनांक
-Relationship.endDate=समाप्ति तिथि
-Relationship.edit=संपादित करें रिश्ता
-Relationship.InvalidDate.error=अंतिम तिथि प्रारंभ तिथि से पहले नहीं होना चाहिए
-Relationship.emptyReason=कारण खाली नहीं हो सकता
-
-RelationshipType.names=नाम
-RelationshipType.manage=रिश्ता प्रबंधन के प्रकार
-RelationshipType.manage.title=रिश्ते के प्रकार मैनेजमैंट
-RelationshipType.title=रिश्ते के प्रकार फार्म
-RelationshipType.save=रिश्ते के प्रकार सहेजें
-RelationshipType.add=जोड़ें रिश्ते के प्रकार
-RelationshipType.list.title=वर्तमान वैवाहिक प्रकार
-RelationshipType.delete=चयनितकोमिटाएँ रिश्ता प्रकार
-RelationshipType.retireRelationshipType=संबंध प्रकार रिटायर
-RelationshipType.saved रिश्ता=बचाया प्रकार
-RelationshipType.deleted रिश्ता=नष्ट कर दिया प्रकार
-RelationshipType.null=रिश्ता प्रकार रिक्त नहीं हो सकता
-RelationshipType.aIsToB=अ से बी
-RelationshipType.bIsToA=बी से ए
-RelationshipType.aIsToB.required=बी नाम की आवश्यकता होती है करने के लिए एक हैd
-RelationshipType.bIsToA.required=बी एक नाम आवश्यक है
-RelationshipType.views.title=रिश्ते के प्रकार दृश्य प्रबंधन
-RelationshipType.views.order=प्रदर्शन आदेश
-RelationshipType.views.order.help=जब प्रकार के लिस्टिंग, इस मूल्य सॉर्टिंग क्रम के रूप में प्रयोग किया जाता है
-RelationshipType.views.preferred=पसंदीदा
-RelationshipType.views.preferred.help=पसंदीदा प्रकार है कि लोगों को डिफ़ॉल्ट रूप से दिखाया जाएगा जब एक उपयोगकर्ता एक व्यक्ति के संबंधों में भरने
-RelationshipType.views.saved=दृश्य रिश्ता प्रकार के लिए बचाया
-RelationshipType.cannot.delete=रिश्ते के प्रकार को नष्ट नहीं कर सकते. डेटाबेस बाधाओं का उल्लंघन किया जाएगा.
-RelationshipType.select=आप कम से कम एक संबंध प्रकार का चयन करना होगा.
-RelationshipType.retiredSuccessfully=रिश्ते के प्रकार सफलतापूर्वक सेवानिवृत्त
-RelationshipType.purgedSuccessfully=रिश्ते के प्रकार सफलतापूर्वक खाली
-RelationshipType.purgeRelationshipType=शुद्ध रिश्ते के प्रकार
-Relationship.InvalidEndDate.error=मान्य समाप्ति तिथि चुनें जो प्रारंभ तिथि के बाद
+Person.age.unknown=आयु अज्ञात
+Person.age.yearsOld={0} (ओं) साल पुराने
+Person.age.or=या उम्र
+Person.age.required=आयु की आवश्यकता है
+Person.age.error=उम्र में त्रुटि
+
+Person.birthdate.required=एक वैध जन्मतिथि या उम्र का चयन करें
+Person.birthdate=जन्मतिथि
+Person.birthdateEstimated=अनुमानित
+Person.dead=मृतक
+Person.dead.checkboxInstructions=जाँच करें कि अगर यह व्यक्ति मृत है
+Person.dead.causeOfDeathNull=मौत का कारण मृतक लोगो के लिए खाले नहीं हो सकता
+Person.deathDate=मौत की तिथि
+Person.causeOfDeath=मौत का कारण
+Person.searchBox=व्यक्ति नाम
+Person.addNew=नए व्यक्ति जोड़ें
+Person.addNew.msg=यदि कोई परिणाम नहीं पाए जाते हैं, एक नए व्यक्ति को जोड़ने.
+Person.allObservations=सभी टिप्पणियों
+Person.allObservationsForConcept={0} के लिए सभी टिप्पणियों
+Person.findBy=नाम या पहचानकर्ता द्वारा एक व्यक्ति का पता लगाएं:
+Person.search.error=जब लोगों को खोजने का प्रयास किया गया तब त्रुटि आये
+
+Person.addNewName=नया नाम जोड़ें
+Person.addNewAddress=नया पता जोड़ें
+Person.removeThisName=इस नाम निकालें
+Person.removeThisAddress=इस पते निकालें
+Person.save=सहेजें व्यक्ति
+Person.saved=व्यक्ति को बचाया
+Person.delete=हमेशा के लिए व्यक्ति को हटाना
+Person.delete.warningMessage=<b><i>आप ऐसा करना चाहते हैं आप यकीन कर रहे हैं?</i></b><br/><br/>इस सिस्टम को पूरी तरह से इस व्यक्ति को नष्ट करने का प्रयास करेंगे । यह आमतौर पर ऐसा करने के लिए गलत बात है : यदि आप चाहते हैं &quot;delete&quot; एक व्यक्ति तो आप चाहिए &quot;Delete&quot; नीचे दिए गए बटन के साथ उन्हें.
+Person.delete.finalWarning=आप इस पूरे व्यक्ति शुद्ध करने के लिए चाहते हैं आप यकीन कर रहे हैं?
+Person.deleted=व्यक्ति को हमेशा के लिए नष्ट कर दिया
+Person.cannot.delete=इस व्यक्ति को पर्ज नहीं किया जा सकता
+Person.cannot.delete.linkedTo.users=उपयोगकर्ता से जुड़ा हुआ है क्योंकि इस व्यक्ति को हमेशा के लिए नष्ट नहीं किया जा सकता है:
+Person.cannot.delete.linkedTo.providers=प्रदाता से जुड़ा हुआ है क्योंकि इस व्यक्ति को हमेशा के लिए नष्ट नहीं किया जा सकता है:
+Person.cannot.void.linkedTo.providers=प्रदाता से जुड़ा हुआ है क्योंकि इस व्यक्ति को नष्ट नहीं किया जा सकता है:
+Person.voided=व्यक्ति हटाए गए
+Person.voidedMessage=इस व्यक्ति को हटा दिया गया है ।
+Person.unvoided=व्यक्ति बहाल
+Person.void=व्यक्ति को हटाना
+Person.unvoid=व्यक्ति पुनर्स्थापित
+Person.shouldHaveAtleastOneNonVoidedName=व्यक्ति कम से कम एक गैर हटाए गए नाम होना चाहिए
+Person.notFoundCreate=नहीं मिला: एक नए व्यक्ति को रिकॉर्ड बनाने
+PersonForm.default.voidReason=व्यक्ति फार्म से हटाए गए
+
+Patient.save.error=जब रोगी की जानकारी सहजने की कोशिश की तब त्रुटी आइये.
+Patient.duplicateName={0} एक रोगी के लिए एक डुप्लिकेट नाम है
+Patient.duplicateAddress={0} एक ही रोगी के लिए एक डुप्लिकेट पता है
+
+PersonName.givenName=पहला नाम
+PersonName.middleName=मध्य
+PersonName.firstName=प्रथम नाम
+PersonName.secondName=दूसरा नाम
+PersonName.familyNamePrefix=परिवार का नाम उपसर्ग
+PersonName.familyName=परिवार का नाम
+PersonName.familyName1=परिवार 1 नाम
+PersonName.familyName2=परिवार 2 नाम
+PersonName.familyNameSuffix परिवार=नाम प्रत्यय
+PersonName.degree=डिग्री
+PersonName.prefix=उपसर्ग
+
+PersonAddress.address1=पता
+PersonAddress.address2=पता 2
+PersonAddress.cityVillage=सिटी / ग्राम
+PersonAddress.stateProvince=राज्य / प्रांत
+PersonAddress.country=देश
+PersonAddress.postalCode=पोस्टल कोड
+PersonAddress.latitude=अक्षांश
+PersonAddress.longitude=देशांतर
+PersonAddress.city=शहर
+PersonAddress.village=ग्राम
+PersonAddress.state=राज्य
+PersonAddress.province=प्रांत
+PersonAddress.isActive=सक्रिय
+PersonAddress.startDate=प्रारंभ दिनांक
+PersonAddress.endDate=समाप्ति तिथि
+PersonAddress.error.endDateBeforeStartDate=पता {0} के लिए 'अंत' तारीख 'शुरुआत' तारीख से पहले नहीं होना चाहिए
+PersonAddress.error.startDateInFuture=पता {0} के लिए 'शुरुआत तिथि भविष्य में है
+PersonAddress.error.endDateInFuture=पता {0} के लिए  'अंतिम तिथि नहीं' भविष्य में है
+
+PersonAttributeType.manage=व्यक्ति प्रबंधन एट्रीब्यूट
+PersonAttributeType.manage.title=व्यक्ति ऐट्रिब्यूट मैनेजमैंट
+PersonAttributeType.save=व्यक्ति गुण प्रकार सहेजें
+PersonAttributeType.saved=व्यक्ति के गुण प्रकार को बचाया
+PersonAttributeType.delete=हटाएँ व्यक्ति ऐट्रिब्यूट
+PersonAttributeType.searchable=खोजा
+PersonAttributeType.searchable.help=क्या इस प्रकार पर खोजा जा सकता है या नहीं
+PersonAttributeType.format=प्रारूप
+PersonAttributeType.format.help=नाम जावा क्लास का
+PersonAttributeType.foreignKey=विदेशी कुंजी
+PersonAttributeType.foreignKey.help='प्रारूप' द्वारा निर्दिष्ट ऑब्जेक्ट के पूर्णांक आईडी
+PersonAttributeType.add=नए व्यक्ति के गुण प्रकार जोड़ें
+PersonAttributeType.list.title=एट्रीब्यूट
+PersonAttributeType.title=व्यक्ति गुण प्रकार
+PersonAttributeType.viewingListing.title=लिस्टिंग और व्यक्ति एट्रीब्यूट के देखने
+PersonAttributeType.viewingListing.saved=लिस्टिंग और देखने के व्यक्ति का श्रेय बचाया
+PersonAttributeType.viewingListing.help=कॉमा व्यक्ति विशेषता नाम अलग
+PersonAttributeType.patient.listing=रोगी लिस्टिंग गुण 
+PersonAttributeType.patient.listing.help=गुणधर्मों को दिखाया गया जब रोगियों को एक सूची में प्रदर्शित कर रहे हैं
+PersonAttributeType.patient.viewing=रोगी देखने गुण 
+PersonAttributeType.patient.viewing.help=गुणधर्मों को दिखाया गया है जब एक रोगी के मेटाडाटा को देखने
+PersonAttributeType.patient.header=रोगी हैडर गुण
+PersonAttributeType.patient.header.help=गुण रोगी डैशबोर्ड के शीर्षक में दिखाया
+PersonAttributeType.user.listing=उपयोगकर्ता लिस्टिंग गुण
+PersonAttributeType.user.listing.help=गुणधर्मों को दिखाया गया जब उपयोगकर्ताओं को एक सूची में प्रदर्शित कर रहे हैं
+PersonAttributeType.user.viewing=उपयोगकर्ता को देखने के गुण
+PersonAttributeType.user.viewing.help=गुणधर्मों को दिखाया गया है जब एक उपयोगकर्ता के मेटाडाटा को देखने
+PersonAttributeType.editPrivilege=संपादित करें विशेषाधिकार
+PersonAttributeType.editPrivilege.help=एक उपयोगकर्ता द्वारा आवश्यक विशेषाधिकार इस व्यक्ति की विशेषता को संपादित करने के लिए
+PersonAttributeType.select=आप कम से कम एक व्यक्ति के गुण प्रकार का चयन करना होगा.
+PersonAttributeType.error.nameEmpty=एक अरिक्त अद्वितीय नाम दर्ज करें.
+PersonAttributeType.error.formatEmpty=एक गैर खाली प्रारूप का चयन करें
+PersonAttributeType.error.nameAlreadyInUse=आपके द्वारा दर्ज किया गया नाम पहले से प्रयोग में है, कृपया एक अद्वितीय नाम दर्ज करें.
+PersonAttributeType.moveup=ऊपर ले जाएँ
+PersonAttributeType.movedown=नीचे ले जाएँ
+PersonAttributeType.retirePersonAttributeType=व्यक्ति गुण प्रकार रिटायर
+PersonAttributeType.retiredSuccessfully=व्यक्ति गुण प्रकार सफलतापूर्वक सेवानिवृत्त
+PersonAttributeType.purgePersonAttributeType=शुद्ध व्यक्ति गुण प्रकार
+PersonAttributeType.purgedSuccessfully=व्यक्ति गुण प्रकार सफलतापूर्वक खाली
+PersonAttributeType.unretiredSuccessfully=व्यक्ति ऐट्रिब्यूट सफलतापूर्वक अन्सेवानिर्वित्र
+PersonAttributeType.UnretirePersonAttributeType=अन्सेवानिर्वित्र व्यक्ति गुण प्रकार
+PersonAttributeType.UnretirePersonAtrributeMessage=क्या आप यकीन है कि आप इस वस्तु अन्सेवानिर्वित्र चाहते हैं? यह तो प्रणाली को बहाल किया जाएगा
+PersonAttributeType.java.util.Date.warning=डेटा के कारण होता है जो आप java.util.Date चुनने के लिए अनुमति दी OpenMRS , के पुराने संस्करणों में एक बग उपयोगकर्ता की तारीख प्रारूप में संग्रहीत किया जाना है। इसका मतलब है कि किसी को डीडी / माह / वर्ष में एक तारीख दर्ज की गई है और आप इसे देखने के लिए या तो चीजें टूट जाएगा dd / mm / YYYY प्रारूप में इसे संपादित करने का प्रयास है। आप तो यह संदेश देख रहे हैं, तो आप एक व्यक्ति जिसका प्रारूप java.util.Date को तैयार है। अपने डेटाबेस में प्रकार की विशेषता है <br/> <br/> आप इस मैन्युअल के लिए person_attribute तालिका में संग्रहीत सभी डेटा को बदलने की जरूरत YYYY -MM-DD प्रारूप करने के लिए टाइप करें, और उसके बाद एक AttributableDate होने के लिए प्रकार की विशेषता इस व्यक्ति का स्वरूप बदल जाते हैं।
+PersonAttributeType.locked=व्यक्ति प्रकार बंद कर रहे हैं विशेषता है, जबकि आप एक व्यक्ति विशेषता प्रकार संपादित करने की कोशिश की
+
+PersonAttributeType.Mother'sName=माता का नाम
+PersonAttributeType.HealthCenter=स्वास्थ्य केंद्र
+PersonAttributeType.Birthplace=जन्मस्थान
+PersonAttributeType.Citizenship=नागरिकता
+PersonAttributeType.CivilStatus=सिविल स्थिति
+PersonAttributeType.HealthDistrict=स्वास्थ्य जिला 
+PersonAttributeType.Race=रेस
+
+Privilege.manage=प्रबंधन विशेषाधिकार
+Privilege.manage.titlebar=विशेषाधिकार प्रबंधन - OpenMRS
+Privilege.manage.title=विशेषाधिकार प्रबंधन
+Privilege.title=विशेषाधिकार प्रपत्र
+Privilege.manage.header=विशेषाधिकार प्रबंधन
+Privilege.privilege=विशेषाधिकार नाम
+error.privilege=विशेषाधिकार खाली नहीं हो सकता
+Privilege.save=विशेषाधिकार सहेजें
+Privilege.add=जोड़ें विशेषाधिकार
+Privilege.list.title=वर्तमान विशेषाधिकार
+Privilege.delete=चयनित विशेषाधिकार हटाएँ
+Privilege.saved=विशेषाधिकार बचाया
+Privilege.deleted=विशेषाधिकार नष्ट कर दिया
+Privilege.cannot.delete=विशेषाधिकार नहीं मिटा सकता. डेटाबेस बाधाओं का उल्लंघन होगा.
+Privilege.select=आप पहले विशेषाधिकार का चयन करना होगा.
+
+CohortBuilder.header=पलटन बिल्डर
+
+Relationship.portlet.title=रिश्ते
+Relationship.manage=प्रबंधित रिश्ते
+Relationship.manage.title=संबंध प्रबंधन
+Relationship.title=रिश्ता प्रपत्र
+Relationship.add=एक नया संबंध जोड़ें
+Relationship.save=रिश्ते को बचाने के
+Relationship.saved=रिश्ता बचाया
+Relationship.list.title=वर्तमान रिश्ते
+Relationship.void=चयनित रिश्ते शून्य करे
+Relationship.unvoid=चयनित रिश्ते शून्य
+Relationship.delete=चयनितकोमिटाएँ रिश्ते
+Relationship.deleted=रिश्ता नष्ट कर दिया
+Relationship.missing=रिश्ता याद आ रही है
+Relationship.select=एक रिश्ते का चयन करें
+Relationship.patient=रोगी
+Relationship.user=पयोगकर्ता
+Relationship.relationship=रिश्ता
+Relationship.relationships=रिश्ते
+Relationship.relationshipType=रिश्ते के प्रकार
+Relationship.relative=सापेक्ष 
+Relationship.remove=हटाएँ रिश्ता
+Relationship.person=व्यक्ति
+Relationship.possessive='ओ
+Relationship.patient.providers=प्रदाता
+Relationship.instructions.select.accompagnateur=नीचे एक अक्कोम्पग्नतेउर का नाम टाइप करें:
+Relationship.instructions.select=एक {0} के नाम के नीचे प्रकार:
+Relationship.error.everything=आप एक व्यक्ति और एक संबंध प्रकार निर्दिष्ट चाहिए
+Relationship.error.same=आप एक व्यक्ति और उसके बीच एक संबंध नहीं बना सकते
+Relationship.whatType=रिश्ते की किस प्रकार?
+Relationship.target=है:
+Relationship.startDateQuestion=जब रिश्ता (वैकल्पिक) शुरू किया था?
+Relationship.startDateLong=रिश्ता प्रारंभ दिनांक
+Relationship.endDateLong=रिश्ता समाप्ति तिथि
+Relationship.startDate=प्रारंभ दिनांक
+Relationship.endDate=समाप्ति तिथि
+Relationship.edit=संपादित करें रिश्ता
+Relationship.InvalidDate.error=अंतिम तिथि प्रारंभ तिथि से पहले नहीं होना चाहिए
+Relationship.emptyReason=कारण खाली नहीं हो सकता
+
+RelationshipType.names=नाम
+RelationshipType.manage=रिश्ता प्रबंधन के प्रकार
+RelationshipType.manage.title=रिश्ते के प्रकार मैनेजमैंट
+RelationshipType.title=रिश्ते के प्रकार फार्म
+RelationshipType.save=रिश्ते के प्रकार सहेजें
+RelationshipType.add=जोड़ें रिश्ते के प्रकार
+RelationshipType.list.title=वर्तमान वैवाहिक प्रकार
+RelationshipType.delete=चयनितकोमिटाएँ रिश्ता प्रकार
+RelationshipType.retireRelationshipType=संबंध प्रकार रिटायर
+RelationshipType.saved रिश्ता=बचाया प्रकार
+RelationshipType.deleted रिश्ता=नष्ट कर दिया प्रकार
+RelationshipType.null=रिश्ता प्रकार रिक्त नहीं हो सकता
+RelationshipType.aIsToB=अ से बी
+RelationshipType.bIsToA=बी से ए
+RelationshipType.aIsToB.required=बी नाम की आवश्यकता होती है करने के लिए एक हैd
+RelationshipType.bIsToA.required=बी एक नाम आवश्यक है
+RelationshipType.views.title=रिश्ते के प्रकार दृश्य प्रबंधन
+RelationshipType.views.order=प्रदर्शन आदेश
+RelationshipType.views.order.help=जब प्रकार के लिस्टिंग, इस मूल्य सॉर्टिंग क्रम के रूप में प्रयोग किया जाता है
+RelationshipType.views.preferred=पसंदीदा
+RelationshipType.views.preferred.help=पसंदीदा प्रकार है कि लोगों को डिफ़ॉल्ट रूप से दिखाया जाएगा जब एक उपयोगकर्ता एक व्यक्ति के संबंधों में भरने
+RelationshipType.views.saved=दृश्य रिश्ता प्रकार के लिए बचाया
+RelationshipType.cannot.delete=रिश्ते के प्रकार को नष्ट नहीं कर सकते. डेटाबेस बाधाओं का उल्लंघन किया जाएगा.
+RelationshipType.select=आप कम से कम एक संबंध प्रकार का चयन करना होगा.
+RelationshipType.retiredSuccessfully=रिश्ते के प्रकार सफलतापूर्वक सेवानिवृत्त
+RelationshipType.purgedSuccessfully=रिश्ते के प्रकार सफलतापूर्वक खाली
+RelationshipType.purgeRelationshipType=शुद्ध रिश्ते के प्रकार
+Relationship.InvalidEndDate.error=मान्य समाप्ति तिथि चुनें जो प्रारंभ तिथि के बाद
 
 #temporary:
-RelationshipType.mother=माँ
-
-Role.manage=प्रबंधन भूमिकाओं
-Role.manage.title=रोल प्रबंधन
-Role.manage.titlebar=OpenMRS भूमिका प्रबंधन
-Role.title=रोल प्रपत्र
-Role.role=रोल
-error.role=रोल खाली नहीं हो सकता
-Role.save=रोल सहेजें
-Role.add=जोड़ें रोल
-Role.inheritedPrivileges.description=बाहर भूरी जांचपेटी को अन्य भूमिकाओं से विरासत में मिली विशेषाधिकारों का प्रतिनिधित्व करते हैं, ये व्यक्तिगत रूप से नहीं हटाया जा सकता है.
-Role.inheritedRoles=भूमिकाओं विरासत
-Role.inheritedRoles.description=<span class="thisRole">यह भूमिका</span> इन भूमिकाओं से विरासत में मिली विशेषाधिकार
-Role.inheritingRoles.description=होते हैं ( से विशेषाधिकार के वारिस ) भूमिकाओं कि <span class\="thisRole">इस भूमिका</span> 
-Role.privileges=विशेषाधिकार
-Role.list.title=वर्तमान भूमिकाओं
-Role.delete=चयनित भूमिकाओं हटाएँ
-Role.saved=रोल बचाया
-Role.deleted=रोल नष्ट कर दिया
-Role.superuser.hasAllRolesAndPrivileges=[सभी भूमिकाओं और विशेषाधिकार है]
-Role.leaveForm=परिवर्तन इस भूमिका के लिए अगर आप इस फार्म छोड़ सहेजा नहीं जाएगा
-Role.cannot.delete=रोल नहीं मिटा सकता. डेटाबेस बाधाओं का उल्लंघन किया जाएगा.
-Role.cannot.delete.with.child=बच्चे भूमिका (एस ) के साथ एक भूमिका को हटा नहीं सकते ।
-Role.select=आप कम से कम एक भूमिका का चयन करना होगा.
-
-Settings.title=सेटिंग
-
-SystemInfo.description=सामान्य सिस्टम जानकारी, वैश्विक सेटिंग्स, आदि
-SystemInfo.overview=सिस्टम सूचना
-SystemInfo.name=नाम
-SystemInfo.value=मूल्य
-SystemInfo.version=संस्करण
-SystemInfo.status =स्थिति
-
-SystemInfo.JavaRuntimeEnv.operatingSystem=ऑपरेटिंग सिस्टम
-SystemInfo.JavaRuntimeEnv.operatingSystemArch=ऑपरेटिंग सिस्टम वास्तुकला
-SystemInfo.JavaRuntimeEnv.operatingSystemVersion=ऑपरेटिंग सिस्टम संस्करण
-SystemInfo.JavaRuntimeEnv.javaVersion=जावा संस्करण
-SystemInfo.JavaRuntimeEnv.javaVendor=जावा विक्रेता
-SystemInfo.JavaRuntimeEnv.jvmVersion=JVM संस्करण
-SystemInfo.JavaRuntimeEnv.jvmVendor=JVM विक्रेता
-SystemInfo.JavaRuntimeEnv.javaRuntimeVersion=जावा रनटाइम संस्करण
-SystemInfo.JavaRuntimeEnv.javaRuntimeName=जावा रनटाइम नाम
-SystemInfo.JavaRuntimeEnv.userName=उपयोगकर्ता नाम
-SystemInfo.JavaRuntimeEnv.systemLanguage=सिस्टम भाषा
-SystemInfo.JavaRuntimeEnv.systemTimezone=सिस्टम समय क्षेत्र
-SystemInfo.JavaRuntimeEnv.fileSystemEncoding=फाइलसिस्टम एन्कोडिंग
-SystemInfo.JavaRuntimeEnv.tempDirectory=Temp निर्देशिका
-SystemInfo.JavaRuntimeEnv.userDirectory=जावा उपयोगकर्ता के घर निर्देशिका
-SystemInfo.OpenMRSInstallation.systemDate=सिस्टम तिथि
-SystemInfo.OpenMRSInstallation.systemTime=सिस्टम समय
-SystemInfo.OpenMRSInstallation.openmrsVersion=OpenMRS संस्करण
-SystemInfo.OpenMRSInstallation.serverURL सर्वर=आधार यूआरएल
-
-SystemInfo.Database.name=डेटाबेस स्कीमा नाम
-SystemInfo.Database.connectionURL=कनेक्शन URL
-SystemInfo.Database.userName=डाटाबेस प्रयोक्ता नाम
-SystemInfo.Database.password=डाटाबेस पासवर्ड
-SystemInfo.Database.driver=डाटाबेस चालक नाम
-SystemInfo.Database.dialect=डाटाबेस बोली
-SystemInfo.Memory.totalMemory=कुल मेमोरी
-SystemInfo.Memory.freeMemory=शुल्क मेमोरी
-SystemInfo.Memory.maximumHeapSize=अधिकतम ढेर आकार
-SystemInfo.title.openmrsInformation=OpenMRS सूचना
-SystemInfo.title.javaRuntimeEnvironmentInformation=जावा रनटाइम सूचना पर्यावरण
-SystemInfo.title.memoryInformation=मेमोरी सूचना
-SystemInfo.title.dataBaseInformation=डेटाबेस सूचना
-SystemInfo.title.moduleInformation=मॉड्यूल सूचना
-SystemInfo.Memory.unusedMemory=उपयोगमेंनहीं मेमोरी
-SystemInfo.Module.repositoryPath=स्थानीय भंडार
-SystemInfo.hostname=होस्ट नाम
-
-User.header=उपयोगकर्ताओं
-User.manage=उपयोगकर्ताओं को प्रबंधितe
-User.manage.title=प्रयोक्ता प्रबंधन
+RelationshipType.mother=माँ
+
+Role.manage=प्रबंधन भूमिकाओं
+Role.manage.title=रोल प्रबंधन
+Role.manage.titlebar=OpenMRS भूमिका प्रबंधन
+Role.title=रोल प्रपत्र
+Role.role=रोल
+error.role=रोल खाली नहीं हो सकता
+Role.save=रोल सहेजें
+Role.add=जोड़ें रोल
+Role.inheritedPrivileges.description=बाहर भूरी जांचपेटी को अन्य भूमिकाओं से विरासत में मिली विशेषाधिकारों का प्रतिनिधित्व करते हैं, ये व्यक्तिगत रूप से नहीं हटाया जा सकता है.
+Role.inheritedRoles=भूमिकाओं विरासत
+Role.inheritedRoles.description=<span class="thisRole">यह भूमिका</span> इन भूमिकाओं से विरासत में मिली विशेषाधिकार
+Role.inheritingRoles.description=होते हैं ( से विशेषाधिकार के वारिस ) भूमिकाओं कि <span class\="thisRole">इस भूमिका</span> 
+Role.privileges=विशेषाधिकार
+Role.list.title=वर्तमान भूमिकाओं
+Role.delete=चयनित भूमिकाओं हटाएँ
+Role.saved=रोल बचाया
+Role.deleted=रोल नष्ट कर दिया
+Role.superuser.hasAllRolesAndPrivileges=[सभी भूमिकाओं और विशेषाधिकार है]
+Role.leaveForm=परिवर्तन इस भूमिका के लिए अगर आप इस फार्म छोड़ सहेजा नहीं जाएगा
+Role.cannot.delete=रोल नहीं मिटा सकता. डेटाबेस बाधाओं का उल्लंघन किया जाएगा.
+Role.cannot.delete.with.child=बच्चे भूमिका (एस ) के साथ एक भूमिका को हटा नहीं सकते ।
+Role.select=आप कम से कम एक भूमिका का चयन करना होगा.
+
+Settings.title=सेटिंग
+
+SystemInfo.description=सामान्य सिस्टम जानकारी, वैश्विक सेटिंग्स, आदि
+SystemInfo.overview=सिस्टम सूचना
+SystemInfo.name=नाम
+SystemInfo.value=मूल्य
+SystemInfo.version=संस्करण
+SystemInfo.status =स्थिति
+
+SystemInfo.JavaRuntimeEnv.operatingSystem=ऑपरेटिंग सिस्टम
+SystemInfo.JavaRuntimeEnv.operatingSystemArch=ऑपरेटिंग सिस्टम वास्तुकला
+SystemInfo.JavaRuntimeEnv.operatingSystemVersion=ऑपरेटिंग सिस्टम संस्करण
+SystemInfo.JavaRuntimeEnv.javaVersion=जावा संस्करण
+SystemInfo.JavaRuntimeEnv.javaVendor=जावा विक्रेता
+SystemInfo.JavaRuntimeEnv.jvmVersion=JVM संस्करण
+SystemInfo.JavaRuntimeEnv.jvmVendor=JVM विक्रेता
+SystemInfo.JavaRuntimeEnv.javaRuntimeVersion=जावा रनटाइम संस्करण
+SystemInfo.JavaRuntimeEnv.javaRuntimeName=जावा रनटाइम नाम
+SystemInfo.JavaRuntimeEnv.userName=उपयोगकर्ता नाम
+SystemInfo.JavaRuntimeEnv.systemLanguage=सिस्टम भाषा
+SystemInfo.JavaRuntimeEnv.systemTimezone=सिस्टम समय क्षेत्र
+SystemInfo.JavaRuntimeEnv.fileSystemEncoding=फाइलसिस्टम एन्कोडिंग
+SystemInfo.JavaRuntimeEnv.tempDirectory=Temp निर्देशिका
+SystemInfo.JavaRuntimeEnv.userDirectory=जावा उपयोगकर्ता के घर निर्देशिका
+SystemInfo.OpenMRSInstallation.systemDate=सिस्टम तिथि
+SystemInfo.OpenMRSInstallation.systemTime=सिस्टम समय
+SystemInfo.OpenMRSInstallation.openmrsVersion=OpenMRS संस्करण
+SystemInfo.OpenMRSInstallation.serverURL सर्वर=आधार यूआरएल
+
+SystemInfo.Database.name=डेटाबेस स्कीमा नाम
+SystemInfo.Database.connectionURL=कनेक्शन URL
+SystemInfo.Database.userName=डाटाबेस प्रयोक्ता नाम
+SystemInfo.Database.password=डाटाबेस पासवर्ड
+SystemInfo.Database.driver=डाटाबेस चालक नाम
+SystemInfo.Database.dialect=डाटाबेस बोली
+SystemInfo.Memory.totalMemory=कुल मेमोरी
+SystemInfo.Memory.freeMemory=शुल्क मेमोरी
+SystemInfo.Memory.maximumHeapSize=अधिकतम ढेर आकार
+SystemInfo.title.openmrsInformation=OpenMRS सूचना
+SystemInfo.title.javaRuntimeEnvironmentInformation=जावा रनटाइम सूचना पर्यावरण
+SystemInfo.title.memoryInformation=मेमोरी सूचना
+SystemInfo.title.dataBaseInformation=डेटाबेस सूचना
+SystemInfo.title.moduleInformation=मॉड्यूल सूचना
+SystemInfo.Memory.unusedMemory=उपयोगमेंनहीं मेमोरी
+SystemInfo.Module.repositoryPath=स्थानीय भंडार
+SystemInfo.hostname=होस्ट नाम
+
+User.header=उपयोगकर्ताओं
+User.manage=उपयोगकर्ताओं को प्रबंधितe
+User.manage.title=प्रयोक्ता प्रबंधन
 User.manage.titlebar=OpenMRS
-User.title=जोड़ें या संपादित उपयोगकर्ता
-User.manage.header=प्रयोक्ता प्रबंधन
-User.title.add=उपयोगकर्ता जोड़ें
-User.title.edit=उपयोगकर्ता संपादित करें
-User.needsAPerson=एक उपयोगकर्ता खाते प्रणाली में एक व्यक्ति का होना चाहिए
-User.demographicInfo=जनसांख्यिकीय जानकारी
-User.loginInfo=लॉगिन जानकारी
-User.systemId=सिस्टम ID
-User.systemId.willBeGenerated=सिस्टम ID सहेजने के बाद उत्पन्न हो जाएगा
-User.login.manner=उपयोगकर्ता नाम या सिस्टम ID या तो साथ में प्रवेश कर सकते हैं
-User.username=यूजर का नाम
-error.systemId=एक प्रणाली आईडी होना चाहिए
-error.username.taken=उपयोगकर्ता नाम या सिस्टम ID लिया । एक अलग से एक का चयन करें।
-error.username.pattern=नाम अवैध है। यह 2 और 50 अक्षरों के बीच होना चाहिए। केवल अक्षर, अंक , " । " "- ", और " _" अनुमति दी जाती है ।
-User.password=पासवर्ड
-User.usersPassword=उपयोगकर्ता का पासवर्ड
-error.password.match=उपलब्ध कराए गए पासवर्ड मेल नहीं खाते
-error.password.weak=एक मजबूत पासवर्ड का चयन करें
-error.password.length=कम से कम { 0} वर्ण लंबा है कि एक पासवर्ड का चयन करें
-error.password.short=एक लंबे समय तक पासवर्ड का चयन करें
-error.password.requireMixedCase=दोनों ऊपरी मामले और कम मामले पत्र में शामिल है एक पासवर्ड का चयन करें
-error.password.requireNumber=कम से कम एक संख्या शामिल है एक पासवर्ड का चयन करें
-error.password.requireLetter=कम से कम एक पत्र में शामिल है एक पासवर्ड का चयन करें
-error.password.different=एक अलग पासवर्ड का चयन करें।
-error.password.incorrect=गलत पासवर्ड ।
-error.User.secretAnswer.empty=गुप्त उत्तर खाली नहीं होना चाहिए
-error.User.secretQuestion.empty=गुप्त प्रश्न खाली नहीं होना चाहिए
-User.confirm=पासवर्ड की पुष्टि कीजिये
-User.confirm.description=( सटीकता के लिए ) फिर से लिखें पासवर्ड
-User.roles=भूमिकाएँ
-User.otherRoles=अन्य भूमिकाओं
-User.secretQuestion.prompt=अपना पासवर्ड रीसेट करने के लिए निम्नलिखित प्रश्न का उत्तर दें
-User.secretQuestion=गुप्त प्रश्न
-User.secretAnswer=गुप्त उत्तर
-User.forceChange=फोर्स पासवर्ड बदलें
-User.forceChange.description=वैकल्पिक रूप से इस उपयोगकर्ता अगले लॉगिन पर उनके पासवर्ड बदलने की आवश्यकता है कि
-User.save=उपयोगकर्ता सहेजें
-User.add=उपयोगकर्ता जोड़ें
-User.list.title=मौजूदा उपयोगकर्ताओं
-User.void=चयनित उपयोगकर्ताओं को हटाना
-User.unvoid=चयनित उपयोगकर्ता पुनर्स्थापित
-User.saved=प्रयोक्ता सहेजा
-User.voided=प्रयोक्ता हटाए गए
-User.unvoided=प्रयोक्ता बहाल
-User.find=नाम पर उपयोगकर्ता का पता लगाएं
-User.password.change=प्रशासकों आप सुरक्षा को बढ़ाने के लिए अपना पासवर्ड परिवर्तित कर अनुरोध किया है। नीचे अपना पासवर्ड बदल दें ।
-User.password.forgot=मैं अपना पासवर्ड भूल गया
-User.goTo=उपयोगकर्ता पर जाओ
-User.assumeIdentity=इस उपयोगकर्ता बनें
-User.assumeIdentity.confirm=सूचना है ! आप लॉग आउट और बाद में नए उपयोगकर्ता के रूप में लॉग इन किया जाएगा ।
-User.assumeIdentity.success=अब आप के रूप में लॉग इन किया है {0}
-User.localeChangeHint=नोट: आप अपने डिफ़ॉल्ट स्थान निर्धारित कर सकते हैं <a href="{0}/options.form">मेरा प्रोफ़ाइल</a> &rarr; 'डिफ़ॉल्ट स्थान'
-User.showAdvancedOptions=दिखाएँ उन्नत विकल्प
-User.hideAdvancedOptions=उन्नत विकल्प छुपाएं
-User.delete=उपयोगकर्ता हटाएं
-User.retire=निष्क्रिय खाता
-User.disableReason.empty=अक्षम कारण खाली नहीं हो सकता ।
-User.unRetire=खाता सक्षम करें
-User.delete.confirm=आप पूरी तरह से प्रणाली से इस उपयोगकर्ता को दूर करना चाहते हैं आप यकीन कर रहे हैं? ( लौटाया नहीं जा सकता )
-User.userDeceased=इस उपयोगकर्ता खाते के अंतर्गत आता व्यक्ति मृत है करने के लिए
-User.retiredMessage=इस उपयोगकर्ता खाता निष्क्रिय है और उपयोगकर्ता में लॉग इन नहीं कर सकते।
-User.unRetiredMessage=इस उपयोगकर्ता खाता सक्षम कर दिया गया है और वे अब अपने यूज़रनेम और पासवर्ड के साथ लॉग इन कर सकते हैं।
-User.userProperties=उपयोगकर्ता के गुण
-User.person=व्यक्ति
-User.createNewPerson=एक नए व्यक्ति बनाएं
-User.useExisting=पहले से ही मौजूद है , जो एक व्यक्ति का प्रयोग करें
-User.whichPerson=कौन सा व्यक्ति?
-User.delete.failure=उपयोगकर्ता को नष्ट नहीं किया जा सकता। इस उपयोगकर्ता के लिए जिम्मेदार ठहराया डेटा नहीं है
-User.delete.success=सफलतापूर्वक उपयोगकर्ता नष्ट कर दिया।
-User.noUsersFound=दी खोज मापदंडों के साथ मिला कोई उपयोगकर्ता नहीं
-User.creationInfo=निर्माण की जानकारी
-User.retiredInfo=विकलांग की जानकारी
-User.retiredBy=द्वारा अक्षम
-User.dateRetired=दिनांक से अक्षम
-User.search.placeholder=उपयोगकर्ता नाम दर्ज करें
-
-Migration.users=उपयोगकर्ता
-Migration.usersHeader=अपलोड उपयोगकर्ता
-Migration.locations=स्थान
-Migration.locationsHeader=अपलोड स्थान
-Migration.hl7Header=भागो HL7
-Migration.pasteUserXmlHere=चिपकाएँ XML निर्यात उपयोगकर्ता डेटा
-Migration.pasteLocationXmlHere=स्थान डेटा चिपकाएँ XML निर्यात
-Migration.pasteHl7Here=चिपकाएँ यहाँ चला HL7
-Migration.uploadButton=अपलोड
-Migration.regimen=परहेज
-Migration.regimen.csv=चिपकाएँ यहाँ CSV नहीं शीर्षक सहित. कॉलम होना चाहिए
-Migration.relationship=रिश्ते, आदि
-Migration.relationship.filename=माइग्रेशन फ़ाइल नाम:
-Migration.relationship.autoCreateUser=रिश्तों के स्रोत के रूप में स्वचालित रूप से उपयोगकर्ताओं को बनाने की जरूरत है?
-Migration.relationship.autoCreateUserRole=उनके रिश्ते के प्रकार के रूप में एक ही नाम के साथ भूमिका के लिए उपयोगकर्ताओं को स्वचालित रूप से बनाया है, अगर यह मौजूद है?
-
-Module.title=प्रबंधित मॉड्यूल
-Module.header=मॉड्यूल
-Module.manage=प्रबंधन मॉड्यूल
-Module.manageProperties=मॉड्यूल गुण
-Module.add=जोड़ें मॉड्यूल
-Module.upgrade=एक मौजूदा मॉड्यूल अपग्रेड
-Module.addOrUpgrade=जोड़ें या मॉड्यूल उन्नयन
-Module.upload=अपलोड
-Module.start=प्रारंभ
-Module.stop=बंद करो
-Module.unload=अनलोड
-Module.start.help=प्रारंभ मॉड्यूल
-Module.stop.help स्टॉप=मॉड्यूल गतिविधि
-Module.unload.help=सिस्टम से हटाने के लिये मौड्यूल
-Module.unloaded=मॉड्यूल {0} उतार दिया गया है
-Module.started=मॉड्यूल {0} शुरू कर दिया गया है
-Module.not.started=मॉड्यूल शुरू करते समय त्रुटी  {0}
-Module.loaded=मॉड्यूल {0} लोड किया गया है
-Module.stopped=मॉड्यूल {0} रोक दिया गया है
-Module.dependencyValidationNotice=ध्यान दें: आश्रित मॉड्यूल का पता चला!
-Module.dependencyShutdownNotice=आप इस कार्रवाई के साथ जारी रखने का फैसला अगर निम्नलिखित मॉड्यूल बंद हो जाएगा।
-Module.error=मॉड्यूल प्रक्रिया में त्रुटि 
-Module.errorStarting=प्रारंभ करने में त्रुटि मॉड्यूल - {0}
-Module.errorClickForDetails=प्रारंभ करने में त्रुटि! विवरण के लिए क्लिक करें
-Module.invalid=अमान्य निर्दिष्ट मॉड्यूल {0}
-Module.notStarted=शुरू नहीं किया
-Module.loadedAndStarted=मॉड्यूल भरी हुई है और सफलतापूर्वक प्रारंभ
-Module.updateAvailable=उपलब्ध उन्नयन!
-Module.checkForUpdates=उन्नयन के लिए जांच
-Module.startAll=सब शुरू
-Module.noLoadedModules=वर्तमान में कोई मॉड्यूल के लोड.
-Module.storedIn=मॉड्यूल में संग्रहीत
-Module.help.load=एक मॉड्यूल 1) मॉड्यूल भंडार में इसे छोड़ने और webapp शुरु, या 2) उपरोक्त फॉर्म के माध्यम से अपलोड करने के लिए या तो द्वारा OpenMRS में भरी हुई है ।
-Module.help.unload=एक मॉड्यूल उतार दिया जाता है, यह तो omod फ़ाइल भंडार से हटा दिया जाता है , 'पहले बंद कर दिया ' है ।
-Module.help.startStop=एक भरी हुई मॉड्यूल बंद कर दिया और शुरू किया जा सकता है। एक बंद मॉड्यूल अभी यह सिर्फ सिस्टम पर कोई असर नहीं है , भरी हुई है।
-Module.help.update=एक मॉड्यूल को अद्यतन , या तो क्लिक करें ' स्थापित करें अपडेट' या करने के क्रम में हैं: 1) अद्यतन डाउनलोड करें , 2) फार्म के माध्यम से नए मॉड्यूल अपलोड उपरोक्त फॉर्म "मौजूदा मॉड्यूल अपग्रेड "।
-Module.help.findMore=ढूँढें और <a target\="moduleRepository" में अधिक मॉड्यूल डाउनलोड OpenMRS मॉड्यूल भंडार href\="http\://modules.openmrs.org/modules"> </a>
-Module.unloadWarning=आप पूरी तरह से प्रणाली से इस मॉड्यूल को दूर करने के बारे में हैं।
-Module.allowUploads=अपलोड की अनुमति ?
-Module.disallowUploads=अपलोड इस समय वेबसाइट से अनुमति नहीं है। क्रम संपत्ति {0} सही पर सेट किया जाना चाहिए।
-Module.disallowAdministration=वेब प्रशासन इस समय वेबसाइट से अनुमति नहीं है । क्रम संपत्ति {0} सही पर सेट किया जाना चाहिए।
-Module.help=मॉड्यूल सहायता
-Module.installUpdate=उन्नत मॉड्यूल स्थापित
-Module.install=स्थापित करें
-Module.findAndDownload=मॉड्यूल भंडार से स्थापित करें ({0})
-Module.downloadUpdate=उन्नत मॉड्यूल
-Module.reload=पुनः लोड मॉड्यूल
-Module.notice=नोट: जोड़ने, हटाने, या OpenMRS समॉड्यूल  पुनः आरंभ करेगा, जिसका अर्थ है कि सभी अनुसूचित कार्यों और पृष्ठभूमि प्रक्रियाओं बाधित हो जाएगा.
-Module.locked=या रोका नहीं जा अनलोअदेद कर सकते हैं
-Module.locked.help=इस मॉड्यूल या तो यह एक अनिवार्य मॉड्यूल के रूप में चिह्नित किया जाता है , क्योंकि संशोधित एक openmrs कोर मॉड्यूल है , या module_web_admin क्रम संपत्ति सच करने के लिए सेट नहीं है नहीं किया जा सकता
-Module.UploadAnUpdate=अद्यतन किया जाता है कि एक मॉड्यूल अपलोड
-Module.requireVersion.outOfBounds=मॉड्यूल संस्करण मिलान की आवश्यकता है {0}.  वर्तमान कोड संस्करण है {1}
-Module.requireVersion.belowLowerBound=मॉड्यूल में कम से कम संस्करण {0} , वर्तमान कोड संस्करण केवल आवश्यकता है {1}
-Module.error.fileCannotBeNull=मॉड्यूल फ़ाइल रिक्त नहीं हो सकता
-Module.error.invalidFileExtension=मॉड्यूल फ़ाइल सही नहीं है '. Omod' फ़ाइल एक्सटेंशन
-Module.error.cannotCreateFile=मॉड्यूल फ़ाइल नहीं बना सकते हैं
-Module.error.cannotGetJarFile=में असमर्थ जार फ़ाइल प्राप्त करने के लिए
-Module.error.noConfigFile त्रुटि=लोडिंग माड्यूल, कोई config.xml फ़ाइल पाया.
-Module.error.cannotGetConfigFileStream=में असमर्थ config फाइल स्ट्रीम पाने के लिए
-Module.error.cannotParseConfigFile=पार्सिंग मॉड्यूल त्रुटि config.xml फ़ाइल
-Module.error.invalidConfigVersion=अमान्य config संस्करण: स्थान में {0} {1}
-Module.error.nameCannotBeEmpty=नाम खाली नहीं हो सकता
-Module.error.idCannotBeEmpty=मॉड्यूल आईडी खाली नहीं हो सकता
-Module.error.packageCannotBeEmpty=पैकेज खाली नहीं हो सकता
-Module.error.noMessagePropsFile={1} भाषा के लिए कोई संदेश गुण फ़ाइल {0}
-Module.startupError.notification.message=एक मॉड्यूल प्रारंभ करने में त्रुटि थी: {0}
-Module.error.moduleCannotBeStarted=यह निम्न मॉड्यूल (एस ) की आवश्यकता है क्योंकि मॉड्यूल {0} शुरू नहीं किया जा सकता है:{1} स्थापित करें और पहले इन मॉड्यूल शुरू करें।
-
-SystemInfo.title=सूचना प्रणाली
-MRNGenerator.title=मेडिकल रिकार्ड संख्या की सूची उत्पन्न (MRNs)
-MRNGenerator.description=यह मरीज पहचानकर्ता एक केंद्रीय सत्ता से वितरित किया है कि गंभीर रूप से महत्वपूर्ण है । अन्यथा, गलती से एक से अधिक व्यक्ति बढ़ जाती है के लिए एक ही मेडिकल रिकॉर्ड संख्या ( MRN ) बताए की संभावना। इसी प्रकार, प्रत्येक क्लीनिक में एक भी व्यक्ति नया पहचानकर्ता बताए के आरोप में होना चाहिए। मेडिकल रिकॉर्ड संख्या के लिए सामान्य प्रारूप 123MT -2 , 123 एक अनुक्रमिक संख्या है , जहां है <br/> <br/> , मीट्रिक टन का प्रतिनिधित्व करता है साइट विशेष प्रत्यय , और -2 की जांच अंकों है । नीचे, बस साइट शुरू अनुक्रम संख्या , और आप की जरूरत पहचानकर्ता की संख्या का चयन करें। ( उचित जांच अंक सहित ) मेडिकल रिकॉर्ड संख्या के साथ कोई टेक्स्ट फाइल उत्पन्न होता है और आपके कंप्यूटर पर डाउनलोड <br/> <br/> नोट किया जाएगा । यह एक सेवा थोक में उचित जांच अंक उत्पन्न मात्र है । यह इन नंबरों एक नियंत्रित केंद्रीय सत्ता के माध्यम से वितरित कर रहे हैं कि यह सुनिश्चित करना आपकी जिम्मेदारी है ? यानी, पहचानकर्ता एक मरीज को एक बार और केवल एक बार आवंटित कर रहे हैं ।
-MRNGenerator.log.view=देखें लॉग MRN लाने के
-MRNGenerator.log.hide=छिपाएँ लॉग MRN लाने के
-MRNGenerator.select.site=1. एक साइट का चयन करें
-MRNGenerator.starting.number=2. प्रारंभिक संख्या दर्ज करें
-MRNGenerator.prefix.number=3. एक उपसर्ग (वैकल्पिक) का चयन करें
-MRNGenerator.generate.number=4. MRNs की संख्या निर्दिष्ट उत्पन्न करने के लिए
-MRNGenerator.all.required=सभी मान आवश्यक है
-MRNGenerator.generate.identifiers=उत्पन्न ईदेन्तिफ़िएर्स
-MRNGenerator.date=उत्पन्न तिथि
-MRNGenerator.generator=जेनरेटर
-MRNGenerator.site=साइट
-MRNGenerator.first=प्रथम
-MRNGenerator.count=गिनती
-MRNGenerator.prefix=उपसर्ग
-
-AuditPatientIdentifiers.manage=लेखापरीक्षा रोगी पहचान की
-AuditPatientIdentifiers.link=अवैध चेक अंक हटाये 
-AuditPatientIdentifiers.description=hasCheckDigit झंडी दिखाकर रवाना किया जाता है, तो 4 ( अमान्य चेक अंक) टाइप करने के लिए 
-Maintenance.header=रखरखाव
-QuickReport.manage=त्वरित रिपोर्ट देखें
-QuickReport.type=रिपोर्ट प्रकार
-QuickReport.type.returnVisit=इस सप्ताह दुबारा आने की तिथि
-QuickReport.type.attendedClinic=भाग लिया क्लिनिक इस सप्ताह
-QuickReport.type.voidedObs=अवलोकन खाली किया
-QuickReport.startDate=प्रारंभ दिनांक
-QuickReport.endDate=समाप्ति तिथि
-QuickReport.location=स्थान
-QuickReport.location.all=सभी स्थान
-QuickReport.date=तिथि रिपोर्ट
-QuickReport.view=उत्पन्न रिपोर्ट
-
-Scheduler.title=प्रबंधित समयबद्धक
-Scheduler.header=समयबद्धक
- Scheduler.taskList.title=उपलब्ध कार्य
-Scheduler.taskList.active=सक्रिय
-Scheduler.taskList.add=जोड़ें टास्क
-Scheduler.taskList.delete=हटाएँ
-Scheduler.taskList.start=प्रारंभ
-Scheduler.taskList.stop=बंद 
-Scheduler.taskList.deleted=(ओं) टास्क {0} नष्ट <br/>
-Scheduler.taskList.started=कार्य शुरू कर दिया गया है {0} <br/>
-Scheduler.taskList.stopped=टास्क {0} <br/> बंद कर दिया गया है
-Scheduler.taskList.deleteNotAllowed=यह नष्ट किया जा सकता से पहले कार्य {0} रोका जाना चाहिए । <br/>
-Scheduler.taskList.refresh=ताज़ा कार्य
-Scheduler.taskList.error=प्रसंस्करण कार्य त्रुटि <br/>
-Scheduler.taskList.requireTask=आप एक क्रिया बटन क्लिक करने से पहले एक कार्य का चयन करना होगा
-Scheduler.taskForm.title=टास्क प्रपत्र
-Scheduler.taskForm.legend=टास्क विन्यास
-Scheduler.taskForm.cancel=रद्द
-Scheduler.taskForm.class=अनुसूची में सक्षम क्लास
-Scheduler.taskForm.edit=संपादित करें
-Scheduler.taskForm.schedules=अनुसूची
-Scheduler.taskForm.save=सहेजें
-Scheduler.taskForm.saved=टास्क {0} <br/> बचा लिया गया है
-Scheduler.list.status स्थिति=
-Scheduler.list.taskClass=कार्य / कक्षा
-Scheduler.list.schedule=अनुसूची 
-Scheduler.list.lastExecutionTime=अंतिम निष्पादन समय
-Scheduler.list.startOnStartup=स्टार्टअप पर 
-Scheduler.list.started=आरंभ 
-Scheduler.list.runsAgainIn=<strong> में फिर से चलाता है {0} </ strong>
-Scheduler.list.stopped=रूका
-Scheduler.list.runsEvery=हर <strong> {0}  </ strong> रन
-Scheduler.list.from=<strong> से {0} </ strong>
-Scheduler.list.startingOn=<strong> पर शुरू {0} </ strong>
-Scheduler.list.manual=पुस्तिका
-Scheduler.list.automatic=स्वत:
+User.title=जोड़ें या संपादित उपयोगकर्ता
+User.manage.header=प्रयोक्ता प्रबंधन
+User.title.add=उपयोगकर्ता जोड़ें
+User.title.edit=उपयोगकर्ता संपादित करें
+User.needsAPerson=एक उपयोगकर्ता खाते प्रणाली में एक व्यक्ति का होना चाहिए
+User.demographicInfo=जनसांख्यिकीय जानकारी
+User.loginInfo=लॉगिन जानकारी
+User.systemId=सिस्टम ID
+User.systemId.willBeGenerated=सिस्टम ID सहेजने के बाद उत्पन्न हो जाएगा
+User.login.manner=उपयोगकर्ता नाम या सिस्टम ID या तो साथ में प्रवेश कर सकते हैं
+User.username=यूजर का नाम
+error.systemId=एक प्रणाली आईडी होना चाहिए
+error.username.taken=उपयोगकर्ता नाम या सिस्टम ID लिया । एक अलग से एक का चयन करें।
+error.username.pattern=नाम अवैध है। यह 2 और 50 अक्षरों के बीच होना चाहिए। केवल अक्षर, अंक , " । " "- ", और " _" अनुमति दी जाती है ।
+User.password=पासवर्ड
+User.usersPassword=उपयोगकर्ता का पासवर्ड
+error.password.match=उपलब्ध कराए गए पासवर्ड मेल नहीं खाते
+error.password.weak=एक मजबूत पासवर्ड का चयन करें
+error.password.length=कम से कम { 0} वर्ण लंबा है कि एक पासवर्ड का चयन करें
+error.password.short=एक लंबे समय तक पासवर्ड का चयन करें
+error.password.requireMixedCase=दोनों ऊपरी मामले और कम मामले पत्र में शामिल है एक पासवर्ड का चयन करें
+error.password.requireNumber=कम से कम एक संख्या शामिल है एक पासवर्ड का चयन करें
+error.password.requireLetter=कम से कम एक पत्र में शामिल है एक पासवर्ड का चयन करें
+error.password.different=एक अलग पासवर्ड का चयन करें।
+error.password.incorrect=गलत पासवर्ड ।
+error.User.secretAnswer.empty=गुप्त उत्तर खाली नहीं होना चाहिए
+error.User.secretQuestion.empty=गुप्त प्रश्न खाली नहीं होना चाहिए
+User.confirm=पासवर्ड की पुष्टि कीजिये
+User.confirm.description=( सटीकता के लिए ) फिर से लिखें पासवर्ड
+User.roles=भूमिकाएँ
+User.otherRoles=अन्य भूमिकाओं
+User.secretQuestion.prompt=अपना पासवर्ड रीसेट करने के लिए निम्नलिखित प्रश्न का उत्तर दें
+User.secretQuestion=गुप्त प्रश्न
+User.secretAnswer=गुप्त उत्तर
+User.forceChange=फोर्स पासवर्ड बदलें
+User.forceChange.description=वैकल्पिक रूप से इस उपयोगकर्ता अगले लॉगिन पर उनके पासवर्ड बदलने की आवश्यकता है कि
+User.save=उपयोगकर्ता सहेजें
+User.add=उपयोगकर्ता जोड़ें
+User.list.title=मौजूदा उपयोगकर्ताओं
+User.void=चयनित उपयोगकर्ताओं को हटाना
+User.unvoid=चयनित उपयोगकर्ता पुनर्स्थापित
+User.saved=प्रयोक्ता सहेजा
+User.voided=प्रयोक्ता हटाए गए
+User.unvoided=प्रयोक्ता बहाल
+User.find=नाम पर उपयोगकर्ता का पता लगाएं
+User.password.change=प्रशासकों आप सुरक्षा को बढ़ाने के लिए अपना पासवर्ड परिवर्तित कर अनुरोध किया है। नीचे अपना पासवर्ड बदल दें ।
+User.password.forgot=मैं अपना पासवर्ड भूल गया
+User.goTo=उपयोगकर्ता पर जाओ
+User.assumeIdentity=इस उपयोगकर्ता बनें
+User.assumeIdentity.confirm=सूचना है ! आप लॉग आउट और बाद में नए उपयोगकर्ता के रूप में लॉग इन किया जाएगा ।
+User.assumeIdentity.success=अब आप के रूप में लॉग इन किया है {0}
+User.localeChangeHint=नोट: आप अपने डिफ़ॉल्ट स्थान निर्धारित कर सकते हैं <a href="{0}/options.form">मेरा प्रोफ़ाइल</a> &rarr; 'डिफ़ॉल्ट स्थान'
+User.showAdvancedOptions=दिखाएँ उन्नत विकल्प
+User.hideAdvancedOptions=उन्नत विकल्प छुपाएं
+User.delete=उपयोगकर्ता हटाएं
+User.retire=निष्क्रिय खाता
+User.disableReason.empty=अक्षम कारण खाली नहीं हो सकता ।
+User.unRetire=खाता सक्षम करें
+User.delete.confirm=आप पूरी तरह से प्रणाली से इस उपयोगकर्ता को दूर करना चाहते हैं आप यकीन कर रहे हैं? ( लौटाया नहीं जा सकता )
+User.userDeceased=इस उपयोगकर्ता खाते के अंतर्गत आता व्यक्ति मृत है करने के लिए
+User.retiredMessage=इस उपयोगकर्ता खाता निष्क्रिय है और उपयोगकर्ता में लॉग इन नहीं कर सकते।
+User.unRetiredMessage=इस उपयोगकर्ता खाता सक्षम कर दिया गया है और वे अब अपने यूज़रनेम और पासवर्ड के साथ लॉग इन कर सकते हैं।
+User.userProperties=उपयोगकर्ता के गुण
+User.person=व्यक्ति
+User.createNewPerson=एक नए व्यक्ति बनाएं
+User.useExisting=पहले से ही मौजूद है , जो एक व्यक्ति का प्रयोग करें
+User.whichPerson=कौन सा व्यक्ति?
+User.delete.failure=उपयोगकर्ता को नष्ट नहीं किया जा सकता। इस उपयोगकर्ता के लिए जिम्मेदार ठहराया डेटा नहीं है
+User.delete.success=सफलतापूर्वक उपयोगकर्ता नष्ट कर दिया।
+User.noUsersFound=दी खोज मापदंडों के साथ मिला कोई उपयोगकर्ता नहीं
+User.creationInfo=निर्माण की जानकारी
+User.retiredInfo=विकलांग की जानकारी
+User.retiredBy=द्वारा अक्षम
+User.dateRetired=दिनांक से अक्षम
+User.search.placeholder=उपयोगकर्ता नाम दर्ज करें
+
+Migration.users=उपयोगकर्ता
+Migration.usersHeader=अपलोड उपयोगकर्ता
+Migration.locations=स्थान
+Migration.locationsHeader=अपलोड स्थान
+Migration.hl7Header=भागो HL7
+Migration.pasteUserXmlHere=चिपकाएँ XML निर्यात उपयोगकर्ता डेटा
+Migration.pasteLocationXmlHere=स्थान डेटा चिपकाएँ XML निर्यात
+Migration.pasteHl7Here=चिपकाएँ यहाँ चला HL7
+Migration.uploadButton=अपलोड
+Migration.regimen=परहेज
+Migration.regimen.csv=चिपकाएँ यहाँ CSV नहीं शीर्षक सहित. कॉलम होना चाहिए
+Migration.relationship=रिश्ते, आदि
+Migration.relationship.filename=माइग्रेशन फ़ाइल नाम:
+Migration.relationship.autoCreateUser=रिश्तों के स्रोत के रूप में स्वचालित रूप से उपयोगकर्ताओं को बनाने की जरूरत है?
+Migration.relationship.autoCreateUserRole=उनके रिश्ते के प्रकार के रूप में एक ही नाम के साथ भूमिका के लिए उपयोगकर्ताओं को स्वचालित रूप से बनाया है, अगर यह मौजूद है?
+
+Module.title=प्रबंधित मॉड्यूल
+Module.header=मॉड्यूल
+Module.manage=प्रबंधन मॉड्यूल
+Module.manageProperties=मॉड्यूल गुण
+Module.add=जोड़ें मॉड्यूल
+Module.upgrade=एक मौजूदा मॉड्यूल अपग्रेड
+Module.addOrUpgrade=जोड़ें या मॉड्यूल उन्नयन
+Module.upload=अपलोड
+Module.start=प्रारंभ
+Module.stop=बंद करो
+Module.unload=अनलोड
+Module.start.help=प्रारंभ मॉड्यूल
+Module.stop.help स्टॉप=मॉड्यूल गतिविधि
+Module.unload.help=सिस्टम से हटाने के लिये मौड्यूल
+Module.unloaded=मॉड्यूल {0} उतार दिया गया है
+Module.started=मॉड्यूल {0} शुरू कर दिया गया है
+Module.not.started=मॉड्यूल शुरू करते समय त्रुटी  {0}
+Module.loaded=मॉड्यूल {0} लोड किया गया है
+Module.stopped=मॉड्यूल {0} रोक दिया गया है
+Module.dependencyValidationNotice=ध्यान दें: आश्रित मॉड्यूल का पता चला!
+Module.dependencyShutdownNotice=आप इस कार्रवाई के साथ जारी रखने का फैसला अगर निम्नलिखित मॉड्यूल बंद हो जाएगा।
+Module.error=मॉड्यूल प्रक्रिया में त्रुटि 
+Module.errorStarting=प्रारंभ करने में त्रुटि मॉड्यूल - {0}
+Module.errorClickForDetails=प्रारंभ करने में त्रुटि! विवरण के लिए क्लिक करें
+Module.invalid=अमान्य निर्दिष्ट मॉड्यूल {0}
+Module.notStarted=शुरू नहीं किया
+Module.loadedAndStarted=मॉड्यूल भरी हुई है और सफलतापूर्वक प्रारंभ
+Module.updateAvailable=उपलब्ध उन्नयन!
+Module.checkForUpdates=उन्नयन के लिए जांच
+Module.startAll=सब शुरू
+Module.noLoadedModules=वर्तमान में कोई मॉड्यूल के लोड.
+Module.storedIn=मॉड्यूल में संग्रहीत
+Module.help.load=एक मॉड्यूल 1) मॉड्यूल भंडार में इसे छोड़ने और webapp शुरु, या 2) उपरोक्त फॉर्म के माध्यम से अपलोड करने के लिए या तो द्वारा OpenMRS में भरी हुई है ।
+Module.help.unload=एक मॉड्यूल उतार दिया जाता है, यह तो omod फ़ाइल भंडार से हटा दिया जाता है , 'पहले बंद कर दिया ' है ।
+Module.help.startStop=एक भरी हुई मॉड्यूल बंद कर दिया और शुरू किया जा सकता है। एक बंद मॉड्यूल अभी यह सिर्फ सिस्टम पर कोई असर नहीं है , भरी हुई है।
+Module.help.update=एक मॉड्यूल को अद्यतन , या तो क्लिक करें ' स्थापित करें अपडेट' या करने के क्रम में हैं: 1) अद्यतन डाउनलोड करें , 2) फार्म के माध्यम से नए मॉड्यूल अपलोड उपरोक्त फॉर्म "मौजूदा मॉड्यूल अपग्रेड "।
+Module.help.findMore=ढूँढें और <a target\="moduleRepository" में अधिक मॉड्यूल डाउनलोड OpenMRS मॉड्यूल भंडार href\="http\://modules.openmrs.org/modules"> </a>
+Module.unloadWarning=आप पूरी तरह से प्रणाली से इस मॉड्यूल को दूर करने के बारे में हैं।
+Module.allowUploads=अपलोड की अनुमति ?
+Module.disallowUploads=अपलोड इस समय वेबसाइट से अनुमति नहीं है। क्रम संपत्ति {0} सही पर सेट किया जाना चाहिए।
+Module.disallowAdministration=वेब प्रशासन इस समय वेबसाइट से अनुमति नहीं है । क्रम संपत्ति {0} सही पर सेट किया जाना चाहिए।
+Module.help=मॉड्यूल सहायता
+Module.installUpdate=उन्नत मॉड्यूल स्थापित
+Module.install=स्थापित करें
+Module.findAndDownload=मॉड्यूल भंडार से स्थापित करें ({0})
+Module.downloadUpdate=उन्नत मॉड्यूल
+Module.reload=पुनः लोड मॉड्यूल
+Module.notice=नोट: जोड़ने, हटाने, या OpenMRS समॉड्यूल  पुनः आरंभ करेगा, जिसका अर्थ है कि सभी अनुसूचित कार्यों और पृष्ठभूमि प्रक्रियाओं बाधित हो जाएगा.
+Module.locked=या रोका नहीं जा अनलोअदेद कर सकते हैं
+Module.locked.help=इस मॉड्यूल या तो यह एक अनिवार्य मॉड्यूल के रूप में चिह्नित किया जाता है , क्योंकि संशोधित एक openmrs कोर मॉड्यूल है , या module_web_admin क्रम संपत्ति सच करने के लिए सेट नहीं है नहीं किया जा सकता
+Module.UploadAnUpdate=अद्यतन किया जाता है कि एक मॉड्यूल अपलोड
+Module.requireVersion.outOfBounds=मॉड्यूल संस्करण मिलान की आवश्यकता है {0}.  वर्तमान कोड संस्करण है {1}
+Module.requireVersion.belowLowerBound=मॉड्यूल में कम से कम संस्करण {0} , वर्तमान कोड संस्करण केवल आवश्यकता है {1}
+Module.error.fileCannotBeNull=मॉड्यूल फ़ाइल रिक्त नहीं हो सकता
+Module.error.invalidFileExtension=मॉड्यूल फ़ाइल सही नहीं है '. Omod' फ़ाइल एक्सटेंशन
+Module.error.cannotCreateFile=मॉड्यूल फ़ाइल नहीं बना सकते हैं
+Module.error.cannotGetJarFile=में असमर्थ जार फ़ाइल प्राप्त करने के लिए
+Module.error.noConfigFile त्रुटि=लोडिंग माड्यूल, कोई config.xml फ़ाइल पाया.
+Module.error.cannotGetConfigFileStream=में असमर्थ config फाइल स्ट्रीम पाने के लिए
+Module.error.cannotParseConfigFile=पार्सिंग मॉड्यूल त्रुटि config.xml फ़ाइल
+Module.error.invalidConfigVersion=अमान्य config संस्करण: स्थान में {0} {1}
+Module.error.nameCannotBeEmpty=नाम खाली नहीं हो सकता
+Module.error.idCannotBeEmpty=मॉड्यूल आईडी खाली नहीं हो सकता
+Module.error.packageCannotBeEmpty=पैकेज खाली नहीं हो सकता
+Module.error.noMessagePropsFile={1} भाषा के लिए कोई संदेश गुण फ़ाइल {0}
+Module.startupError.notification.message=एक मॉड्यूल प्रारंभ करने में त्रुटि थी: {0}
+Module.error.moduleCannotBeStarted=यह निम्न मॉड्यूल (एस ) की आवश्यकता है क्योंकि मॉड्यूल {0} शुरू नहीं किया जा सकता है:{1} स्थापित करें और पहले इन मॉड्यूल शुरू करें।
+
+SystemInfo.title=सूचना प्रणाली
+MRNGenerator.title=मेडिकल रिकार्ड संख्या की सूची उत्पन्न (MRNs)
+MRNGenerator.description=यह मरीज पहचानकर्ता एक केंद्रीय सत्ता से वितरित किया है कि गंभीर रूप से महत्वपूर्ण है । अन्यथा, गलती से एक से अधिक व्यक्ति बढ़ जाती है के लिए एक ही मेडिकल रिकॉर्ड संख्या ( MRN ) बताए की संभावना। इसी प्रकार, प्रत्येक क्लीनिक में एक भी व्यक्ति नया पहचानकर्ता बताए के आरोप में होना चाहिए। मेडिकल रिकॉर्ड संख्या के लिए सामान्य प्रारूप 123MT -2 , 123 एक अनुक्रमिक संख्या है , जहां है <br/> <br/> , मीट्रिक टन का प्रतिनिधित्व करता है साइट विशेष प्रत्यय , और -2 की जांच अंकों है । नीचे, बस साइट शुरू अनुक्रम संख्या , और आप की जरूरत पहचानकर्ता की संख्या का चयन करें। ( उचित जांच अंक सहित ) मेडिकल रिकॉर्ड संख्या के साथ कोई टेक्स्ट फाइल उत्पन्न होता है और आपके कंप्यूटर पर डाउनलोड <br/> <br/> नोट किया जाएगा । यह एक सेवा थोक में उचित जांच अंक उत्पन्न मात्र है । यह इन नंबरों एक नियंत्रित केंद्रीय सत्ता के माध्यम से वितरित कर रहे हैं कि यह सुनिश्चित करना आपकी जिम्मेदारी है ? यानी, पहचानकर्ता एक मरीज को एक बार और केवल एक बार आवंटित कर रहे हैं ।
+MRNGenerator.log.view=देखें लॉग MRN लाने के
+MRNGenerator.log.hide=छिपाएँ लॉग MRN लाने के
+MRNGenerator.select.site=1. एक साइट का चयन करें
+MRNGenerator.starting.number=2. प्रारंभिक संख्या दर्ज करें
+MRNGenerator.prefix.number=3. एक उपसर्ग (वैकल्पिक) का चयन करें
+MRNGenerator.generate.number=4. MRNs की संख्या निर्दिष्ट उत्पन्न करने के लिए
+MRNGenerator.all.required=सभी मान आवश्यक है
+MRNGenerator.generate.identifiers=उत्पन्न ईदेन्तिफ़िएर्स
+MRNGenerator.date=उत्पन्न तिथि
+MRNGenerator.generator=जेनरेटर
+MRNGenerator.site=साइट
+MRNGenerator.first=प्रथम
+MRNGenerator.count=गिनती
+MRNGenerator.prefix=उपसर्ग
+
+AuditPatientIdentifiers.manage=लेखापरीक्षा रोगी पहचान की
+AuditPatientIdentifiers.link=अवैध चेक अंक हटाये 
+AuditPatientIdentifiers.description=hasCheckDigit झंडी दिखाकर रवाना किया जाता है, तो 4 ( अमान्य चेक अंक) टाइप करने के लिए 
+Maintenance.header=रखरखाव
+QuickReport.manage=त्वरित रिपोर्ट देखें
+QuickReport.type=रिपोर्ट प्रकार
+QuickReport.type.returnVisit=इस सप्ताह दुबारा आने की तिथि
+QuickReport.type.attendedClinic=भाग लिया क्लिनिक इस सप्ताह
+QuickReport.type.voidedObs=अवलोकन खाली किया
+QuickReport.startDate=प्रारंभ दिनांक
+QuickReport.endDate=समाप्ति तिथि
+QuickReport.location=स्थान
+QuickReport.location.all=सभी स्थान
+QuickReport.date=तिथि रिपोर्ट
+QuickReport.view=उत्पन्न रिपोर्ट
+
+Scheduler.title=प्रबंधित समयबद्धक
+Scheduler.header=समयबद्धक
+ Scheduler.taskList.title=उपलब्ध कार्य
+Scheduler.taskList.active=सक्रिय
+Scheduler.taskList.add=जोड़ें टास्क
+Scheduler.taskList.delete=हटाएँ
+Scheduler.taskList.start=प्रारंभ
+Scheduler.taskList.stop=बंद 
+Scheduler.taskList.deleted=(ओं) टास्क {0} नष्ट <br/>
+Scheduler.taskList.started=कार्य शुरू कर दिया गया है {0} <br/>
+Scheduler.taskList.stopped=टास्क {0} <br/> बंद कर दिया गया है
+Scheduler.taskList.deleteNotAllowed=यह नष्ट किया जा सकता से पहले कार्य {0} रोका जाना चाहिए । <br/>
+Scheduler.taskList.refresh=ताज़ा कार्य
+Scheduler.taskList.error=प्रसंस्करण कार्य त्रुटि <br/>
+Scheduler.taskList.requireTask=आप एक क्रिया बटन क्लिक करने से पहले एक कार्य का चयन करना होगा
+Scheduler.taskForm.title=टास्क प्रपत्र
+Scheduler.taskForm.legend=टास्क विन्यास
+Scheduler.taskForm.cancel=रद्द
+Scheduler.taskForm.class=अनुसूची में सक्षम क्लास
+Scheduler.taskForm.edit=संपादित करें
+Scheduler.taskForm.schedules=अनुसूची
+Scheduler.taskForm.save=सहेजें
+Scheduler.taskForm.saved=टास्क {0} <br/> बचा लिया गया है
+Scheduler.list.status स्थिति=
+Scheduler.list.taskClass=कार्य / कक्षा
+Scheduler.list.schedule=अनुसूची 
+Scheduler.list.lastExecutionTime=अंतिम निष्पादन समय
+Scheduler.list.startOnStartup=स्टार्टअप पर 
+Scheduler.list.started=आरंभ 
+Scheduler.list.runsAgainIn=<strong> में फिर से चलाता है {0} </ strong>
+Scheduler.list.stopped=रूका
+Scheduler.list.runsEvery=हर <strong> {0}  </ strong> रन
+Scheduler.list.from=<strong> से {0} </ strong>
+Scheduler.list.startingOn=<strong> पर शुरू {0} </ strong>
+Scheduler.list.manual=पुस्तिका
+Scheduler.list.automatic=स्वत:
 
 # Fields 
 #Scheduler.taskForm.id
-Scheduler.taskForm.required={0} क्षेत्र जरूरी है.
-Scheduler.taskForm.illegalAccessException=वर्ग पर अवैध उपयोग अपवाद [{0}].
-Scheduler.taskForm.instantiationException=त्रुटि वर्ग [{0}].
-Scheduler.taskForm.classNotFoundException=कक्षा [{0}] नहीं पाया जा सका. युद्ध फ़ाइल और / या [{0}] वर्ग के लिए मॉड्यूल की जाँच करें.
-Scheduler.taskForm.classDoesNotImplementTask=कक्षा [{0}] [{1}] इंटरफ़ेस को लागू नहीं करता है.
-
-Scheduler.scheduleForm.title=अनुसूची प्रपत्र
-Scheduler.scheduleForm.legend=अनुसूची
-Scheduler.scheduleForm.instructions=कृपया ध्यान दें: \ नीचे अनुसूची में परिवर्तन कार्य उदाहरण है कि पहले से ही चल रहे हैं पर नहीं पारित कर रहे हैं. अपने परिवर्तनों को सहेजने के बाद, आप बंद / कार्य सूची पृष्ठ पर वांछित कार्य शुरू करने में उस कार्य पर इन समय परिवर्तन के पास करने के लिए करना चाहिए.
-Scheduler.scheduleForm.started=आरंभ
-Scheduler.scheduleForm.startOnStartup=स्टार्टअप पर प्रारंभ 
-Scheduler.scheduleForm.startTimePattern=प्रारंभ समय पैटर्न
-Scheduler.scheduleForm.startTime=प्रारंभ समय
-Scheduler.scheduleForm.lastExecutionTime=अंतिम निष्पादन समय
-Scheduler.scheduleForm.repeatInterval=अंतराल दोहराएँ
+Scheduler.taskForm.required={0} क्षेत्र जरूरी है.
+Scheduler.taskForm.illegalAccessException=वर्ग पर अवैध उपयोग अपवाद [{0}].
+Scheduler.taskForm.instantiationException=त्रुटि वर्ग [{0}].
+Scheduler.taskForm.classNotFoundException=कक्षा [{0}] नहीं पाया जा सका. युद्ध फ़ाइल और / या [{0}] वर्ग के लिए मॉड्यूल की जाँच करें.
+Scheduler.taskForm.classDoesNotImplementTask=कक्षा [{0}] [{1}] इंटरफ़ेस को लागू नहीं करता है.
+
+Scheduler.scheduleForm.title=अनुसूची प्रपत्र
+Scheduler.scheduleForm.legend=अनुसूची
+Scheduler.scheduleForm.instructions=कृपया ध्यान दें: \ नीचे अनुसूची में परिवर्तन कार्य उदाहरण है कि पहले से ही चल रहे हैं पर नहीं पारित कर रहे हैं. अपने परिवर्तनों को सहेजने के बाद, आप बंद / कार्य सूची पृष्ठ पर वांछित कार्य शुरू करने में उस कार्य पर इन समय परिवर्तन के पास करने के लिए करना चाहिए.
+Scheduler.scheduleForm.started=आरंभ
+Scheduler.scheduleForm.startOnStartup=स्टार्टअप पर प्रारंभ 
+Scheduler.scheduleForm.startTimePattern=प्रारंभ समय पैटर्न
+Scheduler.scheduleForm.startTime=प्रारंभ समय
+Scheduler.scheduleForm.lastExecutionTime=अंतिम निष्पादन समय
+Scheduler.scheduleForm.repeatInterval=अंतराल दोहराएँ
  Scheduler.scheduleForm.startTime.pattern=MM / dd / yyyy Hh: mm: ss 
-Scheduler.scheduleForm.repeatInterval.units.seconds=दुरुपयोग की
-Scheduler.scheduleForm.repeatInterval.units.minutes=मिनट
-Scheduler.scheduleForm.repeatInterval.units.hours=घंटे
-Scheduler.scheduleForm.repeatInterval.units.days=दिन
-Scheduler.scheduleForm.save=सहेजें
-Scheduler.scheduleForm.add=जोड़ें
-Scheduler.scheduleForm.edit=संपादित करें
-Scheduler.scheduleForm.delete=हटाएँ
-Scheduler.scheduleForm.cancel=रद्द
-
-Scheduler.propertyForm.title=गुण 
-Scheduler.propertyForm.legend=गुण
-Scheduler.propertyForm.save=सहेजें
-Scheduler.propertyForm.add=जोड़ें संपत्ति
-Scheduler.propertyForm.remove=हटाएँ
-
-Program.header=कार्यक्रम
-Program.manage=प्रबंधन कार्यक्रम
-Program.manage.title=कार्यक्रम
-Program.addEdit.title=कार्यक्रम बनाएँ / संपादित करें
-Program.add=एक नया कार्यक्रम
- Program.list.title=वर्तमान कार्यक्रम
-Program.saved=कार्यक्रम सुरक्षित
-Program.concept=संकल्पना
-Program.conceptHint=(अवधारणा है कि इस कार्यक्रम का प्रतिनिधित्व करता है यानी पहले से ही आप इस शब्दकोश में इस अवधारणा को बनाया जाना चाहिए.)
-Program.outcomes=द्वारा परिभाषित संभावित परिणाम
-Program.outcome=परिणाम
-Program.outcome.choose=एक परिणाम चुनें ..
-Program.save=सहेजें
-Program.workflows=वर्कफ़्लोज़
-Program.workflow=कार्यप्रवाह
-Program.workflows.empty=नहीं उपलब्ध वर्कफ़्लोज़
-Program.title=कार्यक्रम
-Program.notEnrolledInAny=किसी भी कार्यक्रम में दाखिला नहीं
-Program.program=कार्यक्रम
-Program.location=स्थान
-Program.location.choose=स्थान चुनें.
-Program.dateEnrolled=नामांकन तिथि
-Program.dateCompleted=पूरा करने की तिथि
-Program.completed=पूरा
-Program.stillEnrolled=अभी भी नामांकित
-Program.completeButton=पूरी
-Program.enrollIn=में दाखिला लिया
-Program.choose=एक कार्यक्रम चुनें ...
-Program.enrollButton=दाखिला लिया
-Program.hiv=एचआईवी कार्यक्रमों
-Program.tb=टीबी कार्यक्रम
-Program.enrolled=नामांकित
-Program.group=समूह
-Program.agent=ऑकोम्पग्नतेउर
-Program.error.already=रोगी पहले से ही है कि कार्यक्रम में समय अवधि के दौरान आप अनिर्दिष्ट दाखिला
-Program.error.enrollmentDateRequired=नामांकन की तारीख की आवश्यकता है
-Program.error.programRequired=कार्यक्रम की आवश्यकता है
-Program.states=राज्य अमेरिका
-Program.state=राज्य
-Program.conversion.manage=प्रबंधन उत्प्रेरित हो जाओ राज्य रूपांतरण
-Program.conversion.saved=उत्प्रेरित हो जाओ राज्य रूपांतरण सहेज लिया गया है
-Program.conversion.manage.title=उत्प्रेरित हो जाओ राज्य रूपांतरण
-Program.conversion.programWorkflow=इस कार्यप्रवाह में
-Program.conversion.concept=इस अवधारणा
-Program.conversion.programWorkflowState=ट्रिगर इस राज्य के लिए रूपांतरण
-Program.conversion.list.title=वर्तमान राज्य रूपांतरण उत्प्रेरित हो जाओ
-Program.conversion.add=जोड़ें नए राज्य रूपांतरण
-Program.conversion.save=इस राज्य रूपांतरण सहेजें
-Program.conversion=उत्प्रेरित हो जाओ राज्य रूपांतरण
-Program.conversion.nonedeleted=नहीं उत्प्रेरित हो जाओ राज्य रूपांतरण को नष्ट कर दिया
-Program.conversion.deleteSelected=हटाएँ चयनित उत्प्रेरित हो जाओ राज्य रूपांतरण (ओं)
-Program.initialStates=प्रारंभिक राज्य अमेरिका
-Program.error.invalidDate=एक पूरा होने की तारीख एक नामांकन की तारीख से पहले नहीं हो सकता
-Program.delete=कार्यक्रम चयनित हटाना ( ओं)
-Program.nonedeleted=कार्यक्रम में से कोई भी नही हटाए गए
-
-PatientProgram.error.outcomeRequired=रोगी परिणाम पूरा होने की तारीख तय की है जब आवश्यक है
-
-Workflow.saved=कार्यप्रवाह बचाया
-
-State.state=राज्य
-State.initial=प्रारंभिक
-State.terminal=टर्मिनल
-State.select=एक राज्य का चयन करें
-State.list.title=वर्तमान राज्य ( ओं)
-State.error.name.duplicate=राज्य में पहले से ही मौजूद है
-State.retire.confirmation=आप इस राज्य रिटायर करना चाहते हैं आप यकीन कर रहे हैं?
-State.delete.confirmation=आप इस राज्य को नष्ट करना चाहते हैं आप यकीन कर रहे हैं?
-State.unretire.confirmation=आप इस राज्य unretire करना चाहते हैं आप यकीन कर रहे हैं?
-State.error.noDate=तुम एक बदलाव दिनांक देने के बिना एक गैर-शून्य राज्य से बदल नहीं सकते
-State.error.noState=आप एक राज्य का चयन करना होगा
-State.error.invalidChangeState=आप पहले से ही एक अंतिम तिथि है कि एक राज्य से बाहर नहीं बदल सकते हैं
-State.error.invalidDate=उस राज्य शुरू होने से पहले आप एक राज्य से बाहर नहीं बदल सकते हैं
-
-PatientState.error.endDateCannotBeBeforeStartDate=उस राज्य शुरू होने से पहले आप एक राज्य से बाहर नहीं बदल सकते हैं
-PatientState.error.duplicatePatientStates=इसी तरह के प्रारंभ दिनांक और कार्यक्रम काम प्रवाह राज्यों के साथ मिला डुप्लीकेट रोगी राज्यों
-PatientState.error.requiredField={0}एक मरीज को राज्य के लिए आवश्यक है
-
-PatientProgram.error.cannotBeInMultipleStates=एक मरीज को एक ही कार्यक्रम काम के प्रवाह के लिए कई रोगी राज्यों में नहीं हो सकता
-PatientProgram.error.foundOverlappingStates=आरंभ तिथि समाप्ति तिथि के साथ '{0 }' गोद पर एक और राज्य '{ 1 }' में एक ही कार्यक्रम काम के प्रवाह के साथ रोगी राज्य
-PatientState.error.invalidPatientState=मिला अमान्य रोगी राज्य: {0}
-
-PatientSet.noPatients=इस सेट में कोई रोगियों
-PatientSet.setOfN=रोगियों के सेट {0}
-PatientSet.stillLoading=रोगी अभी भी सेट लोड हो रहा है ...
-PatientSet.yours Y=<br> ओ <br> यू <br> r <br> <br> जी <br> r <br> ओ <br> यू <br> पी <br>
+Scheduler.scheduleForm.repeatInterval.units.seconds=दुरुपयोग की
+Scheduler.scheduleForm.repeatInterval.units.minutes=मिनट
+Scheduler.scheduleForm.repeatInterval.units.hours=घंटे
+Scheduler.scheduleForm.repeatInterval.units.days=दिन
+Scheduler.scheduleForm.save=सहेजें
+Scheduler.scheduleForm.add=जोड़ें
+Scheduler.scheduleForm.edit=संपादित करें
+Scheduler.scheduleForm.delete=हटाएँ
+Scheduler.scheduleForm.cancel=रद्द
+
+Scheduler.propertyForm.title=गुण 
+Scheduler.propertyForm.legend=गुण
+Scheduler.propertyForm.save=सहेजें
+Scheduler.propertyForm.add=जोड़ें संपत्ति
+Scheduler.propertyForm.remove=हटाएँ
+
+Program.header=कार्यक्रम
+Program.manage=प्रबंधन कार्यक्रम
+Program.manage.title=कार्यक्रम
+Program.addEdit.title=कार्यक्रम बनाएँ / संपादित करें
+Program.add=एक नया कार्यक्रम
+ Program.list.title=वर्तमान कार्यक्रम
+Program.saved=कार्यक्रम सुरक्षित
+Program.concept=संकल्पना
+Program.conceptHint=(अवधारणा है कि इस कार्यक्रम का प्रतिनिधित्व करता है यानी पहले से ही आप इस शब्दकोश में इस अवधारणा को बनाया जाना चाहिए.)
+Program.outcomes=द्वारा परिभाषित संभावित परिणाम
+Program.outcome=परिणाम
+Program.outcome.choose=एक परिणाम चुनें ..
+Program.save=सहेजें
+Program.workflows=वर्कफ़्लोज़
+Program.workflow=कार्यप्रवाह
+Program.workflows.empty=नहीं उपलब्ध वर्कफ़्लोज़
+Program.title=कार्यक्रम
+Program.notEnrolledInAny=किसी भी कार्यक्रम में दाखिला नहीं
+Program.program=कार्यक्रम
+Program.location=स्थान
+Program.location.choose=स्थान चुनें.
+Program.dateEnrolled=नामांकन तिथि
+Program.dateCompleted=पूरा करने की तिथि
+Program.completed=पूरा
+Program.stillEnrolled=अभी भी नामांकित
+Program.completeButton=पूरी
+Program.enrollIn=में दाखिला लिया
+Program.choose=एक कार्यक्रम चुनें ...
+Program.enrollButton=दाखिला लिया
+Program.hiv=एचआईवी कार्यक्रमों
+Program.tb=टीबी कार्यक्रम
+Program.enrolled=नामांकित
+Program.group=समूह
+Program.agent=ऑकोम्पग्नतेउर
+Program.error.already=रोगी पहले से ही है कि कार्यक्रम में समय अवधि के दौरान आप अनिर्दिष्ट दाखिला
+Program.error.enrollmentDateRequired=नामांकन की तारीख की आवश्यकता है
+Program.error.programRequired=कार्यक्रम की आवश्यकता है
+Program.states=राज्य अमेरिका
+Program.state=राज्य
+Program.conversion.manage=प्रबंधन उत्प्रेरित हो जाओ राज्य रूपांतरण
+Program.conversion.saved=उत्प्रेरित हो जाओ राज्य रूपांतरण सहेज लिया गया है
+Program.conversion.manage.title=उत्प्रेरित हो जाओ राज्य रूपांतरण
+Program.conversion.programWorkflow=इस कार्यप्रवाह में
+Program.conversion.concept=इस अवधारणा
+Program.conversion.programWorkflowState=ट्रिगर इस राज्य के लिए रूपांतरण
+Program.conversion.list.title=वर्तमान राज्य रूपांतरण उत्प्रेरित हो जाओ
+Program.conversion.add=जोड़ें नए राज्य रूपांतरण
+Program.conversion.save=इस राज्य रूपांतरण सहेजें
+Program.conversion=उत्प्रेरित हो जाओ राज्य रूपांतरण
+Program.conversion.nonedeleted=नहीं उत्प्रेरित हो जाओ राज्य रूपांतरण को नष्ट कर दिया
+Program.conversion.deleteSelected=हटाएँ चयनित उत्प्रेरित हो जाओ राज्य रूपांतरण (ओं)
+Program.initialStates=प्रारंभिक राज्य अमेरिका
+Program.error.invalidDate=एक पूरा होने की तारीख एक नामांकन की तारीख से पहले नहीं हो सकता
+Program.delete=कार्यक्रम चयनित हटाना ( ओं)
+Program.nonedeleted=कार्यक्रम में से कोई भी नही हटाए गए
+
+PatientProgram.error.outcomeRequired=रोगी परिणाम पूरा होने की तारीख तय की है जब आवश्यक है
+
+Workflow.saved=कार्यप्रवाह बचाया
+
+State.state=राज्य
+State.initial=प्रारंभिक
+State.terminal=टर्मिनल
+State.select=एक राज्य का चयन करें
+State.list.title=वर्तमान राज्य ( ओं)
+State.error.name.duplicate=राज्य में पहले से ही मौजूद है
+State.retire.confirmation=आप इस राज्य रिटायर करना चाहते हैं आप यकीन कर रहे हैं?
+State.delete.confirmation=आप इस राज्य को नष्ट करना चाहते हैं आप यकीन कर रहे हैं?
+State.unretire.confirmation=आप इस राज्य unretire करना चाहते हैं आप यकीन कर रहे हैं?
+State.error.noDate=तुम एक बदलाव दिनांक देने के बिना एक गैर-शून्य राज्य से बदल नहीं सकते
+State.error.noState=आप एक राज्य का चयन करना होगा
+State.error.invalidChangeState=आप पहले से ही एक अंतिम तिथि है कि एक राज्य से बाहर नहीं बदल सकते हैं
+State.error.invalidDate=उस राज्य शुरू होने से पहले आप एक राज्य से बाहर नहीं बदल सकते हैं
+
+PatientState.error.endDateCannotBeBeforeStartDate=उस राज्य शुरू होने से पहले आप एक राज्य से बाहर नहीं बदल सकते हैं
+PatientState.error.duplicatePatientStates=इसी तरह के प्रारंभ दिनांक और कार्यक्रम काम प्रवाह राज्यों के साथ मिला डुप्लीकेट रोगी राज्यों
+PatientState.error.requiredField={0}एक मरीज को राज्य के लिए आवश्यक है
+
+PatientProgram.error.cannotBeInMultipleStates=एक मरीज को एक ही कार्यक्रम काम के प्रवाह के लिए कई रोगी राज्यों में नहीं हो सकता
+PatientProgram.error.foundOverlappingStates=आरंभ तिथि समाप्ति तिथि के साथ '{0 }' गोद पर एक और राज्य '{ 1 }' में एक ही कार्यक्रम काम के प्रवाह के साथ रोगी राज्य
+PatientState.error.invalidPatientState=मिला अमान्य रोगी राज्य: {0}
+
+PatientSet.noPatients=इस सेट में कोई रोगियों
+PatientSet.setOfN=रोगियों के सेट {0}
+PatientSet.stillLoading=रोगी अभी भी सेट लोड हो रहा है ...
+PatientSet.yours Y=<br> ओ <br> यू <br> r <br> <br> जी <br> r <br> ओ <br> यू <br> पी <br>
 PatientSet.drop=x
 
 Units.kg=kg
@@ -2301,503 +2301,503 @@ Units.cm=cm
 Units.m=m
 Units.in=in
 
-Cohort.manage=प्रबंधन साथियों
-Cohort.manage.title=प्रबंधित साथियों
-Cohort.manage.deleteInstructions=करने के लिए साथियों को नष्ट, ऊपर बॉक्स (ते) की जाँच करें, और एक कारण दे:
-Cohort.title.endUser=पलटन सहेजा गया
-Cohort.title=पलटन 
-Cohort.ageAndGender=आयु और लिंग
-Cohort.hivEnrollments=एचआईवी कार्यक्रम नामांकन
-Cohort.count=गिनती
-Cohort.belongs.title=पलटन सदस्यता
-Cohort.belongsNone=किसी भी साथियों से संबंधित नहीं है
-Cohort.belongsTo=संबंधित
-Cohort.add=जोड़ें
-Cohort.add.cohort=इस रोगी को जोड़ें:
-Cohort.ofN=पलटन{0} रोगियों के 
-Cohort.summary=पलटन सारांश <i> ({0} रोगियों) </ i>
-Cohort.save.nameRequired=पलटन नाम की आवश्यकता है
-Cohort.save.descriptionRequired=पलटन वर्णन आवश्यक है
-
-Shortcut.singlePatient=व्यक्तिगत मरीजों
-Shortcut.projectManagement=परियोजना प्रबंधन
-Shortcut.projectManagement.go=जाओ
-
-PatientSearch.searchOnName=रोगी के नाम का हिस्सा पर खोज करें.
-PatientSearch.noneFound=रोगियों नहीं पाया.
-
-ObsSearch.findOrEdit=अवलोकन / संपादन (ओं)
-ObsSearch.noneFound=नहीं टिप्पणियों पाया.
-ObsSearch.byPersonAndConcept=व्यक्ति और संकल्पना द्वारा 
-ObsSearch.byEncounter=मुठभेड़ द्वारा 
-ObsSearch.results=खोज परिणाम
-ObsSearch.patientLabel=प्रकार एक व्यक्ति का नाम या रोगी पहचानकर्ता नीचे एक व्यक्ति के लिए खोज करने के लिए
-ObsSearch.conceptLabel=एक अवधारणा के नीचे नाम एक अवधारणा के लिए खोज प्रकार
-ObsSearch.encounterLabel=प्रकार के एक रोगी का नाम या पहचानकर्ता, या एक मुठभेड़ आईडी एक मुठभेड़ के लिए खोज करने के लिए
-
-Summary.generateSummaries=रोगी सारांश
-Summary.title=Inshuti म्यू रोगी नैदानिक ​​सारांश Buzima
-Summary.problemList समस्या=सूची
-Summary.currentDrugOrders=सक्रिय दवा आदेश
-Summary.pastDrugOrders=विगत औषध आदेश
-Summary.allergies=एलर्जी
-Summary.labResults=लैब परिणाम
-Summary.vitalSigns=महत्वपूर्ण लक्षण
-Summary.cxrFindings=CXR निष्कर्ष 
-Summary.alerts=अलर्ट
-Summary.alert.noCd4In6Months=चेतावनी: इस मरीज पिछले 6 महीनों में कोई CD4 परिणाम है <br />
-Summary.alert.noCxr=चेतावनी: इस मरीज कोई CXR परिणाम है <br />
-
-BatchEntry.title=बैच प्रविष्टि
-
-Missing.start=पेज
-Missing.end=पाया नहीं जा सकता. लिंक की जाँच करें और फिर कोशिश करें.
-
-Portlet.addressLayout.error=त्रुटि! अज्ञात का आकार: {0} पोर्टलेट पते मे 
-
-Portlet.cohort.male=पुरुष
-Portlet.cohort.female=महिला
-Portlet.cohort.viewMethod=देखें विधि:
-Portlet.cohort.viewMethod.list=सूची
-Portlet.cohort.viewMethod.other=अन्य तरीकों अभी तक लागू नहीं कर रहे हैं
-
-Portlet.findPatient.error=त्रुटि! अज्ञात आकार: {0}  इन्द्नेअतिएन्तिद्गेत    में
-
-Portlet.nameLayout.error=त्रुटि! अज्ञात आकार: {0}  नाम पोर्टलेट  में
-
-Portlet.patientEncounter.allEncounter=सभी सामने
-Portlet.patientEncounter.form=फार्म
-
-PostHl7.error=त्रुटि {0}
-PostHl7.missingAuthentication=दोनों 'उपयोगकर्ता नाम' और 'पासवर्ड' मापदंडों प्रमाणीकरण के लिए आवश्यक हैं.
-PostHl7.sourceAndhl7MessageParametersRequired=दोनों 'स्रोत' और 'hl7Message' मापदंडों संदेश प्रस्तुत करने के लिए आवश्यक हैं
-Hl7Messages.header=HL7 संदेश
-
-Hl7inError.title=प्रबंधित HL7 त्रुटियाँ
-Hl7inError.header=HL7 त्रुटियाँ
-Hl7inError.errorList.source.header=स्रोत
-Hl7inError.errorList.data.header=HL7 डेटा
-Hl7inError.errorList.error.header=त्रुटि
-Hl7inError.errorList.errorDetails.header=त्रुटि विवरण
-Hl7inError.errorList.dateCreated.header=तिथि बनाया
- Hl7inError.errorList.title=HL7s त्रुटि कतार में
-Hl7inError.errorList.restore=पुनः सबमिट करें
-Hl7inError.errorList.restored=संदेश {0} सफलतापूर्वक प्रसंस्करण के लिए पंक्तिबद्ध
-Hl7inError.errorList.error=प्रसंस्करण के लिए त्रुटि लाइन मद {0}
-Hl7inError.errorList.showDetails=त्रुटि विवरण देखें 
-
-Hl7inQueue.header=HL7 कतार
-Hl7inQueue.pending.title=पंक्तिबद्ध डाक
-Hl7inQueue.held.title=आयोजित पोस्ट प्रबंधित
-Hl7inQueue.queueList.source.हेअदर=स्रोत
-Hl7inQueue.queueList.data.header=HL7 डेटा
-Hl7inQueue.queueList.dateCreated=तिथि बनाया
-Hl7inQueue.queueList.pending.title=पंक्तिबद्ध HL7 संदेश
-Hl7inQueue.queueList.hold=पकड़ पर प्लेस
-Hl7inQueue.queueList.held={0} कतार आइटम आयोजित
-Hl7inQueue.queueList.held.title=धारित HL7 संदेश
-Hl7inQueue.queueList.restore=पुनर्स्थापित
-Hl7inQueue.queueList.restored={0} बहाल कतार आइटम
-Hl7inQueue.queueList.error=अद्यतन करने के पूंछ आइटम त्रुटि
-Hl7inQueue.queueList.showMore=ज्यादा &raquo;
-Hl7inQueue.queueList.hideMore=&laquo; काम 
-
-Hl7inQueue.status.0=लंबित
-Hl7inQueue.status.1=प्रसंस्करण
-Hl7inQueue.status.2=संसाधित
-Hl7inQueue.status.3=त्रुटि
-Hl7inQueue.status.4=नष्ट कर दिया
-Hl7.proposed.concept.name.empty=प्रस्तावित अवधारणा के लिए कोई नाम निर्दिष्ट
-
-Hl7InArchive.title=प्रबंधित HL7 अभिलेखागार
-Hl7InArchive.header=HL7 अभिलेखागार
-Hl7InArchive.migrate.title=HL7 अभिलेखागार को माइग्रेट करें
-Hl7InArchive.migrate.header=HL7 अभिलेखागार प्रवासन
-Hl7InArchive.migrate.alert=प्रवासन आवश्यक
-Hl7InArchive.migrate.start=प्रारंभ प्रवासन
-Hl7InArchive.migrate.stop=स्टॉप प्रवासन
-Hl7InArchive.migrate.days.kept=रखने के दिन
-Hl7InArchive.migrate.days.kept.error=&larr; सकारात्मक पूर्णांक की आवश्यकता
-Hl7InArchive.migrate.warning.message=प्रारंभ बटन पर क्लिक दिखाया स्थान में फाइल सिस्टम के लिए डेटाबेस से HL7 अभिलेखागार के हस्तांतरण शुरू कर देंगे। <b> hl7_in_archive </b> तालिका डेटाबेस में होना काफी बड़ी है। यह आपको जारी रखने से पीछे <b> hl7_in_queue </b> और <b> hl7_in_archive </b> के टेबल से पहले की सिफारिश की है । तुम्हें छोड़कर प्रक्रिया चलाता है के रूप में बाद में इस पृष्ठ पर लौट सकते हैं।
-Hl7InArchive.migrate.stop.success=प्रवासन सफलतापूर्वक बंद कर दिया
-Hl7InArchive.migrate.complete.all=पूर्ण, सभी अभिलेखागार सफलतापूर्वक का तबादला
-Hl7InArchive.migrate.complete.not.all=पूर्ण, लेकिन कुछ अभिलेखागार नहीं स्थानांतरित कर दिया गया है
-Hl7InArchive.migrate.number.transferred.label=अभिलेखागार के संख्या का तबादला
-Hl7InArchive.migrate.status.label=माइग्रेशन स्थिति
-Hl7InArchive.migrate.running=रनिंग 
-Hl7InArchive.migrate.start.fail=माइग्रेशन प्रारंभ करने में विफल!
-Hl7InArchive.migrate.error=एक त्रुटि हुई और माइग्रेशन बंद कर दिया गया है, जानकारी के लिए लॉग देखने
-Hl7InArchive.migrate.authentication.fail=आपका सत्र समाप्त हो गया है या आप पर्याप्त विशेषाधिकार नहीं है इस प्रक्रिया को चलाने!
-Hl7InArchive.migrate.already.running=किसी और पहले से ही इस प्रक्रिया चल रहा है, कृपया प्रतीक्षा करें ...
-Hl7InArchive.migrate.stopped=प्रवासन बंद कर दिया गया है
-Hl7InArchive.migrate.archives.dir=अभिलेखागार फ़ोल्डर स्थान
-
-Hl7Source.title=HL7 स्रोत
-HL7Source.save=सहेजें HL7 स्रोत
-HL7Source.purgeHL7Source=शुद्ध HL7 स्रोत
-Hl7Source.manage.title=प्रबंधित HL7 सूत्रों का कहना है
-Hl7Source.add=जोड़ें स्रोत HL7
-Hl7Source.list.title=वर्तमान HL7 सूत्रों का कहना है 
-Tribe.manage=प्रबंधन जनजातियों
-Tribe.module.message=जनजाति विशेषता नहीं रह कोर डाटा मॉडल का एक हिस्सा है । कार्यक्षमता को पुनर्स्थापित करने के लिए " जनजाति मॉड्यूल" स्थापित करें। < देखें <br> <br> एक href="https://dev.openmrs.org/modules/view.jsp?module=tribe">https://dev.openmrs.org/modules/view.jsp?module=tribe</a> मॉड्यूल डाउनलोड करने के लिए ।
-
-list.empty=खाली सूची
-
-DatabaseChangesInfo.title=डेटाबेस में परिवर्तन
-DatabaseChangesInfo.help=यह सभी डेटाबेस अद्यतन उस डेटाबेस पर चलाया जा रहा है की एक सूची है. आवेदन करने के लिए हर अद्यतन के साथ की जरूरत है.
-DatabaseChangesInfo.header=सभी वर्तमान परिवर्तन
-DatabaseChangesInfo.overview=डेटाबेस में परिवर्तन देखें
-DatabaseChangesInfo.comments=टिप्पणियाँ
-DatabaseChangesInfo.runDate=भागो तिथि
-DatabaseChangesInfo.runStatus=भागो स्थिति
-DatabaseChangesInfo.filename.title=चेतावनी और संदेश डेटाबेस अद्यतन के दौरान उत्पन्न नीचे फाइल करने के लिए लिखा जाता है:
-
-SearchResults.resultsFor=के लिए परिणाम
-SearchResults.resultsNotDisplayed=अधिक नहीं प्रदर्शित परिणाम 
-SearchResults.viewing=देखने 
-SearchResults.of=के
-SearchResults.minCharactersPhrase1=आप कम से कम होना चाहिए
-SearchResults.minCharactersPhrase2=खोज वर्ण
-SearchResults.noWildcards=वाइल्डकार्ड वर्णों के बिना एक वैध रोगी का नाम दर्ज करें
-SearchResults.noWildcardsAllowed=वाइल्डकार्ड वर्ण रोगी खोजों में की अनुमति नहीं है
-SearchResults.includeVerbose=शामिल वर्बोज़
-SearchResults.includeVoided=शामिल खाली 
-SearchResults.includeRetired=शामिल सेवानिवृत्त
-SearchResults.includeDisabled=विक्लांग शामिल
-
-FormEntry.fillOutForm=पर्चा दर्ज
-FormEntry.noModulesInstalled=आपका व्यवस्थापक एक अद्यतन रूप प्रविष्टि मॉड्यूल स्थापित नहीं किया
-error.name.max.length={0} मान बहुत लंबा है. अधिकतम लंबाई {1} है.
-
-ViewCurrentUsers.list=देखें उपयोगकर्ताओं में लॉग इन
-ViewCurrentUsers.title=उपयोगकर्ताओं में लॉग इन
-ViewCurrentUsers.help=उपयोगकर्ताओं को, जो वर्तमान सिस्टम में लॉग इन कर रहे हैं की सूची देखें.
-ViewCurrentUsers.users=उपयोगकर्ता
-
-ActiveLists.resolve=निकालें
-ActiveLists.date=तिथि 
-ActiveLists.actions=प्रक्रिया
-ActiveLists.startDate=प्रारंभ दिनांक
-ActiveLists.endDate=समाप्ति तिथि 
-ActiveLists.resolvedOn=पर निकाला गया
-ActiveLists.allergy.title=एलर्जी
-ActiveLists.allergy.add=जोड़ें एलर्जी
-ActiveLists.allergy.edit=संपादित करें एलर्जी
+Cohort.manage=प्रबंधन साथियों
+Cohort.manage.title=प्रबंधित साथियों
+Cohort.manage.deleteInstructions=करने के लिए साथियों को नष्ट, ऊपर बॉक्स (ते) की जाँच करें, और एक कारण दे:
+Cohort.title.endUser=पलटन सहेजा गया
+Cohort.title=पलटन 
+Cohort.ageAndGender=आयु और लिंग
+Cohort.hivEnrollments=एचआईवी कार्यक्रम नामांकन
+Cohort.count=गिनती
+Cohort.belongs.title=पलटन सदस्यता
+Cohort.belongsNone=किसी भी साथियों से संबंधित नहीं है
+Cohort.belongsTo=संबंधित
+Cohort.add=जोड़ें
+Cohort.add.cohort=इस रोगी को जोड़ें:
+Cohort.ofN=पलटन{0} रोगियों के 
+Cohort.summary=पलटन सारांश <i> ({0} रोगियों) </ i>
+Cohort.save.nameRequired=पलटन नाम की आवश्यकता है
+Cohort.save.descriptionRequired=पलटन वर्णन आवश्यक है
+
+Shortcut.singlePatient=व्यक्तिगत मरीजों
+Shortcut.projectManagement=परियोजना प्रबंधन
+Shortcut.projectManagement.go=जाओ
+
+PatientSearch.searchOnName=रोगी के नाम का हिस्सा पर खोज करें.
+PatientSearch.noneFound=रोगियों नहीं पाया.
+
+ObsSearch.findOrEdit=अवलोकन / संपादन (ओं)
+ObsSearch.noneFound=नहीं टिप्पणियों पाया.
+ObsSearch.byPersonAndConcept=व्यक्ति और संकल्पना द्वारा 
+ObsSearch.byEncounter=मुठभेड़ द्वारा 
+ObsSearch.results=खोज परिणाम
+ObsSearch.patientLabel=प्रकार एक व्यक्ति का नाम या रोगी पहचानकर्ता नीचे एक व्यक्ति के लिए खोज करने के लिए
+ObsSearch.conceptLabel=एक अवधारणा के नीचे नाम एक अवधारणा के लिए खोज प्रकार
+ObsSearch.encounterLabel=प्रकार के एक रोगी का नाम या पहचानकर्ता, या एक मुठभेड़ आईडी एक मुठभेड़ के लिए खोज करने के लिए
+
+Summary.generateSummaries=रोगी सारांश
+Summary.title=Inshuti म्यू रोगी नैदानिक ​​सारांश Buzima
+Summary.problemList समस्या=सूची
+Summary.currentDrugOrders=सक्रिय दवा आदेश
+Summary.pastDrugOrders=विगत औषध आदेश
+Summary.allergies=एलर्जी
+Summary.labResults=लैब परिणाम
+Summary.vitalSigns=महत्वपूर्ण लक्षण
+Summary.cxrFindings=CXR निष्कर्ष 
+Summary.alerts=अलर्ट
+Summary.alert.noCd4In6Months=चेतावनी: इस मरीज पिछले 6 महीनों में कोई CD4 परिणाम है <br />
+Summary.alert.noCxr=चेतावनी: इस मरीज कोई CXR परिणाम है <br />
+
+BatchEntry.title=बैच प्रविष्टि
+
+Missing.start=पेज
+Missing.end=पाया नहीं जा सकता. लिंक की जाँच करें और फिर कोशिश करें.
+
+Portlet.addressLayout.error=त्रुटि! अज्ञात का आकार: {0} पोर्टलेट पते मे 
+
+Portlet.cohort.male=पुरुष
+Portlet.cohort.female=महिला
+Portlet.cohort.viewMethod=देखें विधि:
+Portlet.cohort.viewMethod.list=सूची
+Portlet.cohort.viewMethod.other=अन्य तरीकों अभी तक लागू नहीं कर रहे हैं
+
+Portlet.findPatient.error=त्रुटि! अज्ञात आकार: {0}  इन्द्नेअतिएन्तिद्गेत    में
+
+Portlet.nameLayout.error=त्रुटि! अज्ञात आकार: {0}  नाम पोर्टलेट  में
+
+Portlet.patientEncounter.allEncounter=सभी सामने
+Portlet.patientEncounter.form=फार्म
+
+PostHl7.error=त्रुटि {0}
+PostHl7.missingAuthentication=दोनों 'उपयोगकर्ता नाम' और 'पासवर्ड' मापदंडों प्रमाणीकरण के लिए आवश्यक हैं.
+PostHl7.sourceAndhl7MessageParametersRequired=दोनों 'स्रोत' और 'hl7Message' मापदंडों संदेश प्रस्तुत करने के लिए आवश्यक हैं
+Hl7Messages.header=HL7 संदेश
+
+Hl7inError.title=प्रबंधित HL7 त्रुटियाँ
+Hl7inError.header=HL7 त्रुटियाँ
+Hl7inError.errorList.source.header=स्रोत
+Hl7inError.errorList.data.header=HL7 डेटा
+Hl7inError.errorList.error.header=त्रुटि
+Hl7inError.errorList.errorDetails.header=त्रुटि विवरण
+Hl7inError.errorList.dateCreated.header=तिथि बनाया
+ Hl7inError.errorList.title=HL7s त्रुटि कतार में
+Hl7inError.errorList.restore=पुनः सबमिट करें
+Hl7inError.errorList.restored=संदेश {0} सफलतापूर्वक प्रसंस्करण के लिए पंक्तिबद्ध
+Hl7inError.errorList.error=प्रसंस्करण के लिए त्रुटि लाइन मद {0}
+Hl7inError.errorList.showDetails=त्रुटि विवरण देखें 
+
+Hl7inQueue.header=HL7 कतार
+Hl7inQueue.pending.title=पंक्तिबद्ध डाक
+Hl7inQueue.held.title=आयोजित पोस्ट प्रबंधित
+Hl7inQueue.queueList.source.हेअदर=स्रोत
+Hl7inQueue.queueList.data.header=HL7 डेटा
+Hl7inQueue.queueList.dateCreated=तिथि बनाया
+Hl7inQueue.queueList.pending.title=पंक्तिबद्ध HL7 संदेश
+Hl7inQueue.queueList.hold=पकड़ पर प्लेस
+Hl7inQueue.queueList.held={0} कतार आइटम आयोजित
+Hl7inQueue.queueList.held.title=धारित HL7 संदेश
+Hl7inQueue.queueList.restore=पुनर्स्थापित
+Hl7inQueue.queueList.restored={0} बहाल कतार आइटम
+Hl7inQueue.queueList.error=अद्यतन करने के पूंछ आइटम त्रुटि
+Hl7inQueue.queueList.showMore=ज्यादा &raquo;
+Hl7inQueue.queueList.hideMore=&laquo; काम 
+
+Hl7inQueue.status.0=लंबित
+Hl7inQueue.status.1=प्रसंस्करण
+Hl7inQueue.status.2=संसाधित
+Hl7inQueue.status.3=त्रुटि
+Hl7inQueue.status.4=नष्ट कर दिया
+Hl7.proposed.concept.name.empty=प्रस्तावित अवधारणा के लिए कोई नाम निर्दिष्ट
+
+Hl7InArchive.title=प्रबंधित HL7 अभिलेखागार
+Hl7InArchive.header=HL7 अभिलेखागार
+Hl7InArchive.migrate.title=HL7 अभिलेखागार को माइग्रेट करें
+Hl7InArchive.migrate.header=HL7 अभिलेखागार प्रवासन
+Hl7InArchive.migrate.alert=प्रवासन आवश्यक
+Hl7InArchive.migrate.start=प्रारंभ प्रवासन
+Hl7InArchive.migrate.stop=स्टॉप प्रवासन
+Hl7InArchive.migrate.days.kept=रखने के दिन
+Hl7InArchive.migrate.days.kept.error=&larr; सकारात्मक पूर्णांक की आवश्यकता
+Hl7InArchive.migrate.warning.message=प्रारंभ बटन पर क्लिक दिखाया स्थान में फाइल सिस्टम के लिए डेटाबेस से HL7 अभिलेखागार के हस्तांतरण शुरू कर देंगे। <b> hl7_in_archive </b> तालिका डेटाबेस में होना काफी बड़ी है। यह आपको जारी रखने से पीछे <b> hl7_in_queue </b> और <b> hl7_in_archive </b> के टेबल से पहले की सिफारिश की है । तुम्हें छोड़कर प्रक्रिया चलाता है के रूप में बाद में इस पृष्ठ पर लौट सकते हैं।
+Hl7InArchive.migrate.stop.success=प्रवासन सफलतापूर्वक बंद कर दिया
+Hl7InArchive.migrate.complete.all=पूर्ण, सभी अभिलेखागार सफलतापूर्वक का तबादला
+Hl7InArchive.migrate.complete.not.all=पूर्ण, लेकिन कुछ अभिलेखागार नहीं स्थानांतरित कर दिया गया है
+Hl7InArchive.migrate.number.transferred.label=अभिलेखागार के संख्या का तबादला
+Hl7InArchive.migrate.status.label=माइग्रेशन स्थिति
+Hl7InArchive.migrate.running=रनिंग 
+Hl7InArchive.migrate.start.fail=माइग्रेशन प्रारंभ करने में विफल!
+Hl7InArchive.migrate.error=एक त्रुटि हुई और माइग्रेशन बंद कर दिया गया है, जानकारी के लिए लॉग देखने
+Hl7InArchive.migrate.authentication.fail=आपका सत्र समाप्त हो गया है या आप पर्याप्त विशेषाधिकार नहीं है इस प्रक्रिया को चलाने!
+Hl7InArchive.migrate.already.running=किसी और पहले से ही इस प्रक्रिया चल रहा है, कृपया प्रतीक्षा करें ...
+Hl7InArchive.migrate.stopped=प्रवासन बंद कर दिया गया है
+Hl7InArchive.migrate.archives.dir=अभिलेखागार फ़ोल्डर स्थान
+
+Hl7Source.title=HL7 स्रोत
+HL7Source.save=सहेजें HL7 स्रोत
+HL7Source.purgeHL7Source=शुद्ध HL7 स्रोत
+Hl7Source.manage.title=प्रबंधित HL7 सूत्रों का कहना है
+Hl7Source.add=जोड़ें स्रोत HL7
+Hl7Source.list.title=वर्तमान HL7 सूत्रों का कहना है 
+Tribe.manage=प्रबंधन जनजातियों
+Tribe.module.message=जनजाति विशेषता नहीं रह कोर डाटा मॉडल का एक हिस्सा है । कार्यक्षमता को पुनर्स्थापित करने के लिए " जनजाति मॉड्यूल" स्थापित करें। < देखें <br> <br> एक href="https://dev.openmrs.org/modules/view.jsp?module=tribe">https://dev.openmrs.org/modules/view.jsp?module=tribe</a> मॉड्यूल डाउनलोड करने के लिए ।
+
+list.empty=खाली सूची
+
+DatabaseChangesInfo.title=डेटाबेस में परिवर्तन
+DatabaseChangesInfo.help=यह सभी डेटाबेस अद्यतन उस डेटाबेस पर चलाया जा रहा है की एक सूची है. आवेदन करने के लिए हर अद्यतन के साथ की जरूरत है.
+DatabaseChangesInfo.header=सभी वर्तमान परिवर्तन
+DatabaseChangesInfo.overview=डेटाबेस में परिवर्तन देखें
+DatabaseChangesInfo.comments=टिप्पणियाँ
+DatabaseChangesInfo.runDate=भागो तिथि
+DatabaseChangesInfo.runStatus=भागो स्थिति
+DatabaseChangesInfo.filename.title=चेतावनी और संदेश डेटाबेस अद्यतन के दौरान उत्पन्न नीचे फाइल करने के लिए लिखा जाता है:
+
+SearchResults.resultsFor=के लिए परिणाम
+SearchResults.resultsNotDisplayed=अधिक नहीं प्रदर्शित परिणाम 
+SearchResults.viewing=देखने 
+SearchResults.of=के
+SearchResults.minCharactersPhrase1=आप कम से कम होना चाहिए
+SearchResults.minCharactersPhrase2=खोज वर्ण
+SearchResults.noWildcards=वाइल्डकार्ड वर्णों के बिना एक वैध रोगी का नाम दर्ज करें
+SearchResults.noWildcardsAllowed=वाइल्डकार्ड वर्ण रोगी खोजों में की अनुमति नहीं है
+SearchResults.includeVerbose=शामिल वर्बोज़
+SearchResults.includeVoided=शामिल खाली 
+SearchResults.includeRetired=शामिल सेवानिवृत्त
+SearchResults.includeDisabled=विक्लांग शामिल
+
+FormEntry.fillOutForm=पर्चा दर्ज
+FormEntry.noModulesInstalled=आपका व्यवस्थापक एक अद्यतन रूप प्रविष्टि मॉड्यूल स्थापित नहीं किया
+error.name.max.length={0} मान बहुत लंबा है. अधिकतम लंबाई {1} है.
+
+ViewCurrentUsers.list=देखें उपयोगकर्ताओं में लॉग इन
+ViewCurrentUsers.title=उपयोगकर्ताओं में लॉग इन
+ViewCurrentUsers.help=उपयोगकर्ताओं को, जो वर्तमान सिस्टम में लॉग इन कर रहे हैं की सूची देखें.
+ViewCurrentUsers.users=उपयोगकर्ता
+
+ActiveLists.resolve=निकालें
+ActiveLists.date=तिथि 
+ActiveLists.actions=प्रक्रिया
+ActiveLists.startDate=प्रारंभ दिनांक
+ActiveLists.endDate=समाप्ति तिथि 
+ActiveLists.resolvedOn=पर निकाला गया
+ActiveLists.allergy.title=एलर्जी
+ActiveLists.allergy.add=जोड़ें एलर्जी
+ActiveLists.allergy.edit=संपादित करें एलर्जी
 ActiveLists.allergy.allergen=Allergen
-ActiveLists.allergy.type=प्रकार
-ActiveLists.allergy.severity=गंभीरता
-ActiveLists.allergy.reaction=रिएक्शन
-ActiveLists.allergy.resolveTitle=हटाएँ एलर्जी
-ActiveLists.allergy.showRemoved दिखाएँ=एलर्जी इतिहास
-ActiveLists.allergy.hideRemoved=छिपाएँ एलर्जी इतिहास
-ActiveLists.allergy.removedAllergies=निकाला गया एलर्जी
-ActiveLists.allergy.allergenRequired=Allergen की आवश्यकता है
-ActiveLists.problem.title=समस्या सूची
-ActiveLists.problem.add=जोड़ें समस्या
-ActiveLists.problem.edit=संपादित करें समस्या
-ActiveLists.problem.problem=समस्या
-ActiveLists.problem.status=संशोधक
-ActiveLists.problem.comments=टिप्पणियाँ
-ActiveLists.problem.resolveTitle=निकालें समस्या
-ActiveLists.problem.resolved=के रूप में निकालें
-ActiveLists.problem.showRemoved दिखाएँ=समस्या इतिहास
-ActiveLists.problem.hideRemoved=छिपाएँ समस्या इतिहास
-ActiveLists.problem.removedProblem=समस्याएं निकाला गया
-ActiveLists.resolve.error=डेटा प्रविष्टि त्रुटि (इस प्रविष्टि को हटाता है)
-ActiveLists.removed.remove=सूची (इतिहास में रहता है) से निकालें
-ActiveLists.problem.problemRequired=समस्या की आवश्यकता
-
-LocalesAndThemes.view.title=स्थलों और थीम्स
-LocalesAndThemes.titlebar=स्थलों और थीम्स
- LocalesAndThemes.locale=डिफ़ॉल्ट स्थान
-LocalesAndThemes.locale.help=यह अभी तक अपने स्वयं के स्थान के लिए चुना नहीं है कि उपयोगकर्ताओं को दी स्थान है। "की अनुमति स्थानों " में से एक हो सकता है और के रूप में करना चाहिए en, en_GB, or es
-LocalesAndThemes.theme=डिफ़ॉल्ट थीम
-LocalesAndThemes.theme.help=यह लग रहा है और अपने स्वयं के विषय को चुना नहीं है कि उपयोगकर्ताओं के लिए लग रहा है। OpenMRS "नारंगी ", " बैंगनी ", " हरी" , और " विरासत" प्रदान करता है
-LocalesAndThemes.manage=प्रबंधन स्थलों और थीम्स
-LocalesAndThemes.saved=वातावरण और विषय सफलतापूर्वक बचाया
-LocalesAndThemes.localeError=लोकेल "की अनुमति स्थानों " में स्थानों में से एक होने की स्थापना करनी चाहिए
-LocalesAndThemes.locale.isRequired=स्थान आवश्यक है
-
-footer.poweredBy=OpenMRS द्वारा संचालित
-footer.lastBuild=अंतिम गठन
-footer.version=संस्करण
-
-Customizable.error.inAttributes=एक विशेषता में त्रुटि
-
-Visit.header=दौरा
-Visit.voidedMessage=इस भेंट खाली किया गया था
-Visit.error.patient.required=रोगी आईडी की आवश्यकता है
-Visit.error.visitType.required=भेंट प्रकार की आवश्यकता है
-Visit.error.startDate.required=प्रारंभ दिनांक आवश्यक है
-Visit.failedToAddEncounter=मुठभेड़ जोड़ने में विफल
-Visit.failedToRemoveEncounter=मुठभेड़ हटाने में विफल
-Visit.error.endDateBeforeStartDate=स्टॉप तिथि प्रारंभ तिथि से पहले नहीं हो सकता
-Visit.void.error=यात्रा को हटाने का प्रयास करते समय त्रुटि
-Visit.unvoid.error=त्रुटि के लिए यात्रा को बहाल करने का प्रयास करते समय
-Visit.save.error=जबकि यात्रा बचाने के प्रयास में त्रुटि
-Visit.purge.error=यात्रा शुद्ध करने का प्रयास करते समय त्रुटि
-Visit.purged=भेंट रिक्त करे गयी
-Visit.end=समाप्ति भेंट
-Visit.enterEndDate=यात्रा के अंत दिनांक दर्ज
-Visit.voided=हटाए गए
-Visit.unvoided=लौटी जाएँ
-Visit.saved=विज़िट सहेजा गया
-Visit.purge.inUse=एक यात्रा कि इससे जुड़े मुठभेड़ों है शुद्ध नहीं कर सकते हैं
-Visit.confirm.removeMessage=आप इस फार्म को भरते हैं या नहीं मुठभेड़ आपको तुरंत आप इसे हटाना चाहते हैं , भले ही हटा दिया हो जाएगी ?
-Visit.confirm.addMessage=आप इस फार्म को भरते हैं या नहीं मुठभेड़ आपको तुरंत आप इसे जोड़ने की इच्छा रखते हैं , की परवाह किए बिना जोड़ा मिलेगा ?
-Visit.edit=संपादित करें भेंट
-Visit.add=भेंट जोड़ें
-Visit.details=भेंट विवरण 
-Visit.encounters=भेंट मुठभेड़ों
-Visit.addEncounter=मुठभेड़ भेंट जोड़ें
-Visit.addEncounterToVisit=सक्रिय {0} यात्रा में जोड़ने के लिए मुठभेड़ चुनें:
-Visit=विजिट
-Visit.start=प्रारंभ करें भेंट
-Visit.confirm.purge=शुद्ध भेंट पुष्टि
-Visit.confirm.purgeMessage=यह कार्रवाई अपरिवर्तनीय है, तो आप यकीन है कि आप पूरी तरह से इस यात्रा को निकालना चाहते हैं?
-Visit.confirm.addEncounter=जोड़ें मुठभेड़ पुष्टि
-Visit.confirm.removeEncounter=हटाएँ मुठभेड़ पुष्टि
-Visit.visitType=भेंट प्रकार
-Visit.location=स्थान
-Visit.from=से
-Visit.to=को
-Visit.startDatetime=प्रारंभ Datetime
-Visit.stopDatetime=स्टॉप Datetime
-Visit.enterer=दर्ज किया
-Visit.indication=संकेत
-Visit.none=नहीं देखा
-Visit.optionalReason=कारण ( वैकल्पिक)
-Visit.active.label=सक्रिय भेंट
-Visit.startedOnDatetime=में शुरू
-Visit.attributes=भेंट गुण
-Visit.endNow=अब यात्रा समाप्त करें
-Visit.ended=विजिट <b>{0}</b> समाप्त
-Visit.startCannotBeTheSameAsOtherStartDateOfTheSamePatient=एक ही समय में दो अलग-अलग यात्राओं शुरू नहीं कर सकते हैं।
-Visit.startDateCannotFallIntoAnotherVisitOfTheSamePatient=इस यात्रा में एक ही मरीज ​​की एक और यात्रा में गिर जाता है कि एक शुरुआत की तारीख है ।
-Visit.stopDateCannotFallIntoAnotherVisitOfTheSamePatient=इस यात्रा में एक ही मरीज ​​की एक और यात्रा में गिर जाता है कि एक बंद तिथि है ।
-Visit.visitCannotContainAnotherVisitOfTheSamePatient=इसकी शुरुआत तारीख अन्य यात्रा की शुरुआत की तारीख से पहले है और इसकी रोक तारीख अन्य यात्रा का पड़ाव तिथि के बाद है यानी यह यात्रा , एक ही मरीज की एक और यात्रा में शामिल है।
-Visit.encountersCannotBeBeforeStartDate=जिसकी तारीखें यात्रा की शुरुआत से पहले कर रहे हैं मुठभेड़ों नहीं हो सकते।
-Visit.encountersCannotBeAfterStopDate=जिसकी तारीखें यात्रा की रोक के बाद कर रहे हैं मुठभेड़ों नहीं हो सकते।
-Visit.find.encounters.error=मुठभेड़ों दिलकश या सर्वर से कनेक्ट नहीं हो सका है, जबकि एक त्रुटि हुई
-VisitId.cannotBeNull=भेंट ईद रिक्त नहीं हो सकता
-Visit.encounters.notAssignedToVisit=एक यात्रा करने के लिए नहीं सौंपा मुठभेड़ों
-Visit.configure=यात्राओं को विन्यस्त
-Visit.viewEncounters=देखें मुठभेड़ों
-Visit.hideEncounters=छुपाएं मुठभेड़ों
-Visit.clickToViewEncounters=मुठभेड़ों देखने के लिए क्लिक करें
-Visit.clickToHideEncounters=मुठभेड़ों को छिपाने के लिए क्लिक करें
-Visit.noVisitAssigned=सौंपा कोई यात्रा
-Visit.cannotPurgeVisitWithEncounters=स्थायी रूप से इसे करने के लिए जुड़े मुठभेड़ों है कि एक यात्रा के नष्ट नहीं कर सकते
-Visit.encounter.search.placeholder=मुठभेड़ आईडी , प्रदाता पहचानकर्ता , स्थान , रूप, मुठभेड़ प्रकार या प्रदाता नाम दर्ज करें।
-
-Visit.type.retired=सेवानिवृत्त
-Visit.configure.startCloseVisitsTask=ऑटो करीब यात्राओं कार्य प्रारंभ
-Visit.configure.closeVisitsTask.failedToStart=कार्य प्रारंभ करने में विफल
-Visit.configure.closeVisitsTask.failedToStop=कार्य को रोकने में नाकाम
-Visit.configure.visitTypesToClose=ऑटो बंद करने के लिए प्रकार की सैर
-
-Visit.assignmentHandler.noAssignment=स्वचालित रूप से दौरा करने के लिए मुठभेड़ों नहीं असाइन
-visit.assignmentHandler.assignToExistingVisitOnly=अगर एक मौजूद एक उपयुक्त यात्रा (एक ही स्थान , यात्रा के दौरान मुठभेड़ तारीख) के लिए आवंटित है, लेकिन नए यात्राओं पैदा नहीं करते
-visit.assignmentHandler.assignToExistingVisitOrNew=अगर एक मौजूद एक उपयुक्त यात्रा (एक ही स्थान , यात्रा के दौरान मुठभेड़ तारीख) के लिए आवंटित । कोई उपयुक्त एक मौजूद है, तो एक नई यात्रा बना
-
-VisitType.manage=भेंट प्रबंधन के प्रकार
-VisitType.title=भेंट प्रकार
-VisitType.manage.title=भेंट प्रकार प्रबंधन
-VisitType.list.title=वर्तमान भेंट प्रकार
-VisitType.save=सहेजें भेंट प्रकार
-VisitType.add=जोड़ें भेंट प्रकार
-VisitType.retireVisitType=भेंट प्रकार रिटायर
-VisitType.purgeVisitType=शुद्ध भेंट प्रकार
-VisitType.saved=भेंट बचाया प्रकार
-VisitType.purgedSuccessfully=भेंट प्रकार सफलतापूर्वक हटाये गए
-VisitType.retiredSuccessfully=भेंट प्रकार सफलतापूर्वक सेवानिवृत्त
-VisitType.unretiredSuccessfully=भेंट प्रकार सफलतापूर्वक unretired
-VisitType.purgeConfirmMessage=क्या आप सुनिश्चित करें कि आप इस यात्रा के प्रकार शुद्ध करना चाहते हैं? यह स्थायी रूप से प्रणाली से हटा दिया जाएगा.
-Visit.search.error=का दौरा करने के खोजने का प्रयास करते समय त्रुटि
-attribute.error.minOccurs=विशेषता {0} सबसे {1} समय पर हो सकता है
-attribute.error.maxOccurs=विशेषता {0} सबसे कम { 1} बार हो सकता है
-attribute.error.invalid=के लिए अवैध मान "{ 0}"
-
-VisitAttributeType.manage=भेंट एट्रीब्यूट प्रबंधित करें
-VisitAttributeType.title=गुण प्रकार भेंट
-VisitAttributeType.manage.title=भेंट गुण प्रकार प्रबंधन
-VisitAttributeType.list.title=वर्तमान भेंट एट्रीब्यूट
-VisitAttributeType.save=सहेजें भेंट गुण प्रकार
-VisitAttributeType.add=जोड़ें भेंट गुण प्रकार
-VisitAttributeType.retireVisitAttributeType=भेंट रिटायर प्रकार गुण
-VisitAttributeType.purgeVisitAttributeType=शुद्ध भेंट गुण प्रकार
-VisitAttributeType.saved=भेंट गुण प्रकार को बचाया
-VisitAttributeType.purgedSuccessfully=भेंट गुण प्रकार सफलतापूर्वक हटाया
-VisitAttributeType.retiredSuccessfully=भेंट गुण प्रकार सफलतापूर्वक सेवानिवृत्त
-VisitAttributeType.unretiredSuccessfully=भेंट गुण प्रकार सफलतापूर्वक अनसेनानिर्वित्र 
-VisitAttributeType.purgeConfirmMessage=क्या आप इस यात्रा विशेषता प्रकार शुद्ध करने के लिए चाहते हैं? यह स्थायी रूप से प्रणाली से हटा दिया जाएगा।
-VisitAttributeType.unretireVisitAttributeType=Unretire भेंट प्रकार की विशेषता
-
-Provider.header=प्रदाता
-Provider.manage=प्रदाता का प्रबंधन करें
-Provider.manage.title=प्रदाता प्रबंधन
-Provider.search=नाम या आईडी के पहचानकर्ता पर खोजें
-Provider.search.placeholder=प्रदाता नाम या पहचानकर्ता
-Provider.add=प्रदाता जोड़ें
-Provider.find=प्रदाता का पता लगाएं
-Provider.title=प्रदाता
-Provider.noMatchesFound=कोई मिलान नहीं मिला : <b>{0}</b>
-Provider.identifier=पहचानकर्ता
-Provider.providerName=प्रदाता
-Provider.search.error=त्रुटि प्रदाता खोजने का प्रयास करते समय
-Provider.name=प्रदाता का नाम
-Provider.create=प्रदाता बनाएँ
-Provider.edit=संपादित प्रदाता
-Provider.person=व्यक्ति का नाम
-Provider.save=सेव
-Provider.retire=रिटायर
+ActiveLists.allergy.type=प्रकार
+ActiveLists.allergy.severity=गंभीरता
+ActiveLists.allergy.reaction=रिएक्शन
+ActiveLists.allergy.resolveTitle=हटाएँ एलर्जी
+ActiveLists.allergy.showRemoved दिखाएँ=एलर्जी इतिहास
+ActiveLists.allergy.hideRemoved=छिपाएँ एलर्जी इतिहास
+ActiveLists.allergy.removedAllergies=निकाला गया एलर्जी
+ActiveLists.allergy.allergenRequired=Allergen की आवश्यकता है
+ActiveLists.problem.title=समस्या सूची
+ActiveLists.problem.add=जोड़ें समस्या
+ActiveLists.problem.edit=संपादित करें समस्या
+ActiveLists.problem.problem=समस्या
+ActiveLists.problem.status=संशोधक
+ActiveLists.problem.comments=टिप्पणियाँ
+ActiveLists.problem.resolveTitle=निकालें समस्या
+ActiveLists.problem.resolved=के रूप में निकालें
+ActiveLists.problem.showRemoved दिखाएँ=समस्या इतिहास
+ActiveLists.problem.hideRemoved=छिपाएँ समस्या इतिहास
+ActiveLists.problem.removedProblem=समस्याएं निकाला गया
+ActiveLists.resolve.error=डेटा प्रविष्टि त्रुटि (इस प्रविष्टि को हटाता है)
+ActiveLists.removed.remove=सूची (इतिहास में रहता है) से निकालें
+ActiveLists.problem.problemRequired=समस्या की आवश्यकता
+
+LocalesAndThemes.view.title=स्थलों और थीम्स
+LocalesAndThemes.titlebar=स्थलों और थीम्स
+ LocalesAndThemes.locale=डिफ़ॉल्ट स्थान
+LocalesAndThemes.locale.help=यह अभी तक अपने स्वयं के स्थान के लिए चुना नहीं है कि उपयोगकर्ताओं को दी स्थान है। "की अनुमति स्थानों " में से एक हो सकता है और के रूप में करना चाहिए en, en_GB, or es
+LocalesAndThemes.theme=डिफ़ॉल्ट थीम
+LocalesAndThemes.theme.help=यह लग रहा है और अपने स्वयं के विषय को चुना नहीं है कि उपयोगकर्ताओं के लिए लग रहा है। OpenMRS "नारंगी ", " बैंगनी ", " हरी" , और " विरासत" प्रदान करता है
+LocalesAndThemes.manage=प्रबंधन स्थलों और थीम्स
+LocalesAndThemes.saved=वातावरण और विषय सफलतापूर्वक बचाया
+LocalesAndThemes.localeError=लोकेल "की अनुमति स्थानों " में स्थानों में से एक होने की स्थापना करनी चाहिए
+LocalesAndThemes.locale.isRequired=स्थान आवश्यक है
+
+footer.poweredBy=OpenMRS द्वारा संचालित
+footer.lastBuild=अंतिम गठन
+footer.version=संस्करण
+
+Customizable.error.inAttributes=एक विशेषता में त्रुटि
+
+Visit.header=दौरा
+Visit.voidedMessage=इस भेंट खाली किया गया था
+Visit.error.patient.required=रोगी आईडी की आवश्यकता है
+Visit.error.visitType.required=भेंट प्रकार की आवश्यकता है
+Visit.error.startDate.required=प्रारंभ दिनांक आवश्यक है
+Visit.failedToAddEncounter=मुठभेड़ जोड़ने में विफल
+Visit.failedToRemoveEncounter=मुठभेड़ हटाने में विफल
+Visit.error.endDateBeforeStartDate=स्टॉप तिथि प्रारंभ तिथि से पहले नहीं हो सकता
+Visit.void.error=यात्रा को हटाने का प्रयास करते समय त्रुटि
+Visit.unvoid.error=त्रुटि के लिए यात्रा को बहाल करने का प्रयास करते समय
+Visit.save.error=जबकि यात्रा बचाने के प्रयास में त्रुटि
+Visit.purge.error=यात्रा शुद्ध करने का प्रयास करते समय त्रुटि
+Visit.purged=भेंट रिक्त करे गयी
+Visit.end=समाप्ति भेंट
+Visit.enterEndDate=यात्रा के अंत दिनांक दर्ज
+Visit.voided=हटाए गए
+Visit.unvoided=लौटी जाएँ
+Visit.saved=विज़िट सहेजा गया
+Visit.purge.inUse=एक यात्रा कि इससे जुड़े मुठभेड़ों है शुद्ध नहीं कर सकते हैं
+Visit.confirm.removeMessage=आप इस फार्म को भरते हैं या नहीं मुठभेड़ आपको तुरंत आप इसे हटाना चाहते हैं , भले ही हटा दिया हो जाएगी ?
+Visit.confirm.addMessage=आप इस फार्म को भरते हैं या नहीं मुठभेड़ आपको तुरंत आप इसे जोड़ने की इच्छा रखते हैं , की परवाह किए बिना जोड़ा मिलेगा ?
+Visit.edit=संपादित करें भेंट
+Visit.add=भेंट जोड़ें
+Visit.details=भेंट विवरण 
+Visit.encounters=भेंट मुठभेड़ों
+Visit.addEncounter=मुठभेड़ भेंट जोड़ें
+Visit.addEncounterToVisit=सक्रिय {0} यात्रा में जोड़ने के लिए मुठभेड़ चुनें:
+Visit=विजिट
+Visit.start=प्रारंभ करें भेंट
+Visit.confirm.purge=शुद्ध भेंट पुष्टि
+Visit.confirm.purgeMessage=यह कार्रवाई अपरिवर्तनीय है, तो आप यकीन है कि आप पूरी तरह से इस यात्रा को निकालना चाहते हैं?
+Visit.confirm.addEncounter=जोड़ें मुठभेड़ पुष्टि
+Visit.confirm.removeEncounter=हटाएँ मुठभेड़ पुष्टि
+Visit.visitType=भेंट प्रकार
+Visit.location=स्थान
+Visit.from=से
+Visit.to=को
+Visit.startDatetime=प्रारंभ Datetime
+Visit.stopDatetime=स्टॉप Datetime
+Visit.enterer=दर्ज किया
+Visit.indication=संकेत
+Visit.none=नहीं देखा
+Visit.optionalReason=कारण ( वैकल्पिक)
+Visit.active.label=सक्रिय भेंट
+Visit.startedOnDatetime=में शुरू
+Visit.attributes=भेंट गुण
+Visit.endNow=अब यात्रा समाप्त करें
+Visit.ended=विजिट <b>{0}</b> समाप्त
+Visit.startCannotBeTheSameAsOtherStartDateOfTheSamePatient=एक ही समय में दो अलग-अलग यात्राओं शुरू नहीं कर सकते हैं।
+Visit.startDateCannotFallIntoAnotherVisitOfTheSamePatient=इस यात्रा में एक ही मरीज ​​की एक और यात्रा में गिर जाता है कि एक शुरुआत की तारीख है ।
+Visit.stopDateCannotFallIntoAnotherVisitOfTheSamePatient=इस यात्रा में एक ही मरीज ​​की एक और यात्रा में गिर जाता है कि एक बंद तिथि है ।
+Visit.visitCannotOverlapAnotherVisitOfTheSamePatient=इसकी शुरुआत तारीख अन्य यात्रा की शुरुआत की तारीख से पहले है और इसकी रोक तारीख अन्य यात्रा का पड़ाव तिथि के बाद है यानी यह यात्रा , एक ही मरीज की एक और यात्रा में शामिल है।
+Visit.encountersCannotBeBeforeStartDate=जिसकी तारीखें यात्रा की शुरुआत से पहले कर रहे हैं मुठभेड़ों नहीं हो सकते।
+Visit.encountersCannotBeAfterStopDate=जिसकी तारीखें यात्रा की रोक के बाद कर रहे हैं मुठभेड़ों नहीं हो सकते।
+Visit.find.encounters.error=मुठभेड़ों दिलकश या सर्वर से कनेक्ट नहीं हो सका है, जबकि एक त्रुटि हुई
+VisitId.cannotBeNull=भेंट ईद रिक्त नहीं हो सकता
+Visit.encounters.notAssignedToVisit=एक यात्रा करने के लिए नहीं सौंपा मुठभेड़ों
+Visit.configure=यात्राओं को विन्यस्त
+Visit.viewEncounters=देखें मुठभेड़ों
+Visit.hideEncounters=छुपाएं मुठभेड़ों
+Visit.clickToViewEncounters=मुठभेड़ों देखने के लिए क्लिक करें
+Visit.clickToHideEncounters=मुठभेड़ों को छिपाने के लिए क्लिक करें
+Visit.noVisitAssigned=सौंपा कोई यात्रा
+Visit.cannotPurgeVisitWithEncounters=स्थायी रूप से इसे करने के लिए जुड़े मुठभेड़ों है कि एक यात्रा के नष्ट नहीं कर सकते
+Visit.encounter.search.placeholder=मुठभेड़ आईडी , प्रदाता पहचानकर्ता , स्थान , रूप, मुठभेड़ प्रकार या प्रदाता नाम दर्ज करें।
+
+Visit.type.retired=सेवानिवृत्त
+Visit.configure.startCloseVisitsTask=ऑटो करीब यात्राओं कार्य प्रारंभ
+Visit.configure.closeVisitsTask.failedToStart=कार्य प्रारंभ करने में विफल
+Visit.configure.closeVisitsTask.failedToStop=कार्य को रोकने में नाकाम
+Visit.configure.visitTypesToClose=ऑटो बंद करने के लिए प्रकार की सैर
+
+Visit.assignmentHandler.noAssignment=स्वचालित रूप से दौरा करने के लिए मुठभेड़ों नहीं असाइन
+visit.assignmentHandler.assignToExistingVisitOnly=अगर एक मौजूद एक उपयुक्त यात्रा (एक ही स्थान , यात्रा के दौरान मुठभेड़ तारीख) के लिए आवंटित है, लेकिन नए यात्राओं पैदा नहीं करते
+visit.assignmentHandler.assignToExistingVisitOrNew=अगर एक मौजूद एक उपयुक्त यात्रा (एक ही स्थान , यात्रा के दौरान मुठभेड़ तारीख) के लिए आवंटित । कोई उपयुक्त एक मौजूद है, तो एक नई यात्रा बना
+
+VisitType.manage=भेंट प्रबंधन के प्रकार
+VisitType.title=भेंट प्रकार
+VisitType.manage.title=भेंट प्रकार प्रबंधन
+VisitType.list.title=वर्तमान भेंट प्रकार
+VisitType.save=सहेजें भेंट प्रकार
+VisitType.add=जोड़ें भेंट प्रकार
+VisitType.retireVisitType=भेंट प्रकार रिटायर
+VisitType.purgeVisitType=शुद्ध भेंट प्रकार
+VisitType.saved=भेंट बचाया प्रकार
+VisitType.purgedSuccessfully=भेंट प्रकार सफलतापूर्वक हटाये गए
+VisitType.retiredSuccessfully=भेंट प्रकार सफलतापूर्वक सेवानिवृत्त
+VisitType.unretiredSuccessfully=भेंट प्रकार सफलतापूर्वक unretired
+VisitType.purgeConfirmMessage=क्या आप सुनिश्चित करें कि आप इस यात्रा के प्रकार शुद्ध करना चाहते हैं? यह स्थायी रूप से प्रणाली से हटा दिया जाएगा.
+Visit.search.error=का दौरा करने के खोजने का प्रयास करते समय त्रुटि
+attribute.error.minOccurs=विशेषता {0} सबसे {1} समय पर हो सकता है
+attribute.error.maxOccurs=विशेषता {0} सबसे कम { 1} बार हो सकता है
+attribute.error.invalid=के लिए अवैध मान "{ 0}"
+
+VisitAttributeType.manage=भेंट एट्रीब्यूट प्रबंधित करें
+VisitAttributeType.title=गुण प्रकार भेंट
+VisitAttributeType.manage.title=भेंट गुण प्रकार प्रबंधन
+VisitAttributeType.list.title=वर्तमान भेंट एट्रीब्यूट
+VisitAttributeType.save=सहेजें भेंट गुण प्रकार
+VisitAttributeType.add=जोड़ें भेंट गुण प्रकार
+VisitAttributeType.retireVisitAttributeType=भेंट रिटायर प्रकार गुण
+VisitAttributeType.purgeVisitAttributeType=शुद्ध भेंट गुण प्रकार
+VisitAttributeType.saved=भेंट गुण प्रकार को बचाया
+VisitAttributeType.purgedSuccessfully=भेंट गुण प्रकार सफलतापूर्वक हटाया
+VisitAttributeType.retiredSuccessfully=भेंट गुण प्रकार सफलतापूर्वक सेवानिवृत्त
+VisitAttributeType.unretiredSuccessfully=भेंट गुण प्रकार सफलतापूर्वक अनसेनानिर्वित्र 
+VisitAttributeType.purgeConfirmMessage=क्या आप इस यात्रा विशेषता प्रकार शुद्ध करने के लिए चाहते हैं? यह स्थायी रूप से प्रणाली से हटा दिया जाएगा।
+VisitAttributeType.unretireVisitAttributeType=Unretire भेंट प्रकार की विशेषता
+
+Provider.header=प्रदाता
+Provider.manage=प्रदाता का प्रबंधन करें
+Provider.manage.title=प्रदाता प्रबंधन
+Provider.search=नाम या आईडी के पहचानकर्ता पर खोजें
+Provider.search.placeholder=प्रदाता नाम या पहचानकर्ता
+Provider.add=प्रदाता जोड़ें
+Provider.find=प्रदाता का पता लगाएं
+Provider.title=प्रदाता
+Provider.noMatchesFound=कोई मिलान नहीं मिला : <b>{0}</b>
+Provider.identifier=पहचानकर्ता
+Provider.providerName=प्रदाता
+Provider.search.error=त्रुटि प्रदाता खोजने का प्रयास करते समय
+Provider.name=प्रदाता का नाम
+Provider.create=प्रदाता बनाएँ
+Provider.edit=संपादित प्रदाता
+Provider.person=व्यक्ति का नाम
+Provider.save=सेव
+Provider.retire=रिटायर
 Provider.unretire=Unretire
-Provider.saved=प्रदाता बचाया
-Provider.retired=प्रदाता सेवानिवृत्त
-Provider.unretired=प्रदाता unretired
-Provider.error.personOrName.required=प्रदाता नाम या व्यक्ति के लिए आवश्यक
-Provider.error.personAndName.provided=प्रदाता नाम या व्यक्ति के लिए आवश्यक है, लेकिन दोनों नहीं
-Provider.error.retireReason.required= कारण आवश्यक रिटायर करने के लिए
-Provider.error.identifier.required=पहचानकर्ता की आवश्यकता है
-Provider.attributes=प्रदाता गुण
-Provider.linkedToPerson=प्रदाता व्यक्ति से जुड़ा हुआ
-Provider.notLinkedToPerson=प्रदाता व्यक्ति से जुड़ा हुआ नहीं
-Provider.linkToPerson=व्यक्ति के लिए लिंक
-Provider.unLinkFromPerson=व्यक्ति से अनलिंक
-Provider.error.duplicateIdentifier=अन्य प्रदाता पहले से ही पहचानकर्ता है {0}
-
-ProviderAttributeType.manage=प्रदाता गुण प्रकार के प्रबंधन
-ProviderAttributeType.manage.title=प्रदाता गुण प्रकार प्रबंधन
-ProviderAttributeType.add=प्रदाता गुण प्रकार जोड़ें
-ProviderAttributeType.title=प्रदाता गुण प्रकार
-ProviderAttributeType.list.title=वर्तमान प्रदाता एट्रीब्यूट
-ProviderAttributeType.save=प्रदाता गुण प्रकार बचा
-ProviderAttributeType.saved=प्रदाता गुण प्रकार बचाया
-ProviderAttributeType.purgedSuccessfully=प्रदाता गुण प्रकार सफलतापूर्वक हमेशा के लिए हटा
-ProviderAttributeType.retiredSuccessfully=प्रदाता गुण प्रकार सफलतापूर्वक सेवानिवृत्त
-ProviderAttributeType.unretiredSuccessfully=प्रदाता गुण प्रकार सफलतापूर्वक unretired
-ProviderAttributeType.retireProviderAttributeType=प्रदाता गुण प्रकार रिटायर
-ProviderAttributeType.unretireProviderAttributeType=प्रदाता गुण प्रकार संयुक्त राष्ट्र के रिटायर
-ProviderAttributeType.purgeProviderAttributeType=हमेशा के लिए प्रकार की विशेषता प्रदाता हटाएं
-ProviderAttributeType.purgeConfirmMessage=प्रदाता गुण प्रकार सफलतापूर्वक हमेशा के लिए हटा
-
-AttributeType.datatype=डाटाटाइप
-AttributeType.datatypeClassname=डाटाटाइप
-AttributeType.datatypeConfig=डाटाटाइप विन्यास
-AttributeType.preferredHandlerClassname=पसंदीदा हैंडलर
-AttributeType.preferredHandlerClassname.wrongDatatype=डेटा प्रकार के लिए हैंडलर मान्य नहीं
-AttributeType.handlerConfig.invalid=अवैध विन्यास: {0}
-AttributeType.handlerConfig=हेन्डलर विन्यास
-AttributeType.minOccurs=न्यूनतम होता है
-AttributeType.maxOccurs=अधिकतम होता है
-AttributeType.minOccursShouldNotBeLessThanZero=न्यूनतम 0 से कम नहीं होना चाहिए
-AttributeType.maxOccursShouldNotBeLessThanZero=अधिकतम 0 से कम नहीं होना चाहिए
-AttributeType.maxOccursShouldNotBeLessThanMinOccurs=अधिकतम न्यूनतम से कम नहीं होना चाहिए
-
-AddressTemplate.Manage=पता खाका प्रबंधित
-AddressTemplate.saved=बचाया
-AddressTemplate.copy.form.wiki=प्रलेखन <br/> पृष्ठ पर उदाहरण के लेआउट देखें
-AddressTemplate.wiki.title=पता टेम्पलेट का प्रबंध
-AddressTemplate.error.empty= नहीं पता खाका पाया।
-AddressTemplate.error= पता टेम्पलेट अमान्य है।
-AddressTemplate.error.requiredAddressFieldIsBlank=आवश्यक पता फ़ील्ड {0} को खाली है ।
-AddressTemplate.error.fieldNotDeclaredInTemplate=फील्ड {0} टेम्पलेट में घोषित नहीं किया गया है ।
-AddressTemplate.error.elementInvalid=तत्व प्रकार " {0}" , मिलान अंत टैग द्वारा समाप्त किया जाना चाहिए लाइन में {1} ।
-AddressTemplate.error.nameOrValueInvalid=नाम या संपत्ति के मूल्य में याद आ रही है "{ 0}" ।
-AddressTemplate.error.wrongFieldName=फ़ील्ड नाम "{ 0}" गलत है।
-
-update.header.title=OpenMRS सर्वर रखरखाव मोड में है ।
-update.maintenance.login=जारी रखने के लिए {0} भूमिका है कि एक उपयोगकर्ता के रूप में लॉग ऑन करें।
-update.maintenance.username=OpenMRS यूजर का नाम
-update.review.desc=अद्यतन का विवरण
-update.review.auth=लेखक
-update.review.act=क्रियाएं
-
-update.warn=निम्न चेतावनी डेटाबेस Updater द्वारा उत्पन्न कर रहे थे , <br/> चेतावनियों से संबंधित किसी भी मुद्दे को ठीक करने और भविष्य में संदर्भ के लिए इस पेज को बचा लो।
-update.warn.saved=चेतावनियों और संदेशों के नीचे फ़ाइल को बचाया जा रहा है:
-update.warn.alert=इस मुद्दे रिकॉर्ड और यदि आवश्यक हो तो इसे ठीक ।
-
-update.warn.anotherUser=किसी अन्य उपयोगकर्ता पहले से ही डेटाबेस अद्यतन चल रहा है!
-update.warn.updatesRequired=निम्नलिखित डेटाबेस अद्यतन आवश्यक हैं :
-update.warn.updatesExecuted=निम्नलिखित डाटाबेस अपडेट निष्पादित किए जा रहे हैं :
-
-update.error.unableCompleteStartup=स्टार्टअप को पूरा करने में असमर्थ। पूरा stacktrace के लिए सर्वर त्रुटि लॉग देखें। {0}
-update.error.inpuNotImplemented=डेटाबेस अद्यतन दौरान इनपुट अभी तक लागू नहीं किया है । {0}
-update.error.unableUpdate=डेटाबेस को अद्यतन करने में असमर्थ। पूर्ण stacktrace के लिए सर्वर त्रुटि लॉग देखें।
-update.error.unableAuthenticate=सिस्टम डेवलपर भूमिका के साथ एक उपयोगकर्ता के रूप को प्रमाणित करने में असमर्थ। अमान्य उपयोगकर्ता नाम या पासवर्ड
-
-CustomDatatype.error.missingDatatype=[[ त्रुटि! डेटा प्रकार गुम : {0} ]]
-CustomDatatype.error.missingValue=[[ त्रुटि! लापता मूल्य के संदर्भ ]]
-
-org.openmrs.customdatatype.datatype.BooleanDatatype.name=बूलियन
-org.openmrs.customdatatype.datatype.BooleanDatatype.description=विन्यास इस्तेमाल नहीं किया है
-org.openmrs.customdatatype.datatype.DateDatatype.name=दिनांक
-org.openmrs.customdatatype.datatype.DateDatatype.description=विन्यास इस्तेमाल नहीं किया है
-org.openmrs.customdatatype.datatype.FreeTextDatatype.name=नि: शुल्क पाठ्य
-org.openmrs.customdatatype.datatype.FreeTextDatatype.description=विन्यास इस्तेमाल नहीं किया है
-org.openmrs.customdatatype.datatype.RegexValidatedTextDatatype.name=Regex मान्य पाठ
-org.openmrs.customdatatype.datatype.RegexValidatedTextDatatype.description=विन्यास जावा प्रारूप में एक regex होना चाहिए
-org.openmrs.customdatatype.datatype.LongFreeTextDatatype.name=लांग नि: शुल्क पाठ्य
-org.openmrs.customdatatype.datatype.LongFreeTextDatatype.description=विन्यास इस्तेमाल नहीं किया है
-org.openmrs.customdatatype.datatype.LongFreeTextDatatype.placeholderValue=[ लांग नि: शुल्क पाठ्य ]
-org.openmrs.customdatatype.datatype.SpecifiedTextOptionsDatatype.name=पाठ के विकल्प
-org.openmrs.customdatatype.datatype.SpecifiedTextOptionsDatatype.description=विन्यास इस्तेमाल नहीं किया है
-
-org.openmrs.web.attribute.handler.BooleanFieldGenDatatypeHandler.name=सही / गलत रेडियो
-org.openmrs.web.attribute.handler.BooleanFieldGenDatatypeHandler.description=विन्यास इस्तेमाल नहीं किया है
-org.openmrs.web.attribute.handler.DateFieldGenDatatypeHandler.name=कैलेंडर पॉपअप
-org.openmrs.web.attribute.handler.DateFieldGenDatatypeHandler.description=विन्यास इस्तेमाल नहीं किया है
-org.openmrs.web.attribute.handler.LongFreeTextTextareaHandler.name=(लंबे पाठ क्षेत्र के लिए) पाठ क्षेत्र
-org.openmrs.web.attribute.handler.LongFreeTextTextareaHandler.description=" पंक्तियाँ " और " कर्नल " विन्यस्त कर सकते हैं
-org.openmrs.web.attribute.handler.LongFreeTextFileUploadHandler.name=(लंबी पाठ क्षेत्रों के लिए ) फ़ाइल अपलोड करें
-org.openmrs.web.attribute.handler.LongFreeTextFileUploadHandler.description=विन्यास इस्तेमाल नहीं किया है
-org.openmrs.web.attribute.handler.SpecifiedTextOptionsDropdownHandler.name=ड्रॉप डाउन
-org.openmrs.web.attribute.handler.SpecifiedTextOptionsDropdownHandler.description=अल्पविराम के द्वारा अलग आइटम नीचे गिरा
-
-ORUR01.error.invalidMessage=ORU_R01 हैंडलर के लिए भेजा अवैध संदेश
-ORUR01.error.invalidMessageType=हैंडलर के लिए अमान्य संदेश लिखें। त्रुटि कास्टिंग {0}
-ORUR01.error.WhileProcessing=त्रुटि जबकि प्रसंस्करण ORU_R01 संदेश
-ORUR01.errorInvalidOBR=फार्म की OBS के खंड एक अवधारणा क्षेत्र है कि यह सुनिश्चित करने के लिए जाँच करें। यूआईडी के साथ HL7 संदेश में अवैध OBR : {0}
-ORUR01.error.improperlyFormattedOBX=का प्रारूप OBX : {0}
-ORUR01.error.relationshipCoding= NK1 सेगमेंट में संबंध कोडिंग प्रणाली {0} अज्ञात ।
-ORUR01.error.relationshipType=अनुचित तरीके से NK1 खंड में गठित रिश्ते के प्रकार {0}
-ORUR01.error.relationshipTypeNotFound=NK1 सेगमेंट में रिश्ते के प्रकार {0} नहीं मिला
-ORUR01.error.relativeNotCreated=NK1 खंड से एक नई रिश्तेदार नहीं बना सका
-ORUR01.error.notnumericConcept=न्यूमेरिक ( समुद्री मील ) मूल्य {0} अवधारणा # के लिए सांख्यिक नहीं है {1} ({ 2}) संदेश में {3}
-ORUR01.error.invalidAnswer={0} UUID साथ OBS के लिए एक वैध जवाब नहीं है {1}
-ORUR01.error.CannotSetBoolean=आईडी के साथ अवधारणा के लिए बूलियन अवधारणा जवाब सेट नहीं कर सकता {0}
-ORUR01.error.InvalidConceptId=OBX -5 मूल्य के लिए अमान्य अवधारणा आईडी { 0} {1}
-ORUR01.error.UpsupportedObsType=असमर्थित अवलोकन डेटा प्रकार {0}
-ORUR01.error.hl7ConceptId=यूआईडी के साथ HL7 संदेश में अवैध अवधारणा आईडी {0}:  {1}
-ORUR01.error.UnresolvedPatient=रोगी को हल नहीं किया जा सका
-ORUR01.error.UnresolvedLocation=स्थान का समाधान नहीं किया जा सका
-ORUR01.error.parseFormId=संदेश से फार्म आईडी पार्सिंग त्रुटि
-ORUR01.error.UnresolvedEnterer=दर्ज हल नहीं किया जा सका
-
-uncaughtException.title=एक आंतरिक त्रुटि हुई है
-uncaughtException.possibleCause=संभावित कारण
-uncaughtException.programmerError=: एक प्रोग्रामर एक त्रुटि बनाया है और एक विधि पर एक Transaction ( केवल पढ़ने = सच ) एनोटेशन शामिल करने के लिए भूल गया है।
-uncaughtException.help.text1=परामर्श करना
-uncaughtException.help.text2=दस्तावेज़ मदद करते हैं।
-uncaughtException.contact=यह हल नहीं किया जा सकता है अगर अपने दोस्ताना पड़ोस व्यवस्थापक से संपर्क करें ।
-uncaughtException.showStackTrace=दिखाएँ स्टैक ट्रेस
-uncaughtException.hideStackTrace=स्टैक ट्रेस छिपाने
-uncaughtException.stackTrace=स्टैक ट्रेस
-uncaughtException.logged.out=आप स्टैक ट्रेस देखने के लिए लॉग इन करना होगा
-uncaughtException.noErrorInfo=उपलब्ध नहीं त्रुटि जानकारी
-uncaughtException.bugFound=एक बग मिला ? भरें और नीचे के फार्म जमा करें - धन्यवाद - हमें OpenMRS बेहतर सॉफ्टवेयर बनाने में मदद!
-uncaughtException.subject=विषय:
-uncaughtException.subject.mandatory=विषय अनिवार्य है।
-uncaughtException.name=आपका नाम:
-uncaughtException.email=ई-मेल:
-uncaughtException.doing=इस त्रुटि हुई जब आप क्या कर रहे थे वर्णन करें :
-uncaughtException.additionalInfo=निम्न डेटा भी समस्या को हल करने के लिए टीम को सक्षम करने के लिए रिपोर्ट के साथ प्रस्तुत किया जाएगा।
-uncaughtException.additionalInfo.msg=त्रुटि संदेश और स्टैक ट्रेस
-uncaughtException.additionalInfo.version=OpenMRS संस्करण
-uncaughtException.additionalInfo.appNameAndVersion=अनुप्रयोग सर्वर का नाम और संस्करण
-uncaughtException.additionalInfo.username=उपयोगकर्ता का उपयोगकर्ता नाम वर्तमान में लॉग इन किया
-uncaughtException.additionalInfo.implementationId=इस स्थापना के कार्यान्वयन आईडी ( परिभाषित अगर )
-uncaughtException.additionalInfo.modules=सभी स्थापित मॉड्यूल का नाम और संस्करण
-
-OrderFrequency.concept.shouldBeClassFrequency=संकल्पना वर्ग फ्रीक्वेंसी की होनी चाहिए
-OrderFrequency.concept.shouldNotBeShared=केवल एक OrderFrequency एक विशेष अवधारणा के लिए मैप किया जाना चाहिए
+Provider.saved=प्रदाता बचाया
+Provider.retired=प्रदाता सेवानिवृत्त
+Provider.unretired=प्रदाता unretired
+Provider.error.personOrName.required=प्रदाता नाम या व्यक्ति के लिए आवश्यक
+Provider.error.personAndName.provided=प्रदाता नाम या व्यक्ति के लिए आवश्यक है, लेकिन दोनों नहीं
+Provider.error.retireReason.required= कारण आवश्यक रिटायर करने के लिए
+Provider.error.identifier.required=पहचानकर्ता की आवश्यकता है
+Provider.attributes=प्रदाता गुण
+Provider.linkedToPerson=प्रदाता व्यक्ति से जुड़ा हुआ
+Provider.notLinkedToPerson=प्रदाता व्यक्ति से जुड़ा हुआ नहीं
+Provider.linkToPerson=व्यक्ति के लिए लिंक
+Provider.unLinkFromPerson=व्यक्ति से अनलिंक
+Provider.error.duplicateIdentifier=अन्य प्रदाता पहले से ही पहचानकर्ता है {0}
+
+ProviderAttributeType.manage=प्रदाता गुण प्रकार के प्रबंधन
+ProviderAttributeType.manage.title=प्रदाता गुण प्रकार प्रबंधन
+ProviderAttributeType.add=प्रदाता गुण प्रकार जोड़ें
+ProviderAttributeType.title=प्रदाता गुण प्रकार
+ProviderAttributeType.list.title=वर्तमान प्रदाता एट्रीब्यूट
+ProviderAttributeType.save=प्रदाता गुण प्रकार बचा
+ProviderAttributeType.saved=प्रदाता गुण प्रकार बचाया
+ProviderAttributeType.purgedSuccessfully=प्रदाता गुण प्रकार सफलतापूर्वक हमेशा के लिए हटा
+ProviderAttributeType.retiredSuccessfully=प्रदाता गुण प्रकार सफलतापूर्वक सेवानिवृत्त
+ProviderAttributeType.unretiredSuccessfully=प्रदाता गुण प्रकार सफलतापूर्वक unretired
+ProviderAttributeType.retireProviderAttributeType=प्रदाता गुण प्रकार रिटायर
+ProviderAttributeType.unretireProviderAttributeType=प्रदाता गुण प्रकार संयुक्त राष्ट्र के रिटायर
+ProviderAttributeType.purgeProviderAttributeType=हमेशा के लिए प्रकार की विशेषता प्रदाता हटाएं
+ProviderAttributeType.purgeConfirmMessage=प्रदाता गुण प्रकार सफलतापूर्वक हमेशा के लिए हटा
+
+AttributeType.datatype=डाटाटाइप
+AttributeType.datatypeClassname=डाटाटाइप
+AttributeType.datatypeConfig=डाटाटाइप विन्यास
+AttributeType.preferredHandlerClassname=पसंदीदा हैंडलर
+AttributeType.preferredHandlerClassname.wrongDatatype=डेटा प्रकार के लिए हैंडलर मान्य नहीं
+AttributeType.handlerConfig.invalid=अवैध विन्यास: {0}
+AttributeType.handlerConfig=हेन्डलर विन्यास
+AttributeType.minOccurs=न्यूनतम होता है
+AttributeType.maxOccurs=अधिकतम होता है
+AttributeType.minOccursShouldNotBeLessThanZero=न्यूनतम 0 से कम नहीं होना चाहिए
+AttributeType.maxOccursShouldNotBeLessThanZero=अधिकतम 0 से कम नहीं होना चाहिए
+AttributeType.maxOccursShouldNotBeLessThanMinOccurs=अधिकतम न्यूनतम से कम नहीं होना चाहिए
+
+AddressTemplate.Manage=पता खाका प्रबंधित
+AddressTemplate.saved=बचाया
+AddressTemplate.copy.form.wiki=प्रलेखन <br/> पृष्ठ पर उदाहरण के लेआउट देखें
+AddressTemplate.wiki.title=पता टेम्पलेट का प्रबंध
+AddressTemplate.error.empty= नहीं पता खाका पाया।
+AddressTemplate.error= पता टेम्पलेट अमान्य है।
+AddressTemplate.error.requiredAddressFieldIsBlank=आवश्यक पता फ़ील्ड {0} को खाली है ।
+AddressTemplate.error.fieldNotDeclaredInTemplate=फील्ड {0} टेम्पलेट में घोषित नहीं किया गया है ।
+AddressTemplate.error.elementInvalid=तत्व प्रकार " {0}" , मिलान अंत टैग द्वारा समाप्त किया जाना चाहिए लाइन में {1} ।
+AddressTemplate.error.nameOrValueInvalid=नाम या संपत्ति के मूल्य में याद आ रही है "{ 0}" ।
+AddressTemplate.error.wrongFieldName=फ़ील्ड नाम "{ 0}" गलत है।
+
+update.header.title=OpenMRS सर्वर रखरखाव मोड में है ।
+update.maintenance.login=जारी रखने के लिए {0} भूमिका है कि एक उपयोगकर्ता के रूप में लॉग ऑन करें।
+update.maintenance.username=OpenMRS यूजर का नाम
+update.review.desc=अद्यतन का विवरण
+update.review.auth=लेखक
+update.review.act=क्रियाएं
+
+update.warn=निम्न चेतावनी डेटाबेस Updater द्वारा उत्पन्न कर रहे थे , <br/> चेतावनियों से संबंधित किसी भी मुद्दे को ठीक करने और भविष्य में संदर्भ के लिए इस पेज को बचा लो।
+update.warn.saved=चेतावनियों और संदेशों के नीचे फ़ाइल को बचाया जा रहा है:
+update.warn.alert=इस मुद्दे रिकॉर्ड और यदि आवश्यक हो तो इसे ठीक ।
+
+update.warn.anotherUser=किसी अन्य उपयोगकर्ता पहले से ही डेटाबेस अद्यतन चल रहा है!
+update.warn.updatesRequired=निम्नलिखित डेटाबेस अद्यतन आवश्यक हैं :
+update.warn.updatesExecuted=निम्नलिखित डाटाबेस अपडेट निष्पादित किए जा रहे हैं :
+
+update.error.unableCompleteStartup=स्टार्टअप को पूरा करने में असमर्थ। पूरा stacktrace के लिए सर्वर त्रुटि लॉग देखें। {0}
+update.error.inpuNotImplemented=डेटाबेस अद्यतन दौरान इनपुट अभी तक लागू नहीं किया है । {0}
+update.error.unableUpdate=डेटाबेस को अद्यतन करने में असमर्थ। पूर्ण stacktrace के लिए सर्वर त्रुटि लॉग देखें।
+update.error.unableAuthenticate=सिस्टम डेवलपर भूमिका के साथ एक उपयोगकर्ता के रूप को प्रमाणित करने में असमर्थ। अमान्य उपयोगकर्ता नाम या पासवर्ड
+
+CustomDatatype.error.missingDatatype=[[ त्रुटि! डेटा प्रकार गुम : {0} ]]
+CustomDatatype.error.missingValue=[[ त्रुटि! लापता मूल्य के संदर्भ ]]
+
+org.openmrs.customdatatype.datatype.BooleanDatatype.name=बूलियन
+org.openmrs.customdatatype.datatype.BooleanDatatype.description=विन्यास इस्तेमाल नहीं किया है
+org.openmrs.customdatatype.datatype.DateDatatype.name=दिनांक
+org.openmrs.customdatatype.datatype.DateDatatype.description=विन्यास इस्तेमाल नहीं किया है
+org.openmrs.customdatatype.datatype.FreeTextDatatype.name=नि: शुल्क पाठ्य
+org.openmrs.customdatatype.datatype.FreeTextDatatype.description=विन्यास इस्तेमाल नहीं किया है
+org.openmrs.customdatatype.datatype.RegexValidatedTextDatatype.name=Regex मान्य पाठ
+org.openmrs.customdatatype.datatype.RegexValidatedTextDatatype.description=विन्यास जावा प्रारूप में एक regex होना चाहिए
+org.openmrs.customdatatype.datatype.LongFreeTextDatatype.name=लांग नि: शुल्क पाठ्य
+org.openmrs.customdatatype.datatype.LongFreeTextDatatype.description=विन्यास इस्तेमाल नहीं किया है
+org.openmrs.customdatatype.datatype.LongFreeTextDatatype.placeholderValue=[ लांग नि: शुल्क पाठ्य ]
+org.openmrs.customdatatype.datatype.SpecifiedTextOptionsDatatype.name=पाठ के विकल्प
+org.openmrs.customdatatype.datatype.SpecifiedTextOptionsDatatype.description=विन्यास इस्तेमाल नहीं किया है
+
+org.openmrs.web.attribute.handler.BooleanFieldGenDatatypeHandler.name=सही / गलत रेडियो
+org.openmrs.web.attribute.handler.BooleanFieldGenDatatypeHandler.description=विन्यास इस्तेमाल नहीं किया है
+org.openmrs.web.attribute.handler.DateFieldGenDatatypeHandler.name=कैलेंडर पॉपअप
+org.openmrs.web.attribute.handler.DateFieldGenDatatypeHandler.description=विन्यास इस्तेमाल नहीं किया है
+org.openmrs.web.attribute.handler.LongFreeTextTextareaHandler.name=(लंबे पाठ क्षेत्र के लिए) पाठ क्षेत्र
+org.openmrs.web.attribute.handler.LongFreeTextTextareaHandler.description=" पंक्तियाँ " और " कर्नल " विन्यस्त कर सकते हैं
+org.openmrs.web.attribute.handler.LongFreeTextFileUploadHandler.name=(लंबी पाठ क्षेत्रों के लिए ) फ़ाइल अपलोड करें
+org.openmrs.web.attribute.handler.LongFreeTextFileUploadHandler.description=विन्यास इस्तेमाल नहीं किया है
+org.openmrs.web.attribute.handler.SpecifiedTextOptionsDropdownHandler.name=ड्रॉप डाउन
+org.openmrs.web.attribute.handler.SpecifiedTextOptionsDropdownHandler.description=अल्पविराम के द्वारा अलग आइटम नीचे गिरा
+
+ORUR01.error.invalidMessage=ORU_R01 हैंडलर के लिए भेजा अवैध संदेश
+ORUR01.error.invalidMessageType=हैंडलर के लिए अमान्य संदेश लिखें। त्रुटि कास्टिंग {0}
+ORUR01.error.WhileProcessing=त्रुटि जबकि प्रसंस्करण ORU_R01 संदेश
+ORUR01.errorInvalidOBR=फार्म की OBS के खंड एक अवधारणा क्षेत्र है कि यह सुनिश्चित करने के लिए जाँच करें। यूआईडी के साथ HL7 संदेश में अवैध OBR : {0}
+ORUR01.error.improperlyFormattedOBX=का प्रारूप OBX : {0}
+ORUR01.error.relationshipCoding= NK1 सेगमेंट में संबंध कोडिंग प्रणाली {0} अज्ञात ।
+ORUR01.error.relationshipType=अनुचित तरीके से NK1 खंड में गठित रिश्ते के प्रकार {0}
+ORUR01.error.relationshipTypeNotFound=NK1 सेगमेंट में रिश्ते के प्रकार {0} नहीं मिला
+ORUR01.error.relativeNotCreated=NK1 खंड से एक नई रिश्तेदार नहीं बना सका
+ORUR01.error.notnumericConcept=न्यूमेरिक ( समुद्री मील ) मूल्य {0} अवधारणा # के लिए सांख्यिक नहीं है {1} ({ 2}) संदेश में {3}
+ORUR01.error.invalidAnswer={0} UUID साथ OBS के लिए एक वैध जवाब नहीं है {1}
+ORUR01.error.CannotSetBoolean=आईडी के साथ अवधारणा के लिए बूलियन अवधारणा जवाब सेट नहीं कर सकता {0}
+ORUR01.error.InvalidConceptId=OBX -5 मूल्य के लिए अमान्य अवधारणा आईडी { 0} {1}
+ORUR01.error.UpsupportedObsType=असमर्थित अवलोकन डेटा प्रकार {0}
+ORUR01.error.hl7ConceptId=यूआईडी के साथ HL7 संदेश में अवैध अवधारणा आईडी {0}:  {1}
+ORUR01.error.UnresolvedPatient=रोगी को हल नहीं किया जा सका
+ORUR01.error.UnresolvedLocation=स्थान का समाधान नहीं किया जा सका
+ORUR01.error.parseFormId=संदेश से फार्म आईडी पार्सिंग त्रुटि
+ORUR01.error.UnresolvedEnterer=दर्ज हल नहीं किया जा सका
+
+uncaughtException.title=एक आंतरिक त्रुटि हुई है
+uncaughtException.possibleCause=संभावित कारण
+uncaughtException.programmerError=: एक प्रोग्रामर एक त्रुटि बनाया है और एक विधि पर एक Transaction ( केवल पढ़ने = सच ) एनोटेशन शामिल करने के लिए भूल गया है।
+uncaughtException.help.text1=परामर्श करना
+uncaughtException.help.text2=दस्तावेज़ मदद करते हैं।
+uncaughtException.contact=यह हल नहीं किया जा सकता है अगर अपने दोस्ताना पड़ोस व्यवस्थापक से संपर्क करें ।
+uncaughtException.showStackTrace=दिखाएँ स्टैक ट्रेस
+uncaughtException.hideStackTrace=स्टैक ट्रेस छिपाने
+uncaughtException.stackTrace=स्टैक ट्रेस
+uncaughtException.logged.out=आप स्टैक ट्रेस देखने के लिए लॉग इन करना होगा
+uncaughtException.noErrorInfo=उपलब्ध नहीं त्रुटि जानकारी
+uncaughtException.bugFound=एक बग मिला ? भरें और नीचे के फार्म जमा करें - धन्यवाद - हमें OpenMRS बेहतर सॉफ्टवेयर बनाने में मदद!
+uncaughtException.subject=विषय:
+uncaughtException.subject.mandatory=विषय अनिवार्य है।
+uncaughtException.name=आपका नाम:
+uncaughtException.email=ई-मेल:
+uncaughtException.doing=इस त्रुटि हुई जब आप क्या कर रहे थे वर्णन करें :
+uncaughtException.additionalInfo=निम्न डेटा भी समस्या को हल करने के लिए टीम को सक्षम करने के लिए रिपोर्ट के साथ प्रस्तुत किया जाएगा।
+uncaughtException.additionalInfo.msg=त्रुटि संदेश और स्टैक ट्रेस
+uncaughtException.additionalInfo.version=OpenMRS संस्करण
+uncaughtException.additionalInfo.appNameAndVersion=अनुप्रयोग सर्वर का नाम और संस्करण
+uncaughtException.additionalInfo.username=उपयोगकर्ता का उपयोगकर्ता नाम वर्तमान में लॉग इन किया
+uncaughtException.additionalInfo.implementationId=इस स्थापना के कार्यान्वयन आईडी ( परिभाषित अगर )
+uncaughtException.additionalInfo.modules=सभी स्थापित मॉड्यूल का नाम और संस्करण
+
+OrderFrequency.concept.shouldBeClassFrequency=संकल्पना वर्ग फ्रीक्वेंसी की होनी चाहिए
+OrderFrequency.concept.shouldNotBeShared=केवल एक OrderFrequency एक विशेष अवधारणा के लिए मैप किया जाना चाहिए
diff --git a/api/src/main/resources/messages_ht.properties b/api/src/main/resources/messages_ht.properties
index 48c8fbaaec27..3d0a0fe5fd89 100644
--- a/api/src/main/resources/messages_ht.properties
+++ b/api/src/main/resources/messages_ht.properties
@@ -2735,7 +2735,7 @@ Visit.active.label=Vizit Aktiv
 # Visit.startCannotBeTheSameAsOtherStartDateOfTheSamePatient=Cannot start two different visits at the same time.
 # Visit.startDateCannotFallIntoAnotherVisitOfTheSamePatient=This visit has a start date that falls into another visit of the same patient.
 # Visit.stopDateCannotFallIntoAnotherVisitOfTheSamePatient=This visit has a stop date that falls into another visit of the same patient.
-# Visit.visitCannotContainAnotherVisitOfTheSamePatient=This visit contains another visit of the same patient, i.e. its start date is before the start date of the other visit and its stop date is after the stop date of the other visit.
+# Visit.visitCannotOverlapAnotherVisitOfTheSamePatient=This visit contains another visit of the same patient, i.e. its start date is before the start date of the other visit and its stop date is after the stop date of the other visit.
 # Visit.encountersCannotBeBeforeStartDate=Cannot contain encounters whose dates are before the start of the visit.
 # Visit.encountersCannotBeAfterStopDate=Cannot contain encounters whose dates are after the stop of the visit.
 # Visit.find.encounters.error=An error occurred while fetching encounters or could not connect to server
diff --git a/api/src/main/resources/messages_hy.properties b/api/src/main/resources/messages_hy.properties
index 7c07b21edaf2..b9d629e5a91f 100644
--- a/api/src/main/resources/messages_hy.properties
+++ b/api/src/main/resources/messages_hy.properties
@@ -2735,7 +2735,7 @@ conceptAnswer.forConcept=
 # Visit.startCannotBeTheSameAsOtherStartDateOfTheSamePatient=Cannot start two different visits at the same time.
 # Visit.startDateCannotFallIntoAnotherVisitOfTheSamePatient=This visit has a start date that falls into another visit of the same patient.
 # Visit.stopDateCannotFallIntoAnotherVisitOfTheSamePatient=This visit has a stop date that falls into another visit of the same patient.
-# Visit.visitCannotContainAnotherVisitOfTheSamePatient=This visit contains another visit of the same patient, i.e. its start date is before the start date of the other visit and its stop date is after the stop date of the other visit.
+# Visit.visitCannotOverlapAnotherVisitOfTheSamePatient=This visit contains another visit of the same patient, i.e. its start date is before the start date of the other visit and its stop date is after the stop date of the other visit.
 # Visit.encountersCannotBeBeforeStartDate=Cannot contain encounters whose dates are before the start of the visit.
 # Visit.encountersCannotBeAfterStopDate=Cannot contain encounters whose dates are after the stop of the visit.
 # Visit.find.encounters.error=An error occurred while fetching encounters or could not connect to server
diff --git a/api/src/main/resources/messages_id_ID.properties b/api/src/main/resources/messages_id_ID.properties
index 567fedbf5b12..85a1d689b712 100644
--- a/api/src/main/resources/messages_id_ID.properties
+++ b/api/src/main/resources/messages_id_ID.properties
@@ -2735,7 +2735,7 @@ Visit.to=kepada
 # Visit.startCannotBeTheSameAsOtherStartDateOfTheSamePatient=Cannot start two different visits at the same time.
 # Visit.startDateCannotFallIntoAnotherVisitOfTheSamePatient=This visit has a start date that falls into another visit of the same patient.
 # Visit.stopDateCannotFallIntoAnotherVisitOfTheSamePatient=This visit has a stop date that falls into another visit of the same patient.
-# Visit.visitCannotContainAnotherVisitOfTheSamePatient=This visit contains another visit of the same patient, i.e. its start date is before the start date of the other visit and its stop date is after the stop date of the other visit.
+# Visit.visitCannotOverlapAnotherVisitOfTheSamePatient=This visit contains another visit of the same patient, i.e. its start date is before the start date of the other visit and its stop date is after the stop date of the other visit.
 # Visit.encountersCannotBeBeforeStartDate=Cannot contain encounters whose dates are before the start of the visit.
 # Visit.encountersCannotBeAfterStopDate=Cannot contain encounters whose dates are after the stop of the visit.
 # Visit.find.encounters.error=An error occurred while fetching encounters or could not connect to server
diff --git a/api/src/main/resources/messages_ku.properties b/api/src/main/resources/messages_ku.properties
index 2e0fadeeb820..23fdb6868d03 100644
--- a/api/src/main/resources/messages_ku.properties
+++ b/api/src/main/resources/messages_ku.properties
@@ -2735,7 +2735,7 @@ conceptAnswer.forConcept=
 # Visit.startCannotBeTheSameAsOtherStartDateOfTheSamePatient=Cannot start two different visits at the same time.
 # Visit.startDateCannotFallIntoAnotherVisitOfTheSamePatient=This visit has a start date that falls into another visit of the same patient.
 # Visit.stopDateCannotFallIntoAnotherVisitOfTheSamePatient=This visit has a stop date that falls into another visit of the same patient.
-# Visit.visitCannotContainAnotherVisitOfTheSamePatient=This visit contains another visit of the same patient, i.e. its start date is before the start date of the other visit and its stop date is after the stop date of the other visit.
+# Visit.visitCannotOverlapAnotherVisitOfTheSamePatient=This visit contains another visit of the same patient, i.e. its start date is before the start date of the other visit and its stop date is after the stop date of the other visit.
 # Visit.encountersCannotBeBeforeStartDate=Cannot contain encounters whose dates are before the start of the visit.
 # Visit.encountersCannotBeAfterStopDate=Cannot contain encounters whose dates are after the stop of the visit.
 # Visit.find.encounters.error=An error occurred while fetching encounters or could not connect to server
diff --git a/api/src/main/resources/messages_lt.properties b/api/src/main/resources/messages_lt.properties
index dc805570f89b..ec89c3a3ce89 100644
--- a/api/src/main/resources/messages_lt.properties
+++ b/api/src/main/resources/messages_lt.properties
@@ -2735,7 +2735,7 @@ Visit.location=Vieta
 # Visit.startCannotBeTheSameAsOtherStartDateOfTheSamePatient=Cannot start two different visits at the same time.
 # Visit.startDateCannotFallIntoAnotherVisitOfTheSamePatient=This visit has a start date that falls into another visit of the same patient.
 # Visit.stopDateCannotFallIntoAnotherVisitOfTheSamePatient=This visit has a stop date that falls into another visit of the same patient.
-# Visit.visitCannotContainAnotherVisitOfTheSamePatient=This visit contains another visit of the same patient, i.e. its start date is before the start date of the other visit and its stop date is after the stop date of the other visit.
+# Visit.visitCannotOverlapAnotherVisitOfTheSamePatient=This visit contains another visit of the same patient, i.e. its start date is before the start date of the other visit and its stop date is after the stop date of the other visit.
 # Visit.encountersCannotBeBeforeStartDate=Cannot contain encounters whose dates are before the start of the visit.
 # Visit.encountersCannotBeAfterStopDate=Cannot contain encounters whose dates are after the stop of the visit.
 # Visit.find.encounters.error=An error occurred while fetching encounters or could not connect to server
diff --git a/api/src/main/resources/messages_pl.properties b/api/src/main/resources/messages_pl.properties
index 937bf7074771..172d0e2d2782 100644
--- a/api/src/main/resources/messages_pl.properties
+++ b/api/src/main/resources/messages_pl.properties
@@ -2765,7 +2765,7 @@ Visit.ended=Wizyta <b>{0}</b> zakończona
 Visit.startCannotBeTheSameAsOtherStartDateOfTheSamePatient=Nie można rozpocząć dwóch różnych wizyt jednocześnie.
 Visit.startDateCannotFallIntoAnotherVisitOfTheSamePatient=Ta wizyta ma datę rozpoczęcia, która przypada na kolejną wizytę tego samego pacjenta.
 Visit.stopDateCannotFallIntoAnotherVisitOfTheSamePatient=Ta wizyta ma datę zakończenia, która przypada na kolejną wizytę tego samego pacjenta.
-Visit.visitCannotContainAnotherVisitOfTheSamePatient=Ta wizyta zawiera kolejną wizytę tego samego pacjenta, tj. jej data rozpoczęcia przypada przed datą rozpoczęcia drugiej wizyty, a data jej zakończenia przypada po dacie zakończenia drugiej wizyty.
+Visit.visitCannotOverlapAnotherVisitOfTheSamePatient=Ta wizyta zawiera kolejną wizytę tego samego pacjenta, tj. jej data rozpoczęcia przypada przed datą rozpoczęcia drugiej wizyty, a data jej zakończenia przypada po dacie zakończenia drugiej wizyty.
 Visit.encountersCannotBeBeforeStartDate=Nie może zawierać badań, których daty przypadają przed rozpoczęciem wizyty.
 Visit.encountersCannotBeAfterStopDate=Nie może zawierać spotkań, których daty przypadają po zakończeniu wizyty.
 Visit.find.encounters.error=Wystąpił błąd podczas pobierania spotkań lub nie można połączyć się z serwerem
diff --git a/api/src/main/resources/messages_ru.properties b/api/src/main/resources/messages_ru.properties
index 2028f45f7c3d..7ef20cc8db63 100644
--- a/api/src/main/resources/messages_ru.properties
+++ b/api/src/main/resources/messages_ru.properties
@@ -2719,7 +2719,7 @@ Visit.ended=Визит <b>{0}</b> закончен
 Visit.startCannotBeTheSameAsOtherStartDateOfTheSamePatient=Невозможно запустить два разных визита в одно и то же время.
 Visit.startDateCannotFallIntoAnotherVisitOfTheSamePatient=Этот визит имеет дату начала сливающуяся с другим визитом этого же пациента.
 Visit.stopDateCannotFallIntoAnotherVisitOfTheSamePatient=Этот визит имеет дату конца сливающуяся с другим визитом этого же пациента.
-Visit.visitCannotContainAnotherVisitOfTheSamePatient=Этот визит содержит другой визит этого же пациента, т.е., дата начала первого до начала второго, а дата остановки после даты остановки другого визита.
+Visit.visitCannotOverlapAnotherVisitOfTheSamePatient=Этот визит содержит другой визит этого же пациента, т.е., дата начала первого до начала второго, а дата остановки после даты остановки другого визита.
 Visit.encountersCannotBeBeforeStartDate=Невозможно содержать пациентов чьи даты перед датой начала визита.
 Visit.encountersCannotBeAfterStopDate=Невозможно содержать пациентов чьи даты после даты конца визита.
 Visit.find.encounters.error=Возникла ошибка при получении посетителей или связь с сервером потеряна
diff --git a/api/src/main/resources/messages_sw.properties b/api/src/main/resources/messages_sw.properties
index e2dcdb4a55e6..532ad9206c5f 100644
--- a/api/src/main/resources/messages_sw.properties
+++ b/api/src/main/resources/messages_sw.properties
@@ -2735,7 +2735,7 @@ Portlet.cohort.female=Mke
 # Visit.startCannotBeTheSameAsOtherStartDateOfTheSamePatient=Cannot start two different visits at the same time.
 # Visit.startDateCannotFallIntoAnotherVisitOfTheSamePatient=This visit has a start date that falls into another visit of the same patient.
 # Visit.stopDateCannotFallIntoAnotherVisitOfTheSamePatient=This visit has a stop date that falls into another visit of the same patient.
-# Visit.visitCannotContainAnotherVisitOfTheSamePatient=This visit contains another visit of the same patient, i.e. its start date is before the start date of the other visit and its stop date is after the stop date of the other visit.
+# Visit.visitCannotOverlapAnotherVisitOfTheSamePatient=This visit contains another visit of the same patient, i.e. its start date is before the start date of the other visit and its stop date is after the stop date of the other visit.
 # Visit.encountersCannotBeBeforeStartDate=Cannot contain encounters whose dates are before the start of the visit.
 # Visit.encountersCannotBeAfterStopDate=Cannot contain encounters whose dates are after the stop of the visit.
 # Visit.find.encounters.error=An error occurred while fetching encounters or could not connect to server
diff --git a/api/src/main/resources/messages_te.properties b/api/src/main/resources/messages_te.properties
index 2e0fadeeb820..23fdb6868d03 100644
--- a/api/src/main/resources/messages_te.properties
+++ b/api/src/main/resources/messages_te.properties
@@ -2735,7 +2735,7 @@ conceptAnswer.forConcept=
 # Visit.startCannotBeTheSameAsOtherStartDateOfTheSamePatient=Cannot start two different visits at the same time.
 # Visit.startDateCannotFallIntoAnotherVisitOfTheSamePatient=This visit has a start date that falls into another visit of the same patient.
 # Visit.stopDateCannotFallIntoAnotherVisitOfTheSamePatient=This visit has a stop date that falls into another visit of the same patient.
-# Visit.visitCannotContainAnotherVisitOfTheSamePatient=This visit contains another visit of the same patient, i.e. its start date is before the start date of the other visit and its stop date is after the stop date of the other visit.
+# Visit.visitCannotOverlapAnotherVisitOfTheSamePatient=This visit contains another visit of the same patient, i.e. its start date is before the start date of the other visit and its stop date is after the stop date of the other visit.
 # Visit.encountersCannotBeBeforeStartDate=Cannot contain encounters whose dates are before the start of the visit.
 # Visit.encountersCannotBeAfterStopDate=Cannot contain encounters whose dates are after the stop of the visit.
 # Visit.find.encounters.error=An error occurred while fetching encounters or could not connect to server
diff --git a/api/src/test/java/org/openmrs/api/VisitServiceTest.java b/api/src/test/java/org/openmrs/api/VisitServiceTest.java
index ca2e119bd31b..f22356112586 100644
--- a/api/src/test/java/org/openmrs/api/VisitServiceTest.java
+++ b/api/src/test/java/org/openmrs/api/VisitServiceTest.java
@@ -786,16 +786,14 @@ public void endVisit_shouldFailIfValidationErrorsAreFound() {
 	 * @see VisitService#endVisit(Visit,Date)
 	 */
 	@Test
-	public void endVisit_shouldNotFailIfAllowOverlappingVisitsIsFalse() {
+	public void startVisit_shouldFailIfActiveVisitExists() {
 		
 		Context.getAdministrationService().setGlobalProperty("visits.allowOverlappingVisits", "false");
+		Patient patient = Context.getPatientService().getPatient(3);
 		
-		Visit visit = visitService.getVisit(1);
-		assertNull(visit.getStopDatetime());
+		Visit visit = new Visit(patient, new VisitType(1), new Date());
 		
-		visitService.endVisit(visit, null);
-		
-		assertNotNull(visit.getStopDatetime());
+		assertThrows(APIException.class, () ->visitService.saveVisit(visit));
 	}
 	
 	/**
diff --git a/api/src/test/java/org/openmrs/api/db/VisitDAOTest.java b/api/src/test/java/org/openmrs/api/db/VisitDAOTest.java
index 301e1a4a15cd..88085891e606 100644
--- a/api/src/test/java/org/openmrs/api/db/VisitDAOTest.java
+++ b/api/src/test/java/org/openmrs/api/db/VisitDAOTest.java
@@ -51,7 +51,7 @@ public void runBeforeEachTest() {
 	@Test
 	public void getVisits_shouldReturnAllUnvoidedVisitsIfIncludeEndedIsSetToTrue() {
 		executeDataSet(VISITS_WITH_DATES_XML);
-		assertEquals(13, dao.getVisits(null, null, null, null, null, null, null, null, null, true, false).size());
+		assertEquals(16, dao.getVisits(null, null, null, null, null, null, null, null, null, true, false).size());
 	}
 	
 	/**
@@ -60,7 +60,7 @@ public void getVisits_shouldReturnAllUnvoidedVisitsIfIncludeEndedIsSetToTrue() {
 	@Test
 	public void getVisits_shouldReturnOnlyActiveVisitsIfIncludeEndedIsSetToFalse() {
 		executeDataSet(VISITS_WITH_DATES_XML);
-		assertEquals(6, dao.getVisits(null, null, null, null, null, null, null, null, null, false, false).size());
+		assertEquals(7, dao.getVisits(null, null, null, null, null, null, null, null, null, false, false).size());
 	}
 	
 	/**
diff --git a/api/src/test/java/org/openmrs/validator/VisitValidatorTest.java b/api/src/test/java/org/openmrs/validator/VisitValidatorTest.java
index feb9b30b570a..abaefa265ab9 100755
--- a/api/src/test/java/org/openmrs/validator/VisitValidatorTest.java
+++ b/api/src/test/java/org/openmrs/validator/VisitValidatorTest.java
@@ -18,6 +18,9 @@
 
 import java.text.ParseException;
 import java.text.SimpleDateFormat;
+import java.time.LocalDateTime;
+import java.time.ZoneId;
+import java.time.format.DateTimeFormatter;
 import java.util.Calendar;
 import java.util.Date;
 import java.util.List;
@@ -85,7 +88,8 @@ public void tearDown() {
 	 */
 	@Test
 	public void validate_shouldAcceptAVisitThatHasTheRightNumberOfAttributeOccurrences() {
-		Visit visit = makeVisit();
+		int patientId = 42;
+		Visit visit = makeVisit(patientId);
 		visit.addAttribute(makeAttribute("one"));
 		visit.addAttribute(makeAttribute("two"));
 		ValidateUtil.validate(visit);
@@ -254,37 +258,114 @@ public void validate_shouldFailIfAnAttributeIsBad() {
 	}
 	
 	/**
-	 * @see VisitValidator#validate(Object, org.springframework.validation.Errors)
+	 * @see VisitValidator#validate(Object,Errors)
 	 */
 	@Test
-	public void validate_shouldRejectAVisitIfStartDateTimeIsEqualToStartDateTimeOfAnotherVisitOfTheSamePatient()
-	        {
-		Calendar calendar = Calendar.getInstance();
-		calendar.setTimeInMillis(DATE_TIME_2014_01_04_00_00_00_0);
+	public void validate_shouldRejectAVisitThatStartsBeforeAndEndsAfterAnExistingVisit() {
+		int patientId = 42;
 		
-		Visit visit = makeVisit(42);
-		visit.setStartDatetime(calendar.getTime());
+		// Existing visit: starts on 2014-01-04 10:00:00 and ends on 2014-01-10 14:00:00 (see VisitValidatorTest.xml)
+		// New visit starts before and ends after the existing visit
+		String startDateTime = "2014-01-04T08:00:00";
+		String endDateTime = "2014-01-10T16:00:00";
 		
-		Errors errors = new BindException(visit, "visit");
-		new VisitValidator().validate(visit, errors);
+		//	Existing visit:  		|---------|
+		//	New visit:       |----------------------|
 		
+		Errors errors = validateVisitOverlap(startDateTime, endDateTime, patientId);
 		assertTrue(errors.hasFieldErrors("startDatetime"));
 	}
 	
 	/**
-	 * @see VisitValidator#validate(Object, org.springframework.validation.Errors)
+	 * @see VisitValidator#validate(Object,Errors)
+	 */	
+	@Test
+	public void validate_shouldRejectAVisitThatStartsBeforeAndEndsDuringAnExistingVisit() {
+		int patientId = 42;
+		// Existing visit: starts on 2014-01-04 10:00:00 and ends on 2014-01-10 14:00:00 (see VisitValidatorTest.xml)
+		// New visit starts before and ends during the existing visit
+		String startDateTime = "2014-01-04T08:00:00";
+		String endDateTime = "2014-01-04T12:00:00";
+		
+		//	Existing event:  	   |----------------------|
+		//	New event:       |------------|
+		
+		Errors errors = validateVisitOverlap(startDateTime, endDateTime, patientId);
+		assertTrue(errors.hasFieldErrors("startDatetime"));
+	}
+	
+	/**
+	 * @see VisitValidator#validate(Object,Errors)
 	 */
 	@Test
-	public void validate_shouldRejectAVisitIfStartDateTimeFallsIntoAnotherVisitOfTheSamePatient() {
-		Calendar calendar = Calendar.getInstance();
-		calendar.set(2014, Calendar.JANUARY, 6);
+	public void validate_shouldRejectAVisitThatStartsDuringAndEndsAfterAnExistingVisit() {
+		int patientId = 42;
+		// Existing visit: starts on 2014-01-04 10:00:00 and ends on 2014-01-10 14:00:00 (see VisitValidatorTest.xml)
+		// New visit starts during and ends after the existing visit
+		String startDateTime = "2014-01-04T12:00:00";
+		String endDateTime = "2014-01-04T16:00:00";
 		
-		Visit visit = makeVisit(42);
-		visit.setStartDatetime(calendar.getTime());
+		//	Existing visit:  	|------------|
+		//	New visit:                  |----------|
 		
-		Errors errors = new BindException(visit, "visit");
-		new VisitValidator().validate(visit, errors);
+		Errors errors = validateVisitOverlap(startDateTime, endDateTime, patientId);
+		assertTrue(errors.hasFieldErrors("startDatetime"));
+	}
+	
+	/**
+	 * @see VisitValidator#validate(Object,Errors)
+	 */
+	@Test
+	public void validate_shouldRejectAVisitThatStartsAndEndsDuringAnExistingVisit() {
+		// Existing visit: starts on 2014-01-04 10:00:00 and ends on 2014-01-10 14:00:00 (see VisitValidatorTest.xml)
+		int patientId = 42;
+		
+		// New visit starts and ends during the existing visit
+		String startDateTime = "2014-01-04T12:00:00";
+		String endDateTime = "2014-01-04T13:00:00";
+		
+		// Existing visit:  	|----------------------|
+		// New visit:                  |------|
+		
+		Errors errors = validateVisitOverlap(startDateTime, endDateTime, patientId);
+		assertTrue(errors.hasFieldErrors("startDatetime"));
+	}
+	
+	/**
+	 * @see VisitValidator#validate(Object,Errors)
+	 */
+	@Test
+	public void validate_shouldRejectAVisitThatStartsAtTheSameTimeAsAnExistingVisit() {
+		// Existing visit: starts on 2014-01-04 10:00:00 and ends on 2014-01-10 14:00:00 (see VisitValidatorTest.xml)
+		int patientId = 42;
+		
+		// New visit starts at the same time as the existing visit and ends before the existing visit
+		String startDateTime = "2014-01-04T10:00:00";
+		String endDateTime = "2014-01-04T12:00:00";
+		
+		// Existing visit:  |----------------------|
+		// New visit:       |------|
+		
+		Errors errors = validateVisitOverlap(startDateTime, endDateTime, patientId);
+		assertTrue(errors.hasFieldErrors("startDatetime"));
+	}
+	
+	/**
+	 * @see VisitValidator#validate(Object,Errors)
+	 */
+	@Test
+	public void validate_shouldRejectAVisitThatEndsAtTheSameTimeAsAnExistingEvent(){
+		// Existing visit: starts on 2014-01-04 10:00:00 and ends on 2014-01-10 14:00:00 (see VisitValidatorTest.xml)
+		int patientId = 42;
+		
+		// New visit starts before the existing visit and ends at the same time as the existing visit
+		String startDateTime = "2014-01-04T08:00:00";
+		String endDateTime = "2014-01-10T14:00:00";
+		
+		// Existing visit:  |----------------------|
+		// New visit:           |------------------|
 		
+		Errors errors = validateVisitOverlap(startDateTime, endDateTime, patientId);
 		assertTrue(errors.hasFieldErrors("startDatetime"));
 	}
 	
@@ -292,40 +373,60 @@ public void validate_shouldRejectAVisitIfStartDateTimeFallsIntoAnotherVisitOfThe
 	 * @see VisitValidator#validate(Object, org.springframework.validation.Errors)
 	 */
 	@Test
-	public void validate_shouldRejectAVisitIfStopDateTimeFallsIntoAnotherVisitOfTheSamePatient() {
-		Calendar calendar = Calendar.getInstance();
-		calendar.set(2014, Calendar.JANUARY, 2);
+	public void validate_shouldRejectOverlappingNewActiveVisit() {
+		int patientId = 42;
 		
-		Visit visit = makeVisit(42);
-		visit.setStartDatetime(calendar.getTime());
+		// Existing visit: starts on 2014-01-04 10:00:00 and ends on 2014-01-10 14:00:00 (see VisitValidatorTest.xml)
+		// New visit starts before and ends after the existing visit
+		String startDateTime = "2014-01-04T12:00:00";
+		String endDateTime = null;
 		
-		calendar.set(2014, Calendar.JANUARY, 8);
-		visit.setStopDatetime(calendar.getTime());
+		//	Existing visit:  |---------|
+		//	New visit:            |----------->
 		
-		Errors errors = new BindException(visit, "visit");
-		new VisitValidator().validate(visit, errors);
+		Errors errors = validateVisitOverlap(startDateTime, endDateTime, patientId);
+		assertTrue(errors.hasFieldErrors("startDatetime"));
+	}
+	
+	/**
+	 * @see VisitValidator#validate(Object, org.springframework.validation.Errors)
+	 */
+	@Test
+	public void validate_shouldRejectOverlappingActiveVisits() {
+		int patientId = 43;
 		
-		assertTrue(errors.hasFieldErrors("stopDatetime"));
+		// Existing visit: starts on 2014-01-04 10:00:00 and no end date (see VisitValidatorTest.xml)
+		// New visit starts before and ends after the existing visit
+		String startDateTime = "2014-01-04T12:00:00";
+		String endDateTime = "2014-01-04T14:00:00";
+		
+		//	Existing visit:  |---------------->
+		//	New visit:            |--------|
+		
+		Errors errors = validateVisitOverlap(startDateTime, endDateTime, patientId);
+		assertTrue(errors.hasFieldErrors("startDatetime"));
 	}
 	
 	/**
 	 * @see VisitValidator#validate(Object, org.springframework.validation.Errors)
+	 * This test verifies that updating an existing visit does not result in a rejection 
+	 * when there are no other overlapping visits.
 	 */
 	@Test
-	public void validate_shouldRejectAVisitIfItContainsAnotherVisitOfTheSamePatient() {
-		Calendar calendar = Calendar.getInstance();
-		calendar.set(2014, Calendar.JANUARY, 2);
+	public void validate_shouldNotRejectOnVisitOverlapDuringUpdate() {
+		int patientId = 42;
 		
-		Visit visit = makeVisit(42);
-		visit.setStartDatetime(calendar.getTime());
+		List<Visit> visits = Context.getVisitService()
+			.getVisitsByPatient(Context.getPatientService().getPatient(patientId), true, false);
 		
-		calendar.set(2014, Calendar.JANUARY, 12);
-		visit.setStopDatetime(calendar.getTime());
+		assertFalse(visits.isEmpty());
+		
+		// Existing visit: starts on 2014-01-04 10:00:00 and ends on 2014-01-10 14:00:00 (see VisitValidatorTest.xml)
+		Visit visit = visits.get(0);
 		
 		Errors errors = new BindException(visit, "visit");
 		new VisitValidator().validate(visit, errors);
-		
-		assertTrue(errors.hasFieldErrors("stopDatetime"));
+		assertFalse(errors.hasFieldErrors("startDatetime"));
 	}
 	
 	/**
@@ -584,4 +685,23 @@ public void validate_shouldFailValidationIfVisitDateBeforeEstimatedBirthDatesMin
 		
 		assertThat(errors, hasFieldErrors("startDatetime", "Visit.startDateCannotFallBeforeTheBirthDateOfTheSamePatient"));
 	}
+	
+	private Date parseIsoDate(String isoDate) {
+		LocalDateTime localDateTime = LocalDateTime.parse(isoDate, DateTimeFormatter.ISO_DATE_TIME);
+		return Date.from(localDateTime.atZone(ZoneId.systemDefault()).toInstant());
+	}
+	
+	private Errors validateVisitOverlap(String startDateTime, String endDateTime, int patientId) {
+		globalPropertiesTestHelper.setGlobalProperty(OpenmrsConstants.GLOBAL_PROPERTY_ALLOW_OVERLAPPING_VISITS, "false");
+		Visit visit = makeVisit(patientId);
+		visit.setStartDatetime(parseIsoDate(startDateTime));
+		if(endDateTime != null) {
+			visit.setStopDatetime(parseIsoDate(endDateTime));
+		}
+		
+		Errors errors = new BindException(visit, "visit");
+		new VisitValidator().validate(visit, errors);
+		
+		return errors;
+	}
 }
diff --git a/api/src/test/resources/org/openmrs/api/include/PersonServiceTest-encountersForVisits.xml b/api/src/test/resources/org/openmrs/api/include/PersonServiceTest-encountersForVisits.xml
index cb79842d62ba..1e7effefe4ec 100644
--- a/api/src/test/resources/org/openmrs/api/include/PersonServiceTest-encountersForVisits.xml
+++ b/api/src/test/resources/org/openmrs/api/include/PersonServiceTest-encountersForVisits.xml
@@ -11,11 +11,11 @@
 
 -->
 <dataset>
-    <encounter encounter_id="100" encounter_type="2" patient_id="2" visit_id="2" location_id="1" form_id="1" encounter_datetime="2008-08-01 00:00:00.0" creator="1" date_created="2008-08-18 14:09:05.0" voided="false" uuid="c8146fac-2f80-11e2-b338-adb892b5d200"/>
+    <encounter encounter_id="100" encounter_type="2" patient_id="2" visit_id="2" location_id="1" form_id="1" encounter_datetime="2005-01-02 08:00:00.0" creator="1" date_created="2005-01-02 08:00:00.0" voided="false" uuid="c8146fac-2f80-11e2-b338-adb892b5d200"/>
     <encounter_provider encounter_provider_id="100" encounter_id="100" provider_id="1" encounter_role_id="1" creator="1" date_created="2006-03-11 15:57:35.0" voided="false" uuid="c8146fac-2f80-11e2-b338-adb892b5d201" />
     <obs obs_id="100" status="FINAL" person_id="2" concept_id="5497" encounter_id="100" obs_datetime="2008-08-01 00:00:00.0" location_id="1" value_numeric="150.0" comments="" creator="1" date_created="2008-08-18 14:11:13.0" voided="false" uuid="c8146fac-2f80-11e2-b338-adb892b5d202"/>
     <obs obs_id="101" status="FINAL" person_id="2" concept_id="5497" encounter_id="100" obs_datetime="2008-08-01 00:00:00.0" location_id="1" value_numeric="510.0" comments="" creator="1" date_created="2008-08-18 14:11:13.0" voided="true" void_reason="testing" uuid="c8146fac-2f80-11e2-b338-adb892b5d203"/>
 
-    <encounter encounter_id="101" encounter_type="2" patient_id="2" visit_id="2" location_id="1" form_id="1" encounter_datetime="2008-08-01 00:00:00.0" creator="1" date_created="2008-08-18 14:09:05.0" voided="true" void_reason="testing" uuid="c8146fac-2f80-11e2-b338-adb892b5d204"/>
+    <encounter encounter_id="101" encounter_type="2" patient_id="2" visit_id="2" location_id="1" form_id="1" encounter_datetime="2005-01-02 08:00:00.0" creator="1" date_created="2005-01-02 08:00:00.0" voided="true" void_reason="testing" uuid="c8146fac-2f80-11e2-b338-adb892b5d204"/>
     <encounter_provider encounter_provider_id="101" encounter_id="100" provider_id="1" encounter_role_id="1" creator="1" date_created="2006-03-11 15:57:35.0" voided="false" uuid="c8146fac-2f80-11e2-b338-adb892b5d205" />
 </dataset>
diff --git a/api/src/test/resources/org/openmrs/api/include/VisitServiceTest-otherVisits.xml b/api/src/test/resources/org/openmrs/api/include/VisitServiceTest-otherVisits.xml
index 0ddfa236ae96..fec286bfd556 100644
--- a/api/src/test/resources/org/openmrs/api/include/VisitServiceTest-otherVisits.xml
+++ b/api/src/test/resources/org/openmrs/api/include/VisitServiceTest-otherVisits.xml
@@ -11,7 +11,16 @@
 
 -->
 <dataset>
-  <visit visit_id="7" patient_id="2" visit_type_id="1" date_started="2005-01-01 02:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="a2c3868a-6b90-11e0-93c3-18a905e044dc" />
+	<person person_id="3" uuid="6631b434-78aa-102b-91a0-001e378eb67e" gender="F" birthdate="1980-05-15" birthdate_estimated="0" dead="false" creator="1" date_created="2024-08-16 00:00:00.0" voided="false"/>
+	<patient patient_id="3" creator="1" date_created="2024-08-16 00:00:00.0" voided="false"/>
+	<patient_identifier patient_identifier_id="2" patient_id="3" identifier="5678" identifier_type="1" preferred="1" location_id="1" creator="1" date_created="2024-08-16 00:00:00.0" voided="false" uuid="3ac98ec8-e9d9-4626-998c-c795c2f0aa9f"/>
+	<person_name person_name_id="3" preferred="true" person_id="3" given_name="Jane" middle_name="A" family_name="Smith" creator="1" date_created="2024-08-16 00:00:00.0" voided="false" uuid="1f1f7d08-076b-4fc6-acac-4bb91515141e"/>
+	
+	<visit visit_id="20" patient_id="3" visit_type_id="1" date_started="2024-08-01 09:00:00.0" date_stopped="2024-08-01 12:00:00.0" creator="1" date_created="2024-08-01 09:00:00.0" voided="0" uuid="d1e2f1c4-78b1-11e0-93c3-18a905e044dc" />
+	<visit visit_id="21" patient_id="3" visit_type_id="1" date_started="2024-08-03 10:00:00.0" date_stopped="2024-08-03 14:00:00.0" creator="1" date_created="2024-08-03 10:00:00.0" voided="0" uuid="e1f3e4f5-79b2-11e0-93c3-18a905e044dc" />
+	<visit visit_id="22" patient_id="3" visit_type_id="1" date_started="2024-08-05 08:00:00.0" creator="1" date_created="2024-08-05 08:00:00.0" voided="0" uuid="f1f4e5d6-80b3-11e0-93c3-18a905e044dc" />
+
+	<visit visit_id="7" patient_id="2" visit_type_id="1" date_started="2005-01-01 02:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="a2c3868a-6b90-11e0-93c3-18a905e044dc" />
   <visit visit_id="8" patient_id="2" visit_type_id="1" date_started="2005-01-01 04:00:00.0" date_stopped="2005-02-01 16:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="a3a5913e-6b94-11e0-93c3-18a905e044dc" />
   <visit visit_id="9" patient_id="2" visit_type_id="1" date_started="2005-01-02 00:00:00.0" date_stopped="2005-02-02 11:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="ae401f88-6b94-11e0-93c3-18a905e044dc" />
   <visit visit_id="10" patient_id="2" visit_type_id="1" date_started="2005-01-03 00:00:00.0" date_stopped="2005-02-03 14:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="ba4781f4-6b94-11e0-93c3-18a905e044dc" />
@@ -25,7 +34,7 @@
   <patient patient_id="2" creator="1" date_created="2005-01-01 00:00:00.0" voided="false"/>
   <patient_identifier patient_identifier_id="1" patient_id="2" identifier="1234" identifier_type="1" preferred="1" location_id="1" creator="1" date_created="2005-01-01 00:00:00.0" voided="false" uuid="1ac98ec8-e9d9-4626-998c-c795c2f0aa9f"/>
   <patient_identifier_type patient_identifier_type_id="1" name="Test Identifier Type" description="Test description" creator="1" date_created="2005-01-01 00:00:00.0" required="false" retired="false" uuid="0cbecb62-7249-4f91-8edf-d0206ecceb63"/>
-  <person person_id="2" uuid="5631b434-78aa-102b-91a0-001e378eb67e" gender="M" birthdate="1950-04-01" dead="false" creator="1" date_created="2005-01-01 00:00:00.0" voided="false"/>
+  <person person_id="2" uuid="5631b434-78aa-102b-91a0-001e378eb67e" gender="M" birthdate="1950-04-01" birthdate_estimated="0" dead="false" creator="1" date_created="2005-01-01 00:00:00.0" voided="false"/>
   <person_name person_name_id="2" preferred="true" person_id="2" given_name="John" middle_name=" " family_name="Doe" creator="1" date_created="2005-01-01 00:00:00.0" voided="false" uuid="0f1f7d08-076b-4fc6-acac-4bb91515141e"/>
   
   <location location_id="1" name="Test Location" creator="1" date_created="2005-01-01 00:00:00.0" retired="false" uuid="c36006e5-9fbb-4f20-866b-0ece245615a1"/>
diff --git a/api/src/test/resources/org/openmrs/include/standardTestDataset.xml b/api/src/test/resources/org/openmrs/include/standardTestDataset.xml
index b6b7827e21e4..a7ce10bd0ed9 100644
--- a/api/src/test/resources/org/openmrs/include/standardTestDataset.xml
+++ b/api/src/test/resources/org/openmrs/include/standardTestDataset.xml
@@ -324,7 +324,7 @@
   <provider provider_id="1" person_id="1" identifier="Test" creator="1" date_created="2005-01-01 00:00:00.0" retired="false" uuid="c2299800-cca9-11e0-9572-0800200c9a66" />
   <visit_type visit_type_id="1" name="Initial HIV Clinic Visit" description="Initial HIV Clinic Visit Description" creator="1" date_created="2005-01-01 00:00:00.0" retired="false" uuid="c0c579b0-8e59-401d-8a4a-976a0b183519"/>
   <visit_type visit_type_id="2" name="Return TB Clinic Visit" description="Return TB Clinic Visit Description" creator="1" date_created="2005-01-01 00:00:00.0" retired="false" uuid="759799ab-c9a5-435e-b671-77773ada74e4"/>
-  <visit_type visit_type_id="3" name="Hospitalization" description="Hospitalization Description" creator="1" date_created="2005-01-01 00:00:00.0" retired="true" retire_reason="Some Retire Reason" uuid="759799ab-c9a5-435e-b671-77773ada74e6"/> 
+  <visit_type visit_type_id="3" name="Hospitalization" description="Hospitalization Description" creator="1" date_created="2005-01-01 00:00:00.0" retired="true" retire_reason="Some Retire Reason" uuid="759799ab-c9a5-435e-b671-77773ada74e6"/>
   <visit visit_id="1" patient_id="2" visit_type_id="1" date_started="2005-01-01 00:00:00.0" location_id="1" indication_concept_id="5497" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="1e5d5d48-6b78-11e0-93c3-18a905e044dc" />
   <visit visit_id="2" patient_id="2" visit_type_id="1" date_started="2005-01-02 00:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="4e663d66-6b78-11e0-93c3-18a905e044dc" />
   <visit visit_id="3" patient_id="2" visit_type_id="2" date_started="2005-01-03 00:00:00.0" creator="1" date_created="2005-01-01 00:00:00.0" voided="0" uuid="6f85b2a6-6b78-11e0-93c3-18a905e044dc" />
diff --git a/api/src/test/resources/org/openmrs/validator/include/VisitValidatorTest.xml b/api/src/test/resources/org/openmrs/validator/include/VisitValidatorTest.xml
index 3764381b7ace..5fe8767066d3 100644
--- a/api/src/test/resources/org/openmrs/validator/include/VisitValidatorTest.xml
+++ b/api/src/test/resources/org/openmrs/validator/include/VisitValidatorTest.xml
@@ -22,10 +22,11 @@
       Patient referring to people defined in HibernatePersonDAOTest-people.xml
   -->
   <patient patient_id="42" creator="1" date_created="2013-11-06 00:00:00.0" changed_by="1" voided="false" void_reason=""/>
+  <patient patient_id="43" creator="1" date_created="2013-11-06 00:00:00.0" changed_by="1" voided="false" void_reason=""/>
 
     <!-- Non-voided and voided visits for testing validation by visit start and end date -->
-  <visit visit_id="10" patient_id="42" visit_type_id="1" date_started="2014-01-04 00:00:00.0" date_stopped="2014-01-10 00:00:00.0" location_id="1" indication_concept_id="5497" creator="1" date_created="2014-01-04 00:00:00.0" voided="false" uuid="7EC61082-9C62-4BBB-9F1B-F4BEA9C2893E"/>
+  <visit visit_id="10" patient_id="42" visit_type_id="1" date_started="2014-01-04 10:00:00.0" date_stopped="2014-01-04 14:00:00.0" location_id="1" indication_concept_id="5497" creator="1" date_created="2014-01-04 10:00:00.0" voided="false" uuid="7EC61082-9C62-4BBB-9F1B-F4BEA9C2893E"/>
   <visit visit_id="11" patient_id="42" visit_type_id="1" date_started="2014-02-05 00:00:00.0" date_stopped="2014-02-11 00:00:00.0" location_id="1" indication_concept_id="5497" creator="1" date_created="2014-02-05 00:00:00.0" voided="true" uuid="3CBB36EA-654C-4C26-9B01-C2D2A1B0426D"/>
-
+  <visit visit_id="12" patient_id="43" visit_type_id="1" date_started="2014-01-04 10:00:00.0" location_id="1" indication_concept_id="5497" creator="1" date_created="2014-01-04 10:00:00.0" voided="false" uuid="47841268-0f09-4af9-9033-d547c6adec54"/>
 
 </dataset>

From da78bda133a9be74ef6b509cae9439dbe0cc292b Mon Sep 17 00:00:00 2001
From: rkorytkowski <rafal.korytkowski@gmail.com>
Date: Thu, 22 Aug 2024 16:30:16 +0200
Subject: [PATCH 092/163] TRUNK-6259: Require authentication for fetching
 privileges and roles

---
 .../org/openmrs/aop/AuthorizationAdvice.java  | 42 ++++++++++---------
 .../java/org/openmrs/api/UserService.java     | 14 +++++++
 .../org/openmrs/api/context/UserContext.java  | 18 ++++----
 3 files changed, 45 insertions(+), 29 deletions(-)

diff --git a/api/src/main/java/org/openmrs/aop/AuthorizationAdvice.java b/api/src/main/java/org/openmrs/aop/AuthorizationAdvice.java
index 604dba84d479..4673fffbfebf 100644
--- a/api/src/main/java/org/openmrs/aop/AuthorizationAdvice.java
+++ b/api/src/main/java/org/openmrs/aop/AuthorizationAdvice.java
@@ -17,6 +17,7 @@
 import org.openmrs.annotation.AuthorizedAnnotationAttributes;
 import org.openmrs.api.APIAuthenticationException;
 import org.openmrs.api.context.Context;
+import org.openmrs.util.PrivilegeConstants;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.aop.MethodBeforeAdvice;
@@ -44,7 +45,6 @@ public class AuthorizationAdvice implements MethodBeforeAdvice {
 	 */
 	@Override
 	public void before(Method method, Object[] args, Object target) throws Throwable {
-		
 		log.debug("Calling authorization advice before {}", method.getName());
 		
 		if (log.isDebugEnabled()) {
@@ -63,28 +63,32 @@ public void before(Method method, Object[] args, Object target) throws Throwable
 		// Iterate through required privileges and return only if the user has
 		// one of them
 		if (!privileges.isEmpty()) {
-			for (String privilege : privileges) {
-				
-				// skip null privileges
-				if (privilege == null || privilege.isEmpty()) {
-					return;
-				}
-				
-				log.debug("User has privilege {}? {}", privilege, Context.hasPrivilege(privilege));
-				
-				if (Context.hasPrivilege(privilege)) {
-					if (!requireAll) {
-						// if not all required, the first one that they have
-						// causes them to "pass"
+			try {
+				Context.addProxyPrivilege(PrivilegeConstants.GET_ROLES);
+				for (String privilege : privileges) {
+					// skip null privileges
+					if (privilege == null || privilege.isEmpty()) {
 						return;
 					}
-				} else {
-					if (requireAll) {
-						// if all are required, the first miss causes them
-						// to "fail"
-						throwUnauthorized(Context.getAuthenticatedUser(), method, privilege);
+					boolean hasPrivilege  = Context.hasPrivilege(privilege);
+					log.debug("User has privilege {}? {}", privilege, hasPrivilege);
+
+					if (hasPrivilege) {
+						if (!requireAll) {
+							// if not all required, the first one that they have
+							// causes them to "pass"
+							return;
+						}
+					} else {
+						if (requireAll) {
+							// if all are required, the first miss causes them
+							// to "fail"
+							throwUnauthorized(Context.getAuthenticatedUser(), method, privilege);
+						}
 					}
 				}
+			} finally {
+				Context.removeProxyPrivilege(PrivilegeConstants.GET_ROLES);
 			}
 			
 			if (!requireAll) {
diff --git a/api/src/main/java/org/openmrs/api/UserService.java b/api/src/main/java/org/openmrs/api/UserService.java
index a6ff1dc70c11..ec507564fdc8 100644
--- a/api/src/main/java/org/openmrs/api/UserService.java
+++ b/api/src/main/java/org/openmrs/api/UserService.java
@@ -210,6 +210,7 @@ public interface UserService extends OpenmrsService {
 	 * @throws APIException
 	 * <strong>Should</strong> return all privileges in the system
 	 */
+	@Authorized(PrivilegeConstants.MANAGE_PRIVILEGES)
 	public List<Privilege> getAllPrivileges() throws APIException;
 	
 	/**
@@ -219,6 +220,7 @@ public interface UserService extends OpenmrsService {
 	 * @throws APIException
 	 * <strong>Should</strong> return all roles in the system
 	 */
+	@Authorized(PrivilegeConstants.MANAGE_ROLES)
 	public List<Role> getAllRoles() throws APIException;
 	
 	/**
@@ -274,6 +276,7 @@ public interface UserService extends OpenmrsService {
 	 * @throws APIException
 	 * <strong>Should</strong> fetch role for given role name
 	 */
+	@Authorized(PrivilegeConstants.GET_ROLES)
 	public Role getRole(String r) throws APIException;
 	
 	/**
@@ -284,6 +287,7 @@ public interface UserService extends OpenmrsService {
 	 * <strong>Should</strong> find object given valid uuid
 	 * <strong>Should</strong> return null if no object found with given uuid
 	 */
+	@Authorized(PrivilegeConstants.GET_ROLES)
 	public Role getRoleByUuid(String uuid) throws APIException;
 	
 	/**
@@ -293,6 +297,7 @@ public interface UserService extends OpenmrsService {
 	 * @throws APIException
 	 * <strong>Should</strong> fetch privilege for given name
 	 */
+	@Authorized(PrivilegeConstants.GET_PRIVILEGES)
 	public Privilege getPrivilege(String p) throws APIException;
 	
 	/**
@@ -304,6 +309,7 @@ public interface UserService extends OpenmrsService {
 	 * <strong>Should</strong> return null if no object found with given uuid
 	 * <strong>Should</strong> fetch privilege for given uuid
 	 */
+	@Authorized(PrivilegeConstants.GET_PRIVILEGES)
 	public Privilege getPrivilegeByUuid(String uuid) throws APIException;
 	
 	/**
@@ -329,6 +335,7 @@ public interface UserService extends OpenmrsService {
 	 * <strong>Should</strong> be able to update password multiple times
 	 * <strong>Should</strong> respect locking via runtime properties
 	 */
+	@Authorized
 	@Logging(ignoredArgumentIndexes = { 0, 1 })
 	public void changePassword(String oldPassword, String newPassword) throws APIException;
 
@@ -382,6 +389,7 @@ public interface UserService extends OpenmrsService {
 	 * <strong>Should</strong> match on correctly hashed stored password
 	 * <strong>Should</strong> match on incorrectly hashed stored password
 	 */
+	@Authorized
 	@Logging(ignoreAllArgumentValues = true)
 	public void changeQuestionAnswer(String pw, String q, String a) throws APIException;
 	
@@ -472,6 +480,7 @@ public interface UserService extends OpenmrsService {
 	 * <strong>Should</strong> add property with given key and value when key does not already exist
 	 * <strong>Should</strong> modify property with given key and value when key already exists
 	 */
+	@Authorized
 	public User setUserProperty(User user, String key, String value) throws APIException;
 	
 	/**
@@ -485,6 +494,7 @@ public interface UserService extends OpenmrsService {
 	 * <strong>Should</strong> throw error when user is not authorized to edit users
 	 * <strong>Should</strong> remove user property for given user and key
 	 */
+	@Authorized
 	public User removeUserProperty(User user, String key) throws APIException;
 	
 	/**
@@ -493,6 +503,7 @@ public interface UserService extends OpenmrsService {
 	 * 
 	 * @return new system id
 	 */
+	@Authorized
 	public String generateSystemId();
 	
 	/**
@@ -562,6 +573,7 @@ public List<User> getUsers(String name, List<Role> roles, boolean includeRetired
 	 * Sets a user's activation key
 	 * @param user The user for which the activation key will be set
 	 */
+	@Authorized(PrivilegeConstants.EDIT_USER_PASSWORDS)
 	public User setUserActivationKey(User user) throws MessageException;
 	
 	/**
@@ -577,6 +589,7 @@ public List<User> getUsers(String name, List<Role> roles, boolean includeRetired
 	 * @return the default Locale of the given user, or the system locale if unspecified
 	 * @since 2.3.6, 2.4.6, 2.5.4, 2.6.0
 	 */
+	@Authorized
 	Locale getDefaultLocaleForUser(User user);
 
 	/**
@@ -586,5 +599,6 @@ public List<User> getUsers(String name, List<Role> roles, boolean includeRetired
 	 * @return timestamp representing last login time (e.g. 1717414410587)
 	 * @since 2.7.0
 	 */
+	@Authorized(PrivilegeConstants.GET_USERS)
 	String getLastLoginTime(User user);
 }
diff --git a/api/src/main/java/org/openmrs/api/context/UserContext.java b/api/src/main/java/org/openmrs/api/context/UserContext.java
index c98ff9117309..8539b89be731 100755
--- a/api/src/main/java/org/openmrs/api/context/UserContext.java
+++ b/api/src/main/java/org/openmrs/api/context/UserContext.java
@@ -323,6 +323,14 @@ public Set<Role> getAllRoles(User user) throws Exception {
 	 * <strong>Should</strong> not authorize if anonymous user does not have specified privilege
 	 */
 	public boolean hasPrivilege(String privilege) {
+		log.debug("Checking '{}' against proxies: {}", privilege, proxies);
+		// check proxied privileges
+		for (String s : proxies) {
+			if (s.equals(privilege)) {
+				notifyPrivilegeListeners(getAuthenticatedUser(), privilege, true);
+				return true;
+			}
+		}
 		
 		// if a user has logged in, check their privileges
 		if (isAuthenticated()
@@ -334,16 +342,6 @@ public boolean hasPrivilege(String privilege) {
 			
 		}
 		
-		log.debug("Checking '{}' against proxies: {}", privilege, proxies);
-		
-		// check proxied privileges
-		for (String s : proxies) {
-			if (s.equals(privilege)) {
-				notifyPrivilegeListeners(getAuthenticatedUser(), privilege, true);
-				return true;
-			}
-		}
-		
 		if (getAnonymousRole().hasPrivilege(privilege)) {
 			notifyPrivilegeListeners(getAuthenticatedUser(), privilege, true);
 			return true;

From 23a1370e5655f764a898edbd9bb936366dacec41 Mon Sep 17 00:00:00 2001
From: rkorytkowski <rafal.korytkowski@gmail.com>
Date: Thu, 22 Aug 2024 17:09:17 +0200
Subject: [PATCH 093/163] TRUNK-6259: Fixing last login time authorization
 check

---
 api/src/main/java/org/openmrs/api/UserService.java | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/api/src/main/java/org/openmrs/api/UserService.java b/api/src/main/java/org/openmrs/api/UserService.java
index ec507564fdc8..f537d76e5d66 100644
--- a/api/src/main/java/org/openmrs/api/UserService.java
+++ b/api/src/main/java/org/openmrs/api/UserService.java
@@ -598,7 +598,11 @@ public List<User> getUsers(String name, List<Role> roles, boolean includeRetired
 	 * @param user the subject user
 	 * @return timestamp representing last login time (e.g. 1717414410587)
 	 * @since 2.7.0
+	 * 
+	 * @should return empty string on last login time if a different user is logged in
+	 * @should not be empty if user is authenticated
+	 * @should return empty string on last login time if property not set
 	 */
-	@Authorized(PrivilegeConstants.GET_USERS)
+	@Authorized
 	String getLastLoginTime(User user);
 }

From ad2d72769d9806ee86a4388051805b02a6b7f246 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 22 Aug 2024 23:11:18 +0300
Subject: [PATCH 094/163] maven(deps): bump org.postgresql:postgresql from
 42.7.3 to 42.7.4 (#4729)

Bumps [org.postgresql:postgresql](https://github.com/pgjdbc/pgjdbc) from 42.7.3 to 42.7.4.
- [Release notes](https://github.com/pgjdbc/pgjdbc/releases)
- [Changelog](https://github.com/pgjdbc/pgjdbc/blob/master/CHANGELOG.md)
- [Commits](https://github.com/pgjdbc/pgjdbc/compare/REL42.7.3...REL42.7.4)

---
updated-dependencies:
- dependency-name: org.postgresql:postgresql
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 2996811d95eb..55332f2933e6 100644
--- a/pom.xml
+++ b/pom.xml
@@ -405,7 +405,7 @@
 			<dependency>
 				<groupId>org.postgresql</groupId>
 				<artifactId>postgresql</artifactId>
-				<version>42.7.3</version>
+				<version>42.7.4</version>
 				<scope>runtime</scope>
 			</dependency>
 			<dependency>

From 3aaa3d17e314186e85f3c862b5b8d71d500b410a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 22 Aug 2024 23:11:55 +0300
Subject: [PATCH 095/163] maven(deps): bump
 org.apache.maven.plugins:maven-dependency-plugin (#4728)

Bumps [org.apache.maven.plugins:maven-dependency-plugin](https://github.com/apache/maven-dependency-plugin) from 3.7.1 to 3.8.0.
- [Release notes](https://github.com/apache/maven-dependency-plugin/releases)
- [Commits](https://github.com/apache/maven-dependency-plugin/compare/maven-dependency-plugin-3.7.1...maven-dependency-plugin-3.8.0)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-dependency-plugin
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 55332f2933e6..827669967009 100644
--- a/pom.xml
+++ b/pom.xml
@@ -947,7 +947,7 @@
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-dependency-plugin</artifactId>
-				<version>3.7.1</version>
+				<version>3.8.0</version>
 			</plugin>
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>

From 991cbc6dbeaa8d971e45dae6a64410f172818b68 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 22 Aug 2024 23:13:28 +0300
Subject: [PATCH 096/163] maven(deps): bump
 org.apache.maven.plugins:maven-jxr-plugin (#4727)

Bumps [org.apache.maven.plugins:maven-jxr-plugin](https://github.com/apache/maven-jxr) from 3.4.0 to 3.5.0.
- [Release notes](https://github.com/apache/maven-jxr/releases)
- [Commits](https://github.com/apache/maven-jxr/compare/jxr-3.4.0...jxr-3.5.0)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-jxr-plugin
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 827669967009..0e2411b7cfae 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1158,7 +1158,7 @@
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-jxr-plugin</artifactId>
-				<version>3.4.0</version>
+				<version>3.5.0</version>
 			</plugin>
 		</plugins>
 	</reporting>

From 6c6c31e96600acb87879df72c0bad08c4bf1ed8a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 22 Aug 2024 23:14:09 +0300
Subject: [PATCH 097/163] maven(deps): bump
 org.apache.maven.plugins:maven-checkstyle-plugin (#4726)

Bumps [org.apache.maven.plugins:maven-checkstyle-plugin](https://github.com/apache/maven-checkstyle-plugin) from 3.4.0 to 3.5.0.
- [Commits](https://github.com/apache/maven-checkstyle-plugin/compare/maven-checkstyle-plugin-3.4.0...maven-checkstyle-plugin-3.5.0)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-checkstyle-plugin
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 0e2411b7cfae..d30a82d39850 100644
--- a/pom.xml
+++ b/pom.xml
@@ -689,7 +689,7 @@
 				<plugin>
 					<groupId>org.apache.maven.plugins</groupId>
 					<artifactId>maven-checkstyle-plugin</artifactId>
-					<version>3.4.0</version>
+					<version>3.5.0</version>
 					<configuration>
 						<configLocation>checkstyle.xml</configLocation>
 					</configuration>

From 522c3dc4319c17e4abbffc3e186b1034a5b1e886 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 25 Aug 2024 00:19:44 +0300
Subject: [PATCH 098/163] maven(deps): bump net.bytebuddy:byte-buddy-agent from
 1.14.19 to 1.15.0 (#4730)

Bumps [net.bytebuddy:byte-buddy-agent](https://github.com/raphw/byte-buddy) from 1.14.19 to 1.15.0.
- [Release notes](https://github.com/raphw/byte-buddy/releases)
- [Changelog](https://github.com/raphw/byte-buddy/blob/master/release-notes.md)
- [Commits](https://github.com/raphw/byte-buddy/compare/byte-buddy-1.14.19...byte-buddy-1.15.0)

---
updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy-agent
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index d30a82d39850..6a0655b1c808 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1134,7 +1134,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy-agent</artifactId>
-						<version>1.14.19</version>
+						<version>1.15.0</version>
 					</dependency>
 				</dependencies>
 			</dependencyManagement>

From 5cf15063f0a996432cf88c39e62030404c6ba92b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 25 Aug 2024 00:19:56 +0300
Subject: [PATCH 099/163] maven(deps): bump net.bytebuddy:byte-buddy from
 1.14.19 to 1.15.0 (#4731)

Bumps [net.bytebuddy:byte-buddy](https://github.com/raphw/byte-buddy) from 1.14.19 to 1.15.0.
- [Release notes](https://github.com/raphw/byte-buddy/releases)
- [Changelog](https://github.com/raphw/byte-buddy/blob/master/release-notes.md)
- [Commits](https://github.com/raphw/byte-buddy/compare/byte-buddy-1.14.19...byte-buddy-1.15.0)

---
updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 6a0655b1c808..88bdf7160378 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1129,7 +1129,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy</artifactId>
-						<version>1.14.19</version>
+						<version>1.15.0</version>
 					</dependency>
 					<dependency>
 						<groupId>net.bytebuddy</groupId>

From af1c46c8255447fc4f16355edadacbe3eb340ecf Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 27 Aug 2024 22:22:23 +0300
Subject: [PATCH 100/163] maven(deps): bump
 org.apache.maven.plugins:maven-javadoc-plugin (#4732)

Bumps [org.apache.maven.plugins:maven-javadoc-plugin](https://github.com/apache/maven-javadoc-plugin) from 3.8.0 to 3.10.0.
- [Release notes](https://github.com/apache/maven-javadoc-plugin/releases)
- [Commits](https://github.com/apache/maven-javadoc-plugin/compare/maven-javadoc-plugin-3.8.0...maven-javadoc-plugin-3.10.0)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-javadoc-plugin
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pom.xml b/pom.xml
index 88bdf7160378..e2f51345e12f 100644
--- a/pom.xml
+++ b/pom.xml
@@ -730,7 +730,7 @@
 				<plugin>
 					<groupId>org.apache.maven.plugins</groupId>
 					<artifactId>maven-javadoc-plugin</artifactId>
-					<version>3.8.0</version>
+					<version>3.10.0</version>
 					<configuration>
 						<!-- For some reason some packages from org.springframework are being
 						included and causing errors. -->
@@ -1147,7 +1147,7 @@
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-javadoc-plugin</artifactId>
-				<version>3.8.0</version>
+				<version>3.10.0</version>
 				<configuration>
 					<docfilessubdirs>true</docfilessubdirs>
 					<bottom>&lt;em&gt;&lt;small&gt; Generated ${TIMESTAMP} NOTE - these libraries are in active development and subject to change&lt;/small&gt;&lt;/em&gt;</bottom>

From 468e8503137fb036b2897b3edef88829d7d62832 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 28 Aug 2024 13:20:47 +0300
Subject: [PATCH 101/163] maven(deps): bump
 org.apache.maven.plugins:maven-surefire-plugin (#4733)

Bumps [org.apache.maven.plugins:maven-surefire-plugin](https://github.com/apache/maven-surefire) from 3.4.0 to 3.5.0.
- [Release notes](https://github.com/apache/maven-surefire/releases)
- [Commits](https://github.com/apache/maven-surefire/compare/surefire-3.4.0...surefire-3.5.0)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-surefire-plugin
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pom.xml b/pom.xml
index e2f51345e12f..e0b13da5f72f 100644
--- a/pom.xml
+++ b/pom.xml
@@ -603,7 +603,7 @@
 				<plugin>
 					<groupId>org.apache.maven.plugins</groupId>
 					<artifactId>maven-surefire-plugin</artifactId>
-					<version>3.4.0</version>
+					<version>3.5.0</version>
 				</plugin>
 				<plugin>
 					<groupId>org.apache.maven.plugins</groupId>
@@ -935,7 +935,7 @@
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-surefire-plugin</artifactId>
-				<version>3.4.0</version>
+				<version>3.5.0</version>
 				<configuration>
 					<failIfNoTests>false</failIfNoTests>
 					<useSystemClassLoader>false</useSystemClassLoader>

From 683628587aaf6439341b1dca421658b5646c3bb9 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 29 Aug 2024 22:19:05 +0300
Subject: [PATCH 102/163] maven(deps): bump net.bytebuddy:byte-buddy from
 1.15.0 to 1.15.1 (#4735)

Bumps [net.bytebuddy:byte-buddy](https://github.com/raphw/byte-buddy) from 1.15.0 to 1.15.1.
- [Release notes](https://github.com/raphw/byte-buddy/releases)
- [Changelog](https://github.com/raphw/byte-buddy/blob/master/release-notes.md)
- [Commits](https://github.com/raphw/byte-buddy/compare/byte-buddy-1.15.0...byte-buddy-1.15.1)

---
updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index e0b13da5f72f..2075dcb31469 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1129,7 +1129,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy</artifactId>
-						<version>1.15.0</version>
+						<version>1.15.1</version>
 					</dependency>
 					<dependency>
 						<groupId>net.bytebuddy</groupId>

From d32aaca1b14c1cdb4a37a6a3f11b975a0efe5533 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 29 Aug 2024 22:19:50 +0300
Subject: [PATCH 103/163] maven(deps): bump net.bytebuddy:byte-buddy-agent from
 1.15.0 to 1.15.1 (#4736)

Bumps [net.bytebuddy:byte-buddy-agent](https://github.com/raphw/byte-buddy) from 1.15.0 to 1.15.1.
- [Release notes](https://github.com/raphw/byte-buddy/releases)
- [Changelog](https://github.com/raphw/byte-buddy/blob/master/release-notes.md)
- [Commits](https://github.com/raphw/byte-buddy/compare/byte-buddy-1.15.0...byte-buddy-1.15.1)

---
updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy-agent
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 2075dcb31469..4dd58ccb1e7b 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1134,7 +1134,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy-agent</artifactId>
-						<version>1.15.0</version>
+						<version>1.15.1</version>
 					</dependency>
 				</dependencies>
 			</dependencyManagement>

From 444f88df8c283bd26f71f0ba558b437d3988313b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 31 Aug 2024 23:16:22 +0300
Subject: [PATCH 104/163] maven(deps): bump org.apache.commons:commons-lang3
 from 3.16.0 to 3.17.0 (#4737)

Bumps org.apache.commons:commons-lang3 from 3.16.0 to 3.17.0.

---
updated-dependencies:
- dependency-name: org.apache.commons:commons-lang3
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 4dd58ccb1e7b..4b60417a1591 100644
--- a/pom.xml
+++ b/pom.xml
@@ -177,7 +177,7 @@
 			<dependency>
 				<groupId>org.apache.commons</groupId>
 				<artifactId>commons-lang3</artifactId>
-				<version>3.16.0</version>
+				<version>3.17.0</version>
 			</dependency>
 			<dependency>
 				<groupId>org.springframework</groupId>

From 9ccb69cd994b13f063830c1839a50897ac68d2a3 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 3 Sep 2024 22:05:26 +0300
Subject: [PATCH 105/163] maven(deps): bump
 org.codehaus.mojo:buildnumber-maven-plugin (#4738)

Bumps [org.codehaus.mojo:buildnumber-maven-plugin](https://github.com/mojohaus/buildnumber-maven-plugin) from 3.2.0 to 3.2.1.
- [Release notes](https://github.com/mojohaus/buildnumber-maven-plugin/releases)
- [Commits](https://github.com/mojohaus/buildnumber-maven-plugin/compare/3.2.0...3.2.1)

---
updated-dependencies:
- dependency-name: org.codehaus.mojo:buildnumber-maven-plugin
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 4b60417a1591..f908c75f8766 100644
--- a/pom.xml
+++ b/pom.xml
@@ -649,7 +649,7 @@
 				<plugin>
 					<groupId>org.codehaus.mojo</groupId>
 					<artifactId>buildnumber-maven-plugin</artifactId>
-					<version>3.2.0</version>
+					<version>3.2.1</version>
 					<configuration>
 						<buildNumberPropertyName>revisionNumber</buildNumberPropertyName>
 						<getRevisionOnlyOnce>true</getRevisionOnlyOnce>

From 687abd3fd5a66d2e424e52707d33c1ced4c8fc64 Mon Sep 17 00:00:00 2001
From: Wikum Weerakutti <wikum@linuxdeveloper.space>
Date: Thu, 5 Sep 2024 16:38:21 +0300
Subject: [PATCH 106/163] O3-3428: Update the DockerFile to support openmrs_spa
 (#4740)

---
 startup-init.sh | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/startup-init.sh b/startup-init.sh
index f475648b728f..9931150387e2 100644
--- a/startup-init.sh
+++ b/startup-init.sh
@@ -75,6 +75,7 @@ OMRS_DISTRO_CORE="$OMRS_DISTRO_DIR/openmrs_core"
 OMRS_DISTRO_MODULES="$OMRS_DISTRO_DIR/openmrs_modules"
 OMRS_DISTRO_OWAS="$OMRS_DISTRO_DIR/openmrs_owas"
 OMRS_DISTRO_CONFIG="$OMRS_DISTRO_DIR/openmrs_config"
+OMRS_DISTRO_FRONTEND="$OMRS_DISTRO_DIR/openmrs_spa"
 
 # Each of these mounted directories are used to populate expected configurations on the server, defined here
 
@@ -82,21 +83,24 @@ OMRS_DATA_DIR="$OMRS_HOME/data"
 OMRS_MODULES_DIR="$OMRS_DATA_DIR/modules"
 OMRS_OWA_DIR="$OMRS_DATA_DIR/owa"
 OMRS_CONFIG_DIR="$OMRS_DATA_DIR/configuration"
+OMRS_FRONTEND_DIR="$OMRS_OMRS_DATA_DIR/frontend"
 
 OMRS_SERVER_PROPERTIES_FILE="$OMRS_HOME/$OMRS_WEBAPP_NAME-server.properties"
 OMRS_RUNTIME_PROPERTIES_FILE="$OMRS_DATA_DIR/$OMRS_WEBAPP_NAME-runtime.properties"
 
-echo "Deleting modules, OWAs and configuration from OpenMRS"
+echo "Deleting modules, OWAs, configuration and frontend from OpenMRS"
 
 rm -fR "${OMRS_MODULES_DIR:?}/*"
 rm -fR "${OMRS_OWA_DIR:?}/*"
 rm -fR "${OMRS_CONFIG_DIR:?}/*"
+rm -fR "${OMRS_FRONTEND_DIR:?}/*"
 
 echo "Loading distribution artifacts into OpenMRS"
 
 [ -d "$OMRS_DISTRO_MODULES" ] && cp -R "$OMRS_DISTRO_MODULES/." "$OMRS_MODULES_DIR"
 [ -d "$OMRS_DISTRO_OWAS" ] && cp -R "$OMRS_DISTRO_OWAS/." "$OMRS_OWA_DIR"
 [ -d "$OMRS_DISTRO_CONFIG" ] && cp -R "$OMRS_DISTRO_CONFIG/." "$OMRS_CONFIG_DIR"
+[ -d "$OMRS_DISTRO_FRONTEND" ] && cp -R "$OMRS_DISTRO_FRONTEND/." "$OMRS_FRONTEND_DIR"
 
 # Setup database configuration properties
 if [[ -z $OMRS_DB || "$OMRS_DB" == "mysql" ]]; then

From 03a87deca5832dfd3829307de93ecf48bad2ef92 Mon Sep 17 00:00:00 2001
From: Wikum Weerakutti <wikum@linuxdeveloper.space>
Date: Thu, 5 Sep 2024 17:44:43 +0300
Subject: [PATCH 107/163] Fixing the typo (#4741)

---
 startup-init.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/startup-init.sh b/startup-init.sh
index 9931150387e2..f6a4511e20cd 100644
--- a/startup-init.sh
+++ b/startup-init.sh
@@ -83,7 +83,7 @@ OMRS_DATA_DIR="$OMRS_HOME/data"
 OMRS_MODULES_DIR="$OMRS_DATA_DIR/modules"
 OMRS_OWA_DIR="$OMRS_DATA_DIR/owa"
 OMRS_CONFIG_DIR="$OMRS_DATA_DIR/configuration"
-OMRS_FRONTEND_DIR="$OMRS_OMRS_DATA_DIR/frontend"
+OMRS_FRONTEND_DIR="$OMRS_DATA_DIR/frontend"
 
 OMRS_SERVER_PROPERTIES_FILE="$OMRS_HOME/$OMRS_WEBAPP_NAME-server.properties"
 OMRS_RUNTIME_PROPERTIES_FILE="$OMRS_DATA_DIR/$OMRS_WEBAPP_NAME-runtime.properties"

From e883c9b5c0ca7442d8a1ed47798b8e10710be9ac Mon Sep 17 00:00:00 2001
From: dkayiwa <dkayiwa@openmrs.org>
Date: Fri, 6 Sep 2024 11:08:37 +0300
Subject: [PATCH 108/163] TRUNK-6263 AuthorizationAdvice should check for
 daemon thread

---
 api/src/main/java/org/openmrs/aop/AuthorizationAdvice.java | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/api/src/main/java/org/openmrs/aop/AuthorizationAdvice.java b/api/src/main/java/org/openmrs/aop/AuthorizationAdvice.java
index 4673fffbfebf..baab29b6e9e2 100644
--- a/api/src/main/java/org/openmrs/aop/AuthorizationAdvice.java
+++ b/api/src/main/java/org/openmrs/aop/AuthorizationAdvice.java
@@ -17,6 +17,7 @@
 import org.openmrs.annotation.AuthorizedAnnotationAttributes;
 import org.openmrs.api.APIAuthenticationException;
 import org.openmrs.api.context.Context;
+import org.openmrs.api.context.Daemon;
 import org.openmrs.util.PrivilegeConstants;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -55,6 +56,10 @@ public void before(Method method, Object[] args, Object target) throws Throwable
 			}
 		}
 		
+		if (Daemon.isDaemonThread()) {
+			return;
+		}
+		
 		AuthorizedAnnotationAttributes attributes = new AuthorizedAnnotationAttributes();
 		Collection<String> privileges = attributes.getAttributes(method);
 		boolean requireAll = attributes.getRequireAll(method);

From 1ea43f3f799bbd05a651b1407078793f3b3e6393 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 9 Sep 2024 23:20:45 +0300
Subject: [PATCH 109/163] maven(deps): bump log4jVersion from 2.22.1 to 2.24.0
 (#4743)

Bumps `log4jVersion` from 2.22.1 to 2.24.0.

Updates `org.apache.logging.log4j:log4j-core` from 2.22.1 to 2.24.0

Updates `org.apache.logging.log4j:log4j-slf4j-impl` from 2.22.1 to 2.24.0

Updates `org.apache.logging.log4j:log4j-1.2-api` from 2.22.1 to 2.24.0

---
updated-dependencies:
- dependency-name: org.apache.logging.log4j:log4j-core
  dependency-type: direct:production
  update-type: version-update:semver-minor
- dependency-name: org.apache.logging.log4j:log4j-slf4j-impl
  dependency-type: direct:production
  update-type: version-update:semver-minor
- dependency-name: org.apache.logging.log4j:log4j-1.2-api
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index f908c75f8766..25df3e25aed9 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1222,7 +1222,7 @@
 		<hamcrestVersion>3.0</hamcrestVersion>
 
 		<slf4jVersion>1.7.36</slf4jVersion>
-		<log4jVersion>2.22.1</log4jVersion>
+		<log4jVersion>2.24.0</log4jVersion>
 		<owaspCsrfGuardVersion>4.2.1</owaspCsrfGuardVersion>
 
 		<customArgLineForTesting />

From 3a5039a073cfcae8f3993b8ca84537ccd6800c4d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 Sep 2024 23:53:32 +0300
Subject: [PATCH 110/163] maven(deps): bump joda-time:joda-time from 2.12.7 to
 2.13.0 (#4748)

Bumps [joda-time:joda-time](https://github.com/JodaOrg/joda-time) from 2.12.7 to 2.13.0.
- [Release notes](https://github.com/JodaOrg/joda-time/releases)
- [Changelog](https://github.com/JodaOrg/joda-time/blob/main/RELEASE-NOTES.txt)
- [Commits](https://github.com/JodaOrg/joda-time/compare/v2.12.7...v2.13.0)

---
updated-dependencies:
- dependency-name: joda-time:joda-time
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 25df3e25aed9..c5126a4b640d 100644
--- a/pom.xml
+++ b/pom.xml
@@ -548,7 +548,7 @@
 			<dependency>
 			  <groupId>joda-time</groupId>
 			  <artifactId>joda-time</artifactId>
-			  <version>2.12.7</version>
+			  <version>2.13.0</version>
 			</dependency>
 			<dependency>
 			    <groupId>javax.annotation</groupId>

From e7eb6ffb566fdb2bbad2672110447cb6ac552fd0 Mon Sep 17 00:00:00 2001
From: Lubwama Samuel <lubwamasamuel3@gmail.com>
Date: Tue, 17 Sep 2024 12:21:26 +0300
Subject: [PATCH 111/163] Resolve 3.4.1 (#4742)

* Resolve 3.4.1

* Changing to global exception class of spring

* Adding java.lang errors too

* remove all and only keep java.lang.Exception
---
 web/src/main/resources/openmrs-servlet.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/web/src/main/resources/openmrs-servlet.xml b/web/src/main/resources/openmrs-servlet.xml
index 3b4f15e1d056..f9eea739ac59 100644
--- a/web/src/main/resources/openmrs-servlet.xml
+++ b/web/src/main/resources/openmrs-servlet.xml
@@ -90,8 +90,8 @@
  		 
  	<bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver"> 
  		<property name="exceptionMappings"> 
- 			<map> 
- 				<entry key="org.openmrs.api.APIException" value="uncaughtException"/> 
+ 			<map>
+				<entry key="java.lang.Exception" value="uncaughtException"/>
  			</map> 
  		</property> 
  		<property name="order" value="100" /> 

From 76aff597e100abba3cc604a18965c8bb5e79a0f6 Mon Sep 17 00:00:00 2001
From: Ssegujja Joseph Bate <38130891+josephbate@users.noreply.github.com>
Date: Tue, 17 Sep 2024 23:02:20 +0300
Subject: [PATCH 112/163] TRUNK-6241: Fix DTD for conditional modules (#4746)

---
 .../main/resources/org/openmrs/module/dtd/config-1.6.dtd    | 6 +++---
 .../main/resources/org/openmrs/module/dtd/config-1.7.dtd    | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/api/src/main/resources/org/openmrs/module/dtd/config-1.6.dtd b/api/src/main/resources/org/openmrs/module/dtd/config-1.6.dtd
index 199805acccf8..2b15c253d09d 100644
--- a/api/src/main/resources/org/openmrs/module/dtd/config-1.6.dtd
+++ b/api/src/main/resources/org/openmrs/module/dtd/config-1.6.dtd
@@ -115,9 +115,9 @@
 	<!ELEMENT packagesWithMappedClasses (#PCDATA)>
 	
 	<!ELEMENT conditionalResources (conditionalResource+)>
-	<!ELEMENT conditionalResource (path, (openmrsVersion | loadIfModulesPresent))>
+	<!ELEMENT conditionalResource (path, (openmrsVersion | modules))>
 	<!ELEMENT path (#PCDATA)>
 	<!ELEMENT openmrsVersion (#PCDATA)>
-	<!ELEMENT loadIfModulesPresent (openmrsModule+)>
-	<!ELEMENT openmrsModule (moduleId, version)>
+	<!ELEMENT modules (module+)>
+	<!ELEMENT module (moduleId, version)>
 	<!ELEMENT moduleId (#PCDATA)>
diff --git a/api/src/main/resources/org/openmrs/module/dtd/config-1.7.dtd b/api/src/main/resources/org/openmrs/module/dtd/config-1.7.dtd
index 7226bc82ae77..ade80287b584 100644
--- a/api/src/main/resources/org/openmrs/module/dtd/config-1.7.dtd
+++ b/api/src/main/resources/org/openmrs/module/dtd/config-1.7.dtd
@@ -115,9 +115,9 @@
 	<!ELEMENT packagesWithMappedClasses (#PCDATA)>
 	
 	<!ELEMENT conditionalResources (conditionalResource+)>
-	<!ELEMENT conditionalResource (path, (openmrsVersion | loadIfModulesPresent))>
+	<!ELEMENT conditionalResource (path, (openmrsVersion | modules))>
 	<!ELEMENT path (#PCDATA)>
 	<!ELEMENT openmrsVersion (#PCDATA)>
-	<!ELEMENT loadIfModulesPresent (openmrsModule+)>
-	<!ELEMENT openmrsModule (moduleId, version)>
+	<!ELEMENT modules (module+)>
+	<!ELEMENT module (moduleId, version)>
 	<!ELEMENT moduleId (#PCDATA)>

From 117b775acf0bc7792eecb90819f9b81ecc17665b Mon Sep 17 00:00:00 2001
From: logresearch <log.researchovo@gmail.com>
Date: Wed, 18 Sep 2024 20:50:02 +0800
Subject: [PATCH 113/163] fix typo in logging message (#4680)

---
 .../databasechange/DuplicateEncounterTypeNameChangeSet.java     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/api/src/main/java/org/openmrs/util/databasechange/DuplicateEncounterTypeNameChangeSet.java b/api/src/main/java/org/openmrs/util/databasechange/DuplicateEncounterTypeNameChangeSet.java
index 00a6e19c6847..32053c713e25 100644
--- a/api/src/main/java/org/openmrs/util/databasechange/DuplicateEncounterTypeNameChangeSet.java
+++ b/api/src/main/java/org/openmrs/util/databasechange/DuplicateEncounterTypeNameChangeSet.java
@@ -143,7 +143,7 @@ public void execute(Database database) throws CustomChangeException {
 			}
 		}
 		catch (BatchUpdateException e) {
-			log.warn("Error generated while processsing batch insert", e);
+			log.warn("Error generated while processing batch insert", e);
 			
 			try {
 				log.debug("Rolling back batch", e);

From bc725f242b28948674ea21c19ce15b083f15b028 Mon Sep 17 00:00:00 2001
From: Mark Goodrich <mgoodrich@pih.org>
Date: Thu, 19 Sep 2024 06:00:18 -0400
Subject: [PATCH 114/163] TRUNK-6265: Bugs in Concept.getPreferredName(Locale)
 method (#4749)

---
 api/src/main/java/org/openmrs/Concept.java    | 58 ++++++++++---------
 .../test/java/org/openmrs/ConceptTest.java    | 57 ++++++++++++++++++
 2 files changed, 89 insertions(+), 26 deletions(-)

diff --git a/api/src/main/java/org/openmrs/Concept.java b/api/src/main/java/org/openmrs/Concept.java
index 8a1753b29f55..9c1ed73b456c 100644
--- a/api/src/main/java/org/openmrs/Concept.java
+++ b/api/src/main/java/org/openmrs/Concept.java
@@ -381,7 +381,7 @@ public void setPreferredName(ConceptName preferredName) {
 		}
 		
 		//first revert the current preferred name(if any) from being preferred
-		ConceptName oldPreferredName = getPreferredName(preferredName.getLocale());
+		ConceptName oldPreferredName = getPreferredName(preferredName.getLocale(), true);
 		if (oldPreferredName != null) {
 			oldPreferredName.setLocalePreferred(false);
 		}
@@ -633,24 +633,26 @@ private ConceptName getNameInLocale(Locale locale) {
 		return null;
 	}
 	
+	public ConceptName getPreferredName(Locale forLocale) {
+		return getPreferredName(forLocale, false);
+	}
+	
 	/**
 	 * Returns the name which is explicitly marked as preferred for a given locale.
 	 * 
 	 * @param forLocale locale for which to return a preferred name
 	 * @return preferred name for the locale, or null if no preferred name is specified
 	 * <strong>Should</strong> return the concept name explicitly marked as locale preferred
-	 * <strong>Should</strong> return the fully specified name if no name is explicitly marked as locale preferred
+	 * <strong>Should</strong> return the concept name marked as locale preferred a partial match locale (same language but different country) if no exact match and exact set to false
+	 * <strong>Should</strong> return the fully specified name if no name is explicitly marked as locale preferred and exact set to false
 	 */
-	public ConceptName getPreferredName(Locale forLocale) {
+	public ConceptName getPreferredName(Locale forLocale, Boolean exact) {
 		
 		if (log.isDebugEnabled()) {
 			log.debug("Getting preferred conceptName for locale: " + forLocale);
 		}
-		// fail early if this concept has no names defined
-		if (getNames(forLocale).isEmpty()) {
-			log.debug("there are no names defined for concept with id: {} in the locale: {}", conceptId, forLocale);
-			return null;
-		} else if (forLocale == null) {
+		
+		if (forLocale == null) {
 			log.warn("Locale cannot be null");
 			return null;
 		}
@@ -661,26 +663,30 @@ public ConceptName getPreferredName(Locale forLocale) {
 			}
 		}
 		
-		// look for partially locale match - any language matches takes precedence over country matches.
-		ConceptName bestMatch = null;
-		
-		for (ConceptName nameInLocale : getPartiallyCompatibleNames(forLocale)) {
-			if (ObjectUtils.nullSafeEquals(nameInLocale.getLocalePreferred(), true)) {
-				Locale nameLocale = nameInLocale.getLocale();
-				if (forLocale.getLanguage().equals(nameLocale.getLanguage())) {
-					return nameInLocale;
-				} else {
-					bestMatch = nameInLocale;
+		if (exact) {
+			return null;
+		} else {
+			// look for partially locale match - any language matches takes precedence over country matches.
+			ConceptName bestMatch = null;
+
+			for (ConceptName nameInLocale : getPartiallyCompatibleNames(forLocale)) {
+				if (ObjectUtils.nullSafeEquals(nameInLocale.getLocalePreferred(), true)) {
+					Locale nameLocale = nameInLocale.getLocale();
+					if (forLocale.getLanguage().equals(nameLocale.getLanguage())) {
+						return nameInLocale;
+					} else {
+						bestMatch = nameInLocale;
+					}
+
 				}
-				
 			}
+
+			if (bestMatch != null) {
+				return bestMatch;
+			}
+
+			return getFullySpecifiedName(forLocale);
 		}
-		
-		if (bestMatch != null) {
-			return bestMatch;
-		}
-		
-		return getFullySpecifiedName(forLocale);
 	}
 	
 	/**
@@ -1014,7 +1020,7 @@ public void addName(ConceptName conceptName) {
 					conceptName.setConceptNameType(ConceptNameType.FULLY_SPECIFIED);
 				} else {
 					if (conceptName.isPreferred() && !conceptName.isIndexTerm() && conceptName.getLocale() != null) {
-						ConceptName prefName = getPreferredName(conceptName.getLocale());
+						ConceptName prefName = getPreferredName(conceptName.getLocale(), true);
 						if (prefName != null) {
 							prefName.setLocalePreferred(false);
 						}
diff --git a/api/src/test/java/org/openmrs/ConceptTest.java b/api/src/test/java/org/openmrs/ConceptTest.java
index 278fdeb956bc..e8c92fab29c1 100644
--- a/api/src/test/java/org/openmrs/ConceptTest.java
+++ b/api/src/test/java/org/openmrs/ConceptTest.java
@@ -753,6 +753,42 @@ public void getPreferredName_shouldReturnTheConceptNameExplicitlyMarkedAsLocaleP
 		assertEquals(preferredNameEN, testConcept.getPreferredName(new Locale("en")));
 	}
 	
+	@Test
+	public void getPreferredName_shouldReturnPreferredNameInLocaleWithCountryIfNoPreferredNameInLocaleWithNoCountry() {
+		Concept color = new Concept();
+		// add a name in en but *not* set as preferred
+		ConceptName preferredNameEN = createConceptName(3, "Color", new Locale("en"), null, false);
+		color.addName(preferredNameEN);
+		//preferred name in en_UK
+		ConceptName preferredNameEN_UK = createConceptName(4, "Colour", Locale.UK, null, true);
+		color.addName(preferredNameEN_UK);
+		// we ask for preferred name in en, but since none of the en names are preferred, we should get the en_UK name
+		assertEquals(preferredNameEN_UK, color.getPreferredName(new Locale("en")));
+	}
+
+	@Test
+	public void getPreferredName_shouldReturnPreferredNameInLocaleWithCountryIfNoNameInLocaleWithNoCountry() {
+		Concept color = new Concept();
+		//preferred name in en_UK
+		ConceptName preferredNameEN_UK = createConceptName(4, "Colour", Locale.UK, null, true);
+		color.addName(preferredNameEN_UK);
+		// we ask for preferred name in en, but since none of the en names are preferred, we should get the en_UK name
+		assertEquals(preferredNameEN_UK, color.getPreferredName(new Locale("en")));
+	}
+
+	@Test
+	public void getPreferredName_shouldReturnPreferredNameInLocaleWithoutCountryBeforeLocaleWithCountry() {
+		Concept color = new Concept();
+		// preferred name in en_UK
+		ConceptName preferredNameEN_UK = createConceptName(4, "Colour", Locale.UK, null, true);
+		color.addName(preferredNameEN_UK);
+		// preferred name in en
+		ConceptName preferredNameEN = createConceptName(3, "Color", new Locale("en"), null, true);
+		color.addName(preferredNameEN);
+		// we ask for preferred name in en_US; there are no names in en_US, but it should "prefer" "en" over "en_UK"
+		assertEquals(preferredNameEN, color.getPreferredName(new Locale("en")));
+	}
+	
 	/**
 	 * @see Concept#getShortestName(Locale,Boolean)
 	 */
@@ -901,6 +937,27 @@ public void setPreferredName_shouldFailIfThePreferredNameToSetToIsAnIndexTerm()
 		assertThrows(APIException.class, () -> concept.setPreferredName(preferredName));
 	}
 	
+	@Test
+	public void setPreferredName_shouldNotSetPreferredNameInDifferentCountryLocaleToNotPreferred() {
+		Concept concept = new Concept();
+		// set non-preferred name in en_US (due to an idiosyncrasy we need to set this to manifest the bug)
+		ConceptName nonPreferredNameInUS = new ConceptName("Col", Locale.US);
+		nonPreferredNameInUS.setLocalePreferred(false);
+		concept.addName(nonPreferredNameInUS);
+		// set preferred name in en_UK
+		ConceptName preferredNameInUK = new ConceptName("Colour", Locale.UK);
+		preferredNameInUK.setLocalePreferred(true);
+		concept.addName(preferredNameInUK);
+		// now set preferred name in en_US
+		ConceptName preferredNameInUS = new ConceptName("Color", Locale.US);
+		preferredNameInUS.setLocalePreferred(true);
+		concept.addName(preferredNameInUS);
+		assertThat(nonPreferredNameInUS.getLocalePreferred(), is(false));
+		assertThat(preferredNameInUK.getLocalePreferred(), is(true));
+		assertThat(preferredNameInUS.getLocalePreferred(), is(true));
+		
+	}
+	
 	/**
 	 * @see Concept#addName(ConceptName)
 	 */

From 83e1ef41e3f1913fbc5b630d4f888d7f317e495d Mon Sep 17 00:00:00 2001
From: Wikum Weerakutti <wikum@linuxdeveloper.space>
Date: Thu, 19 Sep 2024 20:39:27 +0530
Subject: [PATCH 115/163] TRUNK-6267: Fixing the
 java.util.ConcurrentModificationException on hasPrivilege method (#4750)

---
 api/src/main/java/org/openmrs/api/context/UserContext.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/api/src/main/java/org/openmrs/api/context/UserContext.java b/api/src/main/java/org/openmrs/api/context/UserContext.java
index 8539b89be731..983f262f2feb 100755
--- a/api/src/main/java/org/openmrs/api/context/UserContext.java
+++ b/api/src/main/java/org/openmrs/api/context/UserContext.java
@@ -325,7 +325,7 @@ public Set<Role> getAllRoles(User user) throws Exception {
 	public boolean hasPrivilege(String privilege) {
 		log.debug("Checking '{}' against proxies: {}", privilege, proxies);
 		// check proxied privileges
-		for (String s : proxies) {
+		for (String s : new ArrayList<>(proxies)) {
 			if (s.equals(privilege)) {
 				notifyPrivilegeListeners(getAuthenticatedUser(), privilege, true);
 				return true;

From 03d9a37ab5a7e113ca6d42c9903a88c87c0d47f0 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 19 Sep 2024 22:00:09 +0300
Subject: [PATCH 116/163] maven(deps): bump commons-io:commons-io from 2.16.1
 to 2.17.0 (#4751)

Bumps commons-io:commons-io from 2.16.1 to 2.17.0.

---
updated-dependencies:
- dependency-name: commons-io:commons-io
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index c5126a4b640d..9ddb335d690f 100644
--- a/pom.xml
+++ b/pom.xml
@@ -172,7 +172,7 @@
 			<dependency>
 				<groupId>commons-io</groupId>
 				<artifactId>commons-io</artifactId>
-				<version>2.16.1</version>
+				<version>2.17.0</version>
 			</dependency>
 			<dependency>
 				<groupId>org.apache.commons</groupId>

From 636b50fca64ac1554a734126a0a4b621e72d86d1 Mon Sep 17 00:00:00 2001
From: Ian <52504170+ibacher@users.noreply.github.com>
Date: Thu, 19 Sep 2024 15:32:06 -0400
Subject: [PATCH 117/163] TRUNK-6256: Move threading to a shared threadpool
 (#4710)

---
 .../java/org/openmrs/api/context/Daemon.java  | 376 ++++++++++--------
 .../openmrs/api/context/ServiceContext.java   |  36 +-
 .../org/openmrs/logging/MemoryAppender.java   |   4 +
 .../main/java/org/openmrs/scheduler/Task.java |   8 +-
 .../openmrs/scheduler/tasks/AbstractTask.java |   4 +-
 .../TaskThreadedInitializationWrapper.java    |  18 +-
 .../scheduler/timer/TimerSchedulerTask.java   |   7 +-
 .../org/openmrs/util/DatabaseUpdater.java     |   3 -
 .../openmrs/util/OpenmrsThreadPoolHolder.java |  18 +
 .../java/org/openmrs/util/OpenmrsUtil.java    |   2 -
 .../org/openmrs/api/ConceptServiceTest.java   |   5 +-
 .../org/openmrs/api/context/DaemonTest.java   | 125 ++++--
 .../org/openmrs/util/OpenmrsUtilTest.java     |   1 -
 .../main/java/org/openmrs/web/WebDaemon.java  |  61 ++-
 .../initialization/InitializationFilter.java  |  15 +-
 .../web/filter/update/UpdateFilter.java       |  17 +-
 .../java/org/openmrs/web/WebDaemonTest.java   |   4 +-
 17 files changed, 411 insertions(+), 293 deletions(-)
 create mode 100644 api/src/main/java/org/openmrs/util/OpenmrsThreadPoolHolder.java

diff --git a/api/src/main/java/org/openmrs/api/context/Daemon.java b/api/src/main/java/org/openmrs/api/context/Daemon.java
index 2fe6c82e2d62..43908915b67c 100644
--- a/api/src/main/java/org/openmrs/api/context/Daemon.java
+++ b/api/src/main/java/org/openmrs/api/context/Daemon.java
@@ -10,6 +10,10 @@
 package org.openmrs.api.context;
 
 import java.util.List;
+import java.util.concurrent.Callable;
+import java.util.concurrent.CountDownLatch;
+import java.util.concurrent.ExecutionException;
+import java.util.concurrent.Future;
 import java.util.stream.Collectors;
 
 import org.apache.commons.collections.CollectionUtils;
@@ -26,31 +30,28 @@
 import org.openmrs.scheduler.Task;
 import org.openmrs.scheduler.timer.TimerSchedulerTask;
 import org.openmrs.util.OpenmrsSecurityManager;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import org.openmrs.util.OpenmrsThreadPoolHolder;
 import org.springframework.context.support.AbstractRefreshableApplicationContext;
 
 /**
  * This class allows certain tasks to run with elevated privileges. Primary use is scheduling and
  * module startup when there is no user to authenticate as.
  */
-public class Daemon {
-
-	private static final Logger log = LoggerFactory.getLogger(Daemon.class);
+public final class Daemon {
 	
 	/**
 	 * The uuid defined for the daemon user object
 	 */
-	protected static final String DAEMON_USER_UUID = "A4F30A1B-5EB9-11DF-A648-37A07F9C90FB";
+	static final String DAEMON_USER_UUID = "A4F30A1B-5EB9-11DF-A648-37A07F9C90FB";
 	
-	protected static final ThreadLocal<Boolean> isDaemonThread = new ThreadLocal<>();
+	private static final ThreadLocal<Boolean> isDaemonThread = new ThreadLocal<>();
 	
-	protected static final ThreadLocal<User> daemonThreadUser = new ThreadLocal<>();
+	private static final ThreadLocal<User> daemonThreadUser = new ThreadLocal<>();
 	
 	/**
-	 * Protected constructor to override the default constructor to prevent it from being instantiated.
+	 * private constructor to override the default constructor to prevent it from being instantiated.
 	 */
-	protected Daemon() {
+	private Daemon() {
 	}
 	
 	/**
@@ -64,7 +65,7 @@ public static Module startModule(Module module) throws ModuleException {
 	 * This method should not be called directly. The {@link ModuleFactory#startModule(Module)}
 	 * method uses this to start the given module in a new thread that is authenticated as the
 	 * daemon user. <br>
-	 * If a non null application context is passed in, it gets refreshed to make the module's
+	 * If a non-null application context is passed in, it gets refreshed to make the module's
 	 * services available
 	 *
 	 * @param module the module to start
@@ -75,53 +76,33 @@ public static Module startModule(Module module) throws ModuleException {
 	 */
 	public static Module startModule(final Module module, final boolean isOpenmrsStartup,
 	        final AbstractRefreshableApplicationContext applicationContext) throws ModuleException {
-		// create a new thread and execute that task in it
-		DaemonThread startModuleThread = new DaemonThread() {
-			
-			@Override
-			public void run() {
-				isDaemonThread.set(true);
-				try {
-					Context.openSession();
-					returnedObject = ModuleFactory.startModuleInternal(module, isOpenmrsStartup, applicationContext);
-				}
-				catch (Exception e) {
-					exceptionThrown = e;
-				}
-				finally {
-					try {
-						Context.closeSession();
-					} finally {
-						isDaemonThread.remove();
-					}
-				}
-			}
-		};
+		Class<?> callerClass = new OpenmrsSecurityManager().getCallerClass(0);
+		if (callerClass != Daemon.class && callerClass != ModuleFactory.class) {
+			throw new APIException("Module.factory.only", new Object[] { callerClass.getName() });
+		}
 		
-		startModuleThread.start();
+		Future<Module> moduleStartFuture = runInDaemonThreadInternal(() -> ModuleFactory.startModuleInternal(module, isOpenmrsStartup, applicationContext));
 		
 		// wait for the "startModule" thread to finish
 		try {
-			startModuleThread.join();
+			return moduleStartFuture.get();
 		}
 		catch (InterruptedException e) {
 			// ignore
-		}
-		
-		if (startModuleThread.exceptionThrown != null) {
-			if (startModuleThread.exceptionThrown instanceof ModuleException) {
-				throw (ModuleException) startModuleThread.exceptionThrown;
+		} catch (ExecutionException e) {
+			if (e.getCause() instanceof ModuleException) {
+				throw (ModuleException) e.getCause();
 			} else {
-				throw new ModuleException("Unable to start module as Daemon", startModuleThread.exceptionThrown);
+				throw new ModuleException("Unable to start module " + module.getName(), e);
 			}
 		}
 
-		return (Module) startModuleThread.returnedObject;
+		return module;
 	}
 
 	/**
 	 * This method should not be called directly, only {@link ContextDAO#createUser(User, String, List)} can
-	 * legally invoke {@link #createUser(User, String, List)}.
+	 * legally invoke this method.
 	 * 
 	 * @param user A new user to be created.
 	 * @param password The password to set for the new user.
@@ -133,7 +114,6 @@ public void run() {
 	 * @since 2.3.0
 	 */
 	public static User createUser(User user, String password, List<String> roleNames) throws Exception {
-
 		// quick check to make sure we're only being called by ourselves
 		Class<?> callerClass = new OpenmrsSecurityManager().getCallerClass(0);
 		if (!ContextDAO.class.isAssignableFrom(callerClass)) {
@@ -141,53 +121,35 @@ public static User createUser(User user, String password, List<String> roleNames
 		}
 
 		// create a new thread and execute that task in it
-		DaemonThread createUserThread = new DaemonThread() {
-
-			@Override
-			public void run() {
-				isDaemonThread.set(true);
-				try {
-					Context.openSession();
-
-					if ( (user.getId() != null && Context.getUserService().getUser(user.getId()) != null) || Context.getUserService().getUserByUuid(user.getUuid()) != null || Context.getUserService().getUserByUsername(user.getUsername()) != null || (user.getEmail() != null && Context.getUserService().getUserByUsernameOrEmail(user.getEmail()) != null) ) {
-						throw new APIException("User.creating.already.exists", new Object[] { user.getDisplayString() });
-					}
-
-					if (!CollectionUtils.isEmpty(roleNames)) {
-						List<Role> roles = roleNames.stream().map(roleName -> Context.getUserService().getRole(roleName)).collect(Collectors.toList()); 
-						roles.forEach(user::addRole);
-					}
+		Future<User> userFuture = runInDaemonThreadInternal(() -> {
+			if ((user.getId() != null && Context.getUserService().getUser(user.getId()) != null) || Context.getUserService().getUserByUuid(user.getUuid()) != null || Context.getUserService().getUserByUsername(user.getUsername()) != null || (user.getEmail() != null && Context.getUserService().getUserByUsernameOrEmail(user.getEmail()) != null) ) {
+				throw new APIException("User.creating.already.exists", new Object[] { user.getDisplayString() });
+			}
 
-					returnedObject = Context.getUserService().createUser(user, password);
-				}
-				catch (Exception e) {
-					exceptionThrown = e;
-				}
-				finally {
-					try {
-						Context.closeSession();
-					} finally {
-						isDaemonThread.remove();
-					}
-				}
+			if (!CollectionUtils.isEmpty(roleNames)) {
+				List<Role> roles = roleNames.stream().map(roleName -> Context.getUserService().getRole(roleName)).collect(Collectors.toList());
+				roles.forEach(user::addRole);
 			}
-		};
 
-		createUserThread.start();
+			return Context.getUserService().createUser(user, password);
+		});
 
 		// wait for the 'create user' thread to finish
 		try {
-			createUserThread.join();
+			return userFuture.get();
 		}
 		catch (InterruptedException e) {
 			// ignore
 		}
-
-		if (createUserThread.exceptionThrown != null) {
-			throw createUserThread.exceptionThrown;
+		catch (ExecutionException e) {
+			if (e.getCause() instanceof Exception) {
+				throw (Exception) e.getCause();
+			} else {
+				throw new RuntimeException(e.getCause());
+			}
 		}
 
-		return (User) createUserThread.returnedObject;
+		return null;
 	}	
 	
 	/**
@@ -200,52 +162,27 @@ public void run() {
 	 * <strong>Should</strong> not throw error if called from a TimerSchedulerTask class
 	 */
 	public static void executeScheduledTask(final Task task) throws Exception {
-		
 		// quick check to make sure we're only being called by ourselves
 		Class<?> callerClass = new OpenmrsSecurityManager().getCallerClass(0);
 		if (!TimerSchedulerTask.class.isAssignableFrom(callerClass)) {
 			throw new APIException("Scheduler.timer.task.only", new Object[] { callerClass.getName() });
 		}
 		
-		// now create a new thread and execute that task in it
-		DaemonThread executeTaskThread = new DaemonThread() {
-			
-			@Override
-			public void run() {
-				isDaemonThread.set(true);
-				
-				try {
-					Context.openSession();
-					TimerSchedulerTask.execute(task);
-				}
-				catch (Exception e) {
-					exceptionThrown = e;
-				}
-				finally {
-					try {
-						Context.closeSession();
-					} finally {
-						isDaemonThread.remove();
-					}
-				}
-				
-			}
-		};
-		
-		executeTaskThread.start();
+		Future<?> scheduleTaskFuture = runInDaemonThreadInternal(() -> TimerSchedulerTask.execute(task));
 		
 		// wait for the "executeTaskThread" thread to finish
 		try {
-			executeTaskThread.join();
+			scheduleTaskFuture.get();
 		}
 		catch (InterruptedException e) {
 			// ignore
+		} catch (ExecutionException e) {
+			if (e.getCause() instanceof Exception) {
+				throw (Exception) e.getCause();
+			} else {
+				throw new RuntimeException(e.getCause());
+			}
 		}
-		
-		if (executeTaskThread.exceptionThrown != null) {
-			throw executeTaskThread.exceptionThrown;
-		}
-		
 	}
 	
 	/**
@@ -255,15 +192,19 @@ public void run() {
 	 *
 	 * @param runnable what to run in a new thread
 	 * @return the newly spawned {@link Thread}
-	 * <strong>Should</strong> throw error if called from a non daemon thread
-	 * <strong>Should</strong> not throw error if called from a daemon thread
+	 * @deprecated As of 2.7.0, consider using {@link #runNewDaemonTask(Runnable)} instead
 	 */
-	@SuppressWarnings("squid:S1217")
+	@Deprecated
 	public static Thread runInNewDaemonThread(final Runnable runnable) {
 		// make sure we're already in a daemon thread
 		if (!isDaemonThread()) {
 			throw new APIAuthenticationException("Only daemon threads can spawn new daemon threads");
 		}
+
+		// the previous implementation ensured that Thread.start() was called before this function returned
+		// since we cannot guarantee that the executor will run the thread when `execute()` is called, we need another
+		// mechanism to ensure the submitted Runnable was actually started.
+		final CountDownLatch countDownLatch = new CountDownLatch(1);
 		
 		// we should consider making DaemonThread public, so the caller can access returnedObject and exceptionThrown
 		DaemonThread thread = new DaemonThread() {
@@ -273,6 +214,7 @@ public void run() {
 				isDaemonThread.set(true);
 				try {
 					Context.openSession();
+					countDownLatch.countDown();
 					//Suppressing sonar issue "squid:S1217"
 					//We intentionally do not start a new thread yet, rather wrap the run call in a session.
 					runnable.run();
@@ -287,9 +229,54 @@ public void run() {
 			}
 		};
 		
-		thread.start();
+		OpenmrsThreadPoolHolder.threadExecutor.execute(thread);
+
+		// do not return until the thread is actually started to emulate the previous behaviour
+		try {
+			countDownLatch.await();
+		} catch (InterruptedException ignored) {
+		}
+
 		return thread;
 	}
+
+	/**
+	 * Call this method if you are inside a Daemon thread (for example in a Module activator or a
+	 * scheduled task) and you want to start up a new parallel Daemon thread. You may only call this
+	 * method from a Daemon thread.
+	 *
+	 * @param callable what to run in a new thread
+	 * @return a future that completes when the task is done;
+	 * @since 2.7.0
+	 */
+	@SuppressWarnings({"squid:S1217", "unused"})
+	public static <T> Future<T> runInNewDaemonThread(final Callable<T> callable) {
+		// make sure we're already in a daemon thread
+		if (!isDaemonThread()) {
+			throw new APIAuthenticationException("Only daemon threads can spawn new daemon threads");
+		}
+
+		return runInDaemonThreadInternal(callable);
+	}
+
+	/**
+	 * Call this method if you are inside a Daemon thread (for example in a Module activator or a
+	 * scheduled task) and you want to start up a new parallel Daemon thread. You may only call this
+	 * method from a Daemon thread.
+	 *
+	 * @param runnable what to run in a new thread
+	 * @return a future that completes when the task is done;
+	 * @since 2.7.0
+	 */
+	@SuppressWarnings({"squid:S1217", "unused"})
+	public static Future<?> runNewDaemonTask(final Runnable runnable) {
+		// make sure we're already in a daemon thread
+		if (!isDaemonThread()) {
+			throw new APIAuthenticationException("Only daemon threads can spawn new daemon threads");
+		}
+		
+		return runInDaemonThreadInternal(runnable);
+	}
 	
 	/**
 	 * @return true if the current thread was started by this class and so is a daemon thread that
@@ -298,10 +285,12 @@ public void run() {
 	 */
 	public static boolean isDaemonThread() {
 		Boolean b = isDaemonThread.get();
-		if (b == null) {
-			return false;
+		if (b == null || !b) {
+			// Allow functions in Daemon and WebDaemon to be treated as a DaemonThread
+			Class<?> callerClass = new OpenmrsSecurityManager().getCallerClass(1);
+			return callerClass.equals(Daemon.class) || callerClass.getName().equals("org.openmrs.web.WebDaemon");
 		} else {
-			return b;
+			return true;
 		}
 	}
 	
@@ -313,45 +302,25 @@ public static boolean isDaemonThread() {
 	 * @since 1.9
 	 */
 	public static void runStartupForService(final OpenmrsService service) throws ModuleException {
+		Class<?> callerClass = new OpenmrsSecurityManager().getCallerClass(0);
+		if (callerClass != ServiceContext.class) {
+			throw new APIException("Service.context.only", new Object[] { callerClass.getName() });
+		}
 		
-		DaemonThread onStartupThread = new DaemonThread() {
-			
-			@Override
-			public void run() {
-				isDaemonThread.set(true);
-				try {
-					Context.openSession();
-					service.onStartup();
-				}
-				catch (Exception e) {
-					exceptionThrown = e;
-				}
-				finally {
-					try {
-						Context.closeSession();
-					} finally {
-						isDaemonThread.remove();
-					}
-				}
-			}
-		};
-		
-		onStartupThread.start();
+		Future<?> future = runInDaemonThreadInternal(service::onStartup);
 		
 		// wait for the "onStartup" thread to finish
 		try {
-			onStartupThread.join();
+			future.get();
 		}
 		catch (InterruptedException e) {
 			// ignore
-			log.error("Thread was interrupted", e);
 		}
-		
-		if (onStartupThread.exceptionThrown != null) {
-			if (onStartupThread.exceptionThrown instanceof ModuleException) {
-				throw (ModuleException) onStartupThread.exceptionThrown;
+		catch (ExecutionException e) {
+			if (e.getCause() instanceof ModuleException) {
+				throw (ModuleException) e.getCause();
 			} else {
-				throw new ModuleException("Unable to run onStartup() method as Daemon", onStartupThread.exceptionThrown);
+				throw new ModuleException("Unable to run onStartup() method of service {}", service.getClass().getSimpleName(), e);
 			}
 		}
 	}
@@ -363,15 +332,16 @@ public void run() {
 	 * @param token the token required to run code as the daemon user
 	 * @return the newly spawned {@link Thread}
 	 * @since 1.9.2
+	 * @deprecated Since 2.7.0 use {@link #runInDaemonThreadWithoutResult(Runnable, DaemonToken)} instead
 	 */
-	@SuppressWarnings("squid:S1217")
+	@Deprecated
+	@SuppressWarnings({"squid:S1217", "unused"})
 	public static Thread runInDaemonThread(final Runnable runnable, DaemonToken token) {
 		if (!ModuleFactory.isTokenValid(token)) {
 			throw new ContextAuthenticationException("Invalid token " + token);
 		}
 		
 		DaemonThread thread = new DaemonThread() {
-			
 			@Override
 			public void run() {
 				isDaemonThread.set(true);
@@ -390,10 +360,44 @@ public void run() {
 				}
 			}
 		};
-		
-		thread.start();
+
+		OpenmrsThreadPoolHolder.threadExecutor.execute(thread);
 		return thread;
 	}
+
+	/**
+	 * Executes the given runnable in a new thread that is authenticated as the daemon user.
+	 *
+	 * @param callable an object implementing the {@link Callable<T>} interface to be run
+	 * @param token the token required to run code as the daemon user
+	 * @return the newly spawned {@link Thread}
+	 * @since 2.7.0
+	 */
+	@SuppressWarnings({"squid:S1217", "unused"})
+	public static <T> Future<T> runInDaemonThread(final Callable<T> callable, DaemonToken token) {
+		if (!ModuleFactory.isTokenValid(token)) {
+			throw new ContextAuthenticationException("Invalid token");
+		}
+		
+		return runInDaemonThreadInternal(callable);
+	}
+
+	/**
+	 * Executes the given runnable in a new thread that is authenticated as the daemon user.
+	 *
+	 * @param runnable an object implementing the {@link Runnable} interface to be run
+	 * @param token the token required to run code as the daemon user
+	 * @return the newly spawned {@link Thread}
+	 * @since 2.7.0
+	 */
+	@SuppressWarnings("squid:S1217")
+	public static Future<?> runInDaemonThreadWithoutResult(final Runnable runnable, DaemonToken token) {
+		if (!ModuleFactory.isTokenValid(token)) {
+			throw new ContextAuthenticationException("Invalid token");
+		}
+
+		return runInDaemonThreadInternal(runnable);
+	}
 	
 	/**
 	 * Executes the given runnable in a new thread that is authenticated as the daemon user and wait
@@ -401,19 +405,69 @@ public void run() {
 	 *
 	 * @param runnable an object implementing the {@link Runnable} interface.
 	 * @param token the token required to run code as the daemon user
-	 * @since 1.9.2
+	 * @since 2.7.0
 	 */
 	public static void runInDaemonThreadAndWait(final Runnable runnable, DaemonToken token) {
-		Thread daemonThread = runInDaemonThread(runnable, token);
+		Future<?> daemonThread = runInDaemonThreadWithoutResult(runnable, token);
 		
 		try {
-			daemonThread.join();
+			daemonThread.get();
 		}
-		catch (InterruptedException e) {
-			//Ignore
+		catch (InterruptedException | ExecutionException e) {
+			// Ignored
 		}
 	}
 	
+	private static <T> Future<T> runInDaemonThreadInternal(Callable<T> callable) {
+		return OpenmrsThreadPoolHolder.threadExecutor.submit(() -> {
+			isDaemonThread.set(true);
+			try {
+				Context.openSession();
+				return callable.call();
+			}
+			finally {
+				try {
+					Context.closeSession();
+				} finally {
+					isDaemonThread.remove();
+				}
+			}
+		});
+	}
+	
+	private static Future<?> runInDaemonThreadInternal(Runnable runnable) {
+		// for Threads, we used to guarantee that Thread.start() was called before the function returned
+		// since we cannot guarantee that the executor actually started executing the thread, we use a CountDownLatch
+		// to emulate this behaviour when the user submits a Thread. Other runnables are unaffected.
+		CountDownLatch countDownLatch = getCountDownLatch(runnable instanceof Thread);
+
+		Future<?> result = OpenmrsThreadPoolHolder.threadExecutor.submit(() -> {
+			isDaemonThread.set(true);
+			try {
+				Context.openSession();
+				countDownLatch.countDown();
+				runnable.run();
+			}
+			finally {
+				try {
+					Context.closeSession();
+				} finally {
+					isDaemonThread.remove();
+				}
+			}
+		});
+		
+		try {
+			countDownLatch.await();
+		} catch (InterruptedException ignored) {}
+		
+		return result;
+	}
+
+	private static CountDownLatch getCountDownLatch(boolean isThread) {
+		return isThread ? new CountDownLatch(1) : new CountDownLatch(0);
+	}
+
 	/**
 	 * Thread class used by the {@link Daemon#startModule(Module)} and
 	 * {@link Daemon#executeScheduledTask(Task)} methods so that the returned object and the
@@ -443,14 +497,12 @@ public Exception getExceptionThrown() {
 	
 	/**
 	 * Checks whether user is Daemon.
-	 * However this is not the preferred method for checking to see if the current thread is a daemon thread,
-	 * 				rather use Daemon.isDeamonThread().
+	 * However, this is not the preferred method for checking to see if the current thread is a daemon thread,
+	 * 				rather use {@link #isDaemonThread()}.
 	 * isDaemonThread is preferred for checking to see if you are in that thread or if the current thread is daemon.
 	 *
 	 * @param user user whom we are checking if daemon
 	 * @return true if user is Daemon
-	 * <strong>Should</strong> return true for a daemon user
-	 * <strong>Should</strong> return false if the user is not a daemon
 	 */
 	public static boolean isDaemonUser(User user) {
 		return DAEMON_USER_UUID.equals(user.getUuid());
diff --git a/api/src/main/java/org/openmrs/api/context/ServiceContext.java b/api/src/main/java/org/openmrs/api/context/ServiceContext.java
index b84f835ae9cb..7f5b2ef24ab7 100644
--- a/api/src/main/java/org/openmrs/api/context/ServiceContext.java
+++ b/api/src/main/java/org/openmrs/api/context/ServiceContext.java
@@ -50,6 +50,7 @@
 import org.openmrs.notification.MessageService;
 import org.openmrs.scheduler.SchedulerService;
 import org.openmrs.util.OpenmrsClassLoader;
+import org.openmrs.util.OpenmrsThreadPoolHolder;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.aop.Advisor;
@@ -703,9 +704,8 @@ public <T> T getService(Class<? extends T> cls) {
 	 * @param cls Interface to proxy
 	 * @param classInstance the actual instance of the <code>cls</code> interface
 	 */
-	public void setService(Class cls, Object classInstance) {
-		
-		log.debug("Setting service: " + cls);
+	public void setService(Class<?> cls, Object classInstance) {
+		log.debug("Setting service: {}", cls);
 		
 		if (cls != null && classInstance != null) {
 			try {
@@ -734,7 +734,7 @@ public void setService(Class cls, Object classInstance) {
 					
 					services.put(cls, advisedService);
 				}
-				log.debug("Service: " + cls + " set successfully");
+				log.debug("Service: {} set successfully", cls);
 			}
 			catch (Exception e) {
 				throw new APIException("service.unable.create.proxy.factory", new Object[] { classInstance.getClass()
@@ -886,9 +886,7 @@ public boolean isRefreshingContext() {
 	
 	public <T> List<T> getRegisteredComponents(Class<T> type) {
 		Map<String, T> m = getRegisteredComponents(applicationContext, type);
-		if (log.isTraceEnabled()) {
-			log.trace("getRegisteredComponents(" + type + ") = " + m);
-		}
+		log.trace("getRegisteredComponents({}) = {}", type, m);
 		return new ArrayList<>(m.values());
 	}
 	
@@ -918,16 +916,10 @@ public <T> T getRegisteredComponent(String beanName, Class<T> type) throws APIEx
 	 * @param type - The type of component to retrieve
 	 * @return all components registered in a Spring applicationContext of a given type
 	 */
-	@SuppressWarnings("unchecked")
 	private <T> Map<String, T> getRegisteredComponents(ApplicationContext context, Class<T> type) {
-		Map<String, T> components = new HashMap<>();
 		Map<String, T> registeredComponents = context.getBeansOfType(type);
-		if (log.isTraceEnabled()) {
-			log.trace("getRegisteredComponents(" + context + ", " + type + ") = " + registeredComponents);
-		}
-		if (registeredComponents != null) {
-			components.putAll(registeredComponents);
-		}
+		log.trace("getRegisteredComponents({}, {}) = {}", context, type, registeredComponents);
+		Map<String, T> components = new HashMap<>(registeredComponents);
 		if (context.getParent() != null) {
 			components.putAll(getRegisteredComponents(context.getParent(), type));
 		}
@@ -955,26 +947,26 @@ public ApplicationContext getApplicationContext() {
 	 * @since 1.9
 	 */
 	private void runOpenmrsServiceOnStartup(final OpenmrsService openmrsService, final String classString) {
-		new Thread(() -> {
+		OpenmrsThreadPoolHolder.threadExecutor.execute(() -> {
 			try {
 				synchronized (refreshingContextLock) {
 					//Need to wait for application context to finish refreshing otherwise we get into trouble.
 					while (refreshingContext) {
 						log.debug("Waiting to get service: {} while the context is being refreshed", classString);
-
+	
 						refreshingContextLock.wait();
-
+	
 						log.debug("Finished waiting to get service {} while the context was being refreshed", classString);
 					}
 				}
-
+	
 				Daemon.runStartupForService(openmrsService);
 			}
-			catch (InterruptedException e) {
+				catch (InterruptedException e) {
 				log.warn("Refresh lock was interrupted while waiting to run OpenmrsService.onStartup() for "
-				        + classString, e);
+					+ classString, e);
 			}
-		}).start();
+		});
 	}
 	
 	/**
diff --git a/api/src/main/java/org/openmrs/logging/MemoryAppender.java b/api/src/main/java/org/openmrs/logging/MemoryAppender.java
index 87442f1008b0..b56c56f81eda 100644
--- a/api/src/main/java/org/openmrs/logging/MemoryAppender.java
+++ b/api/src/main/java/org/openmrs/logging/MemoryAppender.java
@@ -92,6 +92,10 @@ protected static MemoryAppender createAppender(
 			appender = new MemoryAppender(name, filter, layout, ignoreExceptions, null, theBufferSize);
 			APPENDERS.put(name, new SoftReference<>(appender));
 		}
+		
+		if (!appender.isStarted()) {
+			appender.start();
+		}
 
 		return appender;
 	}
diff --git a/api/src/main/java/org/openmrs/scheduler/Task.java b/api/src/main/java/org/openmrs/scheduler/Task.java
index 9a1cc79395cc..a6f73a25addc 100644
--- a/api/src/main/java/org/openmrs/scheduler/Task.java
+++ b/api/src/main/java/org/openmrs/scheduler/Task.java
@@ -9,26 +9,28 @@
  */
 package org.openmrs.scheduler;
 
+import java.util.concurrent.ExecutionException;
+
 public interface Task {
 	
 	/**
 	 * Executes the task defined in the task definition.
 	 */
-	public void execute();
+	void execute() throws InterruptedException, ExecutionException;
 	
 	/**
 	 * Initializes the task and sets the task definition.
 	 * 
 	 * @param definition
 	 */
-	public void initialize(TaskDefinition definition);
+	void initialize(TaskDefinition definition);
 	
 	/**
 	 * Returns the task definition associated with this task.
 	 * 
 	 * @return a task definition
 	 */
-	public TaskDefinition getTaskDefinition();
+	TaskDefinition getTaskDefinition();
 	
 	/**
 	 * Returns true if the task is currently in its execute() method.
diff --git a/api/src/main/java/org/openmrs/scheduler/tasks/AbstractTask.java b/api/src/main/java/org/openmrs/scheduler/tasks/AbstractTask.java
index b81c290e962e..7dcd40156266 100644
--- a/api/src/main/java/org/openmrs/scheduler/tasks/AbstractTask.java
+++ b/api/src/main/java/org/openmrs/scheduler/tasks/AbstractTask.java
@@ -14,6 +14,8 @@
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+import java.util.concurrent.ExecutionException;
+
 /**
  * Base class for all other task classes.
  */
@@ -48,7 +50,7 @@ protected AbstractTask(TaskDefinition taskDefinition) {
 	 * @see org.openmrs.scheduler.Task#execute()
 	 */
 	@Override
-	public abstract void execute();
+	public abstract void execute() throws InterruptedException, ExecutionException;
 	
 	/**
 	 * @see org.openmrs.scheduler.Task#isExecuting()
diff --git a/api/src/main/java/org/openmrs/scheduler/tasks/TaskThreadedInitializationWrapper.java b/api/src/main/java/org/openmrs/scheduler/tasks/TaskThreadedInitializationWrapper.java
index 866c7b5c1e3e..23892f2f68fd 100644
--- a/api/src/main/java/org/openmrs/scheduler/tasks/TaskThreadedInitializationWrapper.java
+++ b/api/src/main/java/org/openmrs/scheduler/tasks/TaskThreadedInitializationWrapper.java
@@ -9,12 +9,14 @@
  */
 package org.openmrs.scheduler.tasks;
 
+import java.util.concurrent.ExecutionException;
 import java.util.concurrent.locks.Condition;
 import java.util.concurrent.locks.Lock;
 import java.util.concurrent.locks.ReentrantLock;
 
 import org.openmrs.scheduler.Task;
 import org.openmrs.scheduler.TaskDefinition;
+import org.openmrs.util.OpenmrsThreadPoolHolder;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -28,7 +30,7 @@ public class TaskThreadedInitializationWrapper implements Task {
 	// Logger 
 	private static final Logger log = LoggerFactory.getLogger(TaskThreadedInitializationWrapper.class);
 	
-	private Task task;
+	private final Task task;
 	
 	private boolean initialized = false;
 	
@@ -64,8 +66,12 @@ public void execute() {
 		finally {
 			lock.unlock();
 		}
-		
-		task.execute();
+
+		try {
+			task.execute();
+		} catch (InterruptedException | ExecutionException e) {
+			log.error("Exception occurred while executing task.", e);
+		}
 	}
 	
 	/**
@@ -75,7 +81,7 @@ public void execute() {
 	 */
 	@Override
 	public void initialize(final TaskDefinition config) {
-		Runnable r = () -> {
+		OpenmrsThreadPoolHolder.threadExecutor.submit(() -> {
 			lock.lock();
 			try {
 				task.initialize(config);
@@ -85,9 +91,7 @@ public void initialize(final TaskDefinition config) {
 			finally {
 				lock.unlock();
 			}
-		};
-		
-		new Thread(r).start();
+		});
 	}
 	
 	/**
diff --git a/api/src/main/java/org/openmrs/scheduler/timer/TimerSchedulerTask.java b/api/src/main/java/org/openmrs/scheduler/timer/TimerSchedulerTask.java
index 8aaa93ccacf0..904be618c3f9 100644
--- a/api/src/main/java/org/openmrs/scheduler/timer/TimerSchedulerTask.java
+++ b/api/src/main/java/org/openmrs/scheduler/timer/TimerSchedulerTask.java
@@ -11,6 +11,7 @@
 
 import java.util.Date;
 import java.util.TimerTask;
+import java.util.concurrent.ExecutionException;
 
 import org.openmrs.api.context.Context;
 import org.openmrs.api.context.Daemon;
@@ -91,7 +92,11 @@ public void shutdown() {
 	 * Executes the given task.
 	 */
 	public static void execute(Task task) {
-		task.execute();
+		try {
+			task.execute();
+		} catch (InterruptedException | ExecutionException e) {
+			// ignored
+		} 
 		saveLastExecutionTime(task);
 	}
 }
diff --git a/api/src/main/java/org/openmrs/util/DatabaseUpdater.java b/api/src/main/java/org/openmrs/util/DatabaseUpdater.java
index 7aa7dc884c6a..7b0b1f382021 100644
--- a/api/src/main/java/org/openmrs/util/DatabaseUpdater.java
+++ b/api/src/main/java/org/openmrs/util/DatabaseUpdater.java
@@ -786,9 +786,6 @@ public static void writeUpdateMessagesToFile(String text) {
 		catch (FileNotFoundException e) {
 			log.warn("Failed to find the database update log file", e);
 		}
-		catch (IOException e) {
-			log.warn("Failed to write to the database update log file", e);
-		}
 		finally {
 			IOUtils.closeQuietly(streamWriter);
 			IOUtils.closeQuietly(writer);
diff --git a/api/src/main/java/org/openmrs/util/OpenmrsThreadPoolHolder.java b/api/src/main/java/org/openmrs/util/OpenmrsThreadPoolHolder.java
new file mode 100644
index 000000000000..0160250fcabb
--- /dev/null
+++ b/api/src/main/java/org/openmrs/util/OpenmrsThreadPoolHolder.java
@@ -0,0 +1,18 @@
+/**
+ * This Source Code Form is subject to the terms of the Mozilla Public License,
+ * v. 2.0. If a copy of the MPL was not distributed with this file, You can
+ * obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
+ * the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
+ *
+ * Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
+ * graphic logo is a trademark of OpenMRS Inc.
+ */
+package org.openmrs.util;
+
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+
+public class OpenmrsThreadPoolHolder {
+	
+	public static final ExecutorService threadExecutor = Executors.newCachedThreadPool();
+}
diff --git a/api/src/main/java/org/openmrs/util/OpenmrsUtil.java b/api/src/main/java/org/openmrs/util/OpenmrsUtil.java
index 1b1cf990f860..2da47c6830ff 100644
--- a/api/src/main/java/org/openmrs/util/OpenmrsUtil.java
+++ b/api/src/main/java/org/openmrs/util/OpenmrsUtil.java
@@ -271,7 +271,6 @@ public static byte[] getFileAsBytes(File file) throws IOException {
 	 * <strong>Should</strong> copy inputstream to outputstream and close the outputstream
 	 */
 	public static void copyFile(InputStream inputStream, OutputStream outputStream) throws IOException {
-		
 		if (inputStream == null || outputStream == null) {
 			if (outputStream != null) {
 				IOUtils.closeQuietly(outputStream);
@@ -285,7 +284,6 @@ public static void copyFile(InputStream inputStream, OutputStream outputStream)
 		finally {
 			IOUtils.closeQuietly(outputStream);
 		}
-		
 	}
 	
 	/**
diff --git a/api/src/test/java/org/openmrs/api/ConceptServiceTest.java b/api/src/test/java/org/openmrs/api/ConceptServiceTest.java
index a14cebdaf6d9..7f524b2fc79a 100644
--- a/api/src/test/java/org/openmrs/api/ConceptServiceTest.java
+++ b/api/src/test/java/org/openmrs/api/ConceptServiceTest.java
@@ -2875,7 +2875,7 @@ public void saveConcept_shouldNotSetAuditInfoIfTheConceptIsNotEdited() {
 	 * @see ConceptService#saveConcept(Concept)
 	 */
 	@Test
-	public void saveConcept_shouldSetAuditInfoIfAnItemIsRemovedFromAnyOfItsChildCollections() {
+	public void saveConcept_shouldSetAuditInfoIfAnItemIsRemovedFromAnyOfItsChildCollections() throws InterruptedException {
 		Concept concept = conceptService.getConcept(3);
 		assertNull(concept.getDateChanged());
 		assertNull(concept.getChangedBy());
@@ -2888,6 +2888,9 @@ public void saveConcept_shouldSetAuditInfoIfAnItemIsRemovedFromAnyOfItsChildColl
 		Date date=concept.getDateChanged();
 
 		assertTrue(concept.removeAnswer(conceptanswer));
+		
+		Thread.sleep(1);
+		
 		conceptService.saveConcept(concept);
 		assertNotNull(concept.getDateChanged());
 		Date date1=concept.getDateChanged();
diff --git a/api/src/test/java/org/openmrs/api/context/DaemonTest.java b/api/src/test/java/org/openmrs/api/context/DaemonTest.java
index ba6682d37870..1e92b1d67f25 100644
--- a/api/src/test/java/org/openmrs/api/context/DaemonTest.java
+++ b/api/src/test/java/org/openmrs/api/context/DaemonTest.java
@@ -9,22 +9,26 @@
  */
 package org.openmrs.api.context;
 
-import static org.hamcrest.CoreMatchers.is;
+import static org.hamcrest.Matchers.hasItem;
+import static org.hamcrest.Matchers.is;
+import static org.hamcrest.Matchers.not;
+import static org.hamcrest.Matchers.notNullValue;
+import static org.hamcrest.Matchers.startsWith;
 import static org.hamcrest.MatcherAssert.assertThat;
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertFalse;
-import static org.junit.jupiter.api.Assertions.assertNotNull;
 import static org.junit.jupiter.api.Assertions.assertThrows;
-import static org.junit.jupiter.api.Assertions.assertTrue;
 import static org.junit.jupiter.api.Assertions.fail;
 
 import java.util.Arrays;
+import java.util.Locale;
 import java.util.Set;
+import java.util.concurrent.ExecutionException;
+import java.util.concurrent.Future;
 import java.util.stream.Collectors;
 
 import org.junit.jupiter.api.Test;
 import org.openmrs.Person;
 import org.openmrs.PersonName;
+import org.openmrs.Role;
 import org.openmrs.User;
 import org.openmrs.api.APIAuthenticationException;
 import org.openmrs.api.APIException;
@@ -50,7 +54,8 @@ public void executeScheduledTask_shouldNotBeCalledFromOtherMethodsOtherThanTimer
 			fail("Should not be here, an exception should have been thrown in the line above");
 		}
 		catch (APIException e) {
-			assertTrue(e.getMessage().startsWith(Context.getMessageSourceService().getMessage("Scheduler.timer.task.only", new Object[] { this.getClass().getName() }, null)));
+			assertThat(e.getMessage(), startsWith(
+				Context.getMessageSourceService().getMessage("Scheduler.timer.task.only", new Object[] { this.getClass().getName() }, Locale.ENGLISH)));
 		}
 	}
 	
@@ -64,16 +69,19 @@ public void executeScheduledTask_shouldNotBeCalledFromOtherMethodsOtherThanTimer
 	@Test
 	public void executeScheduledTask_shouldNotThrowErrorIfCalledFromATimerSchedulerTaskClass() throws Throwable {
 		Task task = new PrivateTask();
-		assertTrue(new PrivateSchedulerTask(task).runTheTest());
+		assertThat(new PrivateSchedulerTask(task).runTheTest(), is(true));
 	}
 	
 	@Test 
 	public void createUser_shouldThrowWhenCalledOutsideContextDAO() throws Throwable {
-		// verif
+		// setup
+		
+		// verify
 		
 		// replay
 		APIException exception = assertThrows(APIException.class, () -> Daemon.createUser(new User(), "password", null));
-		assertThat(exception.getMessage(), is(Context.getMessageSourceService().getMessage("Context.DAO.only", new Object[] { this.getClass().getName() }, null)));
+		assertThat(exception.getMessage(), is(
+			Context.getMessageSourceService().getMessage("Context.DAO.only", new Object[] { this.getClass().getName() }, Locale.ENGLISH)));
 	}
 	
 	@Test
@@ -88,11 +96,11 @@ public void createUser_shouldCreateUserWithRolesInContextDAO() throws Throwable
 		// replay
 		User createdUser = Context.getContextDAO().createUser(u, "P@ssw0rd", Arrays.asList("Provider", "Foobar Role"));
 		
-		// verif
-		assertNotNull(createdUser.getId());
-		Set<String> roleNames = createdUser.getRoles().stream().map(r -> r.getName()).collect(Collectors.toSet());
-		assertTrue(roleNames.contains("Provider"));
-		assertFalse(roleNames.contains("Foobar Role")); // a bogus role name has just no impact on the created user
+		// verify
+		assertThat(createdUser.getId(), notNullValue());
+		Set<String> roleNames = createdUser.getRoles().stream().map(Role::getName).collect(Collectors.toSet());
+		assertThat(roleNames, hasItem("Provider"));
+		assertThat(roleNames, not(hasItem("Foobar Role"))); // a bogus role name has just no impact on the created user
 	}
 	
 	@Test 
@@ -100,11 +108,12 @@ public void createUser_shouldThrowWhenUserExists() throws Throwable {
 		// setup
 		User u = Context.getUserService().getUser(501);
 		
-		// verif
+		// verify
 		
 		// replay
 		APIException exception = assertThrows(APIException.class, () -> Context.getContextDAO().createUser(u, "P@ssw0rd", null));
-		assertThat(exception.getMessage(), is(Context.getMessageSourceService().getMessage("User.creating.already.exists", new Object[] { u.getDisplayString() }, null)));
+		assertThat(exception.getMessage(), is(
+			Context.getMessageSourceService().getMessage("User.creating.already.exists", new Object[] { u.getDisplayString() }, Locale.ENGLISH)));
 	}
 	
 	/**
@@ -116,10 +125,32 @@ public void runInNewDaemonThread_shouldThrowErrorIfCalledFromANonDaemonThread()
 			Daemon.runInNewDaemonThread(() -> {
 				// do nothing
 			});
-			assertTrue(false, "Should not hit this line, since the previous needed to throw an exception");
+			fail("Should not hit this line, since the previous needed to throw an exception");
+		}
+		catch (APIAuthenticationException ex) {
+			assertThat(ex.getMessage(), is("Only daemon threads can spawn new daemon threads"));
+		}
+	}
+
+	@Test
+	public void runInNewDaemonThreadCallable_shouldThrowErrorIfCalledFromANonDaemonThread() {
+		try {
+			Daemon.runInNewDaemonThread(() -> null);
+			fail("Should not hit this line, since the previous needed to throw an exception");
 		}
 		catch (APIAuthenticationException ex) {
-			assertEquals("Only daemon threads can spawn new daemon threads", ex.getMessage());
+			assertThat(ex.getMessage(), is("Only daemon threads can spawn new daemon threads"));
+		}
+	}
+
+	@Test
+	public void runNewDaemonTask_shouldThrowErrorIfCalledFromANonDaemonThread() {
+		try {
+			Daemon.runNewDaemonTask(() -> {});
+			fail("Should not hit this line, since the previous needed to throw an exception");
+		}
+		catch (APIAuthenticationException ex) {
+			assertThat(ex.getMessage(), is("Only daemon threads can spawn new daemon threads"));
 		}
 	}
 	
@@ -129,7 +160,16 @@ public void runInNewDaemonThread_shouldThrowErrorIfCalledFromANonDaemonThread()
 	@Test
 	public void runInNewDaemonThread_shouldNotThrowErrorIfCalledFromADaemonThread() throws Throwable {
 		Task taskThatStartsAnotherThread = new TaskThatStartsAnotherThread();
-		assertTrue(new PrivateSchedulerTask(taskThatStartsAnotherThread).runTheTest());
+		assertThat(new PrivateSchedulerTask(taskThatStartsAnotherThread).runTheTest(), is(true));
+	}
+
+	/**
+	 * @see Daemon#runInNewDaemonThread(Runnable)
+	 */
+	@Test
+	public void runInNewDaemonThreadCallable_shouldNotThrowErrorIfCalledFromADaemonThread() throws Throwable {
+		Task taskThatStartsAnotherFuture = new TaskThatStartsAnotherFuture();
+		assertThat(new PrivateSchedulerTask(taskThatStartsAnotherFuture).runTheTest(), is(true));
 	}
 	
 	/**
@@ -140,7 +180,6 @@ public void daemonUser_shouldHaveAssociatedPerson() throws Throwable {
 		try {
 			TestTask task = new TestTask();
 			new PrivateSchedulerTask(task).runTask();
-			assertTrue(true);
 		}
 		catch (NullPointerException e) {
 			fail("Daemon user should have an associated person");
@@ -152,9 +191,9 @@ public void daemonUser_shouldHaveAssociatedPerson() throws Throwable {
 	 * 
 	 * @see DaemonTest#executeScheduledTask_shouldNotThrowErrorIfCalledFromATimerSchedulerTaskClass()
 	 */
-	private class PrivateSchedulerTask extends TimerSchedulerTask {
+	private static class PrivateSchedulerTask extends TimerSchedulerTask {
 		
-		private Task task;
+		private final Task task;
 		
 		public PrivateSchedulerTask(Task task) {
 			super(task);
@@ -163,8 +202,6 @@ public PrivateSchedulerTask(Task task) {
 		
 		/**
 		 * Returns true/false whether the task was successfully run by the Daemon user
-		 * 
-		 * @return
 		 */
 		public boolean runTheTest() throws Throwable {
 			Daemon.executeScheduledTask(this.task);
@@ -181,12 +218,12 @@ public void runTask() throws Throwable {
 	 * 
 	 *@see DaemonTest#executeScheduledTask_shouldNotThrowErrorIfCalledFromATimerSchedulerTaskClass()
 	 */
-	private class PrivateTask extends AbstractTask {
+	private static class PrivateTask extends AbstractTask {
 		
 		public boolean wasRun = false;
 		
 		@Override
-		public void execute() {
+		public void execute() throws InterruptedException, ExecutionException {
 			this.wasRun = true;
 		}
 	}
@@ -194,22 +231,38 @@ public void execute() {
 	/**
 	 * A task that starts another Daemon thread that marks *this* thread when it gets run. 
 	 */
-	private class TaskThatStartsAnotherThread extends PrivateTask {
+	private static class TaskThatStartsAnotherThread extends PrivateTask {
 		
 		@Override
-		public void execute() {
-			Thread another = Daemon.runInNewDaemonThread(() -> wasRun = true);
-			try {
-				another.join();
-			}
-			catch (InterruptedException ex) {}
+		public void execute() throws InterruptedException {
+			Thread another = Daemon.runInNewDaemonThread(() -> {
+				this.wasRun = true;
+			});
+			
+			another.join();
+		}
+	}
+
+	/**
+	 * A task that starts another Daemon thread that marks *this* thread when it gets run. 
+	 */
+	private static class TaskThatStartsAnotherFuture extends PrivateTask {
+
+		@Override
+		public void execute() throws ExecutionException, InterruptedException {
+			Future<Boolean> another = Daemon.runInNewDaemonThread(() ->{
+				this.wasRun = true; 
+				return true;
+			});
+			
+			assertThat(another.get(), is(true));
 		}
 	}
 	
 	/**
 	 * A task for testing to ensure that a daemon user always has an associated person.
 	 */
-	private class TestTask extends AbstractTask {
+	private static class TestTask extends AbstractTask {
 		
 		@Override
 		public void execute() {
@@ -225,7 +278,7 @@ public void execute() {
 	public void isDaemonUser_shouldReturnTrueForADaemonUser() {
 		User user = new User();
 		user.setUuid(Daemon.DAEMON_USER_UUID);
-		assertTrue(Daemon.isDaemonUser(user));
+		assertThat(Daemon.isDaemonUser(user), is(true));
 	}
 	
 	/**
@@ -236,6 +289,6 @@ public void isDaemonUser_shouldReturnTrueForADaemonUser() {
 	public void isDaemonUser_shouldReturnFalseIFTheUserIsNotADaemon() {
 		User user = new User();
 		user.setUuid("any other value");
-		assertFalse(Daemon.isDaemonUser(user));
+		assertThat(Daemon.isDaemonUser(user), is(false));
 	}
 }
diff --git a/api/src/test/java/org/openmrs/util/OpenmrsUtilTest.java b/api/src/test/java/org/openmrs/util/OpenmrsUtilTest.java
index 03d889884b89..cd4c9fa265fb 100644
--- a/api/src/test/java/org/openmrs/util/OpenmrsUtilTest.java
+++ b/api/src/test/java/org/openmrs/util/OpenmrsUtilTest.java
@@ -757,7 +757,6 @@ public void copyFile_shouldNotCopyTheOutputstreamIfInputstreamIsNull() throws IO
 	 */
 	@Test
 	public void copyFile_shouldCopyInputstreamToOutputstreamAndCloseTheOutputstream() throws IOException {
-
 		String exampleInputStreamString = "ExampleInputStream";
 		ByteArrayInputStream expectedByteArrayInputStream = new ByteArrayInputStream(exampleInputStreamString.getBytes());
 
diff --git a/web/src/main/java/org/openmrs/web/WebDaemon.java b/web/src/main/java/org/openmrs/web/WebDaemon.java
index 4e9e810c6086..bdb5e624a62b 100644
--- a/web/src/main/java/org/openmrs/web/WebDaemon.java
+++ b/web/src/main/java/org/openmrs/web/WebDaemon.java
@@ -10,63 +10,52 @@
 package org.openmrs.web;
 
 import javax.servlet.ServletContext;
+import javax.servlet.ServletException;
 
-import org.openmrs.api.context.Context;
 import org.openmrs.api.context.Daemon;
 import org.openmrs.module.ModuleException;
 import org.openmrs.util.DatabaseUpdateException;
 import org.openmrs.util.InputRequiredException;
 
+import java.util.concurrent.ExecutionException;
+
 /**
  * This class provides {@link Daemon} functionality in a web context.
  * 
  * @since 1.9
  */
-public class WebDaemon extends Daemon {
+public final class WebDaemon {
+	
+	private WebDaemon() {
+	};
 	
 	/**
 	 * Start openmrs in a new thread that is authenticated as the daemon user.
 	 * 
 	 * @param servletContext the servlet context.
 	 */
-	public static void startOpenmrs(final ServletContext servletContext) throws DatabaseUpdateException,
-	        InputRequiredException {
-		
-		// create a new thread and start openmrs in it.
-		DaemonThread startOpenmrsThread = new DaemonThread() {
-			
-			@Override
-			public void run() {
-				isDaemonThread.set(true);
+	public static void startOpenmrs(final ServletContext servletContext) throws DatabaseUpdateException, InputRequiredException {
+
+		try {
+			Daemon.runNewDaemonTask(() -> {
 				try {
 					Listener.startOpenmrs(servletContext);
+				} catch (ServletException e) {
+					throw new ModuleException("Unable to start OpenMRS. Error thrown was: " + e.getMessage(), e);
 				}
-				catch (Exception e) {
-					exceptionThrown = e;
-				}
-				finally {
-					try {
-						Context.closeSession();
-					} finally {
-						isDaemonThread.remove();
-					}
-				}
+			}).get();
+		} catch (InterruptedException  ignored) {
+		} catch (ExecutionException e) {
+			Throwable cause = e.getCause();
+			if (cause instanceof DatabaseUpdateException) {
+				throw (DatabaseUpdateException) cause;
+			} else if (cause instanceof InputRequiredException) {
+				throw (InputRequiredException) cause;
+			} else if (!(cause instanceof ModuleException)) {
+				throw new ModuleException("Unable to start OpenMRS. Error thrown was: " + cause.getMessage(), cause);
+			}  else {
+				throw (ModuleException) cause;
 			}
-		};
-		
-		startOpenmrsThread.start();
-		
-		// wait for the "startOpenmrs" thread to finish
-		try {
-			startOpenmrsThread.join();
-		}
-		catch (InterruptedException e) {
-			// ignore
-		}
-		
-		if (startOpenmrsThread.getExceptionThrown() != null) {
-			throw new ModuleException("Unable to start OpenMRS. Error thrown was: "
-			        + startOpenmrsThread.getExceptionThrown().getMessage(), startOpenmrsThread.getExceptionThrown());
 		}
 	}
 }
diff --git a/web/src/main/java/org/openmrs/web/filter/initialization/InitializationFilter.java b/web/src/main/java/org/openmrs/web/filter/initialization/InitializationFilter.java
index 810cfac0d5cb..5405142dfbc5 100644
--- a/web/src/main/java/org/openmrs/web/filter/initialization/InitializationFilter.java
+++ b/web/src/main/java/org/openmrs/web/filter/initialization/InitializationFilter.java
@@ -30,6 +30,8 @@
 import java.util.Map;
 import java.util.Properties;
 import java.util.Random;
+import java.util.concurrent.ExecutionException;
+import java.util.concurrent.Future;
 import java.util.zip.ZipInputStream;
 import javax.servlet.FilterChain;
 import javax.servlet.FilterConfig;
@@ -61,6 +63,7 @@
 import org.openmrs.util.DatabaseUtil;
 import org.openmrs.util.InputRequiredException;
 import org.openmrs.util.OpenmrsConstants;
+import org.openmrs.util.OpenmrsThreadPoolHolder;
 import org.openmrs.util.OpenmrsUtil;
 import org.openmrs.util.PrivilegeConstants;
 import org.openmrs.util.Security;
@@ -1245,7 +1248,7 @@ private boolean checkForEmptyValue(String value, Map<String, Object[]> errors, S
 	 */
 	private class InitializationCompletion {
 		
-		private Thread thread;
+		private final Future<Void> future;
 		
 		private int steps = 0;
 		
@@ -1287,15 +1290,13 @@ public synchronized Map<String, Object[]> getErrors() {
 		public void start() {
 			setStepsComplete(0);
 			setInitializationComplete(false);
-			thread.start();
 		}
 		
 		public void waitForCompletion() {
 			try {
-				thread.join();
-			}
-			catch (InterruptedException e) {
-				log.error("Error generated", e);
+				future.get();
+			} catch (InterruptedException | ExecutionException e) {
+				throw new RuntimeException(e);
 			}
 		}
 		
@@ -1886,7 +1887,7 @@ && getRuntimePropertiesFile().setReadable(true)) {
 				}
 			};
 			
-			thread = new Thread(r);
+			future = OpenmrsThreadPoolHolder.threadExecutor.submit(() -> { r.run(); return null; });
 		}
 	}
 	
diff --git a/web/src/main/java/org/openmrs/web/filter/update/UpdateFilter.java b/web/src/main/java/org/openmrs/web/filter/update/UpdateFilter.java
index 9a03f47d1153..360cffc4700f 100644
--- a/web/src/main/java/org/openmrs/web/filter/update/UpdateFilter.java
+++ b/web/src/main/java/org/openmrs/web/filter/update/UpdateFilter.java
@@ -20,6 +20,7 @@
 import org.openmrs.util.DatabaseUpdaterLiquibaseProvider;
 import org.openmrs.util.InputRequiredException;
 import org.openmrs.liquibase.ChangeLogVersionFinder;
+import org.openmrs.util.OpenmrsThreadPoolHolder;
 import org.openmrs.util.OpenmrsUtil;
 import org.openmrs.util.RoleConstants;
 import org.openmrs.util.Security;
@@ -30,6 +31,7 @@
 import org.openmrs.web.filter.util.CustomResourceLoader;
 import org.openmrs.web.filter.util.ErrorMessageConstants;
 import org.openmrs.web.filter.util.FilterUtil;
+import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.web.context.ContextLoader;
 
@@ -54,6 +56,7 @@
 import java.util.List;
 import java.util.Locale;
 import java.util.Map;
+import java.util.concurrent.Future;
 
 /**
  * This is the second filter that is processed. It is only active when OpenMRS has some liquibase
@@ -62,7 +65,7 @@
  */
 public class UpdateFilter extends StartupFilter {
 	
-	protected final org.slf4j.Logger log = LoggerFactory.getLogger(UpdateFilter.class);
+	protected final Logger log = LoggerFactory.getLogger(UpdateFilter.class);
 	
 	/**
 	 * The velocity macro page to redirect to if an error occurs or on initial startup
@@ -586,9 +589,9 @@ protected String getTemplatePrefix() {
 	 * executed. TODO: Break this out into a separate (non-inner) class
 	 */
 	private class UpdateFilterCompletion {
-		
-		private Thread thread;
-		
+
+		private Runnable r;
+
 		private String executingChangesetId = null;
 		
 		private List<String> changesetIds = new ArrayList<>();
@@ -627,7 +630,7 @@ public synchronized Map<String, Object[]> getErrors() {
 		 */
 		public void start() {
 			setUpdatesRequired(true);
-			thread.start();
+			OpenmrsThreadPoolHolder.threadExecutor.submit(r);
 		}
 		
 		public synchronized void setMessage(String message) {
@@ -671,7 +674,7 @@ public synchronized void reportWarnings(List<String> warnings) {
 		 * This class does all the work of creating the desired database, user, updates, etc
 		 */
 		public UpdateFilterCompletion() {
-			Runnable r = new Runnable() {
+			 r = new Runnable() {
 				
 				/**
 				 * TODO split this up into multiple testable methods
@@ -786,8 +789,6 @@ public void executing(ChangeSet changeSet, int numChangeSetsToRun) {
 					}
 				}
 			};
-			
-			thread = new Thread(r);
 		}
 	}
 }
diff --git a/web/src/test/java/org/openmrs/web/WebDaemonTest.java b/web/src/test/java/org/openmrs/web/WebDaemonTest.java
index 35d79e78872c..f9b68a7c671b 100644
--- a/web/src/test/java/org/openmrs/web/WebDaemonTest.java
+++ b/web/src/test/java/org/openmrs/web/WebDaemonTest.java
@@ -13,13 +13,11 @@
 
 import org.junit.jupiter.api.Test;
 import org.openmrs.module.ModuleException;
-import org.openmrs.util.DatabaseUpdateException;
-import org.openmrs.util.InputRequiredException;
 
 public class WebDaemonTest {
 	
 	@Test
-	public void startOpenmrs_shouldThrowExceptionGivenNull() throws DatabaseUpdateException, InputRequiredException {
+	public void startOpenmrs_shouldThrowExceptionGivenNull() {
 		assertThrows(ModuleException.class, () -> WebDaemon.startOpenmrs(null));
 	}
 

From 67eea8ab9f57952e1cccc4894933db5e0113d9d1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fr=C3=A9d=C3=A9ric=20Deniger=20-=20ICRC?=
 <65169434+icrc-fdeniger@users.noreply.github.com>
Date: Thu, 19 Sep 2024 21:39:08 +0200
Subject: [PATCH 118/163] do not fail on curl command (#4694)

---
 startup.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/startup.sh b/startup.sh
index 35cb64734d3a..c51550b9e0b9 100644
--- a/startup.sh
+++ b/startup.sh
@@ -50,7 +50,7 @@ echo "Starting up OpenMRS..."
 
 # Trigger first filter to start data import
 sleep 15
-curl -sL "http://localhost:8080/${OMRS_WEBAPP_NAME}/" > /dev/null
+curl -sL "http://localhost:8080/${OMRS_WEBAPP_NAME}/" > /dev/null || true
 sleep 15
 
 # Bring tomcat process to foreground again

From f715e67295c030c5c4a5fc99cf6adabaf8cd137b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 24 Sep 2024 22:20:58 +0300
Subject: [PATCH 119/163] maven(deps): bump com.google.guava:guava from
 33.3.0-jre to 33.3.1-jre (#4753)

Bumps [com.google.guava:guava](https://github.com/google/guava) from 33.3.0-jre to 33.3.1-jre.
- [Release notes](https://github.com/google/guava/releases)
- [Commits](https://github.com/google/guava/commits)

---
updated-dependencies:
- dependency-name: com.google.guava:guava
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 9ddb335d690f..f9812588bc3d 100644
--- a/pom.xml
+++ b/pom.xml
@@ -563,7 +563,7 @@
 			<dependency>
 				<groupId>com.google.guava</groupId>
 				<artifactId>guava</artifactId>
-				<version>33.3.0-jre</version>
+				<version>33.3.1-jre</version>
 			</dependency>
 			<dependency>
 			    <groupId>jakarta.xml.bind</groupId>

From b9f7169f423a4e550e3057021ac4665bebc0f631 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 25 Sep 2024 21:41:26 +0300
Subject: [PATCH 120/163] maven(deps): bump junitVersion from 5.11.0 to 5.11.1
 (#4754)

Bumps `junitVersion` from 5.11.0 to 5.11.1.

Updates `org.junit.jupiter:junit-jupiter-api` from 5.11.0 to 5.11.1
- [Release notes](https://github.com/junit-team/junit5/releases)
- [Commits](https://github.com/junit-team/junit5/compare/r5.11.0...r5.11.1)

Updates `org.junit.jupiter:junit-jupiter-engine` from 5.11.0 to 5.11.1
- [Release notes](https://github.com/junit-team/junit5/releases)
- [Commits](https://github.com/junit-team/junit5/compare/r5.11.0...r5.11.1)

Updates `org.junit.jupiter:junit-jupiter-params` from 5.11.0 to 5.11.1
- [Release notes](https://github.com/junit-team/junit5/releases)
- [Commits](https://github.com/junit-team/junit5/compare/r5.11.0...r5.11.1)

Updates `org.junit.vintage:junit-vintage-engine` from 5.11.0 to 5.11.1
- [Release notes](https://github.com/junit-team/junit5/releases)
- [Commits](https://github.com/junit-team/junit5/compare/r5.11.0...r5.11.1)

---
updated-dependencies:
- dependency-name: org.junit.jupiter:junit-jupiter-api
  dependency-type: direct:development
  update-type: version-update:semver-patch
- dependency-name: org.junit.jupiter:junit-jupiter-engine
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: org.junit.jupiter:junit-jupiter-params
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: org.junit.vintage:junit-vintage-engine
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index f9812588bc3d..39cf9c480ac1 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1217,7 +1217,7 @@
 		<luceneVersion>5.5.5</luceneVersion>
 		<aspectjVersion>1.9.22.1</aspectjVersion>
 		<jacksonVersion>2.17.2</jacksonVersion>
-		<junitVersion>5.11.0</junitVersion>
+		<junitVersion>5.11.1</junitVersion>
 		<mockitoVersion>3.12.4</mockitoVersion>
 		<hamcrestVersion>3.0</hamcrestVersion>
 

From c02e2e054f93fc6d1eb0e058cd59e177f7f73330 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 25 Sep 2024 21:42:01 +0300
Subject: [PATCH 121/163] maven(deps): bump net.bytebuddy:byte-buddy from
 1.15.1 to 1.15.2 (#4755)

Bumps [net.bytebuddy:byte-buddy](https://github.com/raphw/byte-buddy) from 1.15.1 to 1.15.2.
- [Release notes](https://github.com/raphw/byte-buddy/releases)
- [Changelog](https://github.com/raphw/byte-buddy/blob/master/release-notes.md)
- [Commits](https://github.com/raphw/byte-buddy/compare/byte-buddy-1.15.1...byte-buddy-1.15.2)

---
updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 39cf9c480ac1..2425814b65e7 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1129,7 +1129,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy</artifactId>
-						<version>1.15.1</version>
+						<version>1.15.2</version>
 					</dependency>
 					<dependency>
 						<groupId>net.bytebuddy</groupId>

From f4961a406300eb6e644605971cf9e42716a6e06b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 25 Sep 2024 21:42:23 +0300
Subject: [PATCH 122/163] maven(deps): bump net.bytebuddy:byte-buddy-agent from
 1.15.1 to 1.15.2 (#4756)

Bumps [net.bytebuddy:byte-buddy-agent](https://github.com/raphw/byte-buddy) from 1.15.1 to 1.15.2.
- [Release notes](https://github.com/raphw/byte-buddy/releases)
- [Changelog](https://github.com/raphw/byte-buddy/blob/master/release-notes.md)
- [Commits](https://github.com/raphw/byte-buddy/compare/byte-buddy-1.15.1...byte-buddy-1.15.2)

---
updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy-agent
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 2425814b65e7..080deaaeb633 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1134,7 +1134,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy-agent</artifactId>
-						<version>1.15.1</version>
+						<version>1.15.2</version>
 					</dependency>
 				</dependencies>
 			</dependencyManagement>

From ecbd0f2a07883f00cdd8c6766427d693e8097473 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 26 Sep 2024 22:32:46 +0300
Subject: [PATCH 123/163] maven(deps): bump
 org.codehaus.cargo:cargo-maven3-plugin (#4758)

Bumps org.codehaus.cargo:cargo-maven3-plugin from 1.10.14 to 1.10.15.

---
updated-dependencies:
- dependency-name: org.codehaus.cargo:cargo-maven3-plugin
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 webapp/pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/webapp/pom.xml b/webapp/pom.xml
index af686ea059c5..a956b5b97d76 100644
--- a/webapp/pom.xml
+++ b/webapp/pom.xml
@@ -237,7 +237,7 @@
 		  <plugin>
               <groupId>org.codehaus.cargo</groupId>
               <artifactId>cargo-maven3-plugin</artifactId>
-              <version>1.10.14</version>
+              <version>1.10.15</version>
               <configuration>
                   <container>
                       <containerId>tomcat9x</containerId>

From 1e0b36100c6e449a745dd20abe309ef7f3c8976d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 28 Sep 2024 21:32:11 +0300
Subject: [PATCH 124/163] maven(deps): bump jacksonVersion from 2.17.2 to
 2.18.0 (#4759)

Bumps `jacksonVersion` from 2.17.2 to 2.18.0.

Updates `com.fasterxml.jackson.core:jackson-core` from 2.17.2 to 2.18.0
- [Commits](https://github.com/FasterXML/jackson-core/compare/jackson-core-2.17.2...jackson-core-2.18.0)

Updates `com.fasterxml.jackson.core:jackson-annotations` from 2.17.2 to 2.18.0
- [Commits](https://github.com/FasterXML/jackson/commits)

Updates `com.fasterxml.jackson.core:jackson-databind` from 2.17.2 to 2.18.0
- [Commits](https://github.com/FasterXML/jackson/commits)

Updates `com.fasterxml.jackson.datatype:jackson-datatype-jsr310` from 2.17.2 to 2.18.0

---
updated-dependencies:
- dependency-name: com.fasterxml.jackson.core:jackson-core
  dependency-type: direct:production
  update-type: version-update:semver-minor
- dependency-name: com.fasterxml.jackson.core:jackson-annotations
  dependency-type: direct:production
  update-type: version-update:semver-minor
- dependency-name: com.fasterxml.jackson.core:jackson-databind
  dependency-type: direct:production
  update-type: version-update:semver-minor
- dependency-name: com.fasterxml.jackson.datatype:jackson-datatype-jsr310
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 080deaaeb633..fe93aa93883e 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1216,7 +1216,7 @@
 		<hibernateSearchVersion>5.11.12.Final</hibernateSearchVersion>
 		<luceneVersion>5.5.5</luceneVersion>
 		<aspectjVersion>1.9.22.1</aspectjVersion>
-		<jacksonVersion>2.17.2</jacksonVersion>
+		<jacksonVersion>2.18.0</jacksonVersion>
 		<junitVersion>5.11.1</junitVersion>
 		<mockitoVersion>3.12.4</mockitoVersion>
 		<hamcrestVersion>3.0</hamcrestVersion>

From 52c2499da6fb15229662cedb877b2f646b468530 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 28 Sep 2024 21:34:32 +0300
Subject: [PATCH 125/163] maven(deps): bump net.bytebuddy:byte-buddy from
 1.15.2 to 1.15.3 (#4762)

Bumps [net.bytebuddy:byte-buddy](https://github.com/raphw/byte-buddy) from 1.15.2 to 1.15.3.
- [Release notes](https://github.com/raphw/byte-buddy/releases)
- [Changelog](https://github.com/raphw/byte-buddy/blob/master/release-notes.md)
- [Commits](https://github.com/raphw/byte-buddy/compare/byte-buddy-1.15.2...byte-buddy-1.15.3)

---
updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index fe93aa93883e..12269fca6665 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1129,7 +1129,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy</artifactId>
-						<version>1.15.2</version>
+						<version>1.15.3</version>
 					</dependency>
 					<dependency>
 						<groupId>net.bytebuddy</groupId>

From 1ba0ddafbea9397f9ef53290ed0eb6ebb961139f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 28 Sep 2024 21:34:56 +0300
Subject: [PATCH 126/163] maven(deps): bump net.bytebuddy:byte-buddy-agent from
 1.15.2 to 1.15.3 (#4763)

Bumps [net.bytebuddy:byte-buddy-agent](https://github.com/raphw/byte-buddy) from 1.15.2 to 1.15.3.
- [Release notes](https://github.com/raphw/byte-buddy/releases)
- [Changelog](https://github.com/raphw/byte-buddy/blob/master/release-notes.md)
- [Commits](https://github.com/raphw/byte-buddy/compare/byte-buddy-1.15.2...byte-buddy-1.15.3)

---
updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy-agent
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 12269fca6665..6b2ee59a4a32 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1134,7 +1134,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy-agent</artifactId>
-						<version>1.15.2</version>
+						<version>1.15.3</version>
 					</dependency>
 				</dependencies>
 			</dependencyManagement>

From 03ef7cefa7d15a6020057038c86bc12e666ff89a Mon Sep 17 00:00:00 2001
From: Lubwama Samuel <lubwamasamuel3@gmail.com>
Date: Mon, 30 Sep 2024 12:43:51 +0300
Subject: [PATCH 127/163] Resolve 3.3.2 (#4718)

---
 webapp/src/main/webapp/WEB-INF/web.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/webapp/src/main/webapp/WEB-INF/web.xml b/webapp/src/main/webapp/WEB-INF/web.xml
index 6f3f7a6ab20f..d7212ab4cf70 100644
--- a/webapp/src/main/webapp/WEB-INF/web.xml
+++ b/webapp/src/main/webapp/WEB-INF/web.xml
@@ -339,6 +339,7 @@
 	<session-config>
 	    <cookie-config>
 	        <http-only>true</http-only>
+			<secure>true</secure>
 	    </cookie-config>
 	</session-config>
 	

From b9d853f7230cc8574e483aab03c006fa27b0b37a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 30 Sep 2024 22:24:50 +0300
Subject: [PATCH 128/163] maven(deps): bump log4jVersion from 2.24.0 to 2.24.1
 (#4764)

Bumps `log4jVersion` from 2.24.0 to 2.24.1.

Updates `org.apache.logging.log4j:log4j-core` from 2.24.0 to 2.24.1

Updates `org.apache.logging.log4j:log4j-slf4j-impl` from 2.24.0 to 2.24.1

Updates `org.apache.logging.log4j:log4j-1.2-api` from 2.24.0 to 2.24.1

---
updated-dependencies:
- dependency-name: org.apache.logging.log4j:log4j-core
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: org.apache.logging.log4j:log4j-slf4j-impl
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: org.apache.logging.log4j:log4j-1.2-api
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 6b2ee59a4a32..6d7f12f6681c 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1222,7 +1222,7 @@
 		<hamcrestVersion>3.0</hamcrestVersion>
 
 		<slf4jVersion>1.7.36</slf4jVersion>
-		<log4jVersion>2.24.0</log4jVersion>
+		<log4jVersion>2.24.1</log4jVersion>
 		<owaspCsrfGuardVersion>4.2.1</owaspCsrfGuardVersion>
 
 		<customArgLineForTesting />

From 7ef9c75f135897d33ba7f22e4e099aadea65f94f Mon Sep 17 00:00:00 2001
From: Isaiah Muli <48686606+dicksonmulli@users.noreply.github.com>
Date: Tue, 1 Oct 2024 16:03:31 +0300
Subject: [PATCH 129/163] TRUNK-6245: concept reference ranges (#4687)

* TRUNK-6245 Age sensitive concept ranges

* Changelog file update

* Reverting unnecessary liqubase changes

* Adding unit tests

* Change on the method documentation

* Adding hbm file for ConceptReferenceRange

* Update on license

* Fixing failing tests

* Updating evaluation criteria

* Saving Obs Reference Range

* Removing unused imports

* Removing editable attributes from ObsReferenceRange

* Resolving comments in PR

* Small update

* Solved validation issues

* Update

* Some updates

* Update from comments in PR

* Adding a relationship between conceptNumeric and conceptReferenceRange

* Implementing voidable and creatable interfaces

* Some changes from PR

* Fixes

* Setting reference range in Obs

* Code clean up

* Fixing db check

* Fix change set count

* Moving get age logic to Person class

* Adding tests to get age methods

* Code clean up

* Fixing obs_reference_range not saved

* Small change

* Fixing one test

* Using exiting sorting mechanism

* Using exiting sorting mechanism

* Final changes

* Adding comments in liquibase changelogs

* Method to check if numeric value is in range

* Improvements

* Small change

* Setting Obs reference range from concept concept

* Fixing failing tests

* Refactor

* Updating the order of validation of reference ranges

* Small change

* Fixed a bug - latest obs should be fetched by conceptRef and patient

* CHanging time of the day method

* Criteria evaluation using current obs

* Setting interpretation

* Removing since from private methods

* Removing static in obs validator

* Small change

* Adding concept messages for UI

* Setting the right interpretation - feedback from Burke

* Setting the right interpretation - feedback from Burke

* Adding a helper method

* Code refactor and updating concept hbm

* Added a helper method to remove reference range

* Using Base object in reference range class

* Adding uuid to obs reference range

* order reference ranges

* API method for fetching reference ranges

* Improving docs
---
 .../java/org/openmrs/BaseReferenceRange.java  | 149 +++++
 .../main/java/org/openmrs/ConceptNumeric.java |  50 ++
 .../org/openmrs/ConceptReferenceRange.java    | 128 +++++
 api/src/main/java/org/openmrs/Obs.java        |  25 +-
 .../java/org/openmrs/ObsReferenceRange.java   |  99 ++++
 api/src/main/java/org/openmrs/Person.java     |  73 ++-
 .../java/org/openmrs/api/ConceptService.java  |  43 ++
 .../main/java/org/openmrs/api/ObsService.java |   2 +-
 .../java/org/openmrs/api/db/ConceptDAO.java   |  16 +
 .../main/java/org/openmrs/api/db/ObsDAO.java  |   2 +-
 .../api/db/hibernate/HibernateConceptDAO.java |  41 +-
 .../api/db/hibernate/HibernateObsDAO.java     |   2 +-
 .../openmrs/api/impl/ConceptServiceImpl.java  |  23 +
 .../org/openmrs/api/impl/ObsServiceImpl.java  |   1 -
 .../util/ConceptReferenceRangeUtility.java    | 142 +++++
 .../java/org/openmrs/util/OpenmrsUtil.java    |  28 +
 .../org/openmrs/validator/ObsValidator.java   | 216 ++++++++
 api/src/main/resources/hibernate.cfg.xml      |   5 +-
 api/src/main/resources/messages.properties    |   2 +
 .../openmrs/api/db/hibernate/Concept.hbm.xml  |   4 +
 .../org/openmrs/api/db/hibernate/Obs.hbm.xml  |   2 +
 .../liquibase-update-to-latest-2.7.x.xml      |  70 +++
 .../java/org/openmrs/ConceptNumericTest.java  |  22 +
 api/src/test/java/org/openmrs/ObsTest.java    |   2 +-
 api/src/test/java/org/openmrs/PersonTest.java |  61 +++
 .../org/openmrs/api/ConceptServiceTest.java   |  71 ++-
 .../java/org/openmrs/api/ObsServiceTest.java  |  56 +-
 .../db/hibernate/HibernateConceptDAOTest.java |  23 +
 .../api/impl/ConceptServiceImplTest.java      |  62 ++-
 .../ConceptReferenceRangeUtilityTest.java     | 510 ++++++++++++++++++
 .../util/DatabaseUpdaterDatabaseIT.java       |   2 +-
 .../org/openmrs/util/OpenmrsUtilTest.java     |  62 ++-
 .../openmrs/validator/ObsValidatorTest.java   | 279 +++++++++-
 ...nceptServiceTest-conceptReferenceRange.xml |  21 +
 .../openmrs/include/standardTestDataset.xml   |  15 +
 .../scripts/jquery-ui/js/openmrsSearch.js     |  80 +--
 .../autocomplete/OpenmrsAutoComplete.js       |  17 +-
 37 files changed, 2345 insertions(+), 61 deletions(-)
 create mode 100644 api/src/main/java/org/openmrs/BaseReferenceRange.java
 create mode 100644 api/src/main/java/org/openmrs/ConceptReferenceRange.java
 create mode 100644 api/src/main/java/org/openmrs/ObsReferenceRange.java
 create mode 100644 api/src/main/java/org/openmrs/util/ConceptReferenceRangeUtility.java
 create mode 100644 api/src/test/java/org/openmrs/util/ConceptReferenceRangeUtilityTest.java
 create mode 100644 api/src/test/resources/org/openmrs/api/include/ConceptServiceTest-conceptReferenceRange.xml

diff --git a/api/src/main/java/org/openmrs/BaseReferenceRange.java b/api/src/main/java/org/openmrs/BaseReferenceRange.java
new file mode 100644
index 000000000000..6fba514e70ed
--- /dev/null
+++ b/api/src/main/java/org/openmrs/BaseReferenceRange.java
@@ -0,0 +1,149 @@
+/**
+ * This Source Code Form is subject to the terms of the Mozilla Public License,
+ * v. 2.0. If a copy of the MPL was not distributed with this file, You can
+ * obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
+ * the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
+ *
+ * Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
+ * graphic logo is a trademark of OpenMRS Inc.
+ */
+package org.openmrs;
+
+import javax.persistence.Column;
+import javax.persistence.MappedSuperclass;
+import java.io.Serializable;
+
+/**
+ * This is the base class for reference ranges.
+ * 
+ * @since 2.7.0
+ */
+@MappedSuperclass
+public abstract class BaseReferenceRange extends BaseOpenmrsObject implements Serializable {
+	
+	@Column(name = "hi_absolute")
+	private Double hiAbsolute;
+
+	@Column(name = "hi_critical")
+	private Double hiCritical;
+
+	@Column(name = "hi_normal")
+	private Double hiNormal;
+
+	@Column(name = "low_absolute")
+	private Double lowAbsolute;
+
+	@Column(name = "low_critical")
+	private Double lowCritical;
+
+	@Column(name = "low_normal")
+	private Double lowNormal;
+
+	/**
+	 * Gets high absolute value of the referenceRange
+	 *
+	 * @return hiAbsolute the high absolute value
+	 */
+	public Double getHiAbsolute() {
+		return this.hiAbsolute;
+	}
+
+	/**
+	 * Sets high absolute value of the referenceRange
+	 *
+	 * @param hiAbsolute high absolute value to set
+	 */
+	public void setHiAbsolute(Double hiAbsolute) {
+		this.hiAbsolute = hiAbsolute;
+	}
+
+	/**
+	 * Gets high critical value of the referenceRange
+	 *
+	 * @return the high critical value
+	 */
+	public Double getHiCritical() {
+		return this.hiCritical;
+	}
+
+	/**
+	 * Sets high critical value of the referenceRange
+	 *
+	 * @param hiCritical high critical value to set
+	 */
+	public void setHiCritical(Double hiCritical) {
+		this.hiCritical = hiCritical;
+	}
+
+	/**
+	 * Returns high normal value of the referenceRange
+	 *
+	 * @return the high normal value
+	 */
+	public Double getHiNormal() {
+		return this.hiNormal;
+	}
+
+	/**
+	 * Sets high normal value of the referenceRange
+	 *
+	 * @param hiNormal high normal value to set
+	 */
+	public void setHiNormal(Double hiNormal) {
+		this.hiNormal = hiNormal;
+	}
+
+	/**
+	 * Gets low absolute value of the referenceRange
+	 *
+	 * @return the low absolute value
+	 */
+	public Double getLowAbsolute() {
+		return this.lowAbsolute;
+	}
+
+	/**
+	 * Sets low absolute value of the referenceRange
+	 *
+	 * @param lowAbsolute low absolute value to set
+	 */
+	public void setLowAbsolute(Double lowAbsolute) {
+		this.lowAbsolute = lowAbsolute;
+	}
+
+	/**
+	 * Gets low critical value of the referenceRange
+	 *
+	 * @return the low critical value
+	 */
+	public Double getLowCritical() {
+		return this.lowCritical;
+	}
+
+	/**
+	 * Sets low critical value of the referenceRange
+	 *
+	 * @param lowCritical low critical value to set
+	 */
+	public void setLowCritical(Double lowCritical) {
+		this.lowCritical = lowCritical;
+	}
+
+	/**
+	 * Gets low normal value of the referenceRange
+	 *
+	 * @return the low normal value
+	 */
+	public Double getLowNormal() {
+		return this.lowNormal;
+	}
+
+	/**
+	 * Sets low normal value of the referenceRange
+	 *
+	 * @param lowNormal low normal value to set
+	 */
+	public void setLowNormal(Double lowNormal) {
+		this.lowNormal = lowNormal;
+	}
+}
diff --git a/api/src/main/java/org/openmrs/ConceptNumeric.java b/api/src/main/java/org/openmrs/ConceptNumeric.java
index 82d1de6df6d5..d4ec34ae46b6 100644
--- a/api/src/main/java/org/openmrs/ConceptNumeric.java
+++ b/api/src/main/java/org/openmrs/ConceptNumeric.java
@@ -10,6 +10,7 @@
 package org.openmrs;
 
 import java.util.HashSet;
+import java.util.Set;
 import java.util.TreeSet;
 
 import org.codehaus.jackson.annotate.JsonIgnore;
@@ -45,6 +46,8 @@ public class ConceptNumeric extends Concept {
 	
 	private Boolean allowDecimal = false;
 	
+	private Set<ConceptReferenceRange> referenceRanges;
+	
 	/**
 	 * displayPrecision, represents the number of significant digits
 	 * to be used for display of a numeric value
@@ -55,6 +58,7 @@ public class ConceptNumeric extends Concept {
 	
 	/** default constructor */
 	public ConceptNumeric() {
+		referenceRanges = new HashSet<>();
 	}
 	
 	/**
@@ -127,6 +131,8 @@ public ConceptNumeric(Concept c) {
 		this.lowNormal = null;
 		this.units = "";
 		this.allowDecimal = false;
+
+		referenceRanges = new HashSet<>();
 	}
 	
 	// Property accessors
@@ -228,4 +234,48 @@ public void setAllowDecimal(Boolean allowDecimal) {
 	public Boolean isAllowDecimal() {
 		return getAllowDecimal();
 	}
+
+	/**
+	 * Gets conceptReferenceRanges
+	 * 
+	 * @since 2.7.0
+	 * 
+	 * @return list of conceptReferenceRange
+	 */
+	public Set<ConceptReferenceRange> getReferenceRanges() {
+		return referenceRanges;
+	}
+
+	/**
+	 * Sets conceptReferenceRanges
+	 * 
+	 * @since 2.7.0
+	 * 
+	 * @param referenceRanges List of ConceptReferenceRange
+	 */
+	public void setReferenceRanges(Set<ConceptReferenceRange> referenceRanges) {
+		this.referenceRanges = referenceRanges;
+	}
+
+	/**
+	 * Helper method used to add conceptReferenceRange to the list of conceptReferenceRanges
+	 *
+	 * @since 2.7.0
+	 *
+	 * @param referenceRange to add
+	 */
+	public void addReferenceRange(ConceptReferenceRange referenceRange) {
+		getReferenceRanges().add(referenceRange);
+	}
+
+	/**
+	 * Helper method used to remove conceptReferenceRange from a list of conceptReferenceRanges
+	 *
+	 * @param referenceRange reference range to remove
+	 *                          
+	 * @since 2.7.0
+	 */
+	public void removeReferenceRange(ConceptReferenceRange referenceRange) {
+		getReferenceRanges().remove(referenceRange);
+	}
 }
diff --git a/api/src/main/java/org/openmrs/ConceptReferenceRange.java b/api/src/main/java/org/openmrs/ConceptReferenceRange.java
new file mode 100644
index 000000000000..f46700806d7f
--- /dev/null
+++ b/api/src/main/java/org/openmrs/ConceptReferenceRange.java
@@ -0,0 +1,128 @@
+/**
+ * This Source Code Form is subject to the terms of the Mozilla Public License,
+ * v. 2.0. If a copy of the MPL was not distributed with this file, You can
+ * obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
+ * the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
+ *
+ * Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
+ * graphic logo is a trademark of OpenMRS Inc.
+ */
+package org.openmrs;
+
+import org.hibernate.envers.Audited;
+import org.hibernate.search.annotations.DocumentId;
+
+import javax.persistence.Column;
+import javax.persistence.Entity;
+import javax.persistence.FetchType;
+import javax.persistence.GeneratedValue;
+import javax.persistence.GenerationType;
+import javax.persistence.Id;
+import javax.persistence.JoinColumn;
+import javax.persistence.ManyToOne;
+import javax.persistence.Table;
+
+/**
+ * A concept reference range defines the acceptable numeric values/ranges of a {@link ConceptNumeric} for specific factors
+ * such as age, gender, e.t.c.
+ * 
+ * <p>
+ * The criteria is used to evaluate if certain attributes of a patient meet a certain factor range. 
+ * For example, if criteria is of factor age(say age between 1-5), then the ranges only apply for this age group. 
+ * </p>
+ *
+ * @since 2.7.0
+ */
+@Audited
+@Entity
+@Table(name = "concept_reference_range")
+public class ConceptReferenceRange extends BaseReferenceRange implements OpenmrsObject {
+	
+	private static final long serialVersionUID = 47329L;
+
+	@DocumentId
+	@Id
+	@Column(name = "concept_reference_range_id")
+	@GeneratedValue(strategy = GenerationType.IDENTITY)
+	private Integer conceptReferenceRangeId;
+
+	@Column(name = "criteria")
+	private String criteria;
+
+	@ManyToOne(fetch = FetchType.LAZY)
+	@JoinColumn(name = "concept_id", nullable = false)
+	private ConceptNumeric conceptNumeric;
+	
+	public ConceptReferenceRange() {
+	}
+
+	/**
+	 * Gets id of conceptReferenceRange
+	 *
+	 * @return Returns the ConceptReferenceRangeId.
+	 */
+	public Integer getConceptReferenceRangeId() {
+		return conceptReferenceRangeId;
+	}
+
+	/**
+	 * Sets conceptReferenceRangeId
+	 *
+	 * @param conceptReferenceRangeId The conceptReferenceRangeId to set.
+	 */
+	public void setConceptReferenceRangeId(Integer conceptReferenceRangeId) {
+		this.conceptReferenceRangeId = conceptReferenceRangeId;
+	}
+
+	/**
+	 * Gets the criteria of conceptReferenceRange
+	 *
+	 * @return criteria
+	 */
+	public String getCriteria() {
+		return this.criteria;
+	}
+
+	/**
+	 * Sets the criteria of conceptReferenceRange
+	 *
+	 * @param criteria the criteria to set
+	 */
+	public void setCriteria(String criteria) {
+		this.criteria = criteria;
+	}
+
+	/**
+	 * Gets conceptNumeric of conceptReferenceRange
+	 *
+	 * @return Returns the ConceptNumeric.
+	 */
+	public ConceptNumeric getConceptNumeric() {
+		return conceptNumeric;
+	}
+
+	/**
+	 * Sets conceptNumeric
+	 *
+	 * @param conceptNumeric concept to set.
+	 */
+	public void setConceptNumeric(ConceptNumeric conceptNumeric) {
+		this.conceptNumeric = conceptNumeric;
+	}
+
+	/**
+	 * @see org.openmrs.OpenmrsObject#getId()
+	 */
+	@Override
+	public Integer getId() {
+		return getConceptReferenceRangeId();
+	}
+
+	/**
+	 * @see org.openmrs.OpenmrsObject#setId(java.lang.Integer)
+	 */
+	@Override
+	public void setId(Integer id) {
+		setConceptReferenceRangeId(id);
+	}
+}
diff --git a/api/src/main/java/org/openmrs/Obs.java b/api/src/main/java/org/openmrs/Obs.java
index 7f2648588ca5..af160780369e 100644
--- a/api/src/main/java/org/openmrs/Obs.java
+++ b/api/src/main/java/org/openmrs/Obs.java
@@ -153,7 +153,9 @@ public enum Status {
 	private Interpretation interpretation;
 	
 	private Status status = Status.FINAL;
-	
+
+	private ObsReferenceRange referenceRange;
+
 	/** default constructor */
 	public Obs() {
 	}
@@ -1244,4 +1246,25 @@ public void setStatus(Status status) {
 		markAsDirty(this.status, status);
 		this.status = status;
 	}
+
+	/**
+	 * Returns the ObsReferenceRange
+	 * @return obsReferenceRange.
+	 * 
+	 * @since 2.7.0
+	 */
+	public ObsReferenceRange getReferenceRange() {
+		return referenceRange;
+	}
+	
+	/**
+	 * Sets ObsReferenceRange
+	 * 
+	 * @param referenceRange ObsReferenceRange to set.
+	 *               
+	 * @since 2.7.0
+	 */
+	public void setReferenceRange(ObsReferenceRange referenceRange) {
+		this.referenceRange = referenceRange;
+	}
 }
diff --git a/api/src/main/java/org/openmrs/ObsReferenceRange.java b/api/src/main/java/org/openmrs/ObsReferenceRange.java
new file mode 100644
index 000000000000..10a02a167ed0
--- /dev/null
+++ b/api/src/main/java/org/openmrs/ObsReferenceRange.java
@@ -0,0 +1,99 @@
+/**
+ * This Source Code Form is subject to the terms of the Mozilla Public License,
+ * v. 2.0. If a copy of the MPL was not distributed with this file, You can
+ * obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
+ * the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
+ *
+ * Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
+ * graphic logo is a trademark of OpenMRS Inc.
+ */
+package org.openmrs;
+
+import org.hibernate.envers.Audited;
+import org.hibernate.search.annotations.DocumentId;
+
+import javax.persistence.Column;
+import javax.persistence.Entity;
+import javax.persistence.GeneratedValue;
+import javax.persistence.GenerationType;
+import javax.persistence.Id;
+import javax.persistence.JoinColumn;
+import javax.persistence.OneToOne;
+import javax.persistence.Table;
+
+/**
+ * ObsReferenceRange is typically a reference range of a numeric Observation 
+ * The reference range is created at the point of creating {@link Obs}
+ *
+ * @since 2.7.0
+ */
+@Audited
+@Entity
+@Table(name = "obs_reference_range")
+public class ObsReferenceRange extends BaseReferenceRange {
+	
+	private static final long serialVersionUID = 473299L;
+
+	@DocumentId
+	@Id
+	@Column(name = "obs_reference_range_id")
+	@GeneratedValue(strategy = GenerationType.IDENTITY)
+	private Integer obsReferenceRangeId;
+	
+	@OneToOne
+	@JoinColumn(name = "obs_id", referencedColumnName = "obs_id", unique = true)
+	private Obs obs;
+
+	public ObsReferenceRange() {
+	}
+	
+	/**
+	 * Gets the obsReferenceRangeId
+	 * 
+	 * @return Returns the obsReferenceRangeId.
+	 */
+	public Integer getObsReferenceRangeId() {
+		return obsReferenceRangeId;
+	}
+
+	/**
+	 * Sets the obsReferenceRangeId
+	 * 
+	 * @param obsReferenceRangeId The obsReferenceRangeId to set.
+	 */
+	public void setObsReferenceRangeId(Integer obsReferenceRangeId) {
+		this.obsReferenceRangeId = obsReferenceRangeId;
+	}
+
+	/**
+	 * @see org.openmrs.OpenmrsObject#getId()
+	 */
+	public Integer getId() {
+		return getObsReferenceRangeId();
+	}
+
+	/**
+	 * @see org.openmrs.OpenmrsObject#setId(java.lang.Integer)
+	 */
+	public void setId(Integer id) {
+		setObsReferenceRangeId(id);
+	}
+
+	/**
+	 * Gets Obs
+	 * 
+	 * @return Obs
+	 */
+	public Obs getObs() {
+		return obs;
+	}
+
+	/**
+	 * Sets obs 
+	 * 
+	 * @param obs Obs to set
+	 */
+	public void setObs(Obs obs) {
+		this.obs = obs;
+	}
+}
diff --git a/api/src/main/java/org/openmrs/Person.java b/api/src/main/java/org/openmrs/Person.java
index a23577e8ed53..1c14b0008d5b 100644
--- a/api/src/main/java/org/openmrs/Person.java
+++ b/api/src/main/java/org/openmrs/Person.java
@@ -11,6 +11,8 @@
 
 import java.text.ParseException;
 import java.text.SimpleDateFormat;
+import java.time.LocalDate;
+import java.time.temporal.ChronoUnit;
 import java.util.ArrayList;
 import java.util.Calendar;
 import java.util.Date;
@@ -946,6 +948,76 @@ public Integer getAge(Date onDate) {
 		
 		return age;
 	}
+
+	/**
+	 * Method to get the age of a person in months.
+	 *
+	 * @return the age in months as an Integer e.g. 20 (to mean 20 months)
+	 *
+	 * @since 2.7.0
+	 */
+	public Integer getAgeInMonths() {
+		return getAgeInChronoUnit(ChronoUnit.MONTHS);
+	}
+
+	/**
+	 * Method to get the age of a person in weeks.
+	 *
+	 * @return the age in weeks as an Integer e.g. 20 (to mean 20 weeks)
+	 *
+	 * @since 2.7.0
+	 */
+	public Integer getAgeInWeeks() {
+		return getAgeInChronoUnit(ChronoUnit.WEEKS);
+	}
+
+	/**
+	 * Method to get the age of a person in days.
+	 *
+	 * @return the age in days as an Integer e.g. 20 (to mean 20 days)
+	 *
+	 * @since 2.7.0
+	 */
+	public Integer getAgeInDays() {
+		return getAgeInChronoUnit(ChronoUnit.DAYS);
+	}
+
+	/**
+	 * Gets the age of a person with the specified ChronoUnit.
+	 *
+	 * @param chronoUnit the unit of precision for the age calculation (e.g. WEEKS, MONTHS, YEARS)
+	 * @return the age in the specified unit as an Integer
+	 *
+	 * @since 2.7.0
+	 */
+	private Integer getAgeInChronoUnit(ChronoUnit chronoUnit) {
+		if (this.birthdate == null) {
+			return null;
+		}
+
+		LocalDate birthDate = new java.sql.Date(this.birthdate.getTime()).toLocalDate();
+		LocalDate endDate = LocalDate.now();
+
+		// If date given is after date of death then use date of death as end date
+		if (this.deathDate != null) {
+			LocalDate deathDate = new java.sql.Date(this.deathDate.getTime()).toLocalDate();
+
+			if (endDate.isAfter(deathDate)) {
+				endDate = deathDate;
+			}
+		}
+
+		switch (chronoUnit) {
+			case DAYS:
+				return (int) ChronoUnit.DAYS.between(birthDate, endDate);
+			case WEEKS:
+				return (int) ChronoUnit.WEEKS.between(birthDate, endDate);
+			case MONTHS:
+				return (int) ChronoUnit.MONTHS.between(birthDate, endDate);
+			default:
+				throw new IllegalArgumentException("Unsupported ChronoUnit: " + chronoUnit);
+		}
+	}
 	
 	/**
 	 * Convenience method: sets a person's birth date from an age as of the given date Also sets
@@ -1100,5 +1172,4 @@ public void setId(Integer id) {
 		setPersonId(id);
 		
 	}
-	
 }
diff --git a/api/src/main/java/org/openmrs/api/ConceptService.java b/api/src/main/java/org/openmrs/api/ConceptService.java
index 2ce3fb97c855..75c617fcfd79 100644
--- a/api/src/main/java/org/openmrs/api/ConceptService.java
+++ b/api/src/main/java/org/openmrs/api/ConceptService.java
@@ -29,6 +29,7 @@
 import org.openmrs.ConceptNameTag;
 import org.openmrs.ConceptNumeric;
 import org.openmrs.ConceptProposal;
+import org.openmrs.ConceptReferenceRange;
 import org.openmrs.ConceptReferenceTerm;
 import org.openmrs.ConceptReferenceTermMap;
 import org.openmrs.ConceptSearchResult;
@@ -1982,5 +1983,47 @@ public List<ConceptSearchResult> getOrderableConcepts(String phrase, List<Locale
 	 */
 	@Authorized(PrivilegeConstants.GET_CONCEPTS)
 	boolean hasAnyConceptAttribute(ConceptAttributeType conceptAttributeType);
+
+	/**
+	 * Creates or updates the given {@link ConceptReferenceRange} in the database
+	 *
+	 * @param conceptReferenceRange ConceptReferenceRange to save
+	 * @return the created ConceptReferenceRange
+	 * 
+	 * @since 2.7.0
+	 * 
+	 * <strong>Should</strong> create a new concept reference range
+	 * <strong>Should</strong> edit an existing concept reference range
+	 */
+	@Authorized(PrivilegeConstants.MANAGE_CONCEPTS)
+	ConceptReferenceRange saveConceptReferenceRange(ConceptReferenceRange conceptReferenceRange);
+
+	/**
+	 * This method gets ConceptReferenceRange by concept id
+	 * 
+	 * @param conceptId conceptId 
+	 * @return list of {@link ConceptReferenceRange}
+	 *
+	 * @since 2.7.0
+	 *
+	 * <strong>Should</strong> get a list of conceptReferenceRanges with the given conceptId
+	 * <strong>Should</strong> return empty list if none of conceptReferenceRanges has the given conceptId
+	 */
+	@Authorized(PrivilegeConstants.GET_CONCEPTS)
+	List<ConceptReferenceRange> getConceptReferenceRangesByConceptId(Integer conceptId);
+
+	/**
+	 * This method gets ConceptReferenceRange by uuid
+	 *
+	 * @param uuid uuid 
+	 * @return {@link ConceptReferenceRange}
+	 *
+	 * @since 2.7.0
+	 *
+	 * <strong>Should</strong> get a conceptReferenceRange if found
+	 * <strong>Should</strong> return null if no conceptReferenceRange was found with the given uuid
+	 */
+	@Authorized(PrivilegeConstants.GET_CONCEPTS)
+	ConceptReferenceRange getConceptReferenceRangeByUuid(String uuid);
 	
 }
diff --git a/api/src/main/java/org/openmrs/api/ObsService.java b/api/src/main/java/org/openmrs/api/ObsService.java
index dc2970ae53a2..7bddf03a0df0 100644
--- a/api/src/main/java/org/openmrs/api/ObsService.java
+++ b/api/src/main/java/org/openmrs/api/ObsService.java
@@ -18,6 +18,7 @@
 import org.openmrs.Encounter;
 import org.openmrs.Location;
 import org.openmrs.Obs;
+import org.openmrs.ObsReferenceRange;
 import org.openmrs.Person;
 import org.openmrs.Visit;
 import org.openmrs.annotation.Authorized;
@@ -536,5 +537,4 @@ public Integer getObservationCount(List<Person> whom, List<Encounter> encounters
 			List<Concept> answers, List<PERSON_TYPE> personTypes, List<Location> locations, List<Visit> visits,
 			Integer obsGroupId, Date fromDate, Date toDate, boolean includeVoidedObs, String accessionNumber)
 			throws APIException;
-	
 }
diff --git a/api/src/main/java/org/openmrs/api/db/ConceptDAO.java b/api/src/main/java/org/openmrs/api/db/ConceptDAO.java
index ae365425d4bb..6609687b1d00 100644
--- a/api/src/main/java/org/openmrs/api/db/ConceptDAO.java
+++ b/api/src/main/java/org/openmrs/api/db/ConceptDAO.java
@@ -30,6 +30,7 @@
 import org.openmrs.ConceptNameTag;
 import org.openmrs.ConceptNumeric;
 import org.openmrs.ConceptProposal;
+import org.openmrs.ConceptReferenceRange;
 import org.openmrs.ConceptReferenceTerm;
 import org.openmrs.ConceptReferenceTermMap;
 import org.openmrs.ConceptSearchResult;
@@ -669,4 +670,19 @@ Drug getDrugByMapping(String code, ConceptSource conceptSource,
 	public long getConceptAttributeCount(ConceptAttributeType conceptAttributeType);
 
 	List<Concept> getConceptsByClass(ConceptClass conceptClass);
+
+	/**
+	 * @see ConceptService#saveConceptReferenceRange(ConceptReferenceRange)
+	 */
+	ConceptReferenceRange saveConceptReferenceRange(ConceptReferenceRange conceptReferenceRange);
+
+	/**
+	 * @see ConceptService#getConceptReferenceRangesByConceptId(Integer)
+	 */
+	List<ConceptReferenceRange> getConceptReferenceRangesByConceptId(Integer conceptId);
+
+	/**
+	 * @see ConceptService#getConceptReferenceRangeByUuid(String) 
+	 */
+	ConceptReferenceRange getConceptReferenceRangeByUuid(String uuid);
 }
diff --git a/api/src/main/java/org/openmrs/api/db/ObsDAO.java b/api/src/main/java/org/openmrs/api/db/ObsDAO.java
index 9ed65cf25c7d..31a8ee4b5fb8 100644
--- a/api/src/main/java/org/openmrs/api/db/ObsDAO.java
+++ b/api/src/main/java/org/openmrs/api/db/ObsDAO.java
@@ -17,6 +17,7 @@
 import org.openmrs.Encounter;
 import org.openmrs.Location;
 import org.openmrs.Obs;
+import org.openmrs.ObsReferenceRange;
 import org.openmrs.Person;
 import org.openmrs.Visit;
 import org.openmrs.api.ObsService;
@@ -109,5 +110,4 @@ public Long getObservationCount(List<Person> whom, List<Encounter> encounters, L
 			List<Concept> answers, List<PERSON_TYPE> personTypes, List<Location> locations, Integer obsGroupId,
 			Date fromDate, Date toDate, List<ConceptName> valueCodedNameAnswers, List<Visit> visits,
 			boolean includeVoidedObs, String accessionNumber) throws DAOException;
-	
 }
diff --git a/api/src/main/java/org/openmrs/api/db/hibernate/HibernateConceptDAO.java b/api/src/main/java/org/openmrs/api/db/hibernate/HibernateConceptDAO.java
index 9800387ed89b..756f252f9d03 100644
--- a/api/src/main/java/org/openmrs/api/db/hibernate/HibernateConceptDAO.java
+++ b/api/src/main/java/org/openmrs/api/db/hibernate/HibernateConceptDAO.java
@@ -30,7 +30,6 @@
 import java.util.Locale;
 import java.util.Map;
 import java.util.Set;
-import java.util.stream.Collectors;
 
 import org.apache.commons.collections.CollectionUtils;
 import org.apache.commons.lang3.StringUtils;
@@ -51,6 +50,7 @@
 import org.openmrs.ConceptNameTag;
 import org.openmrs.ConceptNumeric;
 import org.openmrs.ConceptProposal;
+import org.openmrs.ConceptReferenceRange;
 import org.openmrs.ConceptReferenceTerm;
 import org.openmrs.ConceptReferenceTermMap;
 import org.openmrs.ConceptSearchResult;
@@ -2358,4 +2358,43 @@ private List<Predicate> createSearchConceptMapCriteria(CriteriaBuilder cb, Root<
 		}
 		return predicates;
 	}
+
+	/**
+	 * @see org.openmrs.api.db.ConceptDAO#saveConceptReferenceRange(ConceptReferenceRange)
+	 */
+	@Override
+	public ConceptReferenceRange saveConceptReferenceRange(ConceptReferenceRange conceptReferenceRange) {
+		sessionFactory.getCurrentSession().saveOrUpdate(conceptReferenceRange);
+		return conceptReferenceRange;
+	}
+
+	/**
+	 * @see org.openmrs.api.db.ConceptDAO#getConceptReferenceRangesByConceptId(Integer)
+	 */
+	@Override
+	public List<ConceptReferenceRange> getConceptReferenceRangesByConceptId(Integer conceptId) {
+		Session session = sessionFactory.getCurrentSession();
+		CriteriaBuilder cb = session.getCriteriaBuilder();
+		CriteriaQuery<ConceptReferenceRange> cq = cb.createQuery(ConceptReferenceRange.class);
+		Root<ConceptReferenceRange> root = cq.from(ConceptReferenceRange.class);
+
+		cq.where(cb.equal(root.get("conceptNumeric"), conceptId));
+
+		return session.createQuery(cq).getResultList();
+	}
+
+	/**
+	 * @see ConceptDAO#getConceptReferenceRangeByUuid(String)
+	 */
+	@Override
+	public ConceptReferenceRange getConceptReferenceRangeByUuid(String uuid) {
+		Session session = sessionFactory.getCurrentSession();
+		CriteriaBuilder cb = session.getCriteriaBuilder();
+		CriteriaQuery<ConceptReferenceRange> cq = cb.createQuery(ConceptReferenceRange.class);
+		Root<ConceptReferenceRange> root = cq.from(ConceptReferenceRange.class);
+
+		cq.where(cb.equal(root.get("uuid"), uuid));
+
+		return session.createQuery(cq).uniqueResult();
+	}
 }
diff --git a/api/src/main/java/org/openmrs/api/db/hibernate/HibernateObsDAO.java b/api/src/main/java/org/openmrs/api/db/hibernate/HibernateObsDAO.java
index 5dd542490776..e0e86e07b08a 100644
--- a/api/src/main/java/org/openmrs/api/db/hibernate/HibernateObsDAO.java
+++ b/api/src/main/java/org/openmrs/api/db/hibernate/HibernateObsDAO.java
@@ -32,6 +32,7 @@
 import org.openmrs.Encounter;
 import org.openmrs.Location;
 import org.openmrs.Obs;
+import org.openmrs.ObsReferenceRange;
 import org.openmrs.Patient;
 import org.openmrs.Person;
 import org.openmrs.User;
@@ -351,5 +352,4 @@ public Obs.Status getSavedStatus(Obs obs) {
 			session.setHibernateFlushMode(flushMode);
 		}
 	}
-	
 }
diff --git a/api/src/main/java/org/openmrs/api/impl/ConceptServiceImpl.java b/api/src/main/java/org/openmrs/api/impl/ConceptServiceImpl.java
index acfb8ee2d34a..14b67e6706ed 100644
--- a/api/src/main/java/org/openmrs/api/impl/ConceptServiceImpl.java
+++ b/api/src/main/java/org/openmrs/api/impl/ConceptServiceImpl.java
@@ -43,6 +43,7 @@
 import org.openmrs.ConceptNameTag;
 import org.openmrs.ConceptNumeric;
 import org.openmrs.ConceptProposal;
+import org.openmrs.ConceptReferenceRange;
 import org.openmrs.ConceptReferenceTerm;
 import org.openmrs.ConceptReferenceTermMap;
 import org.openmrs.ConceptSearchResult;
@@ -2061,6 +2062,28 @@ public boolean hasAnyConceptAttribute(ConceptAttributeType conceptAttributeType)
 		return dao.getConceptAttributeCount(conceptAttributeType) > 0;
 	}
 
+	/**
+	 * @see ConceptService#saveConceptReferenceRange(ConceptReferenceRange)
+	 */
+	@Override
+	public ConceptReferenceRange saveConceptReferenceRange(ConceptReferenceRange conceptReferenceRange) {
+		return dao.saveConceptReferenceRange(conceptReferenceRange);
+	}
+
+	/**
+	 * @see ConceptService#getConceptReferenceRangesByConceptId(Integer)
+	 */
+	@Override
+	@Transactional(readOnly = true)
+	public List<ConceptReferenceRange> getConceptReferenceRangesByConceptId(Integer conceptId) {
+		return dao.getConceptReferenceRangesByConceptId(conceptId);
+	}
+
+	@Override
+	public ConceptReferenceRange getConceptReferenceRangeByUuid(String uuid) {
+		return dao.getConceptReferenceRangeByUuid(uuid);
+	}
+
 	/***
 	 * Determines if the passed string is in valid uuid format By OpenMRS standards, a uuid must be 36
 	 * characters in length and not contain whitespace, but we do not enforce that a uuid be in the
diff --git a/api/src/main/java/org/openmrs/api/impl/ObsServiceImpl.java b/api/src/main/java/org/openmrs/api/impl/ObsServiceImpl.java
index 57d6b28e64fa..3c0f471b6314 100644
--- a/api/src/main/java/org/openmrs/api/impl/ObsServiceImpl.java
+++ b/api/src/main/java/org/openmrs/api/impl/ObsServiceImpl.java
@@ -674,5 +674,4 @@ public Integer getObservationCount(List<ConceptName> conceptNames, boolean inclu
 	public void removeHandler(String key) {
 		handlers.remove(key);
 	}
-	
 }
diff --git a/api/src/main/java/org/openmrs/util/ConceptReferenceRangeUtility.java b/api/src/main/java/org/openmrs/util/ConceptReferenceRangeUtility.java
new file mode 100644
index 000000000000..5385f41ee594
--- /dev/null
+++ b/api/src/main/java/org/openmrs/util/ConceptReferenceRangeUtility.java
@@ -0,0 +1,142 @@
+/**
+ * This Source Code Form is subject to the terms of the Mozilla Public License,
+ * v. 2.0. If a copy of the MPL was not distributed with this file, You can
+ * obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
+ * the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
+ *
+ * Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
+ * graphic logo is a trademark of OpenMRS Inc.
+ */
+package org.openmrs.util;
+
+import org.apache.commons.lang.StringUtils;
+import org.apache.velocity.VelocityContext;
+import org.apache.velocity.app.VelocityEngine;
+import org.apache.velocity.exception.ParseErrorException;
+import org.joda.time.LocalTime;
+import org.openmrs.Concept;
+import org.openmrs.Obs;
+import org.openmrs.Person;
+import org.openmrs.api.APIException;
+import org.openmrs.api.context.Context;
+
+import java.io.StringWriter;
+import java.util.Collections;
+import java.util.List;
+import java.util.Locale;
+
+/**
+ * A utility class that evaluates the concept ranges 
+ * 
+ * @since 2.7.0
+ */
+public class ConceptReferenceRangeUtility {
+	
+	public ConceptReferenceRangeUtility() {
+	}
+	
+	/**
+	 * This method evaluates the given criteria against the provided {@link Obs}.
+	 *
+	 * @param criteria the criteria string to evaluate e.g. "$patient.getAge() > 1"
+	 * @param obs The observation (Obs) object containing the values to be used in the criteria evaluation.
+	 *                  
+	 * @return true if the criteria evaluates to true, false otherwise
+	 */
+	public boolean evaluateCriteria(String criteria, Obs obs) {
+		if (obs == null) {
+			throw new IllegalArgumentException("Failed to evaluate criteria with reason: Obs is null");
+		}
+		
+		if (obs.getPerson() == null) {
+			throw new IllegalArgumentException("Failed to evaluate criteria with reason: patient is null");
+		}
+		
+		if (StringUtils.isBlank(criteria)) {
+			throw new IllegalArgumentException("Failed to evaluate criteria with reason: criteria is empty");
+		}
+		
+		VelocityContext velocityContext = new VelocityContext();
+		velocityContext.put("fn", this);
+		velocityContext.put("obs", obs);
+		
+		velocityContext.put("patient", obs.getPerson());
+		
+		VelocityEngine velocityEngine = new VelocityEngine();
+		
+		StringWriter writer = new StringWriter();
+		String wrappedCriteria = "#set( $criteria = " + criteria + " )$criteria";
+		
+		try {
+			velocityEngine.evaluate(velocityContext, writer, ConceptReferenceRangeUtility.class.getName(), wrappedCriteria);
+			return Boolean.parseBoolean(writer.toString());
+		}
+		catch (ParseErrorException e) {
+			throw new APIException("An error occurred while evaluating criteria. Invalid criteria: " + criteria, e);
+		}
+		catch (Exception e) {
+			throw new APIException("An error occurred while evaluating criteria: ", e);
+		}
+	}
+	
+	/**
+	 * Gets the latest Obs by concept.
+	 *
+	 * @param conceptRef can be either concept uuid or conceptMap's code and sourceName 
+	 *                   e.g "bac25fd5-c143-4e43-bffe-4eb1e7efb6ce" or "CIEL:1434"
+	 * @param person person to get obs for
+	 *                   
+	 * @return Obs latest Obs
+	 */
+	public Obs getLatestObs(String conceptRef, Person person) {
+		Concept concept = Context.getConceptService().getConceptByReference(conceptRef);
+
+		if (concept != null) {
+			List<Obs> observations = Context.getObsService().getObservations(
+				Collections.singletonList(person), 
+				null, 
+				Collections.singletonList(concept), 
+				null, 
+				null, 
+				null,
+				Collections.singletonList("dateCreated"), 
+				1, 
+				null,
+				null, 
+				null, 
+				false
+			);
+
+			return observations.isEmpty() ? null : observations.get(0);
+		}
+
+		return null;
+	}
+	
+	/**
+	 * Gets the time of the day in hours.
+	 *
+	 * @return the hour of the day in 24hr format (e.g. 14 to mean 2pm)
+	 */
+	public int getCurrentHour() {
+		return LocalTime.now().getHourOfDay();
+	}
+	
+	/**
+	 * Retrieves the most relevant Obs for the given current Obs and conceptRef. If the current Obs contains a valid value 
+	 * (coded, numeric, date, text e.t.c) and the concept in Obs is the same as the supplied concept,
+	 * the method returns the current Obs. Otherwise, it fetches the latest Obs for the supplied concept and patient.
+	 *
+	 * @param currentObs the current Obs being evaluated
+	 * @return the most relevant Obs based on the current Obs, or the latest Obs if the current one has no valid value
+	 */
+	public Obs getCurrentObs(String conceptRef, Obs currentObs) {
+		Concept concept = Context.getConceptService().getConceptByReference(conceptRef);
+		
+		if (currentObs.getValueAsString(Locale.ENGLISH).isEmpty() && (concept != null && concept == currentObs.getConcept())) {
+			return currentObs;
+		} else {
+			return getLatestObs(conceptRef, currentObs.getPerson());
+		}
+	}
+}
diff --git a/api/src/main/java/org/openmrs/util/OpenmrsUtil.java b/api/src/main/java/org/openmrs/util/OpenmrsUtil.java
index 2da47c6830ff..7b202f714975 100644
--- a/api/src/main/java/org/openmrs/util/OpenmrsUtil.java
+++ b/api/src/main/java/org/openmrs/util/OpenmrsUtil.java
@@ -72,10 +72,12 @@
 import org.openmrs.Cohort;
 import org.openmrs.Concept;
 import org.openmrs.ConceptNumeric;
+import org.openmrs.ConceptReferenceRange;
 import org.openmrs.Drug;
 import org.openmrs.EncounterType;
 import org.openmrs.Form;
 import org.openmrs.Location;
+import org.openmrs.Obs;
 import org.openmrs.PersonAttributeType;
 import org.openmrs.Program;
 import org.openmrs.ProgramWorkflowState;
@@ -103,6 +105,7 @@
 import org.openmrs.propertyeditor.PersonAttributeTypeEditor;
 import org.openmrs.propertyeditor.ProgramEditor;
 import org.openmrs.propertyeditor.ProgramWorkflowStateEditor;
+import org.openmrs.validator.ObsValidator;
 import org.slf4j.LoggerFactory;
 import org.slf4j.MarkerFactory;
 import org.springframework.beans.propertyeditors.CustomDateEditor;
@@ -2147,5 +2150,30 @@ public static boolean isYesterday(Date date) {
 	public static Set<String> getDeclaredFields(Class<?> clazz) {
 		return Arrays.stream(clazz.getDeclaredFields()).map(Field::getName).collect(Collectors.toSet());
 	}
+
+	/**
+	 * This method checks if a given value is a valid numeric value for the person/patient in subject 
+	 * given the concept. It checks if a given value is within the valid reference range.
+	 *
+	 * @param value The value to check
+	 * @param concept The concept associated with the value
+	 * @param obs The observation to be verified
+	 * @return Error message containing expected range if there was a range mismatch, else returns empty string.
+	 * 
+	 * @since 2.7.0
+	 */
+	public static String isValidNumericValue(Float value, Concept concept, Obs obs) {
+		ConceptReferenceRange conceptReferenceRange = new ObsValidator().getReferenceRange(concept, obs);
+		if (conceptReferenceRange == null) {
+			return "";
+		}
+
+		if ((conceptReferenceRange.getHiAbsolute() != null && conceptReferenceRange.getHiAbsolute() < value) ||
+			(conceptReferenceRange.getLowAbsolute() != null && conceptReferenceRange.getLowAbsolute() > value)) {
+			return String.format("Expected value between %s and %s", conceptReferenceRange.getLowAbsolute(), conceptReferenceRange.getHiAbsolute());
+		} else {
+			return "";
+		}
+	}
 	
 }
diff --git a/api/src/main/java/org/openmrs/validator/ObsValidator.java b/api/src/main/java/org/openmrs/validator/ObsValidator.java
index fb3998c8568e..c0fdac1c96d1 100644
--- a/api/src/main/java/org/openmrs/validator/ObsValidator.java
+++ b/api/src/main/java/org/openmrs/validator/ObsValidator.java
@@ -10,15 +10,20 @@
 package org.openmrs.validator;
 
 import java.util.ArrayList;
+import java.util.Comparator;
 import java.util.List;
+import java.util.Objects;
 
 import org.openmrs.Concept;
 import org.openmrs.ConceptDatatype;
 import org.openmrs.ConceptNumeric;
+import org.openmrs.ConceptReferenceRange;
 import org.openmrs.Obs;
+import org.openmrs.ObsReferenceRange;
 import org.openmrs.annotation.Handler;
 import org.openmrs.api.APIException;
 import org.openmrs.api.context.Context;
+import org.openmrs.util.ConceptReferenceRangeUtility;
 import org.springframework.validation.Errors;
 import org.springframework.validation.Validator;
 
@@ -78,6 +83,7 @@ public void validate(Object obj, Errors errors) {
 			return;
 		}
 		List<Obs> ancestors = new ArrayList<>();
+		validateConceptReferenceRange(obs, errors);
 		validateHelper(obs, errors, ancestors, true);
 		ValidateUtil.validateFieldLengths(errors, obj.getClass(), "accessionNumber", "valueModifier", "valueComplex",
 		    "comment", "voidReason");
@@ -252,5 +258,215 @@ else if (!isObsGroup) {
 			}
 		}
 	}
+
+	/**
+	 * This method validates Obs' numeric values:
+	 * <ol>
+	 *     <li>Validates Obs in relation to criteria e.g. checks patient's age is within the valid range</li>
+	 *     <li>Validates if Obs' numeric value is within the valid range; i.e. >= low absolute && <= high absolute.</li>
+	 *     <li>Sets field errors if numeric value is outside the valid range</li>
+	 * <ol/>
+	 *
+	 * @param obs Observation to validate
+	 * @param errors Errors to record validation issues
+	 */
+	private void validateConceptReferenceRange(Obs obs, Errors errors) {
+		ConceptReferenceRange conceptReferenceRange = getReferenceRange(obs.getConcept(), obs);
+
+		if (conceptReferenceRange != null) {
+			validateAbsoluteRanges(obs, conceptReferenceRange, errors);
+			
+			if (obs.getId() == null) {
+				setObsReferenceRange(obs, conceptReferenceRange);
+			}
+		} else if (obs.getId() == null) {
+			setObsReferenceRange(obs);
+		}
+		setObsInterpretation(obs);
+	}
+
+	/**
+	 * Evaluates the criteria and return the most strict {@link ConceptReferenceRange} for a given concept.
+	 * It considers all valid ranges that match the criteria for the person.
+	 *
+	 * @param concept The concept to evaluate
+	 * @param obs containing The patient for whom the range is being evaluated
+	 * @return The strictest {@link ConceptReferenceRange}, or null if no valid range is found
+	 * 
+	 * @since 2.7.0
+	 */
+	public ConceptReferenceRange getReferenceRange(Concept concept, Obs obs) {
+		if (concept == null || concept.getDatatype() == null || !concept.getDatatype().isNumeric()) {
+			return null;
+		}
+
+		List<ConceptReferenceRange> referenceRanges = Context.getConceptService()
+			.getConceptReferenceRangesByConceptId(concept.getConceptId());
+
+		if (referenceRanges.isEmpty()) {
+			return null;
+		}
+
+		ConceptReferenceRangeUtility referenceRangeUtility = new ConceptReferenceRangeUtility();
+		List<ConceptReferenceRange> validRanges = new ArrayList<>();
+
+		for (ConceptReferenceRange referenceRange : referenceRanges) {
+			if (referenceRangeUtility.evaluateCriteria(referenceRange.getCriteria(), obs)) {
+				validRanges.add(referenceRange);
+			}
+		}
+
+		if (validRanges.isEmpty()) {
+			return null;
+		}
+		return findStrictestReferenceRange(validRanges);
+	}
+	
+	/**
+	 * Finds the strictest {@link ConceptReferenceRange} from a list of valid ranges.
+	 * The strictest range is determined by having the highest lower bound and the lowest upper bound.
+	 * e.g.
+	 * If ConceptReferenceRange-1 has a range of 80-150.
+	 * and ConceptReferenceRange-2 has a range of 60-140,
+	 * the "strictest" range will be 80-140. 
+	 *
+	 * @param conceptReferenceRanges A list of valid {@link ConceptReferenceRange} objects
+	 * @return The strictest {@link ConceptReferenceRange} constructed from the strictest bounds
+	 */
+	private ConceptReferenceRange findStrictestReferenceRange(List<ConceptReferenceRange> conceptReferenceRanges) {
+		ConceptReferenceRange strictestLowRange = conceptReferenceRanges.stream()
+			.filter(range -> range.getLowAbsolute() != null)
+			.max(Comparator.comparing(ConceptReferenceRange::getLowAbsolute))
+			.orElse(null);
+
+		ConceptReferenceRange strictestHiRange = conceptReferenceRanges.stream()
+			.filter(range -> range.getHiAbsolute() != null)
+			.min(Comparator.comparing(ConceptReferenceRange::getHiAbsolute))
+			.orElse(null);
+
+		ConceptReferenceRange strictestRange = new ConceptReferenceRange();
+
+		if (strictestLowRange != null) {
+			strictestRange.setLowAbsolute(strictestLowRange.getLowAbsolute());
+			strictestRange.setLowNormal(strictestLowRange.getLowNormal());
+			strictestRange.setLowCritical(strictestLowRange.getLowCritical());
+		}
+
+		if (strictestHiRange != null) {
+			strictestRange.setHiAbsolute(strictestHiRange.getHiAbsolute());
+			strictestRange.setHiNormal(strictestHiRange.getHiNormal());
+			strictestRange.setHiCritical(strictestHiRange.getHiCritical());
+		}
+
+		return strictestRange;
+	}
+
+	/**
+	 * Validates the high and low absolute values of the Obs.
+	 *
+	 * @param obs Observation to validate
+	 * @param conceptReferenceRange ConceptReferenceRange containing the range values
+	 * @param errors Errors to record validation issues
+	 */
+	private void validateAbsoluteRanges(Obs obs, ConceptReferenceRange conceptReferenceRange, Errors errors) {
+		if (conceptReferenceRange.getHiAbsolute() != null && conceptReferenceRange.getHiAbsolute() < obs.getValueNumeric()) {
+			errors.rejectValue(
+				"valueNumeric", 
+				"error.value.outOfRange.high", 
+				new Object[] { conceptReferenceRange.getLowAbsolute() },
+				null
+			);
+		}
+		if (conceptReferenceRange.getLowAbsolute() != null && conceptReferenceRange.getLowAbsolute() > obs.getValueNumeric()) {
+			errors.rejectValue(
+				"valueNumeric", 
+				"error.value.outOfRange.low", 
+				new Object[] { conceptReferenceRange.getLowAbsolute() },
+				null
+			);
+		}
+	}
+
+	/**
+	 * Builds and sets the ObsReferenceRange for the given Obs.
+	 *
+	 * @param obs Observation to set the reference range
+	 * @param conceptReferenceRange ConceptReferenceRange used to build the ObsReferenceRange
+	 */
+	private void setObsReferenceRange(Obs obs, ConceptReferenceRange conceptReferenceRange) {
+		ObsReferenceRange obsRefRange = new ObsReferenceRange();
+
+		obsRefRange.setHiAbsolute(conceptReferenceRange.getHiAbsolute());
+		obsRefRange.setHiCritical(conceptReferenceRange.getHiCritical());
+		obsRefRange.setHiNormal(conceptReferenceRange.getHiNormal());
+		obsRefRange.setLowAbsolute(conceptReferenceRange.getLowAbsolute());
+		obsRefRange.setLowCritical(conceptReferenceRange.getLowCritical());
+		obsRefRange.setLowNormal(conceptReferenceRange.getLowNormal());
+		obsRefRange.setObs(obs);
+
+		obs.setReferenceRange(obsRefRange);
+	}
+
+	/**
+	 * Builds and sets the ObsReferenceRange from concept numeric values.
+	 *
+	 * @param obs Observation to set the reference range
+	 */
+	private void setObsReferenceRange(Obs obs) {
+		if (obs.getConcept() == null) {
+			return;
+		}
+		
+		ConceptNumeric conceptNumeric = Context.getConceptService().getConceptNumeric(obs.getConcept().getId());
+
+		if (conceptNumeric != null) {
+			ObsReferenceRange obsRefRange = new ObsReferenceRange();
+
+			obsRefRange.setHiAbsolute(conceptNumeric.getHiAbsolute());
+			obsRefRange.setHiCritical(conceptNumeric.getHiCritical());
+			obsRefRange.setHiNormal(conceptNumeric.getHiNormal());
+			obsRefRange.setLowAbsolute(conceptNumeric.getLowAbsolute());
+			obsRefRange.setLowCritical(conceptNumeric.getLowCritical());
+			obsRefRange.setLowNormal(conceptNumeric.getLowNormal());
+			obsRefRange.setObs(obs);
+			
+			obs.setReferenceRange(obsRefRange);
+		}
+	}
+
+	/**
+	 * This method sets Obs interpretation based on the current obs' numeric value.
+	 *
+	 * @param obs Observation to set the interpretation
+	 */
+	private void setObsInterpretation(Obs obs) {
+		ObsReferenceRange referenceRange = obs.getReferenceRange();
+		if (referenceRange == null || obs.getValueNumeric() == null) {
+			return;
+		}
+		
+		if (referenceRange.getHiNormal() != null 
+			&& referenceRange.getHiCritical() != null
+			&& obs.getValueNumeric() > referenceRange.getHiNormal()
+			&& obs.getValueNumeric() < referenceRange.getHiCritical()) {
+			obs.setInterpretation(Obs.Interpretation.HIGH);
+		} else if (referenceRange.getHiCritical() != null 
+			&& obs.getValueNumeric() >= referenceRange.getHiCritical()) {
+			obs.setInterpretation(Obs.Interpretation.CRITICALLY_HIGH);
+		} else if (referenceRange.getLowNormal() != null 
+			&& referenceRange.getLowCritical() != null
+			&& obs.getValueNumeric() < referenceRange.getLowNormal() 
+			&& obs.getValueNumeric() > referenceRange.getLowCritical()) {
+			obs.setInterpretation(Obs.Interpretation.LOW);
+		} else if (referenceRange.getLowNormal() != null 
+			&& referenceRange.getHiNormal() != null
+			&& obs.getValueNumeric() >= referenceRange.getLowNormal() 
+			&& obs.getValueNumeric() <= referenceRange.getHiNormal()) {
+			obs.setInterpretation(Obs.Interpretation.NORMAL);
+		} else if (referenceRange.getLowCritical() != null 
+			&& obs.getValueNumeric() <= referenceRange.getLowCritical()) {
+			obs.setInterpretation(Obs.Interpretation.CRITICALLY_LOW);
+		}
+	}
 	
 }
diff --git a/api/src/main/resources/hibernate.cfg.xml b/api/src/main/resources/hibernate.cfg.xml
index f8695300e5c1..85402c4b68d6 100644
--- a/api/src/main/resources/hibernate.cfg.xml
+++ b/api/src/main/resources/hibernate.cfg.xml
@@ -111,7 +111,10 @@
 		<mapping resource="org/openmrs/api/db/hibernate/ProviderAttribute.hbm.xml" />
 		
 		<mapping resource="org/openmrs/api/db/hibernate/ClobDatatypeStorage.hbm.xml" />
-		
+
+		<!-- These mappings are required because of rerefences in Obs & Concept -->
+		<mapping class="org.openmrs.ObsReferenceRange"/>
+		<mapping class="org.openmrs.ConceptReferenceRange"/>
   </session-factory>
 
 </hibernate-configuration>
diff --git a/api/src/main/resources/messages.properties b/api/src/main/resources/messages.properties
index ed04c69e602a..9ff76737c989 100644
--- a/api/src/main/resources/messages.properties
+++ b/api/src/main/resources/messages.properties
@@ -65,6 +65,8 @@ error.dwr=A javascript error has occurred:
 error.dwr.hide=Hide error
 error.outOfRange.low.obs.valueNumeric=This value is too low to be valid for this question
 error.outOfRange.high.obs.valueNumeric=This value is too high to be valid for this question
+error.value.outOfRange.low.obs.valueNumeric=The entered value is lower than the minimum expected value {0}
+error.value.outOfRange.high.obs.valueNumeric=The entered value is higher than the maximum expected value {0}
 error.exceededMaxLengthOfField=This value exceeds the maximum length of {0} permitted for this field.
 error.failed.validation=Validation errors found
 errors.patientId.cannotBeNull=Patient Id cannot be null
diff --git a/api/src/main/resources/org/openmrs/api/db/hibernate/Concept.hbm.xml b/api/src/main/resources/org/openmrs/api/db/hibernate/Concept.hbm.xml
index a47929be93ad..de92ea7a6f11 100644
--- a/api/src/main/resources/org/openmrs/api/db/hibernate/Concept.hbm.xml
+++ b/api/src/main/resources/org/openmrs/api/db/hibernate/Concept.hbm.xml
@@ -126,6 +126,10 @@
 			<property name="units" type="java.lang.String" column="units" length="50" />
 			<property name="allowDecimal" type="java.lang.Boolean" column="allow_decimal" length="1" not-null="true"/>
 			<property name="displayPrecision" type="java.lang.Integer" column="display_precision" not-null="false"/>
+			<set name="referenceRanges" inverse="true" cascade="all,delete-orphan" order-by="concept_reference_range_id asc">
+				<key column="concept_id" not-null="true" />
+				<one-to-many class="ConceptReferenceRange" />
+			</set>
 		</joined-subclass>
 	
 	   <joined-subclass name="org.openmrs.ConceptComplex" table="concept_complex" extends="org.openmrs.Concept" lazy="false">
diff --git a/api/src/main/resources/org/openmrs/api/db/hibernate/Obs.hbm.xml b/api/src/main/resources/org/openmrs/api/db/hibernate/Obs.hbm.xml
index caafce676d92..daf73b8ebc80 100644
--- a/api/src/main/resources/org/openmrs/api/db/hibernate/Obs.hbm.xml
+++ b/api/src/main/resources/org/openmrs/api/db/hibernate/Obs.hbm.xml
@@ -99,6 +99,8 @@
 			<one-to-many class="Obs" />
 		</set> 
 		<many-to-one name="previousVersion" class="Obs" column="previous_version" unique="true" />
+
+		<one-to-one name="referenceRange" class="org.openmrs.ObsReferenceRange" cascade="all"  />
 	</class>
 	
 </hibernate-mapping>
diff --git a/api/src/main/resources/org/openmrs/liquibase/updates/liquibase-update-to-latest-2.7.x.xml b/api/src/main/resources/org/openmrs/liquibase/updates/liquibase-update-to-latest-2.7.x.xml
index e505ca0f778a..5911cc7ef823 100644
--- a/api/src/main/resources/org/openmrs/liquibase/updates/liquibase-update-to-latest-2.7.x.xml
+++ b/api/src/main/resources/org/openmrs/liquibase/updates/liquibase-update-to-latest-2.7.x.xml
@@ -100,4 +100,74 @@
         </sql>
     </changeSet>
 	
+	<changeSet author="Isaiah (generated)" id="202408151920-1">
+		<preConditions onError="HALT" onFail="MARK_RAN">
+			<not>
+				<tableExists tableName="concept_reference_range"/>
+			</not>
+		</preConditions>
+		<comment>Creating 'concept_reference_range' table</comment>
+		<createTable tableName="concept_reference_range" >
+			<column name="concept_reference_range_id" type="int" autoIncrement="true">
+				<constraints primaryKey="true" nullable="false"/>
+			</column>
+			<column name="concept_id" type="INT">
+				<constraints nullable="false"/>
+			</column>
+			<column name="criteria" type="VARCHAR(255)">
+				<constraints nullable="false"/>
+			</column>
+			<column name="hi_absolute" type="DOUBLE"/>
+			<column name="hi_critical" type="DOUBLE"/>
+			<column name="hi_normal" type="DOUBLE"/>
+			<column name="low_absolute" type="DOUBLE"/>
+			<column name="low_critical" type="DOUBLE"/>
+			<column name="low_normal" type="DOUBLE"/>
+			<column name="uuid" type="char(38)">
+				<constraints nullable="false" unique="true" />
+			</column>
+		</createTable>
+
+		<addForeignKeyConstraint
+			baseTableName="concept_reference_range"
+			baseColumnNames="concept_id"
+			constraintName="fk_concept_numeric_reference_range"
+			referencedTableName="concept_numeric"
+			referencedColumnNames="concept_id"/>
+
+	</changeSet>
+
+	<changeSet author="Isaiah (generated)" id="202408152220-1">
+		<preConditions onError="HALT" onFail="MARK_RAN">
+			<not>
+				<tableExists tableName="obs_reference_range"/>
+			</not>
+		</preConditions>
+		<comment>Creating 'obs_reference_range' table</comment>
+		<createTable tableName="obs_reference_range" >
+			<column name="obs_reference_range_id" type="int" autoIncrement="true">
+				<constraints primaryKey="true" nullable="false"/>
+			</column>
+			<column name="obs_id" type="INT">
+				<constraints nullable="false" unique="true"/>
+			</column>
+			<column name="hi_absolute" type="DOUBLE"/>
+			<column name="hi_critical" type="DOUBLE"/>
+			<column name="hi_normal" type="DOUBLE"/>
+			<column name="low_absolute" type="DOUBLE"/>
+			<column name="low_critical" type="DOUBLE"/>
+			<column name="low_normal" type="DOUBLE"/>
+			<column name="uuid" type="char(38)">
+				<constraints unique="true" />
+			</column>
+		</createTable>
+
+		<addForeignKeyConstraint
+			baseTableName="obs_reference_range"
+			baseColumnNames="obs_id"
+			constraintName="fk_obs_reference_range"
+			referencedTableName="obs"
+			referencedColumnNames="obs_id"/>
+	</changeSet>
+	
 </databaseChangeLog>
diff --git a/api/src/test/java/org/openmrs/ConceptNumericTest.java b/api/src/test/java/org/openmrs/ConceptNumericTest.java
index 8d45eefc0df3..9a2f053f9983 100644
--- a/api/src/test/java/org/openmrs/ConceptNumericTest.java
+++ b/api/src/test/java/org/openmrs/ConceptNumericTest.java
@@ -9,6 +9,7 @@
  */
 package org.openmrs;
 
+import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertFalse;
 import static org.junit.jupiter.api.Assertions.assertNotSame;
 import static org.junit.jupiter.api.Assertions.assertSame;
@@ -126,4 +127,25 @@ public void shouldSaveAConceptNumericWithAllowDecimalValue() {
 		Context.getConceptService().saveConcept(cn);
 		assertTrue(Context.getConceptService().getConceptNumeric(22).getAllowDecimal());
 	}
+
+	@Test
+	public void shouldRemoveReferenceRangeFromConceptNumeric() {
+		Concept c = Context.getConceptService().getConcept(22);
+		ConceptNumeric cn = new ConceptNumeric(c);
+		ConceptReferenceRange referenceRange1 = new ConceptReferenceRange();
+		referenceRange1.setId(1);
+		referenceRange1.setConceptNumeric(cn);
+		ConceptReferenceRange referenceRange2 = new ConceptReferenceRange();
+		referenceRange2.setId(2);
+		referenceRange2.setConceptNumeric(cn);
+		cn.addReferenceRange(referenceRange1);
+		cn.addReferenceRange(referenceRange2);
+
+		Context.getConceptService().saveConcept(cn);
+		assertEquals(2, Context.getConceptService().getConceptNumeric(22).getReferenceRanges().size());
+
+		cn.removeReferenceRange(referenceRange1);
+		Context.getConceptService().saveConcept(cn);
+		assertEquals(1, Context.getConceptService().getConceptNumeric(22).getReferenceRanges().size());
+	}
 }
diff --git a/api/src/test/java/org/openmrs/ObsTest.java b/api/src/test/java/org/openmrs/ObsTest.java
index d5da177c17a8..a589aa393818 100644
--- a/api/src/test/java/org/openmrs/ObsTest.java
+++ b/api/src/test/java/org/openmrs/ObsTest.java
@@ -56,7 +56,7 @@ public class ObsTest {
 	private static final List<String> IGNORED_FIELDS = Arrays.asList("dirty", "log", "serialVersionUID",
 	    "DATE_TIME_PATTERN", "TIME_PATTERN", "DATE_PATTERN", "FORM_NAMESPACE_PATH_SEPARATOR",
 	    "FORM_NAMESPACE_PATH_MAX_LENGTH", "obsId", "groupMembers", "uuid", "changedBy", "dateChanged", "voided", "voidedBy",
-	    "voidReason", "dateVoided", "formNamespaceAndPath", "$jacocoData");
+	    "voidReason", "dateVoided", "formNamespaceAndPath", "$jacocoData", "referenceRange");
 	
 	private void resetObs(Obs obs) throws Exception {
 		Field field = Obs.class.getDeclaredField("dirty");
diff --git a/api/src/test/java/org/openmrs/PersonTest.java b/api/src/test/java/org/openmrs/PersonTest.java
index 589e0098b50a..b1387901528b 100644
--- a/api/src/test/java/org/openmrs/PersonTest.java
+++ b/api/src/test/java/org/openmrs/PersonTest.java
@@ -20,6 +20,9 @@
 import java.text.DateFormat;
 import java.text.ParseException;
 import java.text.SimpleDateFormat;
+import java.time.LocalDate;
+import java.time.Month;
+import java.time.ZoneOffset;
 import java.util.Arrays;
 import java.util.Calendar;
 import java.util.Collections;
@@ -808,6 +811,64 @@ public void shouldSetDeadToTrueIfSetDeathdate() {
 		p.setDeathDate(deathDate);
 		assertTrue(p.getDead(), "Person must be dead(setDead(true)) inorder have a deathDate set for him");
 	}
+
+	@Test
+	public void getAgeInMonths_shouldReturnCorrectAgeInMonths() {
+		Calendar calendar = Calendar.getInstance();
+		calendar.add(Calendar.MONTH, -12);
+		Person person = new Person();
+		person.setBirthdate(calendar.getTime());
+		assertEquals(12, person.getAgeInMonths());
+	}
+
+	@Test
+	public void getAgeInWeeks_shouldReturnCorrectAgeInWeeks() {
+		Calendar calendar = Calendar.getInstance();
+		calendar.add(Calendar.WEEK_OF_MONTH, -4);
+		Person person = new Person();
+		person.setBirthdate(calendar.getTime());
+		assertEquals(4, person.getAgeInWeeks()); 
+	}
+
+	@Test
+	public void getAgeInDays_shouldReturnCorrectAgeInDays() {
+		Calendar calendar = Calendar.getInstance();
+		calendar.add(Calendar.DAY_OF_MONTH, -11);
+		Person person = new Person();
+		person.setBirthdate(calendar.getTime());
+		assertEquals(11, person.getAgeInDays());
+	}
+
+	@Test
+	public void getAgeInMonths_shouldReturnNullIfBirthdateIsNull() {
+		Person person = new Person();
+		person.setBirthdate(null);
+		assertNull(person.getAgeInMonths());
+	}
+
+	@Test
+	public void getAgeInMonths_shouldReturnCorrectAgeIfDeathDateIsBeforeCurrentDate() {
+		Person person = new Person();
+		person.setBirthdate(Date.from(LocalDate.of(2022, Month.AUGUST, 12).atStartOfDay().toInstant(ZoneOffset.UTC)));
+		person.setDeathDate(Date.from(LocalDate.of(2023, Month.AUGUST, 12).atStartOfDay().toInstant(ZoneOffset.UTC)));
+		assertEquals(12, person.getAgeInMonths());
+	}
+
+	@Test
+	public void getAgeInWeeks_shouldReturnCorrectAgeIfDeathDateIsBeforeCurrentDate() {
+		Person person = new Person();
+		person.setBirthdate(Date.from(LocalDate.of(2024, Month.JUNE, 1).atStartOfDay().toInstant(ZoneOffset.UTC)));
+		person.setDeathDate(Date.from(LocalDate.of(2024, Month.JULY, 1).atStartOfDay().toInstant(ZoneOffset.UTC)));
+		assertEquals(4, person.getAgeInWeeks());
+	}
+
+	@Test
+	public void getAgeInDays_shouldReturnCorrectAgeIfDeathDateIsBeforeCurrentDate() {
+		Person person = new Person();
+		person.setBirthdate(Date.from(LocalDate.of(2024, Month.AUGUST, 1).atStartOfDay().toInstant(ZoneOffset.UTC)));
+		person.setDeathDate(Date.from(LocalDate.of(2024, Month.AUGUST, 5).atStartOfDay().toInstant(ZoneOffset.UTC)));
+		assertEquals(4, person.getAgeInDays());
+	}
 	
 	// helper class
 	private static class PersonNameBuilder {
diff --git a/api/src/test/java/org/openmrs/api/ConceptServiceTest.java b/api/src/test/java/org/openmrs/api/ConceptServiceTest.java
index 7f524b2fc79a..5aac3b26a90f 100644
--- a/api/src/test/java/org/openmrs/api/ConceptServiceTest.java
+++ b/api/src/test/java/org/openmrs/api/ConceptServiceTest.java
@@ -64,6 +64,7 @@
 import org.openmrs.ConceptNameTag;
 import org.openmrs.ConceptNumeric;
 import org.openmrs.ConceptProposal;
+import org.openmrs.ConceptReferenceRange;
 import org.openmrs.ConceptReferenceTerm;
 import org.openmrs.ConceptSearchResult;
 import org.openmrs.ConceptSet;
@@ -110,6 +111,8 @@ public class ConceptServiceTest extends BaseContextSensitiveTest {
 	protected static final String GET_DRUG_MAPPINGS = "org/openmrs/api/include/ConceptServiceTest-getDrugMappings.xml";
 
 	protected static final String CONCEPT_ATTRIBUTE_TYPE_XML = "org/openmrs/api/include/ConceptServiceTest-conceptAttributeType.xml";
+	
+	protected static final String CONCEPT_WITH_CONCEPT_REFERENCE_RANGES_XML = "org/openmrs/api/include/ConceptServiceTest-conceptReferenceRange.xml";
 
 	@Autowired
 	CacheManager cacheManager;
@@ -2527,7 +2530,7 @@ public void getAllConceptReferenceTerms_shouldReturnAllConceptReferenceTermsInTh
 	 */
 	@Test
 	public void getConceptMappingsToSource_shouldReturnAListOfConceptMapsFromTheGivenSource() {
-		assertEquals(8, Context.getConceptService().getConceptMappingsToSource(
+		assertEquals(11, Context.getConceptService().getConceptMappingsToSource(
 		    Context.getConceptService().getConceptSource(1)).size());
 	}
 	
@@ -3146,7 +3149,7 @@ public void mapConceptProposalToConcept_shouldSetValueCodedNameWhenAddSynonymIsS
 	public void getAllConcepts_shouldExcludeRetiredConceptsWhenSetIncludeRetiredToFalse() {
 		final List<Concept> allConcepts = conceptService.getAllConcepts(null, true, false);
 		
-		assertEquals(36, allConcepts.size());
+		assertEquals(39, allConcepts.size());
 		assertEquals(3, allConcepts.get(0).getConceptId().intValue());
 	}
 	
@@ -3157,14 +3160,14 @@ public void getAllConcepts_shouldExcludeRetiredConceptsWhenSetIncludeRetiredToFa
 	public void getAllConcepts_shouldOrderByAConceptField() {
 		List<Concept> allConcepts = conceptService.getAllConcepts("dateCreated", true, true);
 		
-		assertEquals(38, allConcepts.size());
+		assertEquals(41, allConcepts.size());
 		assertEquals(88, allConcepts.get(0).getConceptId().intValue());
 		assertEquals(27, allConcepts.get(allConcepts.size() - 1).getConceptId().intValue());
 		
 		//check desc order
 		allConcepts = conceptService.getAllConcepts("dateCreated", false, true);
 		
-		assertEquals(38, allConcepts.size());
+		assertEquals(41, allConcepts.size());
 		assertEquals(27, allConcepts.get(0).getConceptId().intValue());
 		assertEquals(88, allConcepts.get(allConcepts.size() - 1).getConceptId().intValue());
 	}
@@ -3195,7 +3198,7 @@ public void getAllConcepts_shouldOrderByAConceptNameField() {
 	public void getAllConcepts_shouldOrderByConceptIdAndIncludeRetiredWhenGivenNoParameters() {
 		final List<Concept> allConcepts = conceptService.getAllConcepts();
 		
-		assertEquals(38, allConcepts.size());
+		assertEquals(41, allConcepts.size());
 		assertEquals(3, allConcepts.get(0).getConceptId().intValue());
 	}
 	
@@ -3206,7 +3209,7 @@ public void getAllConcepts_shouldOrderByConceptIdAndIncludeRetiredWhenGivenNoPar
 	public void getAllConcepts_shouldOrderByConceptIdDescendingWhenSetAscParameterToFalse() {
 		final List<Concept> allConcepts = conceptService.getAllConcepts(null, false, true);
 		
-		assertEquals(38, allConcepts.size());
+		assertEquals(41, allConcepts.size());
 		assertEquals(5497, allConcepts.get(0).getConceptId().intValue());
 	}
 	
@@ -3957,4 +3960,60 @@ public void getConceptByReference_shouldReturnNullWhenEitherConceptRefIsInvalidO
 		assertNull(conceptService.getConceptByReference("id, name or map which does not match to any concept"));
 		assertNull(conceptService.getConceptByReference("1000")); //invalid uuid but exists in standardTestDataset
 	}
+
+	/**
+	 * @see ConceptService#getConceptReferenceRangesByConceptId(Integer) 
+	 */
+	@Test
+	public void getConceptReferenceRangeByConceptId_shouldReturnConceptReferencesRanges() {
+		executeDataSet(CONCEPT_WITH_CONCEPT_REFERENCE_RANGES_XML);
+
+		List<ConceptReferenceRange> conceptReferenceRanges = conceptService.getConceptReferenceRangesByConceptId(5089);
+		
+		assertFalse(conceptReferenceRanges.isEmpty());
+		
+		assertEquals(3, conceptReferenceRanges.get(0).getId());
+	}
+
+	/**
+	 * @see ConceptService#saveConcept(Concept)
+	 */
+	@Test
+	public void saveConcept_shouldSaveANewConceptReferenceRange() {
+		Context.setLocale(Locale.US);
+		ConceptNumeric conceptNumeric = new ConceptNumeric();
+		conceptNumeric.setDatatype(new ConceptDatatype(1));
+		conceptNumeric.setConceptClass(new ConceptClass(1));
+		
+		ConceptName conceptName = new ConceptName("a new conceptnumeric", Locale.US);
+		conceptNumeric.addName(conceptName);
+		conceptNumeric.addDescription(new ConceptDescription("some description",null));
+		conceptNumeric.setHiAbsolute(50.0);
+		conceptNumeric.setLowAbsolute(20.0);
+
+		ConceptReferenceRange conceptReferenceRange = new ConceptReferenceRange();
+		conceptReferenceRange.setCriteria("$patient.getAge() >= 1 && $patient.getAge() <= 70");
+		conceptReferenceRange.setConceptNumeric(conceptNumeric);
+		conceptReferenceRange.setHiAbsolute(conceptNumeric.getHiAbsolute());
+		conceptReferenceRange.setLowAbsolute(conceptNumeric.getLowAbsolute());
+		
+		conceptNumeric.setReferenceRanges(Collections.singleton(conceptReferenceRange));
+		conceptService.saveConcept(conceptNumeric);
+
+		ConceptNumeric savedConceptNumeric = conceptService.getConceptNumeric(conceptNumeric.getConceptId());
+		
+		assertEquals("a new conceptnumeric", savedConceptNumeric.getName(Locale.US).getName());
+		assertEquals(50.0, savedConceptNumeric.getHiAbsolute(), 0);
+		assertEquals(1, savedConceptNumeric.getReferenceRanges().size());
+		assertEquals(50.0, savedConceptNumeric.getReferenceRanges().stream().findFirst().get().getHiAbsolute());
+	}
+
+	@Test
+	public void getConceptReferenceRangeByUuid_shouldReturnAConceptReferenceRange() {
+		ConceptReferenceRange conceptReferenceRange = conceptService.getConceptReferenceRangeByUuid("2c5972e8-aee5-468c-8216-369a1b60723d");
+
+		assertNotNull(conceptReferenceRange);
+
+		assertEquals(34, conceptReferenceRange.getId());
+	}
 }
diff --git a/api/src/test/java/org/openmrs/api/ObsServiceTest.java b/api/src/test/java/org/openmrs/api/ObsServiceTest.java
index cf4b09ff6e8b..10ca8425c9c4 100644
--- a/api/src/test/java/org/openmrs/api/ObsServiceTest.java
+++ b/api/src/test/java/org/openmrs/api/ObsServiceTest.java
@@ -31,6 +31,7 @@
 import java.text.SimpleDateFormat;
 import java.util.ArrayList;
 import java.util.Arrays;
+import java.util.Calendar;
 import java.util.Collections;
 import java.util.Date;
 import java.util.HashMap;
@@ -45,9 +46,11 @@
 import org.openmrs.Concept;
 import org.openmrs.ConceptName;
 import org.openmrs.ConceptProposal;
+import org.openmrs.ConceptReferenceRange;
 import org.openmrs.Encounter;
 import org.openmrs.Location;
 import org.openmrs.Obs;
+import org.openmrs.ObsReferenceRange;
 import org.openmrs.Order;
 import org.openmrs.Patient;
 import org.openmrs.Person;
@@ -1101,7 +1104,7 @@ public void getObservations_shouldReturnAllObsWhosePersonIsAPersonOnly() {
 		List<Obs> obss = obsService.getObservations(null, null, null, null, Collections.singletonList(PERSON_TYPE.PERSON),
 		    null, null, null, null, null, null, false, null);
 		
-		assertEquals(17, obss.size());
+		assertEquals(18, obss.size());
 	}
 	
 	/**
@@ -1117,7 +1120,7 @@ public void getObservationCount_shouldReturnCountOfAllObsWhosePersonIsAPersonOnl
 		Integer count = obsService.getObservationCount(null, null, null, null,
 		    Collections.singletonList(PERSON_TYPE.PERSON), null, null, null, null, false, null);
 		
-		assertEquals(17, count.intValue());
+		assertEquals(18, count.intValue());
 	}
 	
 	/**
@@ -1133,7 +1136,7 @@ public void getObservations_shouldReturnObsWhosePersonIsAUserOnly() {
 		List<Obs> obss = obsService.getObservations(null, null, null, null, Collections.singletonList(PERSON_TYPE.USER),
 		    null, null, null, null, null, null, false, null);
 		
-		assertEquals(1, obss.size());
+		assertEquals(2, obss.size());
 	}
 	
 	/**
@@ -1149,7 +1152,7 @@ public void getObservationCount_shouldReturnCountOfObsWhosePersonIsAUserOnly() {
 		Integer count = obsService.getObservationCount(null, null, null, null, Collections.singletonList(PERSON_TYPE.USER),
 		    null, null, null, null, false, null);
 		
-		assertEquals(1, count.intValue());
+		assertEquals(2, count.intValue());
 	}
 	
 	/**
@@ -1278,7 +1281,7 @@ public void getObservations_shouldGetObsMatchingEncounterIdInSearchString() {
 		
 		List<Obs> obss = obsService.getObservations("5");
 		
-		assertEquals(1, obss.size());
+		assertEquals(2, obss.size());
 		assertEquals(16, obss.get(0).getObsId().intValue());
 	}
 	
@@ -1998,4 +2001,47 @@ public void shouldNotAutomaticallySetStatusWhenManuallyCopyingAnObs() throws Exc
 		assertThat(existing.getVoided(), is(true));
 		assertThat(newObs.getStatus(), is(Obs.Status.FINAL));
 	}
+
+	@Test
+	public void saveObsReferenceRange_shouldSaveReferenceRangeAfterSavingObs() {
+		Obs obs = buildObservation();
+
+		obsService.saveObs(obs, null);
+		
+		List<ConceptReferenceRange> conceptReferenceRange = Context.getConceptService().getConceptReferenceRangesByConceptId(obs.getConcept().getId());
+
+		assertFalse(conceptReferenceRange.isEmpty());
+		
+		Double expectedHiAbsolute = conceptReferenceRange.get(0).getHiAbsolute();
+
+		Obs savedObs = obsService.getObsByUuid(obs.getUuid());
+
+		ObsReferenceRange obsReferenceRange = savedObs.getReferenceRange();
+		assertEquals(expectedHiAbsolute, obsReferenceRange.getHiAbsolute());
+	}
+	
+	private Obs buildObservation() {
+		Concept concept = Context.getConceptService().getConcept(4089);
+		Patient patient = new Patient(2);
+		Calendar calendar = Calendar.getInstance();
+		calendar.add(Calendar.YEAR, -5);
+		patient.setBirthdate(calendar.getTime());
+		
+		Date newDate = new Date();
+
+		Obs obs = new Obs();
+		obs.setConcept(concept);
+		obs.setPerson(patient);
+		obs.setEncounter(new Encounter(3));
+		obs.setObsDatetime(newDate);
+		obs.setLocation(new Location(1));
+		obs.setValueGroupId(7);
+		obs.setValueDatetime(newDate);
+		obs.setValueCoded(new Concept(3));
+		obs.setValueNumeric(90.0);
+		obs.setValueModifier("cc");
+		obs.setValueText("value text2");
+		
+		return obs;
+	}
 }
diff --git a/api/src/test/java/org/openmrs/api/db/hibernate/HibernateConceptDAOTest.java b/api/src/test/java/org/openmrs/api/db/hibernate/HibernateConceptDAOTest.java
index d93dde4b4fcd..239e108fb7c8 100644
--- a/api/src/test/java/org/openmrs/api/db/hibernate/HibernateConceptDAOTest.java
+++ b/api/src/test/java/org/openmrs/api/db/hibernate/HibernateConceptDAOTest.java
@@ -12,11 +12,13 @@
 import static org.hamcrest.MatcherAssert.assertThat;
 import static org.hamcrest.Matchers.is;
 import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
 import static org.junit.jupiter.api.Assertions.assertNotNull;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
 import java.util.List;
 import java.util.Locale;
+import java.util.Optional;
 
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
@@ -27,6 +29,7 @@
 import org.openmrs.ConceptMap;
 import org.openmrs.ConceptMapType;
 import org.openmrs.ConceptName;
+import org.openmrs.ConceptReferenceRange;
 import org.openmrs.ConceptReferenceTerm;
 import org.openmrs.ConceptSource;
 import org.openmrs.Drug;
@@ -241,4 +244,24 @@ public void getConceptDatatypes_shouldReturnEmptyListForNonExistentName() {
 
 		assertTrue(datatypes.isEmpty());
 	}
+	
+	/**
+	 * @see HibernateConceptDAO#getConceptReferenceRangesByConceptId(Integer) 
+	 */
+	@Test
+	public void getConceptReferenceRangesByConceptId_shouldReturnEmptyListForIfNoConceptReferenceRangeIsLinkedToConcept() {
+		//Given
+		ConceptDatatype conceptDatatype = dao.getConceptDatatypeByName("N/A");
+
+		Concept concept = new Concept();
+		concept.addName(new ConceptName("Tuberculosis", Locale.US));
+		concept.setDatatype(conceptDatatype);
+		dao.saveConcept(concept);
+
+		//When
+		List<ConceptReferenceRange> savedConceptReferenceRange = dao.getConceptReferenceRangesByConceptId(concept.getId());
+
+		// Then
+		assertTrue(savedConceptReferenceRange.isEmpty());
+	}
 }
diff --git a/api/src/test/java/org/openmrs/api/impl/ConceptServiceImplTest.java b/api/src/test/java/org/openmrs/api/impl/ConceptServiceImplTest.java
index 815ccb6bd10b..ba57bdcff793 100644
--- a/api/src/test/java/org/openmrs/api/impl/ConceptServiceImplTest.java
+++ b/api/src/test/java/org/openmrs/api/impl/ConceptServiceImplTest.java
@@ -35,7 +35,9 @@
 import org.openmrs.ConceptMapType;
 import org.openmrs.ConceptName;
 import org.openmrs.ConceptNameTag;
+import org.openmrs.ConceptNumeric;
 import org.openmrs.ConceptProposal;
+import org.openmrs.ConceptReferenceRange;
 import org.openmrs.ConceptReferenceTerm;
 import org.openmrs.ConceptSearchResult;
 import org.openmrs.ConceptSet;
@@ -55,7 +57,7 @@
 public class ConceptServiceImplTest extends BaseContextSensitiveTest {
 	
 	protected ConceptService conceptService = null;
-	
+	private final String TEST_CRITERIA = "$patient.getAge() >= 1 && $patient.getAge() <= 70";
 	
 	/**
 	 * Run this before each unit test in this class. The "@Before" method in
@@ -925,4 +927,62 @@ public void getConceptNameTagByName_shouldReturnTheMatchingConceptNameTagObjectI
 		assertNotNull(conceptNameTag);
 		assertEquals(conceptNameTag, conceptService.getConceptNameTagByName(conceptNameTag.getTag()));
 	}
+
+	/**
+	 * @see ConceptServiceImpl#saveConceptProposal(ConceptProposal)
+	 */
+	@Test
+	public void saveConceptReferenceRange_shouldReturnSavedConceptReferenceRangeObject() {
+		final Double HIGH_ABSOLUTE = 120.0;
+		
+		ConceptReferenceRange conceptReferenceRange = new ConceptReferenceRange();
+		conceptReferenceRange.setHiAbsolute(HIGH_ABSOLUTE);
+		conceptReferenceRange.setConceptNumeric(createConceptNumeric());
+		conceptReferenceRange.setCriteria(TEST_CRITERIA);
+		ConceptReferenceRange savedConceptReferenceRange = conceptService.saveConceptReferenceRange(conceptReferenceRange);
+		assertEquals(HIGH_ABSOLUTE, savedConceptReferenceRange.getHiAbsolute());
+
+		// Update
+		final Double NEW_HIGH_ABSOLUTE = 200.0;
+		savedConceptReferenceRange.setHiAbsolute(NEW_HIGH_ABSOLUTE);
+
+		ConceptReferenceRange updatedConceptReferenceRange = conceptService.saveConceptReferenceRange(savedConceptReferenceRange);
+		assertEquals(NEW_HIGH_ABSOLUTE, updatedConceptReferenceRange.getHiAbsolute());
+	}
+
+	/**
+	 * @see ConceptServiceImpl#saveConceptProposal(ConceptProposal)
+	 */
+	@Test
+	public void saveConceptReferenceRange_shouldFailGivenNull() {
+		assertThrows(IllegalArgumentException.class, () -> conceptService.saveConceptReferenceRange(null));
+	}
+
+	/**
+	 * @see ConceptServiceImpl#getConceptReferenceRangesByConceptId(Integer) 
+	 */
+	@Test
+	public void getConceptReferenceRangesByConceptId_shouldReturnConceptReferenceRangeIfFound() {
+		ConceptNumeric conceptNumeric = createConceptNumeric();
+		
+		ConceptReferenceRange conceptReferenceRange = new ConceptReferenceRange();
+		conceptReferenceRange.setHiAbsolute(120.0);
+		conceptReferenceRange.setConceptNumeric(conceptNumeric);
+		conceptReferenceRange.setCriteria(TEST_CRITERIA);
+		conceptService.saveConceptReferenceRange(conceptReferenceRange);
+
+		List<ConceptReferenceRange> savedConceptReferenceRange = conceptService.getConceptReferenceRangesByConceptId(conceptNumeric.getId());
+		assertEquals(1, savedConceptReferenceRange.size());
+		assertEquals(conceptReferenceRange.getHiAbsolute(), savedConceptReferenceRange.get(0).getHiAbsolute());
+	}
+	
+	private ConceptNumeric createConceptNumeric() {
+		ConceptNumeric conceptNumeric = new ConceptNumeric();
+		ConceptName fullySpecifiedName = new ConceptName("concept name", new Locale("fr", "CA"));
+		conceptNumeric.addName(fullySpecifiedName);
+		conceptNumeric.addDescription(new ConceptDescription("some description", null));
+		conceptNumeric.setDatatype(new ConceptDatatype(1));
+		conceptNumeric.setConceptClass(new ConceptClass(1));
+		return (ConceptNumeric) Context.getConceptService().saveConcept(conceptNumeric);
+	}
 }
diff --git a/api/src/test/java/org/openmrs/util/ConceptReferenceRangeUtilityTest.java b/api/src/test/java/org/openmrs/util/ConceptReferenceRangeUtilityTest.java
new file mode 100644
index 000000000000..b5bb50211d14
--- /dev/null
+++ b/api/src/test/java/org/openmrs/util/ConceptReferenceRangeUtilityTest.java
@@ -0,0 +1,510 @@
+/**
+ * This Source Code Form is subject to the terms of the Mozilla Public License,
+ * v. 2.0. If a copy of the MPL was not distributed with this file, You can
+ * obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
+ * the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
+ *
+ * Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
+ * graphic logo is a trademark of OpenMRS Inc.
+ */
+package org.openmrs.util;
+
+import org.joda.time.DateTimeUtils;
+import org.joda.time.LocalTime;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.mockito.Mock;
+import org.mockito.Mockito;
+import org.openmrs.Concept;
+import org.openmrs.ConceptDatatype;
+import org.openmrs.Encounter;
+import org.openmrs.Location;
+import org.openmrs.Obs;
+import org.openmrs.Person;
+import org.openmrs.PersonAttribute;
+import org.openmrs.PersonAttributeType;
+import org.openmrs.api.APIException;
+import org.openmrs.api.ConceptService;
+import org.openmrs.api.ObsService;
+import org.openmrs.test.jupiter.BaseContextSensitiveTest;
+
+import java.util.Calendar;
+import java.util.Collections;
+import java.util.Date;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+class ConceptReferenceRangeUtilityTest extends BaseContextSensitiveTest {
+	
+	private Calendar calendar;
+	private Person person;
+	private ConceptReferenceRangeUtility conceptReferenceRangeUtility;
+	
+	@Mock
+	private ObsService obsService;
+	
+	@Mock
+	private ConceptService conceptService;
+	
+	@BeforeEach
+	public void setUp() {
+		person = new Person();
+		conceptReferenceRangeUtility = new ConceptReferenceRangeUtility();
+	}
+
+	@Test
+	public void testAgeInRange_shouldReturnTrueIfAgeIsWithinRange() {
+		calendar = Calendar.getInstance();
+		calendar.add(Calendar.YEAR, -5);
+		person.setBirthdate(calendar.getTime());
+
+		Obs obs = buildObs();
+		obs.setPerson(person);
+
+		assertTrue(
+			conceptReferenceRangeUtility.evaluateCriteria(
+				"$patient.getAge() > 1 && $patient.getAge() < 10",
+				obs)
+		);
+	}
+
+	@Test
+	public void testAgeInRange_shouldReturnFalseIfAgeIsOutsideRange() {
+		calendar = Calendar.getInstance();
+		calendar.add(Calendar.YEAR, -11);
+		person.setBirthdate(calendar.getTime());
+
+		Obs obs = buildObs();
+		obs.setPerson(person);
+
+		assertFalse(
+			conceptReferenceRangeUtility.evaluateCriteria(
+				"$patient.getAge() > 1 && $patient.getAge() < 10", 
+				obs)
+		);
+	}
+
+	@Test
+	public void testAgeInRange_shouldReturnTrueIfAgeIsOnBoundary() {
+		calendar = Calendar.getInstance();
+		calendar.add(Calendar.YEAR, -10);
+		person.setBirthdate(calendar.getTime());
+
+		Obs obs = buildObs();
+		obs.setPerson(person);
+		
+		assertTrue(
+			conceptReferenceRangeUtility.evaluateCriteria(
+				"$patient.getAge() >= 1 && $patient.getAge() <= 10", 
+				obs)
+		);
+	}
+
+	@Test
+	public void testAgeInMonths_shouldReturnTrueIfAgeIsWithinRange() {
+		calendar = Calendar.getInstance();
+		calendar.add(Calendar.MONTH, -5);
+		Date birthDate = calendar.getTime();
+		person.setBirthdate(birthDate);
+
+		Obs obs = buildObs();
+		obs.setPerson(person);
+		
+		assertTrue(
+			conceptReferenceRangeUtility.evaluateCriteria(
+				"$patient.getAgeInMonths() > 1 && $patient.getAgeInMonths() < 12",
+				obs)
+		);
+	}
+
+	@Test
+	public void testAgeInRange_shouldThrowExceptionIfCriteriaIsInvalid() {
+		calendar = Calendar.getInstance();
+		calendar.add(Calendar.YEAR, -1);
+		person.setBirthdate(calendar.getTime());
+
+		Obs obs = buildObs();
+		obs.setPerson(person);
+
+		assertThrows(APIException.class, () -> 
+			conceptReferenceRangeUtility.evaluateCriteria("invalidCriteria", obs));
+	}
+
+	@Test
+	public void testAgeInRange_shouldThrowAnExceptionIfCriteriaIsEmpty() {
+		calendar = Calendar.getInstance();
+		calendar.set(2019, Calendar.JUNE, 2);
+		person.setBirthdate(calendar.getTime());
+
+		Obs obs = buildObs();
+		obs.setPerson(person);
+
+		IllegalArgumentException exception = assertThrows(IllegalArgumentException.class, () -> {
+			conceptReferenceRangeUtility.evaluateCriteria("", obs);
+		});
+
+		assertTrue(exception.getMessage().contains("criteria is empty"));
+	}
+
+	@Test
+	public void testAgeInRange_shouldReturnFalseIfPersonAgeIsNotSet() {
+		Obs obs = buildObs();
+		obs.setPerson(person);
+		
+		assertFalse(
+			conceptReferenceRangeUtility.evaluateCriteria(
+				"$patient.getAge() >= 15 && $patient.getAge() <= 50",
+				obs)
+		);
+	}
+
+	@Test
+	public void testGenderMatch_shouldReturnTrueIfGenderMatches() {
+		person.setGender("M");
+
+		Obs obs = buildObs();
+		obs.setPerson(person);
+
+		assertTrue(
+			conceptReferenceRangeUtility.evaluateCriteria(
+				"$patient.getGender().equals('M')",
+				obs)
+		);
+	}
+
+	@Test
+	public void testGenderMatch_shouldReturnFalseIfGenderDoesNotMatch() {
+		person.setGender("F");
+
+		Obs obs = buildObs();
+		obs.setPerson(person);
+
+		assertFalse(
+			conceptReferenceRangeUtility.evaluateCriteria(
+				"$patient.getGender().equals('M')",
+				obs)
+		);
+	}
+
+	@Test
+	public void testGenderMatch_shouldReturnFalseIfGenderIsNull() {
+		Obs obs = buildObs();
+		obs.setPerson(person);
+		
+		assertFalse(conceptReferenceRangeUtility.evaluateCriteria(
+			"$patient.getGender().equals('M')",
+			obs)
+		);
+	}
+
+	@Test
+	public void testAgeAndGenderMatch_shouldReturnTrueIfAgeAndGenderMatch() {
+		calendar = Calendar.getInstance();
+		calendar.add(Calendar.YEAR, -5);
+		person.setBirthdate(calendar.getTime());
+		person.setGender("M");
+
+		Obs obs = buildObs();
+		obs.setPerson(person);
+
+		assertTrue(
+			conceptReferenceRangeUtility.evaluateCriteria(
+				"$patient.getAge() > 1 && $patient.getAge() < 10 && $patient.getGender().equals('M')", 
+				obs)
+		);
+	}
+
+	@Test
+	public void testAgeAndGenderMatch_shouldReturnTrueIfAgeOrGenderMatch() {
+		calendar = Calendar.getInstance();
+		calendar.add(Calendar.YEAR, -5);
+		person.setBirthdate(calendar.getTime());
+		person.setGender("M");
+
+		Obs obs = buildObs();
+		obs.setPerson(person);
+
+		assertTrue(
+			conceptReferenceRangeUtility.evaluateCriteria(
+				"($patient.getAge() > 1 && $patient.getAge() < 3) || $patient.getGender().equals('M')",
+				obs)
+		);
+	}
+
+	@Test
+	public void testAgeAndGenderMatch_shouldReturnFalseIfAgeDoesNotMatch() {
+		calendar = Calendar.getInstance();
+		calendar.add(Calendar.YEAR, -11);
+		person.setBirthdate(calendar.getTime());
+		person.setGender("M");
+
+		Obs obs = buildObs();
+		obs.setPerson(person);
+
+		assertFalse(
+			conceptReferenceRangeUtility.evaluateCriteria(
+				"$patient.getAge() > 1 && $patient.getAge() < 10 && $patient.getGender().equals('M')", 
+				obs)
+		);
+	}
+
+	@Test
+	public void testAgeAndGenderMatch_shouldReturnFalseIfGenderDoesNotMatch() {
+		calendar = Calendar.getInstance();
+		calendar.add(Calendar.YEAR, -5);
+		person.setBirthdate(calendar.getTime());
+		person.setGender("F");
+
+		Obs obs = buildObs();
+		obs.setPerson(person);
+
+		assertFalse(
+			conceptReferenceRangeUtility.evaluateCriteria(
+				"$patient.getAge() > 1 && $patient.getAge() < 10 && $patient.getGender().equals('M')", 
+				obs)
+		);
+	}
+
+	@Test
+	public void testAgeAndGenderMatch_shouldThrowExceptionIfPersonIsNull() {
+
+		IllegalArgumentException thrown = assertThrows(IllegalArgumentException.class, () -> 
+			conceptReferenceRangeUtility.evaluateCriteria(
+				"$patient.getAge() > 1 && $patient.getAge() < 10 && $patient.getGender().equals('M')", 
+				null)
+		);
+
+		assertEquals("Failed to evaluate criteria with reason: Obs is null", thrown.getMessage());
+	}
+
+	@Test
+	public void testAgeAndGenderMatch_shouldReturnFalseIfAgeIsNull() {
+		Obs obs = buildObs();
+		obs.setPerson(person);
+		
+		assertFalse(
+			conceptReferenceRangeUtility.evaluateCriteria(
+				"$patient.getAge() > 1 && $patient.getAge() < 10",
+				obs)
+		);
+	}
+
+	@Test
+	public void testObsValueMatch_shouldReturnTrueIfValueTextMatch() {
+		person.setGender("F");
+		
+		Obs obs = buildObs();
+		obs.setPerson(person);
+		obs.setValueText("PREGNANT");
+		
+		Concept concept = new Concept(4900);
+		
+		Mockito.when(conceptService.getConceptByReference(Mockito.anyString())).thenReturn(concept);
+
+		Mockito.when(obsService.getObservations(Collections.singletonList(person),
+				null,
+				Collections.singletonList(concept),
+				null,
+				null,
+				null,
+				Collections.singletonList("dateCreated"),
+				1,
+				null,
+				null,
+				null,
+				false))
+			.thenReturn(Collections.singletonList(obs));
+		
+		assertTrue(
+			conceptReferenceRangeUtility.evaluateCriteria(
+				"$patient.getGender().equals('F') " +
+					"&& $fn.getLatestObs('bac25fd5-c143-4e43-bffe-4eb1e7efb6ce', $patient).getValueText().equals('PREGNANT')", 
+				obs)
+		);
+	}
+	
+	@Test
+	public void testObsValueMatch_shouldReturnTrueIfPersonAttributeMatch() {
+		PersonAttributeType personAttributeType = new PersonAttributeType();
+		personAttributeType.setName("Race");
+		personAttributeType.setSearchable(true);
+		
+		PersonAttribute personAttribute = new PersonAttribute();
+		personAttribute.setAttributeType(personAttributeType);
+		personAttribute.setValue("Maasai");
+		
+		person.setAttributes(Collections.singleton(personAttribute));
+		
+		Obs obs = buildObs();
+		obs.setPerson(person);
+		obs.setValueText("PREGNANT");
+		
+		assertTrue(
+			conceptReferenceRangeUtility.evaluateCriteria(
+				"$patient.getAttribute('Race').getValue() == 'Maasai'", 
+				obs)
+		);
+	}
+
+	@Test
+	public void testObsValueMatch_shouldReturnFalseIfValueMismatch() {
+		person.setId(1);
+
+		Obs obs = buildObs();
+		obs.setPerson(person);
+		
+		assertFalse(
+			conceptReferenceRangeUtility.evaluateCriteria(
+				"$fn.getLatestObs('CIEL:1234', $patient).getValueBoolean() == true",
+				obs)
+		);
+	}
+
+	@Test
+	public void testTimeOfDay_shouldReturnTrueIfTimeOfDayMatches() {
+		// Freeze time at the current system time
+		DateTimeUtils.setCurrentMillisFixed(System.currentTimeMillis());
+
+		Obs obs = buildObs();
+		obs.setPerson(person);
+		
+		assertTrue(
+			conceptReferenceRangeUtility.evaluateCriteria(
+				"$fn.getCurrentHour() == " + LocalTime.now().getHourOfDay(),
+				obs)
+		);
+
+		// Clean up: Reset time to system time
+		DateTimeUtils.setCurrentMillisSystem();
+	}
+
+	@Test
+	public void testTimeOfDay_shouldReturnFalseIfTimeOfDayDoesNotMatch() {
+		// Freeze time at the current system time
+		DateTimeUtils.setCurrentMillisFixed(System.currentTimeMillis());
+
+		Obs obs = buildObs();
+		obs.setPerson(person);
+		
+		assertFalse(
+			conceptReferenceRangeUtility.evaluateCriteria(
+				"$fn.getCurrentHour() == " + LocalTime.now().plusHours(1).getHourOfDay(),
+				obs)
+		);
+
+		// Clean up: Reset time to system time
+		DateTimeUtils.setCurrentMillisSystem();
+	}
+
+	@Test
+	public void testRelevantObs_shouldReturnTrueIfCurrentObsHasValidNumericValue() {
+		Obs obs = buildObs();
+		obs.setPerson(person);
+		obs.setValueNumeric(20.0);
+
+		Concept concept = new Concept(4900);
+
+		Mockito.when(conceptService.getConceptByReference(Mockito.anyString())).thenReturn(concept);
+
+		Mockito.when(obsService.getObservations(Collections.singletonList(person),
+				null,
+				Collections.singletonList(concept),
+				null,
+				null,
+				null,
+				Collections.singletonList("dateCreated"),
+				1,
+				null,
+				null,
+				null,
+				false))
+			.thenReturn(Collections.singletonList(obs));
+
+		assertTrue(
+			conceptReferenceRangeUtility.evaluateCriteria(
+				"$fn.getCurrentObs('bac25fd5-c143-4e43-bffe-4eb1e7efb6ce', $obs).getValueNumeric() >= 20",
+				obs)
+		);
+	}
+
+	@Test
+	public void testRelevantObs_shouldReturnTrueIfBMIIsInTheExpectedRange() {
+		Obs obs = buildObs();
+		obs.setPerson(person);
+		
+		Obs heightObservation = buildObs();
+		heightObservation.setValueNumeric(170.0);
+
+		Obs weightObservation = buildObs();
+		weightObservation.setValueNumeric(70.0);
+
+		Concept heightConcept = new Concept(5497);
+		Concept weightConcept = new Concept(5089);
+
+		Mockito.when(conceptService.getConceptByReference("a09ab2c5-878e-4905-b25d-5784167d0216")).thenReturn(heightConcept);
+		Mockito.when(conceptService.getConceptByReference("c607c80f-1ea9-4da3-bb88-6276ce8868dd")).thenReturn(weightConcept);
+
+		Mockito.when(obsService.getObservations(Collections.singletonList(person),
+				null,
+				Collections.singletonList(heightConcept),
+				null,
+				null,
+				null,
+				Collections.singletonList("dateCreated"),
+				1,
+				null,
+				null,
+				null,
+				false))
+			.thenReturn(Collections.singletonList(heightObservation));
+
+		Mockito.when(obsService.getObservations(Collections.singletonList(person),
+				null,
+				Collections.singletonList(weightConcept),
+				null,
+				null,
+				null,
+				Collections.singletonList("dateCreated"),
+				1,
+				null,
+				null,
+				null,
+				false))
+			.thenReturn(Collections.singletonList(weightObservation));
+
+		assertTrue(
+			conceptReferenceRangeUtility.evaluateCriteria(
+				"($fn.getCurrentObs('c607c80f-1ea9-4da3-bb88-6276ce8868dd', $obs).getValueNumeric() " +
+					"/ ( ($fn.getCurrentObs('a09ab2c5-878e-4905-b25d-5784167d0216', $obs).getValueNumeric() / 100) * " +
+					"($fn.getCurrentObs('a09ab2c5-878e-4905-b25d-5784167d0216', $obs).getValueNumeric() / 100))) >= 18.5 && " +
+					"($fn.getCurrentObs('c607c80f-1ea9-4da3-bb88-6276ce8868dd', $obs).getValueNumeric() / " +
+					"( ($fn.getCurrentObs('a09ab2c5-878e-4905-b25d-5784167d0216', $obs).getValueNumeric() / 100) * " +
+					"($fn.getCurrentObs('a09ab2c5-878e-4905-b25d-5784167d0216', $obs).getValueNumeric() / 100))) < 25",
+				obs)
+		);
+	}
+	
+	private Obs buildObs() {
+		Concept concept = new Concept(5089);
+		concept.setDatatype(new ConceptDatatype(3));
+
+		Date date = new Date();
+
+		Obs obs = new Obs();
+		obs.setConcept(concept);
+		obs.setEncounter(new Encounter(3));
+		obs.setObsDatetime(date);
+		obs.setLocation(new Location(1));
+		obs.setValueGroupId(7);
+		obs.setValueDatetime(date);
+		obs.setValueCoded(new Concept(3));
+		obs.setValueNumeric(2.0);
+		obs.setValueModifier("cc");
+
+		return obs;
+	}
+}
+
diff --git a/api/src/test/java/org/openmrs/util/DatabaseUpdaterDatabaseIT.java b/api/src/test/java/org/openmrs/util/DatabaseUpdaterDatabaseIT.java
index f22b4aee80ef..6ced47ee1cfe 100644
--- a/api/src/test/java/org/openmrs/util/DatabaseUpdaterDatabaseIT.java
+++ b/api/src/test/java/org/openmrs/util/DatabaseUpdaterDatabaseIT.java
@@ -30,7 +30,7 @@ public class DatabaseUpdaterDatabaseIT extends H2DatabaseIT {
 	 * This constant needs to be updated when adding new Liquibase update files to openmrs-core.
 	 */
 	
-	private static final int CHANGE_SET_COUNT_FOR_GREATER_THAN_2_1_X = 897;
+	private static final int CHANGE_SET_COUNT_FOR_GREATER_THAN_2_1_X = 899;
 
 	private static final int CHANGE_SET_COUNT_FOR_2_1_X = 870;
 
diff --git a/api/src/test/java/org/openmrs/util/OpenmrsUtilTest.java b/api/src/test/java/org/openmrs/util/OpenmrsUtilTest.java
index cd4c9fa265fb..82346adf714c 100644
--- a/api/src/test/java/org/openmrs/util/OpenmrsUtilTest.java
+++ b/api/src/test/java/org/openmrs/util/OpenmrsUtilTest.java
@@ -21,7 +21,6 @@
 import static org.junit.jupiter.api.Assertions.assertThrows;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 import static org.junit.jupiter.api.Assertions.fail;
-import static org.mockito.ArgumentMatchers.anyString;
 import static org.mockito.Mockito.spy;
 import static org.mockito.Mockito.times;
 import static org.mockito.Mockito.verify;
@@ -38,6 +37,7 @@
 import java.text.ParseException;
 import java.text.SimpleDateFormat;
 import java.util.ArrayList;
+import java.util.Calendar;
 import java.util.Collection;
 import java.util.Date;
 import java.util.List;
@@ -57,10 +57,11 @@
 import org.junit.jupiter.api.Test;
 import org.openmrs.Concept;
 import org.openmrs.GlobalProperty;
+import org.openmrs.Obs;
 import org.openmrs.PatientIdentifier;
 import org.openmrs.PatientIdentifierType;
+import org.openmrs.Person;
 import org.openmrs.User;
-import org.openmrs.api.ConceptService;
 import org.openmrs.api.InvalidCharactersPasswordException;
 import org.openmrs.api.ShortPasswordException;
 import org.openmrs.api.WeakPasswordException;
@@ -1022,4 +1023,61 @@ public void conceptListHelper_shouldNotReturnDuplicateConcepts() {
 		ret = OpenmrsUtil.conceptListHelper(descriptor);
 		assertEquals(1, ret.size());
 	}
+
+	@Test
+	public void isValidNumericValue_shouldReturnErrorMessageWhenValueIsBelowLowAbsolute() {
+		Calendar calendar = Calendar.getInstance();
+		calendar.add(Calendar.YEAR, -10);
+		Person person = new Person(10);
+		person.setBirthdate(calendar.getTime());
+		
+		Obs obs = new Obs();
+		obs.setPerson(person);
+		
+		String result = OpenmrsUtil.isValidNumericValue(
+			5.0f,
+			Context.getConceptService().getConcept(4090),
+			obs
+		);
+
+		assertEquals("Expected value between 70.0 and 140.0", result);
+	}
+
+	@Test
+	public void isValidNumericValue_shouldReturnErrorMessageWhenValueIsAboveHiAbsolute() {
+		Calendar calendar = Calendar.getInstance();
+		calendar.add(Calendar.YEAR, -10);
+		Person person = new Person(10);
+		person.setBirthdate(calendar.getTime());
+
+		Obs obs = new Obs();
+		obs.setPerson(person);
+		
+		String result = OpenmrsUtil.isValidNumericValue(
+			155.0f,
+			Context.getConceptService().getConcept(4090),
+			obs
+		);
+		
+		assertEquals("Expected value between 70.0 and 140.0", result);
+	}
+
+	@Test
+	public void isValidNumericValue_shouldNotReturnErrorMessageWhenNoReferenceRangeIsAvailable() {
+		Calendar calendar = Calendar.getInstance();
+		calendar.add(Calendar.YEAR, -10);
+		Person person = new Person(10);
+		person.setBirthdate(calendar.getTime());
+
+		Obs obs = new Obs();
+		obs.setPerson(person);
+
+		String result = OpenmrsUtil.isValidNumericValue(
+			120.0f,
+			new Concept(),
+			obs
+		);
+
+		assertEquals("", result);
+	}
 }
diff --git a/api/src/test/java/org/openmrs/validator/ObsValidatorTest.java b/api/src/test/java/org/openmrs/validator/ObsValidatorTest.java
index 2f8b08d505fc..5089acd61231 100644
--- a/api/src/test/java/org/openmrs/validator/ObsValidatorTest.java
+++ b/api/src/test/java/org/openmrs/validator/ObsValidatorTest.java
@@ -11,10 +11,14 @@
 
 import static org.hamcrest.CoreMatchers.is;
 import static org.hamcrest.MatcherAssert.assertThat;
+import static org.junit.Assert.assertNull;
+import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
 import static org.junit.jupiter.api.Assertions.assertThrows;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
+import java.util.Calendar;
 import java.util.Date;
 import java.util.HashSet;
 import java.util.Set;
@@ -41,17 +45,21 @@ public class ObsValidatorTest extends BaseContextSensitiveTest {
 	
 	@Autowired
 	private ObsValidator obsValidator;
-	
+
+	Calendar calendar = Calendar.getInstance();
 	
 	/**
 	 * @see ObsValidator#validate(java.lang.Object, org.springframework.validation.Errors)
 	 */
 	@Test
 	public void validate_shouldFailValidationIfPersonIdIsNull() {
+		Person person = new Person();
+		
 		Obs obs = new Obs();
 		obs.setConcept(Context.getConceptService().getConcept(5089));
 		obs.setObsDatetime(new Date());
 		obs.setValueNumeric(1.0);
+		obs.setPerson(person);
 		
 		Errors errors = new BindException(obs, "obs");
 		obsValidator.validate(obs, errors);
@@ -511,4 +519,273 @@ public void validate_shouldPassValidationIfValueTextIsLessThanTheMaximumLength()
 		assertFalse(errors.hasFieldErrors("obsDatetime"));
 		assertFalse(errors.hasFieldErrors("valueText"));
 	}
+
+	/**
+	 * @see ObsValidator#validate(java.lang.Object, org.springframework.validation.Errors)
+	 */
+	@Test
+	public void validate_shouldFailValidationIfObsValueExceedsHiAbsolute() {
+		Calendar calendar = Calendar.getInstance();
+		calendar.add(Calendar.YEAR, -10);
+		Person person = new Person(10);
+		person.setBirthdate(calendar.getTime());
+		
+		Obs obs = new Obs();
+		obs.setId(1);
+		obs.setPerson(person);
+		obs.setConcept(Context.getConceptService().getConcept(4090));
+		obs.setValueNumeric(201.0);
+		obs.setObsDatetime(new Date());
+		
+		Errors errors = new BindException(obs, "obs");
+		obsValidator.validate(obs, errors);
+
+		assertTrue(errors.hasFieldErrors("valueNumeric"));
+	}
+
+	/**
+	 * @see ObsValidator#validate(java.lang.Object, org.springframework.validation.Errors)
+	 */
+	@Test
+	public void validate_shouldFailValidationIfObsValueBelowLowAbsolute() {
+		Obs obs = getObs(10, 4089, 50.0);
+
+		Errors errors = new BindException(obs, "obs");
+		obsValidator.validate(obs, errors);
+
+		assertTrue(errors.hasFieldErrors("valueNumeric"));
+	}
+	
+	/**
+	 * @see ObsValidator#validate(java.lang.Object, org.springframework.validation.Errors)
+	 */
+	@Test
+	public void validate_shouldPassValidationIfObsValueWithinRange() {
+		Obs obs = new Obs();
+		Person person = new Person(10);
+		calendar.add(Calendar.YEAR, -10);
+		
+		person.setBirthdate(calendar.getTime());
+		obs.setPerson(person);
+		obs.setConcept(Context.getConceptService().getConcept(4090));
+		obs.setValueNumeric(80.0);
+		obs.setObsDatetime(new Date());
+
+		Errors errors = new BindException(obs, "obs");
+		obsValidator.validate(obs, errors);
+
+		assertFalse(errors.hasErrors());
+		assertNotNull(obs.getReferenceRange());
+	}
+
+	/**
+	 * @see ObsValidator#validate(java.lang.Object, org.springframework.validation.Errors)
+	 */
+	@Test
+	public void shouldSetObsReferenceRangeIfCriteriaMatches() {
+		Person person = new Person(1);
+		calendar.add(Calendar.YEAR, -6);
+		person.setBirthdate(calendar.getTime());
+		
+		Obs obs = new Obs();
+		obs.setPerson(person);
+		obs.setConcept(Context.getConceptService().getConcept(4090));
+		obs.setValueNumeric(88.0); 
+		obs.setObsDatetime(new Date());
+
+		Errors errors = new BindException(obs, "obs");
+		obsValidator.validate(obs, errors);
+
+		assertFalse(errors.hasErrors());
+		assertNotNull(obs.getReferenceRange());
+		assertEquals(140.0, obs.getReferenceRange().getHiAbsolute());
+	}
+
+	/**
+	 * @see ObsValidator#validate(java.lang.Object, org.springframework.validation.Errors)
+	 */
+	@Test
+	public void shouldSetObsReferenceRangeValuesIfConceptReferenceRangeIsNullAndConceptNumericIsNotNull() {
+		Person person = new Person(1);
+		calendar.add(Calendar.YEAR, -600);
+		person.setBirthdate(calendar.getTime());
+
+		Obs obs = new Obs();
+		obs.setPerson(person);
+		obs.setConcept(Context.getConceptService().getConcept(4090));
+		obs.setValueNumeric(88.0);
+		obs.setObsDatetime(new Date());
+
+		Errors errors = new BindException(obs, "obs");
+		obsValidator.validate(obs, errors);
+
+		assertFalse(errors.hasErrors());
+		assertNotNull(obs.getReferenceRange());
+		assertEquals(145.0, obs.getReferenceRange().getHiAbsolute());
+		assertEquals(70.0, obs.getReferenceRange().getLowAbsolute());
+	}
+
+	/**
+	 * @see ObsValidator#validate(java.lang.Object, org.springframework.validation.Errors)
+	 */
+	@Test
+	public void shouldNotSetObsReferenceRangeValueIfConceptIsNotFound() {
+		Person person = new Person(1);
+		calendar.add(Calendar.YEAR, -6);
+		person.setBirthdate(calendar.getTime());
+
+		Obs obs = new Obs();
+		obs.setPerson(person);
+		obs.setConcept(Context.getConceptService().getConcept(409000));
+		obs.setValueNumeric(8.0);
+		obs.setObsDatetime(new Date());
+
+		Errors errors = new BindException(obs, "obs");
+		obsValidator.validate(obs, errors);
+
+		assertTrue(errors.hasErrors());
+		assertNull(obs.getReferenceRange());
+	}
+
+	/**
+	 * @see ObsValidator#validate(java.lang.Object, org.springframework.validation.Errors)
+	 * 
+	 * Fetching conceptReferenceRanges by concept id (4090) returns 2 items with absolute value bounds;- 80-150 and 60-140
+	 */
+	@Test
+	public void shouldSetErrorIfObsValueIsHigherThanStrictHigherBound() {
+		Obs obs = getObs(10, 4090, 145.0);
+
+		Errors errors = new BindException(obs, "obs");
+		obsValidator.validate(obs, errors);
+
+		assertTrue(errors.hasErrors());
+		assertTrue(errors.hasFieldErrors("valueNumeric"));
+		assertEquals("error.value.outOfRange.high", errors.getAllErrors().get(0).getCode());
+	}
+
+	/**
+	 * @see ObsValidator#validate(java.lang.Object, org.springframework.validation.Errors)
+	 *
+	 * Existing Obs associated with concept id 5089 are more than 1. In this test, we want to make sure we are getting right obs by person.
+	 * With the right obs, the criteria should evaluate to true, then validate ranges. 
+	 * The valid range in accordance to conceptReferenceRange = 60-140
+	 */
+	@Test
+	public void shouldPickTheRightObsGivenTwoObsWithTheSameConcept() {
+		Person person = new Person(1);
+		person.setGender("M");
+
+		Obs obs = new Obs();
+		obs.setPerson(person);
+		obs.setConcept(Context.getConceptService().getConcept(5089));
+		obs.setValueNumeric(145.0);
+		obs.setObsDatetime(new Date());
+
+		Errors errors = new BindException(obs, "obs");
+		obsValidator.validate(obs, errors);
+
+		assertTrue(errors.hasErrors());
+		assertTrue(errors.hasFieldErrors("valueNumeric"));
+		assertEquals("error.value.outOfRange.high", errors.getAllErrors().get(0).getCode());
+	}
+
+	/**
+	 * @see ObsValidator#validate(java.lang.Object, org.springframework.validation.Errors)
+	 */
+	@Test
+	public void shouldSetInterpretationToHighIfObsValueIsAboveHiNormalAndLessThanHighCritical() {
+		Obs obs = getObs(60, 4090, 121.0);
+
+		Errors errors = new BindException(obs, "obs");
+		obsValidator.validate(obs, errors);
+
+		assertFalse(errors.hasErrors());
+		assertEquals(Obs.Interpretation.HIGH, obs.getInterpretation());
+	}
+
+	/**
+	 * @see ObsValidator#validate(java.lang.Object, org.springframework.validation.Errors)
+	 */
+	@Test
+	public void shouldSetInterpretationToCriticallyHighIfObsValueIsAboveHighCritical() {
+		Obs obs = getObs(60, 4090, 131.0);
+
+		Errors errors = new BindException(obs, "obs");
+		obsValidator.validate(obs, errors);
+
+		assertFalse(errors.hasErrors());
+		assertEquals(Obs.Interpretation.CRITICALLY_HIGH, obs.getInterpretation());
+	}
+
+	/**
+	 * @see ObsValidator#validate(java.lang.Object, org.springframework.validation.Errors)
+	 */
+	@Test
+	public void shouldSetInterpretationToCriticallyHighIfObsValueIsEqualToHighCritical() {
+		Obs obs = getObs(60, 4090, 130.0);
+
+		Errors errors = new BindException(obs, "obs");
+		obsValidator.validate(obs, errors);
+
+		assertFalse(errors.hasErrors());
+		assertEquals(Obs.Interpretation.CRITICALLY_HIGH, obs.getInterpretation());
+	}
+
+	/**
+	 * @see ObsValidator#validate(java.lang.Object, org.springframework.validation.Errors)
+	 */
+	@Test
+	public void shouldSetInterpretationToCriticallyLowIfObsValueIsEqualToLowCritical() {
+		Obs obs = getObs(60, 4090, 75.0);
+
+		Errors errors = new BindException(obs, "obs");
+		obsValidator.validate(obs, errors);
+
+		assertFalse(errors.hasErrors());
+		assertEquals(Obs.Interpretation.CRITICALLY_LOW, obs.getInterpretation());
+	}
+
+	/**
+	 * @see ObsValidator#validate(java.lang.Object, org.springframework.validation.Errors)
+	 */
+	@Test
+	public void shouldSetInterpretationToNormalIfObsValueIsWithinNormalRange() {
+		Obs obs = getObs(60, 4090, 100.0);
+
+		Errors errors = new BindException(obs, "obs");
+		obsValidator.validate(obs, errors);
+
+		assertFalse(errors.hasErrors());
+		assertEquals(Obs.Interpretation.NORMAL, obs.getInterpretation());
+	}
+
+	/**
+	 * @see ObsValidator#validate(java.lang.Object, org.springframework.validation.Errors)
+	 */
+	@Test
+	public void shouldSetInterpretationToCriticalLowIfObsValueIsBelowLowCritical() {
+		Obs obs = getObs(60, 4090, 74.0);
+
+		Errors errors = new BindException(obs, "obs");
+		obsValidator.validate(obs, errors);
+
+		assertFalse(errors.hasErrors());
+		assertEquals(Obs.Interpretation.CRITICALLY_LOW, obs.getInterpretation());
+	}
+
+	private static Obs getObs(int numberOfYears, int conceptId, double valueNumeric) {
+		Calendar calendar = Calendar.getInstance();
+		calendar.add(Calendar.YEAR, -numberOfYears);
+
+		Person person = new Person(10);
+		person.setBirthdate(calendar.getTime());
+
+		Obs obs = new Obs();
+		obs.setPerson(person);
+		obs.setConcept(Context.getConceptService().getConcept(conceptId));
+		obs.setValueNumeric(valueNumeric);
+		obs.setObsDatetime(new Date());
+		return obs;
+	}
 }
diff --git a/api/src/test/resources/org/openmrs/api/include/ConceptServiceTest-conceptReferenceRange.xml b/api/src/test/resources/org/openmrs/api/include/ConceptServiceTest-conceptReferenceRange.xml
new file mode 100644
index 000000000000..b15c6f3bcfb7
--- /dev/null
+++ b/api/src/test/resources/org/openmrs/api/include/ConceptServiceTest-conceptReferenceRange.xml
@@ -0,0 +1,21 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!--
+
+    This Source Code Form is subject to the terms of the Mozilla Public License,
+    v. 2.0. If a copy of the MPL was not distributed with this file, You can
+    obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
+    the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
+
+    Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
+    graphic logo is a trademark of OpenMRS Inc.
+
+-->
+<dataset>
+	<concept concept_id="1" retired="false" datatype_id="3" class_id="7" is_set="false" creator="1" date_created="2005-01-01 00:00:00.0" uuid="957eba27-2b38-43e8-91a9-4dfe3956a32d"/>
+	<concept concept_id="2" retired="false" datatype_id="1" class_id="7" is_set="false" creator="1" date_created="2005-01-01 00:00:00.0" uuid="92b910bd-298c-4ecf-a632-661ae2f446bf"/>
+	<concept_description concept_description_id="1" concept_id="1" description="this is a description" locale="en" creator="1" date_created="2005-01-01 00:00:00.0" uuid="0a6f34ea-043a-4e69-b418-1d7bb66b99b6"/>
+	<concept_description concept_description_id="2" concept_id="2" description="this is another description" locale="en" creator="1" date_created="2005-01-01 00:00:00.0" uuid="a72dac37-b593-46a1-a24b-e3da6dbcc521"/>
+	<concept_name concept_id="1" name="Blood pressure" locale="en" creator="1" date_created="2005-01-01 00:00:00.0" concept_name_id="1" concept_name_type="FULLY_SPECIFIED" locale_preferred="0" voided="false" uuid="61618da6-7a3d-4ad4-829c-5ad64410c921"/>
+	<concept_numeric concept_id="2" hi_absolute="123.0" allow_decimal="false"/>
+	<concept_reference_range concept_reference_range_id="3" concept_id="5089" criteria="$patient.getAge() &gt;= 1 &amp;&amp; $patient.getAge() &lt;= 3" hi_absolute="120.0" hi_normal="118.0" low_normal="80" uuid="8a157cae-8ceb-4b15-b922-20cb553bfba4"/>
+</dataset>
diff --git a/api/src/test/resources/org/openmrs/include/standardTestDataset.xml b/api/src/test/resources/org/openmrs/include/standardTestDataset.xml
index a7ce10bd0ed9..7ad9f1dd5fc4 100644
--- a/api/src/test/resources/org/openmrs/include/standardTestDataset.xml
+++ b/api/src/test/resources/org/openmrs/include/standardTestDataset.xml
@@ -354,6 +354,7 @@
   <obs obs_id="14" person_id="7" status="FINAL" concept_id="20" encounter_id="4" obs_datetime="2008-08-15 00:00:00.0" location_id="1" value_datetime="2008-08-14 00:00:00.0" comments="" creator="1" date_created="2008-08-19 12:32:38.0" voided="false" uuid="99b92980-db62-40cd-8bca-733357c48126"/>
   <obs obs_id="15" person_id="7" status="FINAL" concept_id="21" encounter_id="4" obs_datetime="2008-08-15 00:00:00.0" location_id="1" value_coded="22" comments="" creator="1" date_created="2008-08-19 12:32:59.0" voided="false" uuid="1ce473c8-3fac-440d-9f92-e10facab194f"/>
   <obs obs_id="16" person_id="7" status="FINAL" concept_id="5089" encounter_id="5" obs_datetime="2008-08-19 00:00:00.0" location_id="2" value_numeric="61.0" comments="" creator="1" date_created="2008-08-19 12:35:30.0" voided="false" uuid="2ed1e57d-9f18-41d3-b067-2eeaf4b30fb0"/>
+  <obs obs_id="77" person_id="1" status="FINAL" concept_id="5089" encounter_id="5" obs_datetime="2008-08-19 00:00:00.0" location_id="2" value_numeric="65.0" comments="" creator="1" date_created="2024-08-19 12:35:30.0" voided="false" uuid="dd5b7ba9-ba83-45e4-8960-e4232964a0ce"/>
   <order_frequency order_frequency_id="1" concept_id="113" creator="1" date_created="2008-08-15 13:52:53.0" retired="false" uuid="28090760-7c38-11e3-baa7-0800200c9a66" />
   <order_frequency order_frequency_id="2" concept_id="3" creator="1" date_created="2008-08-15 13:52:53.0" retired="false" uuid="38090760-7c38-11e3-baa7-0800200c9a66" />
   <order_frequency order_frequency_id="3" concept_id="4" creator="1" date_created="2008-08-15 13:52:53.0" retired="true" retire_reason="Some Retire Reason" retired_by="1" date_retired="2009-08-15 13:52:53.0" uuid="48090760-7c38-11e3-baa7-0800200c9a66" />
@@ -447,4 +448,18 @@
   <test_order order_id="7" number_of_repeats="2" />
   <test_order order_id="8" />
   <test_order order_id="9" />
+	<concept_reference_map concept_map_id="19" concept_id="4088" concept_reference_term_id="13" concept_map_type_id="2" creator="1" date_created="2004-08-12 00:00:00.0" uuid="2f1a6a81-5c8b-40da-9266-d3d5013d9150"/>
+	<concept_reference_map concept_map_id="20" concept_id="4089" concept_reference_term_id="13" concept_map_type_id="2" creator="1" date_created="2004-08-12 00:00:00.0" uuid="e0eded3f-6c30-47ce-a324-1b63e710e075"/>
+	<concept_reference_map concept_map_id="21" concept_id="4090" concept_reference_term_id="13" concept_map_type_id="2" creator="1" date_created="2004-08-12 00:00:00.0" uuid="ed90a959-6a74-43b7-a01a-4de280421aa6"/>
+	<concept concept_id="4088" retired="false" datatype_id="1" class_id="1" is_set="false" creator="1" date_created="2004-08-12 00:00:00.0" version="0.1" changed_by="1" date_changed="2006-06-09 14:57:33.0" uuid="bb951f1d-efa9-45f4-969a-f05b6a944dd7"/>
+	<concept concept_id="4089" retired="false" datatype_id="1" class_id="1" is_set="false" creator="1" date_created="2004-08-12 00:00:00.0" version="0.1" changed_by="1" date_changed="2006-06-09 14:57:33.0" uuid="a0da2417-59be-47e4-81e7-d89fd5fcb892"/>
+	<concept concept_id="4090" retired="false" datatype_id="1" class_id="1" is_set="false" creator="1" date_created="2004-08-12 00:00:00.0" version="0.1" changed_by="1" date_changed="2006-06-09 14:57:33.0" uuid="a334a29c-0267-474e-8426-df0040b1da57"/>
+	<concept_numeric concept_id="4089" units="" allow_decimal="true"/>
+	<concept_numeric concept_id="4090" units="" allow_decimal="true" hi_absolute="145" low_absolute="70"/>
+	<concept_numeric concept_id="4088" units="" allow_decimal="true"/>
+	<concept_reference_range concept_reference_range_id="30" concept_id="4090" criteria="$patient.getAge() &gt;= 1 &amp;&amp; $patient.getAge() &lt;= 70" hi_absolute="150.0" hi_normal="118.0" hi_critical="130.0" low_normal="80" low_critical="75" low_absolute="70" uuid="239c1904-15ff-45e1-ac9d-d83afb637926"/>
+	<concept_reference_range concept_reference_range_id="31" concept_id="4088" criteria="$patient.getAge() &gt;= 1 &amp;&amp; $patient.getAge() &lt;= 3" hi_absolute="120.0" hi_normal="118.0" low_normal="80" low_absolute="60" uuid="5269e035-c8e6-44d7-af47-7a25a6cf6c60"/>
+	<concept_reference_range concept_reference_range_id="32" concept_id="4089" criteria="$patient.getAge() &gt;= 1 &amp;&amp; $patient.getAge() &lt;= 10" hi_absolute="120.0" hi_normal="118.0" low_normal="80" low_absolute="60" uuid="d8ad3ceb-00a4-4484-a1ff-700f7ac3d10d"/>
+	<concept_reference_range concept_reference_range_id="33" concept_id="4090" criteria="$patient.getAge() &gt;= 1 &amp;&amp; $patient.getAge() &lt;= 50" hi_absolute="140.0" hi_normal="118.0" low_normal="60" low_absolute="60" uuid="3e610133-0105-47db-b32e-a7c4a9838fbe"/>
+	<concept_reference_range concept_reference_range_id="34" concept_id="5089" criteria="$patient.getGender().equals('M') &amp;&amp; $fn.getLatestObs('c607c80f-1ea9-4da3-bb88-6276ce8868dd', $patient).getValueNumeric() == 65.0" hi_absolute="140.0" hi_normal="118.0" low_normal="60.0" low_absolute="60.0" uuid="2c5972e8-aee5-468c-8216-369a1b60723d"/>
 </dataset>
diff --git a/webapp/src/main/webapp/WEB-INF/view/scripts/jquery-ui/js/openmrsSearch.js b/webapp/src/main/webapp/WEB-INF/view/scripts/jquery-ui/js/openmrsSearch.js
index a9ae89ad6899..56fb3b743f5e 100644
--- a/webapp/src/main/webapp/WEB-INF/view/scripts/jquery-ui/js/openmrsSearch.js
+++ b/webapp/src/main/webapp/WEB-INF/view/scripts/jquery-ui/js/openmrsSearch.js
@@ -104,7 +104,8 @@ function OpenmrsSearch(div, showIncludeVoided, searchHandler, selectionHandler,
  *   verboseHandler: function to be called to return the text to display as verbose output
  *   attributes: Array of names for attributes types to display in the list of results
  *   showSearchButton: Boolean, indicating whether to use search button for immediate search
- *   lastSearchParams: Object with properties lastSearchText, includeVoided and includeVerbose, to preserve data with browser back button
+ *   showVerbose: Boolean, indicates whether to check checkbox for verbose 
+ *   includeVoided: Boolean, indicates whether to check checkbox for voided 
  *
  * The styling on this table works like this:
  * <pre>
@@ -194,8 +195,7 @@ function OpenmrsSearch(div, showIncludeVoided, searchHandler, selectionHandler,
             notification = div.find("#searchWidgetNotification");
             loadingMsgObj = div.find("#loadingMsg");
             showSearchButton = o.showSearchButton ? true : false;
-            lastSearchParams = (o.lastSearchParams != null) ? o.lastSearchParams : null;
-
+            
             this._div = div;
 
             lbl.text(o.searchLabel);
@@ -545,30 +545,21 @@ function OpenmrsSearch(div, showIncludeVoided, searchHandler, selectionHandler,
                 }
             });
 
-            // Browser back button support, for preserve data
-            if (lastSearchParams !== null) {
-                $j('#inputNode').val(lastSearchParams.lastSearchText);
-                if (lastSearchParams.includeVoided == 1) {
-                    $j('#includeVoided').attr('checked','checked');
-                }
-                if (lastSearchParams.includeVerbose == 1) {
-                    $j('#includeVerbose').attr('checked','checked');
-                }
-                var keyEvent = jQuery.Event("keyup");
-
-                var codex = 13;
-
-                // Patient search doesn't support for Enter Key. So invoke keyup
-                // event with last character of searched text.
-                if (el.attr('id') === "findPatients") {
-                    var text = $j('#inputNode').val();
-                    codex = $j('#inputNode').val().charCodeAt($j('#inputNode').val().length - 1);
+            //Browser back button support, to preserve data
+            if(typeof(Storage) !== "undefined") {
+            	//check to see if there are parameters to get from sessionStorage
+            	//after setting the fields clear out session storage so it doesn't get used on other pages
+            	 
+                if(sessionStorage.includeVoided){
+                	self.options.includeVoided = true;
+                	sessionStorage.removeItem("includeVoided");
                 }
-
-                keyEvent.keyCode = codex;
-                $j("#inputNode").trigger(keyEvent);
+                if(sessionStorage.includeVerbose){
+                	self.options.showVerbose = true;
+                	sessionStorage.removeItem("includeVerbose");
+                }              
             }
-
+        
             //register an onchange event handler for the length dropdown so that we don't lose
             //the row highlight when the user makes changes to the length
             var selectElement = document.getElementById('openmrsSearchTable_length').getElementsByTagName('select')[0];
@@ -587,11 +578,30 @@ function OpenmrsSearch(div, showIncludeVoided, searchHandler, selectionHandler,
                     self._table.numberOfPages = Math.floor(initialRowCount/self._table.fnSettings()._iDisplayLength)+1;
 
             } else if(self.options.searchPhrase || self.options.doSearchWhenEmpty) {
-                if (self.options.searchPhrase == null) {
-                    self.options.searchPhrase = "";
-                }
-                $j(input).val(self.options.searchPhrase).keyup();
+            	if (self.options.searchPhrase == null) {
+            		self.options.searchPhrase = "";
+            	}                
+            	//check to see if we need to select the checkbox for includeVerbose and/or includeVoided
+            	//since there is a searchPhrase the page will reload using these values
+            	if(self.options.showVerbose){
+            		$j('#includeVerbose').attr('checked','checked');
+            	}
+            	if(self.options.includeVoided){
+            		$j('#includeVoided').attr('checked','checked');
+            	}           	
             }
+            $j(input).val(self.options.searchPhrase).keyup();
+        	//setting the cursor to the end of the searchPhrase
+        	//setSelectionRange is a method of the DOM element not the jQuery object so get the DOM element
+        	var inputNodeDOM = $j('#inputNode').get(0);
+        	inputNodeDOM.focus();
+        	if(inputNodeDOM){
+        		var searchPhraseLength = self.options.searchPhrase ? self.options.searchPhrase.length : 0;
+        		//setSelectionRange is for setting the cursor at the end of the search text
+        		if (inputNodeDOM.setSelectionRange) {
+        			inputNodeDOM.setSelectionRange(searchPhraseLength, searchPhraseLength);
+        		}
+        	}
         },
 
         _makeColumns: function() {
@@ -951,6 +961,16 @@ function OpenmrsSearch(div, showIncludeVoided, searchHandler, selectionHandler,
 
         _doSelected: function(position, rowData) {
             if(this.options.selectionHandler) {
+        		// Check the browser compatibility and, add an entries to sessionStorage
+            	if(typeof(Storage) !== "undefined") {
+        	        sessionStorage.lastSearchText= $j('#inputNode').val();
+        			if($j(verboseCheckBox).is(':checked')) {
+        				sessionStorage.includeVerbose = "checked";
+        			}
+        			if($j(checkBox).is(':checked')) {
+        				sessionStorage.includeVoided = "checked";	
+        			}
+        		}
                 this.options.selectionHandler(position, rowData);
             }
         },
@@ -1188,4 +1208,4 @@ function OpenmrsSearch(div, showIncludeVoided, searchHandler, selectionHandler,
             };
         }
     });
-})(jQuery);
\ No newline at end of file
+})(jQuery);
diff --git a/webapp/src/main/webapp/WEB-INF/view/scripts/jquery/autocomplete/OpenmrsAutoComplete.js b/webapp/src/main/webapp/WEB-INF/view/scripts/jquery/autocomplete/OpenmrsAutoComplete.js
index 4d667ceeeb30..d6fa783a05eb 100644
--- a/webapp/src/main/webapp/WEB-INF/view/scripts/jquery/autocomplete/OpenmrsAutoComplete.js
+++ b/webapp/src/main/webapp/WEB-INF/view/scripts/jquery/autocomplete/OpenmrsAutoComplete.js
@@ -213,8 +213,10 @@ function CreateCallback(options) {
 	// This is what maps each PersonListItem returned object to a name in the dropdown
 	this.displayPerson = function(origQuery) { return function(person) {
 		// dwr methods sometimes put strings into the results, just display those
-		if (typeof person == 'string')
-			return { label: person, value: "" };
+		if (typeof person == 'string'){
+			personEscaped = $j('<div/>').text(person).html();
+			return { label: personEscaped, value: "" };
+		}
 					
 		// item is a PersonListItem object
 		var imageText = "";
@@ -230,11 +232,11 @@ function CreateCallback(options) {
 		var textShown = " ";
 		
 		if (person.identifier)
-			textShown += person.identifier;
+			textShown += $j('<div/>').text(person.identifier).html();
 		
 		textShown += " ";
 		
-		textShown += person.personName;
+		textShown += $j('<div/>').text(person.personName).html();
 
 		// highlight each search term in the results
 		textShown = highlightWords(textShown, origQuery);
@@ -242,6 +244,7 @@ function CreateCallback(options) {
 		var ageText = "";
 		if (person.age) {
 			ageText = " (" + person.age + " " + omsgs.yearsOld + ")";
+			ageText = $j('<div/>').text(ageText).html();
 		}
 		
 		// append the gender image and age AFTER word highlighting so regex doesn't match it
@@ -251,7 +254,9 @@ function CreateCallback(options) {
 		// wrap each result in a span tag (needed?)
 		textShown = "<span class='autocompleteresult'>" + textShown + "</span>";
 		
-		return { label: textShown, value: person.personName, id: person.personId, object: person };
+		personNameEscaped = $j('<div/>').text(person.personName).html();
+		personIdEscaped = $j('<div/>').text(person.personId).html();
+		return { label: textShown, value: personNameEscaped, id: personIdEscaped, object: person };
 	}; }
 	
 	/**
@@ -388,4 +393,4 @@ function CreateCallback(options) {
 		
 		return { label: textShown, value: value, object: item};
 	}; };
-}
+}
\ No newline at end of file

From d22950b7d3a734f5dad657c6675d19196868b205 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 1 Oct 2024 21:31:54 +0300
Subject: [PATCH 130/163] maven(deps-dev): bump org.testcontainers:mysql from
 1.20.1 to 1.20.2 (#4766)

Bumps [org.testcontainers:mysql](https://github.com/testcontainers/testcontainers-java) from 1.20.1 to 1.20.2.
- [Release notes](https://github.com/testcontainers/testcontainers-java/releases)
- [Changelog](https://github.com/testcontainers/testcontainers-java/blob/main/CHANGELOG.md)
- [Commits](https://github.com/testcontainers/testcontainers-java/compare/1.20.1...1.20.2)

---
updated-dependencies:
- dependency-name: org.testcontainers:mysql
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 6d7f12f6681c..b06fa65902ac 100644
--- a/pom.xml
+++ b/pom.xml
@@ -585,7 +585,7 @@
 			<dependency>
 				<groupId>org.testcontainers</groupId>
 				<artifactId>mysql</artifactId>
-				<version>1.20.1</version>
+				<version>1.20.2</version>
 				<scope>test</scope>
 			</dependency>
 			<dependency>

From d4d27eea980a0eb86fd88c41cd3a45805fbe5cf2 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 1 Oct 2024 21:32:29 +0300
Subject: [PATCH 131/163] maven(deps-dev): bump org.testcontainers:postgresql
 (#4767)

Bumps [org.testcontainers:postgresql](https://github.com/testcontainers/testcontainers-java) from 1.20.1 to 1.20.2.
- [Release notes](https://github.com/testcontainers/testcontainers-java/releases)
- [Changelog](https://github.com/testcontainers/testcontainers-java/blob/main/CHANGELOG.md)
- [Commits](https://github.com/testcontainers/testcontainers-java/compare/1.20.1...1.20.2)

---
updated-dependencies:
- dependency-name: org.testcontainers:postgresql
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index b06fa65902ac..52c71b50cc51 100644
--- a/pom.xml
+++ b/pom.xml
@@ -591,7 +591,7 @@
 			<dependency>
 				<groupId>org.testcontainers</groupId>
 				<artifactId>postgresql</artifactId>
-				<version>1.20.1</version>
+				<version>1.20.2</version>
 				<scope>test</scope>
 			</dependency>
 		</dependencies>

From 5df37541c25826acc622556f298a3fa6cbe8f8e4 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 1 Oct 2024 21:33:21 +0300
Subject: [PATCH 132/163] maven(deps): bump
 org.apache.maven.plugins:maven-javadoc-plugin (#4768)

Bumps [org.apache.maven.plugins:maven-javadoc-plugin](https://github.com/apache/maven-javadoc-plugin) from 3.10.0 to 3.10.1.
- [Release notes](https://github.com/apache/maven-javadoc-plugin/releases)
- [Commits](https://github.com/apache/maven-javadoc-plugin/compare/maven-javadoc-plugin-3.10.0...maven-javadoc-plugin-3.10.1)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-javadoc-plugin
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pom.xml b/pom.xml
index 52c71b50cc51..501a627b4624 100644
--- a/pom.xml
+++ b/pom.xml
@@ -730,7 +730,7 @@
 				<plugin>
 					<groupId>org.apache.maven.plugins</groupId>
 					<artifactId>maven-javadoc-plugin</artifactId>
-					<version>3.10.0</version>
+					<version>3.10.1</version>
 					<configuration>
 						<!-- For some reason some packages from org.springframework are being
 						included and causing errors. -->
@@ -1147,7 +1147,7 @@
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-javadoc-plugin</artifactId>
-				<version>3.10.0</version>
+				<version>3.10.1</version>
 				<configuration>
 					<docfilessubdirs>true</docfilessubdirs>
 					<bottom>&lt;em&gt;&lt;small&gt; Generated ${TIMESTAMP} NOTE - these libraries are in active development and subject to change&lt;/small&gt;&lt;/em&gt;</bottom>

From 45cfd84fbe74cc6d7f6ed49c134cfc8e5bf61cc2 Mon Sep 17 00:00:00 2001
From: dkayiwa <dkayiwa@openmrs.org>
Date: Wed, 2 Oct 2024 21:51:57 +0300
Subject: [PATCH 133/163] TRUNK-6259 do not add null proxy privileges

---
 api/src/main/java/org/openmrs/api/context/UserContext.java | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/api/src/main/java/org/openmrs/api/context/UserContext.java b/api/src/main/java/org/openmrs/api/context/UserContext.java
index 983f262f2feb..fd47a5f3cddc 100755
--- a/api/src/main/java/org/openmrs/api/context/UserContext.java
+++ b/api/src/main/java/org/openmrs/api/context/UserContext.java
@@ -238,6 +238,11 @@ public void logout() {
 	 * @param privilege to give to users
 	 */
 	public void addProxyPrivilege(String privilege) {
+		
+		if (privilege == null) {
+			throw new IllegalArgumentException("UserContext.addProxyPrivilege does not accept null privileges");
+		}
+		
 		log.debug("Adding proxy privilege: {}", privilege);
 		
 		proxies.add(privilege);

From 543df8f820205cae03458e7da24a7389309b8458 Mon Sep 17 00:00:00 2001
From: Isaiah Muli <48686606+dicksonmulli@users.noreply.github.com>
Date: Thu, 3 Oct 2024 21:25:01 +0300
Subject: [PATCH 134/163] TRUNK-6245 - Save concept reference ranges in the
 same order as from UI (#4769)

---
 .../main/java/org/openmrs/ConceptNumeric.java |  5 +--
 .../java/org/openmrs/ConceptNumericTest.java  | 32 +++++++++++++++++++
 2 files changed, 35 insertions(+), 2 deletions(-)

diff --git a/api/src/main/java/org/openmrs/ConceptNumeric.java b/api/src/main/java/org/openmrs/ConceptNumeric.java
index d4ec34ae46b6..ae84af36d8de 100644
--- a/api/src/main/java/org/openmrs/ConceptNumeric.java
+++ b/api/src/main/java/org/openmrs/ConceptNumeric.java
@@ -10,6 +10,7 @@
 package org.openmrs;
 
 import java.util.HashSet;
+import java.util.LinkedHashSet;
 import java.util.Set;
 import java.util.TreeSet;
 
@@ -58,7 +59,7 @@ public class ConceptNumeric extends Concept {
 	
 	/** default constructor */
 	public ConceptNumeric() {
-		referenceRanges = new HashSet<>();
+		referenceRanges = new LinkedHashSet<>();
 	}
 	
 	/**
@@ -132,7 +133,7 @@ public ConceptNumeric(Concept c) {
 		this.units = "";
 		this.allowDecimal = false;
 
-		referenceRanges = new HashSet<>();
+		referenceRanges = new LinkedHashSet<>();
 	}
 	
 	// Property accessors
diff --git a/api/src/test/java/org/openmrs/ConceptNumericTest.java b/api/src/test/java/org/openmrs/ConceptNumericTest.java
index 9a2f053f9983..f901c8b4688c 100644
--- a/api/src/test/java/org/openmrs/ConceptNumericTest.java
+++ b/api/src/test/java/org/openmrs/ConceptNumericTest.java
@@ -19,6 +19,9 @@
 import org.openmrs.api.context.Context;
 import org.openmrs.test.jupiter.BaseContextSensitiveTest;
 
+import java.util.ArrayList;
+import java.util.List;
+
 /**
  * Tests the {@link ConceptNumeric} object
  */
@@ -148,4 +151,33 @@ public void shouldRemoveReferenceRangeFromConceptNumeric() {
 		Context.getConceptService().saveConcept(cn);
 		assertEquals(1, Context.getConceptService().getConceptNumeric(22).getReferenceRanges().size());
 	}
+
+	@Test
+	public void shouldMaintainInsertionOrderOfReferenceRangesWithConstructor() {
+		Concept concept = new Concept();
+		concept.setConceptId(1);
+
+		ConceptNumeric conceptNumeric = new ConceptNumeric(concept);
+
+		ConceptReferenceRange referenceRange1 = new ConceptReferenceRange();
+		referenceRange1.setId(1);
+		ConceptReferenceRange referenceRange2 = new ConceptReferenceRange();
+		referenceRange2.setId(2);
+		ConceptReferenceRange referenceRange3 = new ConceptReferenceRange();
+		referenceRange3.setId(3);
+		ConceptReferenceRange referenceRange4 = new ConceptReferenceRange();
+		referenceRange4.setId(4);
+
+		conceptNumeric.addReferenceRange(referenceRange1);
+		conceptNumeric.addReferenceRange(referenceRange2);
+		conceptNumeric.addReferenceRange(referenceRange3);
+		conceptNumeric.addReferenceRange(referenceRange4);
+
+		List<ConceptReferenceRange> referenceRangeList = new ArrayList<>(conceptNumeric.getReferenceRanges());
+
+		assertEquals(1, referenceRangeList.get(0).getId().intValue());
+		assertEquals(2, referenceRangeList.get(1).getId().intValue());
+		assertEquals(3, referenceRangeList.get(2).getId().intValue());
+		assertEquals(4, referenceRangeList.get(3).getId().intValue());
+	}
 }

From 85e45c6530f13db5021cdd041f52363bd8d67603 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 5 Oct 2024 20:22:49 +0300
Subject: [PATCH 135/163] maven(deps): bump junitVersion from 5.11.1 to 5.11.2
 (#4770)

Bumps `junitVersion` from 5.11.1 to 5.11.2.

Updates `org.junit.jupiter:junit-jupiter-api` from 5.11.1 to 5.11.2
- [Release notes](https://github.com/junit-team/junit5/releases)
- [Commits](https://github.com/junit-team/junit5/compare/r5.11.1...r5.11.2)

Updates `org.junit.jupiter:junit-jupiter-engine` from 5.11.1 to 5.11.2
- [Release notes](https://github.com/junit-team/junit5/releases)
- [Commits](https://github.com/junit-team/junit5/compare/r5.11.1...r5.11.2)

Updates `org.junit.jupiter:junit-jupiter-params` from 5.11.1 to 5.11.2
- [Release notes](https://github.com/junit-team/junit5/releases)
- [Commits](https://github.com/junit-team/junit5/compare/r5.11.1...r5.11.2)

Updates `org.junit.vintage:junit-vintage-engine` from 5.11.1 to 5.11.2
- [Release notes](https://github.com/junit-team/junit5/releases)
- [Commits](https://github.com/junit-team/junit5/compare/r5.11.1...r5.11.2)

---
updated-dependencies:
- dependency-name: org.junit.jupiter:junit-jupiter-api
  dependency-type: direct:development
  update-type: version-update:semver-patch
- dependency-name: org.junit.jupiter:junit-jupiter-engine
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: org.junit.jupiter:junit-jupiter-params
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: org.junit.vintage:junit-vintage-engine
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 501a627b4624..c3e4214d21f5 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1217,7 +1217,7 @@
 		<luceneVersion>5.5.5</luceneVersion>
 		<aspectjVersion>1.9.22.1</aspectjVersion>
 		<jacksonVersion>2.18.0</jacksonVersion>
-		<junitVersion>5.11.1</junitVersion>
+		<junitVersion>5.11.2</junitVersion>
 		<mockitoVersion>3.12.4</mockitoVersion>
 		<hamcrestVersion>3.0</hamcrestVersion>
 

From f4f949c514d47326abb2d1b3a52516fcfee01e2f Mon Sep 17 00:00:00 2001
From: Wikum Weerakutti <wikum@linuxdeveloper.space>
Date: Mon, 7 Oct 2024 16:46:20 +0530
Subject: [PATCH 136/163] TRUNK-6267: Making the Mapped Supper Classes
 Auditable (#4773)

---
 api/src/main/java/org/openmrs/BaseCustomizableMetadata.java    | 2 ++
 .../main/java/org/openmrs/BaseFormRecordableOpenmrsData.java   | 2 ++
 api/src/main/java/org/openmrs/BaseOpenmrsData.java             | 2 ++
 api/src/main/java/org/openmrs/BaseOpenmrsMetadata.java         | 2 ++
 api/src/main/java/org/openmrs/BaseOpenmrsObject.java           | 2 ++
 api/src/main/java/org/openmrs/BaseReferenceRange.java          | 3 +++
 api/src/main/java/org/openmrs/attribute/BaseAttribute.java     | 2 ++
 api/src/main/java/org/openmrs/attribute/BaseAttributeType.java | 2 ++
 8 files changed, 17 insertions(+)

diff --git a/api/src/main/java/org/openmrs/BaseCustomizableMetadata.java b/api/src/main/java/org/openmrs/BaseCustomizableMetadata.java
index 1b3d3e0f23ba..673dbfc4600a 100644
--- a/api/src/main/java/org/openmrs/BaseCustomizableMetadata.java
+++ b/api/src/main/java/org/openmrs/BaseCustomizableMetadata.java
@@ -10,6 +10,7 @@
 package org.openmrs;
 
 import org.hibernate.annotations.BatchSize;
+import org.hibernate.envers.Audited;
 import org.openmrs.attribute.Attribute;
 import org.openmrs.customdatatype.CustomValueDescriptor;
 import org.openmrs.customdatatype.Customizable;
@@ -32,6 +33,7 @@
  * @since 1.9
  */
 @MappedSuperclass
+@Audited
 public abstract class BaseCustomizableMetadata<A extends Attribute> extends BaseChangeableOpenmrsMetadata implements Customizable<A> {
 	
 	@OrderBy("voided asc")
diff --git a/api/src/main/java/org/openmrs/BaseFormRecordableOpenmrsData.java b/api/src/main/java/org/openmrs/BaseFormRecordableOpenmrsData.java
index df6fbacacf13..ba6db70caa1f 100644
--- a/api/src/main/java/org/openmrs/BaseFormRecordableOpenmrsData.java
+++ b/api/src/main/java/org/openmrs/BaseFormRecordableOpenmrsData.java
@@ -10,6 +10,7 @@
 package org.openmrs;
 
 import org.apache.commons.lang3.StringUtils;
+import org.hibernate.envers.Audited;
 import org.openmrs.api.APIException;
 
 import javax.persistence.Column;
@@ -21,6 +22,7 @@
  * @since 2.4.0
  */
 @MappedSuperclass
+@Audited
 public abstract class BaseFormRecordableOpenmrsData extends BaseChangeableOpenmrsData implements FormRecordable {
 
 	private static final long serialVersionUID = 1L;
diff --git a/api/src/main/java/org/openmrs/BaseOpenmrsData.java b/api/src/main/java/org/openmrs/BaseOpenmrsData.java
index b154d3c06d9d..c7bdd8530be3 100644
--- a/api/src/main/java/org/openmrs/BaseOpenmrsData.java
+++ b/api/src/main/java/org/openmrs/BaseOpenmrsData.java
@@ -17,6 +17,7 @@
 import javax.persistence.MappedSuperclass;
 
 import org.codehaus.jackson.annotate.JsonIgnore;
+import org.hibernate.envers.Audited;
 import org.hibernate.search.annotations.Field;
 
 /**
@@ -28,6 +29,7 @@
  * @see OpenmrsData
  */
 @MappedSuperclass
+@Audited
 public abstract class BaseOpenmrsData extends BaseOpenmrsObject implements OpenmrsData {
 	
 	//***** Properties *****
diff --git a/api/src/main/java/org/openmrs/BaseOpenmrsMetadata.java b/api/src/main/java/org/openmrs/BaseOpenmrsMetadata.java
index 5b8b40c40b53..664379ecb89e 100644
--- a/api/src/main/java/org/openmrs/BaseOpenmrsMetadata.java
+++ b/api/src/main/java/org/openmrs/BaseOpenmrsMetadata.java
@@ -17,6 +17,7 @@
 import javax.persistence.MappedSuperclass;
 
 import org.codehaus.jackson.annotate.JsonIgnore;
+import org.hibernate.envers.Audited;
 import org.hibernate.search.annotations.Field;
 
 /**
@@ -29,6 +30,7 @@
  * @see OpenmrsMetadata
  */
 @MappedSuperclass
+@Audited
 public abstract class BaseOpenmrsMetadata extends BaseOpenmrsObject implements OpenmrsMetadata {
 	
 	//***** Properties *****
diff --git a/api/src/main/java/org/openmrs/BaseOpenmrsObject.java b/api/src/main/java/org/openmrs/BaseOpenmrsObject.java
index 406169d7c2e3..bb77af4a44b0 100644
--- a/api/src/main/java/org/openmrs/BaseOpenmrsObject.java
+++ b/api/src/main/java/org/openmrs/BaseOpenmrsObject.java
@@ -18,12 +18,14 @@
 import org.apache.commons.lang3.builder.ToStringBuilder;
 import org.apache.commons.lang3.builder.ToStringStyle;
 import org.hibernate.Hibernate;
+import org.hibernate.envers.Audited;
 
 /**
  * This is the base implementation of the {@link OpenmrsObject} interface.<br>
  * It implements the uuid variable that all objects are expected to have.
  */
 @MappedSuperclass
+@Audited
 public abstract class BaseOpenmrsObject implements Serializable, OpenmrsObject {
 	
 	@Column(name = "uuid", unique = true, nullable = false, length = 38, updatable = false)
diff --git a/api/src/main/java/org/openmrs/BaseReferenceRange.java b/api/src/main/java/org/openmrs/BaseReferenceRange.java
index 6fba514e70ed..3911c56c0d0a 100644
--- a/api/src/main/java/org/openmrs/BaseReferenceRange.java
+++ b/api/src/main/java/org/openmrs/BaseReferenceRange.java
@@ -9,6 +9,8 @@
  */
 package org.openmrs;
 
+import org.hibernate.envers.Audited;
+
 import javax.persistence.Column;
 import javax.persistence.MappedSuperclass;
 import java.io.Serializable;
@@ -19,6 +21,7 @@
  * @since 2.7.0
  */
 @MappedSuperclass
+@Audited
 public abstract class BaseReferenceRange extends BaseOpenmrsObject implements Serializable {
 	
 	@Column(name = "hi_absolute")
diff --git a/api/src/main/java/org/openmrs/attribute/BaseAttribute.java b/api/src/main/java/org/openmrs/attribute/BaseAttribute.java
index 39a1f2651eda..2a9b926a6499 100644
--- a/api/src/main/java/org/openmrs/attribute/BaseAttribute.java
+++ b/api/src/main/java/org/openmrs/attribute/BaseAttribute.java
@@ -12,6 +12,7 @@
 import javax.persistence.Column;
 import javax.persistence.MappedSuperclass;
 
+import org.hibernate.envers.Audited;
 import org.hibernate.search.annotations.Field;
 import org.openmrs.BaseChangeableOpenmrsData;
 import org.openmrs.customdatatype.CustomDatatypeUtil;
@@ -29,6 +30,7 @@
  */
 @SuppressWarnings("rawtypes")
 @MappedSuperclass
+@Audited
 public abstract class BaseAttribute<AT extends AttributeType, OwningType extends Customizable<?>> extends BaseChangeableOpenmrsData implements Attribute<AT, OwningType>, Comparable<Attribute> {
 	
 	private OwningType owner;
diff --git a/api/src/main/java/org/openmrs/attribute/BaseAttributeType.java b/api/src/main/java/org/openmrs/attribute/BaseAttributeType.java
index 17edb4c76988..292346fdad98 100644
--- a/api/src/main/java/org/openmrs/attribute/BaseAttributeType.java
+++ b/api/src/main/java/org/openmrs/attribute/BaseAttributeType.java
@@ -12,6 +12,7 @@
 import javax.persistence.Column;
 import javax.persistence.MappedSuperclass;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.BaseChangeableOpenmrsMetadata;
 import org.openmrs.customdatatype.Customizable;
 
@@ -21,6 +22,7 @@
  * @since 1.9
  */
 @MappedSuperclass
+@Audited
 public abstract class BaseAttributeType<OwningType extends Customizable<?>> extends BaseChangeableOpenmrsMetadata implements AttributeType<OwningType> {
 	
 	@Column(name = "min_occurs", nullable = false, length = 11)

From 8d46a47403fbc66852fe447011b3750d196a5257 Mon Sep 17 00:00:00 2001
From: chibongho <cbho@pih.org>
Date: Mon, 7 Oct 2024 07:33:31 -0400
Subject: [PATCH 137/163] TRUNK-6259: fix concurrency issue when checking
 privileges (#4772)

---
 api/src/main/java/org/openmrs/api/context/UserContext.java | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/api/src/main/java/org/openmrs/api/context/UserContext.java b/api/src/main/java/org/openmrs/api/context/UserContext.java
index fd47a5f3cddc..df87b62b01c7 100755
--- a/api/src/main/java/org/openmrs/api/context/UserContext.java
+++ b/api/src/main/java/org/openmrs/api/context/UserContext.java
@@ -11,6 +11,7 @@
 
 import java.io.Serializable;
 import java.util.ArrayList;
+import java.util.Collections;
 import java.util.HashSet;
 import java.util.List;
 import java.util.Locale;
@@ -58,7 +59,7 @@ public class UserContext implements Serializable {
 	/**
 	 * User's permission proxies
 	 */
-	private List<String> proxies = new ArrayList<>();
+	private List<String> proxies = Collections.synchronizedList(new ArrayList<>());
 	
 	/**
 	 * User's locale

From 5b415def0f3b1a40f379b67e6cbee9a32ce7789e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 7 Oct 2024 22:15:40 +0300
Subject: [PATCH 138/163] maven(deps): bump
 org.apache.maven.plugins:maven-surefire-plugin (#4775)

Bumps [org.apache.maven.plugins:maven-surefire-plugin](https://github.com/apache/maven-surefire) from 3.5.0 to 3.5.1.
- [Release notes](https://github.com/apache/maven-surefire/releases)
- [Commits](https://github.com/apache/maven-surefire/compare/surefire-3.5.0...surefire-3.5.1)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-surefire-plugin
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pom.xml b/pom.xml
index c3e4214d21f5..1246e803512d 100644
--- a/pom.xml
+++ b/pom.xml
@@ -603,7 +603,7 @@
 				<plugin>
 					<groupId>org.apache.maven.plugins</groupId>
 					<artifactId>maven-surefire-plugin</artifactId>
-					<version>3.5.0</version>
+					<version>3.5.1</version>
 				</plugin>
 				<plugin>
 					<groupId>org.apache.maven.plugins</groupId>
@@ -935,7 +935,7 @@
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-surefire-plugin</artifactId>
-				<version>3.5.0</version>
+				<version>3.5.1</version>
 				<configuration>
 					<failIfNoTests>false</failIfNoTests>
 					<useSystemClassLoader>false</useSystemClassLoader>

From eb2333a085f4bba0564265a1119c69f4f3520c98 Mon Sep 17 00:00:00 2001
From: Wikum Weerakutti <wikum@linuxdeveloper.space>
Date: Tue, 8 Oct 2024 02:05:48 +0530
Subject: [PATCH 139/163] TRUNK-6270: PatientIdentifierType - Switching from
 Hibernate Mapping to JPA annotations (#4774)

---
 .../java/org/openmrs/BaseOpenmrsMetadata.java |  2 +-
 .../org/openmrs/PatientIdentifierType.java    | 36 ++++++-
 api/src/main/resources/hibernate.cfg.xml      |  1 -
 .../hibernate/PatientIdentifierType.hbm.xml   | 99 -------------------
 .../org/openmrs/api/OrderServiceTest.java     |  2 +
 5 files changed, 35 insertions(+), 105 deletions(-)
 delete mode 100644 api/src/main/resources/org/openmrs/api/db/hibernate/PatientIdentifierType.hbm.xml

diff --git a/api/src/main/java/org/openmrs/BaseOpenmrsMetadata.java b/api/src/main/java/org/openmrs/BaseOpenmrsMetadata.java
index 664379ecb89e..482e34bb3dfb 100644
--- a/api/src/main/java/org/openmrs/BaseOpenmrsMetadata.java
+++ b/api/src/main/java/org/openmrs/BaseOpenmrsMetadata.java
@@ -38,7 +38,7 @@ public abstract class BaseOpenmrsMetadata extends BaseOpenmrsObject implements O
 	@Field
 	private String name;
 	
-	@Column(name = "description", length = 255)
+	@Column(name = "description", columnDefinition = "clob")
 	private String description;
 	
 	@ManyToOne(optional = false)
diff --git a/api/src/main/java/org/openmrs/PatientIdentifierType.java b/api/src/main/java/org/openmrs/PatientIdentifierType.java
index 600530bba2b4..f54e26e12aa9 100644
--- a/api/src/main/java/org/openmrs/PatientIdentifierType.java
+++ b/api/src/main/java/org/openmrs/PatientIdentifierType.java
@@ -10,14 +10,30 @@
 package org.openmrs;
 
 import org.apache.commons.lang3.StringUtils;
+import org.hibernate.annotations.GenericGenerator;
 import org.hibernate.envers.Audited;
 import org.hibernate.search.annotations.DocumentId;
 import org.hibernate.search.annotations.Field;
 
+import javax.persistence.AttributeOverride;
+import javax.persistence.AttributeOverrides;
+import javax.persistence.Column;
+import javax.persistence.Entity;
+import javax.persistence.EnumType;
+import javax.persistence.Enumerated;
+import javax.persistence.GeneratedValue;
+import javax.persistence.Id;
+import javax.persistence.Table;
+
 /**
  * PatientIdentifierType
  */
+@Entity
+@Table(name = "patient_identifier_type")
 @Audited
+@AttributeOverrides({
+	@AttributeOverride(name = "name", column = @Column(name = "name", nullable = false, length = 50))
+})
 public class PatientIdentifierType extends BaseChangeableOpenmrsMetadata {
 	
 	public static final long serialVersionUID = 211231L;
@@ -61,19 +77,31 @@ public enum UniquenessBehavior {
 	
 	// Fields
 	@DocumentId
+	@Id
+	@GeneratedValue(generator = "native")
+	@GenericGenerator(name = "native", strategy = "native")
+	@Column(name = "patient_identifier_type_id")
 	private Integer patientIdentifierTypeId;
-	
+
+	@Column(name = "format")
 	private String format;
 
 	@Field
+	@Column(name = "required", nullable = false)
 	private Boolean required = Boolean.FALSE;
-	
+
+	@Column(name = "format_description", length = 250)
 	private String formatDescription;
 
+	@Column(name = "validator", length = 200)
 	private String validator;
-	
+
+	@Enumerated(EnumType.STRING)
+	@Column(name = "location_behavior", length = 50)
 	private LocationBehavior locationBehavior;
-	
+
+	@Enumerated(EnumType.STRING)
+	@Column(name = "uniqueness_behavior", length = 50)
 	private UniquenessBehavior uniquenessBehavior;
 	
 	/** default constructor */
diff --git a/api/src/main/resources/hibernate.cfg.xml b/api/src/main/resources/hibernate.cfg.xml
index 85402c4b68d6..60ccdf2099b0 100644
--- a/api/src/main/resources/hibernate.cfg.xml
+++ b/api/src/main/resources/hibernate.cfg.xml
@@ -60,7 +60,6 @@
 		<mapping resource="org/openmrs/api/db/hibernate/Role.hbm.xml" />
 		<mapping resource="org/openmrs/api/db/hibernate/Patient.hbm.xml" />
 		<mapping resource="org/openmrs/api/db/hibernate/PatientIdentifier.hbm.xml" />
-		<mapping resource="org/openmrs/api/db/hibernate/PatientIdentifierType.hbm.xml" />
                 <mapping resource="org/openmrs/api/db/hibernate/PatientProgram.hbm.xml" />
                 <mapping resource="org/openmrs/api/db/hibernate/PatientProgramAttribute.hbm.xml" />
 		<mapping resource="org/openmrs/api/db/hibernate/RelationshipType.hbm.xml" />
diff --git a/api/src/main/resources/org/openmrs/api/db/hibernate/PatientIdentifierType.hbm.xml b/api/src/main/resources/org/openmrs/api/db/hibernate/PatientIdentifierType.hbm.xml
deleted file mode 100644
index 611cc5ab3074..000000000000
--- a/api/src/main/resources/org/openmrs/api/db/hibernate/PatientIdentifierType.hbm.xml
+++ /dev/null
@@ -1,99 +0,0 @@
-<?xml version="1.0"?>
-<!--
-
-    This Source Code Form is subject to the terms of the Mozilla Public License,
-    v. 2.0. If a copy of the MPL was not distributed with this file, You can
-    obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
-    the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
-
-    Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
-    graphic logo is a trademark of OpenMRS Inc.
-
--->
-<!DOCTYPE hibernate-mapping PUBLIC
-    "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
-    "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">   
-<hibernate-mapping package="org.openmrs">
-
-<class name="PatientIdentifierType" table="patient_identifier_type">
-
-	<id name="patientIdentifierTypeId" type="java.lang.Integer" column="patient_identifier_type_id"
-        unsaved-value="0">
-		<generator class="native">
-			<param name="sequence">patient_identifier_type_patient_identifier_type_id_seq</param>
-		</generator>
-    </id>
-
-    
-
-		<property name="uuid" type="java.lang.String"
-			column="uuid" length="38" unique="true" />
-
-    <property
-        name="name"
-        type="java.lang.String"
-        not-null="true"
-        length="50"
-    />
-    <property
-        name="description"
-        type="java.lang.String"
-        length="65535"
-    />
-    <property
-        name="format"
-        type="java.lang.String"
-        length="255"
-    />
-
-    <property
-        name="formatDescription"
-        type="java.lang.String"
-        column="format_description"
-        length="250"
-    />
-    
-    <property name="required" type="boolean" not-null="true"/>
-    
-    <property name="validator" type="java.lang.String" column="validator" length="200"/>
-    
-    <property
-        name="dateCreated"
-        type="java.util.Date"
-        column="date_created"
-        not-null="true"
-        length="19"
-    />
-    
-	<property name="locationBehavior" column="location_behavior" length="50">
-		<type name="org.hibernate.type.EnumType">
-			<param name="enumClass">org.openmrs.PatientIdentifierType$LocationBehavior</param>
-			<param name="useNamed">true</param>
-		</type>
-	</property>
-    
-    <property name="uniquenessBehavior" column="uniqueness_behavior" length="50">
-    	<type name="org.hibernate.type.EnumType">
-    		<param name="enumClass">org.openmrs.PatientIdentifierType$UniquenessBehavior</param>
-    		<param name="useNamed">true</param>
-    	</type>
-    </property>
-	
-    <!-- Associations -->
-  
-    <many-to-one name="creator" class="User" not-null="true" />
-    
-    <many-to-one name="retiredBy" class="User" column="retired_by" />
-	<property name="dateRetired" type="java.util.Date"
-			column="date_retired" length="19" />
-	<property name="retireReason" type="java.lang.String"
-			column="retire_reason" length="255" />
-	<property name="retired" type="boolean" column="retired"
-			length="1" not-null="true" />
-
-	<many-to-one name="changedBy" class="org.openmrs.User" column="changed_by"/>
-	<property name="dateChanged" type="java.util.Date"
-			  column="date_changed" length="19"/>
-
-</class>
-</hibernate-mapping>
diff --git a/api/src/test/java/org/openmrs/api/OrderServiceTest.java b/api/src/test/java/org/openmrs/api/OrderServiceTest.java
index 207b7c2cbed0..e47ce608ad47 100644
--- a/api/src/test/java/org/openmrs/api/OrderServiceTest.java
+++ b/api/src/test/java/org/openmrs/api/OrderServiceTest.java
@@ -52,6 +52,7 @@
 import org.openmrs.OrderSet;
 import org.openmrs.OrderType;
 import org.openmrs.Patient;
+import org.openmrs.PatientIdentifierType;
 import org.openmrs.PatientState;
 import org.openmrs.PersonAddress;
 import org.openmrs.PersonAttributeType;
@@ -2733,6 +2734,7 @@ public void saveOrder_shouldFailIfTheJavaTypeOfThePreviousOrderDoesNotMatch() th
 			.addAnnotatedClass(PatientState.class)
 			.addAnnotatedClass(DrugIngredient.class)
 			.addAnnotatedClass(AlertRecipient.class)
+			.addAnnotatedClass(PatientIdentifierType.class)
 			.getMetadataBuilder().build();
 
 

From d7c80a6864620a06b6fecee81cc38ad2e165c9c5 Mon Sep 17 00:00:00 2001
From: Ian <ian.c.bacher@gmail.com>
Date: Tue, 8 Oct 2024 15:37:22 -0400
Subject: [PATCH 140/163] Miscellaneous refactorings

---
 .../openmrs/liquibase/ChangeLogDetective.java | 117 +++++++-----------
 .../liquibase/LiquibaseScopeHandling.java     |   2 +-
 .../java/org/openmrs/module/ModuleUtil.java   |   2 +-
 .../java/org/openmrs/util/LocaleUtility.java  |  54 ++++----
 4 files changed, 77 insertions(+), 98 deletions(-)

diff --git a/api/src/main/java/org/openmrs/liquibase/ChangeLogDetective.java b/api/src/main/java/org/openmrs/liquibase/ChangeLogDetective.java
index f08df226397b..9cf059fe5f5f 100644
--- a/api/src/main/java/org/openmrs/liquibase/ChangeLogDetective.java
+++ b/api/src/main/java/org/openmrs/liquibase/ChangeLogDetective.java
@@ -83,38 +83,16 @@ public String getInitialLiquibaseSnapshotVersion(String context, LiquibaseProvid
 			log.info("looking for un-run change sets in snapshot version '{}'", version);
 			List<String> changeSets = snapshotCombinations.get(version);
 			
-			Liquibase liquibase = null;
-			try {
-				for (String filename : changeSets) {
-					String scopeId = LiquibaseScopeHandling.enterLiquibaseUILoggingService();
-					
-					liquibase = liquibaseProvider.getLiquibase(filename);
-					
-					List<ChangeSet> rawUnrunChangeSets = new StatusCommandStep()
-						.listUnrunChangeSets(new Contexts(context), 
-							new LabelExpression(), liquibase.getDatabaseChangeLog(), liquibase.getDatabase());
-
-					
-					LiquibaseScopeHandling.exitLiquibaseScope(scopeId);
-					liquibase.close();
-					
-					List<ChangeSet> refinedUnrunChangeSets = excludeVintageChangeSets(filename, rawUnrunChangeSets);
-					
-					log.info("file '{}' contains {} un-run change sets", filename, refinedUnrunChangeSets.size());
-					logUnRunChangeSetDetails(filename, refinedUnrunChangeSets);
-					
-					unrunChangeSetsCount += refinedUnrunChangeSets.size();
-				}
-			}
-			finally {
-				if (liquibase != null) {
-					try {
-						liquibase.close();
-					}
-					catch (Exception e) {
-						// ignore exceptions triggered by closing liquibase a second time 
-					}
-				}
+			Contexts contexts = new Contexts(context);
+			for (String filename : changeSets) {
+				List<ChangeSet> rawUnrunChangeSets = getUnrunChangeSets(filename, contexts, liquibaseProvider);
+				
+				List<ChangeSet> refinedUnrunChangeSets = excludeVintageChangeSets(filename, rawUnrunChangeSets);
+				
+				log.info("file '{}' contains {} un-run change sets", filename, refinedUnrunChangeSets.size());
+				logUnRunChangeSetDetails(filename, refinedUnrunChangeSets);
+				
+				unrunChangeSetsCount += refinedUnrunChangeSets.size();
 			}
 			
 			if (unrunChangeSetsCount == 0) {
@@ -146,35 +124,15 @@ public List<String> getUnrunLiquibaseUpdateFileNames(String snapshotVersion, Str
 		List<String> updateVersions = changeLogVersionFinder.getUpdateVersionsGreaterThan(snapshotVersion);
 		List<String> updateFileNames = changeLogVersionFinder.getUpdateFileNames(updateVersions);
 		
-		Liquibase liquibase = null;
-		try {
-			for (String filename : updateFileNames) {
-				String scopeId = LiquibaseScopeHandling.enterLiquibaseUILoggingService();
-				liquibase = liquibaseProvider.getLiquibase(filename);
+		Contexts contexts = new Contexts(context);
+		for (String filename : updateFileNames) {
+			List<ChangeSet> unrunChangeSets = getUnrunChangeSets(filename, contexts, liquibaseProvider);
 
-				List<ChangeSet> unrunChangeSets = new StatusCommandStep()
-					.listUnrunChangeSets(new Contexts(context),
-						new LabelExpression(), liquibase.getDatabaseChangeLog(), liquibase.getDatabase());
-
-				LiquibaseScopeHandling.exitLiquibaseScope(scopeId);
-				liquibase.close();
-				
-				log.info("file '{}' contains {} un-run change sets", filename, unrunChangeSets.size());
-				logUnRunChangeSetDetails(filename, unrunChangeSets);
-				
-				if (!unrunChangeSets.isEmpty()) {
-					unrunLiquibaseUpdates.add(filename);
-				}
-			}
-		}
-		finally {
-			if (liquibase != null) {
-				try {
-					liquibase.close();
-				}
-				catch (Exception e) {
-					// ignore exceptions triggered by closing liquibase a second time 
-				}
+			log.info("file '{}' contains {} un-run change sets", filename, unrunChangeSets.size());
+			logUnRunChangeSetDetails(filename, unrunChangeSets);
+			
+			if (!unrunChangeSets.isEmpty()) {
+				unrunLiquibaseUpdates.add(filename);
 			}
 		}
 		
@@ -183,7 +141,7 @@ public List<String> getUnrunLiquibaseUpdateFileNames(String snapshotVersion, Str
 	
 	List<String> getSnapshotVersionsInDescendingOrder(Map<String, List<String>> snapshotCombinations) {
 		List<String> versions = new ArrayList<>(snapshotCombinations.keySet());
-		Collections.sort(versions, Collections.reverseOrder());
+		versions.sort(Collections.reverseOrder());
 		return versions;
 	}
 	
@@ -197,15 +155,29 @@ List<ChangeSet> excludeVintageChangeSets(String filename, List<ChangeSet> change
 		return result;
 	}
 	
-	boolean isVintageChangeSet(String filename, ChangeSet changeSet) {
-		if (filename != null && filename.contains(LIQUIBASE_CORE_DATA_1_9_X_FILENAME)
-		        && changeSet.getId().equals(DISABLE_FOREIGN_KEY_CHECKS) && changeSet.getAuthor().equals(BEN)) {
-			return true;
+	List<ChangeSet> getUnrunChangeSets(String filename, Contexts context, LiquibaseProvider liquibaseProvider) throws Exception {
+		String scopeId = LiquibaseScopeHandling.enterLiquibaseUILoggingService();
+		Liquibase liquibase = liquibaseProvider.getLiquibase(filename);
+
+		List<ChangeSet> unrunChangeSets;
+		try {
+			unrunChangeSets = new StatusCommandStep()
+				.listUnrunChangeSets(context,
+					new LabelExpression(), liquibase.getDatabaseChangeLog(), liquibase.getDatabase());
+
+		} finally {
+			LiquibaseScopeHandling.exitLiquibaseScope(scopeId);
+			liquibase.close();
 		}
-		if (filename != null && filename.contains(LIQUIBASE_CORE_DATA_1_9_X_FILENAME)
-		        && changeSet.getId().equals(ENABLE_FOREIGN_KEY_CHECKS) && changeSet.getAuthor().equals(BEN)) {
-			return true;
+		
+		return unrunChangeSets;
+	}
+	
+	boolean isVintageChangeSet(String filename, ChangeSet changeSet) {
+		if (filename != null && filename.contains(LIQUIBASE_CORE_DATA_1_9_X_FILENAME) && changeSet.getAuthor().equals(BEN)) {
+			return changeSet.getId().equals(DISABLE_FOREIGN_KEY_CHECKS) || changeSet.getId().equals(ENABLE_FOREIGN_KEY_CHECKS);
 		}
+		
 		return false;
 	}
 	
@@ -218,10 +190,13 @@ boolean isVintageChangeSet(String filename, ChangeSet changeSet) {
 	boolean logUnRunChangeSetDetails(String filename, List<ChangeSet> changeSets) {
 		if (changeSets.size() < MAX_NUMBER_OF_CHANGE_SETS_TO_LOG && (filename.contains(LIQUIBASE_CORE_DATA_1_9_X_FILENAME)
 		        || filename.contains(LIQUIBASE_SCHEMA_ONLY_1_9_X_FILENAME))) {
-			for (ChangeSet changeSet : changeSets) {
-				log.info("file '{}' contains un-run change set with id '{}' by author '{}'", filename, changeSet.getId(),
-				    changeSet.getAuthor());
+			if (log.isInfoEnabled()) {
+				for (ChangeSet changeSet : changeSets) {
+					log.info("file '{}' contains un-run change set with id '{}' by author '{}'", filename, changeSet.getId(),
+						changeSet.getAuthor());
+				}
 			}
+			
 			return true;
 		}
 		return false;
diff --git a/api/src/main/java/org/openmrs/liquibase/LiquibaseScopeHandling.java b/api/src/main/java/org/openmrs/liquibase/LiquibaseScopeHandling.java
index 971cf4c72294..d67249a5f8aa 100644
--- a/api/src/main/java/org/openmrs/liquibase/LiquibaseScopeHandling.java
+++ b/api/src/main/java/org/openmrs/liquibase/LiquibaseScopeHandling.java
@@ -22,7 +22,7 @@ public static String enterLiquibaseUILoggingService() throws Exception {
 		// Temp workaround to silence liquibase writing to stdout - https://github.com/liquibase/liquibase/issues/2396,
 		// https://github.com/liquibase/liquibase/issues/3651
 		LoggerUIService loggerUIService = new LoggerUIService();
-		loggerUIService.setStandardLogLevel(Level.FINE);
+		loggerUIService.setStandardLogLevel(Level.INFO);
 		Map<String, Object> m = Collections.singletonMap(Scope.Attr.ui.name(), loggerUIService);
 		return Scope.enter(m);
 	}
diff --git a/api/src/main/java/org/openmrs/module/ModuleUtil.java b/api/src/main/java/org/openmrs/module/ModuleUtil.java
index 60f5e072e94b..d3b72cf7f442 100644
--- a/api/src/main/java/org/openmrs/module/ModuleUtil.java
+++ b/api/src/main/java/org/openmrs/module/ModuleUtil.java
@@ -71,7 +71,7 @@ public static void startup(Properties props) throws ModuleMustStartException {
 		
 		String moduleListString = props.getProperty(ModuleConstants.RUNTIMEPROPERTY_MODULE_LIST_TO_LOAD);
 		
-		if (moduleListString == null || moduleListString.length() == 0) {
+		if (moduleListString == null || moduleListString.isEmpty()) {
 			// Attempt to get all of the modules from the modules folder
 			// and store them in the modules list
 			log.debug("Starting all modules");
diff --git a/api/src/main/java/org/openmrs/util/LocaleUtility.java b/api/src/main/java/org/openmrs/util/LocaleUtility.java
index 547c1e0384d4..2cff8e531e50 100644
--- a/api/src/main/java/org/openmrs/util/LocaleUtility.java
+++ b/api/src/main/java/org/openmrs/util/LocaleUtility.java
@@ -34,7 +34,7 @@ public class LocaleUtility implements GlobalPropertyListener {
 	 * Cached version of the default locale. This is cached so that we don't have to look it up in
 	 * the global property table every page load
 	 */
-	private static Locale defaultLocaleCache = null;
+	private static volatile Locale defaultLocaleCache = null;
 	
 	/**
 	 * Cached version of the localeAllowedList. This is cached so that we don't have to look it up
@@ -55,36 +55,40 @@ public class LocaleUtility implements GlobalPropertyListener {
 	 */
 	public static Locale getDefaultLocale() {
 		if (defaultLocaleCache == null) {
-			if (Context.isSessionOpen()) {
-				try {
-					String locale = Context.getAdministrationService().getGlobalProperty(
-					    OpenmrsConstants.GLOBAL_PROPERTY_DEFAULT_LOCALE);
-					
-					if (StringUtils.hasLength(locale)) {
+			synchronized (LocaleUtility.class) {
+				if (defaultLocaleCache == null) {
+					if (Context.isSessionOpen()) {
 						try {
-							defaultLocaleCache = fromSpecification(locale);
+							Context.addProxyPrivilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES);
+							String locale = Context.getAdministrationService().getGlobalProperty(
+								OpenmrsConstants.GLOBAL_PROPERTY_DEFAULT_LOCALE);
+
+							if (StringUtils.hasLength(locale)) {
+								try {
+									defaultLocaleCache = fromSpecification(locale);
+								} catch (Exception t) {
+									log.warn("Unable to parse default locale global property value: {}", locale, t);
+								}
+							}
+						} catch (Exception e) {
+							// don't print the full stack-trace by default
+							log.warn("Unable to get locale global property value. {}", e.getMessage());
+							log.debug("Exception caught while capturing locale global property value.", e);
+						} finally {
+							Context.removeProxyPrivilege(PrivilegeConstants.GET_GLOBAL_PROPERTIES);
 						}
-						catch (Exception t) {
-							log.warn("Unable to parse default locale global property value: " + locale, t);
+
+						// if we weren't able to load the locale from the global property,
+						// use the default one
+						if (defaultLocaleCache == null) {
+							defaultLocaleCache = fromSpecification(OpenmrsConstants.GLOBAL_PROPERTY_DEFAULT_LOCALE_DEFAULT_VALUE);
 						}
+					} else {
+						// if session is not open, return the default locale without caching
+						return fromSpecification(OpenmrsConstants.GLOBAL_PROPERTY_DEFAULT_LOCALE_DEFAULT_VALUE);
 					}
 				}
-				catch (Exception e) {
-					// swallow most of the stack trace for most users
-					log.warn("Unable to get locale global property value. " + e.getMessage());
-					log.trace("Unable to get locale global property value", e);
-				}
-				
-				// if we weren't able to load the locale from the global property,
-				// use the default one
-				if (defaultLocaleCache == null) {
-					defaultLocaleCache = fromSpecification(OpenmrsConstants.GLOBAL_PROPERTY_DEFAULT_LOCALE_DEFAULT_VALUE);
-				}
-			} else {
-				// if session is not open, return the default locale without caching
-				return fromSpecification(OpenmrsConstants.GLOBAL_PROPERTY_DEFAULT_LOCALE_DEFAULT_VALUE);
 			}
-			
 		}
 		
 		return defaultLocaleCache;

From 865047f7ba27d81d6ebb36b6b796bbd9af636ef2 Mon Sep 17 00:00:00 2001
From: dkayiwa <dkayiwa@openmrs.org>
Date: Wed, 9 Oct 2024 00:15:40 +0300
Subject: [PATCH 141/163] SQLIntegrityConstraintViolationException: Column
 'class_id' cannot be null

---
 .../org/openmrs/api/db/hibernate/HibernateConceptDAOTest.java    | 1 +
 1 file changed, 1 insertion(+)

diff --git a/api/src/test/java/org/openmrs/api/db/hibernate/HibernateConceptDAOTest.java b/api/src/test/java/org/openmrs/api/db/hibernate/HibernateConceptDAOTest.java
index 239e108fb7c8..62fd26acc662 100644
--- a/api/src/test/java/org/openmrs/api/db/hibernate/HibernateConceptDAOTest.java
+++ b/api/src/test/java/org/openmrs/api/db/hibernate/HibernateConceptDAOTest.java
@@ -256,6 +256,7 @@ public void getConceptReferenceRangesByConceptId_shouldReturnEmptyListForIfNoCon
 		Concept concept = new Concept();
 		concept.addName(new ConceptName("Tuberculosis", Locale.US));
 		concept.setDatatype(conceptDatatype);
+		concept.setConceptClass(new ConceptClass(1));
 		dao.saveConcept(concept);
 
 		//When

From 07cd0715f9820e0a1f0cae11cada4c5ec3a833b3 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 11 Oct 2024 01:13:18 +0300
Subject: [PATCH 142/163] maven(deps): bump net.bytebuddy:byte-buddy-agent from
 1.15.3 to 1.15.4 (#4780)

Bumps [net.bytebuddy:byte-buddy-agent](https://github.com/raphw/byte-buddy) from 1.15.3 to 1.15.4.
- [Release notes](https://github.com/raphw/byte-buddy/releases)
- [Changelog](https://github.com/raphw/byte-buddy/blob/master/release-notes.md)
- [Commits](https://github.com/raphw/byte-buddy/compare/byte-buddy-1.15.3...byte-buddy-1.15.4)

---
updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy-agent
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 1246e803512d..29fbb39fe196 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1134,7 +1134,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy-agent</artifactId>
-						<version>1.15.3</version>
+						<version>1.15.4</version>
 					</dependency>
 				</dependencies>
 			</dependencyManagement>

From 3b76dae82be96f5cb9f7e5574b38b4f1ee6ccddf Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 11 Oct 2024 01:14:01 +0300
Subject: [PATCH 143/163] maven(deps): bump net.bytebuddy:byte-buddy from
 1.15.3 to 1.15.4 (#4781)

Bumps [net.bytebuddy:byte-buddy](https://github.com/raphw/byte-buddy) from 1.15.3 to 1.15.4.
- [Release notes](https://github.com/raphw/byte-buddy/releases)
- [Changelog](https://github.com/raphw/byte-buddy/blob/master/release-notes.md)
- [Commits](https://github.com/raphw/byte-buddy/compare/byte-buddy-1.15.3...byte-buddy-1.15.4)

---
updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 29fbb39fe196..d2d2fcadf502 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1129,7 +1129,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy</artifactId>
-						<version>1.15.3</version>
+						<version>1.15.4</version>
 					</dependency>
 					<dependency>
 						<groupId>net.bytebuddy</groupId>

From 4708c71eb3e0aa3d2b3f83dc28d977703e77fc9d Mon Sep 17 00:00:00 2001
From: Wikum Weerakutti <wikum@linuxdeveloper.space>
Date: Fri, 11 Oct 2024 14:53:04 +0530
Subject: [PATCH 144/163] TRUNK-6273: Switching to MySQL InnoDB engine for
 hbm2ddl (#4783)

---
 api/src/main/resources/hibernate.default.properties | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/api/src/main/resources/hibernate.default.properties b/api/src/main/resources/hibernate.default.properties
index 2984484e89ff..34fc4ac88188 100644
--- a/api/src/main/resources/hibernate.default.properties
+++ b/api/src/main/resources/hibernate.default.properties
@@ -10,7 +10,8 @@ hibernate.connection.url=jdbc:mysql://localhost:3306/openmrs?autoReconnect=true
 hibernate.show_sql=false
 hibernate.format_sql=true
 hibernate.lazy=true
-hibernate.dialect=org.hibernate.dialect.MySQL5Dialect
+hibernate.dialect=org.hibernate.dialect.MySQL57Dialect
+hibernate.dialect.storage_engine=innodb
 
 # Hibernate specific connection pool properties		
 hibernate.c3p0.max_size=50

From ab52929aa84e21237b47139c63b88a25fb234913 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 17 Oct 2024 22:12:04 +0300
Subject: [PATCH 145/163] maven(deps): bump net.bytebuddy:byte-buddy from
 1.15.4 to 1.15.5 (#4788)

Bumps [net.bytebuddy:byte-buddy](https://github.com/raphw/byte-buddy) from 1.15.4 to 1.15.5.
- [Release notes](https://github.com/raphw/byte-buddy/releases)
- [Changelog](https://github.com/raphw/byte-buddy/blob/master/release-notes.md)
- [Commits](https://github.com/raphw/byte-buddy/compare/byte-buddy-1.15.4...byte-buddy-1.15.5)

---
updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index d2d2fcadf502..dbb5d973ded6 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1129,7 +1129,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy</artifactId>
-						<version>1.15.4</version>
+						<version>1.15.5</version>
 					</dependency>
 					<dependency>
 						<groupId>net.bytebuddy</groupId>

From 489168f91edaa1f58b3fb18f8fd2e5f528e022dc Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 17 Oct 2024 22:12:57 +0300
Subject: [PATCH 146/163] maven(deps): bump net.bytebuddy:byte-buddy-agent from
 1.15.4 to 1.15.5 (#4789)

Bumps [net.bytebuddy:byte-buddy-agent](https://github.com/raphw/byte-buddy) from 1.15.4 to 1.15.5.
- [Release notes](https://github.com/raphw/byte-buddy/releases)
- [Changelog](https://github.com/raphw/byte-buddy/blob/master/release-notes.md)
- [Commits](https://github.com/raphw/byte-buddy/compare/byte-buddy-1.15.4...byte-buddy-1.15.5)

---
updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy-agent
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index dbb5d973ded6..684346b14b06 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1134,7 +1134,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy-agent</artifactId>
-						<version>1.15.4</version>
+						<version>1.15.5</version>
 					</dependency>
 				</dependencies>
 			</dependencyManagement>

From 7890cf193f266e1bcbe1e612c654ae79b3e0e371 Mon Sep 17 00:00:00 2001
From: dkayiwa <dkayiwa@openmrs.org>
Date: Mon, 21 Oct 2024 16:33:27 +0300
Subject: [PATCH 147/163] Revert "maven(deps): bump log4jVersion from 2.24.0 to
 2.24.1 (#4764)" (#4790)

This reverts commit b9d853f7230cc8574e483aab03c006fa27b0b37a.
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 684346b14b06..b22d006f8048 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1222,7 +1222,7 @@
 		<hamcrestVersion>3.0</hamcrestVersion>
 
 		<slf4jVersion>1.7.36</slf4jVersion>
-		<log4jVersion>2.24.1</log4jVersion>
+		<log4jVersion>2.24.0</log4jVersion>
 		<owaspCsrfGuardVersion>4.2.1</owaspCsrfGuardVersion>
 
 		<customArgLineForTesting />

From 34f76670406daf3cc4b3fcdd5dd6086d3d3de33a Mon Sep 17 00:00:00 2001
From: dkayiwa <dkayiwa@openmrs.org>
Date: Mon, 21 Oct 2024 16:34:01 +0300
Subject: [PATCH 148/163] Revert "maven(deps): bump log4jVersion from 2.22.1 to
 2.24.0 (#4743)" (#4791)

This reverts commit 1ea43f3f799bbd05a651b1407078793f3b3e6393.
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index b22d006f8048..8d0ce2c6a5ea 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1222,7 +1222,7 @@
 		<hamcrestVersion>3.0</hamcrestVersion>
 
 		<slf4jVersion>1.7.36</slf4jVersion>
-		<log4jVersion>2.24.0</log4jVersion>
+		<log4jVersion>2.22.1</log4jVersion>
 		<owaspCsrfGuardVersion>4.2.1</owaspCsrfGuardVersion>
 
 		<customArgLineForTesting />

From bec5068a756a5151271b9d6fc6720351b3bcf9b7 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 21 Oct 2024 22:12:33 +0300
Subject: [PATCH 149/163] maven(deps): bump junitVersion from 5.11.2 to 5.11.3
 (#4793)

Bumps `junitVersion` from 5.11.2 to 5.11.3.

Updates `org.junit.jupiter:junit-jupiter-api` from 5.11.2 to 5.11.3
- [Release notes](https://github.com/junit-team/junit5/releases)
- [Commits](https://github.com/junit-team/junit5/compare/r5.11.2...r5.11.3)

Updates `org.junit.jupiter:junit-jupiter-engine` from 5.11.2 to 5.11.3
- [Release notes](https://github.com/junit-team/junit5/releases)
- [Commits](https://github.com/junit-team/junit5/compare/r5.11.2...r5.11.3)

Updates `org.junit.jupiter:junit-jupiter-params` from 5.11.2 to 5.11.3
- [Release notes](https://github.com/junit-team/junit5/releases)
- [Commits](https://github.com/junit-team/junit5/compare/r5.11.2...r5.11.3)

Updates `org.junit.vintage:junit-vintage-engine` from 5.11.2 to 5.11.3
- [Release notes](https://github.com/junit-team/junit5/releases)
- [Commits](https://github.com/junit-team/junit5/compare/r5.11.2...r5.11.3)

---
updated-dependencies:
- dependency-name: org.junit.jupiter:junit-jupiter-api
  dependency-type: direct:development
  update-type: version-update:semver-patch
- dependency-name: org.junit.jupiter:junit-jupiter-engine
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: org.junit.jupiter:junit-jupiter-params
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: org.junit.vintage:junit-vintage-engine
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 8d0ce2c6a5ea..51507ede7162 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1217,7 +1217,7 @@
 		<luceneVersion>5.5.5</luceneVersion>
 		<aspectjVersion>1.9.22.1</aspectjVersion>
 		<jacksonVersion>2.18.0</jacksonVersion>
-		<junitVersion>5.11.2</junitVersion>
+		<junitVersion>5.11.3</junitVersion>
 		<mockitoVersion>3.12.4</mockitoVersion>
 		<hamcrestVersion>3.0</hamcrestVersion>
 

From 10a32e1b50f395df74e02b5eb364d90c94dea939 Mon Sep 17 00:00:00 2001
From: Ian <52504170+ibacher@users.noreply.github.com>
Date: Mon, 21 Oct 2024 16:29:15 -0400
Subject: [PATCH 150/163] TRUNK-6275: Follow-on: clear daemonThreadUser when
 thread execution is done (#4794)

---
 api/src/main/java/org/openmrs/api/context/Daemon.java | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/api/src/main/java/org/openmrs/api/context/Daemon.java b/api/src/main/java/org/openmrs/api/context/Daemon.java
index 43908915b67c..16981a782118 100644
--- a/api/src/main/java/org/openmrs/api/context/Daemon.java
+++ b/api/src/main/java/org/openmrs/api/context/Daemon.java
@@ -224,6 +224,7 @@ public void run() {
 						Context.closeSession();
 					} finally {
 						isDaemonThread.remove();
+						daemonThreadUser.remove();
 					}
 				}
 			}
@@ -356,6 +357,7 @@ public void run() {
 						Context.closeSession();
 					} finally {
 						isDaemonThread.remove();
+						daemonThreadUser.remove();
 					}
 				}
 			}
@@ -430,6 +432,7 @@ private static <T> Future<T> runInDaemonThreadInternal(Callable<T> callable) {
 					Context.closeSession();
 				} finally {
 					isDaemonThread.remove();
+					daemonThreadUser.remove();
 				}
 			}
 		});
@@ -453,6 +456,7 @@ private static Future<?> runInDaemonThreadInternal(Runnable runnable) {
 					Context.closeSession();
 				} finally {
 					isDaemonThread.remove();
+					daemonThreadUser.remove();
 				}
 			}
 		});

From 296e3104bbc22669660f3f1e4ac3935f1bab1c1b Mon Sep 17 00:00:00 2001
From: Wikum Weerakutti <wikum@linuxdeveloper.space>
Date: Tue, 22 Oct 2024 19:28:39 +0530
Subject: [PATCH 151/163] TRUNK-6274: Fix Issues with Hibernate Envers Audit
 Table Generation for Specific Tables (#4784)

---
 api/src/main/java/org/openmrs/BaseOpenmrsMetadata.java     | 2 +-
 api/src/main/java/org/openmrs/LocationAttributeType.java   | 5 +++++
 api/src/main/java/org/openmrs/ProviderAttributeType.java   | 5 +++++
 api/src/main/java/org/openmrs/VisitAttributeType.java      | 5 +++++
 .../main/java/org/openmrs/attribute/BaseAttributeType.java | 7 +++++--
 .../api/db/hibernate/DiagnosisAttributeType.hbm.xml        | 2 +-
 .../openmrs/api/db/hibernate/ProgramAttributeType.hbm.xml  | 2 +-
 7 files changed, 23 insertions(+), 5 deletions(-)

diff --git a/api/src/main/java/org/openmrs/BaseOpenmrsMetadata.java b/api/src/main/java/org/openmrs/BaseOpenmrsMetadata.java
index 482e34bb3dfb..664379ecb89e 100644
--- a/api/src/main/java/org/openmrs/BaseOpenmrsMetadata.java
+++ b/api/src/main/java/org/openmrs/BaseOpenmrsMetadata.java
@@ -38,7 +38,7 @@ public abstract class BaseOpenmrsMetadata extends BaseOpenmrsObject implements O
 	@Field
 	private String name;
 	
-	@Column(name = "description", columnDefinition = "clob")
+	@Column(name = "description", length = 255)
 	private String description;
 	
 	@ManyToOne(optional = false)
diff --git a/api/src/main/java/org/openmrs/LocationAttributeType.java b/api/src/main/java/org/openmrs/LocationAttributeType.java
index 1fe43226c635..d5cd04e180b0 100644
--- a/api/src/main/java/org/openmrs/LocationAttributeType.java
+++ b/api/src/main/java/org/openmrs/LocationAttributeType.java
@@ -15,6 +15,8 @@
 import org.openmrs.attribute.AttributeType;
 import org.openmrs.attribute.BaseAttributeType;
 
+import javax.persistence.AttributeOverride;
+import javax.persistence.AttributeOverrides;
 import javax.persistence.Column;
 import javax.persistence.Entity;
 import javax.persistence.GeneratedValue;
@@ -30,6 +32,9 @@
 @Entity
 @Table(name = "location_attribute_type")
 @Audited
+@AttributeOverrides(value = {
+	@AttributeOverride(name = "description", column = @Column(name = "description", length = 1024))
+})
 public class LocationAttributeType extends BaseAttributeType<Location> implements AttributeType<Location> {
 
 	@Id
diff --git a/api/src/main/java/org/openmrs/ProviderAttributeType.java b/api/src/main/java/org/openmrs/ProviderAttributeType.java
index f241621a5255..d2d6f893226b 100644
--- a/api/src/main/java/org/openmrs/ProviderAttributeType.java
+++ b/api/src/main/java/org/openmrs/ProviderAttributeType.java
@@ -13,6 +13,8 @@
 import org.openmrs.attribute.AttributeType;
 import org.openmrs.attribute.BaseAttributeType;
 
+import javax.persistence.AttributeOverride;
+import javax.persistence.AttributeOverrides;
 import javax.persistence.Column;
 import javax.persistence.Entity;
 import javax.persistence.GeneratedValue;
@@ -28,6 +30,9 @@
 @Entity
 @Table(name = "provider_attribute_type")
 @Audited
+@AttributeOverrides(value = {
+	@AttributeOverride(name = "description", column = @Column(name = "description", length = 1024))
+})
 public class ProviderAttributeType extends BaseAttributeType<Provider> implements AttributeType<Provider> {
 
 	@Id
diff --git a/api/src/main/java/org/openmrs/VisitAttributeType.java b/api/src/main/java/org/openmrs/VisitAttributeType.java
index 8d8ca0e44902..db23e4d99f87 100644
--- a/api/src/main/java/org/openmrs/VisitAttributeType.java
+++ b/api/src/main/java/org/openmrs/VisitAttributeType.java
@@ -13,6 +13,8 @@
 import org.openmrs.attribute.AttributeType;
 import org.openmrs.attribute.BaseAttributeType;
 
+import javax.persistence.AttributeOverride;
+import javax.persistence.AttributeOverrides;
 import javax.persistence.Column;
 import javax.persistence.Entity;
 import javax.persistence.GeneratedValue;
@@ -27,6 +29,9 @@
 @Entity
 @Table(name = "visit_attribute_type")
 @Audited
+@AttributeOverrides(value = {
+	@AttributeOverride(name = "description", column = @Column(name = "description", length = 1024))
+})
 public class VisitAttributeType extends BaseAttributeType<Visit> implements AttributeType<Visit> {
 
 	@Id
diff --git a/api/src/main/java/org/openmrs/attribute/BaseAttributeType.java b/api/src/main/java/org/openmrs/attribute/BaseAttributeType.java
index 292346fdad98..06f3af5ea2ea 100644
--- a/api/src/main/java/org/openmrs/attribute/BaseAttributeType.java
+++ b/api/src/main/java/org/openmrs/attribute/BaseAttributeType.java
@@ -10,6 +10,7 @@
 package org.openmrs.attribute;
 
 import javax.persistence.Column;
+import javax.persistence.Lob;
 import javax.persistence.MappedSuperclass;
 
 import org.hibernate.envers.Audited;
@@ -34,13 +35,15 @@ public abstract class BaseAttributeType<OwningType extends Customizable<?>> exte
 	@Column(name = "datatype", length = 255)
 	private String datatypeClassname;
 	
-	@Column(name = "datatype_config", length = 65535)
+	@Column(name = "datatype_config", length = 65535 )
+	@Lob
 	private String datatypeConfig;
 	
 	@Column(name = "preferred_handler", length = 255)
 	private String preferredHandlerClassname;
 	
-	@Column(name = "handler_config", length = 65535)
+	@Column(name = "handler_config", length = 65535 )
+	@Lob
 	private String handlerConfig;
 	
 	/**
diff --git a/api/src/main/resources/org/openmrs/api/db/hibernate/DiagnosisAttributeType.hbm.xml b/api/src/main/resources/org/openmrs/api/db/hibernate/DiagnosisAttributeType.hbm.xml
index c596b8f06ed0..b4a7022919d3 100644
--- a/api/src/main/resources/org/openmrs/api/db/hibernate/DiagnosisAttributeType.hbm.xml
+++ b/api/src/main/resources/org/openmrs/api/db/hibernate/DiagnosisAttributeType.hbm.xml
@@ -26,7 +26,7 @@
 		
 		<property name="name" type="java.lang.String" column="name" not-null="true" length="255" />
 
-		<property name="description" type="java.lang.String" column="description" length="65535" />
+		<property name="description" type="java.lang.String" column="description" length="1024" />
 
 		<property name="datatypeClassname" type="java.lang.String" column="datatype" length="255" />
 
diff --git a/api/src/main/resources/org/openmrs/api/db/hibernate/ProgramAttributeType.hbm.xml b/api/src/main/resources/org/openmrs/api/db/hibernate/ProgramAttributeType.hbm.xml
index 80aa0947ec91..e85f1bb7a95c 100644
--- a/api/src/main/resources/org/openmrs/api/db/hibernate/ProgramAttributeType.hbm.xml
+++ b/api/src/main/resources/org/openmrs/api/db/hibernate/ProgramAttributeType.hbm.xml
@@ -26,7 +26,7 @@
 
         <property name="name" type="java.lang.String" column="name" not-null="true" length="255" />
 
-        <property name="description" type="java.lang.String" column="description" length="65535" />
+        <property name="description" type="java.lang.String" column="description" length="1024" />
 
         <property name="datatypeClassname" type="java.lang.String" column="datatype" length="255" />
 

From fea9d7c1804444f65f2be698cf363b69624e71dd Mon Sep 17 00:00:00 2001
From: Wikum Weerakutti <wikum@linuxdeveloper.space>
Date: Tue, 22 Oct 2024 20:33:22 +0530
Subject: [PATCH 152/163] TRUNK-6275: Adding MySQL and Postgres support to
 ValidateHibernateMappingsDatabaseIT test (#4786)

---
 .../InsertWithUuidDataChangeDatabaseIT.java   |  4 +-
 .../ChangeLogDetectiveDatabaseIT.java         |  4 +-
 .../java/org/openmrs/test/Containers.java     |  4 +-
 .../{H2DatabaseIT.java => DatabaseIT.java}    | 78 +++++++++++++------
 .../util/DatabaseUpdaterDatabaseIT.java       |  4 +-
 .../ValidateHibernateMappingsDatabaseIT.java  |  9 +--
 .../initialization/DatabaseDetectiveIT.java   |  6 +-
 7 files changed, 69 insertions(+), 40 deletions(-)
 rename api/src/test/java/org/openmrs/util/{H2DatabaseIT.java => DatabaseIT.java} (54%)

diff --git a/api/src/test/java/liquibase/ext/change/core/InsertWithUuidDataChangeDatabaseIT.java b/api/src/test/java/liquibase/ext/change/core/InsertWithUuidDataChangeDatabaseIT.java
index c7aa60cb16e4..b31fb9ced09e 100644
--- a/api/src/test/java/liquibase/ext/change/core/InsertWithUuidDataChangeDatabaseIT.java
+++ b/api/src/test/java/liquibase/ext/change/core/InsertWithUuidDataChangeDatabaseIT.java
@@ -22,9 +22,9 @@
 import java.util.UUID;
 
 import org.junit.jupiter.api.Test;
-import org.openmrs.util.H2DatabaseIT;
+import org.openmrs.util.DatabaseIT;
 
-public class InsertWithUuidDataChangeDatabaseIT extends H2DatabaseIT {
+public class InsertWithUuidDataChangeDatabaseIT extends DatabaseIT {
 	
 	@Test
 	public void shouldInsertUuids() throws Exception {
diff --git a/api/src/test/java/org/openmrs/liquibase/ChangeLogDetectiveDatabaseIT.java b/api/src/test/java/org/openmrs/liquibase/ChangeLogDetectiveDatabaseIT.java
index 2c03409539ab..911b5350aeeb 100644
--- a/api/src/test/java/org/openmrs/liquibase/ChangeLogDetectiveDatabaseIT.java
+++ b/api/src/test/java/org/openmrs/liquibase/ChangeLogDetectiveDatabaseIT.java
@@ -12,13 +12,13 @@
 import java.util.List;
 import java.util.Map;
 import org.junit.jupiter.api.Test;
-import org.openmrs.util.H2DatabaseIT;
+import org.openmrs.util.DatabaseIT;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
 
-public class ChangeLogDetectiveDatabaseIT extends H2DatabaseIT {
+public class ChangeLogDetectiveDatabaseIT extends DatabaseIT {
 	
 	private static final Logger log = LoggerFactory.getLogger(ChangeLogDetectiveDatabaseIT.class);
 
diff --git a/api/src/test/java/org/openmrs/test/Containers.java b/api/src/test/java/org/openmrs/test/Containers.java
index 679e3aa2e612..c34bb2e3955f 100644
--- a/api/src/test/java/org/openmrs/test/Containers.java
+++ b/api/src/test/java/org/openmrs/test/Containers.java
@@ -42,6 +42,7 @@ public static void ensureDatabaseRunning() {
 		}
 	}
 	
+	
     private static void ensureMySQLRunning() {
     	
         if (mysql == null) {
@@ -69,6 +70,7 @@ private static void ensureMySQLRunning() {
     		System.setProperty("databasePassword", PASSWORD);
     		System.setProperty("databaseDriver", mysql.getDriverClassName());
     		System.setProperty("databaseDialect", MySQLDialect.class.getName());
+			System.setProperty("database", "mysql");
     		
     		createSchema();
         }
@@ -95,7 +97,7 @@ private static void ensurePostgreSQLRunning() {
     		System.setProperty("databasePassword", PASSWORD);
     		System.setProperty("databaseDriver", postgres.getDriverClassName());
     		System.setProperty("databaseDialect", PostgreSQL82Dialect.class.getName());
-    		
+			
     		createSchema();
         }
     }
diff --git a/api/src/test/java/org/openmrs/util/H2DatabaseIT.java b/api/src/test/java/org/openmrs/util/DatabaseIT.java
similarity index 54%
rename from api/src/test/java/org/openmrs/util/H2DatabaseIT.java
rename to api/src/test/java/org/openmrs/util/DatabaseIT.java
index 61e2a575e869..37d2bc0b165a 100644
--- a/api/src/test/java/org/openmrs/util/H2DatabaseIT.java
+++ b/api/src/test/java/org/openmrs/util/DatabaseIT.java
@@ -26,20 +26,22 @@
 import org.junit.jupiter.api.AfterEach;
 import org.junit.jupiter.api.BeforeEach;
 import org.openmrs.liquibase.LiquibaseProvider;
+import org.openmrs.test.Containers;
+import org.openmrs.util.databasechange.H2LessStrictDialect;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
-public class H2DatabaseIT implements LiquibaseProvider {
+public class DatabaseIT implements LiquibaseProvider {
 	
-	private static final Logger log = LoggerFactory.getLogger(H2DatabaseIT.class);
-	
-	public static final String CONNECTION_URL = "jdbc:h2:mem:openmrs;DB_CLOSE_DELAY=-1";
+	private static final Logger log = LoggerFactory.getLogger(DatabaseIT.class);
+
+	public static String CONNECTION_URL = "jdbc:h2:mem:test;DB_CLOSE_DELAY=-1";
 	
 	private static final String CONTEXT = "some context";
 	
-	protected static final String USER_NAME = "another_user";
+	protected static final String USER_NAME = "test";
 	
-	protected static final String PASSWORD = "another_password";
+	protected static final String PASSWORD = "test";
 	
 	@BeforeEach
 	public void setup() throws SQLException, ClassNotFoundException {
@@ -55,40 +57,62 @@ public Liquibase getLiquibase(String filename) throws LiquibaseException, SQLExc
 		Database liquibaseConnection = DatabaseFactory.getInstance()
 		        .findCorrectDatabaseImplementation(new JdbcConnection(getConnection()));
 		
-		liquibaseConnection.setDatabaseChangeLogTableName("LIQUIBASECHANGELOG");
-		liquibaseConnection.setDatabaseChangeLogLockTableName("LIQUIBASECHANGELOGLOCK");
+		liquibaseConnection.setDatabaseChangeLogTableName("liquibasechangelog");
+		liquibaseConnection.setDatabaseChangeLogLockTableName("liquibasechangeloglock");
 		
 		return new Liquibase(filename, new ClassLoaderResourceAccessor(getClass().getClassLoader()), liquibaseConnection);
 	}
 	
-	protected void initializeDatabase() throws SQLException, ClassNotFoundException {
-		String driver = "org.h2.Driver";
-		Class.forName(driver);
+	protected void initializeDatabase() throws ClassNotFoundException {
+		if (!useInMemoryDatabase()) {
+			setupContainerDB();
+		} else {
+			System.setProperty("databaseDialect", H2LessStrictDialect.class.getName());
+		}
 	}
-	
+
+	private void setupContainerDB() throws ClassNotFoundException {
+		Containers.ensureDatabaseRunning();
+		CONNECTION_URL = System.getProperty("databaseUrl");
+	}
+
 	protected void updateDatabase(String filename) throws Exception {
 		Liquibase liquibase = getLiquibase(filename);
 		liquibase.update(new Contexts(CONTEXT));
 		liquibase.getDatabase().getConnection().commit();
 	}
-	
+
 	protected void dropAllDatabaseObjects() throws SQLException {
-		Connection connection = getConnection();
-		Statement statement = null;
-		try {
-			statement = connection.createStatement();
-			String query = "DROP ALL OBJECTS";
-			statement.execute(query);
-		}
-		catch (JdbcSQLNonTransientException e) {
+		try (Connection connection = getConnection()) {
+			Statement statement = connection.createStatement();
+			if (useInMemoryDatabase()) {
+				String query = "DROP ALL OBJECTS";
+				statement.execute(query);
+			} else {
+				if ("postgres".equalsIgnoreCase(System.getProperty("database"))) {
+					connection.setAutoCommit(true);
+					String dropTables =
+						"DO $$ DECLARE " +
+							"    r RECORD; " +
+							"BEGIN " +
+							"    FOR r IN (SELECT tablename FROM pg_tables WHERE schemaname = 'public') " +
+							"    LOOP " +
+							"        EXECUTE 'DROP TABLE IF EXISTS ' || quote_ident(r.tablename) || ' CASCADE'; " +
+							"    END LOOP; " +
+							"END $$;";
+					statement.execute(dropTables);
+					connection.setAutoCommit(false);
+				} else if ("mysql".equalsIgnoreCase(System.getProperty("database"))) {
+					statement.execute("DROP DATABASE " + System.getProperty("databaseName") + ";");
+					statement.execute("CREATE DATABASE " + System.getProperty("databaseName") + ";");
+				}
+			}
+		} catch (JdbcSQLNonTransientException e) {
 			log.error("connection is already closed, most likely a test method already dropped all database objects");
 		}
-		finally {
-			connection.close();
-		}
 	}
 
-	protected void updateDatabase( List<String> filenames) throws Exception {
+	protected void updateDatabase(List<String> filenames) throws Exception {
 		log.info("liquibase files used for creating and updating the OpenMRS database are: " + filenames);
 
 		for (String filename : filenames) {
@@ -102,4 +126,8 @@ protected Connection getConnection() throws SQLException {
 		connection.setAutoCommit( false );
 		return connection;
 	}
+	
+	private Boolean useInMemoryDatabase() {
+		return !"false".equalsIgnoreCase(System.getProperty("useInMemoryDatabase"));
+	}
 }
diff --git a/api/src/test/java/org/openmrs/util/DatabaseUpdaterDatabaseIT.java b/api/src/test/java/org/openmrs/util/DatabaseUpdaterDatabaseIT.java
index 6ced47ee1cfe..fb7616ac9cdc 100644
--- a/api/src/test/java/org/openmrs/util/DatabaseUpdaterDatabaseIT.java
+++ b/api/src/test/java/org/openmrs/util/DatabaseUpdaterDatabaseIT.java
@@ -19,7 +19,7 @@
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
 
-public class DatabaseUpdaterDatabaseIT extends H2DatabaseIT {
+public class DatabaseUpdaterDatabaseIT extends DatabaseIT {
 	
 	private static final String VERSION_2_1_X = "2.1.x";
 	
@@ -35,7 +35,7 @@ public class DatabaseUpdaterDatabaseIT extends H2DatabaseIT {
 	private static final int CHANGE_SET_COUNT_FOR_2_1_X = 870;
 
 	@BeforeEach
-	public void setup() {
+	public void setup() throws ClassNotFoundException {
 		DatabaseUpdater.setLiquibaseProvider(this);
 	}
 	
diff --git a/api/src/test/java/org/openmrs/util/databasechange/ValidateHibernateMappingsDatabaseIT.java b/api/src/test/java/org/openmrs/util/databasechange/ValidateHibernateMappingsDatabaseIT.java
index 453e5c614edf..d2eec70e9c61 100644
--- a/api/src/test/java/org/openmrs/util/databasechange/ValidateHibernateMappingsDatabaseIT.java
+++ b/api/src/test/java/org/openmrs/util/databasechange/ValidateHibernateMappingsDatabaseIT.java
@@ -21,7 +21,7 @@
 import org.openmrs.api.OrderServiceTest;
 import org.openmrs.api.db.hibernate.envers.OpenmrsRevisionEntity;
 import org.openmrs.liquibase.ChangeLogVersionFinder;
-import org.openmrs.util.H2DatabaseIT;
+import org.openmrs.util.DatabaseIT;
 import org.openmrs.util.OpenmrsClassScanner;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -29,7 +29,7 @@
 /**
  * Validates Hibernate mapping files.
  */
-public class ValidateHibernateMappingsDatabaseIT extends H2DatabaseIT {
+public class ValidateHibernateMappingsDatabaseIT extends DatabaseIT {
 	
 	private static final Logger log = LoggerFactory.getLogger(ValidateHibernateMappingsDatabaseIT.class);
 	
@@ -87,9 +87,8 @@ private SessionFactory buildSessionFactory() {
 		for (Class<?> clazz : entityClasses) {
 			configuration.addAnnotatedClass(clazz);
 		}
-		configuration.setProperty(Environment.DIALECT, H2LessStrictDialect.class.getName());
-		configuration.setProperty(Environment.URL, "jdbc:h2:mem:openmrs;AUTO_RECONNECT=TRUE;DB_CLOSE_DELAY=-1");
-		configuration.setProperty(Environment.DRIVER, "com.mysql.cj.jdbc.Driver");
+		configuration.setProperty(Environment.DIALECT, System.getProperty("databaseDialect"));
+		configuration.setProperty(Environment.URL, CONNECTION_URL);
 		configuration.setProperty(Environment.USER, USER_NAME);
 		configuration.setProperty(Environment.PASS, PASSWORD);
 		configuration.setProperty(Environment.USE_SECOND_LEVEL_CACHE, "false");
diff --git a/web/src/test/java/org/openmrs/web/filter/initialization/DatabaseDetectiveIT.java b/web/src/test/java/org/openmrs/web/filter/initialization/DatabaseDetectiveIT.java
index 9102f8b8b27a..82c763d5c1af 100644
--- a/web/src/test/java/org/openmrs/web/filter/initialization/DatabaseDetectiveIT.java
+++ b/web/src/test/java/org/openmrs/web/filter/initialization/DatabaseDetectiveIT.java
@@ -12,12 +12,12 @@
 import java.util.Properties;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
-import org.openmrs.util.H2DatabaseIT;
+import org.openmrs.util.DatabaseIT;
 
 import static junit.framework.TestCase.assertTrue;
 import static org.junit.jupiter.api.Assertions.assertFalse;
 
-public class DatabaseDetectiveIT extends H2DatabaseIT {
+public class DatabaseDetectiveIT extends DatabaseIT {
 	
 	private static final String LIQUIBASE_SCHEMA_ONLY_1_9_X = "org/openmrs/liquibase/snapshots/schema-only/liquibase-schema-only-1.9.x.xml";
 
@@ -28,7 +28,7 @@ public class DatabaseDetectiveIT extends H2DatabaseIT {
 	private Properties properties;
 	
 	@BeforeEach
-	public void setup() {
+	public void setup() throws ClassNotFoundException {
 		databaseDetective = new DatabaseDetective();
 
 		properties = new Properties();

From 09aa12cb6c7269fd8ed7183b8bb03e125421f6f8 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Oct 2024 23:08:15 +0300
Subject: [PATCH 153/163] maven(deps-dev): bump org.testcontainers:postgresql
 (#4796)

Bumps [org.testcontainers:postgresql](https://github.com/testcontainers/testcontainers-java) from 1.20.2 to 1.20.3.
- [Release notes](https://github.com/testcontainers/testcontainers-java/releases)
- [Changelog](https://github.com/testcontainers/testcontainers-java/blob/main/CHANGELOG.md)
- [Commits](https://github.com/testcontainers/testcontainers-java/compare/1.20.2...1.20.3)

---
updated-dependencies:
- dependency-name: org.testcontainers:postgresql
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 51507ede7162..f7f55c6d603b 100644
--- a/pom.xml
+++ b/pom.xml
@@ -591,7 +591,7 @@
 			<dependency>
 				<groupId>org.testcontainers</groupId>
 				<artifactId>postgresql</artifactId>
-				<version>1.20.2</version>
+				<version>1.20.3</version>
 				<scope>test</scope>
 			</dependency>
 		</dependencies>

From 86077dab56604d3df9276a89b07692f2f40b6a06 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Oct 2024 23:08:38 +0300
Subject: [PATCH 154/163] maven(deps-dev): bump org.testcontainers:mysql from
 1.20.2 to 1.20.3 (#4799)

Bumps [org.testcontainers:mysql](https://github.com/testcontainers/testcontainers-java) from 1.20.2 to 1.20.3.
- [Release notes](https://github.com/testcontainers/testcontainers-java/releases)
- [Changelog](https://github.com/testcontainers/testcontainers-java/blob/main/CHANGELOG.md)
- [Commits](https://github.com/testcontainers/testcontainers-java/compare/1.20.2...1.20.3)

---
updated-dependencies:
- dependency-name: org.testcontainers:mysql
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index f7f55c6d603b..697f283993de 100644
--- a/pom.xml
+++ b/pom.xml
@@ -585,7 +585,7 @@
 			<dependency>
 				<groupId>org.testcontainers</groupId>
 				<artifactId>mysql</artifactId>
-				<version>1.20.2</version>
+				<version>1.20.3</version>
 				<scope>test</scope>
 			</dependency>
 			<dependency>

From 43692bc32dc9995ee3a83fb9f5f50535eda9c9d2 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Oct 2024 23:09:54 +0300
Subject: [PATCH 155/163] maven(deps): bump net.bytebuddy:byte-buddy-agent from
 1.15.5 to 1.15.7 (#4798)

Bumps [net.bytebuddy:byte-buddy-agent](https://github.com/raphw/byte-buddy) from 1.15.5 to 1.15.7.
- [Release notes](https://github.com/raphw/byte-buddy/releases)
- [Changelog](https://github.com/raphw/byte-buddy/blob/master/release-notes.md)
- [Commits](https://github.com/raphw/byte-buddy/compare/byte-buddy-1.15.5...byte-buddy-1.15.7)

---
updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy-agent
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 697f283993de..a62110107b76 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1134,7 +1134,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy-agent</artifactId>
-						<version>1.15.5</version>
+						<version>1.15.7</version>
 					</dependency>
 				</dependencies>
 			</dependencyManagement>

From 214c45a3166cecad6021577472a508f02d8f2e91 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 24 Oct 2024 00:27:23 +0300
Subject: [PATCH 156/163] maven(deps): bump net.bytebuddy:byte-buddy from
 1.15.5 to 1.15.7 (#4797)

Bumps [net.bytebuddy:byte-buddy](https://github.com/raphw/byte-buddy) from 1.15.5 to 1.15.7.
- [Release notes](https://github.com/raphw/byte-buddy/releases)
- [Changelog](https://github.com/raphw/byte-buddy/blob/master/release-notes.md)
- [Commits](https://github.com/raphw/byte-buddy/compare/byte-buddy-1.15.5...byte-buddy-1.15.7)

---
updated-dependencies:
- dependency-name: net.bytebuddy:byte-buddy
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index a62110107b76..9f14e0c9b6d4 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1129,7 +1129,7 @@
 					<dependency>
 						<groupId>net.bytebuddy</groupId>
 						<artifactId>byte-buddy</artifactId>
-						<version>1.15.5</version>
+						<version>1.15.7</version>
 					</dependency>
 					<dependency>
 						<groupId>net.bytebuddy</groupId>

From a2064a242602942212f75608bfec5b968cebf627 Mon Sep 17 00:00:00 2001
From: Wikum Weerakutti <wikum@linuxdeveloper.space>
Date: Fri, 25 Oct 2024 00:43:12 +0530
Subject: [PATCH 157/163] TRUNK-6277: Migrate HL7InError from Hibernate Mapping
 XML to JPA annotatoions. (#4795)

---
 .../main/java/org/openmrs/hl7/HL7InError.java | 29 +++++++++--
 .../java/org/openmrs/hl7/HL7QueueItem.java    | 19 ++++++-
 .../hl7/db/hibernate/HibernateHL7DAO.java     |  2 +-
 api/src/main/resources/hibernate.cfg.xml      |  1 -
 .../hl7/db/hibernate/HL7InError.hbm.xml       | 51 -------------------
 .../org/openmrs/api/OrderServiceTest.java     |  2 +
 6 files changed, 46 insertions(+), 58 deletions(-)
 delete mode 100644 api/src/main/resources/org/openmrs/hl7/db/hibernate/HL7InError.hbm.xml

diff --git a/api/src/main/java/org/openmrs/hl7/HL7InError.java b/api/src/main/java/org/openmrs/hl7/HL7InError.java
index a2eb90dfdaca..e2c64f83e564 100644
--- a/api/src/main/java/org/openmrs/hl7/HL7InError.java
+++ b/api/src/main/java/org/openmrs/hl7/HL7InError.java
@@ -9,24 +9,47 @@
  */
 package org.openmrs.hl7;
 
+import org.hibernate.annotations.GenericGenerator;
+import org.hibernate.annotations.Parameter;
 import org.hibernate.envers.Audited;
 import org.openmrs.api.APIException;
 
+import javax.persistence.Column;
+import javax.persistence.Entity;
+import javax.persistence.GeneratedValue;
+import javax.persistence.GenerationType;
+import javax.persistence.Id;
+import javax.persistence.Lob;
+import javax.persistence.Table;
+
 /**
- * Represents a error in processing an hl7 message.
+ * Represents an error in processing an hl7 message.
  *
  * @see HL7InQueue
  * @see HL7Service
  */
+@Entity
+@Table(name = "hl7_in_error")
 @Audited
 public class HL7InError extends HL7QueueItem {
 	
 	private static final int MAX_ERROR_DETAILS_LENGTH = 16777215;
-	
+
+	@Id
+	@GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "hl7_in_error_id_seq")
+	@GenericGenerator(
+		name = "hl7_in_error_id_seq",
+		strategy = "native",
+		parameters = @Parameter(name = "sequence", value = "hl7_in_error_hl7_in_error_id_seq")
+	)
+	@Column(name = "hl7_in_error_id", nullable = false)
 	private Integer hl7InErrorId;
-	
+
+	@Column(name = "error", nullable = false)
 	private String error;
 	
+	@Column(name = "error_details", columnDefinition = "mediumtext")
+	@Lob
 	private String errorDetails;
 	
 	/**
diff --git a/api/src/main/java/org/openmrs/hl7/HL7QueueItem.java b/api/src/main/java/org/openmrs/hl7/HL7QueueItem.java
index 4b20ac210026..087bf00451f0 100644
--- a/api/src/main/java/org/openmrs/hl7/HL7QueueItem.java
+++ b/api/src/main/java/org/openmrs/hl7/HL7QueueItem.java
@@ -11,8 +11,15 @@
 
 import java.util.Date;
 
+import org.hibernate.envers.Audited;
 import org.openmrs.BaseOpenmrsObject;
 
+import javax.persistence.Column;
+import javax.persistence.JoinColumn;
+import javax.persistence.Lob;
+import javax.persistence.ManyToOne;
+import javax.persistence.MappedSuperclass;
+
 /**
  * Common representation of {@link HL7InQueue}, {@link HL7InArchive} and {@link HL7InError}.
  * 
@@ -21,14 +28,22 @@
  * @see HL7InArchive
  * @see HL7InError
  */
+@MappedSuperclass
+@Audited
 public abstract class HL7QueueItem extends BaseOpenmrsObject {
-	
+
+	@ManyToOne(optional = false)
+	@JoinColumn(name = "hl7_source")
 	private HL7Source hl7Source;
 	
+	@Column(name = "hl7_source_key", length = 1024)
 	private String hl7SourceKey;
 	
+	@Column(name = "hl7_data", nullable = false,  columnDefinition = "text")
+	@Lob
 	private String hl7Data;
-	
+
+	@Column(name = "date_created", nullable = false, length = 19)
 	private Date dateCreated;
 	
 	/**
diff --git a/api/src/main/java/org/openmrs/hl7/db/hibernate/HibernateHL7DAO.java b/api/src/main/java/org/openmrs/hl7/db/hibernate/HibernateHL7DAO.java
index f3a99fa6f2a5..efffad372d9d 100644
--- a/api/src/main/java/org/openmrs/hl7/db/hibernate/HibernateHL7DAO.java
+++ b/api/src/main/java/org/openmrs/hl7/db/hibernate/HibernateHL7DAO.java
@@ -348,7 +348,7 @@ public HL7InError getHL7InErrorByUuid(String uuid) throws DAOException {
 	@Override
 	@SuppressWarnings("unchecked")
 	public List<HL7InError> getAllHL7InErrors() throws DAOException {
-		return sessionFactory.getCurrentSession().createQuery("from HL7InError order by HL7InErrorId").list();
+		return sessionFactory.getCurrentSession().createQuery("from HL7InError order by hl7InErrorId").list();
 	}
 	
 	/**
diff --git a/api/src/main/resources/hibernate.cfg.xml b/api/src/main/resources/hibernate.cfg.xml
index 60ccdf2099b0..8bcc951d75b0 100644
--- a/api/src/main/resources/hibernate.cfg.xml
+++ b/api/src/main/resources/hibernate.cfg.xml
@@ -92,7 +92,6 @@
 		<mapping resource="org/openmrs/hl7/db/hibernate/HL7Source.hbm.xml" />
 		<mapping resource="org/openmrs/hl7/db/hibernate/HL7InQueue.hbm.xml" />
 		<mapping resource="org/openmrs/hl7/db/hibernate/HL7InArchive.hbm.xml" />
-		<mapping resource="org/openmrs/hl7/db/hibernate/HL7InError.hbm.xml" />
 		
 		<!-- Notification -->
 		<mapping resource="org/openmrs/notification/db/hibernate/Template.hbm.xml" />
diff --git a/api/src/main/resources/org/openmrs/hl7/db/hibernate/HL7InError.hbm.xml b/api/src/main/resources/org/openmrs/hl7/db/hibernate/HL7InError.hbm.xml
deleted file mode 100644
index 194a2b470174..000000000000
--- a/api/src/main/resources/org/openmrs/hl7/db/hibernate/HL7InError.hbm.xml
+++ /dev/null
@@ -1,51 +0,0 @@
-<?xml version="1.0"?>
-<!--
-
-    This Source Code Form is subject to the terms of the Mozilla Public License,
-    v. 2.0. If a copy of the MPL was not distributed with this file, You can
-    obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
-    the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
-
-    Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
-    graphic logo is a trademark of OpenMRS Inc.
-
--->
-<!DOCTYPE hibernate-mapping PUBLIC
-    "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
-    "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">
-<hibernate-mapping package="org.openmrs">
-
-	<class name="org.openmrs.hl7.HL7InError" table="hl7_in_error">
-
-		<id name="HL7InErrorId" type="int" column="hl7_in_error_id" unsaved-value="0">
-			<generator class="native">
-				<param name="sequence">hl7_in_error_hl7_in_error_id_seq</param>
-			</generator>
-		</id>
-
-		<discriminator column="hl7_in_error_id" insert="false" />
-		
-		<many-to-one name="HL7Source" class="org.openmrs.hl7.HL7Source" not-null="true">
-			<column name="hl7_source" />
-		</many-to-one>
-		
-		<property name="HL7SourceKey" type="java.lang.String" 
-			column="hl7_source_key" not-null="false" length="1024" />
-			
-		<property name="HL7Data" type="java.lang.String" 
-			column="hl7_data" not-null="true" length="16777215" />
-			
-		<property name="error" type="java.lang.String" length="255"
-			column="error" />
-
-		<property name="errorDetails" type="java.lang.String" length="16777215"
-			column="error_details" />
-
-		<property name="dateCreated" type="java.util.Date" 
-			column="date_created" not-null="true" length="19" />
-		
-		<property name="uuid" type="java.lang.String"
-			column="uuid" length="38" unique="true" />
-			
-	</class>
-</hibernate-mapping>
diff --git a/api/src/test/java/org/openmrs/api/OrderServiceTest.java b/api/src/test/java/org/openmrs/api/OrderServiceTest.java
index e47ce608ad47..c357f0d95101 100644
--- a/api/src/test/java/org/openmrs/api/OrderServiceTest.java
+++ b/api/src/test/java/org/openmrs/api/OrderServiceTest.java
@@ -72,6 +72,7 @@
 import org.openmrs.api.db.hibernate.HibernateSessionFactoryBean;
 import org.openmrs.api.impl.OrderServiceImpl;
 import org.openmrs.customdatatype.datatype.FreeTextDatatype;
+import org.openmrs.hl7.HL7InError;
 import org.openmrs.messagesource.MessageSourceService;
 import org.openmrs.notification.AlertRecipient;
 import org.openmrs.order.OrderUtil;
@@ -2735,6 +2736,7 @@ public void saveOrder_shouldFailIfTheJavaTypeOfThePreviousOrderDoesNotMatch() th
 			.addAnnotatedClass(DrugIngredient.class)
 			.addAnnotatedClass(AlertRecipient.class)
 			.addAnnotatedClass(PatientIdentifierType.class)
+			.addAnnotatedClass(HL7InError.class)
 			.getMetadataBuilder().build();
 
 

From 47e2020fb295e04b6a97181b1d2d40e7376711e4 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 26 Oct 2024 22:13:49 +0300
Subject: [PATCH 158/163] maven(deps): bump
 org.apache.maven.plugins:maven-checkstyle-plugin (#4803)

Bumps [org.apache.maven.plugins:maven-checkstyle-plugin](https://github.com/apache/maven-checkstyle-plugin) from 3.5.0 to 3.6.0.
- [Commits](https://github.com/apache/maven-checkstyle-plugin/compare/maven-checkstyle-plugin-3.5.0...maven-checkstyle-plugin-3.6.0)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-checkstyle-plugin
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 9f14e0c9b6d4..2329670bfc60 100644
--- a/pom.xml
+++ b/pom.xml
@@ -689,7 +689,7 @@
 				<plugin>
 					<groupId>org.apache.maven.plugins</groupId>
 					<artifactId>maven-checkstyle-plugin</artifactId>
-					<version>3.5.0</version>
+					<version>3.6.0</version>
 					<configuration>
 						<configLocation>checkstyle.xml</configLocation>
 					</configuration>

From 715d6b596cba4772bb0225f48dc7e0fa975989d2 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 26 Oct 2024 22:14:17 +0300
Subject: [PATCH 159/163] maven(deps): bump
 org.apache.maven.plugins:maven-jxr-plugin (#4802)

Bumps [org.apache.maven.plugins:maven-jxr-plugin](https://github.com/apache/maven-jxr) from 3.5.0 to 3.6.0.
- [Release notes](https://github.com/apache/maven-jxr/releases)
- [Commits](https://github.com/apache/maven-jxr/compare/jxr-3.5.0...jxr-3.6.0)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-jxr-plugin
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 2329670bfc60..2288e16f8977 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1158,7 +1158,7 @@
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-jxr-plugin</artifactId>
-				<version>3.5.0</version>
+				<version>3.6.0</version>
 			</plugin>
 		</plugins>
 	</reporting>

From 5dfd740aa8c712afa32b8aa8d47d18996a6f4bbe Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 26 Oct 2024 22:14:52 +0300
Subject: [PATCH 160/163] maven(deps): bump
 org.apache.maven.plugins:maven-dependency-plugin (#4801)

Bumps [org.apache.maven.plugins:maven-dependency-plugin](https://github.com/apache/maven-dependency-plugin) from 3.8.0 to 3.8.1.
- [Release notes](https://github.com/apache/maven-dependency-plugin/releases)
- [Commits](https://github.com/apache/maven-dependency-plugin/compare/maven-dependency-plugin-3.8.0...maven-dependency-plugin-3.8.1)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-dependency-plugin
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 2288e16f8977..af28356330d8 100644
--- a/pom.xml
+++ b/pom.xml
@@ -947,7 +947,7 @@
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-dependency-plugin</artifactId>
-				<version>3.8.0</version>
+				<version>3.8.1</version>
 			</plugin>
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>

From b2bd587e6a92c5b328a92efc43ce5dcd6f4ea594 Mon Sep 17 00:00:00 2001
From: Manoj Lakshan <48247516+ManojLL@users.noreply.github.com>
Date: Sun, 27 Oct 2024 01:00:26 +0530
Subject: [PATCH 161/163] TRUNK-5946: ProgramAttributeType Domain - Switching
 from Hibernate Mappings to Annotations (#4777)

* TRUNK-5946: ProgramAttributeType Domain switching from XML Mappings to Annotations

* TRUNK-5946: Updated OrderService test

* TRUNK-5946: added ID generating sequence
---
 .../org/openmrs/ProgramAttributeType.java     | 20 ++++++
 api/src/main/resources/hibernate.cfg.xml      |  1 -
 .../db/hibernate/ProgramAttributeType.hbm.xml | 63 -------------------
 .../org/openmrs/api/OrderServiceTest.java     |  2 +
 4 files changed, 22 insertions(+), 64 deletions(-)
 delete mode 100644 api/src/main/resources/org/openmrs/api/db/hibernate/ProgramAttributeType.hbm.xml

diff --git a/api/src/main/java/org/openmrs/ProgramAttributeType.java b/api/src/main/java/org/openmrs/ProgramAttributeType.java
index a2313c694f4d..fd5a49608ccb 100644
--- a/api/src/main/java/org/openmrs/ProgramAttributeType.java
+++ b/api/src/main/java/org/openmrs/ProgramAttributeType.java
@@ -10,12 +10,32 @@
 
 package org.openmrs;
 
+import org.hibernate.annotations.GenericGenerator;
+import org.hibernate.annotations.Parameter;
 import org.hibernate.envers.Audited;
 import org.openmrs.attribute.AttributeType;
 import org.openmrs.attribute.BaseAttributeType;
 
+import javax.persistence.Column;
+import javax.persistence.Entity;
+import javax.persistence.GeneratedValue;
+import javax.persistence.GenerationType;
+import javax.persistence.Id;
+import javax.persistence.Table;
+
+@Entity
+@Table(name = "program_attribute_type")
 @Audited
 public class ProgramAttributeType extends BaseAttributeType<PatientProgram> implements AttributeType<PatientProgram> {
+
+	@Id
+	@GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "program_attribute_type_id_seq")
+	@GenericGenerator(
+		name = "program_attribute_type_id_seq",
+		strategy = "native",
+		parameters = @Parameter(name = "sequence", value = "program_attribute_type_program_attribute_type_id_seq")
+	)
+	@Column(name = "program_attribute_type_id")
     private Integer programAttributeTypeId;
 
     @Override
diff --git a/api/src/main/resources/hibernate.cfg.xml b/api/src/main/resources/hibernate.cfg.xml
index 8bcc951d75b0..05e1299293e4 100644
--- a/api/src/main/resources/hibernate.cfg.xml
+++ b/api/src/main/resources/hibernate.cfg.xml
@@ -81,7 +81,6 @@
         <mapping resource="org/openmrs/api/db/hibernate/EncounterProvider.hbm.xml" />
 		<mapping resource="org/openmrs/api/db/hibernate/EncounterRole.hbm.xml" />
 		<mapping resource="org/openmrs/api/db/hibernate/Program.hbm.xml" />
-                <mapping resource="org/openmrs/api/db/hibernate/ProgramAttributeType.hbm.xml" />
 		<mapping resource="org/openmrs/api/db/hibernate/ProgramWorkflow.hbm.xml" />
 		<mapping resource="org/openmrs/api/db/hibernate/ProgramWorkflowState.hbm.xml" />
 		<mapping resource="org/openmrs/api/db/hibernate/Cohort.hbm.xml" />
diff --git a/api/src/main/resources/org/openmrs/api/db/hibernate/ProgramAttributeType.hbm.xml b/api/src/main/resources/org/openmrs/api/db/hibernate/ProgramAttributeType.hbm.xml
deleted file mode 100644
index e85f1bb7a95c..000000000000
--- a/api/src/main/resources/org/openmrs/api/db/hibernate/ProgramAttributeType.hbm.xml
+++ /dev/null
@@ -1,63 +0,0 @@
-<?xml version="1.0"?>
-<!--
-
-    This Source Code Form is subject to the terms of the Mozilla Public License,
-    v. 2.0. If a copy of the MPL was not distributed with this file, You can
-    obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
-    the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
-
-    Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
-    graphic logo is a trademark of OpenMRS Inc.
-
--->
-<!DOCTYPE hibernate-mapping PUBLIC
-        "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
-        "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">
-
-<hibernate-mapping package="org.openmrs">
-
-    <class name="ProgramAttributeType" table="program_attribute_type">
-
-        <id name="programAttributeTypeId" type="int" column="program_attribute_type_id">
-            <generator class="native">
-                <param name="sequence">program_attribute_type_program_attribute_type_id_seq</param>
-            </generator>
-        </id>
-
-        <property name="name" type="java.lang.String" column="name" not-null="true" length="255" />
-
-        <property name="description" type="java.lang.String" column="description" length="1024" />
-
-        <property name="datatypeClassname" type="java.lang.String" column="datatype" length="255" />
-
-        <property name="datatypeConfig" type="text" column="datatype_config" length="65535" />
-
-        <property name="preferredHandlerClassname" type="java.lang.String" column="preferred_handler" length="255" />
-
-        <property name="handlerConfig" type="text" column="handler_config" length="65535" />
-
-        <property name="minOccurs" type="int" column="min_occurs" length="11" not-null="true" />
-
-        <property name="maxOccurs" type="int" column="max_occurs" length="11" />
-
-        <many-to-one name="creator" class="org.openmrs.User" not-null="true" column="creator" />
-
-        <property name="dateCreated" type="java.util.Date" column="date_created" not-null="true" length="19" />
-
-        <many-to-one name="changedBy" class="org.openmrs.User" column="changed_by" />
-
-        <property name="dateChanged" type="java.util.Date" column="date_changed" length="19" />
-
-        <property name="retired" type="java.lang.Boolean" column="retired" length="1" not-null="true" />
-
-        <many-to-one name="retiredBy" class="org.openmrs.User" column="retired_by" />
-
-        <property name="dateRetired" type="java.util.Date" column="date_retired" length="19" />
-
-        <property name="retireReason" type="java.lang.String" column="retire_reason" length="255" />
-
-        <property name="uuid" type="java.lang.String" column="uuid" length="38" unique="true" />
-
-    </class>
-
-</hibernate-mapping>
diff --git a/api/src/test/java/org/openmrs/api/OrderServiceTest.java b/api/src/test/java/org/openmrs/api/OrderServiceTest.java
index c357f0d95101..60b6ad9516c8 100644
--- a/api/src/test/java/org/openmrs/api/OrderServiceTest.java
+++ b/api/src/test/java/org/openmrs/api/OrderServiceTest.java
@@ -56,6 +56,7 @@
 import org.openmrs.PatientState;
 import org.openmrs.PersonAddress;
 import org.openmrs.PersonAttributeType;
+import org.openmrs.ProgramAttributeType;
 import org.openmrs.Provider;
 import org.openmrs.ProviderAttributeType;
 import org.openmrs.Relationship;
@@ -2736,6 +2737,7 @@ public void saveOrder_shouldFailIfTheJavaTypeOfThePreviousOrderDoesNotMatch() th
 			.addAnnotatedClass(DrugIngredient.class)
 			.addAnnotatedClass(AlertRecipient.class)
 			.addAnnotatedClass(PatientIdentifierType.class)
+			.addAnnotatedClass(ProgramAttributeType.class)
 			.addAnnotatedClass(HL7InError.class)
 			.getMetadataBuilder().build();
 

From 335c2b5186086f8a3b3d1d353bb1d06d23a20dcd Mon Sep 17 00:00:00 2001
From: Wikum Weerakutti <wikum@linuxdeveloper.space>
Date: Sun, 27 Oct 2024 16:04:17 +0530
Subject: [PATCH 162/163] TRUNK-6279: Migrate OrderType from Hibernate Mapping
 XML to JPA annotations. (#4800)

---
 api/src/main/java/org/openmrs/OrderType.java  | 70 ++++++++++++++-----
 api/src/main/resources/hibernate.cfg.xml      |  1 -
 .../api/db/hibernate/OrderType.hbm.xml        | 59 ----------------
 .../org/openmrs/api/OrderServiceTest.java     |  1 +
 .../validator/OrderTypeValidatorTest.java     |  7 +-
 5 files changed, 58 insertions(+), 80 deletions(-)
 delete mode 100644 api/src/main/resources/org/openmrs/api/db/hibernate/OrderType.hbm.xml

diff --git a/api/src/main/java/org/openmrs/OrderType.java b/api/src/main/java/org/openmrs/OrderType.java
index 610a857d65dd..d24a573c0ef0 100644
--- a/api/src/main/java/org/openmrs/OrderType.java
+++ b/api/src/main/java/org/openmrs/OrderType.java
@@ -9,20 +9,38 @@
  */
 package org.openmrs;
 
-import java.util.Collection;
-import java.util.LinkedHashSet;
-
 import org.apache.commons.lang3.StringUtils;
+import org.hibernate.annotations.GenericGenerator;
+import org.hibernate.annotations.Parameter;
 import org.hibernate.envers.Audited;
 import org.openmrs.annotation.Independent;
 import org.openmrs.api.APIException;
 import org.openmrs.api.context.Context;
 
+import javax.persistence.AttributeOverride;
+import javax.persistence.AttributeOverrides;
+import javax.persistence.Column;
+import javax.persistence.Entity;
+import javax.persistence.GeneratedValue;
+import javax.persistence.GenerationType;
+import javax.persistence.Id;
+import javax.persistence.JoinColumn;
+import javax.persistence.JoinTable;
+import javax.persistence.ManyToMany;
+import javax.persistence.ManyToOne;
+import javax.persistence.Table;
+import javax.persistence.UniqueConstraint;
+import java.util.Collection;
+import java.util.LinkedHashSet;
+import java.util.Set;
+
 /**
  * OrderTypes are used to classify different types of Orders e.g to distinguish between Serology and
  * Radiology TestOrders
  *
  */
+@Entity
+@Table(name = "order_type")
 @Audited
 public class OrderType extends BaseChangeableOpenmrsMetadata {
 	
@@ -33,15 +51,33 @@ public class OrderType extends BaseChangeableOpenmrsMetadata {
 	public static final String TEST_ORDER_TYPE_UUID = "52a447d3-a64a-11e3-9aeb-50e549534c5e";
 	
 	public static final String REFERRAL_ORDER_TYPE_UUID = "f1b63696-2b6c-11ec-8d3d-0242ac130003";
-	
+
+	@Id
+	@GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "order_type_id_seq")
+	@GenericGenerator(
+		name = "order_type_id_seq",
+		strategy = "native",
+		parameters = @Parameter(name = "sequence", value = "order_type_order_type_id_seq")
+	)
+	@Column(name = "order_type_id", nullable = false)
 	private Integer orderTypeId;
 	
+	@Column(name = "java_class_name", nullable = false)
 	private String javaClassName;
 	
+	@ManyToOne
+	@JoinColumn(name = "parent")
 	private OrderType parent;
 	
 	@Independent
-	private Collection<ConceptClass> conceptClasses;
+	@ManyToMany
+	@JoinTable(
+		name = "order_type_class_map", 
+		joinColumns = @JoinColumn(name = "order_type_id"), 
+		inverseJoinColumns = @JoinColumn(name = "concept_class_id"), 
+		uniqueConstraints = @UniqueConstraint(columnNames = {"order_type_id", "concept_class_id"})
+	)
+	private Set<ConceptClass> conceptClasses;
 	
 	/**
 	 * default constructor
@@ -52,7 +88,7 @@ public OrderType() {
 	/**
 	 * Constructor with ID
 	 * 
-	 * @param orderTypeId the ID of the {@link org.openmrs.OrderType}
+	 * @param orderTypeId the ID of the {@link OrderType}
 	 */
 	public OrderType(Integer orderTypeId) {
 		this.orderTypeId = orderTypeId;
@@ -87,7 +123,7 @@ public void setOrderTypeId(Integer orderTypeId) {
 	}
 	
 	/**
-	 * @see org.openmrs.OpenmrsObject#getId()
+	 * @see OpenmrsObject#getId()
 	 */
 	@Override
 	public Integer getId() {
@@ -95,7 +131,7 @@ public Integer getId() {
 	}
 	
 	/**
-	 * @see org.openmrs.OpenmrsObject#setId(java.lang.Integer)
+	 * @see OpenmrsObject#setId(Integer)
 	 */
 	@Override
 	public void setId(Integer id) {
@@ -118,23 +154,23 @@ public void setJavaClassName(String javaClassName) {
 	}
 	
 	/**
-	 * @return Returns the {@link org.openmrs.OrderType}
+	 * @return Returns the {@link OrderType}
 	 */
 	public OrderType getParent() {
 		return parent;
 	}
 	
 	/**
-	 * @param parent The {@link org.openmrs.OrderType} to set
+	 * @param parent The {@link OrderType} to set
 	 */
 	public void setParent(OrderType parent) {
 		this.parent = parent;
 	}
 	
 	/**
-	 * @return Get the {@link org.openmrs.ConceptClass}es
+	 * @return Get the {@link ConceptClass}es
 	 */
-	public Collection<ConceptClass> getConceptClasses() {
+	public Set<ConceptClass> getConceptClasses() {
 		if (conceptClasses == null) {
 			conceptClasses = new LinkedHashSet<>();
 		}
@@ -142,17 +178,17 @@ public Collection<ConceptClass> getConceptClasses() {
 	}
 	
 	/**
-	 * @param conceptClasses the collection containing the {@link org.openmrs.ConceptClass}es
+	 * @param conceptClasses the collection containing the {@link ConceptClass}es
 	 */
-	public void setConceptClasses(Collection<ConceptClass> conceptClasses) {
+	public void setConceptClasses(Set<ConceptClass> conceptClasses) {
 		this.conceptClasses = conceptClasses;
 	}
 	
 	/**
-	 * Convenience method that returns a {@link java.lang.Class} object for the associated
+	 * Convenience method that returns a {@link Class} object for the associated
 	 * javaClassName
 	 * 
-	 * @return The Java class as {@link java.lang.Class}
+	 * @return The Java class as {@link Class}
 	 * @throws APIException
 	 */
 	public Class getJavaClass() {
@@ -177,7 +213,7 @@ public void addConceptClass(ConceptClass conceptClass) {
 	}
 	
 	/**
-	 * @see org.openmrs.BaseOpenmrsObject#toString()
+	 * @see BaseOpenmrsObject#toString()
 	 */
 	@Override
 	public String toString() {
diff --git a/api/src/main/resources/hibernate.cfg.xml b/api/src/main/resources/hibernate.cfg.xml
index 05e1299293e4..2bd3c6ad8dc1 100644
--- a/api/src/main/resources/hibernate.cfg.xml
+++ b/api/src/main/resources/hibernate.cfg.xml
@@ -63,7 +63,6 @@
                 <mapping resource="org/openmrs/api/db/hibernate/PatientProgram.hbm.xml" />
                 <mapping resource="org/openmrs/api/db/hibernate/PatientProgramAttribute.hbm.xml" />
 		<mapping resource="org/openmrs/api/db/hibernate/RelationshipType.hbm.xml" />
-		<mapping resource="org/openmrs/api/db/hibernate/OrderType.hbm.xml" />
 		<mapping resource="org/openmrs/api/db/hibernate/Order.hbm.xml" />
 		<mapping resource="org/openmrs/api/db/hibernate/OrderAttribute.hbm.xml" />
 		<mapping resource="org/openmrs/api/db/hibernate/OrderAttributeType.hbm.xml" />
diff --git a/api/src/main/resources/org/openmrs/api/db/hibernate/OrderType.hbm.xml b/api/src/main/resources/org/openmrs/api/db/hibernate/OrderType.hbm.xml
deleted file mode 100644
index 92217966fb48..000000000000
--- a/api/src/main/resources/org/openmrs/api/db/hibernate/OrderType.hbm.xml
+++ /dev/null
@@ -1,59 +0,0 @@
-<?xml version="1.0"?>
-<!--
-
-    This Source Code Form is subject to the terms of the Mozilla Public License,
-    v. 2.0. If a copy of the MPL was not distributed with this file, You can
-    obtain one at http://mozilla.org/MPL/2.0/. OpenMRS is also distributed under
-    the terms of the Healthcare Disclaimer located at http://openmrs.org/license.
-
-    Copyright (C) OpenMRS Inc. OpenMRS is a registered trademark and the OpenMRS
-    graphic logo is a trademark of OpenMRS Inc.
-
--->
-<!DOCTYPE hibernate-mapping PUBLIC
-    "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
-    "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">
-<hibernate-mapping package="org.openmrs">
-
-    <class name="OrderType" table="order_type">
-
-        <id name="orderTypeId" type="int" column="order_type_id">
-            <generator class="native">
-                <param name="sequence">order_type_order_type_id_seq</param>
-            </generator>
-        </id>
-
-        <property name="name" type="java.lang.String" not-null="true" length="255" unique="true" />
-
-        <property name="description" type="java.lang.String" length="1024"/>
-
-        <property name="javaClassName" type="java.lang.String" column="java_class_name" not-null="true" length="255" />
-
-        <property name="dateCreated" type="java.util.Date" column="date_created" not-null="true" length="19"/>
-
-        <property name="retired" type="boolean" length="1" not-null="true"/>
-
-        <property name="uuid" type="java.lang.String" length="38" unique="true" not-null="true"/>
-
-        <property name="dateRetired" type="java.util.Date" column="date_retired" length="19"/>
-
-        <property name="retireReason" type="java.lang.String" column="retire_reason" length="255" />
-
-        <many-to-one name="retiredBy" class="User" column="retired_by"/>
-
-        <many-to-one name="parent" class="OrderType"/>
-
-        <many-to-one name="creator" class="User" not-null="true"/>
-
-        <many-to-one name="changedBy" class="User" column="changed_by" />
-
-        <property name="dateChanged" type="java.util.Date" column="date_changed" length="19" />
-
-        <set name="conceptClasses" table="order_type_class_map" lazy="true" cascade="none">
-            <key column="order_type_id" />
-            <many-to-many column="concept_class_id" class="ConceptClass" unique="true"/>
-        </set>
-
-    </class>
-
-</hibernate-mapping>
diff --git a/api/src/test/java/org/openmrs/api/OrderServiceTest.java b/api/src/test/java/org/openmrs/api/OrderServiceTest.java
index 60b6ad9516c8..6d553c038256 100644
--- a/api/src/test/java/org/openmrs/api/OrderServiceTest.java
+++ b/api/src/test/java/org/openmrs/api/OrderServiceTest.java
@@ -2739,6 +2739,7 @@ public void saveOrder_shouldFailIfTheJavaTypeOfThePreviousOrderDoesNotMatch() th
 			.addAnnotatedClass(PatientIdentifierType.class)
 			.addAnnotatedClass(ProgramAttributeType.class)
 			.addAnnotatedClass(HL7InError.class)
+			.addAnnotatedClass(OrderType.class)
 			.getMetadataBuilder().build();
 
 
diff --git a/api/src/test/java/org/openmrs/validator/OrderTypeValidatorTest.java b/api/src/test/java/org/openmrs/validator/OrderTypeValidatorTest.java
index 87fb1f3cfc0d..24826fe7a467 100644
--- a/api/src/test/java/org/openmrs/validator/OrderTypeValidatorTest.java
+++ b/api/src/test/java/org/openmrs/validator/OrderTypeValidatorTest.java
@@ -19,6 +19,7 @@
 
 import java.util.Collection;
 import java.util.HashSet;
+import java.util.Set;
 
 import org.junit.jupiter.api.Test;
 import org.openmrs.ConceptClass;
@@ -159,7 +160,7 @@ public void validate_shouldPassIfAllFieldsAreCorrectForANewOrderType() {
 		OrderType orderType = new OrderType();
 		orderType.setName("unique name");
 		orderType.setJavaClassName("org.openmrs.TestDrugOrder");
-		Collection<ConceptClass> col = new HashSet<>();
+		Set<ConceptClass> col = new HashSet<>();
 		col.add(Context.getConceptService().getConceptClass(2));
 		orderType.setConceptClasses(col);
 		Errors errors = new BindException(orderType, "orderType");
@@ -201,7 +202,7 @@ public void validate_shouldPassValidationIfFieldLengthsAreCorrect() {
 		OrderType orderType = new OrderType();
 		orderType.setName("unique name");
 		orderType.setJavaClassName("org.openmrs.TestDrugOrder");
-		Collection<ConceptClass> col = new HashSet<>();
+		Set<ConceptClass> col = new HashSet<>();
 		col.add(Context.getConceptService().getConceptClass(2));
 		orderType.setConceptClasses(col);
 		
@@ -224,7 +225,7 @@ public void validate_shouldFailValidationIfFieldLengthsAreNotCorrect() {
 		        .setName("too long text too long text too long text too long text too long text too long text too long text too long text too long text too long text too long text too long text too long text too long text too long text too long text too long text too long text too long text too long text");
 		orderType
 		        .setJavaClassName("too long text too long text too long text too long text too long text too long text too long text too long text too long text too long text too long text too long text too long text too long text too long text too long text too long text too long text too long text too long text");
-		Collection<ConceptClass> col = new HashSet<>();
+		Set<ConceptClass> col = new HashSet<>();
 		col.add(Context.getConceptService().getConceptClass(2));
 		orderType.setConceptClasses(col);
 		

From df3665a70f5f4a936e1b952f0f7a19f7907e6b6d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 29 Oct 2024 23:37:14 +0300
Subject: [PATCH 163/163] maven(deps): bump jacksonVersion from 2.18.0 to
 2.18.1 (#4808)

Bumps `jacksonVersion` from 2.18.0 to 2.18.1.

Updates `com.fasterxml.jackson.core:jackson-core` from 2.18.0 to 2.18.1
- [Commits](https://github.com/FasterXML/jackson-core/compare/jackson-core-2.18.0...jackson-core-2.18.1)

Updates `com.fasterxml.jackson.core:jackson-annotations` from 2.18.0 to 2.18.1
- [Commits](https://github.com/FasterXML/jackson/commits)

Updates `com.fasterxml.jackson.core:jackson-databind` from 2.18.0 to 2.18.1
- [Commits](https://github.com/FasterXML/jackson/commits)

Updates `com.fasterxml.jackson.datatype:jackson-datatype-jsr310` from 2.18.0 to 2.18.1

---
updated-dependencies:
- dependency-name: com.fasterxml.jackson.core:jackson-core
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: com.fasterxml.jackson.core:jackson-annotations
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: com.fasterxml.jackson.core:jackson-databind
  dependency-type: direct:production
  update-type: version-update:semver-patch
- dependency-name: com.fasterxml.jackson.datatype:jackson-datatype-jsr310
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index af28356330d8..d99fa021a848 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1216,7 +1216,7 @@
 		<hibernateSearchVersion>5.11.12.Final</hibernateSearchVersion>
 		<luceneVersion>5.5.5</luceneVersion>
 		<aspectjVersion>1.9.22.1</aspectjVersion>
-		<jacksonVersion>2.18.0</jacksonVersion>
+		<jacksonVersion>2.18.1</jacksonVersion>
 		<junitVersion>5.11.3</junitVersion>
 		<mockitoVersion>3.12.4</mockitoVersion>
 		<hamcrestVersion>3.0</hamcrestVersion>