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

Setting Object Properties

For each object you insert in a report, you can define its properties by specifying values in the Properties pane. Some properties, such as borders, color, and padding, are discussed elsewhere. Other properties include

Some properties apply only to some objects. For more information about objects and properties, see Report Studio Object and Property Reference.

Many object properties are Cascading Style Sheets (CSS) attributes. For information about a particular property that is a CSS attribute, see the CSS documentation on the World Wide Web Consortium (W3C) Web site (http://www.w3.org).

Note: Some properties do not apply to all types of report output. For example, the Direction text flow property works with HTML output but does not apply to PDF output.

Control Page Breaks and Page Numbering

You can control page breaks and page numbering in a list, crosstab, table, or report page by choosing any of these options.

OptionDescription

Keep with header

Keeps all headers on the same page with the number of detail rows specified.

Keep with footer

Keeps all footers on the same page with the number of detail rows specified.

Reset page count

Resets the page count after a page break to the value specified.

Reset page number

Resets the page number after a page break to the value specified.

Repeat every page

If the report renders multiple pages, this object is repeated on every page.

Allow contents to break across pages

Allows contents to break across pages.

Allow horizontal pagination

In PDF output, allows the columns of a list or crosstab to break across horizontal pages if they do not fit on a single page.

Tip: In lists, you can select the Repeat every page option for list columns that you want to show on every horizontal page.

If the Allow horizontal pagination option is not selected, the size of the list or crosstab is scaled down when necessary so that it fits on a single page.

If your report includes nested data frames such as a list within a list, horizontal pagination is supported on either the parent or child frame, but not both. If horizontal pagination is enabled on both the parent and child frame, it will be ignored on the child frame when the report runs. We recommend that you do not enable horizontal pagination on both the parent and child frames.

You can also specify page number options that use compound numbering schemes. For example, you can use the numbering scheme 1-1, 1-2, 2-1, 2-2, and so on. For more information, see Insert Page Numbers.

Enable horizontal page numbering

Increments page numbers of horizontal pages separately from the main page numbers when you select a page numbering style that includes horizontal pages. For example, if a page has three page breaks horizontally and you selected the page number style 1a, the horizontal pages are numbered 1a, 1b, and 1c. If you did not select a numbering style that includes horizontal pages, the horizontal pages are all numbered 1 for the first vertical page, 2 for the second vertical page, and so on.

If this option is not selected and there are horizontal pages, all pages are numbered sequentially. For example, if a report has two vertical pages and three horizontal pages, the PDF pages are numbered from 1 to 6. Pages 1 to 3 are the three horizontal pages for the first vertical page and pages 4 to 6 are the three horizontal pages for the second vertical page.

Repeat table rows on page break

In tables, if a row breaks across pages, repeats the rows that were previously rendered on each page. By default, table rows are repeated.

Note: This option applies to saved reports only. In interactive HTML reports, table rows are always repeated even if this option is not selected.

You can also specify the style to use for page numbers .

Steps
  1. Click the object you want.

  2. In the Properties pane, double-click the Pagination property.

  3. Specify how you want pages to break and be numbered by specifying the options that you want.

Specify Text Properties

You can specify text properties by choosing any of these options.

OptionDescription

Line Height

Sets the distance between lines of text in an object.

Letter Spacing

Sets the amount of additional space between letters in an object.

Text Indent

Sets the indentation of the first line of text in an object.

Note: This property works with HTML output but does not apply to PDF output.

Word Break

Sets line-breaking behavior within words.

Break Words when Necessary

Sets whether to break words when the content exceeds the boundaries of an object.

Enforce Stricter Line-Breaking Rules for Japanese Text

Sets line-breaking rules for Japanese text.

Steps
  1. Click the object you want.

  2. In the Properties pane, double-click the Spacing & Breaking property.

  3. Specify the text properties that you want.

Specify Text Flow

You can specify text flow properties by choosing any of these options.

OptionDescription

Direction

Sets the reading order of an object, such as right to left.

Writing mode

Sets the direction and flow of content in an object.

Bi-directional

Sets the level of embedding in an object.

Type

Sets the type of alignment used to justify text in an object.

Kashida space

Sets the ratio of kashida expansion to white space expansion when justifying lines of text in the object. This property is used in Arabic writing systems.

Note: All the text flow properties work with HTML output but do not apply to PDF output.

Steps
  1. Click the object you want.

  2. In the Properties pane, double-click the Text Flow & Justification property.

  3. Choose how you want text to flow by specifying the options that you want.

Specify the Height and Width

You can specify the height and width of objects using various units of measurement. In addition, if the object is a field set, text box prompt, prompt button, hyperlink button, block, or a conditional block, you can specify how to handle content overflow. Specify the height and width by choosing any of these options.

OptionDescription

Height

Sets the height of the object.

Width

Sets the width of the object.

Content is not clipped

If the contents of the block exceed the height or width of the block, the block automatically resizes to fit the contents.

Content is clipped

If the contents of the block exceed the height or width of the block, the content is clipped.

Note: The clipped content still exists. It is just not visible in the block.

Use scrollbars only when necessary

If the contents of the block exceed the height or width of the block, scrollbars are added to the block.

Always use scrollbars

Scrollbars are added to the block.

Do not use percentages to resize charts and maps that contain interactive elements that are activated when you pause the pointer over them, such as tooltips or drill-through links, because the browser is unable to realign the hard-coded hot spots after an image is resized.

When you use a percentage to specify the size of an object, the percentage is relative to the object's parent. In some cases, setting the size of an object using percentages will not give you the results that you want unless you also specify the size of the parent container.

Steps
  1. Click the object you want.

  2. In the Properties pane, double-click the Size & Overflow property.

  3. Specify the options that you want.

Control How Objects Flow Around Other Objects

You can control how objects flow around other objects by choosing any of the following options.

OptionDescription

Float

Sets how other objects flow around the object.

Allow floating objects on both sides

Allows other objects to flow on both sides. The Float property must be set.

Move below any floating object on the left side

If there are other objects to the left of the object, the object moves below those objects. The Float property must be set.

Move below any floating object on the right side

If there are other objects to the right of the object, the object moves under those objects. The Float property must be set.

Move below any floating object

Moves the object under any other object in which the Float property was set.

Steps
  1. Click the object you want.

  2. In the Properties pane, double-click the Floating property.

  3. Specify how you want other objects to flow around the object by specifying the options that you want.

Specify Borders and Cell Size in Tables

You can specify the borders and cell size in lists, crosstabs, and tables by choosing any of these options.

OptionDescription

Collapse borders

Collapses adjacent cell borders into a single border.

Cell spacing

If borders are not collapsed, sets the amount of space between cell borders.

Show empty cell borders

If borders are not collapsed, shows borders of cells that are empty.

Note: This property works with HTML output but does not apply to PDF output.

Fixed size

Makes all cells the same fixed, size.

Steps
  1. Click the object you want.

  2. In the Properties pane, double-click the Table Properties property.

  3. Specify the borders and cell size by specifying the options that you want.