IBM Cognos Viewer (IBM Cognos Connection)
The following table shows the properties that you can change.
| Property |
Description |
|---|---|
| Title |
Specifies the title of the portlet. If no title is specified, the entry name is used by default. 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. |
| Entry |
Specifies the location of the entry, such as a report, to display in this portlet. You can search the folders to locate the entry. After you select the entry, the Report Properties link appears. Use this link to access the advanced portlet properties. |
| Channel |
Enables communication between this portlet and other Cognos portlets. To set up communication between specific portlets, type the same channel name for the portlets that you want to interact. The channel name can contain only letters, numbers, and underscore (_) characters, and must not contain any spaces. For example, Cognos, Cognos_Portlets, or CognosPortlets. |
| Height (pixels) |
Specifies the portlet height in pixels. If the report image is larger than this setting, scroll bars appear when you view the report. |
Advanced Properties
Use these properties to override the default IBM Cognos Viewer properties, customize the portlet user interface, and enable interactivity between other portlets in the same page.
| Property |
Description |
|---|---|
| Fragment action |
Defines the default action when the portlet is invoked in a page. When you select Show a run action, the run button appears in the portlet. When the button is clicked, the report runs. This feature helps to avoid running multiple reports a the same time. When Show most recent saved output is selected and there is no saved report output when the portlet is invoked, you can choose to run the report, or show the run button. |
| Prompt the user |
Controls prompted reports in a page or a dashboard. When you select Only when required parameter values are missing, the user is prompted if the report contains required prompts and the values are missing. Otherwise the report runs successfully. When you select Every time, if the report contains optional or required prompts, the user is prompted to enter the prompt values before the report is run. When you select Based on the prompt settings of the report, IBM Cognos Viewer uses the prompts specified in the report. When you select Never and show the report only when required values are provided, IBM Cognos Viewer attempts to run the report, but the page remains hidden until the required prompt values are provided. |
| Portlet communication options (Prompt values) |
Enables communication between the IBM Cognos Viewer portlets in the same page when using prompted reports. 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. By specifying the channel name, you have more control over the page. For example, you can link only reports that have matching parameters. 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. |
| Drill down and drill up |
Enables sharing of drill-down and drill-up actions when a page contains reports based on dimensionally modeled data sources. The item on which the drill action is based must be present in all linked reports in the page. In some cases, the sharing of drill events is not recommended. For example, simultaneous drill requests may have a negative impact on performance. When you select the Communicate with other portlets check box, communication between the 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 channel name can interact. By specifying the channel name, you have more control over the page. For example, you can link only the reports that have matching parameters. The channel name can contain only letters, numbers, and underscore (_) characters, and must not contain any spaces. For example, sales_reports or AbC. |
| Report-based drill through |
Enables sharing of drill-through actions when a page contains a report with an authored drill-through path. You must select the Communicate with other portlets on the page check box, and type the channel name in the box provided. Only the portlets that share the 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. |
| View Options (Show Toolbar) |
Specify whether the portlet toolbar should appear in the normal or maximized view. |
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 
in the
portlet title bar. To exit the properties page without saving the
changes, click the return button 
or click Cancel.
- 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.