You are on page 1of 72

DOORS

Database Management

TRW Automotive Inc. 2004

Why to have a

Requirement Database???

TRW Automotive Inc. 2004

Why to have a Requirement Database???

When a project team receives requirements from an approved requirements


provider:
The requirements are reviewed with the requirements provider to
resolve issues and prevent misunderstanding before the requirements
are incorporated into the projects plans.

Once the requirements provider and the requirements receiver reach an


agreement:
Commitment to the requirements is obtained from the project
participants.

TRW Automotive Inc. 2004

Why to have a Requirement Database???


The project team has to maintain the track of the requirements changes

as they evolve and identifies any inconsistencies that occur among:


The plans
Work products
Requirements
To minimize the inconsistencies that may erase due to any of the above
reasons we should have a management system where we can have a track
of the:
The requirement Changes
Design and Implementation of the requirements
Testing of the requirement and product as a whole.
So we need an appropriate system to keep a track of these things

TRW Automotive Inc. 2004

DOORS Database
as a Requirement Management System

TRW Automotive Inc. 2004

DOORS - Introduction
DOORs as a Requirements Database:
DOORs is a tool that provides linkage (traceability) between various
levels of requirements, design, code packages, test cases, and change
requests of a product in development.

DOORs takes a Word document (or other publishers) and extracts the
requirements to an online database for linkage with succeeding
documentation within the software generation process.
DOORS can also be used to create documentation from scratch (no
import necessary).

TRW Automotive Inc. 2004

DOORS - Introduction

Example of DOORs layout:


Customer documents will be imported directly to DOORS, saved,
baselined, write protected and left alone.
There will be one formal module for each living requirements set.
Attributes will be added to indicate for each object:
Whether that object is a requirement or not (Boolean type),
For which discipline it is a requirement (multi-valued enumerated
type),
The review state (date, enumerated and text types), and potentially
others also.
Each object that is a requirement must link back (via a represents
link) to one of the original source documents (customer documents,
legislation, company standards etc).

TRW Automotive Inc. 2004

DOORS Training Directory Structure

TRW Automotive Inc. 2004

Example of DOORs layout (continued):


The software requirements formal module will expand and elaborate
on the system requirements, and will link back to the appropriate
system requirements via an requirements link.
There may be many software requirements modules, based on the
architectural design, to ease development.
One software design module will exist for each architectural domain in
the architectural design.
Objects in the design modules will link back to the software
requirements modules via the design link.
Design decisions will be made that influence the content of the software
design modules these may be documented either in the relevant
module (using an attribute) or in a separate design decisions formal
module, with justifies links to the software design module.

TRW Automotive Inc. 2004

DOORS Training Displayed Information

TRW Automotive Inc. 2004

10

DOORS Training Displayed Information (continued)

Object Identifier (First column) ID


Prefix Typically an abbreviation for the requirement set.
Absolute number Provided by DOORS database.
Heading and Text
Section number
Object heading Provides a title for the object
Object text Requirement text or other information stored in the
object.
Current Object Is the highlighted object, used for performing functions:
Inserting an object
Pasting an object
Moving an object

TRW Automotive Inc. 2004

11

DOORS Training Displayed Information (continued)

Change Bars
Green, yellow, and red change bars appear at the left edge of the Text
column.
Blue Denotes an object has not been changed since the last module
baseline.
Yellow Shows changes that have been saved since the baseline.
Red Indicates unsaved changes made in the current session.
Link Indicators
Displayed on the right hand edge of objects, which have relationships
to other objects.
Orange Triangle Points to the left and indicates an incoming link.
Maroon Triangle Points to the right and indicates an outgoing
link.

TRW Automotive Inc. 2004

12

DOORS Training Displayed Information (continued)

TRW Automotive Inc. 2004

13

DOORS Training Displayed Information (continued)

TRW Automotive Inc. 2004

14

DOORS Training Changing Edit Mode

TRW Automotive Inc. 2004

