Chat now with support
Chat with Support

Identity Manager 8.0 - Web Designer Reference Guide

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

Bookmarks

You can set bookmarks for custom and defined objects at any place in the definition tree view.

To set a bookmark

NOTE: The relevant data object must already be selected and opened in the definition tree view.
  1. Mark the relevant node in the definition tree view.
  2. Select the Set bookmark function from the context menu and enter a description for the bookmark.
  3. Click OK to confirm.

To remove a bookmark

  • Delete the bookmark from the definition tree view context menu.

    This removes the bookmark.

To manage bookmarks

  1. Select Bookmarks in the View menu bar.

    The Bookmarks pane is displayed in the lower area of the Web Designer. This lists bookmarked objects in chronological order.

  2. Double-click an object in the Bookmarks pane.

    Note: The marked object is also shown in the definition tree view. Navigate between bookmarks by pressing F2.

The Bookmarks pane has its own toolbar which is described in the table below.

Table 25: Toolbar for "Bookmarks"
Icon Function

Delete all bookmarks.

All bookmarks are permanently deleted from the list after the security prompt is confirmed.

Edit description.

This opens a dialog box in which a description can be entered for the bookmark. The description can be extended, changed or delete. This function can also be called by right clicking on the selected object.

Delete current bookmark.

This deletes the current bookmark permanently from the list after the security prompt is confirmed. All bookmarks of the marked modules or components are deleted when modules/components are grouped together. This function can also be called by right clicking on the selected object.

Group by module/component.

Bookmarked objects are grouped by their respective affiliation under modules or components and are listed in alphabetical order.

Show bookmarks for current web project only.

This filters bookmarks found in the compiled web project only. Hidden bookmarks are shown again by clicking on the button.

Command List

The command list shows all modifications carried out on the current object in the definition tree view. A command list is kept for each object in the definition tree view. You can use the buttons in the toolbar to undo or redo commands.

Implemented commands are flagged with the icon in the list. This icon is missing for commands that were undone.

The use of wizards allows for automatic implementation of numerous commands, which in the command list are displayed as composite commands and the individual commands are shown at a second level. However, these commands can only be undone through the composite command.

Table 26: Functions in the Command List
Icon Function

Undo.

Undoes the last implemented command in the list.

Redo.

Redoes the last implemented command in the list.

Properties

Once you have successfully compiled a web project, you can call up important information on individual nodes in the Properties view. In this view, you can check the property values of controls during application runtime.

Note: A WCF connection must be created for this function.

The Properties view is divided into three sections. On the left, the ASP.NET control hierarchy is displayed as it was on the web server when the web page was created. The associated database objects and IDs are also listed with the controls. The properties and property values for the controls are displayed on the right.

To view properties of a node you can, for example, click a point in the preview window to view it in more detail in the Properties view. The point is highlighted in the Properties view.

NOTE: This is only possible with display nodes, since only they are displayed in the preview window. Data and action node properties are only displayed in debug mode.

To display a definition object

  1. Click the point in the preview you want to see in more detail.

    The clicked object is marked in the Properties hierarchy.

    NOTE: The items Show definition object and Query here are shown in the context menu if the marked object is a control. No context menu is available if you selected another object type.

  2. Click the marked object with the right mouse button in Properties.

    The items Show definition object and Show query are shown in the context menu.

  3. Click Show definition object.

    The definition object is marked in the definition tree view.

Table 27: Toolbar functions in the "Properties" view
Icon Function

Marks superordinate nodes.

After clicking this button, the parent nodes for the definition object are marked in the Properties view.

Marks subordinate nodes.

Use this button to navigate in the view to a subordinate node in the node tree structure. On the right-hand side of the view in the Property column, the property associated with the node marked is highlighted in color.

 

Closes all nodes and subnodes.

You can close all nodes and sub-nodes in the view with Collapse all entries. Only the root node is visible.

 

Opens all nodes and subnodes.

Use Expand all nodes to expand all nodes and sub-nodes. This displays all levels in the hierarchy.

Displays more details.

Use this button to mark the definition object in the definition tree view and view more details.

Multilingual Captions

In the Multilingual captions dialog box you can add and edit multilingual captions and generate references to nodes in the definition tree view. The dialog box is called up via Edit | Captions in the menu bar.

Multilingual captions are standalone objects and are not saved in web project files. Instead, a reference to the multilingual caption is created in the web project nodes.

Before adding or editing multilingual captions, in your web project you need to define objects that output captions in your web application. Keys are created for these objects. These keys contain a caption for each language. This means that the keys are translated into the different languages you wish to use.

Adding and editing multilingual captions

To add and edit keys and translations, use the Captions tab in the dialog box. Here, the toolbar displays the different functions available. These are listed and described in the table below.

Table 28: Toolbar functions for the "Multilingual captions" dialog box
Icon Function
Add

Adds a new caption.

Delete.

Deletes from the database the caption that is active in the edit view after confirming the security prompt.

Save.

Saves a new or modified caption in the database.

Assign caption.

This button is only enabled if the dialog box was called via a node in the definition tree view. Clicking this button assigns the caption that is active in the Edit view to the node.

NOTE: If you open the dialog box Multilingual Captions when editing a node in the node editor, it contains an extra tab Quick edit with additional settings. In this case, the selected caption is assigned to the relevant node in the same work step.

The following properties are edited to add and edit multilingual captions in the Captions tab.

Table 29: Multilingual captions properties
Property Description
Language Indicates the language in which the caption is written.
Key A unique value assigned for object referencing.
Text The caption to be displayed in the corresponding language.
Custom caption

Custom caption that replaces the standard caption displayed.

With custom captions, it is possible to modify captions in the standard modules without having to create a custom module.

NOTE: You can set the regional language for captions via the Language option box. For example, for the "English" language option, you can select "English - United Kingdom [en-GB]" or "English - United States [en-US]". The settings for the web browser in which you open your web application also play an important role when adding captions in different languages. If a translation into the selected language or regional language is not available in your web browser, a translation from the next family of languages above is sought.

The key that outputs the caption in the web application can be entered and edited manually in an SQL editor. If the node does not have a key, the SQL editor is empty. If a caption exists for a key, the following SQL expression appears in the SQL editor:

translate ("#LDS#<Key>")

In this case, translate stands for calling the associated Web Designer SQL function. #LDS# means that a key containing the caption follows.

If no appropriate translation for a key in the language you want to offer is found, you can create a new caption. The SQL input field in the Quick edit tab is empty when there is no translation. You can manually enter the translation as an SQL expression in the input field.

NOTE: If there is no translation for a language, the preview and web application display the caption that is saved in the Key.
Example:

translate("#LDS#Hello World!")

This SQL expression appears as Hello World! in your web application. There is no translation or caption for the key in the database.

This function is particularly useful during the initial phases of a project, when captions are frequently modified. Until the customer initially accepts the text, only its key is kept updated. Once the text has been accepted, the captions and all necessary translations are implemented.

The Translate function also allows for the use of parameters. When several parameters are used, you do not need to enter the parameter references ({0}) in the key. It is sufficient to enter the parameter references in the caption. If you want to display the parameter reference in the caption, you need to enter the relevant parameters in the function. The following example shows what this variation looks like.

Example with two parameters:

translate('#LDS#Please fill in the field "{0}" on the request "{1}".', datacaption(shoppingcartitem, currentcolumn), from shoppingcartitem select current displayvalue(uid_accproduct))

How to add a caption to a Label-type node is described below.

To add a node directly to a caption

  1. Select a Label-type node in the definition tree view to which you want to add a caption.
  2. Select the Node editor view.
  3. Click next to the Caption input field.

    This opens the Multilingual Captions dialog box.

  4. Select Quick edit.
  5. Perform one of the following tasks.
    1. Enter an SQL expression.
    2. Edit the SQL expression.
  6. Save the changes.

Searching for captions

To edit existing multilingual captions, a search function with several options in available at the top of the dialog box.

Table 30: Search options in the "Multilingual captions" dialog box
Option Description
Search key and value Searches keys and captions.
Search for key only Searches only in keys.
Search for value only Searches captions only.
Search in all available languages Searches all existing languages.

During caption searches, both the standard and custom captions are searched. The search results are shown in the result list, where they can be selected for editing by clicking them.

To search for a caption

  1. Open the Multilingual captions dialog box from the web project menu bar or from the node of choice in the definition tree view.
  2. Narrow your search down using one of the options.
  3. Select a language or regional language to be applied to the search in the Language option box.

    Note: In the Web Portal, captions and other values, such as numbers or dates, are displayed dependent on the regional language settings of the browser you use. When maintaining multilingual captions, you must specify a language which applies for all captions. For more detailed information on languages, see the One Identity Manager Configuration Guide.

  4. Enter part or all of the caption in the search box and click .

    All captions matching the search string are displayed.

    Note: If one of the Search key and caption or Search for key only options is set, the keys shown in the result list are labeled with an asterisk (*).

Related Documents