With DOORS Next Generation to the next level of requirements management.

I have been working with the requirements management solution IBM Engineering Requirements Management DOORS (formerly Telelogic DOORS and Rational DOORS) since the end of 2006 and with IBM DOORS Next Generation since 2011. Both solutions are used to specify systems and software in requirements management. In this article I present the differences to DOORS and the main functionalities of IBM DOORS Next Generation.

Requirements Management

Good requirements are the basis for successful system or software development. Suitable software in requirements management (AM) that supports the fulfillment of customer requirements and business goals is helpful. In many customer projects, whether in the aerospace or automotive industry, IBM DOORS has been used successfully for many years to capture, track, analyze and manage requirements. Numerous market and IT trends are constantly posing new challenges for both customers and AM tools. In addition to DOORS, IBM is therefore offering an additional solution with DOORS Next Generation, which relies on proven DOORS practices but offers new, groundbreaking technological and methodological options for both systems engineering and IT customers.

DOORS as a proven solution IBM DOORS (Dynamic Object Oriented Requirements System) has a success story spanning more than 20 years. It was already used by the aerospace industry for specification in the 1990s. Since the turn of the millennium, the automotive industry has increasingly used DOORS. The reasons for this lie in the powerful traceability functions, which provide evidence of whether the requirements have been implemented as described. The tool supports a regulated and process-safe data exchange of specifications between OEM and supplier. In addition, DOORS scales in terms of project size and complexity and can be flexibly expanded with DXL.

DOORS Next Generation Dashboard
next

DOORS Next Generation Basics

With the development of IBM DOORS Next Generation, IBM responded to the wishes of developers, project managers and IT managers a few years ago.

DNG is an AM system designed for collaboration between teams. It is web-based and uses the IBM Jazz platform. The Jazz Team Server offers an open integration architecture and collaboration through work items, dashboards, reviews and comments. The server supports the collaborative management of users and their rights, projects, data types, artifact types, attributes and keywords. Using common services and project-wide type systems, project templates and glossaries, project teams can define and manage their requirements consistently.

In lifecycle projects, administrators can manage project areas, team members and processes in all associated applications (requirements management, change and configuration management, quality management and design management). In addition, common commercial databases are supported, which provide flexible and standardized operating processes for system and project administrators. In terms of approach, IBM DOORS Next Generation is not a direct successor to IBM DOORS. The classic DOORS is still ideal for teams that need a mature, proven AM system and the corresponding professional industry functionality based on a classic full client. With regard to a smooth migration or interoperation, existing DOORS customers with active maintenance and support have the option of using DNG at no extra charge.

IT requirements

Effective collaboration and communication within a team are extremely important for product development. Many specialists and teams contribute their knowledge and need a user-friendly front end to describe, define and query requirements.

While document-based work on a specification used to be possible only with a rich client, web-based work is becoming more and more popular in many tools. This trend is also accelerating with the increased use of mobile devices in everyday work. More and more IT departments are examining the high rollout costs every time a rich client is updated on hundreds or even thousands of user clients. Since with DOORS Next the user accesses the Jazz platform with a web browser, a rich client no longer needs to be rolled out. The architecture is predestined for worldwide, decentralized access via WAN and makes a terminal server superfluous.

Clear user guidance in the tool and high-performance work are important requirements for an AM solution. DNG takes advantage of the enormous advances in web technology and allows easy and convenient work on document-oriented artifacts in the browser, including important functionalities such as drag-and-drop linking.

DOORS Next Generation Modulansicht

Defining and structuring requirements

DOORS Next Generation offers flexible ways to define and structure requirements. In a requirements project, requirements can be created as rich text artifacts and graphical artifacts. While in DOORS a requirement must always be created within a module, in DNG requirements can also be created, edited and linked individually in the project. This is particularly useful for less complex development projects.

If, however, a document-based approach is required, two different ways are available to group and manage artifacts. Collection is a group of artifacts with no specific order or hierarchy. A module is the document format known from IBM DOORS with a hierarchy of artifacts.

Use cases and user stories

When asked in the 2013 RE Compass about the techniques and notations for requirements documentation, natural language is still in the lead with around 75%, but use cases and user stories are already in second place with over 60%. DNG allows both techniques and provides an editor in the web browser for defining requirements in rich text documents and graphical representations.

