Social object resolution | HCL Digital Experience
When a portal user clicks a link to an object, the portal takes the user to the details view of that object. This process is called social object resolution. For example, a user might click a specific forum topic that is listed in the Community Forum Topics list. In this case, the social object resolution takes the user to a portal page that provides a details view of the forum topic that the user clicked. You can influence the result of the resolution that the user views by setting various parameters. These parameters are described here.
The social object resolution process is implemented by the connections resolver that is contained in the HCL Connections Portlets for HCL Digital Experience. To enable social object resolution, you need to install this resolver first.
- The type of link that points to the social object. This link can be either of the
following two types:
- A portal URL. In this case, the link is called a POC (piece of content) link.
- An HCL Connections URL.
- The resolution root page parameter that is defined in your view definition.
- Whether the social object is contained in a community or not, and if it is contained in a community, which community that is.
- The type of object that the user clicked, for example whether it is a forum topic or a blog post.
- HCL Connections URL:
- If the link to the social object is an HCL Connections URL, the social object
resolution process is not triggered. Instead, the user is taken directly to the
corresponding HCL Connections user interface that shows the details of the
object that the user clicked. You can set the portal-wide default type for your social
object links in the portal configuration. For more information about how to do so, read
Configuring globally how social object links are resolved. You can always
overrule that default in your appearance components by using the
[AttributeResource attributeName=""]
tag as follows:- To generate default links to the current social object, specify
[AttributeResource attributeName="link"]
. - To generate a HCL Portal type link, specify
[AttributeResource attributeName="portalLink"]
. - To generate an HCL Connections type link, specify the
[AttributeResource attributeName=rawLink]
.
- To generate default links to the current social object, specify
- HCL Portal URL:
- If the link to the social object is a HCL Portal URL, the connections
resolver starts the social object resolution. It evaluates this process in the following
three phases:
- Determine the set of candidate pages
- Determine the appropriate page from the set of candidate pages
- Determine the final fallback resolution target for the case that the resolver finds no matching page from the set of candidate pages.
current
. If you identify a portal page by using the resolution root
page parameter, the connections resolver considers the identified page and all of its
descendant pages to be candidate pages for the current social object resolution process.
IC_Forums.topic=true
to indicate that this portlet can render a detail view for a
forum topic. For a full list of the supported portlet preferences, read HCL
Connections Portlets for HCL Portal. If the connections resolver finds no candidate page or candidate page that contains a
suitable viewer portlet, the portal takes the user to the default page for the social object
that the user clicked. To identify the default pages for specific types of social objects, you
assign those pages-specific unique names. For example, the default name for identifying the
default page for social objects that are served by the Forums service is ibm.conn.forums
. An administrator can change the default unique
names. For more information, read HCL Connections Portlets for HCL
Portal: Configuring unique names.
If the connections resolver does not find the default page, the final fallback is either to
redirect the user to a defined portal error page or to take the user to the details view in
the HCL Connections user interface. An administrator can control this behavior by
running the portal configuration tasks disable-poc-redirect-to-connections
or enable-poc-redirect-to-connections
. For more details about the social object
resolution, read HCL Connections Portlets for HCL Portal.