Kennenlernen der DOORS® Strukturelemente und den

DOORS® Basis-WerkzeugenUm effizient mit DOORS® arbeiten zu können sind die Kenntnisse der Strukturele-

mente (Items) eine wichtige Voraussetzung.Im diesem 1. Teil des IBM® Rational® DOORS® StartUp Training lernen Sie die Struk-

turelemente und deren Zusammenhänge kennen. Des Weiteren werden die Basis Werkzeuge zum Umgang mit den Strukturelementen gezeigt. Erstellen und Editieren

von Objekten, Umgang mit Attributen, Views, Verlinken von Objekten ... Auf Grund dessen das DOORS® als Werkzeug zur Zeit nur in englischer Sprache ver-

fügbar ist, werden die Begriffe in diesem Dokument ebenfalls in Anlehnung der Originaldokumentation und an die DOORS®-Befehle in englischer Begrifflichkeit ge-

nutzt. Nur so kann die Bedienung von DOORS® erlernt werden. Dadurch lässt es sich an manchen Stellen nicht vermeiden, dass sich deutsch und englisch in diesem Doku-

ment mischen.

StrukturelementeIBM® Rational® DOORS® StartUp Training - Teil 1

Inhalt:

Strukturelemente und deren Zugriffs-Architektur

DOORS Database Explorer

DOORS Document Explorer

Editieren von Anforderungen

Arbeiten mit Attributen

Arbeiten mit Views

DOORS® Access Architecture

Seite - 2 -

RightsNone (N)

Read Read (look at) Items

(R)

Create Create new Items (C)

Modify Edit existing Items (M)

Delete Delete Items (D)

Admin Change the access rights of Items

(A)

User TypesAdminist-rator

all in any case

Database Manager

CP, AD, PD, CG, CU, MD

Project Manager

AD, PD, CG

User -

Custom User

(Custom)

PowersCreate Projects (CP)

Archive Data (AD)

Partition Data (PD)

Create Groups (CG)

Create User (CU)

Manage Database (MD)

ItemsFolder

Project

Document (Module)

Object

Attribute

Property

UserUser

Groups

Die Strukturelemente (Items) in DOORS® (Folder, Projects, Modules, Objects, Attributes) können vom Anwender (User) bearbeitet werden, wenn der User die entsprechenden Rechte (Read, Create, Modify, Delete, Admin) besitzt. Den einzelnen Usern können dafür die Rechte (Rights) zugewiesen werden.Zur einfacheren Administration können die Rechte auf Basis von User-Gruppen (Groups) verwaltet werden. Neben den allgemeinen Rechten gibt es noch User-Typen. Jeder User muss einem Type zugewiesen sein. Der Type gibt an, was ein User mit den Strukturelementen tun darf (Powers wie: Create- Project, -Groups, -User oder Partition Data und Archive Data).

Seite - 3 -

DOORS® Database Explorer

DOORS® Document Explorer

Object Heading

Structured View Object ID Object AttribteLink indicator

Object Text (Requirement)

ChangebarNeues ungespeichertes Objekt

Geändertes ungespeichertes Objekt

Objekt aktuell in Baseline

Objekt nach Baseline geändert

Gelöschtes Objekt

Folder

Project

Deleted Folder

DOORS Module (Dokument)

Database Root

Structured View

Editieren im ExplorerCreate new Folder

Create new Project

Create new Module

Create new Linkmodule

Editieren von Anforderungen

Seite - 4 -

Best Practice TipEin Objekt sollte immer entweder Überschrift (Header) oder Text zu genau einer Anforderung beinhalten. Die Trennung zwischen Überschrift und Text ist bei späteren strukturellen Änderungen und beim Verlinken von Anforderungen hilfreich.

Editieren von ObjektenCTRL + H Objekt Heading editieren

CTRL + T Objekt Text editieren

CTRL + N Neues Objekt auf gleicher Ebene

CTRL + L Neues Objekt Ebene tiefer

Heading und Text tauschen

Delete Objekte löschen

Die DOORS Module (Dokumente) werden im Modul Explorer editiert. Dort können einzelne Anforderungen erzeugt, geändert oder gelöscht werden. Eine Anforde-rung wird auf Basis eines Objektes (Object) erstellt und kann eine Überschrift (Heading), einen Text (Text), meh-rere Attribute (Atributes), eine eindeutige ID (Req. ID) und Eigenschaften (Propertys) haben. Unter den Eigen-schaften befinden sich auch die Zugriffsrechte.

Promote - Demote Object

Verschieben der Objekte in der Hierarchie

Edit Object Eigenschaften (Properties)

Arbeiten mit Attributen

Seite - 5 -

Best Practice Tip Attribute auf Basis von Enumeration sorgen für Konsistenz und erleichtern das Automatisieren.

Priorität Enum ( Mandatory - Highly Re-commended - Recommended)

Product Variante

Enum ( HighEnd - LowEnd - Cust.Spec. )

Teststatus Enum (High, Low, Not necessary)

Object Attributes dienen zum strukturierten Speichern von zusätzlichen Informationen zu Anforderungen. Attribute können sehr gut zur späteren Automatisierung von verschiedenen Arbeitsschritten herangezogen werden.Sie sind Basis für die Erstellung von spezifischen Ansichten (Views). Mit Views, die Informationen abhängig von Attri-buten darstellen, lassen sich die Übersichtlichkeit erhöhen und Zusammenhänge besser darstellen.

Best Practice TipAktivieren Sie „Add new attribute to current view“ dann wird das neue Attribut sofort in Ihrem View angezeigt

