Identity Manager 8.1 - Configuration Guide

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.
• You enter the name of the main form element in the configuration data of the user interface form in the SpecialSheetData section.

  Example:

  <DialogSheetDefinition FormatVersion="1.0">

  <SpecialSheetData>VI_Person_Person_Overview</SpecialSheetData>

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

• Creating overview forms
• Adding more form elements to an overview form
• Layout of form elements
• User interface form properties
• Forms for custom extensions

Layout of form elements

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

1. Select User interface | Forms | Overview forms in Designer.
2. Select the overview form and open it in the Overview Form Editor.
3. Select the form element in the design view.
4. Select the tab Layout in the Properties view and change the properties.

   Table 55: Layout information for form elements

   Property	Meaning
   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 of the form element for displaying 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. Any columns that are given are not displayed in this case. The items are shown with their display mode. There is an icon in the header for showing and hiding the items. There is an icon in the header for showing and hiding the items. TIP: If you apply a list display mode with no more than two column names, you can set up a table in the display mode to achieve a two-column alignment.
   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: To display a separator line in a form element to optically separate the information, enter a minus sign (-) as 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)]

Designing the Form Element Header

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

Previewing an overview form during editing

To create a preview of an overview form

1. Select User interface | Forms | Overview forms in Designer.
2. Select the overview form and open it in the Overview Form Editor.
3. 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 preview from Object.

   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

1. Select User interface | Forms | Overview forms in Designer.
2. Select the overview form and start the Form Editor with the task Edit interface form.
3. Set the option Disabled.

To disable a form element on an overview form

1. Select User interface | Forms | Overview forms in Designer.
2. Select the overview form and start the Overview Form Editor with the task Edit overview form <form name>.
3. Select the form element in the design view.
4. Set the option Disabled.

You can also disable overview forms or single form elements using preprocessor conditions.

Related Topics

• Deleting form elements
• Deleting overview forms