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: Compile the database to ensure the selection criteria take 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
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 caption 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 captions, the caption of the object definition with the lowest sort order is shown.
Example: Captions based on the sort order of 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 a system role 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.
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 > Save to database and click Save.
The following properties are displayed for objects definitions
Table 100: Object definition properties
|
Exclusive |
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 |
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! |
|
Remarks |
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 modifying the inserted 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 |
Icon for displaying the object definition. |
|
Table |
Table for which the object definition is created. |
