Canvas enables the developer to mark the item as mandatory or conditional mandatory enabling the developer to effectively handle user input.
Mandatory Text | ConditionalMandatory Text |
The Mandatory Text indicates that an item is mandatory. The end-users must enter the values for those items marked with Required Indicators. These fields will be marked with a red asterisk (*) symbol. | The Conditional Mandatory Text indicates that an item is conditionally mandatory. The users will have to enter values based on a condition. These fields will be marked with double blue asterisk (**) symbols. The developers can write the conditions and the forms behavior in the cbxprevalidate handler CFEC.PRE_VALIDATE handler. |
For example:
Consider a case like making a Text Area (TXT_MESSAGE_DESC) as mandatory based on the check box (CHK_PROCEED_WOUT_MESG).
...
You can mark the TXT_MESSAGE_DESC as conditional mandatory and can write the cbxprevalidate as CFEC.PRE_VALIDATE as shown:
| Code Block | ||
|---|---|---|
| ||
this.fm.registerHandler("cbxprevalidate"CFEC.PRE_VALIDATE, function(fm, config) { //fm.getValue API is used to get the value of particular field. if(fm.getValue("CHK_PROCEED_WOUT_MESG")=='Y') { //This API is used to marksmark aan invalid field as Validvalid. fm.clearInvalid("TXT_MESSAGE_DESC"); return [true, true]; } else { //This API is used to marksmark aan invalid field as Validvalid. fm.markInvalid("TXT_MESSAGE_DESC", "Please, Enter the message"); return false; } }); |
For more details of form APIs, see Form and Form Item APIs.
...