Working with ReqIF Studio

Creating and Editing ReqIF

This on-line course teaches you how to create and edit ReqIF files with ReqIF Studio, our popular requirements editor. It covers the creation of requirements, specifications and links. On the way you learn some tricks like change tracking and traceability analysis.

Content

This Solution contains:

  • 4 Videos (50 minutes)
  • 1 Download
  • 1 PDF
  • 4 other pieces of content

This solution contains a lot of elements that are only accessible to premium members (upgrade now >>).

We will soon offer them as part of an online training package. Curious? Be sure that you are still subscribed to our email messages!

Creating a ReqIF File and Basic Editing (8 min)

Summary

Content: This video lecture describes how to create a new ReqIF file, and the basics of editing.

Target Group: Requirements Engineers

Prerequisites: ReqIF Studio has been installed.

Agenda

  • Create ReqIF File (0:40)
  • Create and Edit Requirements (1:27)
  • Specification Structure / Hierarchy (2:49)
  • Deleting Requirements (4:05)

No video here? This means that you do not have access to this premium content. You can buy full access to all premium content. We will soon offer content packages, which will be cheaper, but will only offer access to a subset of the premium content. Be sure to check the update page regularly, and make sure that you receive our monthly update emails.
Posted in Premium, Video | Comments Off on Creating a ReqIF File and Basic Editing (8 min)

This one-page references is very helpful to understand the data structures that you are creating in the tool.

ReqIF Quick Reference

The Essentials of ReqIF on One Page

This one-pager will help you make sense of the ReqIF files that you are working with. Whether you need to understand the structure or decipher the XML: This reference will save you a lot of time.

Posted in Reference | Leave a comment

The ReqIF Header

ReqIF Header Attributes

  • Identifier
  • Title
  • Creation Time
  • ReqIF Tool ID
  • Source Tool ID
  • ReqIF Version (always 1.0)
  • Repository ID (optional)
  • Comment (optional)

More useful than you thought!

Every ReqIF file has a header section, but it is rarely paid much attention to. Nevertheless, it contains some important and useful information, and it's a good idea to understand what information it holds, and how it can be used.

In ReqIF Studio, the header information is accessible from the Main Editor.

A ReqIF File consists of three elements, as shown in the figure below. The ReqIF Header is one of these. It is mandatory and contains information regarding the file itself, some of which makes the handling easier.

ReqIF Header

The following list describes the attributes and points out eventual particularities.

  • Identifier – This attribute identifies the ReqIF file and is mandatory. The identifier must comply with the format of an XML identifier (e.g. no spaces, must start with a character, etc.).  This ID must be different for every file! In other words, even if just one requirement has changed, a new ID must be used. Don't use this ID to track repeated requirement exchanges. That information should be traced in the tool extensions (see information on conversation ID below).
  • Title – A useful, human-readable title. This attribute is mandatory.
  • Creation Time – The timestamp indicating the generation time and date of this file. This attribute is mandatory and must be formatted as an XML dateTime. Note that the timezone information is optional but recommended.
  • ReqIF Tool ID – An identifier for the ReqIF exporter has to be provided here. This mandatory attribute should not be confused with the Source Tool ID, but may be identical if the requirements tool has the built-in capability of exporting ReqIF.
  • Source Tool ID – This is the identifier of the requirements tool and is mandatory.
  • ReqIF Version – Here the version of ReqIF is required. Note that this currently has always to be "1.0", even for ReqIF 1.1 and 1.2! This sounds confusing, but is required this way, as the schema of those versions has not changed (see ReqIF FAQ).
  • Repository ID – This optional attribute allows the writing tool to provide information regarding the repository of the data, e.g. the database that has been used.
  • Comment – This optional attribute can be used freely. It is not recommended to use it for information that is being machine processed. The tool extensions are recommended for this purpose.

A note on ReqIF ID and Conversation ID. It is tempting to use the ReqIF ID to track the repeated exchange of requirements between two parties, and some tools have been known to do this (hopefully not any more). Resist the temptation and don't do it! For one, you risk that a tool does not even analyze the content of your file, as the ID has not changed. This is also a violation of the ReqIF standard. Instead, the ReqIF Implementor Forum has defined a tool extension for exactly this purpose. Using the tool extension is the recommended approach.

There are three representations of the ReqIF Header, as shown in the figure below:

  • The ReqIF Standard uses a UML representation, as shown on the left. Please consult the standard for detailed information, e.g. the types of the attributes.
  • The header is stored as XML in the file, as shown in the middle. In ReqIF Studio, you can inspect the XML by right-clicking on a .reqif file and opening it as Text.
  • In ReqIF Studio, the Main Editor has a form that shows the header attributes and allows some of them to be edited, as shown on the right.

Images: Unsplash, OMG

Posted in Reference | Comments Off on The ReqIF Header

Configuration of Datatypes (20 min)

Summary

Content: This video lecture describes how Datatypes work in ReqIF Studio, and explain how they are customized. In the process, it covers adding new requirements attributes, validation, ID generation and interoperability issues.

Target Group: Administrators of requirements models

Prerequisites: ReqIF Studio is installed. Basic ReqIF Studio editing knowledge.

Agenda

Agenda (cont.)

  • Validation (10:19)
    • Datatype Validation (10:36)
    • Specification Validation (11:31)
    • Value Validation (12:14)
  • Creating new SpecTypes (12:33)
  • Using new SpecTypes (14:11)
  • Additional Concepts (15:06)
  • Interoperability (16:05)
  • ID Generation (17:56)
