Main Tab
Set field properties and the display type on the Main tab:
- Name -- Enter the name for this field. A field name is usually a
path expression into the view that is being used with this form.
All fields that display as editing components (such as text boxes, checkboxes, and selects)
must have a name that specifies a view path. Fields that do not display as editing components
(such as SectionHead and Javascript) do not require names; however, non-editing fields
may be given names if they need to be referenced by another form through a Field Reference.
- Title -- Enter a title for the field. This title displays adjacent
to the field on the form.
- Help Key -- Enter the help key that keys guidance for the field. The value is the name
of an entry in an associated help catalog specified by the form.
Specifying a help key causes an icon to appear to the left of the field.
Moving the mouse over the icon causes the text referenced in the help catalog
to display.
- Confirmation Field -- Enter the name of another field with which you want to
compare values. Generally, this feature is used when setting and confirming passwords.
- Options -- Select one or more display options for the field:
- Hidden -- The field will not display on the form.
- Container -- Deprecated. This setting is ignored.
- Required -- An entry or selection in this field is required to process the form.
- Button -- Causes the field to display in a single, horizontal row at the
bottom of the form; otherwise, it displays on the next line of the form. This is
most commonly set with fields that use the display class button.
- Display Class -- Select the class type used to render the form field.
Note: Refer to Display Class Reference for brief descriptions of each display class.
See Configuration I (Forms) for more detailed display class reference information.
- Display Properties -- Set one or more properties that apply to this field. To create properties,
click New in the Properties area, and then double-click the blank line entry in the list.
In the displayed Property dialog, select a Name from the list of options and set the value for
the property. You can enter a value in the Value field, or calculate a value by setting XPRESS
values in the Expression area.
Note: See Configuration III for XPRESS language reference information.
Constraints Tab
Constraints should be specified as the allowedAttributes property
of select and multiselect fields.
Disable Tab
Use the Disable area to specify an expression that, if evaluated to true, will disable the field and
any of its nested fields.
A disabled field does not display on the form. It is commonly used to determine
if a user has a specific type of resource; if so, the form then displays the appropriate fields for that resource.
Enter an expression, and then click Validate to check for errors.
Default Tab
The Default area lets you specify an expression to calculate a default value for the field.
The default expression will be called before the form is displayed if the current value for this field is null.
Enter an expression, and then click Validate to check for errors.
Derivation Tab
The Derivation area lets you specify an expression to calculate the value of a field
before it is displayed. It is similar to a Default expression, except that it will be evaluated even
if the current field value is non-null. The derivation expression is evaluated before the form is
first displayed, and then again each time the form is refreshed.
Enter an expression, and then click Validate to check for errors.
Expansion Tab
The Expansion area lets you specify an expression to calculate the value of the field
after the form has been submitted. Expansion expressions are normally used with fields that are also
marked hidden. Since hidden fields are not directly editable by the user, the value may be
calculated with an expansion expression.
Enter an expression, and then click Validate to check for errors.
|