15

DOORS Training Changing Edit Mode (continued)

Use Edit, Edit Mode to change the edit mode of an open


formal module.
Read-only Provides read access to files for the user, and
does not prohibit other users from editing the files.
Shareable Edit Allows controlled, multi-user editing.
Exclusive Edit Exclusive write access to files for the user,
and prohibits other users from editing the files.
You can change edit mode without closing and reopening the
module.

TRW Automotive Inc. 2004

16

DOORS Training Object Properties

To open the object


properties within a
formal module:
Select an object.
Right click onto
properties.
The result is the
screen shown here.

TRW Automotive Inc. 2004

17

DOORS Training Object Properties (continued)

Properties provides an area for editing of detailed information


on an object.
Detailed information about an object:
General Heading, short text, object text values for the
object.
Access View or set access rights.
History Log of changes to the object.
Attributes Attribute values for the object.
Links Relationships to other objects.
Apply changes before leaving the properties, by clicking on the
Apply button and then the OK button.

TRW Automotive Inc. 2004

18

DOORS Training Object Drag and Drop

To move an object:
Select the object, hold down the left mouse button and drag
to new position.
When you start to drag an object, its background changes
color.
When you release the left mouse button at the new position,
a menu is displayed with the following options:
Make link from start
Move object after or below
Copy object after or below
Copy and link object
If drag is started, but not completed, select Clear Start
from the Link menu to clear highlighted objects.

TRW Automotive Inc. 2004

19

DOORS Training Copy and Paste Objects

Objects within modules can be added with Copy and Paste


Copy
Copy current object only with Edit, Copy or Ctrl+C.
Copy current object with hierarchy to copy the current
object and all of its children using Edit, Copy objects
with hierarchy function.
Select insertion point
Paste Ctrl+V or Paste objects one level down.
When you perform a copy and paste, the pasted copies are
new objects.
Attributes and links are also copied.

TRW Automotive Inc. 2004

20

DOORS Training Cut and Paste Objects

A DOORS tree can be rearranged with Cut and Paste


Cut
Cut (Ctrl+X) Removes current object and all children.
The objects are placed on a clipboard.
Paste
Select insertion point.
Paste (Ctrl+V) or paste
Pastes objects as first child one level down or
Pastes objects after as next sibling to the current
object.
Objects are renumbered according to entry location.

TRW Automotive Inc. 2004

21

DOORS Training Delete Objects

Delete
A DOORS tree can be trimmed with the Delete function.
Use Edit, Object, Delete, or select the object and then use
the delete key on the keyboard.
Applies to current or selected objects, including all child
objects.
Objects are only marked for deletion.
Deleted objects can be undeleted, restoring them in the
module.
Deleted objects can be purged, permanently removing
them.

TRW Automotive Inc. 2004

22

DOORS Training Creating Objects

Creating Objects
Building a hierarchy of objects in DOORS is simple
Current object is always the insertion point.
Choose position of new object relative to current.
New objects are placed in one of two positions relative to the current
object:
Insert, Object Places new object as the next sibling of the
current object.
Insert, Object Below - Places new object as the first child of the
current object.
Ctrl-T Puts the object into text mode (double click on object).
Ctrl-H Puts the object into heading mode (automatic when typing
starts).

TRW Automotive Inc. 2004

23

DOORS Training Undo Function

Undo
To undo an edit, select Edit, Undo.
The undo function will undo:
Object cut,
Object delete,
Attribute value changes,
Table formatting changes.
Undo is multi-level as long as an unsupported undo
function is not in the middle of the chain.
Changing of many attribute values at once may be undone
with a single undo.

TRW Automotive Inc. 2004

24

DOORS Training Undo Via the History Window

Undo via the History Window


Select the object.
Right click on the properties page.
Click on the History page.
Highlight the history item that you want undone.
Click the Restore button on the page.
The Undo via the History Window will not undo the following. To undo
these operations, do the following:
Create object Delete object
Move object Move it back
Copy object Delete object
Create link Delete link or close source module without saving
Delete link Create link or close source module without saving

