Cooperative portlets

 

+

Search Tips   |   Advanced Search

 

WebSphere Portal includes portlet applications using standard or IBM portlet containers that demonstrate the interaction of portlets through the property broker.

All sample portlets are available in...

portal_server_root/installableApps

Subsequent updates of these samples will be available from the portlet catalog by searching for navcode 1WP10004N.

You may see the acronym C2A in some IBM sample portlets. This stands for Click-To-Action.

 

Shipping demo

The Shipping demo is available for both standard and IBM portlet containers. This demo is an order shipment application that consists of several portlets that display orders and detailed information about those orders. The Shipping demo consists of the following portlets:

Order Summary Orders Lists the orders placed during a particular month. Each entry in the list contains an order ID and a customer ID.
Order Details OrderDetail Provides details about an order, based on the order ID.
Customer Details CustomerDetail Provides details about a customer, based on the customer ID.
Tracking TrackingDetail Provides shipment tracking details for an order based on the tracking ID.
Accounts AccountDetail Provides account details for an order, based on the order ID.

This portlet application is available in...

portal_server_root/installableApps/pbshipexample.war

To run the Shipping demo:

  1. Navigate to the page that contains the Shipping portlets.

  2. Enter a valid month in the Months field of the Orders portlet. Use the full month name or the first three letters of the month. For example, Jan and January both display orders made in January.

  3. An icon renders next to items that allows additional actions. Click an icon to display a pop-up menu with actions specific to the selected item.

  4. The selection made from the pop-up menu updates other portlets on the page. For example, if you click the icon next to Order ID and the menu item Order details, the Order Details portlet is updated with the information about the selected order.

  5. Depending on the browser, holding either the ALT key or CTRL key while clicking the icon allows us to save the menu selection as a wire between the portlets. Next time you click the icon, the saved preferences are used and no menu selection is shown. Also, a different icon is rendered depending on whether a transfer selection has been wired.

Advanced options, such as broadcasting a source to all possible actions, or scattering a set of sources to all possible actions, are available in the Shipping demo.

 

Destination Guide demo

The Destination Guide demo is available for the IBM container only. It uses a clickable client-side image map to initiate the transfer of properties to other portlets. The source code demonstrates some of the features of the property broker APIs used to customize the interaction between portlets. For example, a portlet developer can associate Click-to-Action menus with hot, clickable elements on an image map. This portlet application is available in...

portal_server_root/installableApps/pbdestexample.war

...and contains...

  • Tourist Application Destination Example
  • Click Map Application Destination Example
  • Weather Application Destination Example

 

Cooperative portlet using Struts

One of the portlets in the Shipping demo, Order Details, has been rewritten using the Struts Portlet Framework. It behaves the same way as the Order Details portlet, but demonstrates how to use cooperative portlets within the Struts framework. To test this portlet, replace the Order Details portlet from the Shipping demo with the portlet from the struts war file in...

portal_server_root/installableApps

For a list of war file names and a short description of each demo, see the cooperative samples section of Developing portlets for cooperation.

 

Related information

 

Parent topic:

Installed portlets