Chat now with support
Chat with Support

Identity Manager 9.2.1 - Configuration Guide

About this guide One Identity Manager software architecture Customizing the One Identity Manager default configuration Customizing the One Identity Manager base configuration One Identity Manager schema basics
Overview of the One Identity Manager schema Table types and default columns in the One Identity Manager data model Notes on editing table definitions and column definitions Table definitions Column definitions Table relations Dynamic foreign key Supporting file groups
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
Mapping processes in One Identity Manager Setting up Job servers
The One Identity Manager Service functionality Tracking changes with process monitoring Conditional compilation using preprocessor conditions Scripts in One Identity Manager
Visual Basic .NET scripts usage Notes on message output Notes on using date values Tips for using PowerShell scripts Using dollar ($) notation Using base objects Calling functions Pre-scripts for use in processes and process steps Using session services Using #LD notation Script library Support for processing scripts in the Script Editor Creating and editing scripts in the Script Editor Copying scripts in the Script Editor Testing scripts in the Script Editor Testing script compilation in the Script Editor Overriding scripts Permissions for running scripts Editing and testing script code with the System Debugger Extended debugging in the Object Browser
One Identity Manager query language Reports in One Identity Manager Adding custom tables or columns to the One Identity Manager schema Web service integration One Identity Manager as SCIM 2.0 service provider Processing DBQueue tasks One Identity Manager Service configuration files

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

  1. In the Designer, select the User interface > Forms > Overview forms category.

  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 51: Form elements layout
    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 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

  1. In the Designer, select the User interface > Forms > Overview forms category.

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

  1. In the Designer, select the User interface > Forms > Overview forms category.

  2. Select the overview form and start the Form Editor with the Edit interface form task.

  3. Set the Disabled option.

  4. Select the Database > Commit to database and click Save.

To disable a form element on an overview form

  1. In the Designer, select the User interface > Forms > Overview forms category.

  2. Select the overview form and start the Overview Form Editor with the Edit overview form <form name> task.

  3. Select the form element in the design view.

  4. Set the option Disabled.

  5. 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
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating