Identity Manager 8.0 - Web Designer Reference Guide

Adding Functions

It is possible to share functions that are already implemented but hidden by using the default web project configuration. If new functions should be added they need to be programmed. Operating processes that are not implemented can be programmed using new modules. For more information, see Create New Module. If an existing operating process is being dealt with the default module being used can be extended. To do this, the module or component in which the new function will be inserted has to be found first.

The following example shows you how to add a function. You want to add the name of the current user to the "Welcome" text on your start page. Before you add a new function, add a new object copy in the example.

To add a function

1. Update the preview in the Web Designer by clicking on and log on in the preview on the login page.

   NOTE: Once you have logged in to the Web Designer, the preview with the login page is loaded automatically.

   For more information, see Working with the Preview.

2. Click "Welcome" link on the preview's start page and select the Properties window in the lower area of the Web Designer.

   The Label control for the "Welcome" text is gray.

3. Mark the Label control and select the Show definition object entry from the context menu.

   The file belonging to the control is opened as a tab in the definition tree view. In this case, it is the default object VI_Start.

4. Mark the Label node and switch to the Copy object view.
5. Specify the settings for the object copy and click Next.

   A new tab is added for the object copy in the definition tree view. In addition, your web project is given a substitution rule.

6. Select the object copy tab in the definition tree view and search for the Label node containing the "Welcome" text.
7. Mark the Label control and switch to the Node editor view.
8. In the Text text box, enter +" "+from user select top 1 display() after translate("#LDS#Welcome") and click in toolbar.

   NOTE: It is important not only to save the object copy with the modified function but also the default object with the automatically added substitution rule.

9. Select the Start page tab in the definition tree view and click Refresh preview.

   The changes you have made are shown in the preview of your web project.

You must create an object copy to retain the predefined default object in its original state. Customer-specific modules can, of course, be edited without making a copy. For more information, see Creating Object Copies with the Wizard.

Pasting in Texts or Captions

In order for texts or captions to be displayed on a web page, a Label node must be pasted into the definition tree.

To paste text or captions

1. Find the place in the definition tree view that represents the desired position on the web page.

   The procedure is the same as creating a new module. For more information, see Create New Module.

2. Mark the relevant node and select Display nodes | Label in the context menu.

   A new Label-type node is inserted in the definition tree view and automatically marked.

3. Switch to the Node editor view and click next to the Text text box.
4. Enter an SQL expression with the relevant caption.
5. Select the relevant action to be executed when text is clicked in the browser, in the Action to execute* option box.

   The following settings are available.

   • Display only
   • Execute action

6. To obtain a valid node definition, the Label node must contain at least one text.

   The new text is shown in the preview window after compiling.

Detailed information about this topic

• Editing Captions
• Multilingual Captions

Pasting in Grids

A grid shows any database content desired in tabular form. To paste in a grid, first find the place in the definition tree that represents the desired grid position on the web page.

To insert grids

1. Find the place in the definition tree view that represents the desired position on the web page.

   The procedure is the same as creating a new module. For more information, see Create New Module.

2. Mark the required Container-type node and select Wizards | Data display from the context menu.

For more information, see Grid Display for Collection Data.

Table 65: Overview of grid configuration options

Setting	Description
Enable the user to sort columns	If this option is enabled, the user can sort the columns in ascending or descending order by double-clicking the column header. This option is generally set for all columns in this dialog box but you can also set it separately for each column in the table.
Sort collection	Use this option to specify an initial sort order in the layer. If this option is not enabled, the data sets are shown in the order that they are in the data set. For example, data sets have a logical sort order if you entered appropriate data when the collection was loaded.
Dynamic column width	Use this option to automatically divide up the column widths based on the length of the entries in the rows by applying an internal optimization algorithm. NOTE: These options relate to how the column width is fixed and can only be used alternatively.
Fixed column width	This option requires input in pixels. All columns in the grid are given the same fixed width.
Custom column width	This option enables the width and the unit (pixel or %) to be edited individually for each column.

3. Configure your settings.

Presets for Grouping Grids

You can use a simple code snippet to preset grouping of grids.

To preset grouping of grids

1. Insert a new Code snippet node after the grid node in Web Designer.
2. Select the property Code on the new node and edit the value.
3. Enter the following source text:

   var dataSource = GridBand1.DataSource;

   var col = dataSource.Table.GetColumn("UID_Department");

   if (!dataSource.GroupingColumns.Contains(col))

   dataSource.GroupingColumns.Add(col);