TRW Automotive Inc. 2004

25

DOORS Training Export from Word to DOORS

TRW Automotive Inc. 2004

26

DOORS Training Export from Word to DOORS

To import a Word document into the selected folder in DOORS:


Open the document in Word
Click on the DOORS button (it looks like a door with an arrow
pointing at it)
The Export To DOORS window opens
Fill in the Module Name, Module Description, Module Prefix, Absolute
Numbers Start At
The Module Prefix can be modified/created at anytime.
Click Export button
The document is imported into DOORS with the same structure as the
Word outline.
Heading 1 text becomes an object at level 1 in DOORS
Paragraph breaks are used for delimiting the content of each object.

TRW Automotive Inc. 2004

27

DOORS Training Capturing and Displaying Additional Information via Attributes

TRW Automotive Inc. 2004

28

DOORS Training Capturing and Displaying Additional Information via Attributes

Attributes
Are additional defined characteristics of an object.
They can be used to define essential information:
Source Who specified this requirement
Priority What is the priority of this requirement
Verifiability Is the requirement verifiable
Accepted Has the requirement been accepted by developers
Review Review status of the requirement
Safety Is this a safety critical requirement
Comments Any comments to clarify the meaning of the requirement
Questions Any questions that must be clarified from the source
You can define attributes that will support your process and make your
database more productive for you.

TRW Automotive Inc. 2004

29

DOORS Training Finding and Displaying the Data You Want to See

Search Capabilities
Search the database for folders, projects, or modules based on:
Name
Text in the object text or object heading
Search a module for objects based on:
Text contents
Attribute values
Links
Position in hierarchy
Filter to show (only) all objects, which meet search criteria
Find and replace text
Go to object based on absolute number or section number

TRW Automotive Inc. 2004

30

DOORS Training Finding and Displaying the Data You Want to See

TRW Automotive Inc. 2004

31

DOORS Training Finding and Displaying the Data You Want to See

TRW Automotive Inc. 2004

32

DOORS Training Printing and Reports

Printing
DOORS supports direct printing of formal and descriptive modules.
Three print formats are supported:
Column
Is used to print tables in their typical multiple column format.
Book
Prints all columns of data visible online, but the column data is
listed by column heading wrapped under the object.
Graphics
The user is given the option of printing the currently displayed
tree view or using the applied column or book format.
The number of objects is constrained by the page size chosen in
the Page Layout window rather than the current DOORS
window size.

TRW Automotive Inc. 2004

33

DOORS Training Link Concepts

Why Define Relationships


Requirements in any real project are inter-related.
These relationships can be used to understand dependencies between
requirements and assess impact of change.
Analysis of dependencies helps ensure 100% traceability.
Requirements also have relationships to other objects in the database
for the project lifecycle.
Maintain bi-directional traceability among the requirements and the
project plans and work products.

TRW Automotive Inc. 2004

34

DOORS Training Link Concepts

Link Concepts
A relationship between two objects in the DOORS database is
established using a link.
Source and Target Objects
Source is the from object
Target is the to object
Links can be followed in either direction.
We link from the bottom upward to provide a consistency for
traceability.
From module (where we have access rights) To higher level
requirements module (where we dont need access rights).
From STP to SRS
From SDD to SRS
From SRS to SPS
From SPS to CRS

TRW Automotive Inc. 2004

35

DOORS Training Link Concepts

Customer
Requirement
Specifications

Glossary

System
Product
Specifications

Standards

Requirem ents

Requirem ents

TRW Lessons
Learned

Design

Software
Requirement
Specifications

Software Test
Plans

Software
Design
Documents

TRW Automotive Inc. 2004

36

Hardware
Requirement
Specifications

DOORS Training Link Direction Considerations

Primary reason for choice of link direction is access rights


