Introduction
Cognition Cockpit users often have the need to move data between an existing DOORS database and the Cockpit tool. This White Paper describes services that Cockpit provides to facilitate this information transfer. Cognition Corporation developed SyncPoint™ software to enhance the flow of information between DOORS and Cognition Cockpit.
The most basic transfer is a one-time migration from DOORS to Cockpit. Even this basic transfer often will turn out to require multiple iterations and/or need to be done in stages. In other situations there may be a need to sustain continued use of both the DOORS and the Cockpit databases. An example of the latter can be where the Cockpit tool is being used for development of new requirements coupled to a larger requirements system still maintained in DOORS. However, this White Paper will focus on one-way migration from DOORS to Cockpit. We use the general term ‘Mapping’ to refer to either a one-time migration or to a future two-way synchronization arrangement.
The Cockpit tool provides facilities for establishing and synchronizing information transfer for all of these scenarios. These facilities are collectively called “SyncPoint™” in Cockpit. SyncPoint™ provides the following services:
· Examination of both DOORS and Cockpit databases for determining the relevant portions of each tool needing information alignment.
· Setup for specifying how information transfers (migration, synchronization) are to be accomplished.
· Automation of the information transfer processes.
· Status reporting of what information is being transferred, synchronization status, error reporting, etc. These status reports may be generated as Excel files.
· Presentation in Cockpit formats of all the mapped DOORS data.
· Export from Cockpit of any of the mapped DOORS data. Exports may be done in number of formats, including Excel, Word, RIF, and specialized Cockpit XML, for example to another Cockpit Project.
Formats for Connecting to DOORS
Connection to the DOORS databases may be based on several alternative interface standards. These standards are:
· RIF (Requirements Interchange Format). RIF is a relatively new standard that DOORS and Cockpit support for comprehensive two-way information flow. RIF is XML based, as are the native Cockpit interfaces.
· CSV/TSV [Comma-Separated Variables/Tab-Separated Variables] (for Spreadsheets).
· Word (Microsoft Word files). Word files exported from DOORS provide for the capture of graphics embedded within a DOORS Requirement Object.
SyncPoint™ supports each of these formats. The formats serve different purposes. RIF is the most comprehensive, and is particularly useful for two-way communication with DOORS. CSV is particularly useful for dealing with object linkages as well as object data. Word allows for having graphical items in addition to text and document structure.
Key SyncPoint™ Elements
DOORS Reference Object (DRO)
A fundamental building block of SyncPoint™ is the "DOORS Reference Object". The DRO is a type of Requirement object in Cockpit that has the following two properties: 1) If you look at a DRO from the DOORS direction it will reflect all the data that is being transferred from or linked with its corresponding DOORS Requirement Object. 2) If you look at that same DRO from the Cockpit model direction you will see that same DOORS information, plus any additional information added into the Cockpit Project for that object. (An example added piece of information might be approval status as conducted from within the Cockpit Project.) If a total migration away from DOORS is wanted SyncPoint™ can migrate the DRO’s into another requirement type in conformance with the Project at hand.
DOORS Module Document (DMD)
A DOORS Module Document is a defined type of Cockpit document that corresponds to a particular DOORS Module. A DMD will have metadata that properly identifies it, including its matching Module in DOORS. A Project-specific document template may also be used to present the same data.
A DOORS Module Document will contain within it a number of DOORS Reference Objects as described above. There will be one DRO for each mapped DOORS Requirement Object in the DOORS Module. Typically all the DOORS Requirements in the Module will be mapped, but it could be just a selected subset of objects. The Cockpit DMD structure reflects the object hierarchy present in the DOORS Module.
As with normal Cockpit Document Objects, the document and its contacts may be viewed and reported on within Cognition Cockpit in several ways:
· Use of the Cockpit Table of Contents
· Specialized Cockpit body pages, including Tables
· Cockpit live connectivity diagrams (Visio, Excel, etc.)
· Cockpit Document Presentations / Exports (to Word, Excel, Powerpoint, Visio, etc.)
Representation of DOORS Links in Cockpit
DOORS Links are directional associations between Requirement objects. These links may be between objects within a Module or between objects in different Modules. Intra-Module Links in DOORS are strictly hierarchical; inter-Module links may be many-to-many. Cockpit’s SyncPoint™ may be used to create corresponding associations between DRO’s. In Cockpit these links are represented as unidirectional Parent/Child Assogiations.
The native Cockpit tool provides many facilities for viewing and navigating both hierarchical and non-hierarchical (many-to-one or many-to many) parent-child associations. SyncPoint™ groups these associations in the same manner as the mapped DOORS file. SyncPoint™ allows the user to navigate live graphical presentations of the linkage structure. SyncPoint™ also provides reporting of this linkage structure in both tabular and spreadsheet form.
Summary of DOORS/Cockpit Terminology
| | DOORS Term | Cockpit Term | Notes |
| | Requirement Object | DOORS Reference Object (DRO) | One Cockpit DRO will correspond to a given DOORS Requirement Object. In the Cockpit Project this DRO will not only capture information from the DOORS object (ID, Text, Attributes, etc.), but may augmented and elaborated within Cockpit while still retaining the identity and data from the DOORS object. |
| | Requirement Object ID | DOORS Object ID (DID) | Fundamental basis for identifying corresponding requirement objects in each tool. |
| | Object Number | DOORS Object Number (DON) | DOORS Text Field conveying a Module’s object hierarchy. |
| | Object Name | DOORS Object Name [Title] (DOT) | DOORS-defined Requirement Object name |
| | Object Text | DOORS Object Text (DTx) | DOORS-defined Requirement Object body text |
| | Module | Cockpit Document: DOORS Module Document (DMD) | Typically a DOORS Module will be represented as a Cockpit Document. The Cockpit Document will contain Requirement objects that correspond to objects in the DOORS module. |
| | Intra-Module Link | Cockpit Associations | DOORS Intra-module Links are One-to-Many (An object may have only a single parent). Cockpit associations reflect these Links. |
| | Module-to-Module Link | Cockpit Associations | DOORS Module-to-Module Links may be Many-to-Many (An object in one Module may have multiple parents in other Modules). Cockpit associations reflect these Links. |
| | N/A | Requirement Parameter | Mathematically-oriented Cockpit parameters do not have a counterpart in DOORS. However such a Cockpit parameter may be part of an overall Requirement object, this hosting Cockpit Requirement object having a textual counterpart in DOORS. The parameter value may be processed mathematically in Cockpit, but only represented as text in DOORS. |
| | Module ID [??] | DOORS Module ID | Unique identifier of a DOORS Module that is/ is to be synced to a Cockpit DOORS Module Document (DMD) |
| | Object Attribute | A Cockpit Custom Attribute called DOORS-Defined Attribute (DDA) | Upon import from DOORS to Cockpit, the Cockpit Project will acquire a customized attribute corresponding to each relevant or requested DOORS Object Attribute. |
| | Link | Association | In DOORS, Requirement Objects are Linked. Links are maintained in dedicated ‘Link Modules’. In a Cockpit Project this corresponding linkage information is maintained in the form of object associations. |
Cockpit’s Dynamic Excel Spreadsheets
An important feature of the Cognition Cockpit tool is dynamically-linked Excel spreadsheets. These spreadsheet files are maintained and configuration-managed from within the Cockpit Project. They contain information that is dynamically linked (two-way) with Cockpit model data. In the context of this White Paper these dynamic Excel spreadsheets mean that data may be moved between Cockpit DRO’s (DOORS Reference Objects) and Excel spreadsheets-- data that not only includes the DRO data, but also may include data from other objects throughout the Cockpit Project, and even additional Excel user data that is not directly synchronized with any particular Cockpit data. (Constraints may be applied to ensure that the Excel sheets cannot improperly modify DRO data.) These dynamic Excel spreadsheets are very valuable for collaborating between other organizations or other tools.
SyncPoint™ Actions
Actions: Specify DOORS Scope for Cockpit Project
Identify DOORS Files
Allows user to specify in a given Cockpit Project the DOORS Database for which data transfer is to be done. The result will be the identification of a set of DOORS modules in a given DOORS Database for which data transfer with the Cockpit Project is to be accomplished.
Typically these DOORS Modules will contain Requirement objects that have both intra-Module linkages as well as inter-Module linkages. These links may also be exported in addition to the objects themselves.
Typically the DOORS Requirement Objects will have attributes associated with them. This attribute information may also be brought into the Cockpit Project.
A dedicated DOORS Scope Panel in Cockpit support the user in establishing the scope.
Actions: Setup DOORS Export to Cockpit
Set Up Module Export
Allows user to Specify the DOORS Module or Modules on the basis of which a new Cockpit DOORS Module Document (DMD) will be created. The DMDs created will contain Cockpit Requirement objects that correspond to the DOORS Requirement Objects.
Set Up Object Export
Allows user to specify various options for importing data for a given object.
Actions: Report on DOORS Database Import Status
Cockpit Reporting of DOORS Mapping Status
Cockpit SyncPoint™ provides many views and reports to show the status of mapping and synchronization between the Cockpit Project and mapped DOORS files. (‘Mapping’ refers to DOORS-Cockpit associations that are scheduled for transfer/migration, have been transferred, or are in an ongoing synchronization status.)
Without going into detail in this White Paper, the following are general characteristics of the different DOORS Mapping status reporting available in SyncPoint™:
· Identification of items in DOORS that are mapped (migrated or synchronized) in the Cockpit Project
· Status of Actions like transfers or synchronization that have been taken or are planned to take place. Status includes history, successes, errors/exceptions, statistics, etc.
· Navigable graphical presentation of the relationship between linked items.
· Exportable status reports, e.g. into Excel
File-level Status
· DOORS File Identification
· DOORS Module Identification
Inter-Module DOORS Links
· File-level mapping status information
Module-level Status
· Identification of Objects in Module
· Module-level status information
Object-level Status
· Object-level status information
· Object Attribute Data
Actions: Export DOORS-linked Data
Cockpit provides a number of ways to export data that has been exported from or linked to a DOORS Database. These include:
· Word Document
· Excel Spreadsheet
· Cockpit Project data
Summary
Cockpit’s SyncPoint™ feature provides for easy migration of ALL information from DOORS files to a Cockpit Project. Additional capabilities support ongoing two-way synchronization if one’s project has that need.
DOORS Elements Mappable with Cockpit include the following:
· Identification of all DOORS Files, Modules, and Objects/Attributes that are mapped.
· Data captured into Cockpit.
· Selected (or all) DOORS Requirement Attributes.
· DOORS Links, both within a Module, and between Modules.
· DOORS Requirement content, including body text and embedded graphics.
SyncPoint™ provides specialized Cockpit Documents called DOORS Module Documents (DMD’s). There is one DMD per mapped DOORS module. DMD’s present data for objects in a DOORS Module as a collection specialized Cockpit requirements objects called DRO’s. There is one DRO for each mapped DOORS Requirement Object. The DOORS Module Document presents an object’s Identification, Body Text, Embedded Graphics, and Attributes.
SyncPoint™ utilizes ‘DOORS Reference Objects (DRO’s) that both reflect data that is mapped to DOORS, as well as holding additional associated data that is linked with the rest of the Cockpit Project.
The SyncPoint™ interface supports user for identifying and specifying how DOORS Data will map to a Cockpit Project; Viewing the status of migration or synchronization between the two tools; Viewing the mapped data from within Cockpit; and Exporting the DOORS-mapped data from Cockpit to several useful file formats.















