IBM Cognos Sample Programs

Upgrades and/or Extracts Report Specifications from Report Objects in the Content Store.

The Java ReportUpgrade SDK sample program upgrades the Specification property of report objects in the content store. It also allows report specifications to be extracted to the local file system, as they exist, or upgraded.

Dependent Files

Associated files are contained under the java sample folder.
Additional files required for running are identified in the CLASSPATH definitions in run.bat file.

How To Run The Sample Program

Double click on the file run.bat.

A window will be opened containing:
    - URL text box
    - Tree View of the Content Store

First, you must select the desired Report or Folder in the Tree View. If a folder is selected, the sample will perform any selected action on all Report Objects found in a recursive search starting with the selected Folder object
To upgrade the Report Specifications for existing Report Objects in the Content Store, select the Upgrade and Replace option in the Upgrade menu. To upgrade the Report Specification in newly created copies of Report Objects that will be added to the content store, select the Upgrade and Copy option in the Upgrade menu.
To extract Report Specifications to xml files saved on the local filesystem, select the Save To File option in the Extract menu.

Expected Results

All packages, reports, queries and their associated search paths will be displayed in the Output Pane.

Documentation

The IBM Cognos Software Development Kit Developer Guide contains additional information about the samples. See the chapter titled 'Methods' and the appendix titled 'Code Samples and Language-Specific Coding Practices'.

Please note that the samples are not intended to be treated as end-user applications. Refer to the sample code for examples of how to use the API when developing your own applications.