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

Create a Table of Contents

You can create a table of contents that appears in the rendered output of your report. A table of contents is useful for reports that include sectioned items, grouped items, or multiple pages in the layout. The report output indicates page numbers and allows for easy navigation.

You can include multiple tables of contents in your report, which are useful if your report contains grouped lists. You can also add section numbers in front of entries in the table of contents by modifying the heading level property.

Table of contents entries are logical markers placed anywhere in a report. For example, you can place entries at the top of a page or in a list group header to mark each grouped data value. Although table of contents entries are visible in Report Studio, they cannot be seen when a report is run.

A table of contents works only for reports produced in PDF and non-interactive HTML format. In HTML format, they work best when viewing saved report outputs, as the entire report appears in a single HTML page. When reports are run interactively, more than one HTML page may be generated, and a table of contents works only if the target exists in the page currently being viewed.

If you want to quickly move from one part of a report to another without using page numbers, you can add bookmarks .

You must first create a table of contents before adding entries in the report. All entries must be inserted after the table of contents in the report layout.

Steps
  1. In the Insertable Objects pane, click the Toolbox tab.

  2. Drag the Table of Contents object to the location you want, which can be anywhere in the report.

    A table of contents placeholder appears.

  3. Drag the Table of Contents Entry object to the location where you want to locate your first table of contents marker.

    Tip: You can also click Structure, and then Insert Table of Contents Entry.

    The new entry appears in the table of contents.

  4. Double-click the Double click to edit text box of the new marker.

  5. In the Text box, type the text to appear in the table of contents, and then click OK.

  6. To edit the heading level of a table of contents entry, click the entry, and in the Properties pane, click the Heading Level property and select the level.

    The heading level is used to insert section numbers in front of entries in the table of contents using layout calculations.

When you finish creating the table of contents, click the run report button . By clicking the arrow to the right of the run report button, you can specify whether you want to run the report as HTML or PDF.