To integrate IBM® Engineering Requirements
Management DOORS®
(DOORS)
version 9.4 and later and IBM
Engineering Test Management (ETM), you
must configure the ETM server
to communicate with the DOORS
server.
About this task
Note: This topic applies to
DOORS
version 9.4 and later. For information about integration
ETM with
DOORS
version 9.3 and earlier, see the related topic in the
DOORS
version 9.3/9.4 documentation.
To configure this integration, you must perform the
following tasks on the
ETM server:
- Set up ETM to allow
the connection from DOORS
- Add DOORS to
ETM
as a friend
- Add DOORS to
the whitelist in ETM
- Associate a DOORS
module view, which represents a collection of requirements, or an entire DOORS
database with a ETM
project
Procedure
- Set up ETM to allow
the connection from DOORS:
- In your web browser, open the Application Administration page on the ETM server.
Enter the following URL in your browser: https://[fully qualified
hostname]:9443/[application]/admin to access the application, where [application] is
qm. For example, https://<server_name:port
number>/qm/admin.
- On the Application Administration page, at the Application tab, in the
Communication section in the navigation menu on the left, click Consumers
(Inbound).
- Create a consumer entry for DOORS.
Enter a consumer name, such as DOORS, enter a consumer secret, and then click
Register. Make a note of the consumer secret. It is used later when you set
up DOORS.
- DOORS is
now registered in ETM as a
consumer. Navigate to the list of authorized keys, and make a note of the consumer key that has been
automatically allocated. It is used later when you set up DOORS.
- Add DOORS to
ETM
as a friend:
- In the navigation menu on the left, click Friends (Outbound), and in the
Friends pane, click Add.
- Enter a name for the connection, such as DOORS.
- At the Root Services URI field, enter the URL for the DOORS
service. This service is hosted on IBM
Engineering Requirements Management DOORS - Web
Access
(DWA),
and the default URL is https://hostname:8443/dwa/public/rootservices.
- Enter an OAuth secret (for example, DOORS).
Make a note of the OAuth secret. It is used later when you set up DOORS.
- Click Create Friend. A green confirmation message is displayed.
- Click Next. Make a note of the provisional key. It is used later when
you configure DOORS to
access ETM.
- Click Finish.
- To approve the provisional key:
- Open the DOORS
client.
- Click .
- Select the provisional key that was created in step 2 and approve it.
- Add DOORS to
the whitelist in ETM:
- In the navigation page on the left, click Whitelist (Outbound).
- At the Enter Base URL field, enter the URL of the DOORS
database. The default URL is https://hostname:8443/.
- Click Add. A green confirmation message is displayed.
- Associate a DOORS
module view or database with a ETM
project:
- On the Application Administration page for ETM, select
the Project Areas tab and click Active Project
Areas.
- Select a project area from the Active Project Areas list.
- Scroll to the Associations section and click Add.
- In the Add Association window, at the Application field, select the
DOORS application. The Association field indicates the
service that is provided in the integration. Confirm that the association "Uses - Requirements" is
selected.
- In the Artifact Containers list, select a DOORS
module view or a database for the integration and click OK.
- Click Save at the top of the project area page.