User assistance for content authors

Setting the list-rendering context

Learn about how you set the list-rendering context in IBM® Digital Data Connector (DDC) for WebSphere® Portal.

About this task

To establish the list-rendering context, you add the following tag to your presentation template:

[Plugin:ListRenderingContext action="set" 
                             extension-id="bean list provider id" 
                             profile="profile name"]

Replace the bean list provider id variable by the ID that identifies the DDC plug-in instance through which you want to render this list. If the addressed DDC plug-in is the generic XML DDC plug-in or a DDC plug-in that delegates its requests to that provider, you must identify the list-rendering profile. The XML DDC plug-in uses the identified profile to transform the XML data into bean list objects. Custom DDC plug-ins might or might not require this profile parameter.

To address one of the two DDC plug-ins that are provided with IBM WebSphere Portal Version 8.5, use one of the following values for the extension-id parameter:

ibm.portal.ddc.xml: Use this value for addressing the generic XML DDC plug-in.
ibm.portal.ddc.sr: Use this value for addressing the DDC plug-in that is used by the social lists feature.

If you use one of the providers, you must set the profile parameter.

Depending on your choice, the addressed DDC plug-in can support or even require that you pass extra information through the attribute parameters. For details about which information is supported or required with the DDC plug-ins, read the documentation about the DDC plug-in that you use.

Example

Here is an example of how to set a list-rendering context that uses the generic Atom list-rendering profile to retrieve the list of public IBM communities:

[Plugin:ListRenderingContext action=”set” extension-id=”ibm.portal.ddc.xml” 
     profile=”ibm.portal.atom” 
     attribute=”source=https://www.ibm.com/connections/communities/service/atom/catalog/public” 
     compute=“always“]

Note: If you want to test this example, you might have to adjust your proxy configuration to allow your portal to access the source URL. For more information, read the information about proxy configuration in the IBM WebSphere Portal documentation.

Note: If you want to test this example, you probably must adjust your outbound HTTP connection to allow your portal to access the source URL. For more information, read Outbound HTTP connection.

Library | Support | Terms of use |

Thursday, May 7, 2015 12:23am EST

Copyright IBM Corporation 2000, 2014.