When an Rational® DOORS® data source is present in a document template, you must
define the properties for the concrete data source. A concrete Rational DOORS data source is defined by a view from a current version
or a baseline of a DOORS module. The view defines a filtered and
sorted subset of data to use. The default is the view for the Rational DOORS user.
Before you begin
Make sure that a
Rational DOORS 9.1 or later is installed on the same computer as the
Rational DOORS data source.
About this task
You can configure the
Rational DOORS data source and
Rational DOORS database structure data source using:
- A command-line Rational DOORS client running in the background (run mode set as new_instance=true).
- An already running Rational DOORS instance (run mode set as new_instance=false).
Procedure
- In the Document Specification view, expand .
- Right-click the data source and then select Configure Data Source.
- In the DOORS Database Source Selection wizard, click Next.
- Specify the connection details:
- To use a running instance of Rational DOORS, select Use running DOORS instance and click Next.
- To run Rational DOORS in the background, select Run a new background
DOORS process and specify the following values in the Properties page:
- username - Type the Rational DOORS account name.
- password - Type the Rational DOORS account password.
- doors_home - Type the full path to doors.exe.
- doors_param - Type the database name you
want to connect to. By default, -data 36677@localhost is used.
- new_instance - Set the run mode to true.
Note: If IBM® Rational Publishing Engine Web Services are used, the doors_home, new_instance parameters are always rewritten by the Rational Publishing Engine Web Service, after the Document Specification file is
uploaded, to match the server configuration. You configure the username, password, and doors_param in the Properties page.
- Click Next. In the Select
a view from the DOORS database window, navigate the structure
and select the module, version, and view. After you select
a view, the Finish button activates.
- Click Finish.
Note: Providing
an incorrect value for any field marked as required (except view and
baseline) results in the output not being generated. Providing an
incorrect value for view or baseline results in the output being generated
from the default view of the current module version.
Results
The information you have provided is used to configure the
data source. You can see this information in the
Properties page.