4 Consuming CPS Portlets

This chapter provides information required for consuming Content Portlet Suite (CPS) portlets. It covers the following topics:

Important:

User IDs on the content server must correspond with user IDs on your portal server.

4.1 Oracle WebCenter Spaces as Consumer

This section provides information on consuming CPS portlets in WebCenter Spaces:

4.1.1 Installation Requirements

These servers and components are required for the installation:

  • Oracle WebCenter Spaces 11g Release 1 (as consumer)

  • Oracle WebCenter Content Server 11g Release 1, Oracle Content Server 11g Release 1, or Oracle Content Server 10g Release 3

4.1.2 Supported WSRP Producers

These WSRP producers are supported with WebCenter Spaces as consumer:

4.1.3 Consumption Steps

This section describes how to consume CPS portlets on Oracle WebCenter Spaces.

  1. Login to WebCenter Spaces at:

    http://Host_Name:Port/webcenter/spaces/
    
  2. Create a new page. Select Page Actions, then Edit Page, and then click Add Content.

  3. A new dialog displays. Click on Portlets and then select the WSRP Producer that you registered.

  4. Select the portlets you want to include.

4.2 Oracle WebCenter Interaction as Consumer

This section provides information for consuming CPS portlets on Oracle WebCenter Interaction 10g Release 3.

4.2.1 Installation Requirements

These servers and components are required for the installation:

  • Oracle WebCenter Interaction 10g Release 3 (as consumer)

  • WSRP Consumer component

    The WebCenter Interaction WSRP Consumer component must be installed to configure WebCenter Interaction as a WSRP consumer. Refer to your WebCenter Interaction installation guide for information on installing this component.

  • JSR 168 Container

    Refer to the WebCenter Interaction Installation Guide for information on installing this component.

  • Oracle WebCenter Content Server 11g Release 1, Oracle Content Server 11g Release 1, or Oracle Content Server 10g Release 3

4.2.2 Supported WSRP Producers

These WSRP producers are supported with Oracle WebCenter Interaction as consumer:

4.2.3 Consumption Steps

This section describes how to consume CPS portlets on Oracle WebCenter Interaction.

  1. Start WebCenter Interaction and log in to the portal as an administrator.

  2. Click Administration.

  3. Click on the folder where you want to store the remote portlets.

  4. From the Create Object drop-down list, select Portlet.

  5. In the Choose Template or WebService dialog, enable the WSRP consumer option.

    The WSRP Consumer component must be installed for this option to display. See Section 4.2.1, "Installation Requirements" for more information.

  6. Click OK.

  7. In the Create Portlet dialog, enable the Suppress Portlet Title Bar option.

  8. In the Configure this Portlet section, click Edit.

  9. Enter the WSDL link of the WSRP-enabled CPS producer.

  10. Click Import Service WSDL.

  11. Click Next.

  12. Choose the CPS remote portlet and click Finish.

  13. In the Create Portlet dialog, click Finish.

  14. In the Save Object dialog, provide a name and description and then save the portlet object to the desired folder.

  15. Repeat these steps to add the other CPS remote portlets.

4.3 Oracle WebLogic Portal as Consumer

This section provides information for consuming CPS portlets on Oracle WebLogic Portal 10g Release 3.

4.3.1 Installation Requirements

These servers and components are required for the installation:

  • Oracle WebLogic Portal 10g Release 3 (as consumer)

  • Oracle WebCenter Content Server 11g Release 1, Oracle Content Server 11g Release 1, or Oracle Content Server 10g Release 3

4.3.2 Supported WSRP Producers

These WSRP producers are supported with WebLogic Portal as consumer:

4.3.3 Consumption Steps

This section describes how to consume CPS portlets on WebLogic Portal.

Create a Portal Web Project

  1. Launch Workshop for WebLogic.

  2. Select File, then New, and then Project.

  3. In the New Project dialog, expand the WebLogic Portal node.

  4. Select Portal Web Project.

  5. Click Next.

    The New Portal Web Project wizard displays.

  6. In the Create a New Oracle WebLogic Portal Web Project step, enter a project name (for example, CPS Consumer).

  7. Click Finish.

  8. If the Open Associated Perspective dialog displays, click Yes.

Create a Portal EAR Project

  1. In Workshop for WebLogic, select File, then New, and then Project.

  2. In the New Project dialog, expand the WebLogic Portal node.

  3. Click Portal EAR Project.

  4. Click Next.

    The New Portal EAR Project wizard displays.

  5. In the Create a New Oracle WebLogic Portal EAR Project step, enter a project name (for example, CPS Consumer-EAR).

  6. Click Next.

  7. In the Project Facets step, select WebLogic Portal EAR Project Facets from the drop-down list.

  8. Click Next.

  9. In the J2EE Modules to Add to the EAR step, select the portal web project you created (for example, CPS Consumer).

  10. Click Finish.

  11. If the Open Associated Perspective dialog displays, click Yes.

Import the CPS Remote Portlets

  1. Select Project Explorer view and expand the new Portal Web Project node (for example, CPS Consumer).

  2. Right-click the WebContent node, select New, and then Portlet.

  3. Select the directory where you want the portlet to be available and provide a name for the portlet.

  4. Click Next.

    The Portlet wizard displays.

  5. In the Select Portlet Type step, enable the Remote Portlets option.

  6. Click Next.

  7. In the Producer step, enable the Find Producer option.

  8. Enter the WSDL link of the WSRP-enabled CPS producer.

  9. Click Retrieve.

  10. Click Register to register the producer.

  11. In the registration dialog, provide a Producer Handle name and enable the Store registration properties in local registry option.

  12. Click OK.

  13. Click Next.

  14. Select the CPS remote portlet from the list of available portlets and click Next.

  15. Provide proxy portlet details and click Create. A new remote (proxy) portlet is created.

  16. From the File menu select Save All to save the remote portlet.

  17. Repeat these steps to add the other CPS remote portlets. If you enabled the option to store registration properties in the local registry you can add the WSDL link (step 8) by clicking Producer and selecting it from the Registered Producer drop-down list.

Follow these additional steps to deploy the CPS portlets to your existing portal instance:

  1. Select your Portal EAR project and open the Portal Administration Console by selecting Run and then Open Portal Administration Console.

  2. Log in using your administration credentials.

  3. In the left navigation pane, click Portal Management.

  4. Within the resource tree, select Portals

  5. Select the CPS remote portlets and add them to your existing portal.

4.4 IBM WebSphere Portal as Consumer

This section provides information for consuming CPS portlets on IBM WebSphere Portal.

4.4.1 Installation Requirements

These servers and components are required for the installation:

  • IBM WebSphere Portal Version 6.1 (as consumer)

  • Oracle WebCenter Content Server 11g Release 1, Oracle Content Server 11g Release 1, or Oracle Content Server 10g Release 3

4.4.2 Supported WSRP Producers

These WSRP producers are supported with WebSphere Portal as consumer:

4.4.3 Consumption Steps

This section describes how to consume CPS portlets on WebSphere Portal:

Consume the CPS Portlets

  1. Launch WebSphere Portal and click Administration from the main menu.

  2. In the Portlet Management section, click Web Modules.

  3. Click Consume.

  4. From the list of Web Service Producers, select the producer created to provide CPS portlets.

    See Section 3.3, "IBM WebSphere Portal as Producer" and Section 3.3.3, "Create the Producer" more information.

  5. Select the CPS portlets you want to consume in your portal. Select all if you want to consume all the portlets.

  6. Click OK.

Locate the CPS Remote Portlets

  1. In the Portlet Management section, click Portlets.

  2. Search for the CPS remote portlets in the list of available portlets.

    Remote portlets are distinguished from local portlets by the title of the Web Service Producer that appears under the 'Remote Portlet' column for that portlet.

Assign Resource Permissions

For each of the CPS remote portlets perform the following steps:

  1. Click the Assign Access to Portlet icon.

    The Resource Permissions page displays.

  2. In the Roles column, click the Edit Role icon for the User role.

  3. Click Add.

  4. Enable the Anonymous Portal User option.

  5. Click OK.

  6. In the Add section, click the portlet name.

  7. Repeat the steps above for the Privileged User role: click the Edit Role icon, click Add, enable the Anonymous Portal User option, and click OK.

  8. When you have completed these steps for each of the CPS remote portlets, click Done.

Add the Portlets to Your Page

  1. In the Portal User Interface section, click Manage Pages.

  2. In the Title column, click Content Root and then Home.

  3. Click New Page.

    The Page Properties page displays.

  4. Provide a title and unique name.

  5. Click OK.

  6. Click the Home link at the top left of the page and then click the tab with your newly created page.

  7. Hover your cursor over the title, click the displayed icon, and select Edit Page Layout.

  8. Click Add Portlets.

  9. Select each of the CPS remote portlets from the list of available portlets and click OK.

  10. When you have completed these steps for each of the CPS remote portlets, click Done.

Note:

If users are using Internet Explorer 8, it is recommended that they view the portlet pages in compatibility mode. If they do not, the portlet icon menu options do not render correctly and are not available.