Chat now with support
Chat with Support

Identity Manager 8.1.4 - 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 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 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
Using scripts Notes on message output Notes on using date values 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 of scripts in 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 executing scripts Editing and testing script code with the System Debugger Extended debugging in the Object Browser
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 One Identity Manager Service configuration files

Selection criteria for object definitions

The table entries to be displayed are found through a selection script and an object definition condition.

  • Formulate a selection script as a VB.Net expression which returns either True or False, depending on whether or not the transferred data record belongs to this object definition.

  • Formulate a condition as a WHERE clause database query so that an object definition can also be used for display in result lists.

IMPORTANT: You must compile the database for the selection criteria to come into effect.

Example displaying employees flagged with the “Dummy employee” property

Selection script to determine at runtime whether this data record concerns a dummy employee:

Value = $IsDummyPerson:Bool$

Condition (WHERE clause) to select all “dummy employees”:


Related topics

Using the captions for object definitions

You can define the following captions to represent each object definition in the administration tool user interface.

  • List caption

    The list caption is used in One Identity Manager tools as the title for result lists. The display text of the object definition that you specified through the selected menu item, is used as the list title.

  • Form caption

    The form caption is used to display the current object definition, for example, in the Manager's status bar.

The current object definition is determined when an item in the administration tool result list is selected. Valid object definitions and thereby the possible captions are determined by selection scripts. From the possible display texts, the caption of the object definition with the lowest sort order is shown.

Table 32: Captions depending on the sort order of the object definitions
Object definition Selection script Sort order


Employee general




Employee dummy

Employees labeled as dummy.


Dummy employee

When you select an employee in the result list, the related caption is Employees. If the employee is labeled as a dummy employee, this object is assigned to another object definition by means of the VB.Net expression and the Dummy employees caption is used.

Related topics

Editing object definitions

Predefined configurations are maintained by the schema installation and cannot be edited apart from a few properties.

To define objects definitions

  1. In the Designer, select the User interface | Object definitions category.

  2. Select one of the object definitions in the list.

    - OR -

    From the menu bar, add a new object definition using the Object | New. menu item.

  3. Enter the object definition's master data.

Related topics

Object definition properties

Table 33: Object definition properties
Property Description


Objects labeled with this option are considered exclusive. That means, all other possible matching object definitions are not accepted as valid. If several object definitions of one table are labeled as exclusive, the object definition with the lowest sort order applies.

Display template

The display template specifies the form in which the data sets in the administration tool result lists are displayed.

Display name

The object's display name is used, for example, to identify the table in a database search or for error output. Display names can be given in more than one language.

List caption

Caption used to display the list title in the user interface.

Form caption

Caption used to display the form title in the user interface.

Selection script

Selection script as a VB.Net term, to determine during runtime whether the database object passed down belongs to this object definition.

NOTE: The database needs to be complied after changing modifying the selection script.

Processing status

Object processing status. The processing status is used for creating custom configuration packages.


Condition required for the object definition to be used for displaying in lists. You define the condition as a valid WHERE clause for database queries.

NOTE: The selection script and the condition must match. If one of the properties is given then the other one also has to be given!


Text field for additional explanation.

Disabled by preprocessor

If an object definition is excluded through a preprocessor condition, this option is set by the Database Compiler.

Insert values

Default settings for fields that are assigned when a new data set is added. The input is in VB.Net syntax.

NOTE: The database needs to be complied after changing modifying the values.

Background color

Color, with which the control for this object is displayed in the schema overview.

Object name

Name of the object.

Preprocessor condition

Object definitions can have preprocessor conditions added. This means, an object definition is only available when the preprocessor condition is fulfilled.

Sort order

The sort order is used for displaying the form title when an object is selected. The smaller the sort order magnitude, the stronger the restrictions defined for the object.


Icon for displaying the object definition.


Table for which the object definition is created.

Related topics
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating