Identity Manager 8.0 - Web Designer Reference Guide

Extensions

In some cases, it is sufficient to add or delete a node, to change single properties within an object. In such cases, extensions are best suited to configuring the web application. This method of configuration allow you to describe changes to an object.

How Extensions Work

You can add any number of extensions to the Web Designer's base object module, component and web project. Some default extensions are already supplied when the database modules are installed. You can add custom extensions yourself.

Extensions are edited when you configure the base objects. That means you add an extension to the object and change the property value. You then compile the base object and the modification resulting from the extension is highlighted in the Web Designer.

You can identity base objects, which you want to extend, by their colored nodes in the Objects definitions view in the definition tree view. You edit extensions in the Configuration (custom) view.

Figure 1: Workflow in the Web Designer

To overwrite a single property in an extension

1. Mark the extension node you want in Object definition.
2. Click in the Node editor's toolbar. This highlights the extension node's setting being edited.
3. Click at the marked place.

   This swaps you to the Configuration (custom) view and marks the node with the modified property value.

4. By clicking on in the Node editor you switch back to the Object definition view.

   NOTE: You can swap between Configuration (custom) and Object definition views with the button, if the extension is found under the Add node or Remove node node.

Extension Rules

Each extension is its own object in the Web Designer. The advantage of extensions is that database objects that have been extended are updated by migration without the database objects being overwritten. This does not apply in the case of object copies. In that case, the copy is not updated on migration.

The following extension rules are listed in the table.

You add a new node in the definition tree view using the context menu on your selected node. The entries in the context menu vary and depend on which type of node you are adding the extension node to. You can, for example, add new form or component nodes.

Because there are numerous types of node, which can be added to, the example of how to add a node is based on a node of type title.

To add a new node

1. Double-click the relevant base object in the navigation view.

   The selected base object is displayed in the Object definition (read-only) view in the definition tree view.

2. Mark the node, for example 'Title' and select the Object in extension | New node from the context menu.

   NOTE: You can also select another item as New node if you know on which node type to base the extension.

3. Select the node type button from the list in the dialog box New nodes and confirm with OK.

   The new node is added with a custom prefix and a mark in form of a bar under the selected node. is displayed at the bottom of the definition tree view. Use to go to the definition object.

4. Edit the new node in the Node edit view. You might configure the following settings.

• Enter a name for the button in the Text box.

  NOTE: The text must be enclosed in quotes.

  The button is displayed in the definition tree view with the name you entered.

To modify the position of an extension node.

1. Mark the nodes you added in the step-by-step "To add a new node", in the Object definition view in the definition tree view.
2. Switch to the definition object by click in the definition tree view.

   The edited new node is displayed in the Configuration (custom) view in the definition tree.

   In the custom configuration view, you can, for example, edit the position of the button. This is how you do this.

3. Mark the node Add node above the node you added in the Configuration (custom).
4. Enter the value "0" in Sort order in the Node editor view.

   The value is displayed after the Add node node (sort order: 0). You will see the change after compiling the preview. When you swap back to the Object definition (read-only) view, you will see that your added node is placed above the extension you marked.

You can move nodes, which are on a parent node in an extension. This assumes that the node to move is on a custom object which is not write protected. An example of this would be objects found in a container node. Other examples of moveable extension nodes are columns in a collection or parameters of a configuration parameter section.

To move a node

1. Double-click the relevant base object in the navigation view.

   The selected base object is displayed in the Object definition view in the definition tree view.

2. Enable the view in the definition tree view using .
3. Mark a node and select Move to extension from the context menu.

   The node is marked in color as in the extension mode.

A change can take the form of extending viewing conditions for a container, for example, as explained below. Other changes are not gone into here. For more information, see How Extensions Work.

To edit a property

1. Click next to Viewing condition in the Node editor view.

   The view switches to Configuration (custom) and the Modify property value extension is selected. You can edit the extension.

2. Enter the value "1=1" in Condition in the Node editor view.

The edited extension is displayed with the modification in the definition tree view and in the preview. The edited node is marked with in the definition tree view.

Before you can delete the node, you must create a deletion rule for the mode in question. You can only add a deletion rule to a node that does not contain an extension.

A use case would be if you want to remove a container node from a write protected base object.

To create a deletion rule

• Mark the node to delete in the Object definition view and select Delete node as an extension from the context menu.

  The node changes its colored mark and you can see the message, Remove node in the Node editor. You can also see this message on the extension when you swap to the Configuration (custom) view.

To remove a deletion rule

1. Mark the node Remove node in the Configuration (custom) view when you want to remove the extension again, and select Delete from the context menu.

   NOTE: The menu item Delete is only available to custom objects.

2. Delete the extension from the definition tree view by selecting Yes.

Creating New HyperViews

You can use this wizard to create new Hyper Views or Hyper View shapes or to import existing ones.

To import an complete Hyper View

1. Click in the toolbar.
2. Select the Import a complete Hyper View option in the Hyper View wizard dialog box.

3. Select an element from the list on the Select central element page and click Next.

4. Disable the dependent elements you do not wish to display on the Select dependent elements page and click Next.
5. Enter the component identifier in the text field on the Details and layout page and click Next.

   The Wizard closed page is shown and the component is created.

6. Close the dialog box with Finish.

To import one or more Hyper View shapes

1. Click in the toolbar.
2. Select the Import one or more Hyper View shapes option in the Hyper View wizard dialog box.

3. Select a Hyper View from the list on the Extend an existing Hyper View page and click Next.

4. Disable the dependent elements you do not wish to display on the Select dependent elements page and click Next.

   The Wizard closed page is shown and the component is created.

5. Close the dialog box with Finish.

To define a new Hyper View shape

1. Click in the toolbar.
2. Select the Define a new Hyper View shape option in the Hyper View wizard dialog box.

3. Select a Hyper View from the list on the Extend an existing Hyper View page and click Next.

4. Select a database table in the Base table selection box on the Information on new Hyper View shape page.
5. Enter a definition in the WHERE-clause SQL input field and enter a name in the text field for the new shape.

   The Wizard closed page is shown and the component is created.

6. Close the dialog box with Finish.