FormConditions.js is located under bahmni_config/openmrs/apps/clinical.
This configuration allows users to enable, disable or as well as show errors based on specific conditions or inputs on the form.
Some sections of the form are only filled when a particular set of information is needed. So, if we disable such fields, it simplifies the form.
Consider for example the case where there are two dates being entered in a form and one of the date should be always lesser than the other one. This condition can be checked in this JavaScript file and an appropriate error message can be shown upon validation.
The following function takes two inputs (formName and formFieldValues) and returns an object that contains array of enable and disable field/s and an error message if any.This code snippet will make "Posture" option disabled on initial rendering. Once data is entered for "Systolic Data" field, "Posture" option is enabled.
Code Block |
---|
language | js |
---|
linenumbers | true |
---|
|
'Systolic Data' : function (formName, formFieldValues) {
var systolic = formFieldValues['Systolic'];
if (systolic) {
return {
enable: ["Posture"]
}
} else {
return {
disable: ["Posture"],
error: "Error message here if any"
}
}
}
|
In this case, the returned object will be-
Code Block |
---|
|
{
enable: ["Posture"],
disable: [],
error: "Error message here if any"
} |
Code Block |
---|
|
<Concept Full Name> : function (formName, formFieldValues) { } |
Existing form conditions can be overriden by the formConditions.js file in /implementation_config/openmrs/apps/clinical folder.
Bahmni.ConceptSet.FormConditions.rulesOverride is used as variable.
Code Block |
---|
Bahmni.ConceptSet.FormConditions.rulesOverride = {
'Systolic Data' : null,
'Diastolic Data' : function (formName, formFieldValues) {
var diastolic = formFieldValues['Diastolic'];
if (diastolic) {
return {
enable: ["Posture"]
}
} else {
return {
disable: ["Posture"],
error: "Error message here if any"
}
}
}
} |
Note |
---|
The form field based on which conditional enabling and disabling is done should be above the fields that are getting disabled or enabled. |
Info |
---|
For example if we are disabling Blood Pressure based on Pulse Data, then Pulse Data should be above the Blood Pressure. Please refer the image below. |