IBM Support

System Reports - Changing the order (HTML,PDF,XLS) that reports are generated, ensuring PDF displays OK

Troubleshooting


Problem

When a user runs a 'standard report' (also known as 'system report') they are displayed (by default) in HTML format. HTML reports do not show any controls which the end-user can use to save or print the report. Therefore, users may prefer to see the report as a PDF file which gives them these controls. Are there any tips and tricks for end users to work smarter with these reports? How can the end user change the default standard report format?

Symptom

.

Cause

Controller system reports can give their output as HTML, PDF or XLS. By design, Controller only displays it in HTML initially. This is because HTML is before PDF (and PDF is before XLS) *alphabetically*.

Resolving The Problem

Tips:

  1. It is possible to print from the (initial) HTML report directly, rather than changing to PDF and printing from here. To do this, the end-user can click CTRL-P on their keyboard
  2. To ensure that the PDF system renders the report as intended, ensure that Adobe Acrobat Reader is configured to display the system report in the Internet Explorer window.
  3. It is possible to change the order of report generation, so that (for example) PDF generates/displays (first / by default). This is done by a local preference 'StandardReportPreviewFormat'

Steps:
(2) To ensure that the PDF system renders the report as intended:
  1. On the client, launch 'Adobe Acrobat Reader'
  2. Click on 'Edit' - 'preferences'
  3. Select 'Internet'
  4. Tick the box "Display PDF in browser"

(3) To change the order of report generation:
The following must be done on a per-user basis:
  1. Launch Controller
  2. Click 'Maintain - Installation - Local Preferences
  3. Add a new key called 'StandardReportPreviewFormat', with a value of either 'html' or 'pdf' or 'xls' or 'xml'
  4. Click 'save'
NOTE: If you change the setting so that the default report is 'pdf', then be aware that the report will take longer to view (longer to initially display). This is because there is more workload that the Controller application/report server must perform, in order to generate a 'pdf' report (compared with the default 'html' format). In other words, the end user(s) may perceive this as a performance loss.

[{"Product":{"code":"SS9S6B","label":"IBM Cognos Controller"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Controller","Platform":[{"code":"PF033","label":"Windows"}],"Version":"8.5.1;8.5;8.4;8.3","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Historical Number

1031733

Document Information

Modified date:
15 June 2018

UID

swg21346959