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 x86-64 architectures supported. If using x86 architecture all tools listed below should be x86 too. If using x86-64 all used tools could be x86 all or x86-64 all. Currently there is no supported browser engine for Windows x86-64, that could be integrated to Eclipse, so you should use x86 versions for Windows x86-64.
  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 (for Eclipse lower 4.4) Eclipse plugin: update site. For Eclipse 4.4 (Luna) and higher you should use XULRunner 10.0.4esr. For Linux and Eclipse lower 4.4 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 x86-64 x86 x86-64
Sun/Oracle Java SE
6.0
7.0
x86
x86
x86 or x86-64
Eclipse Platform
4.2
4.3
x86
x86
x86 or x86-64
XULRunner
1.9.2.19
1.9.2.19,
(for Eclipse lower 4.4.)
or 10.0.4esr
(for Eclipse 4.4 and higher)
x86
x86
x86 or x86-64

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. Depending on the operating system it is recommended to use a different browser engine.


NOTE! After Requality installation you can check if browser engine has been installed successfully. See instructions here.


Operation System Eclipse < 4.4 Eclipse >= 4.4
Windows x86
XULRunner plugin (from update site) XULRunner 10.0.4esr
Windows x86-64
XULRunner plugin (from update site)
+ Visual C++ 2010 runtime
XULRunner 10.0.4esr
+ Visual C++ 2010 runtime
Linux x86
XULRunner plugin (from update site) WebKit
Linux x86-64
XULRunner plugin (from update site) WebKit


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. In the case of Subversion it is recommended to use Subversive plugin (Subclipse plugin is not recommended).

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

After installation

After Requality installation it's recommended to check if browser has been successfully installed to Eclipse.

In Eclipse main menu select 'Window -> Preferences'. In 'Preferences' select menu 'Requality'. On the right you can see what browser engines are integrated with 'Eclipse' and which one is currently in use.


Browser engine selection


To change active browser engine click on 'Browser Engine' field and select required one in the drop-down list. Then save changes by 'Apply' button. After that Eclipse should be restarted for the changes to take effect.

If required browser engine has 'not available' status in the drop-down list, this means that either you have not installed it yet or the installation has been failed. You can activate only browser engine with status 'available'.

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