The Lotus® Expeditor 6.2 runtime provides a Tag Library that can be used by developers to write JSPs that aggregate multiple Portlets on one page. This capability will not provide the developer with a full feature portal aggregation implementation, but provides a very good migration scenario for developers who already have aggregating servlets and JSPs and want to switch to Portlets.
The biggest advantage for developers is that they can re-use Portlets that currently run on the WebSphere® Portal Server on the Lotus Expeditor 6.1 client runtime. However, the Tag Library and the JSPs that use this Tag Library can only be run on the WebSphere Portlet container implementation (the protocol between the tags and the Portlet container is not standardized).
A brief description of the Aggregation Tags is provided below:
Aggregating Portlets to JSPs
- Init - This tag initializes the Portlet framework and has to be used in the beginning of the JSP. All other tags described in this section are only valid in the body of this tag, therefore the init tag usually encloses the whole body of a JSP.
- State - This tag creates a URL pointing to the given Portlet using the given state. This URL can either be placed into a variable specified by the var attribute or can be written directly to the output stream.
- Insert - This tag calls the render method of the Portlet and retrieves the content as well as title. The content and title of the specified Portlet can optionally be placed into variables using the contentVar and titleVar attributes.
- urlParam - This tag adds a render parameter to the newly created URL.
- initBranding - This tag is to provide the branding theme information to the Portlet aggregator page. The theme includes - stylesheet, the title bar images, the title bar background color and the content background color.
- initUrlPrefix - This tag is used to provide the URL prefix information for all the Portlet URLs including the render and action URLs. The URL prefix includes the server address and the port number.
describes how to use the Lotus Expeditor Portlet tools to write an aggregation JSP.
If you manually create the aggregator JSP, then include the following tag library references in the JSP:
<%@ taglib uri="http://ibm.com/portlet/aggregation" prefix="portlet"%>
<%@ taglib uri="http://ibm.com/portlet/aggregation/ext" prefix="portlet_ext"%>
Adding these tag library references will allow the Lotus Expeditor tools to automatically process the tags during compilation of the aggregator JSP. The Lotus Expeditor Portlet tools will automatically add the above tag library references if you follow the procedure described in Aggregating Portlets to JSPs
Parent topic: Understanding Portlet applications: XPD621