Links

Creating a simple link

Creating a Link with Pivots

Creating a Complex Link

Logical Ancestors

Links make it possible to bind different resource types.

Defining Links between Resources

A link allows a user to navigate in the data available—that is from a source resource to one or more target resources. For example, from a particular location, users want to be able to access a list of P people working in this location by following a link.

The number of links is unlimited. COGNITUM scrutinizes the lookup behavior and prevents the same resource to be called more than twice, thus avoiding linkage loops.

For instance, A and B are two types of resources connected by a link L, and A1 is an instance of resource A. The relationship can be expressed as L(A1)=(B1,B2,…Bn) where B1, B2, Bn are instances of resource B.

Creating a link

Creating a link is performed through the Link Creation wizard accessible with a click on the New Link toolbar button.

The New Link wizard displays the Name and Resources first step screen. Naming the link and selecting the resources to link stand for the first step of the link creation.

Figure: New link definition

Application This is the application for which the link is to be created. A click in the list box allows to change applications. When the wizard is launched from a selected resource of an application, the application is already selected.

Source Resource This is the resource standing for the starting point of the link. A click in the list box allows to change resources defined under the same application.

Target Resource This is the resource required as a result of the link. A click in the list box allows to change resources defined under the same application.

Name This is the name of the link as it is displayed in the COGNITUM Console. The wizard assigns a default name to the link when it has been launched from the context menu of a resource in the tree. A custom name can be entered. Non-alphanumerical characters and blank spaces are prohibited.

A click on the Next button displays the second screen of the wizard with the three types of links that can be created.

Figure: New link type

Simple Link: It is a direct link between two resources.

Link with Pivots: This type of link must pass through intermediate resources so as to reach the target resource. The intermediate resources are called pivots. Pivots are used because the target resource cannot be reached directly from the source resource.

Complex This is a link composed of several simple links. The number of simple links used is not limited. The result of each simple link can be used in another link provided that the result comes from a link previously created.

A click on Next updates the wizard according to the selected link type:

• Simple Link, see “Creating a simple link”,
• Links with Pivots, see “Creating a link with pivots”,
• Complex Link, see “Creating a complex link”.

Creating a simple link

Creating a simple link consists in binding two resources. The Simple Link option must have been selected in the Link Creation wizard—see “Creating a link”.

Figure: New simple link creation

Once the Simple Link option is selected, a click on the Next button displays the third screen of the wizard.

Figure: New simple link definition

In the Type list box, the link behavior must be selected. It is configured in the Description box before COGNITUM compiles the request in the bottom area.

Bottom to Top Hierarchy: This link is based on the directory hierarchical structure. The destination (target) is reached by going back up one or several levels in the tree from the source.

A click on the Level hyperlink in the Description area opens up a dialog box to be filled in with the number of levels the link must go up in the directory tree. Once defined, this number can be modified with a click on the hyperlink.

The Navigation expression area displays the LDAP syntax of the link defined.

Top to Bottom Hierarchy: This link is based on the directory hierarchical structure. The link is computed by retrieving all the target resource instances located under the source instance either one level below or in the whole sub-tree

A click on the Level hyperlink in the Description area opens up a dialog box to be filled in with the scope of the link:

• One Level means that the search is performed on all direct descendents (one level below) of the source resource.
• Sub Tree means that the search is performed on all entries located in the directory branches below the source resource (whole tree).

Once defined, the scope can be modified with a click on the hyperlink.

The Navigation expression area displays the LDAP syntax of the link defined.

Navigation: This link allows to navigate from the source to the target with the DN-type attributes located in the source. Navigating from a user to his/her secretary is made possible. Going back up in the tree is also a possible navigation. A click on the Target of Navigation hyperlink opens up the Navigation Target Selection dialog box. A click in the list box of the dialog box displays the navigation targets available:

• up() allows to navigate toward the parents of the source resource.
• Attributes is a link towards one of the DN-type attributes.

Once defined, the scope can be modified with a click on the hyperlink.

A click on the Delete an attribute of Navigation hyperlink opens up the Attribute Deletion dialog box. In the Attribute Deletion list box, the attribute to delete can be selected.

The Navigation expression area displays the LDAP syntax of the link defined.

Join on Attributes:

This link consists in matching one or several attributes of the source resource with an attribute of the target resource. Matching those attributes is possible with a click on the query hyperlink which opens up the Query Builder dialog box.

