Chat now with support
Chat with Support

Identity Manager 9.0 LTS - Web Designer Reference Guide

The Web Designer editor Web Designer structures and functions The Web Designer object model Working with the Web Designer Web project configuration options Customizing the Web Portal Basics of Web Designer programming Compiling and debugging Monitoring Frequent tasks in the Web Portal

Collections as data sources for controls

Some control types can load required data from the database themselves, assuming Database was selected as data source.

  • The control type Tree load data from a database table depending on hierarchy level. First of all, the root level is loaded; the second level is loaded by expanding a node and so on.

  • The control type Grid loads data depending on the selected page. If, for example, 20 entries are displayed per page, then initially only the first 20 database objects are loaded from the database.

This reduces memory usage and the control can be displayed faster.

Collection events

You can define actions to be run if a specified operation is applied to the collection data. Events can be triggered by the following.

Table 59: Overview of the operations used
Operation Description
Insert A single row was added to the collection.
Delete A single row was deleted from the collection.
Update

A single collection data value was updated.

Bulk A set of rows was added to the collection or deleted from it.

To define an event

  1. In the navigation view, select a module or component.
  2. In the definition tree view, mark the Events node and, in the context menu, select the Object in extension > Event handling menu item.

    The view switches to Configuration (custom) and the new Insert subnode is selected. In Node editor, you can manage the following settings.

    Table 60: Settings for event handling
    Setting Description
    Identifier (optional) Enter the name for the event.
    Operation* Select one of the operations listed above.
    Collection* Select a collection in the option box. You can navigate to the selected collection using and apply further settings if necessary.
    Control-ID* A Control-ID is preset. You can overwrite this.
  3. Adjust any settings you need to and then click in the toolbar.

To define an expression-based event

  1. In the navigation view, select a module or component.
  2. In the definition tree view, mark the Events node and, in the context menu, select the Object in extension > Expression-based event menu item.

    The view switches to Configuration (custom) and the new subnode is marked. In Node editor, you can manage the following settings.

  3. Open the SQL field of the Value* box using .
  4. Enter a value for the expression-based event and click Apply.
  5. Save with .

Assigning collections to components

Before you can assign a collection to a component, you must prepare the custom component to make it suitable for the collection.

To do this, the component requires a "virtual collection", which you will find under the component’s Property node in the definition tree view. Collections are assigned in the "virtual collection".

"Virtual collections" defined on components are marked as compulsory or optional.

Compulsory "virtual collections" must be assigned to a location collection. This assignment is made where the component's usage is defined.

Before you assign a collection to a component, a node must be configured under Collection mapping

Collection mapping nodes are automatically assigned when a component reference is added. These nodes are added automatically but not configured. You configure them in Node editor. You can also add a Collection mapping node with the help of a wizard that you can call from the context menu. Another option for adding these nodes, is to add a single node that you can also access through the context menu of your component in the definition tree view.

NOTE: The following instruction steps are based on an example of a direct container reference.

To assign a collection to a component

  1. In the definition tree view, select the tab of the component or module, in which you want to use a Container type component.
  2. Mark a Container type node and, in the context menu, select the Component reference > Container (reference) menu item.

    NOTE: If you add a component reference, the subnodes for collection mapping are automatically added. If more nodes are required for collection mapping, you can either add a Collection mapping type node yourself or by using the wizard. Other nodes may be added when you add a node with the wizard. You can delete these afterward.

  3. In the Note editor view, in the Identifier field, select the component you want to reference.
  4. In the definition tree view, select the Collection mapping node.
  5. In the Node editor view, select the relevant collection under Virtual collection.
  6. In the Map to local collection field, select a collection.

To define a virtual collection for a user-defined component

  1. Select a custom component to which you want to assign a collection.

    This displays the object in the definition tree view.

  2. Mark the Properties node and, in the context menu, select the Virtual collection menu item.

    This adds a new virtual collection in the definition tree view.

  3. In the Node editor, in the Identifier field, enter a name for the virtual collection.

    NOTE: Use Object type and Cursor required to limit collection assignment further. Use Object type to ensure that the assigned collection must be a database collection of the given type. Use Cursor required to specify the point of the assigned collection which must be within an iteration above this.

Declaring configuration keys in modules and components

To declare a configuration key for a module or a component

  1. In the definition tree view, click and open the Configuration node.
  2. In the context menu, select the Configuration section item.
  3. In the definition tree view, mark the new configuration section.

    You can see that the new configuration section is selected with empty fields in Node editor.

  4. Enter the name for the new configuration section in the Identifier and Description fields in Node editor.

    The configuration section is displayed with its name in the definition tree view.

  5. Mark the configuration section.
  6. In the context menu, select the Parameter item.

    The new parameter is added under the configuration section.

  7. Mark the new parameter.
  8. In the Key field, enter a name for the configuration key.
    • Example of a configuration key name: CCC_ConfigParm_Hyperview_HR
  9. In the Identifier field, enter the name from the Key field in the following way:
    • Example for input: translate('#LDS#HR_Hyperview_Colums')
  10. In the Description field, enter the field to be display in the Settings... view under Details.
    • Example for input: translate('#LDS#Choose Columns for HR-Hyperview')
  11. In the Type field, select the parameter type and edit the configuration key as in the sections about parameter types.

    NOTE: You may have to edit further settings depending on which parameter type you selected.

Detailed information about this topic
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating