You can set up IBM® Rational® DOORS® Web Access so that it can access the data that is stored in a remote application by using
OSLC. Gather information about the remote application from its administrator and register
the application with Rational DOORS.
Before you begin
Contact the administrator of the other application that you want to integrate with and request the
OAuth Consumer Name, the
Consumer Secret, and the
Root Services URL for the application.
About this task
When you receive the necessary information from the administrator of the remote
application, use the
Remote Services window to register the
details.
After you register the remote application, you add the projects from the
remote application that you want to integrate with.
Note: If you do not do these
steps correctly, an error is displayed when you try to set up links between Rational DOORS Web Access and the other application. After you configure the integration, an
error is also displayed if you uninstall the remote application or if connectivity
to the application is interrupted.
Procedure
- Log in to Rational DOORS as a database manager or a custom user who has the power to manage the database.
- Click . The Remote Services window opens.
- In the Server List pane, click Add and complete the fields with the information that you were given by the administrator of the remote application.
Note: When you configure "friend" relationships for OSLC linking between participating servers,
always use a server name. Do not use an IP address.
- Click Register. The remote application is added to the list.
- In the Collaboration Links pane, click Add.
- Select the remote application that you registered and browse to the project in the application that you want to integrate with. You might be prompted to log in to the remote application.
- Click Add to complete the integration with the project.
What to do next
You must give the administrator of the other application a Consumer Key,
OAuth Secret, and the Root Services
URL for your Rational DOORS Web Access installation.
For information about gathering this information, see Setting up Rational DOORS Web Access to be accessed by remote applications with OSLC.
If you integrate
Rational DOORS Web Access with an application that uses Jazz Team Server and
link discovery, you are
prompted to authenticate when you open modules that contain links to the remote
application. You can avoid repeated authentication prompts by designating
Rational DOORS Web Access as a trusted service.
- Log on to the remote application server and open the Server
Administration page, for example:
- Jazz Team Server:
https://host-name:9443/jts/admin
- Design Management Server:
https://host-name:9443/dm/admin
- In the Communication section, click Consumers
(Inbound).
- Edit the Rational DOORS Web Access consumer and ensure that the
Trusted check box is selected.
- Click Advanced Properties.
- In the com.ibm.team.repository.service.internal.oauth.TrustedCallbackService
section, enter a Trusted Callback Service URL value
that specifies the URL to the Rational DOORS Web Access server; for example,
https://dwaserver.com:9443. This entry establishes the
trusted server URI that corresponds to the Trusted option.
- Save the Advanced Properties settings.
Note: If you move a Rational DOORS database that contains OSLC links to a different server, the OSLC links in
the associated application are broken. You must configure each link from any
associated applications to the new database server.