Identity Manager 8.1 - Configuration Guide

Defining insert values

You can use insert values to initialize individual values when a new data set is added over the result list. You can apply insert values to interface forms, object definitions, menu item lists and tables.

Enter insert values in VB.Net syntax. With base., the object that is currently loaded is always accessed. Insert values are described with the following syntax:

• Simple value assignment

  Base.PutValue("<column>", <value>)

• Value assignment with variable replacement (value must be a character string)

  Base.PutValue("<column>", context.Replace(<value>))

All the columns of the table to be displayed may be applied. You can use variable for defining insert values.

Related Topics

• Using variables

Using links

Links support the navigation configuration. Links are implemented to reference frequently used menu items. Parts of the navigation interface that require an application several times, only need to be set up once. The links themselves do not appear in the navigation. Instead the referenced menu items and their child menu items are shown.

Figure 15: Structure of the navigation interface using links in the User Interface Editor (left) and display in the Manager (right).

Special features of using links

• Links inherit some properties of the reference entry.
• You can use variables in the reference entry, for example in conditions for lists or data-dependent menu entries. Value assignment to the variables only takes place in the link. You must define the variables in the link.
• The caption and the icon of the reference entry are overwritten with the corresponding values ​​from the link.

To use links

1. Create the menu item that you want to use as the reference entry.
2. If necessary, create other menu items below the reference entry.
3. Create the menu items that link to the reference entry. Enter at least the following information for the link.
   • Menu item: Enter the name of the menu item.
   • Entry type: Select the entry type Link.
   • Menu item link: Select the reference entry to be shown at runtime when the link is called.
4. Assign an application and the permissions groups.

Related Topics

• Creating a new menu item
• General menu item properties
• Using variables

Using variables

You may use variables to configure identifiers and menu item display templates for menu items in insert values and database queries. In some parts of the navigation interface you have to implement variables as, for example, in the case of formulating database queries for recursive data-dependent menu items.

Variables are inherited within a hierarchical navigation. This means that variables in deeper levels of a hierarchy can be reused or overwritten. The actual run-time value is passed to the variable.

Figure 16: Inheriting Variables in a Hierarchical Navigation Interface

The variables of the session object that are listed below are always available when the menu items are being set up.

Use the following syntax to access the variables:

%<variable>%

Related Topics

• Creating and displaying variables
• General menu item properties
• Creating database queries for data-dependent menu items
• Editing lists
• Using links

Creating and displaying variables

In addition to the variables belonging to the session object, you can also define other variables. The variable definition is made up of variable type, variable name and the value. Basically, any string is permitted in the variable definition. However, events have proved that it is a good idea to use a pattern that is unlikely to occur in the data but is accepted as a string by the database server in use.

Use the following syntax to access the variables:

%<variable>%

To create variables

1. In Designer, select User interface | User interface navigation.

   The menu items are loaded and displayed in the User Interface Editor for editing.

2. Select the menu item in the navigation overview.
3. In the edit view, select Variable definitions.

   In this view, all the variable definitions that belong to the selected menu item are displayed in tabular form with type, name and assigned value.

   TIP: To display variables inherited from parent nodes, click .

4. To create a variable, click and enter the following information.
   • Type of variable: Select Column, Display value or Text.
   • Variable: Enter the name of the variable.
   • Value: Enter the value of the variable. The value to be entered depends on the variable type.

The actual value stored in the variable can be shown in the administration tools as additional navigation information.

To display variable values of a menu item in the Manager

• In the Manager, enable the program setting Show additional navigation information.
• Select menu item in the navigation in the Manager and select Definition | Defined variables.

Related Topics

• Using variables