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 concrete data source. A concrete Rational DOORS data source is defined by a view from a current version or a baseline of a Rational 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 with the run mode set to new_instance=true.
  • An already running Rational DOORS instance with the run mode set to new_instance=false.

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 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 view:
      1. username : Enter the Rational DOORS account name.
      2. password: Enter the Rational DOORS account password.
      3. doors_home: Enter the full path to doors.exe.
      4. doors_param: Enter the database name 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 and new_instance properties are always rewritten by the Rational Publishing Engine Web Service. After the Document Specification file is uploaded, Rational Publishing Engine rewrites the properties to match the server configuration.
      Properties view
  5. Click Next.
  6. In the Select a view from the DOORS database window, select the module, version, and view.
  7. Click Finish.
    Note: Providing an incorrect value for any field marked as required, except view and baseline, prevents 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.

Feedback