Chat now with support
Chat with Support

Identity Manager 8.1 - Configuration Guide

About this guide One Identity Manager software architecture Customizing the One Identity Manager default configuration Adjusting the One Identity Manager base configuration One Identity Manager schema basics Editing the user interface
Object definitions for the user interface User interface navigation Forms for the user interface Statistics in One Identity Manager Extending the Launchpad Task definitions for the user interface Applications for configuring the user interface Icons and images for configuring the user interface Using predefined database queries
Localization in One Identity Manager Process orchestration in One Identity Manager
Setting up Job servers in Designer Configuring the One Identity Manager Service Handling processes in One Identity Manager
Tracking changes with process monitoring Conditional compilation using preprocessor conditions Scripts in One Identity Manager Reports in One Identity Manager Adding custom tables or columns to the One Identity Manager schema Web service integration SOAP Web Service One Identity Manager as SPML provisioning service provider Processing DBQueue tasks Appendix: Configuration files of the One Identity Manager Service

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

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.

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.

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.

NOTE: You can find an overview of existing preprocessor dependencies in Designer in One Identity Manager Schema | Preprocessor dependencies.

Related Topics
Related Documents