+

Search Tips   |   Advanced Search

Configure globally how social object links are resolved

We can include one or many attributes of social objects in the design component that defines the visual design of the social list. Among other features, social objects have different resolvable links that enable users to open details views of the social objects or the community to which the social objects belong. To add these links to the social list, we can decide how we want the social objects and their home community to be resolved when users click the corresponding links. IBM WebSphere Portal can either resolve the links in the context of the portal itself, or redirect the user to the IBM Connections user interface. We can globally configure how these types of links of social objects are resolved for the users. To do so, we use a setting in the WP Connections Integration Service resource environment provider in the WAS admin console.

Social object links can be resolved for the users in the following two ways:

  • The linked resources can be rendered in the IBM Connections user interfaces.

  • The linked resources can be rendered on a portal page

We have two ways to specify how social object links are resolved:

  • We can globally configure in the WP Connections Integration Service resource environment provider how social object links are resolved by default. This setting sets the link resolution method for all social lists in the portal. As a result, all the design components that do not explicitly request a specific resource link resolution method use this default method for resolving links. Use this configuration method to switch the link resolution method globally for all social lists.

  • We can explicitly override the default link resolution method in the individual design components. To override the default setting, we use specific attributeName values in the AttributeResource tags that we use in the design components. These values determine a specific link resolution method. This way, we can specify for individual types of links by which method we want them to be resolved.

For example, this configuration affects the link and communityLink attributes. For details about which attributes are available for a specific type of social object, read Render profiles for social lists.

To globally configure how social object links are resolved by default, set the resource.resolution.url.type property of the WP Connections Integration Service resource environment provider. We can then still choose between using the default method or overriding it for individual data in individual design components:

  • To use the default method for resolving links, use the attribute names without any prefix. For example, such attribute names are link and communityLink values for the attributeName. The portal then generates links that resolve either to the IBM Connections user interface or to a portal page. The link resolution method depends on the value specified for the resource.resolution.url.type property.

  • To override the default method, you prefix the corresponding attributeName values in the design component with either of the following prefixes:

    • raw. Use this prefix to resolve links directly in IBM Connections.

    • portal. Use this prefix to resolve links in the portal.

Example: You want to generate a social object link that always points directly to the IBM Connections server, independently of the resource.serving.url.type setting. In this case, you add the [AttributeResource attributeName="rawLink"] tag to your design component instead of using the tag [AttributeResource attributeName="link"]. This option keeps the link resolution method switchable based on the resource.resolution.url.type setting.

We can specify one of the following values for the resource.resolution.url.type property:

    contextual

    Default value. Specify this value to determine the portal sets the social object resolving mode to either portal or connections. The portal determines the setting, depending on whether the IBM Connections portlets "refresh" for WebSphere Portal are installed on the portal or not:

    • If these portlets are installed, the portal uses the portal mode.

    • If the portlets are not installed, the portal uses the connections mode.

    If we install these portlets while the social object resolving mode is set to contextual, the social object resolving mode switches from connections to portal.

    portal

    Specify this value to determine the link and communityLink attributes contain URLs that display social objects in the context of the WebSphere Portal that renders the social list. In this case, their values equal the values of the corresponding portalLink and portalCommunityLink attributes for the design component. For details about the portal resolution mechanism, read Social object resolution. Use this setting only if the IBM Connections portlets are installed.

    connections

    Specify this value to determine the link and communityLink attributes contain URLs that route the user to IBM Connections and resolve the links in the context of IBM Connections. In this case, their values equal the values of the corresponding rawLink and rawCommunityLink attributes for the design component.

To globally configure how social object links are resolved by default...

  1. Log in to the WAS admin console.

  2. Click Resources > Resource Environment > Resource Environment Providers.

  3. Select WP ConnectionsIntegrationService.

  4. Under Additional properties, click Custom properties.

  5. Set the resource.resolution.url.type property to a value of either contextual, connections, or portal as required.

  6. Save the changes.

  7. Restart the portal server for the changes to take effect.


What to do next

To determine the default link resolution method currently in effect in the social list designs, check the value of the portlet request attribute ibm.portal.default.social.object.resolution.mode. This attribute is set to either connections or portal. This value indicates the default social object resolution mode.

We can disable this request attribute by setting the property enable.default.social.object.resolution.mode.request.param to the value false in WP Configuration Service resource environment provider. In this case, the attribute ibm.portal.default.social.object.resolution.mode is always set to the value disabled.


Parent Configure global settings for social rendering

Related concepts:

Social object resolution

Related reference:

Digital Data Connector profiles for social rendering