The Query Builder helps link an attribute of the source resource with an attribute of the target resource. In the list boxes, attributes and operators must be selected properly so as to make a sentence translating the request. In the Result area, the sentence corresponding to the request is displayed.

Once created, a query can be deleted with a click on it and by clicking the Delete the Query button in the Query Builder. It can also be modified as a click on it opens up the Query Builder to enter modifications.

A click on the Apply button validates the query and closes the Query Builder box. Back in the wizard, a new query can be added with a click on the query hyperlink.

The request area displays:

• LDAP syntax of the link defined when the resources are LDAP compliant,
• logical or SQL request of the link defined when the target resources are RDBMS compliant. The request follows the LDAP syntax—for example (&(attr1='xyz')(attr2='abc'))—with the logical elements in the COGNITUM Console. The corresponding SQL filter is generated.

Advanced Join: This link allows to create all the type of links previously mentioned. However, the Query Builder for this type of link offers more query building parameters such as the value parameter that allows to allocate any value for the link definition.

A click on the Apply button validates the query and closes the Query Builder box.

A click on the Query hyperlink opens up the Query Builder. For more information, see the description of the Join on Attributes behavior type. A new query can be added with a click on the Query hyperlink.

When the resources are LDAP compliant, a click on the Base DN of the resource hyperlink opens up the Definition of Context and Scope dialog box. A click on the Base DN list box displays the available entries.

When you select the DN of the parent of the resource N option in the Base DN list box, a new area is displayed below. The number of level(s) to go up to reach the parent location must be entered or selected in the list.

When you select the Other DN value in the Base DN list box, a new area is displayed below in which the DN of your choice must be entered.

The Scope list box must be populated with the depth of search value. A click on the list box displays the values available.

Once configured, the Base DN can be modified with a click on the hyperlink created. The scope definition can be modified with a click on the Scope hyperlink facing the label.

The request area displays:

• LDAP syntax of the link defined when the resources are LDAP compliant,
• logical request or the SQL syntax of the link defined when the resources are RDBMS compliant.

A click on the Finish button creates the simple link.

Further descriptive information can be entered with the Edit Description command accessible with a right-click on the link in the tree.

To create a simple link

1. In the COGNITUM Console, click the New Link toolbar button.
2. The first screen of the New Link wizard is displayed. In the Application list box, you can select another application for which you want to create a link, when not selected contextually.
3. In Source Resource, select the resource you want to set as the starting point of the link.
4. In Target Resource, select the resource you want to set as the result of the link.
5. In Name, you can change the default name for the link in the COGNITUM Console.
6. Click Next to display the second screen of the wizard.
7. Select the Simple Link option.
8. Click the Next button to display the third screen of the wizard.
9. In the Type list box, select the behavior of the simple link.
10. In Description, configure the link with the hyperlinks displayed, as required. For more information see “Creating a simple link”.
11. Check the syntax of the link request in the bottom area of the wizard.
12. Click the Finish button to validate the creation of the link.

Creating a Link with Pivots

Creating a link with pivots consists in binding two resources through an intermediate resource. The Link with Pivots option must have been selected in the Link Creation wizard—see “Creating a link”.

Figure: New link with pivots creation

Once the Link with Pivots option is selected, a click on the Next button displays the third screen of the wizard.

Figure: Pivot 3rd screen

Figure: Pivot selection

As pivots are intermediate resources used to link the source resource with the target resource, the First Resource Selection dialog box pops up. A click on the list box displays all the intermediate resources available.

Once the intermediate resource is defined, it is displayed as an hyperlink in the Description area of the wizard. The intermediate link hyperlink shows the to Configure argument inscription meaning that the link must be set up. A click on the hyperlink opens up the Simple Link Creation dialog box allowing to configure the intermediate link. To configure a simple link, see “Creating a simple link”.

Back in the wizard, a click on Add a resource allows to add a new intermediate resource, as above described. When necessary, a click on Delete an intermediate resource allows to remove an intermediate resource.

A click on Finish in the wizard creates the link.

Further descriptive information can be entered with the Edit Description command

accessible with a right-click on the link in the tree.

To create a link with pivots

1. In the COGNITUM Console, click the New Link toolbar button.
2. The first screen of the New Link wizard is displayed. In the Application list box, you can select another application for which you want to create a link, when not selected contextually.
3. In Source Resource, select the resource you want to set as the starting point of the link.
4. In Target Resource, select the resource you want to set as the result of the link.
5. In Name, you can change the default name for the link in the COGNITUM Console.
6. Click Next to display the second screen of the wizard.
7. Select the Link with Pivots option.
8. Click the Next button to display the third screen of the wizard.
9. In the First Resource Selection dialog box, select the resource to define as the first intermediate resource.
10. In the Description area of the wizard, configure each intermediate resource with a click on the related hyperlink. Configure the intermediate links the same way as for simple links. For more information, see “Creating a simple link”.
11. Click Finish to validate the link.