User must have RM access at source in order to create a link
For example, engineers may not have Modify access to the
Standards module; therefore, they could only link to that module.
Only R access is required at the target object.
RM access is required for the link module.
RMC is required to create a linkset; limit this kind of access in order
to enforce your schema.
Secondary reason for choice of link direction is consistency and ease of
reporting.
When linking through multiple linksets in a single link module, same
direction allows for more convenient multi-level traceability reporting.

TRW Automotive Inc. 2004

37

DOORS Training Menu Driven Linking

TRW Automotive Inc. 2004

38

DOORS Training Menu Driven Linking

TRW Automotive Inc. 2004

39

DOORS Training Menu Driven Linking

Menu Driven Linking


Select source object
Use Link, Start Link
Locate target object
Use Link, Make Link from Start
A link is created from the first object to the second object in the default
link module.
To clear a link that was mistakenly started from a source object use
Link, Clear Start, or just close the module.
A source link stays open to allow multiple linking to a number of target
objects by just using Link, Make Link from Start on each target object.

TRW Automotive Inc. 2004

40

DOORS Training Delete Links

TRW Automotive Inc. 2004

41

DOORS Training Delete Links

Delete Links
Select the object.
Click on Link, Edit Links in
module.
This opens the properties
window to the Link page.
Highlight the link that you
want deleted.
Click on the Delete button in
the lower right corner.

TRW Automotive Inc. 2004

42

DOORS Training Using Link Indicators

Position cursor over link indicator.


Right mouse button to select module and object.

TRW Automotive Inc. 2004

43

DOORS Training Attribute Types

DOORS provides a variety of predefined types from which attributes may


be defined.
Attribute types constrain the values that can be assigned for an attribute.
For example, by creating an attribute based on Integer Type, users
would not be allowed to enter values that contain a decimal point.
Attribute Defined Types
Integer, Real, Date Can have minimum and maximum values.
String, Text Text is as short as a string, or as long as a complete
document.
Username Values are constrained to the Usernames of DOORS users.
Enumeration A user-defined list.
User-Defined Types Users may create types that are relevant to their
project data.
Predefined types can be used directly, or customized to create user- defined
types.

TRW Automotive Inc. 2004

44

DOORS Training Defining Attributes

Edit, Attributes
Shows a list of the existing attributes.
To create a new attribute, click on the New button

TRW Automotive Inc. 2004

45

DOORS Training Defining Attributes

Each attribute must have


name and type.
Enter name
Select type
Set default value
Set application level
Objects and/or Module
Set Inheritance On/Off
Set history options
Change bars
Changed dates
Generate history
Indicate if Add new
attribute to current view.

TRW Automotive Inc. 2004

46

DOORS Training Attribute Value Inheritance

With inheritance set to On for an attribute, setting the value of the


attribute on a parent object causes the value to flow down to all of its
children, grandchildren, etc.
When an attribute has a specific value, it can be inherited by lower
level objects.
When the value is changed at the high level, it changes for all children
that have no specific value.
Inheritance is a characteristic specified when an attribute is created,
but can be changed later, if necessary.
Attribute inheritance should be used sparingly.
It may leave the impression that a conscious decision was made to enter
a value when it has actually been propagated by inheritance.

TRW Automotive Inc. 2004

47

DOORS Training Importing Attributes or Types


Use Edit, Types,
New button, then
click import button
Enter source module
Select attributes
to be applied

TRW Automotive Inc. 2004

48

DOORS Training Copying Modules

Formal modules can be selected, copied, cut, and pasted using the DOORS
Explorer clipboard.
Click on parent, then select in right hand pane of Explorer window.
Select operation from Edit menu or right-click and select.
Links that are in link modules within the copied folder will also be
copied.
A selection of modules can also be copied and pasted.
You must have Create access in the destination folder/project to paste
copied modules.
When copying a module that contains links, out-links are always copied.
An In-link is only copied if you also copy the module that contains the
source object at the other end of the link.

