Rational Publishing Engine: ClearQuest queries with filters do not work

Technote (troubleshooting)


Problem(Abstract)

When integrating IBM Rational Publishing Engine with ClearQuest using Data Services, the REST URI for Data Services queries referencing certain kinds of ClearQuest queries with filters do not work correctly.

Symptom

IBM Rational Publishing Engine REST URIs referencing ClearQuest queries with filters fail in one of two ways:

  • Filters with 'not null' in a condition cause all the filters to be ignored

  • Other kinds of filters that do not use 'not null' result in an error like:
    Error 500: [Lcom.ibm.rational.wvcm.stp.cq.CqQuery$FilterLeaf$TargetType; incompatible with java.lang.String

Cause

This has been identified as a product defect under APAR PM48320.

Environment

This has been seen with IBM Rational Publishing Engine 1.1.1.2 and 1.1.2, when using ClearQuest with multiple databases (Microsoft Access, Oracle 11G)

Diagnosing the problem

To determine whether you are having this problem, you need to have an IBM Rational ClearQuest (CQ) system with the sample database and Rational Publishing Engine (RPE) installed, with Data Services configured for CQ. If you are having this problem, you will be able to reproduce it in this way:

  1. Make a copy of the All Defects query.

  2. Edit the copy to add a filter. For example, you can filter by State and only find Resolved defects.

  3. In a browser, run the REST query to see the queries available for the sample database.
    For example:
    http://localhost:9080/DataServices/ClearQuest/7.0.0/SAMPL/Personal+Queries)

  4. Run the All Defects query in a browser. For example:
    http://localhost:9080/DataServices/ClearQuest/7.0.0/SAMPL/Personal+Queries/All+Defects?Type=Query)

    This works as expected, returning all defects.

  5. Run the query with the filter. For example:
    http://localhost:9080/DataServices/ClearQuest/7.0.0/SAMPL/Personal+Queries/All+Resolved+Defects?Type=Query)

    This fails with the 500 error described above.

Resolving the problem

As a result of this issue, you cannot use IBM Rational ClearQuest queries with Rational Publishing Engine (RPE) if the queries use filters.

WORKAROUND:

To work around this problem, instead of filtering at the ClearQuest level, you can filter at the RPE level by using script filters in the RPE template.

Please note that doing the filtering in RPE will impact performance.


Cross reference information
Segment Product Component Platform Version Edition
Software Development Rational Publishing Engine General Information Windows 1.1.1.2, 1.1.2

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Rational ClearQuest
Integrations: IBM

Software version:

7.1.2, 7.1.2.1, 7.1.2.2, 7.1.2.3, 7.1.2.4

Operating system(s):

Windows

Reference #:

1569223

Modified date:

2014-09-09

Translate my page

Machine Translation

Content navigation