Connecting to the Rational DOORS data source

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.

Before you begin

Add a Rational DOORS template to a document specification.

Procedure

  1. In the Document Specification view, expand Templates > Data Sources.
  2. Right-click the data source and select Configure Data Source.
  3. In the DOORS Data Source Selection Wizard, click Next.
  4. Specify your Rational DOORS connection details.
    1. User name: Enter the Rational DOORS account name.
    2. Password: Enter the Rational DOORS account password.
    3. Database: Enter the database name to connect to. By default, -data 36677@localhost is used.
    4. Path to doors.exe: Enter the full path to doors.exe. Example: C:\Program Files\IBM\Rational\DOORS\version\bin\doors.exe
  5. Applies to version 1.2.0.1 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.
  6. 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:

Feedback