+

Search Tips   |   Advanced Search

Portal, V6.1

 

Contextual linking

Contextual linking is used in systems where content from one site is shared across multiple sites. When content is linked into a site, embedded links (link elements and links in HTML) will reference the site the original content item is located in. Contextual linking is used so that when content is linked from another site, the link will be rendered relative to the current site if possible.

 

Contextual path linking

Contextual path linking will attempt to resolve a link using a relative path technique. Contextual path linking assumes that each site framework that the linked content is stored in has the same site structure. Contextual path linking can be applied to elements referenced using the element tag. For example:

It can only be used if context=current or context=autofill.

When contextual path linking is used a compatible link is searched for using the same relative path. If no link is found, the original link is used.

 

Set up the Missed Absolute Path Cache

To improve the performance of contextual linking you can enable a Missed Absolute Path Cache. The Missed Absolute Path Cache functionality requires a dynamic object cache to be setup in WAS before it can be utilized. This cache should be installed by default, but if you need to create this, follow these instructions:

Non-clustered environment

  1. Login to the WebSphere Administrative console for your server.

  2. Go to Resources tree > Cache Instances .

  3. Click Object cache instances.

  4. In the scope section, select the node on which your server is located and then select the server on which the cache is to be set up.

  5. Click Apply to save your choices.

  6. Click New to create a new cache.

  7. Enter missed in the Name field and services/cache/iwk/missed in the JNDI name field. These values are used to lookup the cache and use it. Leave all other fields set to their default values.

  8. Click OK at the bottom of the form and then Save.

  9. To enable the cache for your Web content, edit the WCM ConfigService.properties file and ensure missed_absPath.cache.enable=true .

    The WCM ConfigService.properties file is in was_profile_root/PortalServer/wcm/shared/app/config/wcmservices/. Restart WebSphere Portal to enable any configuration changes made to this file.

Clustered environment

  1. Login to the WebSphere Administrative console for your server.

  2. Go to Resources > Cache Instances > Object cache instances .

  3. Click the Browse Clusters button and choose the cluster that you want to create the cache for.

  4. Click Apply to save your choices.

  5. Click New to create a new cache.

  6. Enter missed in the Name field and services/cache/iwk/missed in the JNDI name field. These values are used to lookup the cache and use it. Leave all other fields set to their default values.

  7. Select Enable Cache Replication.

  8. Go to the Full group replication domain drop-down box and select the name of the cluster you want to cache.

  9. Select Choose Push-Only from the Replication type drop down box.

  10. Enter 1 in the Push Frequency field. Leave all other fields set to their default values.

  11. Click OK and then Save > Save > OK.

  12. To enable the cache for your Web content, edit the WCM ConfigService.properties file on every server in your cluster and ensure missed_absPath.cache.enable=true .

    The WCM ConfigService.properties file is in was_profile_root/PortalServer/wcm/shared/app/config/wcmservices/. Restart WebSphere Portal to enable any configuration changes made to this file.

 

Parent topic

Displaying Web content

 

Related reference


Referencing Elements