The user can use business process diagrams to represent business process flows or create sketches of user interfaces that contain reusable sketch parts.

The relationship between use cases and actors can be described in use case diagrams. Also supported are storyboards in which frames are sequentially numbered and displayed on a timeline, and display flows that represent a sequence of user-controlled software processes. If the user wants to integrate models in UML and SysML, DNG offers a link to the IBM Rhapsody Model Manager, which works with IBM Rhapsody and IBM Software Architect and serves as a central design repository for development teams.

Reuse of requirements

In the area of software development, the reuse of artifacts is a common concept. In requirements management, however, it has been used less so far and copying the requirement with a link back to the original requirement has dominated.

A new product development is often based on previous development work from other projects. This applies today, among other things, to the automotive industry, where the majority of requirements for a new product line are generic. Why should requirements that are less dynamic always be created anew in a project? Simply duplicating the information and setting a link back to the original information is quick to implement and involves clear responsibility, but it can lead to error-prone manual effort as soon as the duplicate has to be synchronized with the original when changes are made.

DOORS Next Generation includes both methods and allows "copying and linking" as well as reuse in the specification module. The artifact can be reused in the project, regardless of whether it is a requirement, heading, image, model or information.

Requirements Configuration Management

As the product portfolio grows and complexity increases, it becomes increasingly difficult to keep track of everything. This is particularly the case when product lines come into play in development. How can you then ensure that the latest release of a system contains the changes from a dependent development part in addition to the generic requirements of the previous releases?

Or a product contains general functions as well as special functions tailored to the sales market. In addition to reuse, the key words here are "Requirements Configuration Management" and PLE (Product Line Engineering).

Configurations can be used to map development streams and variants by combining certain logically related artifact versions into "components". Artifact versions can be strategically reused in several configurations without copying.

In addition, component hierarchies (products) can be mapped, compared and frozen using a parent-child relationship. Change sets can be used to bundle and track changes to the artifacts.

Conflicts that may arise, such as: Parallel conflicts can be found and resolved accordingly, e.g. using compare and merge. Global configurations can be used to manage requirements data together with artifact types from other domains such as test cases, models and code. Using tools such as IBM Engineering Lifecycle Optimization - Engineering Insights, product lines can be defined, analyzed and visualized across disciplines.

Cross-disciplinary work

Another trend in requirements management is towards a holistic view of the entire life cycle of a product line. From the idea for a product to delivery, various people and teams, as well as special development tools, are involved in the process.

To ensure that the individual development phases can be completed successfully and no information is lost, complete traceability is necessary. Between the individual development phases, it is important to overcome the media breaks that can occur due to different tools and responsibilities. A project manager wants to be able to use simple means to ensure that the latest release contains all planned requirements and agreed changes.

The project status is not only limited to the requirements area, but also extends across disciplines to implementation and thus, in software projects, to the source code. It is helpful for the developer if he can use simple means to understand what the customer or client originally specified as a requirement. This is best done from his development environment, without installing additional tools or "learning" how to use them.

IBM DOORS Next Generation can provide comprehensive traceability and project metrics thanks to its close integration with change and configuration management, as well as test and design management. The project manager can easily see in the dashboard and in reports which requirements are already being implemented, how far they have already been implemented, or which requirements have been included in which release. Cross-disciplinary traceability allows an impact analysis to be carried out that determines the consequences of a change request. In DNG, the user can display the content of the linked artifact in a small window within their work area by hovering over a link with the mouse, even across discipline boundaries. To display the traceability information, the user does not have to carry out data synchronization or leave the usual work environment.

Open interfaces and expandability

While basic functionalities such as linking, drawing baselines and displaying traceability were often sufficient for AM tools in the past, today the entire process must be kept in mind. Projects must be viewed as a coherent process from the recording of customer requirements to the delivery of the system or software. At the same time, various tools are used in the overall process, which usually do not all come from the same software manufacturer and do not contain standard interfaces between the individual development disciplines. For the IT department, this means integrating various tools in the development process, connecting external service providers and at the same time establishing a reliable data exchange with suppliers.

How can artifacts along the lifecycle of an application, such as requirements, models, tasks, source code or test cases, be consistently linked and traceable? Ideally with standard interfaces and not point-to-point integrations, which are costly to maintain and quickly lead to risks as soon as the underlying operating system is updated or a new version of the interface specification is used.