No video here? This means that you do not have access to this premium content. You can buy full access to all premium content. We will soon offer content packages, which will be cheaper, but will only offer access to a subset of the premium content. Be sure to check the update page regularly, and make sure that you receive our monthly update emails.

Lecture Notes

Posted in Premium, Video | Comments Off on Configuration of Datatypes (20 min)

Traceability with SpecRelations (15 min)

Summary

Content: This video lecture describes how links are created in ReqIF Studio, in order to create traceability between requirements. Links, or Traces, are called SpecRelations in ReqIF. This lecture explains how they are created, edited and customized. In particular, it explains how traceability can be used for analysis, like change management or visualizing a traceability matrix.

Target Group: Requirements Engineers

Prerequisites: ReqIF Studio is installed. Basic ReqIF Studio editing knowledge.

Agenda

  • Creating SpecRelations (1:09)
    • Creating a test file (1:17)
    • Creating a SpecRelation (1:43)
    • Understanding SpecRelations (2:54)
    • Creating multiple links in one step (3:58)
  • Datatypes for SpecRelations (4:50)
  • Advanced Concepts (6:06)
    • Link column in the Specification Editor (6:12)
    • Following links (7:02)
    • List of all SpecRelations (7:39)
    • Searching for SpecRelations (8:20)
    • SpecRelationGroups (8:47)

Agenda (cont.)

  • Change Management (9:50)
    • Using the Template for Change Management (10:29)
    • Change Management in practice (11:51)
    • Presentation (plug-in) configuration for change management (12:15)
  • Deduct traceability matrix (13:07)
No video here? This means that you do not have access to this premium content. You can buy full access to all premium content. We will soon offer content packages, which will be cheaper, but will only offer access to a subset of the premium content. Be sure to check the update page regularly, and make sure that you receive our monthly update emails.

Lecture Notes

Up Next / Related

Posted in Premium, Video | Comments Off on Traceability with SpecRelations (15 min)

Traceability Template

Traces are the Foundation for Change Management

ReqIF Studio has powerful features for change management. In particular, SpecRelations (traces) can be flagged if source or target of a it change.

This template consists of a preconfigured stakeholder requirements spec and a system requirement spec. These can be connected with a traceability that is enabled for change management.

You find usage instructions as part of the template.

How to Use

To use this template, follow these steps:

  • Make sure you have ReqIF Studio installed.
  • Create a Project (see Handbook).
  • Import the template (which you first have to download) by dragging it into the Project. Alternatively, you can use the import wizard via File | Import ... | File System.
  • Optional: Rename the template, as you see fit.
  • Open the template and follow the instructions inside.
  • Also consult the Handbook chapter on this feature.

Posted in Template | Comments Off on Traceability Template

Deduct

Creating a traceability is only half the story – making sense of it is another. A common tool for this purpose is a traceability matrix. Such a matrix visually shows the relationship between two sets of elements in a grid.

No download button here? This means that you do not have access to this premium content. You can buy full access to all premium content.

For news and offers, be sure to check the update page regularly, and make sure that you receive our monthly update emails.

Traceability Matrix

deduct-matrixThe Situation: Traces are important in development. They are realized in ReqIF with SpecRelations and can connect requirements to tests ("tests" relationship), stakeholder requirements to system requirements ("realizes" relationship). Creating the required traces is the first step towards better development.

The Challenge: Creating traces is not enough: The traceability must be analyzed as well. Analytical questions include: "Is every requirement tested?" or, "Is every stakeholder requirement realized?

Solution: By creating a grid with one set of elements on one axis and another set of elements on the other axis, an established traceability can be quickly grasped. For instance, the matrix to the right shows requirements on the vertical axis and tests on the horizontal axis. Three traces are shown, indicating that R-1 and R-5 are not yet covered by a test, and that T-1 and T-5 are not yet associated with a requirement.

Results: Deduct visualizes relationships as shown in the figure. It produces a nicely formatted HTML output that highlights missing relations, thereby making it easy to spot them. It also produces CSV, which can be read by Excel, for further processing.

Features

  • Specifications define the axes of the matrix
  • Reduce the axes by applying filters
  • More than one SpecRelationType possible
  • Highlights incomplete traceability
  • Automatically adds SpecRelations that are not covered by the Specifications
  • HTML output (can be pasted into Word)
  • CSV export (can be opened with Excel)

Posted in Premium, Software | Comments Off on Deduct

Specifications in ReqIF Studio (7 min)

Summary

Content: This video lecture describes how Specifications workin ReqIF Studio. Besides creating, editing and typing, this lecture also describes printing and exporting them to a word processor.

Target Group: Requirements Engineers

Prerequisites: ReqIF Studio is installed. Basic ReqIF Studio editing knowledge.

Agenda

  • Download the template (0:41)
  • Main Editor (1:06)
  • Spec Editor (1:44)
  • Arranging Editors (2:18)

Agenda (cont.)

  • Creating and Editing Specifications (3:08)
  • Printing Specifications (5:44)
  • Exporting to a Word Processor (6:34)
No video here? This means that you do not have access to this premium content. You can buy full access to all premium content. We will soon offer content packages, which will be cheaper, but will only offer access to a subset of the premium content. Be sure to check the update page regularly, and make sure that you receive our monthly update emails.

Lecture Notes

Up Next / Related

Posted in Video | Comments Off on Specifications in ReqIF Studio (7 min)

Face-to-Face Training (German and English)

Nothing beats working with a real person

This library is designed to give you as much information as possible, using various digital formats, let it be a PDF, a video to software. But if you need to absorb a lot of information in a short time, nothing beats working with an expert. This is why we offer trainings on a regular basis:

Posted in Training | Comments Off on Face-to-Face Training (German and English)