Creating a Complex Link

Complex links are based on the connection of several simple links results. Each of those results define the complex link. Those results can be used in the other links defining the complex link. The Complex Link option must have been selected in the Link Creation wizard—see “Creating a link”.

Figure: New complex link creation

Once the Complex Link option is selected, a click on the Next button displays the third screen of the wizard.

Figure: New complex link definition

In the Description area of the third screen of the wizard, a click on the Create new link hyperlink opens up the Link Definition dialog box.

Figure: Link Definition box

In the Link Definition dialog box, the source resource and the target resource must be selected by clicking the respective list boxes. Both resources stand for the resources to be linked by a complex link.

Once the resource source and the target resource are defined, a corresponding hyperlink is displayed in the Description area of the New Link wizard. The hyperlink is followed by the to configure argument meaning that the link must be configured. A click on the hyperlink opens up the Simple Link Creation dialog box allowing to configure a simple link. To configure a simple link, see “Creating a simple link”.

After creating a number of simple links, it is necessary to bind them. Using the result of a link previously defined into another link is achieved by creating an Advanced Join type simple link. After selecting the Advanced Join option in the Type list box of the Simple Link Creation dialog box, a click on the query hyperlink opens up the Query Builder dialog box.

Figure: Query Builder box

In the attribute role list box, the parent of level or the previous result values can be selected to be applied into the link definition.

Back in the New Link wizard, a click on Finish validates the complex link.

Further descriptive information can be entered with the Edit Description command accessible with a right-click on the link in the tree.

To create a complex link

1. In the COGNITUM Console, click the New Link toolbar button.
2. The first screen of the New Link wizard is displayed. In the Application list box, you can select another application for which you want to create a link, when not selected contextually.
3. In Source Resource, select the resource you want to set as the starting point of the link.
4. In Target Resource, select the resource you want to set as the result of the link.
5. In Name, you can change the default name for the link in the COGNITUM Console.
6. Click Next to display the second screen of the wizard.
7. Select the Complex Link option.
8. Click the Next button to display the third screen of the wizard.
9. Click the Create new link hyperlink to define a simple link. In the Link Definition dialog box, select the source and target resources to link.
10. Back in the New Link wizard, click on the link hyperlink to configure it.
11. In the Simple Link Creation dialog box, configure the link the same way as for simple links. For more information, see “Creating a simple link”.
12. After configuring several simple links, configure the new link as an advanced join. In the Query Builder box, select the parent of level or the the previous result attribute role to apply a result of a previous link into the new link.
13. Back in the New Link wizard, click Finish to validate the creation of the complex link.

Creating a link by operation

A link by operation is based on the results returned by sub-links.

An intermediate link with operations can be created in the Definition tab of an existing link in the tree.

Figure: Link by operation creation

In the Physical Definition area, a click on the Insert button makes it possible to create an intermediate link. A new intermediate link tab is inserted automatically.

Figure: Physical definition of an intermediate link

Operation: This option must be selected to display the parameters for operations on the result returned by sub-links.

Based on resource: This is the main resource used for the operation. A click on the list box makes it possible to change it.

Union: With this option, the operation is the aggregation of the results returned by the sub-links in the facing area.

Intersection: With this option, only the data shared by the returned results of the sub¬links are taken into account.

Difference: It is the returned results deducted by the results of the sub-links.

Insert/Remove: The buttons make it possible to add/remove existing links as sub-links for the operation.

A click on Apply validates the link definition.

To create a link by operation

1. In the COGNITUM Console, select an existing link and choose its Definition tab.
2. In the Physical Definition area, select the tab corresponding to the intermediate link; or click Insert to add one.
3. Choose the Operation option.
4. In Based on resource, selected the main resource used for the operation.

5. Choose one of the following operation option:

6. Union to aggregate the results returned by the sub-links in the facing list, or

7. Intersection to retrieve only the results common to the sub-links in the facing list, or

8. Difference to retrieve all the results, but the ones returned by the sub-links in the facing list.

9. Add another sub-link with the Insert button next to the sub-links list.

10. Click Apply to validate the link.

Internal links process

