Properties used by the form designer
Use the Properties page to configure attribute format and constraints. The Properties page includes the following tabs:
- Format
- Use this tab to change
the format of a form. Available fields in this tab are:
- Name
- Use this field to add or modify the name of an attribute. This value is the identifier that the form uses to process LDAP attributes.
- Data Type
- Use this field to add or modify the data type of an attribute, such as Directory String, Distinguished Name, binary code, or another data type
- Label
- Use this field to add or modify a user-readable label for the attribute. For example, $homepostaladdress, where the $ (dollar) symbol indicates a key to look up a string in a resource bundle.
- Size
- Use this field to add or modify the visible width in units of pixels for the following control type: TextField, Password, Search Control, and Search Match. Size represents the number of visible items for the following control type: ListBox and Editable TextList.
- Rows
- Use this field to add or modify the value used by the TextArea control type to represent the number of visible text lines.
- Cols
- Use this field to add or modify the value used by the TextArea control type to represent the visible width in average character widths.
- Width
- Use this field to add or modify the value used by the SubForm
control type to represent the width of a pop-up window in units of pixels.
This property is also used by the DropDownBox, EditableTextList,
ListBox, SearchControl, and SearchMatch controls to represent the width of their associated combo boxes, in pixels. For EditableTextList
and SearchMatch controls, width also determines the width of associated text boxes in pixels.
If width is not specified, it is assumed to be a default of 300 pixels. If the width for these controls is set to 0, the associated combo boxes are not a fixed size and resize dynamically. The size depends on the options added.
- Height
- Use this field to add or modify the value used by the SubForm control type to represent the height of a pop-up window in units of pixels
- Read-Only on Modify
- Select this check box to set an attribute to read-only. Only the label is displayed in the form, and users cannot modify the attribute value.
- Direction
- Select the direction
of text:
- inherit displays text in the same direction as the form category to which the attribute belongs
- ltr displays text from left to right
- rtl displays text from right to left
- Hide on Modify
- Select this check box to hide the attribute field in the form when the form is in modify state. For example, if we select this check box for the Owner field within a service form, the Owner field is displayed when users create a service. The field is not displayed when users change a service.
- Constraints
- Use this tab to enter values for constraint
fields to guarantee
the type of data and the syntax of the data users are allowed to enter
in form fields. Custom constraints are field-level data restrictions
of various types. When we select a control type of Search Control, Search Match, ListBox,
or DropDownBox, all of the constraint fields are disabled, except for the Required constraint.
- Required
- Select this check box to prevent the form from being submitted unless some value is typed into the field where this constraint is placed.
- Validate and Update Constraints
In the field next to the Validate and Update Constraints button,
which is at the bottom of the constraint type list, type a sample value for the attribute we selected from the form template layout area and click the Validate and Update
Constraints button. This tests the value entered against the constraints activated for the attribute. If the test value you enter complies with all constraints, a message indicates success after we click the Validate and Update Constraints button.
Constraints fall into one of these general categories.
- Syntactic constraints
- Allow only values that conform to rules that define sequences
of characters and structured parts.
- E-mail address
- Select this check box to guarantee that the syntax of the value
supplied on the field where this constraint is placed complies with the following rules:
- Has one @ sign
- Invalid characters, such as < > ( ) . ; " \ [ ] do not occur before the @ sign
- The @ sign must be followed by a valid domain name or IP Address
- IP address (IPV4)
- Select this check box to guarantee that the value entered in the field where this constraint is placed is a valid IPV4 address of the form 127.0.0.1. The four octets are separated by a dot and none of the octets exceeds 255.
- IP address (IPV6)
- Select this check box to guarantee that the value entered in the field conforms with the text representation of IP addresses defined in RFC 2373. For example, 0:0:0:0:0:0:0:1 is the loopback IPV6 address. See RFC 2373 for more details.
- Domain name
- Select this check box to ensure that the value entered in the field where this constraint is placed is compliant with the Windows NT Server Domain Name syntax. The name must have two leading
back-slashes (\\) and can contain up to 15 characters, except for these characters: " / \ [ ] : ; | = , + * ? < >
The name cannot consist solely of periods or spaces.
- Invalid characters
- Enter characters in this field to define characters that is not valid when entered for the field.
- DN
- Select this check box to guarantee that the value entered in this field conforms with the distinguished name structure. For example, cn=common name, ou=organizational name, o=organization.
- Data type constraints
- Allow values that occur within a range of characters or numbers.
- ASCII-Only
- Constrain the characters allowed in the field to ASCII.
- ASCII7
- Constrain the characters allowed in the field to ASCII-7.
- ASCII8
- Select this check box to constrain the characters allowed in the field to ASCII-8.
- Integer only
- Select this check box to allow only integers in the field.
- Numeric
- Select this check box to allow only numbers in the field.
- Date range
- Enter a date range to force an ending date to be after a beginning date.
- Value constraints
- Require a parameter, such as Max Length = 10,
where 10 is the parameter to constrain the value by.
- Invalid characters
- Enter characters that are disallowed.
- Maximum length
- Enter a numeric value that constrains the length of the value entered for the field to the number of characters specified.
- Minimum length
- Enter a numeric value that prevents the form from being submitted unless the value entered has at least as many characters specified by this constraint.
- Maximum value
- Enter a numeric value to set a high end point on the value entered (is at most n).
- Minimum value
- Enter a numeric value to set a low end point on the value entered (is at least n).
- Maximum lines
- Enter a numeric value to guarantee that the value entered on the form does not exceed the maximum number of lines specified (in a multi-line field).
- No white space
- Select this check box to disallow any white space from being entered on the form.
Parent topic: Form customization