Under the umbrella term Open Services for Lifecycle Collaboration (OSLC), IBM uses a lifecycle integration approach in its tools that is comparable to the hypertext concept of Internet architecture. Each resource is given a universal address that can be used to address it from any tool or other lifecycle resource. For example, users can use the OSLC integration protocol to link requirements in IBM DOORS with artifacts in DNG, thereby establishing interoperation between the two RM solutions. OSLC support is now offered not only by many IBM Engineering solutions, but also by numerous other applications.

In addition to OSLC, dashboards and various configuration options, the Client Extension Capability can be used to implement extensions such as consistency checks based on ISO 26262 ASIL via Javascript, which are among some freely available examples.

Data exchange

The communication and data exchange between different teams and between those involved in the supply chain make an important contribution to project success. The aim is to make production data available to everyone involved in a consistent manner. Requirements data between DNG and other AM tools can be exchanged bidirectionally via the implementation of ReqIF.

next

Imprint

Hubert Spieß
Siegesstraße 25
80802 München
Tel. 0175 7281914
Internet: www.hubert-spiess.de
E-Mail: mail@hubert-spiess.de

Datenschutzhinweis

Erhebung und Speicherung personenbezogener Daten sowie Art und Zweck von deren Verwendung beim Besuch der Website. Beim Aufrufen der Website hubert-spiess.de werden durch den auf Ihrem Endgerät zum Einsatz kommenden Browser automatisch Informationen an den Server unserer Website gesendet. Diese Informationen werden temporär in einem sog. Logfile gespeichert. Folgende Informationen werden dabei ohne Ihr Zutun erfasst und bis zur automatisierten Löschung gespeichert:

IP-Adresse des anfragenden Rechners, Datum und Uhrzeit des Zugriffs, Name und URL der abgerufenen Datei, Website, von der aus der Zugriff erfolgt (Referrer-URL), verwendeter Browser und ggf. das Betriebssystem Ihres Rechners sowie der Name Ihres Access-Providers.

Die genannten Daten werden durch uns zu folgenden Zwecken verarbeitet: Gewährleistung eines reibungslosen Verbindungsaufbaus der Website, Gewährleistung einer komfortablen Nutzung unserer Website, Auswertung der Systemsicherheit und -stabilität sowie zu weiteren administrativen Zwecken.

Die Rechtsgrundlage für die Datenverarbeitung ist Art. 6 Abs. 1 S. 1 lit. f DSGVO. Unser berechtigtes Interesse folgt aus oben aufgelisteten Zwecken zur Datenerhebung. In keinem Fall verwenden wir die erhobenen Daten zu dem Zweck, Rückschlüsse auf Ihre Person zu ziehen.

Weitergabe von Daten

Eine Übermittlung Ihrer persönlichen Daten an Dritte zu anderen als den im Folgenden aufgeführten Zwecken findet nicht statt. Wir geben Ihre persönlichen Daten nur an Dritte weiter, wenn: Sie Ihre nach Art. 6 Abs. 1 S. 1 lit. a DSGVO ausdrückliche Einwilligung dazu erteilt haben, die Weitergabe nach Art. 6 Abs. 1 S. 1 lit. f DSGVO zur Geltendmachung, Ausübung oder Verteidigung von Rechtsansprüchen erforderlich ist und kein Grund zur Annahme besteht, dass Sie ein überwiegendes schutzwürdiges Interesse an der Nichtweitergabe Ihrer Daten haben, für den Fall, dass für die Weitergabe nach Art. 6 Abs. 1 S. 1 lit. c DSGVO eine gesetzliche Verpflichtung besteht, sowie dies gesetzlich zulässig und nach Art. 6 Abs. 1 S. 1 lit. b DSGVO für die Abwicklung von Vertragsverhältnissen mit Ihnen erforderlich ist.

Betroffenenrechte

Sie haben das Recht:

gemäß Art. 15 DSGVO Auskunft über Ihre von uns verarbeiteten personenbezogenen Daten zu verlangen. Insbesondere können Sie Auskunft über die Verarbeitungszwecke, die Kategorie der personenbezogenen Daten, die Kategorien von Empfängern, gegenüber denen Ihre Daten offengelegt wurden oder werden, die geplante Speicherdauer, das Bestehen eines Rechts auf Berichtigung, Löschung, Einschränkung der Verarbeitung oder Widerspruch, das Bestehen eines Beschwerderechts, die Herkunft ihrer Daten, sofern diese nicht bei uns erhoben wurden, sowie über das Bestehen einer automatisierten Entscheidungsfindung einschließlich Profiling und ggf. aussagekräftigen Informationen zu deren Einzelheiten verlangen;