COGNITUM processes links through specific mechanisms. Understanding them may prove useful in order to implement links which must meet peculiar needs.

Link evaluation process

When end-users browse through data with linked resources, COGNITUM instantiates—that is, evaluates—the links. Instantiating a link is the process allowing to get the target resource instances from a source resource instance.

Simple links

The engine evaluates a simple link for an LDAP-compliant resource as follows:

• Base DN instantiation
• Filter instantiation
• Request(s) execution

Base DN instantiation

Instantiating a Base DN may lead to one or several DNs.

Example:

• Base DN=$this. The evaluation retrieves the source instance DN.
• Base DN=$this.uniquemember. The evaluation retrieves all the DNs of the group members.
• Base DN=$this.uniquemember.secretary. The attribute must be defined as a DN aiming at a resource of employee type that includes the secretary attribute. The evaluation retrieves all the DNs of all the group members secretaries.
• or Base DN=$this.(employee)uniquemember.secretary where the aimed resource is considered as of employee type for the link.

Filter instantiation

The filter may contain multi-valued data ($result, for example). The instantiation then leads to one or several filters. The link evaluation corresponds to a two-level loop.

• For each Base DN possible:
• And for each filter possible:
• Performing the query
• Adding the result into the list of results
• Removing the doublets

The process is efficient but tends to use a large proportion of machine resources when mishandled. It is strongly recommended to parse queries generated so as to adjust the directory indexes accordingly.

Links with pivots

A link with pivots is composed of several simple links evaluated in their definition order. Each simple link uses the result of the previous link. A link with pivots stands for a specific case of complex link.

Complex links

A complex link is composed of several simple links evaluated in their definition order. Each link may use the result(s) of the previous links. Unlike links with pivots, a complex link can also perform conjunctions and logical additions of simple links.

Logical ancestors versus physical ancestors

A link makes it possible to navigate from an instance of a resource A (source) to a list of instances of a resource B (target). Each instance can be the starting point of one or several links. This mechanism results in the possibility to navigate in a virtual tree structure. In this structure, the direct parent of an instance is known as the logical ancestor of level 1. The parent of its parent is the logical ancestor of level 2 and so on. A logical ancestor can be used in a link process.

The physical ancestor is the data source entry located one level above the source entry in the data source. Subsequently, the physical ancestor of level 1 is the data source entry the source entry is directly linked to.

Configuring or modifying a link

Configuring a link is necessary:

• Once a link is added to the tree. Its parameters can still be modified or reset. The link parameters can be adjusted to match the application needs.
• To update an existing link.
• To configure its logical ancestors.

A click on a link in the tree gives access to the Definition and Configuration tabs where the behavior and display parameters of the link are set.

Definition

The Definition tab of a selected link in the COGNITUM Console tree provides the definition parameters and general settings of the link.

Figure: Link definition properties

Name: This is the name of the link generated by the wizard. A click in the cell allows to enter a new name. Non-alphanumerical characters and blank spaces are prohibited.

Target Resource: This is the target resource defined for the link. A click in the list box displays all the resources available to be defined as the target resource. A new selection can be performed.

Wizard: A click on this button launches the Link Creation wizard. It is pre-filled in with the parameters of the current link. The link can be modified in the wizard. For more information about the Link Creation wizard, see “Creating a link”.

Ancestors Parameters: A click on this button makes it possible to configure the logical ancestors of the link. For more information, see “Logical ancestors”.

Physical Definition: In this area are displayed the parameters of the intermediate links defining the link. The parameters of each intermediate link are gathered in a related sub-tab.

The parameters of each link are accessible according to the selected configuration option:

• Navigation: This option displays the parameters for the LDAP syntax of the navigation between the source and the target resources:
• From: This is the source resource defined for the link. A click in the list box makes it possible to redefine the link with another source resource.
• To: This is the target resource defined for the link. A click in the list box displays makes it possible to redefine the link with another target resource.
• Navigation Expression: This is the LDAP syntax of the navigation between the source and the target resources. Navigation is performed between the attributes and parents of these two resources. Once the option is chosen, a click in the cell allows to modify the syntax.

The Navigation Expression box is a graphical interface facility. Filling this box with any expression amounts to defining the link as follows:

