When an Rational® DOORS® data
source is present in a document template, you must define the properties
for the data source. The Rational DOORS view
listed in the document specification defines a filtered and sorted
subset of data to use in the generated output.
Procedure
- In the Document Specification view, expand .
- Right-click the data source and select Configure
Data Source.
- In the DOORS Data Source Selection Wizard,
click Next.
- Specify your Rational DOORS connection
details.
- User name: Enter the Rational DOORS account
name.
- Password: Enter the Rational DOORS account
password.
- Database: Enter the database
name to connect to. By default, -data 36677@localhost is
used.
- Path to doors.exe: Enter the
full path to doors.exe. Example: C:\Program
Files\IBM\Rational\DOORS\version\bin\doors.exe
Choose to use a running
instance of Rational DOORS or
start a new instance for these situations: - Use running DOORS instance for module selection
in this wizard:
- If Rational DOORS is
running currently from the location you specified for the Path
to doors.exe field, select the Use running
DOORS instance for module selection in this wizard option
to complete this wizard.
- If Rational DOORS is
not running currently from the location you specified for the Path
to doors.exe field, clear the Use running DOORS
instance for module selection in this wizard option to
start a new instance to complete this wizard.
- Use running DOORS instance during document generation
- If Rational DOORS is
expected to be running from the location you specified for the Path
to doors.exe field when you generate a document from this
document specification, select the Use running DOORS instance
during document generation option.
- If Rational DOORS is
not expected to be running from the location you specified for the Path
to doors.exe field when you generate a document from this
document specification, clear the Use running DOORS instance
during document generation option to start a new instance.
Note: If
the Web Services application is used, the doors_home and new_instance properties
are always rewritten by the Web Services application. After the document
specification is uploaded, Rational Publishing Engine rewrites
the properties to match the server configuration.
In version 1.2.0.1, you have
the option of selecting difference
Rational DOORS instances
for configuring the document specification and for generating a document.
In
version 1.2, you could only select between these two options, both
of which would apply to both scenarios:
- Use running DOORS instance: Rational DOORS is
installed, running, and available to provide data to the document
generation
- Run a new background DOORS process: Rational DOORS is
installed, but might not be running to provide data to the document
generation. So an extra step is added to the document generation to
start Rational DOORS to
provide data.
- To specify a Module URI, View,
and Baseline, complete one of the following
steps:
- Click Next to select values for the Module
URI, View, and Baseline.
If you click Next, in the Select
a view from the DOORS database window, you can select from
lists of modules, views, and baselines. Then click Finish.
- Enter a Module URI. After a module
URI is entered, Finish is enabled and you can
click it to use the default values for view and baseline. To use a
view and baseline different from the defaults, enter View and Baseline values
to use instead and click Finish.
Note: If you
manually edit the Module URI value and enter
an incorrect value, you might prevent the output from being generated.
When you provide an incorrect value for View or Baseline,
the output generates from the default view of the current module version.
The output generates, but the data might not be correct.
Results
When you select the data source, the
Properties view
displays the selections that you made when you configured the data
source:
- The Database value is listed in the doors_param property.
- The Path to doors.exe value is listed in
the doors_home property.
- If you selected the Use running DOORS instance during
document generation option, the new_instance property
value is false. If you cleared the Use
running DOORS instance during document generation option,
the new_instance property value is true.
- The Module value is listed in the URI property.