Control types used by the form designer
Use control types in the form designer applet to specify how users enter a value for an attribute.
- CheckBox
- Assigns a single check box as the data gathering field. This control type is typically used for attributes that are Boolean in nature.
- Date
- Provides a calendar pop-up window that allows users to select the desired date. This control type has additional attributes that can be used to configure the date.
When you select this control type in the form designer applet, the Date Editor page is displayed. You can use the fields in the editor to configure the control type. The Date Editor contains the following fields:- DateInput Type
- Select the type of date input for the calendar pop-up window.
- Default
- Provides a calendar pop-up window and a Never check box. If the user selects the check box, then the attribute value never expires.
- Alternative Date
- Provides a calendar pop-up window without a Never check box. Use this type if the attribute value must expire at some point in time.
- Show Time
- Select this check box to include a pop-up window that you can use to view and specify a time.
- DropDown Box
- Creates a list for an attribute. You must populate the attributes to be contained in the list by with one of the following options:
- Custom Values
- Limits the information that is available in the list on the resulting
form. When you select this option, the Select Editor page
is displayed. You can use the fields in the editor to configure the
control type. The Select Editor contains the following fields and
toolbar buttons:
- Number of Rows
- Type the number of rows to include in the list and press Enter. Use this field to specify the number of rows in the list. If the original list contains more rows than the number that you enter, then the extra rows are removed.
- Data Value
- Type a data value.
- Display Value
- Type a display value to display in the list.
- Use Blank Row
- Select this check box to insert a blank entry into the list.
- Add Row
- Click to add a row to display in the list.
- Delete Row
- Click to delete a row from the list.
- Use Display Value as Data Value
- Click to use the same value that is entered in the Display Value column for the Data Value column.
- Use Index as Data Value
- Click to use the same value that is in the index for the Data Value column.
- Search Filter
- Provides a broader range from which to gather information when
populating the box. Use an LDAP search filter that assigns a value
to an attribute through the use of a search control. When you select
this option, the SearchFilter Editor page is displayed. You can use
the fields in the editor to configure the control type. The SearchFilter
Editor contains the following fields:
- Search Base
- Select the scope of the search from these options:
- org searches the organization of the selected container in the organization tree.
- contextual searches the selected organizational unit in the organization tree.
- Object Class
- Type the name of the LDAP class to search for, such as erNTGlobalGroup. The value for the group field on the resulting form must be erroles.
- Attribute
- Type the attribute to search for, such as erNTLocalName.
- Source Attribute
- Type the attribute value to return after the search completes, such as erNTGlobalGroupId.
- Description Attribute
- Type the attribute value that is appropriate for the service type. If there is no entry in this field, the group search page in the user interface contains no Description column in the search results table. For more information, see Customizing an account request.
- Filter
- Type any additional filter that needs to be applied to the search, such as (objectclass=erNTLocalGroup). The value for the group field on the resulting form must be objectclass=erroles.
- Delimiter
- Type the delimiter to use to separate attribute values in the resulting form.
- Source Attribute Delimiter
- Type the delimiter to use to separate multiple source attribute values of an entity to store in the directory server. Make sure that the specified delimiter is not part of any source attribute value. If configured properly, you can use the search filter to resolve the attribute value correctly when you must store multiple source values of an entity in a delimiter-separated string format.
- Multiple Value
- Select this check box to change a dropdown box to a list box in the resulting form. The list box allows users to select more than one value.
- Show Query UI
- Select this check box to display a search page in the resulting form. When this option is not selected, only search results are displayed in a separate page.
- Paginate Results
- Select this check box to display the search results across multiple pages.
- Editable Text List
- Enables the display of multi-value attributes on the user interface. This control type is a list box that displays user-provided information. Users can enter information into the text field and add it to the list box by clicking Add, and they can delete information from the list box by selecting the entry and clicking Delete.
- ListBox
- Provides a list box for an attribute. The list box contains user-selected data. Users can add one or more items to a list box, and they can delete one or more items from the list box.
- Custom Values
- Limits the information that is available in the list on the resulting
form. When you select this option, the Select Editor page is displayed.
You can use the fields in the editor to configure the control type.
The Select Editor contains the following fields and toolbar buttons:
- Number of Rows
- Type the number of rows to include in the list and press Enter. Use this field to specify the number of rows in the list. If the original list contains more rows than the number that you enter, then the extra rows are removed.
- Data Value
- Type a data value.
- Display Value
- Type a display value to display in the list.
- Use Blank Row
- Select this check box to insert a blank entry into the list.
- Add Row
- Click to add a row to display in the list.
- Delete Row
- Click to delete a row from the list.
- Use Display Value as Data Value
- Use the same value that is entered in the Display Value column for the Data Value column.
- Use Index as Data Value
- Use the same value that is in the index for the Data Value column.
- Search Filter
- Provides a broader range from which to gather information when
populating the box. Use an LDAP search filter to assign a value to
an attribute through the use of a search control. When you select
this option, the SearchFilter Editor page is displayed. You can use
the fields in the editor to configure the control type. The SearchFilter
Editor contains the following fields:
- Search Base
- Select the scope of the search from these options:
- org searches the organization of the selected container in the organization tree.
- contextual searches the selected organizational unit in the organization tree.
- Object Class
- Type the name of the LDAP class to search for, such as erNTGlobalGroup. The value for the group field on the resulting form must be erroles.
- Attribute
- Type the attribute to search for, such as erNTLocalName.
- Source Attribute
- Type the attribute value to return after the search completes, such as erNTGlobalGroupId.
- Filter
- Type any additional filter that needs to be applied to the search, such as (objectclass=erNTLocalGroup). The value for the group field on the resulting form must be objectclass=erroles.
- Delimiter
- Type the delimiter to use to separate attribute values in the resulting form.
- Multiple Value
- Select this check box to change a dropdown box to a list box in the resulting form. The list box allows users to select more than one value.
- Show Query UI
- Select this check box to display a search page in the resulting form. When this option is not selected, only search results are displayed in a separate page.
- Paginate Results
- Select this check box to display the search results across multiple pages.
- LoginHours
- Defines the hours that a service is available for users to log in to it. Use this control type only on forms for services that support restricted login times, such as a Windows 2000 service.
When you select this control type in the form designer applet, the LoginHours Editor page is displayed. You can use the fields in the editor to configure the control type to default to a specific type of search. The LoginHours Editor contains the following fields:- Time Interval
- Select the time interval to be displayed in the resulting form:
- One Hour sets the time interval to one-hour blocks.
- Mid Hour sets the time interval to half-hour blocks.
- Orientation
- Select the orientation for the editor that is used to define login
times on the resulting form:
- Portrait places the days of the week along the X-axis and the time (in half-hour or one-hour blocks) along the Y-axis.
- Landscape places the time (in half-hour or one-hour blocks) along the X-axis and the days of the week along the Y-axis.
- Password
- Provides a text box for an attribute that does not display the information that a user provides. The information is masked on the screen for security.
- Password Popup
- Opens a window for the user to enter secure information. The information is masked on the screen and provides two text fields to enter the information. This control type is typically used for the shared secret of an individual.
- Search Control
- Provides a text field search page for the selected attribute, and includes Search and Clear buttons. Users populate the text field by selecting the wanted search result. In the resulting form in the user interface, the Search button opens a search page with the search type already selected, and the Clear button clears the text field.
When you select this control type in the form designer applet, the Search Control Editor page is displayed. You can use the fields in the editor to configure the control type to default to a specific type of search. The Search Control Editor contains the following fields:- Category
- Select the category for the search.
- Profile
- Select the profile to use for the search.
- Attribute
- Select the attribute to use for the search.
- Operator
- Select the operator, such as Contains or Equals, that links the Attribute and Value fields together.
- Value
- Type the value for the attribute.
- Type
- Select the type of attributes to be returned. A single-value type provides a text field for the user to populate. A multi-value type provides a list box of attributes. In this scenario, users can identify which attributes to search by selecting the attributes that they do not want to include in the search and clicking the Delete button. Deletion removes the selected attributes from the list of searchable attributes.
- Search entire organization (current container only if not checked)
- Select this check box if you want the search to include the entire organization.
A related control type is the Search Match control type. This type is the Search Control control type with an additional feature that allows automatic searching and populating the list box of an attribute.
- Search Match
- Similar to the Search Control control type, with an additional feature that allows automatic searching and populating of the list box of an attribute. Users can use the automatic searching feature by typing in the first few letters of the wanted value in the text field and clicking Add. If one result is found, the result is automatically added to the list box. If more than one result is found, a Search Results page is displayed. A user can then select which items to add to the list box.
Provides a text field search page for the selected attribute. Users populate the text field by selecting the wanted search result. In the resulting form, the Search button opens a search page with the search type already selected. The Clear button clears the text field. The Delete button is used to remove a selected item from the list box.
When you select this control type in the form designer applet, the Search Control Editor page is displayed. You can use the fields in the editor to configure the control type to default to a specific type of search. The Search Control Editor contains the following fields:- Category
- Select the category for the search.
- Profile
- Select the profile to use for the search.
- Attribute
- Select the attribute to use for the search.
- Operator
- Select the operator, such as Contains or Equals, that links the Attribute and Value fields together.
- Value
- Type the value for the attribute.
- Type
- Select the type of attributes to be returned. A single-value type provides a text field for the user to populate. A multi-value type provides a list box of attributes. In this scenario, users can identify which attributes to search by selecting the attributes that they do not want to include in the search and clicking the Delete button. Deletion removes the selected attributes from the list of searchable attributes.
- Search entire organization (current container only if not checked)
- Select this check box if you want the search to include the entire organization.
A related control type is Search Control.
- SubForm
- The SubForm control type provides a means to use custom user interfaces for complex multi-valued attributes. Some Identity Manager adapters use this control type infrequently.
SubForm is a special control type used to start a Servlet, JSP, or static HTML page from a popup window that opens from a custom Identity Manager form. Subforms provide a means to submit an arbitrary number of parameter names and values to a custom Servlet or JSP. Subforms are used to create custom user interfaces for complex multi-valued attributes.
Table 1. SubForm parameters Parameter Description Value customServletURI The URI to the Servlet, JSP, or static HTML page to be started from the main form. If a Servlet is implemented and deployed in the default web application for IBM Verify Identity Governance, the value for this parameter is the same as the URL-pattern value defined in web.xml in the servlet-mapping tag, without the slash (/). If a JSP is implemented, the value for this parameter is the JSP file name that includes the jsp file extension. This parameter is required on all subforms. Servlet name or JSP file name, such as sample.jsp Parameter Name Arbitrary parameter name and value that is included in the HTTP request that starts the resource at customServletURI. Parameter Value, such as racfconnectgroup servlet - TextArea
- Places a text area next to the attribute. A text area is a multiline text field used to gather user input and display data previously gathered.
- TextField
- Places a text field next to the attribute. A text field is a single-line area used to gather user input or display data previously gathered.
- UMask
- Allows a user to define UNIX access rights to files and directories.
