INPUT (Wizards)VTML 2

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.

Location

This tag can occur only within a PAGE tag in a Wizard profile file.

Function

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

Syntax and Attributes

<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.

Usage Notes

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.

top