IBM Cognos Metric List

Use this portlet to add performance metrics to a page. The metrics are created in IBM® Cognos® Metric Studio.

You can configure the portlet to show different types of metric lists, such as a watch list, an accountability list, a scorecard, or a strategy list. However, if the IBM Cognos Custom Diagram portlet in a page uses the same channel, the configured metric list may not appear. Instead, a strategy metric list of the IBM Cognos Custom Diagram portlet appears. To see the configured metric list, click Back to default entry.

This portlet is interactive. When you click a metric name, the content of the IBM Cognos History Chart and IBM Cognos Viewer portlets using the same channel is automatically updated. When you position a pointer over a metric icon, a tooltip appears that shows the history chart associated with the metric. When you click the arrow button Arrow icon , the metric opens in Metric Studio. When you position a pointer over the comment icon for a metric or a strategy, the tooltip shows the latest comment.

The following table shows the properties that you can change.

Table 1. Cognos Metric List portlet properties
Property	Description
Title	Specifies the title of the portlet. You can use the default metric list name, or type a new name. If no title is specified, the portlet name is used. You can specify a title for each supported language version of the product. Note: The title does not appear in WebSphere®, WCI, and SAP portals.
Language	Specifies the product language version in which the title appears. You can assign the same title for multiple language versions.
Show title in content area	Shows the title in content area of the portlet. This option is useful when the portal does not show the title bar.
Metric package	Specifies a metric package that contains the metrics.
List type	Use to add performance metrics to a page. You can configure the portlet to show the following types of metric lists: Watch List Contains the metrics that a user wants to monitor closely. Accountability List Contains the metrics that a user owns. Scorecard metric list Contains the metrics included in a scorecard. Strategy metric list Contains metrics associated to a strategy. The metrics can befiltered by a specified scorecard. To select a scorecard, use the Apply a scorecard filter check box. If no scorecard is selected, all metrics in the strategy are shown.
Portlet communication options	Enables communication between this portlet, the IBM Cognos Viewer portlet, and other IBM Cognos Metric Studio portlets. When you select the Communicate with other portlets check box, communication between this portlet and other portlets that also have this check box selected is enabled. To set up communication between specific portlets, click Portlets using channel and type the channel name. Only the portlets that share the same channel name can interact. The channel name can contain only letters, numbers, and underscore (_) characters, and must not contain any spaces. For example, sales_reports or AbC are valid channel names.
Number of entries	Specify the maximum number of metrics displayed in the list. For a strategy metric list, and lists viewed with grouping enabled, this value is ignored. Valid range is 1 to 1000.

How To Modify the Properties

To modify the properties for this portlet, click the edit button to open the properties page. If the edit button is disabled or not visible, the administrator did not make these settings available to you. For more information, see Control Access to Portlets.

In the portlet properties page, to reset the default portlet settings, or to return to the settings specified by your administrator, click the reset button Reset icon in the portlet title bar. To exit the properties page without saving the changes, click the return button Return icon or click Cancel.

Tip:

In SAP Enterprise Portal, portlets are named iViews. This document may refer to iViews as portlets.
In Microsoft SharePoint Portal Server, portlets are named Web Parts. This document may refer to Web Parts as portlets.