You can integrate with IBM® Rational® ClearQuest® Web
so that you can use Rational ClearQuest for
tracking defects.
Before you begin
Integration with Rational ClearQuest has
the following requirements:
- Rational ClearQuest v7.1
or newer
- Rational Quality Manager v2.0
or newer
- Public host names must be used rather than aliases
or proxies.
- Pop-up blockers must be disabled in your browser.
Note: Rational ClearQuest defects
that are associated with Rational Quality Manager tests
are not included in defect reports.
About this task
To
integrate with
Rational ClearQuest:
Procedure
- In Rational Quality Manager,
configure the Rational ClearQuest bridge.
- Log on as a user with JazzAdmins repository
permissions.
- Click Admin,
and then click Jazz
Server Administration.
- Under
Configuration, click Advanced Properties.
- Scroll to the ClearQuest Bridge
section and click Edit.
- Optionally, specify the default ClearQuest schema repository and ClearQuest user database.
The options that you specify here are available to users
when they log in to ClearQuest.
If you specify the schema in the Advanced Properties page, all project
areas will use that same schema. If you do not specify a schema repository
or user database, users must select them when they log in, but this
allows each project area to use a different schema and database.
Important: The schema repository and user database names are
case-sensitive and must match the names that you entered in the ClearQuest Maintenance tool.
- Specify the host name of the ClearQuest Web remote server, for example,
cqserver.domain.com.
- Unless you need to change them, accept the
default numbers,
80 for the HTTP Port and 443 for the HTTPS Port.
- Set the Enable ClearQuest Bridge Webui property
to true. You must enable this setting for the ClearQuest bridge to function
properly.
- Depending on your preferences,
enable or disable the ClearQuest full-text
search
functionality by setting the Is Full Text search enabled? property.
Note that you must also enable full-text search on your ClearQuest schema to use it with the ClearQuest bridge.
- Search for Public URI Root and set the Current
Value field to your public root URI, for example https://myserver:9443/jazz.
Note: Whatever value you set as the Public URI Root must be
exactly the same as the URL that users type to access the Jazz™ server.
- Click Save.
- In Rational Quality Manager,
set up the Rational ClearQuest bridge
as a "friend" of Rational Quality Manager.
You establish this relationship by setting up cross-server communication.
- In Rational Quality Manager,
click Admin, and then click Jazz
Server Administration.
- Click Cross-Server
Communication.
- For Title,
type the name that
you want to use to identify the Rational ClearQuest Web
server.
- For Root Services
URI, type the
concatenation of the public URI and the Rational ClearQuest discovery
context information, for example, https://myrqm1:9443/jazz/cqrest/repo/cqrepo/discovery,
where cqrepo is the name of the repository on the
remote Rational ClearQuest server.
- For OAuth Secret, enter
a code
of your choice to be associated with the new OAuth consumer key of
the server.
Note: In this step you do not enter the key
itself; you enter a shorter phrase that will be associated with the
actual key.
- Retype the OAuth
Secret code
phrase.
- Click Trusted to designate
this
as a Trusted consumer.
Trusted consumers can share authorization
with other trusted consumers and do not require user approval to access
data.
- Click Request Access.
- In Rational Quality Manager,
set up a link between the Rational ClearQuest user
database and the Rational Quality Manager project
area.
- Click Admin,
and then click Jazz
Project Administration.
- Click
to open the project area to configure.
- Scroll
to the bottom of the page and in the Links section,
click Add.
- On the Add Link page select the
name of the Rational ClearQuest Target
Server.
- Set the Link Type to Tests and
click Finish.
- Click Save to save
the changes
to the project area.
- Initialize
the connection.
- Point to the Defects icon
(
) and
click Create
Defect. A window opens saying that more
than one change management provider is configured.
- Select Rational ClearQuest as
your change management provider.
A connection window
opens.
- Type the User ID and password
of the Rational ClearQuest repository
and database.
- Click Log In.
A
Defect work item is displayed.
- Complete
the Defect work item and click Save to
submit the defect.