Creating REST URIs to run queries

You can create REST URIs to run queries.

About this task

To create a REST URI to run a query:

Procedure

  1. On the Rational® ClearQuest® Web toolbar, click the arrow next to New Change Request and select New REST URI. The New REST URI wizard opens.
  2. Select Run a query from the REST URI Type list.
  3. Select a query from the workspace display in the Select a query field.
  4. Optional: To add Rational® ClearQuest® Web logon parameters to the REST URI, select the Automatically log in check box.
  5. Optional: To include the banner, workspace tree, and main toolbar in the window that opens when the REST URI runs, select the Include the banner, workspace tree, and main toolbar check box.
  6. Click Create.
    The REST URI template appears in the REST URI Template field.
  7. Copy the template into a text editor and replace the placeholders, enclosed by double curly brackets {{ }}, with appropriate values.

    Optional: Change the default format for the resource request from HTML to XML or ATOM.

  8. Copy the modified template into your web application or another Web browser window.
  9. Click Reset to create a new REST URI template or Close to exit.

Example

Example

The following REST URI template to run a query was created by using the New REST URI wizard. In this example, the check box Automatically log in was selected to create the REST URI. 

http://CQWebServerHost/cqweb/restapi/YourConnection/YourUserDB/QUERY/QuerySpecification?format=HTML&loginId={{loginid}}&password={{password}}&noframes=true
The variables and template placeholders have the following meanings:
CQWebServerHost
Web address of your Rational® ClearQuest® Web server host. This value is defined when the REST URI template is created.
YourConnection
Your Rational® ClearQuest® connection. This value is defined when the REST URI template is created.
YourUserDB
Your Rational® ClearQuest® user database. This value is defined when the REST URI template is created.
QuerySpecification
The query specification that you selected in the Select a query field.
format
The default format for the resource request is HTML. You can change the format to XML or ATOM, if desired.
{{loginid}}
Replace this placeholder with your logon ID.
{{password}}
Replace this placeholder with your password.
noframes
If this value is true, the Rational® ClearQuest® Web banner, workspace tree, and main toolbar do not appear when you run the REST URI to view the resource. The noframes filter is relevant only if format=HTML.