TRW Automotive Inc. 2004

49

DOORS Training Deleting Modules

Modules can be deleted, undeleted, and purged


Delete
Select the desired module in the right hand pane of DOORS Explorer
window.
Click Delete from the File menu or use the right click pop-up menu.
Undelete
Select Show Deleted Items from the DOORS Explorer View menu.
Select the item
Right-click or use the File menu and select Undelete.
Purge
Select deleted items (as described above)
Select Purge from the File menu.
A deleted module is removed from the standard DOORS Explorer
display, but is not removed from the database until it is Purged.

TRW Automotive Inc. 2004

50

DOORS Training View Deleted Objects

Deleted objects are shown in red with black change bar.


Use View, Show, Deletions to view deleted objects.

TRW Automotive Inc. 2004

51

DOORS Training Undelete Objects

Show deleted objects, which are shown in red with black change bar.
Highlight the object to be undeleted.
Use Edit, Object, Undelete.

TRW Automotive Inc. 2004

52

DOORS Training Purge Deleted Objects

Use Edit, Object, Purge to remove an individual object from a module.


Use Edit, Purge All to permanently delete all objects previously deleted in
the formal module. A trace of the delete and purge is recorded in the
Properties History.

TRW Automotive Inc. 2004

53

DOORS Training Importing Process

Identify essential source data


Select DOORS module
Analyze source data format
Select import method
Prepare source for import
Dry run import; if necessary, fix source
Import, check & save module
Files may be imported into new (empty) formal modules, or into existing
modules which already contain an object structure.
When importing into an existing module, the imported data will generally
be inserted after the current object in the module (starting at the same level
as the current object).
Word to DOORS export function will only allow you to append the
contents of the Word document to the end of the existing module.

TRW Automotive Inc. 2004

54

DOORS Training Exporting Process

DOORS supports many export formats to provide you with a convenient


method of transferring DOORS data in electronic format to other desktop
tools.
All export tools are found under the File, Export menu.
Export allows DOORS data to be transferred to other tools in known
formats.
Export to popular publishing applications
Export to ASCII
Export to other tools and the Web
DOORS exports the objects in the current View.

TRW Automotive Inc. 2004

55

DOORS Training Word Formatting Concepts

DOORS uses styles to map Word paragraphs to formal module objects


Heading 1 = Level 1 heading object
Heading 2 = Level 2 heading object
Heading 3 = Level 3 heading object
Normal = Object text
Before exporting a Word document to DOORS, ensure the Word document
is appropriately formatted to yield the desired content and structure in a
DOORS formal module.
Every Word paragraph is mapped to a DOORS object.
Any tables in the Word file will be brought into DOORS as DOORS tables.
Graphics in the Word file will be brought into the DOORS module as
embedded OLE objects.
Title page, table of contents, and any other formatter used in Word does
not need to exported to DOORS.

TRW Automotive Inc. 2004

56

DOORS Training From DOORS To Word

Use File, Export, Microsoft Office, Word to export the contents of a


DOORS module to a Word document.
This function exports the following to Microsoft Word:
Object Heading, Object Text, Tables, Pictures and icons, Embedded
OLE objects
Use the Advanced options to define the following for export
Use Paragraph Style attribute to use style information that was
captured in the Paragraph Style attribute during Word to DOORS
importing.
Allow the style mapping to map the DOORS features to Word styles.
Ignore DOORS table borders, put all borders on all cells.
Ignore DOORS column widths in table layout export, Auto Format
instead.
Use normal template to format the document using Normal.dot Word
template.

TRW Automotive Inc. 2004

57

DOORS Training Split Object Text

Use Tools, Functions,


Split object Text
To decompose
compound requirement
paragraphs into discrete
requirements that are
independently allocated
and verified.

TRW Automotive Inc. 2004

58

DOORS Training Spreadsheet Import

Use File, Import, Spreadsheet


