INPUT declares an input control on a Wizard page; the NAME and PARAM attributes provide a mechanism to 'bind' the control to a Wizard parameter.
This tag can occur only within a PAGE tag in a Wizard profile file.
Declares an input control on a Wizard page; the NAME and PARAM attributes provide a mechanism to 'bind' the control to a Wizard parameter. More about how this works in the section Bound Controls
<INPUT .../> | |
---|---|
NAME | Required. Name of the form control to which the INPUT is bound. |
PARAM | Name of the parameter to which the INPUT is bound. The default value is that of the NAME attribute. |
DEFAULT | Default value for the input. |
REQUIRED | True/False or YES/NO (can be the result of a dynamic expression). Determines whether the input is required. |
VALIDATIONMSG | A message to display to the user if the input is required and a value is not entered. Recommended. |
LISTCONTENTS | If this is a DropDown or ListBox based control, then a comma-separated list will be used to populate the list with values. |
REQUIRED
If the REQUIRED attribute on a WIZARD PARAM is set to "true", then the Finish button remains disabled
until this PARAM (and all other required parameters) has a value. Setting REQUIRED="true" on an INPUT tag has a more direct effect in the user interface; when the control that the INPUT is bound to does not have a value when the user tries to move to the next page, an error
message displays. The message text is defined in VALIDATIONMSG below.
Since the REQUIRED attribute for an INPUT tag does not disable the Next button, it is advisable to also create some sort of visual marker for required fields so the user will know which input is required before encountering this type of error message when trying to move to the next page.
You have the choice of setting REQUIRED on the PARAM, on the INPUT, or both. See also the section on Dynamic expressions in tags.
VALIDATIONMSG
Recommended when the flag REQUIRED is present. Defaults to "The required parameter [NAME] was not entered. Please enter this value before
proceeding.", where [NAME] is the name of the Wizard PARAM.