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

Preprocessor conditions in VB.Net expressions

IMPORTANT: Every modification to preprocessor conditions in VB.Net expressions requires recompiling the One Identity Manager database.

Preprocessor conditions can be used in VB.Net expressions. Script code that is dependent on a preprocessor condition has to be passed in an #if...then...#else statement. To formulate the preprocessor condition, use the preprocessor expressions of the preprocessor-related configuration parameters. You can link preprocessor expressions together with AND, OR, NOT, ().

The interpretation of the preprocessor conditions is not carried out until the script is generated.


#If <preprocessor_condition_1>

’ code, for this preprocessor condition

#ElseIf <preprocessor_condition_2> then

’ code, for this preprocessor condition


' other code



The preprocessor condition ITSHOP is entered in the column definition (table DialogColumn) for the column ADSGroup.IsForITShop. The template in column ADSGroup.DisplayName should reference the column IsForITShop. In order to remain compatible the following construction has to be used for the template:


If $IsForITShop:Bool$ And $UID_AccProduct$ <> "" Then

Value = $FK(UID_AccProduct).Ident_AccProduct$


value = $cn$

End If


value = $cn$

#End If

Related Topics

Evaluation of preprocessor conditions during compilation

In order to become effective on a system-wide basis, every modification to preprocessor relevant configuration parameters as well as modifications to preprocessor conditions on objects and VB.Net expressions requires the One Identity Manager database to be recompiled.

The following is true for compiling:

  • Internal program code in the form of an #if...then...#else statement is created for objects that have a preprocessor condition. Program code in sections whose preprocessor condition does not apply basically do not exist for the compiler and are not parsed by the compiler. Therefore these objects are not considered to exist.
  • VB.Net expressions that contain preprocessor conditions are compiled. The program code exists. The interpretation of the preprocessor conditions is not carried out until the script is generated.

These templates are valid for compiling:

  • Templates for columns that are disabled by preprocessor conditions are not compiled and the resulting relations are not saved in the table DialogNotification. These columns are therefore considered to be non-existent.
  • Templates that relate to disabled columns cause a compiler error message if the corresponding part of code is not linked in a preprocessor statement.

Scripts in One Identity Manager

Scripts are used in One Identity Manager to monitor and maintain data consistency and customer business logic in the database. Scripts can be used to:

  • Test column values
  • Trigger events
  • Create, change and delete objects and therefore manipulate the database
Detailed information about this topic

Using scripts

The One Identity Manager scripts are written in VB.Net syntax, which allows all VB.Net functions to be used. The values to be edited are given as preprocessor instructions.

NOTE: You can find detailed examples for syntax and usage of scripts on the installation medium in the directory QBM\dvd\AddOn\SDK\ScriptSamples.

You can use scripts in:

  • Templates and formatting scripts (DialogColumn table)
  • Table scripts (DialogTable table)
  • Script library (DialogScript table)
  • Tasks (DialogMethod table)
  • Object definition selection scripts (DialogObject table)
  • Views selection scripts (DialogTable table)
  • Scripts to find the servers to execute process steps (Job table)
  • Process step parameters (Jobrunparameter table)
  • Process control notification (Job table)
  • Generating conditions for process steps and processes (Job and JobChain tables)
  • Process step and process pre-scripts (Job and JobChain tables)
  • Process information (Job, JobChain and JobEventgen table)
  • Mail templates (table DialogRichMailBody)
Related Documents