• Filter: No query
• BaseDN: Expression
• Scope: Object
• Filter: This option displays the parameters for the LDAP filter syntax defined for the link. The filter, base DN and scope entries stand for the complete LDAP definition of the intermediate link. A link is defined either by a navigation expression or by a filter, a base DN and a scope:
• From: This is the source resource defined for the link.
• To: This is the target resource defined for the link.
• Filter: This is the LDAP syntax of the filter defined for the link. A click on the torch button opens the LDAP Request Builder to modify the filter. For more information about the LDAP Request Builder, see “Creating an LDAP request”.
• Base DN: It is the node from which the LDAP query starts. A click on the torch button opens up a dialog box in which another base DN can be selected.
• Scope: It is the depth of the LDAP request in the directory tree from the context node. With a click in the list box, the scope option may be changed to Object, One Level or Sub Tree.
• Operation: This option displays the parameters for operations on the result returned by sub-links:
• Based on resource: This is the main resource used for the operation. A click on the list box makes it possible to change it.
• Union: With this option, the operation is the aggregation of the results returned by the sub-links in the facing area.
• Intersection: With this option, only the data shared by the returned results of the sub-links are taken into account.
• Difference: It is the returned results deducted by the results of the sub- links.
• Insert/Remove: The buttons make it possible to add/remove existing links as sub-links for the operation.
• Logical Query: This option is available for RDBMS-compliant and computed resources. The request logic can be entered:
• From: This is the source resource defined for the link.
• To: This is the target resource defined for the link.
• Request: In this area, the logical request can be entered through the Logical Request Builder accessible with the torch button. The Logical Request Builder is functionally similar to the LDAP Request Builder documented in “Creating an LDAP request”.
• SQL Query: This option is available when the resources are RDBMS- compliant:
• From: This is the source resource defined for the link.
• To: This is the target resource defined for the link.
• FROM: This is the SQL keyword representing the data table.
• WHERE: In this area the SQL request conditions are entered. A click on the torch button launches the SQL Request Builder. The SQL Request Builder is functionally similar to the LDAP Request Builder documented in “Creating an LDAP request”.

Insert/Remove: A click on the Insert button allows to add/withdraw an intermediate link. A sub-tab is added in the Physical Definition area. The intermediate link newly added can be configured directly in its sub-tab.

In a sub-tab, an additional link can be created and configured manually. Below are some of the possible values to be entered in the Navigation expression, Filter and Base DN boxes of the Physical Definition area

Table 25 Configuring an additional link

When the request is left empty, the base DN of the target resource is used by default. Likewise, when the base DN is not redefined, the base DN of the target resource is used.

A click on the Apply button validates the link changes.

To configure or modify the definition parameters of a link

1. In the COGNITUM Console tree, select the link you want to modify under the expanded Links item.
2. Click the Definition tab.
3. In the Name box, you can change the name of the link.
4. In the Target Resource list box, you can select another target resource for the link.
5. Click the Wizard button to launch the Link Creation wizard and modify the link definition.
6. In the Physical Definition area, select the tab corresponding to the intermediate link.
7. In the From list box, you can select another source resource for the intermediate link. In the To list box, you can select another target resource for the intermediate link.

8. In the Physical Definition, select the configuration mode for the intermediate links:

9. Navigation to configure the parameters for the LDAP syntax.

10. Filter to configure the parameters for the LDAP filter syntax.
11. Operation to configure the parameters for operations on the result returned by sub-links.
12. Logical Request to configure logically the request on RDBMS-compliant and computed resources.

13. SQL Request to configure the SQL request.

14. Click the Insert button to add an intermediate link. Click Remove to withdraw the link created last.

15. Click the Apply button to validate the modifications.

Logical Ancestors

The logical ancestors of a link defines the navigation path to activate the link. The link is available only when the path leading to the source object matches the list. Once created, any type of link can have its logical ancestors configured so as to make the link browsing-contextual.

Defining a logical ancestor for a link makes it possible for its result to be contextual to the navigation performed on the resource. Configuring a link with a logical ancestor makes it dependent upon the logical context—that is the entries unfolded down to the link. The result of the link depends and varies according to the previous entries.

For any link available in the COGNITUM Console tree, a click on the Ancestor Parameters button in the Definition tab makes it possible to configure its logical ancestors. The Ancestors Parameters dialog box is displayed.

Figure: Ancestors Parameters box

Ancestors: Configuring the logical ancestors for a link consists in entering the number of levels to browse back in the logical data source.

Resources: The target resource must be selected for the COGNITUM engine to identify the resource type.

A click on OK validates the parameters. Once the logical ancestor parameters are set, the link definition must be further configured to enable its correlation with the ancestors. The LDAP syntax chunk specially designed for this facility is $logicalUp(n) where n is the number of levels to browse back toward the target resource in the logical directory.

