Requality: general information

What is Requality

Requality is a tool to manage requirements primarily to software. It allows:

Multiuser revision control for documents and requirements is supported. You can use any revision control system, e.g. Subversion or Git.

The tool is implemented as an Eclipse plugin. It could be used in IDE based on this platform, and independently.

About team

Requality home page

UniTESK Lab, Institute for System Programming of RAS

System requirements

  1. Windows or Linux. x86 and x64 architectures supported. If using x86 architecture all tools listed below should be x86 too. If using x64 all used tools could be x86 all or x64 all. Currently there is no supported browser engine for Windows x64, that could be integrated to Eclipse, so you should use x86 versions for Windows x64.
  2. Sun/Oracle Java SE 6.0.
  3. Eclipse Platform 3.5, (3.7.1 recommended). You can use Platform Runtime Binary (about 50MB) or any other package based on it.
  4. XULRunner 1.9.2.19 (currently Eclipse doesn’t support XULRunner 2.0 and later) XULRunner Eclipse plugin: update site. For Linux you can use WebKit instead of XULRunner.
  5. CVS, Subversive, EGit (recommended) or any other Eclipse Team Provider — it depends on your version control system.


Dependency Min
version
Recommended version Windows Linux
x86 x64 x86 x64
Sun/Oracle Java SE
6.0
7.0
x86
x86
x86 or x64
Eclipse Platform
3.5
3.7.1
x86
x86
x86 or x64
XULRunner
1.9.2.19
1.9.2.19,
(for now Eclipse doesn’t supports
XULRunner 2.0 and later)
x86
x86
x86 or x64

Preparation to Requality installation

Eclipse installation

To install Eclipse unpack the archive to any convenient place. This creates an 'eclipse' sub-directory.

If using Java 7, to turn on backward compatibility mode add following string to the end of 'eclipse.ini' file

-Djava.util.Arrays.useLegacyMergeSort=true

Following instructions expects you to know how to install Eclipse plugins from an update site.

Browser integration to Eclipse

Requality requires browser engine to be integrated to Eclipse. Mozilla Foundation XULRunner and WebKit are supported.

It’s recommended to use update site (see System requirements) to install Eclipse plugin for XULRunner.

If it is unsuitable for some reason there is another way to install XULRunner:

Installation of plugin for interaction with control version system

Control version system provides collective work with requirements. Check if there are plugins to interact with chosen version control system (CVS, Subversion, git and others) in Eclipse. If needed, appropriate plugin could be installed from Eclipse repository.

Requality installation

There are 2 ways how to install the tool:


Installing Requality from update site

We recommend installing from the update site because it makes version update easier. It uses Eclipse Update Manager – usual Eclipse Platform procedure to install plugins from the update site. Requality update site: http://forge.ispras.ru/repo/requality/site/

Installing Requality to dropins directory

Eclipse Platform supports another way of extention by adding plugin to eclipse/dropins directory.


We take a closer look of these two ways below:


1. Installing Requality by Eclipse Update Manager (from update site)

2. Installing to dropins directory

Requality usecases

  1. Creating a project with base of all requirements.
  2. Importing documents to the project.
  3. Marking up the document by selecting system requirements in the text. Could be done manually or by Document Processor.
  4. Adding test purposes to selected requirements.
  5. Auto-generation of a requirements and test purposes report. There are possibility to create your own report templates.


Note! Additional plugins could be used to add some other functions.

Requality perspective

To open Requality perspective choose in main menu 'Window' -> 'Open Perspective' - >'Other...'. In the opened window choose Requality (see the picture) and push 'OK'.
Choosing Requality perspective

If you create 'Requality' project 'Requality'-perspective opens itself.

Following views are opened in 'Requality' perspective by default:

  1. Requality Explorer – contains a documents tree, tree of requirements, test purposes and comments, reports tree. 'Requality Explorer' is similar to 'Package explorer', but you can open only 'Requality' projects in it. 'Requality' project contains following components:


    Requality Explorer structure

  2. Requality Markup Editor – documents editor (empty gray area on the picture below). Here you can open all imported documents and mark requirements locations. Also reports are opened here.

  3. Properties – view to edit properties of requirements, test purposes, reports, documents. Properties view has some tabs. The number and contents of tabs depends on type of component. Note that you can open several Properties views at the same time. To do this select in the view menu 'New Properties View' item. To fix properties of some special component in Properties view, select 'Pin to Selection' in the view menu or push an appropriate button in the view. Now the content of the view is not being changed even if you switch between other components.

  4. Outline – shows a list of locations marked in current document. Current document is a document that is opened in 'Markup Editor' and is in a focus. At other times this view is empty.

  5. UniEditor – an editor to handle and edit requirements, test purposes and comments. Is opened at the same place as 'Requality Markup Editor'.


Requality perspective