Configuring the Rational DOORS data source

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

  1. In the Document Specification view, expand Templates > Data Sources.
  2. Right-click the data source and then select Configure Data Source.
  3. In the DOORS Database Source Selection wizard, click Next.
  4. 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:
      1. username - Type the Rational DOORS account name.
      2. password - Type the Rational DOORS account password.
      3. doors_home - Type the full path to doors.exe.
      4. doors_param - Type the database name you want to connect to. By default, -data 36677@localhost is used.
      5. 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.
  5. 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.
  6. 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.

Feedback