Special features of editing overview forms
Special features of a user interface form for the main form element of an overview form
-
The user interface form is created using the VI_ElementNavigation form definition. This form definition provides the control element for displaying the overview form in the user interface.
-
Enter the name of the main form element in the user interface form's configuration data in the Properties section.
Example:
<DialogSheetDefinition FormatVersion="1.0">
<Properties>
<Property Name="OverviewNode">VI_Person_Person_Overview</Property>
</Properties>
</DialogSheetDefinition>
Special features of mapping lists on an overview form
If a form element is used for mapping lists, the items are displayed with their names. You can jump to the referenced object by clicking on the entry with the mouse.
To prevent navigation to the referenced object, set the value of the configuration switch on the menu item to Ignore user interface forms in result list. This is useful if, for example, forms are not defined for some objects in the result list. Otherwise, an empty form is displayed.
Related topics
Customizing the form elements layout
The color and positioning of the form elements on the overview as well as the properties that are shown, are specified by layout information for the menu items. You can modify these properties for predefined overview forms as well.
To customize the form element's layout information
-
In the Designer, select the User interface > Forms > Overview forms category.
-
Select the overview form and open it in the Overview Form Editor.
-
Select the form element in the design view.
-
Select the tab Layout in the Properties view and change the properties.
Table 51: Form elements layout
|
Alignment |
Positioning of the form elements on the overview form. You cannot align the main form element. The main form element is always displayed in the middle of the overview form. All child menu items are positioned relevant to the main form element. |
|
Background color |
Color for displaying the form element on the overview form The background color of the main form element cannot be configured. When a link is set up, it is given the background color of the referenced menu item. |
|
max. similar elements count |
If a menu item defines a list of items, each item in the menu item’s result list is displayed in a separate form element.
Define up to how many items should be displayed in separate form elements. If the number is exceeded the items are grouped into a list and displayed in one form element. In this case, any given columns are not displayed.
The items are shown with their display template. The number of items is shown in the form element header. There is also an icon in the form element header for showing and hiding the items.
TIP: If you want a list in the display template with no more than two column names, you can use a table to create a two-column display. |
|
Display columns |
Specifies which columns from the valid object definition are to be displayed in the form element. The columns for the main form element refer to the object definitions of the associated overview form. All other form elements get their object definitions from the menu items. When a link is configured, the selected columns of the referenced menu item are initially copy to the link. The order of displaying the properties in a form element corresponds to the column sort order defined in the menu item.
TIP: If you want to display a line in a form element to visibly separate the information, enter a minus sign (-) in the column to be displayed.
You can use scripts in the column definitions to affect the value displayed in the column. The column definition is activated when you click and hold on the column name. Extend the column definition as follows:
Column[S(script name)]
If columns contain a web address and you want to navigate to this web address, use the URI formatting type for the column definition. This display a link on the overview form. |
Designing the form element header
The menu item display text, display text for the objects to be shown and the menu item icon are displayed in the header of a form element.
TIP: You can open an interface form by clicking the caption in the form element header.
-
To do this, assign a fixed menu item to the interface form that is allocated below the main form element. The interface form, however, must refer to the main form element, for example, a form for assigning this object.
-
Use the option Navigation view in the form assignment view to access forms in the user interface.
Related topics
Previewing an overview form during editing
When you edit an overview form, it is possible to display a preview of it.
To create a preview of an overview form
-
In the Designer, select the User interface > Forms > Overview forms category.
-
Select the overview form and open it in the Overview Form Editor.
-
Select the main form element's table in Table in the Overview Form Editor's toolbar and select a fixed object to use for the Object preview from.
NOTE: In the Object menu, select the No object item to end the preview.
Disabling overview forms and form elements
You can disable single predefined overview forms or single form elements of an overview form if necessary. This prevents them being displayed in the user interface. They remain disabled even after schema installation.
To disable an overview form
-
In the Designer, select the User interface > Forms > Overview forms category.
-
Select the overview form and start the Form Editor with the Edit interface form task.
-
Set the Disabled option.
-
Select the Database > Commit to database and click Save.
To disable a form element on an overview form
-
In the Designer, select the User interface > Forms > Overview forms category.
-
Select the overview form and start the Overview Form Editor with the Edit overview form <form name> task.
-
Select the form element in the design view.
-
Set the option Disabled.
-
Select the Database > Commit to database and click Save.
You can also disable overview forms or single form elements using preprocessor conditions.
NOTE: In the Designer, you can find an overview of existing preprocessor dependencies in the One Identity Manager Schema > Preprocessor dependencies category.
Related topics