1. neuen Type definierenModule Explorer Menue ,Edit-Types‘. Wenn kein neuer Type benö-tigt wird kann auch sofort ein neues Attribut erstellt werden.

2. neues Attribut erstellenDabei wird der zuvor erstellte Type genutzt

Der

zuv

or e

rste

llte

Type

wir

d nu

n au

sgew

ählt

Arbeiten mit Views

Seite - 6 -

Views sind eines der mächtigsten Instru-mente von DOORS. Bei der Entwicklung von komplexen Systemen ist der Grad des Verstehens von bestimmten zusam-menhängen elementar für effizientes Ar-beiten. Unser Gehirn kann zusammen-hänge über mehr als 2 maximal 3 Ebenen nur schwer erkennen und wir verlieren den Überblick. Wird der Fokus jedoch auf ein oder zwei Ebenen gelegt, dann ist der Grad des Verständnisses wesentlich höher. Üblicher Weise werden dazu Informatio-nen in verschiedenen Sichtweisen darge-stellt. Auf Basis von Text Dokumenten entstehen dabei jedoch Redundanzen, die die Wartung und Pflege von Dokumenten aufwändig machen bzw. zu inkonsistenten Dokumenten führen. Mit DOORS lassen sich auf Basis von verschiedenen Views Zusammenhänge darstellen ohne das Informationen redundant abgelegt wer-den müssen. Die Views entsprechen Do-kumenten mit verschiedenen Darstellun-gen von Inhalten, die auf ein in sich konsis-tentes Repository zugreifen.

1. Insert new ColumneMenue ,Insert-Column‘

2. Define Filter Menue ,Tools-Filter‘

3. Save View

Schalten Sie Filter ein und aus

Anlegen von Projekten

Seite - 7 -

A C H T U N G :Mit den Powers eines Projektmana-gers dürfen Sie selber keine Projek-

te anlegen. Ein User mit den Po-wers eines Database Manager muss Ihnen mindestens ein Projekt anle-gen. Innerhalb des Projektes haben Sie die Power für die üblichen Ar-

beiten.

Bevor Sie startenÜberlegen Sie sich die Struktur und Fachdomänen der Mitarbeiter, die in dem Projekt arbeiten werden. Es ist ratsam für jede Ebene einen Folder

einzurichten. In den einzelnen Foldern liegen nun die entsprechenden Dokumente.

Beispiel für eine mögliche Struktur

Folder(Bereiche)

Stakeholder (Bereichs-Verantwortliche)

Module (Dokumente)

Auftraggeber Kunde oder Product Ma-nager

Lastenhefte

Projektierung Projektierung oder Entw. Leitung

Pflichtenhefte, System Specification

Entwicklung System Architekten, HW und SW Entwickler

Architekturbeschreibung, Einheiten auf Implemen-tationsebene.

Test Tester, Qualitätssicherung Testpläne, Testprotokolle

Angelehnt an der obigen Struktur werden in den Modulen entsprechend der Bereiche unterschiedliche Attribute sinnvoll sein. Sie sollten sich als

nächstes die Attribute überlegen und für jeden Bereich ein Modul mit den eingerichteten Attributen als Vorlage erstellen.

Das gleiche gilt für die Views, auch diese sollten Sie sich überlegen und in den Modulen, die als Vorlage dienen, einrichten und speichern.

Haben Sie die entsprechenden Module erstellt, dann können Sie auf Basis der Archiv Funktion im Database Explorer als Template abspeichern und

dann so häufig wieder verwenden, wie notwendig.

Best Practice TipDOORS hat eine kleine Schwäche, Attribute und Views gelten immer be-zogen auf ein Modul und können lei-der nicht kopiert werden. Aus diesem Grund ist es ratsam, sich die benötig-ten Attribute und Views vor der Erst-ellung einer Projekt-Struktur zu über-legen und eine Modulvorlage zu erstel-len. Die benötigten Module können dann auf Basis dieser Vorlage erstellt werden und haben sofort alle definier-ten Attribute und Views.

Module Template erstellen, Aktivieren Sie das Modul, das als Tem-plate gespeichert werden soll im Da-tabase Explorer und archivieren Sie es (Menue ,File‘ - Archive)

Module Template laden

(Menue ,File‘ im Database Explorer)

Zum Administrieren und Aufsetzen von Projekten sollten Sie mindestens die Power eines Project Manager haben.

Wird DOORS in Ihrem Unternehmen bereits eingesetzt gibt es sicher Richtlinien und Vorlagen für Projekte. Erkundigen Sie sich bei den Administ-

ratoren. Es ist dringend zu empfehlen vorhandene Vorlagen zu nutzen.Wenn DOORS noch nicht eingesetzt wird sollte es in Ihrem Unternehmen trotzdem einen DOORS Administrator (oder Power User mit erweiterten

Kenntnissen) geben. Scheuen Sie sich nicht die Hilfe dieser Personen in Anspruch zu nehmen, auch wenn Sie hier nun Hinweise bekommen, wie ein

Projekt sauber aufgesetzt werden kann.

Seite - 8 -

Autor:

ANDREAS WILLERT

Herausgeber:

WILLERT SOFTWARE TOOLS GMBH

Hannoversche Str. 2131675 Bückeburgwww.willert.deinfo@willert.de+49 5722 9678 60

IBM® is a registered trademark of International Business Machines Corporation  Rational® is a registered trademark owned by IBM DOORS® is registered trademark owned by IBMRhapsody® is a registered trademark owned by IBMMS Word® is a registered trademark of Microsoft CorporationGrafik zur Cover-Gestaltung lizenziert über iStockphoto.com

Produkt:

DOORSⓇ START-UP TRAINING