Use with Word tables, Excel,
Lotus, Access
Map columns to attributes
From select list
From column header row
Choose import option
If create, navigate to desired
parent object (insertion point)
All imported objects are
siblings (no hierarchy)
Identify delimiter
Select input file

TRW Automotive Inc. 2004

59

DOORS Training Tables in DOORS

Tabular data can be displayed in a formal module as an OLE object or a


DOORS table.
Using OLE, the entire table is in a single DOORS object.
In a DOORS table, each table cell is a separate DOORS object
(displayed in a tabular format).
Tables are basically a displayed database of information.
Many of our customers and development teams provide their required
parameters as tabular data.
Part of the development teams job is to extract the data from a Word file
provided by customers, and create objects with attributes to manage the
data.

TRW Automotive Inc. 2004

60

DOORS Training Baselines


Baselines are read-only copies of a formal module and cannot be edited.
You can only edit the current version of a module.
The name of the last (most recent) baseline is displayed within the title bar of the
formal module window.
History is stored relative to the last baseline.
It builds up over the evolution of the version.
Baselining leaves the new history empty except for the baseline date.
The life history of a module is stored across a series of baselines.
Frequent baselining is recommended for large modules that are undergoing frequent
changes.
Baselines are typically created at significant stages of a project.
Creation 0.1
Baseline 1.0
Update 1.1 (modifications after 1st baseline)
Review 1.2 (2nd modifications after 1st baseline)
Baseline 2.0 (2nd baseline)
TRW Automotive Inc. 2004

61

DOORS Training Saving Baseline

Use File, Baseline, New


Select version
Increment the 1st digit of the
baseline number to create a
major baseline.
Increment the 2nd digit to create
a minor baseline.
Enter suffix (if desired)
Enter description
Click OK

TRW Automotive Inc. 2004

62

DOORS Training Opening Baselines

Use File, Baseline, View


Opens the baseline version in
read-only mode.
Provides the contents of the
module at the time that it was
baselined.
Select the baseline to view
Description is displayed
Click OK to open
Shading indicates all contents
are read-only

TRW Automotive Inc. 2004

63

DOORS Training Copy Baseline

Use File, Baseline, Copy


Copies a saved baseline to a new
formal module.
Can be used to revert to
previous baseline
Can be used to create module
template
Select baseline to copy
Verify new module name and
description
Include headings only or all
information
Select OK

TRW Automotive Inc. 2004

64

DOORS Training Compare Baselines

Use File, Baseline, Compare


The user can determine the number of changes that occurred between two
baselines or between the current version and a baseline.
The results are accumulated in a dialogue box and the formal module is
filtered to display only the objects that have changed.

TRW Automotive Inc. 2004

65

DOORS Training Delete Baseline

Caution: Deleting a Baseline deletes the associated history


As a baseline deletion is not reversible, you may want to archive the
baseline before deleting the baseline, so that it can be restored should you
need access to that history information.
Use File, Baseline, Delete
This only shows up if you are a Database Manager or Custom user
with the ability to Manage a Database.
Must have Delete access to the module.
Can be used to delete superfluous baselines from the database.
Select baseline to be deleted
Select Delete

TRW Automotive Inc. 2004

66

DOORS Training Archive and Restore

Archives can be created to prevent the loss of important data.


User with Can Archive Data privilege can archive:
Projects
Modules
User lists (only the Administrator can restore use lists)
Archived data should be restored in the same location in the same
DOORS database.
Use Partition/Rejoin to transfer data between databases.
Use DOORS Exchange Utility software for synchronizing two different
databases.

TRW Automotive Inc. 2004

67

DOORS Training Shanghai Database

TRW Automotive Inc. 2004

68

DOORS Training Shanghai Database

TRW Automotive Inc. 2004

69

DOORS Training Koblenz Database

TRW Automotive Inc. 2004

70

DOORS Training Koblenz Database

TRW Automotive Inc. 2004

71

Thank You

TRW Automotive Inc. 2004

72

You might also like