IBM Rational DOORS Next Gen Connector [pre Sync 4.0]

This section explains how to connect to supported versions of IBM® Rational DOORS Next Gen™ using Tasktop’s IBM Rational DOORS Next Gen Connector.

Configuring the IBM Rational DOORS Next Gen Repository

Connecting to the IBM Rational DOORS Next Gen Repository

Tasktop Sync must be configured to connect to the IBM Rational DOORS Next Gen Repository through the Tasktop Sync Repository manager.

Add the IBM Rational DOORS Next Gen repository to the Task Repositories view:

Add Task Repository menu option

Create Initialization and Changes Queries for IBM Rational DOORS Next Gen

After the previous step, Tasktop Sync has been configured to connect to the IBM Rational DOORS Next Gen server. Now, the changes and initialization queries can be created. Please consult the configuration section on creating queries for details on the purpose of the queries.

Select New Query

Select Query Type

Query from folders

Folders query selection dialog

Query from a collection

Collection query selection dialog

Required attributes and properties

Additional repository properties:

Setting up the proxyStorageAttribute property

Note: these instructions assume a task mapping exists for IBM Rational DOORS Next Gen and HPE QC / ALM.

Folder Sync

The IBM Rational DOORS Next Gen connector supports synchronization of the folder of a requirement to and from a mapped repository. Folder Sync allows the containment of a requirement to be synchronized such that the requirement will reside in a folder (or container) of the same name and structure in the mapped repository.

Preparing for Folder Sync

In order to synchronize folders, ensure that the structure and names of each folder in IBM Rational DOORS Next Gen matches the target repository. Folder structure must be configured prior to synchronization. For example, folder structures for IBM Rational DOORS Next Gen and HPE QC / ALM could be set up as follows:

Example Folder Structure Example Folder Structure

Limitations

Artifact Types

Each artifact type requires a separate mapping since not all attributes are common to all artifact types, even within the same project. If the artifact type of a requirement is changed, it will fall under a new mapping. Only the attributes common to both mappings will continue to sync properly. Artifact type should not be a mapped attribute.

Artifact Format

Tasktop Sync only supports Text format requirements.

Folder Names

Folder Sync

Unsupported IBM Rational DOORS Next Gen Features

Tasktop Sync does not support synchronization of the following for IBM Rational DOORS Next Gen:

Unsupported Basic Types

Tasktop Sync does not support mappings for attributes of the following IBM Rational DOORS Next Gen types:

Attribute Sync Limitations

Summary with special characters appears encoded (Rational DOORS Next Gen Versions 4.0.4 and 4.0.5)

Due to a defect on the Rational DOORS Next Gen versions 4.0.4 and 4.0.5, requirement summaries containing special characters (e.g. an & character) will appear encoded (e.g. &amp) when synchronized to another ALM system. This problem is resolved in versions 4.0.6 and up.
For more information, please see jazz.net ticket 83692 .