Identity Manager 8.0 - Configuration Guide

Calling Functions

Functions are stored in the script library (DialogScript table).

Example

Public Function BuildInternalName(ByVal Firstname As String,ByVal Lastname As String) As String

End Function

Usage in template for Person.Internalname:

Value = BuildInternalName($Firstname$, $Lastname$)

Pre-scripts for using in Processes and Process Steps

Pre-script code is code that is executed before other scripts are run. You can define process specific variables. Process specific variables are local data spaces when a process is generated. This enables variables to be defined that can be made further use of within processes and process steps, for exmaple, generating conditions, server selection scripts or in parameters.

Pre-script syntax

values("Name") = "value"

Usage in the following process and process step code sections:

Value = values("Name")

Related Topics

• Using Process Specific and Global Variables for the Process Definition
• Querying Session Object Global Variables

Using Session Services

The session object is the instance which makes data available to the user session. This includes the current user, their user groups and program functions. Furthermore, the session object make various services available for accessing data. The session object services provided are made available through a generic interface (Resolve (Of Service)()). In the following, examples are provided of frequently used service.

Detailed information about this topic

• Querying Configuration Parameters
• Testing the Existence of Certain Database Entries
• Querying Session Object Global Variables

Querying Configuration Parameters

The full path for the configuration parameter always has to entered when configuration parameter are queried.

Syntax

Session.Config().GetConfigParm("<full path>")

When a configuration parameter is tested in a generating condition in VB.Net syntax, the function returns a string. In order to compare this value to a numerical value, the configuration parameter has to be set and contain a numerical value. This depends on the implicit value type conversion from VB.Net. If the configuration parameter is not enabled, the function returns an empty string that cannot be compared to a numerical value.This results in a VB.Net runtime error. Configuration parameter values are therefore always compared to strings.

Do not use:

Session.Config().GetConfigParm("QER\Person\User\DeleteOptions\Homedir")=1

but:

Session.Config().GetConfigParm("QER\Person\User\DeleteOptions\Homedir")=1

In order to ensure that a logical value is always returned, the function VID_IsTrue should be used.

Example

If VID_IsTrue(Session.Config().GetConfigParm("QER\Person\User\DeleteOptions\Homedir")) Then ...

Related Topics

• Testing the Existence of Certain Database Entries
• Querying Session Object Global Variables