Example

You have created three LDAP-compliant resources in the LogicalLinks application: functions, project and users. You have created a link from projects toward functions displaying the functions related to the project. You want a link from functions toward users. This link should display the users holding a function and belonging to a project.

When the logical ancestor feature is not used, you end up with all the users belonging to the function independently from the project they are bound to.

The functionsTousers link must be contextual to the projects resource. As the logical ancestor is located one level above in the logical directory, the syntax to apply to the LDAP definition of the link must be $logicalUp(1). Subsequently, the link must be defined in the COGNITUM Console.

Besides, the logical ancestor must be declared in the Ancestor Parameters dialog box.

You can then log onto the application and check that the links work properly.

To configure a logical ancestor

1. In the COGNITUM Console tree, select the link you want to configure a logical ancestor for.
2. In the Definition tab, click the Ancestors Parameters button. In the Ancestors Parameters dialog box fill in the Ancestors and Resources table lines respectively with the number of level to browse back in the data source and the target resource.
3. In the Physical Definition area, refine your request to correlate the link to its logical ancestor.
4. Click Apply to validate the configuration.

Configuration

The Configuration tab contains optional facilities for the selected link such as display parameters.

Figure: Link configuration properties

Hide the Link: Selecting this check box makes the link inaccessible to end-users in the COGNITUM portal forms. However, the link is still available for use in the COGNITUM engine. For example, it can be used as a bridge between several resources.

Use Display Bounds: This option displays the linked resource with its sorting bounds when configured accordingly at the resource level.

Display Parameters: The area allows to configure the links display policy. The display rules for a link are based on the interdependence between the links of a resource. Configuring the display parameters for a link consists in defining the conditions the link must fulfil. Defining the display parameters of a link is particularly useful for managing logical and non-logical links within a same resource. The designer can easily decide when a link must be displayed or not according to the other link(s) defined for the same resource.

• Always Display the Link: When the option is selected, no rule is applied and the current link is always displayed.
• Display the Link if: This option is linked to the list box below that defines the condition for the link to be displayed. The list box proposes two conditions.
• None of these links is displayed: The links in question are those listed in the facing box that can be added with a click on the Insert button. The Links dialog box lists the links created under the same resource as for the current link. Subsequently, when none of the links listed in the box is displayed, the current link is displayed.
• All these links are displayed: When the links listed in the facing box are displayed, the current link is displayed as well. A link can be added in the box with a click on the Insert button.

Each time a condition is defined with the Display the Link if option, the corresponding expression is generated in the Advanced Expression box. The expression can then be modified with a click on the box once the option is selected.

• Advanced Expression: The link display policy can be defined manually through specific boolean expression operators. The expression relies on the combination of link names and specific operators. Brackets can be used in the link display expression syntax. The table below identifies the operators available for the expression.

Table: Advanced expression operators

The expression (!FunctionToUser|(TownToUser&CountryToUser)) translates the following condition: The current link is displayed when the link FunctionToUser is not displayed or when the link TownToUser and CountryToUser are displayed.

A click on the Apply button validates the modifications.

To modify the configuration properties for a link

1. In the COGNITUM Console tree, select the link you want to modify.
2. Click the Configuration tab.
3. Select the Hide the Link check box if you want to make the link inaccessible to end¬users.
4. Select the Use Display Bounds check box when you want to display the bounds defined previously for the destination resource.

5. In the Display Parameters area select the option corresponding to the required display policy for the link:

6. Leave Always Display the Link when you want that the current link is always displayed without any specific rule.

7. For the Display the Link if option, add the related links with a click on the Insert button.

8. When you select the Advanced Expression option, enter the link display expression manually.

9. Click Apply.

Deleting a link

COGNITUM makes it possible to delete a link easily and safely. The Delete command is accessible from a selected link context menu.

The Delete Link message box pops up. Choosing Yes validates the deletion. COGNITUM automatically updates the links list when the link is deleted.

To delete a link

1. In the COGNITUM Console tree, select the link you want to delete.
2. Choose Delete from the context menu.
3. Validate the removal in the warning box.

Logging links errors

Links can be created between multiple resources. To help build advanced sets of links, a log file can be activated to spot errors.

The debug mode must be enabled in the COGNITUM-root/Server/cdm.ini file. The cdm.server.links.debug key must be set to true. The generated log is the errorlog.log file available in the COGNITUM-root/Server/logs/application/applicationdate.txt folder.