Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Description
FormConditions.js is located under bahmni_config/openmrs/apps/clinical.
This configuration allows users to enable, disable or show errors based on specific conditions on 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.
Steps
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.
Example
Code Block | ||||
---|---|---|---|---|
| ||||
'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" } |
Function signature which needs to be used
Code Block | ||
---|---|---|
| ||
<Concept Full Name> : function (formName, formFieldValues) { } |
Overriding Form Conditions:
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" } } } } |
Tip | ||
---|---|---|
| ||
|