Identity Manager 9.2.1 - Configuration Guide

A special input field is used for editing scripts. It has an advanced edit mode that provides additional actions.

To switch to advanced mode

• Press Ctrl + Alt + Enter or click the button at the bottom right.

Figure 30: Directly entering a database query

There is additional help provided for creating script code.

Syntax highlighting

The input fields support syntax highlighting depending on the syntax type.

Auto-completion

You can use auto-completion when you write script code. You can enable automatic completion in the input fields with the button in advanced edit mode. This suggests a word to automatically complete the keyword as it is entered. If a keyword is expected at a certain position in the source code, auto-completion comes up automatically after a few letters. Although, after specific characters, such as period (.) or parenthesis ((), automatic completion is always offered. Alternatively, you can use the Ctrl + space shortcut in the relevant positions within the input fields to call up autocomplete.

The amount of scripted code to enter is reduced by displaying the names of properties or functions that can be used. The contents of the list is determined by the key words in the code.

Entering code snippets

Input fields that require data in VB.Net syntax support code snippets. In the Visual Basic category, general code snippets are provided. The Object Layer category contains special code snippets for the One Identity Manager object layer. In the SQL Formatter category, code snippets database queries are formatted from VB.Net.

You can insert code snippets using the following options:

1. Using the icon

   1. Select the icon.

   2. Select the Object Layer, SQL Formatter, or Visual Basic category.

   3. Select the code snippet.

2. Using a shortcut

   1. Press F2.

   2. Select the Object Layer, SQL Formatter, or Visual Basic category.

   3. Select the code snippet.

3. Using an aliases

   1. Enter an alias.

   2. Use Tab to insert the code snippet.

      NOTE: Be aware of case sensitivity when you enter the alias.

Custom code snippets

You can use custom code snippets. To do this, create a CustomSnippets directory in the One Identity Manager installation directory to store the code snippets. Use Visual Studio documentation to develop your own code snippets.

To sort custom code snippets, use the following syntax to enter a sort order in the code snippet header in the code snippet file. When the code snippet is entered, the numbering is hidden.

<Title>(1) Your title for the code snippet</Title>

<Title>(2) Your title for the code snippet</Title>

Inputting values using dollar ($) notation

In input fields where a VB.NET term is expected, a help list opens when you enter $. All properties of the current object are displayed. You can also see a tooltip with a detailed description of the property. When you select a foreign key (FK) column, you can navigate to the columns in the relevant table using the arrow keys. To end the selection in the target column, press Enter or double-click. The complete $ notation for your selection should now be shown in the input column. To close the help list without copying any data, press Esc or leave the input field.

Figure 31: Help list for dollar notation