To use Cognos product documentation, you must enable JavaScript in your browser.

Insert Other Objects

In addition to text and images, the Toolbox tab in the Insertable Objects pane contains other objects that you can add to the report layout.

Object

Description

Block

Adds an empty block, a container in which you can insert other objects. This is useful for controlling where objects appear.

Table

Adds a table, a container in which you can insert other objects. This is useful for controlling where objects appear.

Field Set

Adds an empty block that has a caption. This is similar to the Block object, but with a caption.

Calculated Member

Adds a calculated member .

Intersection (Tuple)

Adds an intersection (tuple) .

Query Calculation

Adds a calculated column .

Layout Calculation

Adds a calculation in the layout that contains run-time information, such as current date, current time, and user name.

Crosstab Space

Inserts an empty cell on a crosstab edge. Allows for the insertion of non-data cells on an edge. Blank cells appear for the edge when the report is run.

Insert this object when a crosstab edge does not produce useful data and you want blanks to appear in the cells instead.

Crosstab Space (with fact cells)

Inserts an empty cell on a crosstab edge. Allows for the insertion of non-data cells on an edge. The contents of the fact cells for the edge are rendered when a measure is added or the default measure is specified.

  • If the crosstab space is nested, the scope of the fact cells is the scope of the item that is at the level before the space.

  • If the crosstab space is not nested and there are no items nested below it, the scope of the fact cells is the default measure.

Singleton

Inserts a single data item .

Conditional Blocks

Adds an empty block that you can use for conditional formatting .

HTML Item

Adds a container in which you can insert HTML code. HTML items can be anything that your browser will execute, including links, images, multimedia, tooltips, or JavaScript.

HTML items appear only when you run the report in HTML format.

Note:

You cannot include <form> tags in HTML items.

When you upgrade to the next version of Cognos 8, the report upgrade processes do not account for the use of undocumented and unsupported mechanisms or features such as JavaScript that refers to Cognos HTML objects.

Rich Text Item

Inserts an object that is used to render HTML in the layout. This object is similar to the HTML Item, except that rich text items also render in PDF output. Using rich text items is useful when you want to add annotations defined in a data source to a report.

Note: Rich text items support only a restricted set of well-formed XHTML.

Hyperlink

Adds a hyperlink so that users can jump to another place, such as a Web site.

Hyperlink Button

Adds a hyperlink in the form of a button.

As of Time Expression

Adds a As of Time expression so that you can show data for a specific time period .

Page Number

Inserts page numbers that you can customize .

Row Number

Numbers each row of data returned when the report is run.

Note: You can add row numbers only to lists and repeaters.

Layout Component Reference

Adds a reference to another object. Useful when you want to reuse an object.

Metric Studio Diagram

Adds a Metric Studio history chart as an image.

For information about adding a Metric Studio diagram to a report, see the Metric Studio User Guide.

Table of Contents

Creates a table of contents that is rendered in the output of a report .

Table of Contents Entry

Adds a table of contents marker .

Bookmark

Inserts a bookmark so that users can move from one part of a report to another .

For information about each report type, see Types of Reports. For information about each prompt control and prompt buttons, see Adding Prompts. The Toolbox tab contains other objects when you work in other areas such as Query Explorer and Condition Explorer . You can also add your own objects to the toolbox, such as a company logo that you use often. For more information, see the Administration and Security Guide.

Before you can add a hyperlink, HTML item, or hyperlink button, you must have the HTML Items in Report capability. For more information, see the Administration and Security Guide.

Step

Elements Supported in Rich Text Items

Rich text items support all XHTML character entities, such as &nbsp (non-breaking space), and the following elements:

Each element only supports the style attribute, which must contain a valid CSS style. In addition, ul and ol elements support list-style attributes. Specifically, the ol element supports decimal, and the ul element supports circle, disc, and square, as well as list-style-image.

For example, the following code produces an unordered list entitled List: with three items. Each list item is in a different color, and the list-style attribute used is circle.

<div style="font-size:14pt; text-decoration:underline">List:</div> <ul style="list-style-type:circle"> <li style="color:green">Item <span style="font-weight:bold">A</span></li> <li style="color:red">Item B</li> <li style="color:blue">Item C</li> </ul>

Example - Add a Multimedia File to a Report

You are a report author at the Great Outdoors Company, which sells sporting equipment. You want to insert a Windows Media Audio/Video file named GO.wmv in a template that serves as a cover page for all reports.

You must have Windows Media Player installed on your computer.

Steps
  1. In the Cognos Connection Welcome page, click the Public Folders link.

  2. Click the GO Data Warehouse (query) link, click the Launch link in the top right corner of the page, and then click Report Studio.

  3. In the Welcome dialog box, click Create a new report or template and in the New dialog box, click Blank.

  4. In the Insertable Objects pane, on the Toolbox tab, drag the HTML Item object  to the report.

  5. In the report, select the HTML Item you just added.

  6. In the Properties pane, double-click the HTML property.

  7. In the HTML dialog box, type the following:

    <OBJECT classid="CLSID:6BF52A52-394A-11D3-B153-00C04F79FAA6">
        <PARAM NAME="URL" VALUE="/c8/webcontent/samples/images/GO.wmv"/>
    </OBJECT>
  8. Click OK.

When you run the report, the multimedia file plays in Windows Media Player.