Object definitions for the user interface
The data in the user interface is represented by objects. Objects in the user interface map the data stored in the database. These objects can be configured and enable data to be distinguished by specific properties.
User interface forms and task definitions are linked to object definitions and displayed depending on the selected object definition. Object definitions provide an additional control function for configuring the user interface.
You can assign several objects to each table in the One Identity Manager schema. Basically, each database table should have at least one object definition that is generally valid, that means, without limited selection criterion. Other object definitions then relate to the respective special case limited by the general case.
TIP: To create object definitions for new tables, run the Missing DialogObject consistency check in the Designer and use the repair method. You must edit object definitions created like this afterward.
Table 30: Example relationship between tables and user interface object definitions
|
ESet |
System roles (ESet) |
None |
|
ESet |
System roles for IT Shop (ESet_ITShop) |
System roles that can be excluded from the IT Shop |
Detailed information about this topic
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 (True) or False (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 system roles for the IT Shop
Selection script to determine at runtime whether this data record concerns a system role for the IT Shop:
Value = $IsForITShop:Bool$
Condition (WHERE clause) to determine whether this system role concerns the IT Shop:
IsForITShop=1
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.
This value can be overridden by a list title that is defined specifically for the menu item.
-
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.
Example:
Table 31: Captions depending on the sort order of the object definitions
|
System roles (ESet) |
None |
99 |
System roles |
|
System roles for IT Shop (ESet_ITShop) |
System roles that can be excluded from the IT Shop |
8 |
System roles for IT Shop |
When you select an employee in the result list, the related caption is System roles. If the system role is also labeled for the IT Shop (IsForITShop=1), this object is assigned to another object definition by means of the VB.Net expression and the display text System roles for IT Shop is used.
Related topics
Creating and editing object definitions
Predefined configurations are maintained by the schema installation and cannot be edited apart from a few properties.
To create or edit an object definition
-
In the Designer, select the User interface > Object definitions category.
-
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.
-
Enter the object definition's main data.
-
Select the Database > Commit to database and click Save.
Related topics
