Deployment Guide

288 | Configuration Dell Networking W-ClearPass Guest 6.3 | User Guide
The initial value for a form field may be specified. Use this option when a field value has a sensible default. The initial
value should be expressed in the same way as the field’s value. In particular, for drop-down list and radio button
selections, the initial value should be the key of the desired default option. Likewise, for date/time fields that have a
display function set, the initial value should be a value that can be passed to the display function.
Select the Field value must be supplied check box to mark the field as a required field. Required fields are marked
with an asterisk, as shown below:
An optional field may be left blank. In this case, the field is not validated as there is no value for the field. However,
any value that is supplied for an optional field is subject to validation checks.
All values supplied for a required field are always validated, including blank values.
Validation errors are displayed to the user by highlighting the field(s) that are in error and displaying the validation
error message with the field:
All fields must be successfully validated before any form processing can take place. This ensures that the form
processing always has user input that is known to be valid.
To validate a specific field, choose a validator from the drop-down list. See "Form Field Validation Functions" on page
521 for a description of the built-in validators.
The Validator Param is the name of a field on the form, the value of which should be passed to the validator as its
argument. This could be used to validate one field based on the contents of another. However, in most deployments
this does not need to be set.
Set the Validator Param to its default value, “(Use argument)”, to provide a fixed value as the argument to the
validator.
The Validator Argument is used to provide further instructions to the selected validator. Not all validators require an
argument; a validator such as IsValidEmail is entirely self-contained and will ignore the Validator Argument.
Validators such as IsEqual, IsInRange and IsRegexMatch use the argument to perform validation.
Examples of Form field Validation
Example 1 – To create a form field that requires an integer value between 1 and 100 (inclusive) to be provided, use
the following settings in the form field editor: