Deploying Cognos Portlets to SAP Enterprise Portal 6.0. 6.4, and 7.0

Before users can add Cognos portlets to their portal pages, you must deploy the portlets to the portal server.

You can deploy the following portlets:

• Cognos Content portlets

  This group includes Cognos Navigator, Cognos Search, Cognos Viewer

• Cognos Extended Applications portlets

  This group includes the Cognos Extended Applications portlet.

• Metric Studio portlets

  This group includes the Metric List and Metric History Chart portlets.

Before you start deploying the Cognos portlets, ensure that Cognos 8, including Cognos Connection and Portal Services, is installed and configured.

For the Cognos Extended Applications portlet, Cognos 8 Software Development Kit must also be installed. If Cognos 8 Software Development Kit is not installed or not available, the portal administrator should disable the Cognos Extended Applications portlet after the Cognos business package is installed .

For the Metric List and Metric History Chart portlets, Metric Studio must also be installed. If Metric Studio is not installed or not available, the portal administrator should disable the Metric List and Metric History Chart portlets after the Cognos business package is installed .

In SAP Enterprise Portal, portlets are named iViews. Portions of this document refer to iViews as portlets.

You must first log on to the portal with administrator privileges.

The deployment process consists of the following tasks:

	Installing the Cognos business package
	Editing properties for the iViews
	Setting the default iViews content and appearance

After you deploy the portlets, you must configure security for your SAP Enterprise Portal environment.

Install the Cognos Business Package

The Cognos business package is an Enterprise Portal Archive (.epa) file named com.cognos.pct.cognos83.epa. This package contains the Cognos Navigator, Cognos Search, Cognos Viewer, Cognos Extended Applications, Metric List, and Metric History Chart iViews, and the com.cognos.pct.cognos83.ivew.par file.

You must be logged on to the portal with administrator privileges and be able to access the com.cognos.cognos83.epa file from your file system or from the network file system. If the Cognos installation is not within your network access, you must manually move the com.cognos.cognos83.epa file to an accessible location.

Steps

1. In the portal, click the System Administration tab.

2. On the Transport tab, click Import.

3. Next to Source for Package Files, click Client.

   If Client is not functional, click Server.

4. Click Browse to locate the com.cognos.cognos83.epa file, and click Open.

   The com.cognos.cognos83.epa file is located in the c8_location\cps\sap\package directory.

   If you clicked Server in the previous step, browse for the com.cognos.cognos83.epa file in the SAP_installation\usr\sap\env\SYS\global\pcd\Import directory, where env represents a directory that is different for different environments. The com.cognos.cognos83.epa file must first be copied to this directory.

5. Click Upload.

Edit Properties for the iViews

The business package includes the Cognos iViews . Edit the properties for each iView so that they work with your Cognos 8 installation.

The following table shows some of the properties you may want to modify.

Property	Description
CPS: Connection Server	Represents the URL required to connect to the Portal Services server. The URL must contain the correct protocol, server name, port number, and server path. By default, the protocol is http. If Cognos 8 is configured to be accessed through Secure Sockets Layer (SSL) connections, change the protocol to https. The server path must point to a Cognos 8 gateway. For the Cognos Navigator, Cognos Search, and Cognos Viewer iView, the path is c8_gateway/wsrp/cps4/portlets/nav?wsdl&b_action=cps.wsdl For the Cognos Extended Applications iView, the path is c8_gateway/wsrp/cps4/portlets/sdk?wsdl&b_action=cps.wsdl For the Cognos Metric List and Metric History Chart iView, the path is c8_gateway/wsrp/cps4/portlets/cmm?wsdl&b_action=cps.wsd
CPS: Configuration Mode Role	Specifies the SAP role whose members, typically administrators, can modify the default iView properties . These users can see the link Edit the properties for all users at the bottom of the iView properties page, and use it to modify the default iView properties. Only one SAP role can be specified to modify the default iView properties. Default: content_admin_role

Steps

1. Log on to the portal with administrator permissions.

2. Click the Content Administration tab.

3. In the window on the left, on the Browse tab, expand the Portal Content folder.

4. Continue expanding the folders until you see Cognos iViews.

   By default, Cognos iViews are imported into the Portal Content, Content Provided by Other Vendors, End User Content, com.cognos.pct.cognos8, iviews folder.

5. Double-click the iView you want to modify.

   The Property Editor appears in the main window.

6. In the Property Category drop-down list, click Show All.

7. Edit the properties as required.

8. Click Save.

9. Repeat steps 5 to 8 for each Cognos iView.

10. If you want to test the connection between Cognos 8 and Portal Services, click the Preview button.

Set the Default iView Content and Appearance for All Users

An administrator can define the default content and appearance for Cognos iViews. When end users add the iViews to their pages, the default properties are enabled. For example, in the Cognos Navigator iView, the administrator can define the default display folder or package. When users add this iView to their pages, they see the folder or package that was specified by the administrator.

End users can change the Cognos iView properties to personalize their pages. Their changes do not affect iViews of other users or other pages. The personalized settings are not affected if the administrator changes the default properties for the iView. Users can click the Reset button to revert to the current administrative defaults.

To change the iView properties for all users, you must be a member of the SAP role that has the required access permissions. This role is specified by the CPS: Configuration Mode Role property. For more information, see Edit Properties for the iViews.

Steps

1. Log on to the portal with administrator permissions.

2. Browse to the page that contains Cognos iViews.

3. For the iView you want to modify, click the option menu button in the upper-right corner of the iView, and select Personalize.

   The iView properties page appears.

4. At the bottom of the page, click the link Edit the properties for all users.

5. Change the properties as required.

   These settings become the default settings for user instances of this portlet.

6. Click Save.

7. Repeat steps 3 to 6 for other Cognos iViews.