Cognos Validation – Batch Validation of Cognos Reports

by Mar 15, 2012Blog, Cognos Analytics, Mass Update, Mass update Cognos, MotioPI0 comments

As a Cognos modeler I’m sure many of you have had this experience: After your latest round of model updates, you publish a new version of a package from Framework Manager. This new version of the package accidentally breaks a ton of reports.

Let’s face it – this is pretty easy to do (especially for reports you haven’t thought about in a while).

Wouldn’t it be nice if you could press a button and batch validate all Cognos reports which are associated with this package…?

Well, you’re in luck because MotioPI (the FREE tool for Cognos admins) allows you to batch validate Cognos reports with just a few simple clicks. Here’s how:

1. First launch MotioPI, login to your desired Cognos Environment, and click on the Validation Panel.

MotioPI Cognos validation

2. Now, we’ll select the type of objects we want to validate (in this example, we’ll stick to validation of reports).

MotioPI types of Cognos objects

3. Now we’ll specify which reports we want to validate. Click on the Show Cognos Selector button.

Cognos report validation

4. Select the folders which contain reports we wish to validate, add them to the right and press apply.

Cognos report validation

5. Click the submit button to start the validation process. At this point, MotioPI will go off, query for all Cognos reports which match your selection criteria, and then start validating them. Depending on how many reports you selected, this might take a few minutes (could be a good time to grab that next cup of coffee).

MotioPI query for Cognos reports

6. As the process runs and the reports are validated, the results will show up in the center panel (shown below).

MotioPI run report validation for Cognos

7. For reports which fail validation, you can select the report and view the details in the bottom panel (shown below).

Cognos report validation

Note that you also have Cognos related actions which can be performed on each validated report. These are shown under the “Cognos” columnn in the results table. Examples of these actions include:

  • View the SQL generated by each of the report’s queries
  • Open the report’s properties page in Cognos Connection
  • Open the report’s parent folder in Cognos Connection
  • Launch the report in Report Studio
  • Etc.
    SQL generated by Cognos report query
    That’s about it for batch validation of Cognos reports using MotioPI (pretty easy, right?).

    Advanced usage – custom validation parameters

    Many Cognos reports accept required or optional parameters when executed. For parameterized reports, Cognos will prompt for parameter values during validation.

    Through introspection, MotioPI can determine which parameters a report accepts (as well as the parameter type), and will pass sample parameter values of the correct type during the validation phase. If you’d like more control over the parameter values which are used during the validation phase, then you can point MotioPI at a set of Cognos report views. This is done through the validation preferences, as depicted below:

    1. Open the MotioPI preferences panel, by choosing the Edit -> Preferences menu item
    MotioPI preferences panel

    2. Click on the validation tab, and configure which folder contains the aforementioned report views.
    MotioPI cognos validation tab


    MotioPI, is a free community driven tool for Cognos Admins, Authors and Power Users. Through the support of tools like MotioPI and MotioCI, Motio is firmly committed to improving the efficiency and productivity of Cognos BI teams. If you have ideas for new features you’d like to see in MotioPI, please drop us a line viapi-support AT

Case StudiesFinancial ServicesMotioCIUpgrade Factory
Have No Fear, An Easy Cognos Upgrade Is Here

Have No Fear, An Easy Cognos Upgrade Is Here

The team at CoBank relies on Cognos for its operational reporting and main financial reporting system. Keeping Cognos upgraded allows them to maintain integration with their other BI tools and systems. The team consists of 600 business users with a handful developing their own reports in the “My Content” space.

Read More

BlogCognos AnalyticsCognos PerformanceCognos TroubleshootingReportCard
Cognos Auditing Blog
Cognos Auditing Blog – Tips and Tricks for Large & High Volume Environments

Cognos Auditing Blog – Tips and Tricks for Large & High Volume Environments

A blog by John Boyer and Mike Norris. Introduction It is important to have the Cognos Auditing capability working to know and understand how Cognos is being used by your user community and help answer questions like: Who is using the system? What reports are they...

Read More