gemäß Art. 16 DSGVO unverzüglich die Berichtigung unrichtiger oder Vervollständigung Ihrer bei uns gespeicherten personenbezogenen Daten zu verlangen;

gemäß Art. 17 DSGVO die Löschung Ihrer bei uns gespeicherten personenbezogenen Daten zu verlangen, soweit nicht die Verarbeitung zur Ausübung des Rechts auf freie Meinungsäußerung und Information, zur Erfüllung einer rechtlichen Verpflichtung, aus Gründen des öffentlichen Interesses oder zur Geltendmachung, Ausübung oder Verteidigung von Rechtsansprüchen erforderlich ist;

gemäß Art. 18 DSGVO die Einschränkung der Verarbeitung Ihrer personenbezogenen Daten zu verlangen, soweit die Richtigkeit der Daten von Ihnen bestritten wird, die Verarbeitung unrechtmäßig ist, Sie aber deren Löschung ablehnen und wir die Daten nicht mehr benötigen, Sie jedoch diese zur Geltendmachung, Ausübung oder Verteidigung von Rechtsansprüchen benötigen oder Sie gemäß Art. 21 DSGVO Widerspruch gegen die Verarbeitung eingelegt haben;

gemäß Art. 20 DSGVO Ihre personenbezogenen Daten, die Sie uns bereitgestellt haben, in einem strukturierten, gängigen und maschinenlesebaren Format zu erhalten oder die Übermittlung an einen anderen Verantwortlichen zu verlangen;

gemäß Art. 7 Abs. 3 DSGVO Ihre einmal erteilte Einwilligung jederzeit gegenüber uns zu widerrufen. Dies hat zur Folge, dass wir die Datenverarbeitung, die auf dieser Einwilligung beruhte, für die Zukunft nicht mehr fortführen dürfen und

gemäß Art. 77 DSGVO sich bei einer Aufsichtsbehörde zu beschweren. In der Regel können Sie sich hierfür an die Aufsichtsbehörde Ihres üblichen Aufenthaltsortes oder Arbeitsplatzes oder unseres Firmensitzes wenden.

Widerspruchsrecht

Sofern Ihre personenbezogenen Daten auf Grundlage von berechtigten Interessen gemäß Art. 6 Abs. 1 S. 1 lit. f DSGVO verarbeitet werden, haben Sie das Recht, gemäß Art. 21 DSGVO Widerspruch gegen die Verarbeitung Ihrer personenbezogenen Daten einzulegen, soweit dafür Gründe vorliegen, die sich aus Ihrer besonderen Situation ergeben oder sich der Widerspruch gegen Direktwerbung richtet. Im letzteren Fall haben Sie ein generelles Widerspruchsrecht, das ohne Angabe einer besonderen Situation von uns umgesetzt wird.

Möchten Sie von Ihrem Widerrufs- oder Widerspruchsrecht Gebrauch machen, genügt eine E-Mail mail@hubert-spiess.de

Datensicherheit

Wir bedienen uns geeigneter technischer und organisatorischer Sicherheitsmaßnahmen, um Ihre Daten gegen zufällige oder vorsätzliche Manipulationen, teilweisen oder vollständigen Verlust, Zerstörung oder gegen den unbefugten Zugriff Dritter zu schützen. Unsere Sicherheitsmaßnahmen werden entsprechend der technologischen Entwicklung fortlaufend verbessert.

Aktualität und Änderung dieser Datenschutzerklärung

Diese Datenschutzerklärung ist aktuell gültig und hat den Stand Mai 2018. Durch die Weiterentwicklung unserer Website und Angebote darüber oder aufgrund geänderter gesetzlicher beziehungsweise behördlicher Vorgaben kann es notwendig werden, diese Datenschutzerklärung zu ändern. Die jeweils aktuelle Datenschutzerklärung kann jederzeit auf der Website unter Datenschutzhinweis von Ihnen abgerufen und ausgedruckt werden.

Hinweis: Basistemplate ist von HTML5 UP und lizenziert unter Creative Commons Attribution 3.0 License.