User Manual

www.reqtify.com support@reqtify.com

This document is for information and instruction purposes. Geensoft reserves the right to make changes in specifications and other information contained in this publication without prior notice, and the reader should, in all cases, consult Geensoft to determine whether any changes have been made.

The terms and conditions governing the sale and licensing of Geensoft products are set forth in written agreements between Geensoft and its customers. No representation or other affirmation of fact contained in this publication shall be deemed to be a warranty or give rise to any liability of Geensoft whatsoever.

GEENSOFT MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS MATERIAL INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

GEENSOFT SHALL NOT BE LIABLE FOR ANY INCIDENTAL, INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING BUT NOT LIMITED TO LOST PROFITS) ARISING OUT OF OR RELATED TO THIS PUBLICATION OR THE INFORMATION CONTAINED IN IT, EVEN IF GEENSOFT CORPORATION HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Table of Contents

How to Use this Documentation ........................................................................ 11

Documentation Overview ...................................................................................... 11 Important Product Documentation ........................................................................ 12 Getting Started ...................................................................................................... 12

Capture and Analysis Process ........................................................................... 13

Capture and Analysis ProcessRelated Documentation ........................................ 13 Traceability Elements ............................................................................................ 15
Section ....................................................................................................................... 15 Macro-requirement ....................................................................................................... 15 Requirement ................................................................................................................ 15 Entity ......................................................................................................................... 15 Reference ................................................................................................................... 16 Attribute ..................................................................................................................... 16 Reference Attribute ...................................................................................................... 16 Link............................................................................................................................ 16 Text ........................................................................................................................... 17

Compliance with Quality Standards ....................................................................... 17

Main Window .................................................................................................... 19

Main Window Presentation .................................................................................... 20 Menu Bar ............................................................................................................... 21
File Menu .................................................................................................................... 21 Edit Menu.................................................................................................................... 22 View Menu .................................................................................................................. 23 Tools Menu .................................................................................................................. 24 Reports Menu .............................................................................................................. 24

Toolbar .................................................................................................................. 25 Status Bar .............................................................................................................. 27 Project Workspace................................................................................................. 27 Management View ................................................................................................. 27
Description .................................................................................................................. 27 Contextual Menu .......................................................................................................... 29

Coverage Analysis View ......................................................................................... 29

User Manual

Table of Contents

Description .................................................................................................................. 29 Contextual Menu .......................................................................................................... 31

Impact Analysis View ............................................................................................ 33

Description .................................................................................................................. 33 Contextual Menu .......................................................................................................... 34

Graphical View ...................................................................................................... 36

Description .................................................................................................................. 36 Context Menus ............................................................................................................. 38

Requirement Details View ..................................................................................... 41

Description .................................................................................................................. 41 Contextual Menus ......................................................................................................... 42

Link Details View ................................................................................................... 43

Description .................................................................................................................. 43 Filter field usage .......................................................................................................... 44 Coverage Display ......................................................................................................... 45 Commenting Link Creation and Deletion .......................................................................... 45 Menus ........................................................................................................................ 46

Configuration Dialog Box .................................................................................. 49

Overview ............................................................................................................... 49 Restricted Access to the Configuration Dialog Box ................................................ 50 Management of Concurrent Access ........................................................................ 51
Control Access on Reqtify Activities ................................................................................. 51 User Changes Management ............................................................................................ 52

Project Configuration ........................................................................................ 53

Objectives ............................................................................................................. 53 Description ............................................................................................................ 54
Document Details Area .................................................................................................. 54 Creating Tools ............................................................................................................. 56 Edit Menu.................................................................................................................... 57

Adding a Document ............................................................................................... 57 Adding Coverage Links between Documents ......................................................... 57 Adding a Folder ..................................................................................................... 59 Folders and Coverage Links ................................................................................... 60 Document Covered by Combination of Several Others ........................................... 61 Modification Documents ........................................................................................ 63 Importing an Existing Project ................................................................................ 65 Assigning Categories ............................................................................................. 66

Project Options ................................................................................................. 69

Overview of the General Option pane .................................................................... 70 Overview of the Environment Option pane ............................................................ 71 Overview of the Project Option pane ..................................................................... 72

Reqtify

Table of Contents

Handling Rules ............................................................................................................. 73

Overview of the Connections Option Pane ............................................................. 75

Managing the Analysis Results .......................................................................... 77

Rules Checking ...................................................................................................... 78 Using Views ........................................................................................................... 79
Using the Management View .......................................................................................... 79 Using the Coverage Analysis View ................................................................................... 79 Using the Impact Analysis View ...................................................................................... 81

Displaying Requirement and Reference Types ....................................................... 82 Filters Usage and Advanced Analysis ..................................................................... 83
Display Reducing Filters ................................................................................................ 83 Defining Filters............................................................................................................. 85 Creating a Filter ........................................................................................................... 88 Applying Filters to Project Analysis Results ....................................................................... 89 Impacts of Filters Definition ........................................................................................... 89

Understanding the Coverage Ratios....................................................................... 90

General Case ............................................................................................................... 90 Coverage Ratio for Combined Coverage ........................................................................... 90 Coverage Ratio in the Management View ......................................................................... 91 Impact of Filters on Coverage Ratios ............................................................................... 92

Using Folders ......................................................................................................... 93

Coverage Link between a Low Level Folder and a High Level Folder ..................................... 94 Coverage Links between Documents in a Folder ................................................................ 96 Coverage Links between a Lower Level Folder and a High Level Document ............................ 96 Coverage Links between Lower Level Documents and a High Level Folder ............................. 98

Using Macro-requirement ...................................................................................... 99

Propagation of Elements Attached to the Macro-requirement .............................................. 99 Coverage of Requirements Contained in a Macro-requirement ............................................ 100

Using Requirements Hierarchy ............................................................................ 102

Creating Information ...................................................................................... 105

Adding Traceability Information in your Project Documents ............................... 106
Features for Inserting Coverage Information in Project Files .............................................. 106

Adding Information from ReqtifyBasic Capabilities ........................................... 107

Adding Covering Links .................................................................................................. 107 Adding Attributes ........................................................................................................ 108 Modification of the Added Attributes ............................................................................... 110 Deleting Added Attributes ............................................................................................. 111 Adding Reference Attributes .......................................................................................... 111 Deleting Added Reference Attributes .............................................................................. 113 Adding Text ................................................................................................................ 113 Consistency Checking for Added Information ................................................................... 114

Adding Information from ReqtifyAdvanced Capabilities .................................... 115

Including Types for Added Elements in your Project Configuration ...................................... 115

User Manual

Table of Contents

Adding Covering Links .................................................................................................. 116 Adding Links ............................................................................................................... 117 Deleting Links ............................................................................................................. 118 Assigning Attributes ..................................................................................................... 119 Assigning reference attribute ........................................................................................ 119

Adding Marks ....................................................................................................... 121

Automatic and Persistent Highlight of Modifications .......................................................... 121 Automatic Highlight of Search Results ............................................................................ 123 Creating your own marks ............................................................................................. 124 Using Your Own Marks ................................................................................................. 125 Shortcuts to Add Marks ................................................................................................ 125 Visualizing Marks on Deleted Elements ........................................................................... 126 Using Marks in Filters ................................................................................................... 126

Suspicious Links Management ............................................................................. 126

Detection of Requirement Changes ................................................................. 131

Automatic Detection Modified Elements .............................................................. 131 Managing Changes using Marks ........................................................................... 132 Using Snapshots .................................................................................................. 133
Creating a Snapshot .................................................................................................... 135 Using Snapshots to Compare Results.............................................................................. 136 Element History .......................................................................................................... 137 Opening a Snapshot .................................................................................................... 137 Snapshots Troubleshooting ........................................................................................... 137

Rules Check and Error Messages ..................................................................... 139

Critical Error Messages ........................................................................................ 139 Error Messages .................................................................................................... 140 Warning Messages ............................................................................................... 147 Information Messages ......................................................................................... 148

Generating Reports ......................................................................................... 149

Generating the Traceability Matrix Report ........................................................... 150 Generating the Analysis Results Report ............................................................... 152 Generating the Project Description Report .......................................................... 153 Generating the Upstream Impact Analysis Report ............................................... 154 Generating the Downstream Impact Analysis Report .......................................... 155 Generating the Synthesis of Added Information Report ...................................... 156 Generating the Rules Checking Report ................................................................ 157 Customizing your Report Style ............................................................................ 157
Word document generation ........................................................................................... 158 Excel generation ......................................................................................................... 160

Overview of the Product Work Files ................................................................ 161

Reqtify

Table of Contents

Main Configuration Files in the Installation Directory .......................................... 162

Types Definition .......................................................................................................... 162 Report Templates ........................................................................................................ 163 Templates for Report Styles .......................................................................................... 163

Adding Configuration Files in the Project Directory ............................................. 164

Types Definition .......................................................................................................... 164 Report Templates ........................................................................................................ 164 Templates for Report Styles .......................................................................................... 165

Project Files......................................................................................................... 165

Project Configuration File.............................................................................................. 165 Analysis Results File .................................................................................................... 165 Information File .......................................................................................................... 166 Filter Definition File ..................................................................................................... 166 Sharing Filter Files ....................................................................................................... 166

Environment Variables Declaration...................................................................... 167

TMP Environment Variable ............................................................................................ 167 Debugging Directory .................................................................................................... 168

Appendix: Command Line Options .................................................................. 169

-l <eng|fra|jpn>.................................................................................................. 169 Config="<ConfigDir1>, <ConfigDir2>, ..."........................................................... 169 -regserver ........................................................................................................... 170 -unregserver........................................................................................................ 170 -sync ................................................................................................................... 170

Index .............................................................................................................. 171

User Manual

How to Use this Documentation

This chapter introduces the organization of the documentation. You can read about these topics in:

Documentation Overview Important Product Documentation Getting Started

Documentation Overview
The Reqtify documentation is organized as shown in the following figure:

User Manual

11

How to Use this Documentation

There is one Coupling Note per tool interfaced with Reqtify. These notes describe how Reqtify brings to the engine the information to be analyzed, using either the third party tool API, or dedicated converter, or any other convenient solution. This part is dedicated to administrators or users in charge of Reqtify customization, in relation with the Customization Guide. The Coupling Notes also explain to users how Reqtify interacts with their authoring and verification tool. The Customization Guide explains how you indicate to Reqtify the relevant information that should be picked up in the intermediate files. Such information can include: what are the requirements, attributes, coverage links, and so on. In other words, the Customization Guide explains how to implement your requirement standards in Reqtify. The User Manual explains how to use Reqtify on your projects, such as how to describe your project's process, how to understand the analysis results, how to filter them, how to generate reports. Aspects directly linked to the use of authoring and verification tools are detailed in the Coupling Note for the concerned tool.

Important Product Documentation

Users need to read the User Manual and the Users part of the Coupling Notes for the tools they use (for example Coupling Word, Coupling DOORS, etc.). Administrators or Users who need to implement their requirements standards and to customize Reqtify need to:

Read the Coupling Notes for the tool used in the project or process. This will enable you to understand how the source information is converted and analyzed by the engine. Read the Customization Guide and play the Tutorial (direct links included in the Customization Guide, step by step). Read the User Manual for more information about requirements management aspects and displays of analysis results by Reqtify. This will enable you to understand users concerns and to properly support them.

Getting Started
The best way to familiarize yourself with Reqtify is to complete the following tasks:

Read the Getting Started guide to familiarize you with the main windows, concepts and features. Read and complete the tutorial example in that Getting Started. Review the other sections in the User Manual, and familiarize yourself with all the windows, features and analysis results calculation.

12

Reqtify

Capture and Analysis Process

This chapter explains how the source information is captured and analyzed. You can read about these topics in:

Capture and Analysis ProcessRelated Documentation Traceability Elements Compliance with Quality Standards

Capture and Analysis ProcessRelated Documentation

In order for proper customization to take place, there needs to be a clear understanding of the analysis process. As depicted below, several steps have to be considered:

The source information is brought to the engine by converters. These converters transform the information natively stored in the interfaced tool to an intermediate file containing the information in a format that the engine can analyze. The engine uses the definition of your requirements standards (what is the expected format for requirements, attributes, etc.) to identify elements compliant with this definition in the intermediate file. The engine also uses the project definition, indicating how the intermediate files are supposed to be linked together. This allows the engine to calculate coverage ratios, check consistency rules, etc. The information is stored as analysis results. The results can be filtered to allow more oriented analysis. The results are displayed, produced in reports, or can be exported in tools to automate parts of the requirements management process.

User Manual

13

Capture and Analysis Process

The relationship between this process and Reqtify windows usage can be described as follows:

The Project Editor is used to define the relationship between individual inputs and the Types applied to each document for their analysis. As explained in the Getting Started document, the Project Editor is the entry point for all new projects. The types are customized using the Types Editor. This customization is described in the Customization Guide and not in that User Manual. Once the customization is performed by the Administrator, the internal Support team or Reqtify Application Engineers, Project users will find the types available and ready to use from the Types of Analysis drop-down list box in the Project Editor. The analysis results are displayed in the main window, containing several tabs and information areas. The main windows are introduced in the Getting Started document and detailed in this User Manual. The filters are defined using the Filters Editor, described in this User Manual. The report templates are defined in the Reports Editor for the content, and files created directly in the generation format are used as style sheets for the look and feel. Exports to interfaced tools are activated from the Tools menu and can activate additional windows and buttons. These cases are described in the Coupling Notes.

14

Reqtify

Traceability Elements

Traceability Elements
Reqtify defines the following traceability elements.

Section
A section is a hierarchical file description element. The following are examples of sections:

Heading levels in a Microsoft Word file Tabs in a Microsoft Excel spreadsheet UML packages, diagrams Modules, sub-modules and components of design models

The tree is composed by Reqtifys sections and gives you a hierarchical view of the analyzed input.

Macro-requirement
A macro-requirement is a super-requirement that includes requirements and passes its properties onto those requirements. Any new element attached to a macro-requirement (attribute, text, link or coverage link) is also attached to the requirements and the derived requirements contained within the macro-requirement. A macro-requirement is derived if all its requirements are derived and if it is derived itself. See the section concerning Using Macro-requirement for more details.

Requirement
A requirement expresses either a need or a constraint (technical constraints, costs, deadlines, and so on). The requirement is written either in natural language or as an expressionwhich may be mathematical, geometric, computerized, and so on. A derived requirement is a requirement which does not refer to any Specifications requirement. This requirement is defined in a covering document but it does not cover a specification element. Indeed this requirement appears during the process and is considered as 'derived'.

Entity
By defining an entity, the user defines an element that must cover (contain a reference to) a requirement. If a defined entity does not contain any reference, Reqtify will display a warning message.

User Manual

15

Capture and Analysis Process

This is quite an advanced concept used only in specific cases, for example to detect a dead code. An entity cannot reference itself.

Reference
A reference is the information indicating the coverage (implementation or verification) of a requirement. A reference points to a macro-requirement, requirement, or derived requirement. In Reqtify, the reference can be defined either in a bottom-up direction, where the lowerlevel element covers the higher-level element, or in a top-down direction, where the higher-level element is covered by the lower-level element.

Attribute
Attributes complete the requirement. The following are examples of attributes:

Type of checktest, observation, and so on. Categoryfunctional, operational. Criticalitylow, high, and so on. Flexibilitylow, high. Maturitysource, analyzed, approved, and so on.

Reqtify allows you to define attributes to be analyzed in the project files and filters the display in accordance with these attributes.

Reference Attribute
A reference attribute is added to a reference to define the type of coverage, such as partial coverage or provisional coverage.

Link
A link is reference information that does not concern coverage. The following are examples of links:

Supported by Issued by Checked by Valid under Allocated to Result of

16

Reqtify

Compliance with Quality Standards

Text
Text is the wording of a traceability element. Reqtify attaches the text to the element (section, requirement) detected immediately above it.

Compliance with Quality Standards

Reqtify allows compliance with the traceability objectives defined by quality standards:

CMMI for companies' processes; DO-178B and DO-254 for civil aviation; ECSS-E40 for space; EN 50128 for railways; IEC61508 for industry; ISO 26262 for Automotive; GAMP / 21 CFR parts 820 & 11 for pharmaceutics and medical devices; etc.

User Manual

17

Main Window

This chapter describes the main window of the application. You can read about these topics in:

Main Window Presentation Menu Bar Toolbar Status Bar Project Workspace Management View Coverage Analysis View Impact Analysis View Graphical View Requirement Details View Link Details View

User Manual

19

Main Window

Main Window Presentation

When you launch Reqtify, the main window appears, as shown in the following figure:

The main window is composed of four main parts:

the menu bar the toolbar the project workspace the status bar

20

Reqtify

Menu Bar

Menu Bar
The menu bar contains the following menus: File, Edit, View, Tools, Reports, and Help. Browse the menus in the main window to familiarize yourself with their contents. As you hover over each menu item, the status bar displays a brief explanation of the menu item.

File Menu
The File menu contains the following items: Item New Description Creates a new project. Two saving formats are available Reqtify project with File and Reqtify project with Database. Opens a new project. Saves current modifications of the project. Saves the current project. Two saving formats are available Reqtify project with File and Reqtify project with Database. Renames the current project. Opens the directory where the current project is located. Refreshes the information displayed by reloading the project information. Refreshes the information displayed by reloading ALL the project information. Opens the configuration editor. Opens the types editor. Opens the filter editor. Opens the Snapshot editor. A list of the last projects opened is presented in this menu section. Closes all windows and exits the application.

Open Save Save as

Rename Open Project Directory Reload Reload All Edit Project Edit Types Edit Filters Edit Snapshots <Recent files> Exit

User Manual

21

Main Window

Edit Menu
The Edit menu contains the following items: Item Undo Description Cancels actions on element actions (Attributes, Reference Attributes or Coverage links creation). You can press <Ctrl>+<Z>. Redo Back Forward Copy Copy For Re-does actions on element actions that have been cancelled. You can press <Ctrl>+<Y>. Displays the previously displayed page of the main window. After a Back action, displays the page preceding the Back action. Copies the identifier of the selected requirement to the clipboard or copies the attribute values. Copies the selected element, with options (submenu): ID only or customized additional information defined for creation of direct traceability links. In the Requirement Details View, this function will paste added attributes which have been copied in the clipboard. Deletes the selected links. Available only for the links created from Reqtify. Opens a dialog box to define a search action. You can press <Ctrl> + <F>. Find Next Searches the next occurrence of the string defined in the Find dialog box. You can press <F3>. Find Previous Searches the previous occurrence of the string defined in the Find dialog box. You can press <Shift> + <F3> Find in the tree Marks Navigates from an element displayed in the Rule check section to the element in the analyzed document tree. Provides submenus to create and manage Marks.

Paste

Delete Find

22

Reqtify

Menu Bar

Item Navigate Create Covering Links

Description Displays the source document where the element has been detected. Creates coverage links between the selected requirements. This is only available from the Graphical View and the Coverage Analysis View. Creates links (other than coverage) between the selected elements. Available only in the Graphical View and if links have been defined in a Type for Added Elements. Changes the direction of a link created from Reqtify.

Create Links

Reverse Links

View Menu
The View menu contains the following items: Item Requirements Derived requirements Undefined requirements Uncovered requirements Entities Non Covering Entities Attributes Links Empty Sections Added Information Description Displays or hides requirements. Displays or hides derived requirements. Displays or hides undefined requirements. Displays or hides uncovered requirements. Displays or hides entities. Displays or hides entities covering nothing. Displays or hides attributes. Displays or hides links. Displays or hides empty sections. Displays or hides elements added from Reqtify such as attributes, text or reference attributes.

User Manual

23

Main Window

Tools Menu
The Tools menu contains items depending on:

The advanced interfaces available for your Reqtify and project configuration. The advanced interfaces, among the available ones, effectively used for your current project.

The Tools menu contains the items for dialog with Third Party tools. Each item is fully described in the Coupling Notes for the interfaced tool.

For example, the Tools menu can contain the following items: Item Options Export Document to DOORS Export document to RequisitePro Description Opens the Options editor. Creates DOORS formal modules containing project information, and Link modules for traceability between DOORS requirements and Reqtify analysis results. Creates RequisitePro packages containing project information, and Traceability views for traceability between RequisitePro requirements and Reqtify analysis results. Makes available a requirements list in an authoring or verification tool.

Add High Level Requirements

All trademarks are property of their respective owner.

Reports Menu
The Reports menu contains the following items: Item Edit Reports Description Opens the report editor to create reports and edit report contents.

Library Reports (installed by default). Traceability matrix Analysis results Project description Generates a traceability matrix between selected documents. Generates a report containing the synthesis of analyzed elements. Generates a report with the project description.

24

Reqtify

Toolbar

Item Upstream impact analysis Downstream impact analysis Synthesis of added information Rules Checking

Description Generates a report for upstream impact analysis from an element selected at a low level. Generates a report for downstream impact analysis from an element selected at a high level. Generates a report containing the list of information added from Reqtify. Generates a report containing the list of rule violations.

Project Reports (defined by the user and/or by the Support Team). Subdirectories can be added to the Reports menu and contain reports defined by the user.

Toolbar
The toolbar contains shortcuts to commonly used selections of the menu bar. As shown below, the toolbar contains the following sections: Standard, Configuration, Navigation, View Options, Filtering, and Third Party Tools.

Standard and Access Control (1)Contains buttons for creating, loading and saving project files. Save is locked by user during modifications Configuration (2)Contains buttons for configuring projects, types, snapshots and options. Plug-ins can be added there. Navigation (3)Contains buttons for applying navigation commands previously performed within the coverage information of the Coverage Analysis, Impact Analysis views, Graphical View and Requirement Details. It is only available for these views. View Options (4)Contains buttons to control which requirement elements are visible in the Coverage Analysis, and Impact Analysis views. Filtering (5)Contains the Filter drop-down list box to configure and apply filters. These filters specify the conditions by which to include requirements in analysis or views. Third Party Tools and Plug-ins (6)Contains additional buttons that apply to specific third party products, such as DOORS, and/or plug-ins.

User Manual

25

Main Window

Button

Description Creates a new project. Opens an existing project. Saves the modified files of the project. Opens the configuration editor. Opens the types editor. Opens the snapshots editor. Opens the Options dialog box. Displays the previous view. Displays the next view. Displays or hides requirements. Displays or hides derived requirements. Displays or hides undefined requirements. Displays or hides uncovered requirements. Displays or hides entities. Displays or hides non covering entities. Displays or hides attributes. Displays or hides links. Displays or hides empty sections (sections not containing any traceability information). Displays or hides information added from Reqtify. Selects a filter. Opens the filter editor.

26

Reqtify

Status Bar

Status Bar
The status bar displays common information in the application, such as descriptions of the menus or status while performing analysis.

Project Workspace
The project workspace is the main area of the application. This area displays the project information and analysis for the loaded project. The project workspace contains multiple view tabs for displaying the contents of the project. Each view may contain one or more panes. The project workspace contains the following views:

Management ViewDisplays the project documents, the elements of each document, and a summary of coverage information for the project. Coverage Analysis ViewDisplays for a selected element of a document, one level of covering elements, N-1, and one level of covered elements, N+1, from other documents as defined by the project. Impact Analysis ViewDisplays for a selected element of a document, all levels of covering elements, N-m, and all levels of covered elements, N+p, from other documents as defined by the project. Graphical ViewDisplays each document graphically using a tree view with lines connecting requirement elements in documents and covering elements in other documents. Requirement DetailsDisplays each requirement and its attributes for a document in a table. Link DetailsDisplays covering information between a covering document and its covered documents.

Management View
Description
To activate the Management View, click the Management View tab in the project workspace of the main window.

User Manual

27

Main Window

The Management View contains four panes:

The Overall Quality area displays the analysis results according to requirements. A status bar shows the ratios of errors and warnings in relation to the total requirements number. The red fragment represents the errors. The orange fragment represents the warnings. The green fragment represents the ratio without trouble. For each fragment, the number of requirements is displayed in white. This analysis is presented for the complete project then for each specific analysis category. Categories are assigned from the Project Editor and a status bar is added for each category in the Overall Quality area. See the section on Assigning category to understand the categories behavior. This area also summaries general information on the project such as the project saving format, the number of documents, the requirements, etc.

The Project Overview area displays the covering analysis results by showing the project documents representation and their coverage ratio. Depending on the coverage ratios, links are displayed in green, orange or red: from 0% to 70% links are red displayed from 70% to 90% links are orange displayed exactly 100% links are green displayed

See the section concerning Coverage Ratio calculations for more details.

The Rule Check pane displays the list of violated rules, if any, and for each rule the list of elements violating the rule. The selection of an element in these lists selects the same element in the Coverage Analysis View. The Information pane displays some additional details and messages concerning the element selected in the Project Overview.

28

Reqtify

Coverage Analysis View

Contextual Menu
A contextual menu appears when you select a document in the Project Overview area and right click. This menu shows the Navigate item: Menu Navigate Comments Navigates to the source file corresponding to the selected document in the third party tool.

Coverage Analysis View

Description
To activate the Coverage Analysis View, click the Coverage Analysis View tab in the project workspace of the main window. The Coverage Analysis View allows you to select elements from a project document and displays requirement coverage one level upstream and one level downstream from the selected document.

User Manual

29

Main Window

The columns in the upper half of the view contain the following three view panes:

Upstream Coverage InformationDisplays one level of covered requirements, N-1, for a selected document element in the Selection column. SelectionDisplays the contents of the documents in the project. Downstream Coverage InformationDisplays one level of covering requirement reference elements, N+1, for a selected document element in the Selection column.

The lower half of the Coverage Analysis View contains three tabs. Each tab is divided into three columns that display details about the selected element in the tree view pane in the upper half of the view. The three tabs are:

Texts and References AttributesDisplays the text for the selected item and any reference attributes. These references link the selection in the Selection column to the corresponding element in the Upstream Coverage Information or Downstream Coverage Information column. AttributesDisplays the attributes for the selected item. MessagesDisplays helpful information, including rule violation details, for the selected item in the Selection column.

Note

The attributes are always displayed in these lists, regardless of the status of the button to hide or display "Attributes in the Toolbar.

30

Reqtify

Coverage Analysis View

Contextual Menu
A contextual menu appears when you right click an element or the project workspace background in the main window. The contextual menu depends on the activated view and on the selected element. These items are available in the Coverage Analysis View: Menu Copy Copy For Comments Copies the identifier of the selected requirement to the clipboard or copies the attribute values. Copies the selected element, with options (submenu): ID only or with additional information defined in the type. This feature allows direct creation of traceability information in project documents Deletes the selected attribute. You can only delete an attribute added from Reqtify. Opens a window to define a search string, with options Used to find an element selected in a Rule check section in the project tree. It is also used to navigate between linked elements (with relations through Links and not References) Marks are used to highlight manually or automatically elements that have specific properties. Marks can be added automatically for modified elements and for the results of a Search action. See the sections on Marks to learn more. Navigate Runs the third party tool and selects the element in this tool. The accuracy of the selection can depend on the third party tool interface. The selected document is no longer displayed. To display it again, use the Show selected documents item. Displays a dialog box with the list of the hidden elements, allowing the selection of documents to be shown again. Allows the addition of an attribute for the selected element. Opens two submenu items: Add a valuable attribute and Add a Boolean attribute. See the section on the addition of elements to learn more.

Delete Find Find in the Tree

Marks

Hide Selected Documents Show Hidden Documents Add an attribute

User Manual

31

Main Window

Menu Edit Text or Add Text

Comments Allows the edition of text added to the selected element. See the section on the addition of elements to learn more. Reloads the selected document on order to update analysis results. Opens the OTScript Evaluator

Reload Evaluate

Context menus are also available in the lower half of the Coverage Analysis view. In the Text and References Attributes pane, the following context menu is available if you click in the Reference Attributes area and if an element is selected either in the Upstream Coverage Information or Downstream Coverage Information column: Menu Add a reference attribute Comments Adds a Reference attribute to the coverage link between the element selected in the Selection column and the one selected in the Coverage column. Opens two submenu items: Define a Boolean reference attribute and Define a value reference attribute. See the section on the addition of elements to learn more. Delete selected attributes Deletes the selected reference attribute. You can only delete a reference attribute added from Reqtify.

In the Attributes pane, the following context menu is available if you click on the Attributes area and if an element is selected in the Selection column: Menu Add an attribute Comments Adds an attribute to the element selected in the Selection column. Opens two submenu items: Define a Boolean attribute and Define a value attribute. See the section on the addition of elements to learn more. Delete Delete the selected attribute. You can only delete an attribute added from Reqtify.

32

Reqtify

Impact Analysis View

Impact Analysis View

Description
To activate the Impact Analysis View, click the Impact Analysis View tab in the project workspace of the main window. The Impact Analysis view displays for a selected element of a document, for all levels of covering elements, N-m, and for all levels of covered elements, N+p, from other documents as defined by the project. The columns in the upper half of the view contain the following three view panes:

Upstream Impact InformationDisplays all levels of covered requirements, N-m, for a selected document element in the Selection column. SelectionDisplays the contents of the documents in the project. Downstream Impact InformationDisplays all levels of covering requirement reference elements, N+p, for a selected document element in the Selection column.

The lower half of the Impact Analysis View contains three tabs. Each tab is divided into three columns that display details about the selected element in the tree view pane in the upper half of the view. The three tabs are as follows:

Texts and References AttributesDisplays the text for the selected item and any reference attributes for references linking the selection in the Selection column to the corresponding element in the Upstream Impact Information or Downstream Impact Information column. AttributesDisplays the attributes for the selected item.

User Manual

33

Main Window

MessagesDisplays helpful information, including rule violation details, for the selected item in the Selection column.

Contextual Menu
A contextual menu appears when you right click an element or the project workspace background in the main window. The contextual menu depends on the activated view and on the selected element. These items are available in the Impact Analysis View: Menu Copy Copy For Comments Copies the identifier of the selected requirement to the clipboard or copies the attribute values. Copies the selected element, with options (submenu): ID only or with additional information defined in the type. This feature allows direct creation of traceability information in project documents. See the adding information section for more information. Deletes the selected attribute. You can only delete an attribute added from Reqtify. Opens a window to define a search string, with options Used to find an element selected in a Rule check section in the project tree. It is also used to navigate between linked elements (with relations through Links and not References) Marks are used to highlight manually or automatically elements that have specific properties. Marks can be added automatically for modified elements and for results of a Search action. See the section on Marks to learn more. Navigate Runs the third party tool and selects the element in this tool. The accuracy of the selection can depend on the third party tool interface. The selected document is no longer displayed. To display it again, use the Show hidden documents item. Displays a dialog box with the list of the hidden elements, allowing the selection of documents to be shown again.

Delete Find Find in the Tree

Marks

Hide Selected Documents Show Hidden Documents

34

Reqtify

Impact Analysis View

Menu Add an Attribute

Comments Allows the addition of an attribute for the selected element. Opens two submenu items: Add a valuable attribute and Add a Boolean attribute. See the section on the addition of elements to learn more.

Edit Text (or Add Text) Evaluate Reload

Allows the edition of text added to the selected element. See the sections on the addition of elements to learn more. Opens the OTScript Evaluator Reloads the selected document in order to update analysis results.

Context menus are also available in the lower half of the Impact Analysis view. In the Text and References Attributes pane, the following context menu is available if you click in the Reference Attributes area and if an element is selected either in the Upstream Coverage Information or Downstream Coverage Information column: Menu Add a reference attribute Comments Adds a Reference attribute to the coverage link between the element selected in the Selection column and the one selected in the Coverage column. Opens two submenu items: Define a Boolean reference attribute and Define a value reference attribute. See the section on the addition of elements to learn more. Delete selected attributes Deletes the selected reference attribute. You can only delete a reference attribute added from Reqtify.

In the Attributes pane, the following context menu is available if you click on the Attributes area and if an element is selected in the Selection column: Menu Add an Attribute Comments Adds an attribute to the element selected in the Selection column. Opens two submenu items: Define a Boolean attribute and Define a value attribute. See the section on the addition of elements to learn more. Delete Delete the selected attribute. You can only delete an attribute added from Reqtify.

User Manual

35

Main Window

Graphical View
Description
The Graphical View displays each document as an object with its traceability elements displayed in a tree view within the object. You can move documents, adjust the width of the documents, zoom, and resize the containing page. Lines represent covering references between requirement elements of a document and elements in another document. Dotted lines represent links that are not coverage links. The color codes for the Coverage Links (references) displayed in the Graphical View are: Link Color (Black) (Red) (Green) (Blue) Description Standard link Traceability violation Link created from Reqtify Link with a reference attribute attached

Flying over a link, the following information is displayed: Reference to '<requirement>' Type: <reference_type_name> in a balloon.

The lower half of the Graphical View contains three panes:

Attributes (or Reference Attributes if a reference is selected)Displays the attributes attached to the item selected in the graphical view. TextDisplays the text for the item selected item in the graphical view. MessagesDisplays helpful information, including rule violation details, for the item selected in the graphical view.

36

Reqtify

Graphical View

The Graphical view can display the full traceability graph. When you select an element, the view highlights the selected element, the covering elements and the lines between the elements, as shown below.

Click the header of a document. When you make this selection the entire document is selected.

The graphical view can also display a partial graph by focusing on some documents elements or by hiding some documents.

Focusing on a sub-graph
Select an element in a document and right-click on the view to select View Graph for Selection from the context menu, the view will only display the highlighted elements from the three documents, as shown in the following figure.

User Manual

37

Main Window

Right-click on the view and select Show All Elements from the context menu to show all the elements of the documents again.

Hiding documents of a graph

Right-click the document and select Hide Selected Documents from the context menu. When you make this selection, the view hides the selected document and displays the traceability information for the remaining two documents. Right-click on the view and select Show Hidden Documents in the context menu to access a dialog box selected documents to be visible again.

Managing the documents in the graphical view

As your document gets larger or more complex, you can perform the following actions to control the Graphical View:

Move documents within the Graphical View by selecting the document header and dragging the header to a new location. Resize the width of a document by selecting the document header and dragging the resize handles that appear on the right side of the document. Expand and collapse the sections by clicking the plus sign. You can also rightclick the header of a document and select Collapse Root Sections or Expand All Sections from the context menu.

Zoom in and out by pressing <Ctrl> while scrolling your mouse wheel up or down, or by selecting either Zoom100% or Fit in page from the context menu.

Context Menus
A context menu appears when you right click an element or the project workspace background in the main window. The context menu depends on the activated view and on the selected element.

38

Reqtify

Graphical View

These menus and items are available in the Graphical View: Menu Copy Copy For Comments Copies the identifier of the selected requirement to the clipboard or copies the attribute values. Copies the selected element, with options (submenu): ID only or with additional information defined in the type. This feature allows direct creation of traceability information in project documents. Deletes the selected attribute. You can only delete an attribute added from Reqtify Marks are used to highlight manually or automatically elements that have specific properties. Marks can be added automatically for modified elements and for results of a Search action. See the section on Marks to learn more. Navigate Runs the third party tool and selects the element in this tool. The accuracy of the selection can depend on the third party tool interface. Opens the OTScript Evaluator If this option is checked when some documents are hidden, the documents that are still visible are automatically repositioned. If this option is unchecked, when some documents are hidden, the still visible documents stay at their position. View Graph for Selection Show all Elements Hide Selected Documents Show Hidden Documents Collapse root sections Displays the sub-graph for the selected elements, including the covering elements and the lines between the elements. Displays all the elements previously hidden thanks to View Graph for Selection option. The selected document is no longer displayed. To display it again, use the Show Hidden Documents or Show all elements item. Displays a dialog box with the list of the hidden elements, allowing the selection of documents to be shown again. Minimizes the selected document by only displaying the sections of this document.

Delete Marks

Evaluate Automatically Position Documents

User Manual

39

Main Window

Menu Expand all sections

Comments Expands the selected document, which has previously been minimized, thanks to the Collapse root sections option. Select Zoom>100% or Fit in page to zoom in and out. You can also press <Ctrl> while scrolling your mouse wheel up or down. Allows you to create covering links between several elements. See the section on the addition of elements to learn more. Allows you to create links (other than covering links). If several links to create have the same name, the document's name is shown between parentheses. See the section on the addition of elements to learn more. Changes the direction of a link created from Reqtify

Zoom

Create Covering Links

Create Links

Reverse Links

In the Attributes pane, the following context menu is available when an element is selected in the Graphical view: Menu Add an attribute Comments Adds an attribute to the element selected in the Graphical view. Opens two submenu items: Define a Boolean attribute and Define a Value attribute. See the section on the addition of elements to learn more. Delete Deletes the selected attribute. You can only delete an attribute added from Reqtify.

In the Reference Attributes pane available when a reference is selected in the Graphical view, the following context menu is available: Menu Add a reference attribute Comments Adds an attribute to the reference selected in the Graphical view. Opens two submenu items: Define a Boolean Reference Attribute and Define a Value Reference Attribute. See the section on the addition of elements to learn more.

40

Reqtify

Requirement Details View

Menu Delete selected attributes

Comments Deletes the selected attribute. You can only delete an attribute added from Reqtify.

Requirement Details View

Description
The Requirement Details view displays each requirement and its attributes for a document in a table. The document displayed is selected from the drop-down list box in the upper left. For this document, all the requirements, derived requirements, macro-requirements and entities are presented in the first column. The other column headers are the attributes and the cells contain values of these attributes.

The lower half of the Requirement Details view contains two panes:

TextDisplays the text for the item selected in the first column. MessagesDisplays helpful information, including rule violation details, for the item selected in the first column.

User Manual

41

Main Window

You can sort the elements:

Click one of the requirements in the first column and select Sort by Identifier in the context menu. Click the header of an attribute column to sort elements using the value of the selected attribute.

Contextual Menus
If you right click the header of an attribute created from Reqtify, you get the following context menu: Menu Rename Delete Comments Opens a dialog box allowing you to rename the selected attribute. Deletes the selected attribute. You can only delete an attribute added from Reqtify.

If you right click a cell corresponding to an attribute created from Reqtify, you get the following context menu: Menu Copy Paste Delete Comments Copies the value of the attribute. Pastes the copied value. Deletes the selected value.

If you right click a cell corresponding to a requirement element in the requirements column, you get the following context menu: Menu Sort by identifier Sort by default Copy requirement ID Navigate Comments Sort alphabetically the requirements column list. Sort requirements according to their definition order in the document. Copies the requirement ID into the clipboard. Navigate to the selected requirement in the corresponding document.

42

Reqtify

Link Details View

Link Details View

Description
The Link Details pane displays covering information between a covering document and its covered documents. It also enables you to create suspicious links. See Suspicious links section. This view enables you to easily create links. A covering link creation or a reference attribute assignment can be performed when the following conditions are met:

the covering document has a modification file with a type for added elements associated this modification file has one or more references type defined

Refer to the Customization Guide for more information about the added type creation. The Link Details view is shown in the following figure:

The covering document area of the Link Details view corresponds to the covering document. It contains the following areas:

Document (1)Allows the selection of the covering document. Document content view (2)Displays the content of the covering document with its elements. Link type (3)Shows the reference types defined in the added types of modification for the selected document in a combo-box. Attributes (4)Shows all the attributes of the selected element. Messages (5)Displays the message associated to the selected element.

User Manual

43

Main Window

History (6)Displays the links creation and the links removal history for the selected element. Text (7)Displays the text of the selected element.

The covered documents area of the Link Details view corresponds to the covered documents. It contains the following areas:

Requirements (1)Displays the requirements of the covered documents and their hierarchy. Covering links are marked by a check or a green square. Filter (2)Allows you to filter the requirements of the covered documents to only visualize some of them. This field is case-sensitive and supports regular expressions. See next section for filters details. Attributes (3)Displays the attributes of the selected requirement. Reference Attributes (4)When it is possible, allows you to assign values to reference attributes defined in the added type of modification. There are listed in a multi-lines box. To learn more see the reference attribute definition. Messages (5)Displays the message relative to a reference, its contents will be displayed only if the selected requirement has a checkmark. Information (6)Displays the links creation and the value assignments to reference attributes history for the selected requirement. Text (7)Displays the text of the selected requirement.

Filter field usage

Requirements of the covered documents can be filtered out in the Requirements area to make it easy to visualize. Type few characters of the requirements, for instance REQ1, to create a simple filter. All requirements containing the string REQ1 are now listed in the Requirements area. Regular expressions can be used to create more complex filters. Type for instance ^PS_.*2$. All requirements beginning by PS_ and ending by 2 are now listed in the Requirements area. Because this field is case-sensitive, use for instance (?i) to start your filter avoiding the case-sensitive mode.

44

Reqtify

Link Details View

Coverage Display
When you select a covering document the whole view is updated with corresponding information.

If the selected element covers high-level requirements with the selected link type, a check is placed next to the covered requirements. If the selected element covers high-level requirements with another link type, a green square is placed next to the covered requirements. If we fly over the green square information concerning the reference type is displayed.

For more information on the covering links creation, see the chapter concerning addition of information.

Commenting Link Creation and Deletion

If the option Comment cover link creation and deletion in Link Details view is checked in the General Options window, you can insert a comment when you click to create a cover link. This comment is added in the History and Information areas.

User Manual

45

Main Window

By the same way, when you click to delete a cover link, you can add a comment.

This comment becomes visible in the History area.

Menus
Contextual menus and Edit menu contain the following options: Menu Display only requirements Sort requirements Comments This option the ability to show only the requirements or to show requirements with hierarchy. When the option Display only requirements is activated, this option allows the alphabetically sort of requirements display. When the option Display only requirements is deactivated, this option displays only the covered requirements by the requirement selected in the covering document area.

Show the covered requirements

46

Reqtify

Link Details View

Menu Navigate

Comments Runs the third party tool and selects the element in this tool. The accuracy of the selection can depend on the third party tool interface. Creates a link if it is possible. Deletes a link if it is possible.

Add link Delete link

User Manual

47

Configuration Dialog Box

This chapter introduces the configuration dialog box for the topics concerning the operational use in project contexts. The topics concerning customization are described in the Customization Guide. You can read about these topics in:

Overview Restricted Access to the Configuration Dialog Box Management of Concurrent Access

Overview
Reqtify launches the Configuration dialog box when you select a menu item or toolbar button to configure one of the following parts of your project: Project, Types, Snapshots, Filters, Reports, Expressions, XML or Options.

User Manual

49

Configuration Dialog Box

The Configuration dialog box contains the following panes:

ProjectAllows you to configure the project by specifying the documents to include, the type of each document, and the covering relationship between documents. Refer to the Project Configuration chapter later in this User Manual for more information about configuring projects. TypesAllows you to create new types or customize existing types for your project. Refer to the Customization Guide for more information about customizing types. SnapshotsAllows you to create, manage and compare snapshots of your project. Refer to the Detection of Requirement Changes chapter in this User Manual for more information about using snapshots. FiltersAllows you to define custom filters to analyze requirements and only display requirements from documents that meet specific criteria. You can enable filters using the Filter drop-down list box on the toolbar of the Reqtify main window. Refer to the Filters Usage and advanced Analysis section of this User Manual for more information about using filters. ReportsAllows you to define new custom reports. You can generate a default report or a custom report using the Reports > Library Reports submenu on the main window. Refer to the Generating Reports chapter in this User Manual for more information about generating documents. ExpressionsAllows you to test regular expressions used by Types to analyze the intermediate files. Refer to the Customization Guide for more information about customizing types. XMLAllows you to test XML syntaxes used by Types to analyze the intermediate files. Refer to the Customization Guide for more information about customizing types. OptionsAllows you to set the default font for text in the application, set the password on the project, define environment variables, and other miscellaneous settings for the application.

Restricted Access to the Configuration Dialog Box

The access to the Configuration Dialog Box can be restricted. Select Tools > Options to open the Configuration Dialog Box. In the Project pane you can enter a password:

50

Reqtify

Management of Concurrent Access

Once a password is defined for the project, you will see the dialog box shown in the following figure each time you try to open the Configuration dialog box:

Access to the Configuration dialog box is granted only if the Password is correct. To change the password, select Tools > Options, enter the correct password to open the Configuration Dialog Box, and then type a new password in the Password field of the Project pane.

Management of Concurrent Access

Concurrent modification of the project is not allowed.

Control Access on Reqtify Activities

While one user can modify some elements of a project, another user can modify different elements of the same project. The control access on a project is handled separately according to different activities. Activities which can be handled separately are:

Project Configuration Edition Types of Analysis Customization Filters Edition Marks Creation Modification Files Edition

User Manual

51

Configuration Dialog Box

User Changes Management

When you want to add information from Reqtify, you must have the appropriate access rights:

The first user who attempts to modify the project becomes the owner of the files in which he is making changes. Once he modifies a Reqtify element, the appropriate file becomes locked. If another user has already locked the same file before, a dialog box like the following opens:

As long as a file is locked, the owner can undo or redo modifications. Once he terminates his modifications, he presses to save them. The files associated with his modifications become unlocked again and undo and redo actions are no longer accessible.

52

Reqtify

Project Configuration

This chapter explains how you can configure your project in order to describe to Reqtify what your project lifecycle and your requirement standards are. You can read about these topics in:

Objectives Description Adding a Document Adding Coverage Links between Documents Adding a Folder Folders and Coverage Links Documents Covered by Combination of several Others Modification Documents Importing an Existing Project Assigning a Category

Objectives
A project specifies the documents that Reqtify analyzes and displays, as well as the type of each document. A type defines how to select external files that represent a document, how to read the contents of the external files, how to interpret the contents as elements for managing requirements, and how to display the elements of the document.

User Manual

53

Project Configuration

A project also defines the relationship between these documents.

Description
The configuration window is composed of several areas such as the document details area and some creation buttons.

Document Details Area

If Details or Modification Files pane is selected, the lower part of the Project editor window contains the following fields: Field Name Description Used to name a document. It is a logical name that does depend on the name of the input element (file, directory, database module, etc.) This drop-down list box displays the list of generic and customized types that can be used to analyze the document.

Type of Analysis

54

Reqtify

Description

Field File or Directory

Description Click on the button to activate the browse, and click this button to select your source information. The dialog box that will be used for selection depends on the type selected for the document. Once the selection procedure is completed, the field is filled automatically. When this option is activated, Reqtify will ignore structure errors in the analyzed documents (for example, a heading 3 section underneath a heading 1 section without any intermediate heading 2 section). When this option is activated, the intermediate file corresponding to the analysis of the source document is stored in directory named intermediate in the project directory. For some types, the default option is set by Reqtify and cannot be modified. This option is helpful for the different types of customization activities. See the Customization Guide to learn more about the intermediate files.

Ignore structure

Intermediate File

Block reloading Variable

When this option is activated, Reqtify will avoid the reloading of the corresponding document. This drop-down list box is filled automatically by Reqtify and depends on the Type applied to the document. It is used in relation with the Value field to define additional parameters for the Type. Variables and expected Values are described in the Coupling Notes for the interfaced third party tool.

Value

See the explanation above for Variables. The Value field is used to define Variable values. Depending on the selected variable, this element can be a drop-down list box, a text field, or an option box. This field is used to define the access mode to the input file. Access can be local, HTTP, need dialog with a Configuration Management tool, a Document Management tool, etc. Right click on the Access field provides access to 'Intermediate access file' option that enables you to access a directory outside the project directory for the Access types. For instance the SVN working directory can be located out off the Reqtify project directory.

Access

User Manual

55

Project Configuration

If Covers pane is selected, the lower part of the Project editor window contains the following fields: Field Sources->Target Kind Description All the connections between documents are listed as source document followed by target document. Two kinds of covering link are available: cover and dependency. Cover is the default value for Kind. The Kind drop-down list enables the change of Cover links by Dependency links. Dependency is depicted as . Covers contribute to the coverage ratio, dependencies do not. Name A name can be associated to a Cover or Dependency link. This name is displayed next to the link in the Project view. .

Creating Tools
The following action buttons are available: Button Description Used to add a folder. See the Using Folders chapter later in this document to learn more about the usage of folders. Used to insert a new document for the project. Used to add a Modification document. Used to insert a project. Refer to Composite Project Management Manual. This button is only available if the Composite Project plugin has been installed. Used to create coverage link between two documents. Deletes the selected element (document, link or folder). Used to collapse (hide) / expand (show) the Documents Detail Area to maximize the size of the Traceability Description Area.

56

Reqtify

Adding a Document

Edit Menu
The configuration editor allows you to undo operations, and redo the previous operation. The edit fields for undo and redo are contained in the Edit menu:

UndoCancels actions on element editions or creations. RedoReverses the undo field.

Adding a Document
To insert a new document into the Traceability Description Area, follow these steps:

Click the Add a document button. When you make this selection, the cursor automatically moves to the Traceability Description Area and the cursor outlines a document object. Click within this area to place the document. When you place the document, the document is added to the Project Tree pane. The Document Details pane displays the settings for the selected document in the Project Tree pane. In the document Details pane, click in the Name column to rename the document. The name in the document object now displays the new name. Click on the Type of Analysis column. Select from the drop-down list box the Type you want to apply. Click on the File or Directory column. The File Browse button appears on the right side of the field. Click the File Browse button and select the input information you want to consider. The selection procedure depends on the selected type of analysis (file, directory, database based type of analysis), and on the Access defined for the document (local, HTTP, configuration management tool, etc.) Check if Variables have to be defined. Variables are described in the Coupling Notes for the tool on which type of analysis is based (Word, Excel, etc.) If you need to define variables, define Values for each of them.

2 3 4

5 6

Adding Coverage Links between Documents

You define your traceability links directly in the Traceability Description Area, which is the graphical part of the project editor. To add a coverage link between documents, follow these steps.

1 2

Click the Add a cover Description Area.

button. The cursor moves to the Traceability

Click the covering (low level) document object first and then click the covered (higher level) document object. An arrow appears between the two documents.

User Manual

57

Project Configuration

This arrow indicates that the low level document covers the high level document. You can also click the covering document by keeping the mouse button pressed and hovering over the covered document and then releasing your mouse button. This creates a link. For instance, your traceability graph could be created as shown in the following figure.

Note The link arrow means "Covers". Links between documents are in two parts: by clicking and dragging on the circle you can alter the angle of the link. This is useful if there are several documents to be configured. You can select multiple documents in this graphical area, or in the project tree, by keeping [Ctrl] pressed during multiple click actions. You can also draw a selection area by clicking and dragging the mouse button. The following context menu appears if you right click in the Traceability description area: Item Copy Description Copies the selected document. The copied document can be pasted into the current project, or into another project along with its type and an updated path to the file to be analyzed. Pastes the copied document. You can Paste documents copied from the Project Editor for the current project or for another project. Deletes the document or link selected. Activated only if you select a link. Re-draws the selected link. Navigates to the source file corresponding to the selected document.

Paste

Delete Cleanup Link Navigate

Note By pressing <Ctrl> while scrolling your mouse wheel up or down you will zoom in and out in the Traceability Description Area of the Project Configuration View.

58

Reqtify

Adding a Folder

Adding a Folder
Folders can be used to group documents considered at a given step in your process, and/or in order to have a cleaner project configuration displayed for a large project. See the section about Using Folders to learn more about traceability management when a project contains folders. Concerning folders, note the following point:

Only one hierarchical level is allowed. You cannot create a folder inside a folder.

To add a folder in your project configuration, follow these steps:

Click the Add a folder button. When you make this selection, the cursor automatically moves to the Traceability Description Area and the cursor outlines a folder object. Click within this area to place the folder. You can resize it. When you place the folder, the folder is added to the Project Tree pane. The Details pane displays the settings for the selected folders in the Project Tree pane. In the Details pane, click on the Name column to rename the folder. The name in the folder object now displays the new name.

To navigate into the folder, double click the folder. To go out of the folder, double click on the background of the Traceability Description Area.

User Manual

59

Project Configuration

To add a document in the folder, you can either:

1 2

Open the folder and create your document as described in the previous sections. Select a document already created in the traceability description area, then drag and drop the document into the folder object.

Folders and Coverage Links

To add a coverage link between folders, or between a document and a folder, follow these steps.

1 2

Click the Add a cover Description Area.

button. The cursor moves to the Traceability

Click the covering (low level) document or folder object first and then click the covered (higher level) document or folder object. An arrow appears between the two objects. You can also click the covering document or folder by keeping the mouse button pressed and hovering over the covered document or folder and then releasing your mouse button. This creates a link.

You may need to create more precise links between a document out of the folder and a specific document located in the folder. For this you will use the folder Ports such as .

1 2

Create a traceability graph with links between a folder and document(s), or between folders containing document(s). Double click to enter the folder. As shown in the following figure, the Traceability Description Area now contains some Ports, one for each document linked to the folder. Hover over the port to display the name of the document represented by the port. To link a document contained in a folder directly with an external document, create a link between the document and the port using the Add a Cover button to create of a link between documents. The created link has no arrow; the direction is defined by the arrow icon of the port.

60

Reqtify

Document Covered by Combination of Several Others

Note Individual links between documents through folder ports is not the typical use of folders, and has consequences on the traceability management. See the section concerning Using Folders to learn more about traceability management in cases involving folders and documents.

The table below gives you additional information about Ports: Ports Description This port represents a document available for a traceability link TO this document: the document in the folder is covering the external document. To create a link, click on the document first, then on the port. This port represents a document available for a traceability link FROM this document: the document in the folder is covered by the external document. To create a link, click on the port first then on the document.

It is better to consider a folder as a package of requirements that belong to the same project hierarchy level. But in some cases it is useful to add coverage links inside a folder. Use the Add a cover option to create links between internal documents.

Document Covered by Combination of Several Others

In a lot of cases, a high level document is not fully covered by only one lower level document, but by the combination of several documents. This is typically the case when you consider a system specification that will be refined into two sub-systems specifications. The sub-systems specifications together are supposed to cover the system specifications. In that case each high-level requirement is supposed to be covered by at least one of the lower level documents. Two configurations are also possible, as shown below.

User Manual

61

Project Configuration

In this configuration Reqtify expects the Specifications requirements to be implemented AND tested. The requirement will be considered as uncovered until at least one reference is found in the Design Document AND in the Test Plan as well.

In this configuration Reqtify expects the Specifications requirements to be developed in the Software specifications OR in the Hardware specifications (or in both). The requirement will be considered as covered as soon as there is a reference found in the Software Document OR in the Hardware document (or in both).

To create a combined link, follow these steps:

First create the documents. As shown in the Figure above, a Specifications document can be covered by the combination of a Software document and a Hardware document. Next create a link between the Software document (covering) and the Specifications document (covered). Click the Add a cover button, then click the second covering document (in our example the Hardware document). Instead of clicking the covered document object, click the circle in the middle of the coverage link that already groups the other two documents together.

2 3 4
Note

To delete a combined link, click one of the two halves of a link then click the Delete button.

62

Reqtify

Modification Documents

Modification Documents
The Modification Documents are used to capture additional information that applies at the same level as a standard Document and to complete or modify it.

Modification Documents are typically used in the following cases:

The version 1 of a document can be modified, completed, and reviewed during the project. Before getting a version 2 of the document, the project teams usually need to consider the version 1. They also need to consider additional review forms or modification sheets which contain information that completes, modifies or replaces the information contained in the original document. These additional elements can be managed as Modification Documents applied to the original document that was defined in the Project configuration. A Specifications document can contain generic requirements. Some additional documents (typically worksheets) can create additional information to make generic requirements specific for the project. Additional worksheets can add attributes for allocation, priority, etc. and they are also managed as Modification Documents. A Test plan contains the test definitions. These tests are performed and a test report is automatically generated by the verification tool. Instead of manually copying the test results into the Test Plan to produce a Test Report document, you can capture the results automatically by defining a Modification Document.

To add a modification document, follow these steps:

1 2 3 4 5 6

Select a document object in the Traceability description area of the project editor. Click the Modification Files tab of the document details pane. Click the Add a Modification Document button.

In the Document Details pane, click in the Name column to rename the document. The name in the document object now displays the new name. Click in the Type of Analysis column. Select from the drop-down list box the Type you want to apply. Click in the File or Directory column. The File Browse button appears on the right side of the field. Click the File Browse button and select the input information you want to consider. The selection procedure depends on the selected type of analysis (file, directory, database based type of analysis), and on the Access defined for the document (local, HTTP, configuration management tool, etc.). Check if Variables have to be defined. Variables are described in the Coupling Notes for the tool on which is based the type of analysis (Word, Excel, etc.). If you need to define variables, define Values for each of them.

7 8

User Manual

63

Project Configuration

When a document has modification files, an additional icon representing a yellow book is added to the icon of the modified document, in the Project editor, as shown in the following figure. The modification document appears underneath the document it modifies in the project tree pane.

The Accumulate information option indicates to Reqtify if the information captured in the Modification Document completes or replaces the information captured in the project document. Note Modification files do not remove elements coming from other modification files. The position of the modification files in the list is important. The analysis is performed in list order. Information contained in a file overwrites information contained in a file higher up the list if the box Accumulate information box is not checked. Otherwise information accumulates in list order.

64

Reqtify

Importing an Existing Project

In the main window of Reqtify, the yellow icon indicating the modification of the project document is displayed as well, as shown in the following figure. The Messages tab in the lower half of the window gives you more information concerning the modification file.

The Modification Documents are also used when you want to add information created from Reqtify:

Default additions create an internal type that you cannot edit or manipulate. Advanced additions are based on the integration of modification documents using a Type for added elements.

See the Adding information section to learn more. Additional information can be defined in a special modification file which is specified by the Type for Added Elements. (see the Customization Guide).

Importing an Existing Project

An existing project, or part of it, can be imported into your current project.

If you want to import the whole project, select File > Import and select the Reqtify project file you want to import. If you want to import only some documents of an existing project, open this project. In the Project Editor, select the documents you want to import, right click and select Copy in the context menu. Open your current project. In the project editor, right click in the traceability description area and select Paste in the context menu.

In both cases, the imported documents are added to the project configuration. The types of these documents are also imported if they do not already exist in the current project. The input files to be analyzed are not moved; the paths to these files are automatically updated in the File or Directory field of the Document Details Area.

User Manual

65

Project Configuration

Assigning Categories
A category type can be assigned to a document or to a folder from the Project Editor. This information appears in the Management View to present a detailed analysis of documents. To assign a category to a document or to a folder, follow these steps:

1 2

Select a document in the Project Editor. In the document Details area, a Category field, which is not a parameter of the document type, can be selected from the drop-down list of Variable. Select Category. Click Value to know the category values. The available category list appears in the drop-down list. Choose the desired value.

See the Categories creation section from the Customization Guide to know how to create or modify categories. The principles of the categories association are the following:

Associating a category to a document: once a category has been selected for a document, this category is associated to the document. some categories can be associated by default according to the types folder of the document type. For example, if a document has a type of the uml folder associated, the design category is automatically associated to this document.

In this case, the category can be overloaded but not removed. See the Categories creation section in the Customization Guide to know how to set or unset this behavior.

Associating a category to a folder:

66

Reqtify

Assigning Categories

if the documents inside this folder do not have any associated category or have a default associated category (types folder association), the category associated to the folder is propagated to these documents. if the documents inside this folder have already an associated category, they keep their category.

Dissociating a category: a category association to a document can be removed if the association is not a default association. In order to, select the blank value in the Value field. The document will have no more associated category. a category association to a folder can be removed by selecting the blank value for the Value field. Consequently, this category association is also removed for all documents inside this folder and having this category. If the documents had a category associated by default, they recover this category again. Other documents, which had a category different from the folder category, keep their category.

User Manual

67

Project Options

This chapter introduces the options you can define for your project. The Options dialog box allows you to configure some options for your project. It contains three panes.

You can read about these topics in:

Overview of the General Option pane Overview of the Environment Option pane Overview of the Project Option pane Overview of the Connections Option pane

User Manual

69

Project Options

Overview of the General Option pane

This window contains the general following fields: Field Font Description Changes the font of the trees displayed in the project workspace. This option does not change the fonts of the menus, menu items and pane names. When this option is activated, Reqtify displays the name of the document beside each element in the Upstream Impact Analysis and Downstream Impact Analysis panes of the Impact Analysis View When this option is activated, Reqtify displays the Application on top of all the other applications on your desktop. Defines the number of recent files listed in the File menu for direct opening. Some tools interfaced with Reqtify are database-based (i.e. DOORS), or more generally non file based, and it is not possible to automatically detect that information has changed. This option allows you to define a periodic update for these tools. This combo provides all the directory types. Selecting one type allows you to define the kind of directory type to create during a drag and drop of a directory from the outside into the Project configuration window. When this option is activated, Reqtify displays the reload dialog box. As a result a dedicated icon will inform you if a document is up to date or not. Enables you to produce a log file in the project directory Enables to launch supervisor when opening Windows session. Indicates to Reqtify that the reports must be opened automatically at the end of the generation process. Gives you the possibility to access a wizard to insert comments when creating and deleting cover links. Refer the Link Details chapter.

Display document name in impact mode

Application stay on top

Number of recent files in the File menu Update period (in hours) for non automatic updated document

Default type for directory drag and drop

Ask for reloadings

Enable debugging Launch supervisor when opening Windows session Open document after generation Comment cover link creation and deletion in Link Details view

70

Reqtify

Overview of the Environment Option pane

Overview of the Environment Option pane

The Environment pane looks like the following:

This window contains the following fields: Field Environment variables Description Environment variables can be necessary to give specific information concerning your tools and workbench environment. When they are necessary, these environment variables are described in the Coupling Note for the concerned tool. Name of selected environment variable Value of selected environment variable

Name Value

User Manual

71

Project Options

Overview of the Project Option pane

The Project pane presents the following project options:

This window contains the following fields: Field View log file Description Opens the file containing the list of actions performed by Reqtify. This file can help for your discussions with the Support Team. This field is used to define a password for access to the Configuration dialog box. See the chapter about restricted access to project configuration to learn more. This option indicates whether or not you want Reqtify to check if the dates of project files have changed since the previous analysis. You can have Reqtify performs the update automatically when you switch from an external application to the Reqtify main window. In some cases and network configurations such an analysis it can take some time, therefore you will have the opportunity to deactivate it if you want.

Password

Automatically check document dates

72

Reqtify

Overview of the Project Option pane

Field Compare project after loading Activate suspicious link management

Description Avoid comparing calculations between two loadings of a project. This is useful for big projects. Activates or not the suspicious links management for the current project.

Handling Rules
The Rules part allows you to choose the rules to be analyzed in the analysis process. The top of the Rules area lists Reqtify rules and users rules by categories Internal Rules, OTScript Rules and Project Rules. Project Rules contains rules from files located in the project directory. All Project Rules are editable. For each rule from the three categories, you can choose if you want a rule to be analyzed or not by checking this rule. If the selected rule is OTScript written, its content is displayed in the code area.

Corresponding analyzed rules appears following a color code in the Rule check in the project workspace of Reqtify.

A contextual menu is available on rules: Item Delete Select all Deselect all Description Delete the selected user rule. This option is only available on user rules. Select all rules of the rules area. Deselect all rules of the rules area.

User Manual

73

Project Options

An editing area is used to visualize rules code and to enter user own rules. When a new rule is validated, it is added to the rules list. New ruleThis button allows a new rule creation. It gives access to the rule typing area. Users rules are written in OTScript. New rules are saved in the rules.br file of the project. SaveThis button validates and accepts the new rule. The rule has been added in italics in the rules list.

Creating a rule
To create a new rule, follows these steps:

Click the New rule button. An input area is accessible filled out with a rule template:

Object class is the name of the class to insert the method within. Method name is the name of the rule. Alert degree corresponds to the alert level for a rule, it is described by a code, as follows: Alert degree code e1 e2 e3 e4 Type of rule error warning information information Displaying color of concerned elements red orange green no color

LABEL corresponds to displaying names of the rule. Here, English and French labels are requested, but only one label can be defined. It is also possible to add Japanese and Chinese labels translations.

Complete this syntax to define your rule. Type for instance:

Click the Save button to validate your rule. The rule is added checked and in italics in the rules list. This rule can be modified afterwards.

74

Reqtify

Overview of the Connections Option Pane

During the creation phase, errors can appear:

If the rule in creation contains syntax errors a dialog message appears. If a rule has already the same label and function name an error is raised. If only one of these names is the same the rule will be only modified.

Overview of the Connections Option Pane

This option enables you to define connection parameters. Indeed, creating a profile enables you to configure the servers you often connect to. For instance, the Connections pane looks like the following:

This window contains the following fields: Field Profiles Add new profile Delete selected profile Description A profiles area which lists created profiles according to tools to connect to. This button allows you to access the form to define a new profile. This option allows you to delete the selected profile.

User Manual

75

Managing the Analysis Results

This section explains how to understand and manage the analysis results displayed in the project workspace of Reqtify. When Reqtify analyzes your project information (documents, database modules, etc.) it provides you with:

A list of elements violating default rules and customized rules in the Rule check section. The first action to perform once results analyses are available in the project workspace is to analyze the reported errors. Coverage ratios. Navigation in the traceability graph. Filter capabilities, for more targeted display and results, and for oriented reports generation. Features allowing you to create additional information within the Reqtify environment, such as attributes, links, texts. Features allowing the transfer of items captured in a given tool into another interfaced tool. This is typically done to make requirements captured at a high level available in an authoring tool environment. Navigation features between Reqtify and interfaced tools.

This section focuses on analysis of the information captured by Reqtify. For detailed description of the views, menu items, toolbar and panes, see the sections concerning the Main window and the Configuration dialog box. You can also refer to the Getting Started document for a first overview of Reqtify's main capabilities. You can read about these topics in:

Rules Checking Using Views Displaying Requirement and Reference Types Displaying Reducing Filters Filter Usage and Advanced Analysis

User Manual

77

Managing the Analysis Results

Understanding the Coverage Ratios Folders Macro-Requirements

Rules Checking
When Reqtify analyzes the project artefacts, it checks the compliance of analysis results with rules defined in your configuration. The rules set is composed of the default rules installed with Reqtify, and the customized rules that can be created by trained users, the Support Team or our experts. Customized rules allow a more advanced and a more dedicated support of your requirements management process. The first step of your analysis process should be to review the rules activated in the Rule Check section of the Selection column in the project workspace. An effective way to navigate between the Rule Check section and the project analysis results is:

Expand the Rule Check tree and select an element violating the rule. Double click the element to navigate to the selected element in the project workspace, and analyze it. You can also navigate to the source document. Click the Back button on the toolbar to go back to the previous display, with the element selected in the Rule Check section. Select the following element to analyze it.

In addition to the Rule Check section, some icons are displayed on the right side of the Selection column for specific information. Icon Description Derived requirement Uncovered requirement Undefined requirement Non-covering entity

If you hover over one of these icons, additional information is displayed. The icons are brought up to the document level, giving you the information even if the document tree is collapsed. Click on the icon to quickly navigate to the first element concerned by the warning message.

78

Reqtify

Using Views

Using Views
Using the Management View
See the section describing the Management View to learn more about details and context menus. The Management View contains project information, the only possible change in this view is the refresh of the coverage ratio displaying for each document.

Using the Coverage Analysis View

See the section describing the Coverage Analysis View to learn more about details and context menus. This section describes the behavior of Upstream Coverage Information and Downstream Coverage Information according to the done actions on the Section tab.

When you click an element in the Selection column, the Downstream Coverage Information column automatically displays the elements covering the one you selected, and the coverage ratio between documents. The following figure shows the coverage of the PS_USB_REQ1 requirement. The Downstream Coverage Information column displays the 1.1 USB 1.0 Speeds section as a covering element because this section of the document contains a reference to the requirement. You can also see that the Product Specification document is covered at 83% by the Design Specification document.

User Manual

79

Managing the Analysis Results

In the following figure, the Downstream Coverage Information column does not display any covering elements because the covering document does not contain a reference to the requirement.

An added rule violation and the exclamation icon at the right side of the PS_USB_REQ2 highlight the requirement as an Uncovered Requirement.

The following figure shows the selection of a parent element. The child elements of the Analog Channels section contain two requirements: PS_AI_REQ1, and PS_AO_REQ1. The Downstream Coverage Information column displays both the 2.1 Analog Input and the 2.2 Analog Output sections as covering elements. In the covering document, the 2.1 Analog Input section contains reference to the PS_AI_REQ1 requirement and the 2.2 Analog Output section contains reference to the PS_AO_REQ1 requirement.

Double-click an element in the Downstream Coverage Information column. Reqtify navigates to this element in the Selection column. When you select an element in the Selection column, the Upstream Coverage Information column automatically displays the elements covered by your selection, and the coverage ratio between documents.

80

Reqtify

Using Views

In the following figure, the Upstream Coverage Information column displays that 83% of the requirements in the Product Specification document are covered by the Design Specification document. It also displays that the PS_AI_REQ1 requirement is specifically covered by references from the 2.1 Analog Input section in the Selection column.

To summarize, the Coverage Analysis View allows you to select elements from a project document and displays requirement coverage one level upstream and one level downstream from the selected document. For analysis of requirements coverage for several levels both upstream and downstream, use the Impact Analysis View.

Using the Impact Analysis View

The Impact Analysis View displays traceability information from all downstream and upstream documents instead of just displaying the immediate downstream and upstream document. All the features related to the navigation, selection, coverage ratio calculation, etc. are the same as the ones available in the Coverage analysis view. The following figure shows the Downstream Impact Information for the PS_USB_REQ1 requirement. The Downstream Impact Information column displays the covering 1.1 USB 1.0 Speeds section from the Design Specification document.

Note Document names are displayed between brackets in the Downstream and Upstream information columns only if you activated the option Display document name in impact mode in the Options dialog box.

User Manual

81

Managing the Analysis Results

As the covering of the 1.1 USB 1.0 Speeds section from the Design Specification is not a requirement, it cannot be covered downstream. Therefore the displayed information is equivalent to the one displayed in the Coverage analysis view. The following figure shows the Downstream Impact Information for the PS_USB_REQ2 requirement. The Downstream Impact Information column displays the requirements from the covering Design Specification document, but it also displays the sections from the Test Specification document that covers these requirements.

This is the main difference with the Coverage Analysis View, because in this case the Coverage Analysis View displays only the coverage of the PS_USB_REQ2 requirement by the requirements contained in the Design Specification document, at the immediate downstream level, but not the lower level information contained in the Test Specification document.

Displaying Requirement and Reference Types

Your types of analysis can be defined to support several kinds of requirements, attributes, sections, references, etc. Information concerning the requirement or the reference is displayed in the Management, Coverage analysis and Impact analysis views when you hover over an element. The following figure shows that the name of the requirement defined in the Types editor, is displayed in the Selection column:

82

Reqtify

Filters Usage and Advanced Analysis

The following figure shows that the name of the reference (coverage link) defined in the Types editor, is displayed in the Downstream Coverage Information column (and in the Upstream Information Column as well) when you click an element in the Selection column and hover over covering elements. This feature is helpful to quickly see all the link types involved in coverage of a requirement.

Filters Usage and Advanced Analysis

Some reducing filters are provided by Reqtify to get a more targeted display in the project workspace. You can also build advanced filters by creating your conditions and creating targeted displays, analysis results and reports generation. For example, if a system specification contains requirements allocated to hardware and software, the software development teams may want to filter the analysis result in order to have only the software requirements displayed.

Display Reducing Filters

The toolbar of Reqtify contains several buttons used to show or hide specific elements. Button Description Displays or hides requirements Displays or hides derived requirements Displays or hides undefined requirements Displays or hides uncovered requirements Displays or hides entities Displays or hides non-covering entities Displays or hides attributes Displays or hides links

User Manual

83

Managing the Analysis Results

Button

Description Displays or hides empty sections (sections not containing any traceability information) Displays or hides information added from Reqtify

To display or hide ALL attributes, you can select View / Attributes or the Attributes in the toolbar. You can also apply a more selective display reduction, as shown in the following figure. In order to do so, follow these steps:

1 2

Right click the attribute button

in the toolbar.

A context menu appears, containing the list of the types used in the project, with the attributes defined for each type. Select the attributes you want to display or hide.

Note In the Requirement Details view, display reduction filters can be used to hide or show the attribute columns.

84

Reqtify

Filters Usage and Advanced Analysis

Defining Filters
Filters are defined using the Filters Editor. This editor allows to filter requirements or links. To open the Filter Editor, select File > Edit Filters or click the Filters button in the toolbar.

Filters list area

The top left hand side of the dialog box contains a list of filters and options to manage the filters list: Button Function Creates a new filter. Moves the selected filter up in the list. Moves the selected filter down in the list. Deletes the selected filter.

User Manual

85

Managing the Analysis Results

The corresponding contextual menu offers two options:

The Show in list option is used to indicate whether or not you want the filter to be displayed in the filters list of the main window. As filters themselves can be used as conditions for defining advanced filters, you may not want to have these intermediate filters displayed in the list. In this case, deactivate the Show in list option.

Filters are listed as trees in the filter list area. If several filters files define filters they are all shown and used in the filter list area. See Filter Definition File section. Some filters can be placed in library to be used for each Reqtify project. Refer to Sharing filters files section to learn more about this point.

A filter which contains errors is displayed in ref in the filter list area and in the filters list of the main window.

Parameters definition area

The bottom left area of the dialog box contains an area to define parameters and options to manage the parameters: Button Function Creates a new named parameter. Deletes the selected parameter. If a filter is based on an attribute value, this value can be dynamically input when applying the filter. If the attribute is an enumeration, possible values are suggested, otherwise type $<parameterName> in the value field of the condition declaration.

86

Reqtify

Filters Usage and Advanced Analysis

See below a filter example using a parameter:

Filters definition area

The Conditions pane contains several areas: The Filter out elements unless area is used to combine the conditions in two ways:

at least one of the following conditionsin a logical OR all of the following conditionsa logical AND

The Apply filter to is used to indicate if the filter is a display filter or an analysis filter. See Impacts of Filters Definition section to obtain description of these concepts.

The Hide children of filtered elements option is used to indicate whether or not you want the children of the filtered elements to be displayed. If you do not want to have the children of the filtered elements displayed, activate this option.

User Manual

87

Managing the Analysis Results

The Condition area contains options to create a condition: Button Function Creates a new condition, which is added to conditions in the multi-lines conditions area. Deletes the selected condition. Condition on Lists the kind of elements concerned by the condition: requirement/macro-requirement, entity or reference. Types associated elements are listed in drop-down lists in order to compose the condition. See below a filter creation.

Creating a Filter
A filter is based on conditions. To create a filter, you can create one or several conditions. Follow these steps to create a condition:

1 2 3

Click

in the Condition area to add a new condition. Name your filter.

Choose in the Condition on field, if the condition will be applied to requirement/macro-requirement, entity or reference. Use the drop-down list box to build the condition: The first drop-down list box is filled automatically by Reqtify according the definition of your type, and displays all the elements you can use to filter. Select one of them. The second drop-down list box contains conditions (is present / is absent / is equal to /etc.) Depending on the condition, Reqtify displays an additional field to enter the value. For instance, if the condition is is equal to, enter the target value in this additional field. A possible value is the parameter value, so as to fill out this field with $<parameterName>.

If the element selected in the first drop-down list is an enumerated attribute, all values are suggested.

88

Reqtify

Filters Usage and Advanced Analysis

4 5 6

Click

to create additional conditions.

Check the pane Filter out elements unless. Check the pane Apply filter to.

Applying Filters to Project Analysis Results

Once defined, the filters are selected from the drop-down list box in the toolbar:

The filters remove the requirements that fit with the conditions defined for the apply filter.

To use a filter which contains a parameter, choose the filter to apply to the project. A dialog box opens to enter the parameter value:

Requirements which correspond to this attribute value are the only displayed.

Impacts of Filters Definition

The display filter is the most intuitive one. The filtered elements are removed from the display in the project workspace. An analysis filter has a stronger action. The filtered elements are more often used by Reqtify for the coverage analysis. The following figure shows an example: LL_REQ1 covers REQ2. For instance, we can consider a Safety filter defined to consider only the requirements with a Safety attribute.

If Safety is a display filter, REQ2 is simply hidden. If Safety is an analysis filter, REQ2 is completely ignored. This means LL_REQ1 references a requirement considered as no longer existing, which raises the warning Undefined requirement.

User Manual

89

Managing the Analysis Results

Note Because of this strong action, some features may be deactivated when an analysis filter is applied. To get access to these features, deactivate the filter (or make it a display filter).

Applying a filter impacts the coverage ratios. See the section about Understanding the Coverage Ratios below to learn more. Applying a filter can impact the Export actions of analysis results to a third party tool. See the Coupling Notes for more information. Applying a filter impacts the Reports generation. Only the non-filtered results will be included in the reports. A dialog box informs you that a filter is applied, you can then confirm that you want a filter-oriented reports generation, or interrupt the generation process to remove the filter.

Understanding the Coverage Ratios

The following sections describe the coverage ratio formula.

General Case
The coverage ratios presented in the Coverage Analysis view are calculated as follows:
Number of requirements for the covered document referenced in covering document Number of requirements in the covered document

Coverage Ratio for Combined Coverage

When a document is covered by the combination of several downstream documents, Reqtify gives you:

The coverage ratio between the upstream document and each downstream document, as described in the previous chapter.

90

Reqtify

Understanding the Coverage Ratios

The coverage ratio corresponding to the combined coverage, calculated as follows:

Number of requirements referenced in at least one covering document Number of requirements in the covered document

In other words, the combined coverage ratio is

Number of requirements not referenced in any of the covering document 1 Number of requirements in the covered document

Coverage Ratio in the Management View

When a document is covered by several documents with independent coverage links, the Coverage Analysis and Impact Analysis views display a coverage ratio calculated as described in the General case section. For this project configuration, a requirement is considered to be covered if it is referenced in ALL the downstream documents. The coverage ratio displayed in the Management view provides you with the information concerning these covered requirements compared to the total number of requirements.
Number of requirements referenced in ALL the covering documents Total number of requirements in the covered document

Coverage Ratio

25%
Only REQ4 is covered

REQ1 REQ2 REQ3 REQ4

75% 50%
Covers_REQ1 Covers_REQ4 Covers_REQ2 Covers_REQ3 Covers_REQ4

Note A reflexive coverage link (document covering itself) is not considered in this coverage ratio. Adding a reflexive link on the upstream document does not change the coverage ratio.

User Manual

91

Managing the Analysis Results

Impact of Filters on Coverage Ratios

Defining filters impacts Coverage ratios. Filters are applied to a given type of analysis. If your filter condition is based on an attribute defined in the type My_Type, only the requirements contained in documents of that type are filtered. Ratios are updated according to the filter selection. When a filter is applied, the coverage ratio displayed is calculated as follows:
Number of requirements referenced in the covering document, filtered Total number of requirements in the covered document, filtered

As an example, if you consider:

a Specifications document with 10 requirements: 6 with Priority = High and 4 with Priority = Low a test report with 10 tests: 8 will result with "Passed" and 2 will result with "Failed" the table below summarizes the traceability information: Tests Test_1 (Passed) Test_2 (Failed) Test_3 (Passed) Test_4 (Failed) Test_5 (Passed) Test_6 (Passed) Test_7 (Passed) Specifications are covered by tests at 90% Comments

Specifications REQ_1 (High Priority) REQ_2 (Low Priority) REQ_3 (High Priority) REQ_4 (Low Priority) REQ_5 (High Priority) REQ_6 (Low Priority) REQ_7 (High Priority) REQ_8 (Low Priority) REQ_9 (High Priority) REQ_10 (High Priority)

9 requirements tested / 10 specification requirements

Test_9 (Passed) Test_10 (Passed)

92

Reqtify

Using Folders

A filter based on the condition Priority = High will reduce the traceability graph: Specifications (Filtered) REQ_1 (High Priority) REQ_3 (High Priority) REQ_5 (High Priority) REQ_7 (High Priority) REQ_9 (High Priority) REQ_10 (High Priority) Tests Test_1 (Passed) Test_3 (Passed) Test_5 (Passed) Test_7 (Passed) Test_9 (Passed) Test_10 (Passed) Comments Specifications with High priority are covered by tests at 100 % 6 requirements tested / 6 specification requirements when the filter is applied

A filter based on the condition TestResult = Passed will reduce the traceability graph: Specifications REQ_1 (High Priority) REQ_2 (Low Priority) REQ_3 (High Priority) REQ_4 (Low Priority) REQ_5 (High Priority) REQ_6 (Low Priority) REQ_7 (High Priority) REQ_8 (Low Priority) REQ_9 (High Priority) REQ_10 (High Priority) Test_9 (Passed) Test_10 (Passed) Test_5 (Passed) Test_6 (Passed) Test_7 (Passed) Test_3 (Passed) Tests (Filtered) Test_1 (Passed) Specifications are covered by tests passed at 70% Comments

7 requirements tested with a result in Passed / 10 specification requirements

Using Folders
Folders can be used to group some documents considered at a given step in your process and/or to have a cleaner project configuration displayed for a large project. Note Only one hierarchical level is allowed. You cannot create a folder inside a folder.

User Manual

93

Managing the Analysis Results

When a project is defined with coverage links between a folder at a given level and a folder at a lower level, the coverage ratio between folders is:
Sum of references of high level requirements in the low level folder Sum of requirements in documents of the high level folder

This calculation is applied whether coverage links are folder-folder, folder-lower level document(s), or documents-lower level folders types. This coverage ratio is displayed opposite a folder in the Project Workspace. Other coverage ratio calculations depend on the configuration graph.

Coverage Link between a Low Level Folder and a High Level Folder
In this case configuration looks like:
Folder 1 Doc1-1 : N1 Requirements Doc1-2 : N2 Requirements Doc1-3 : N3 Requirements

Folder 2 Calculation of % between folders : Sum of referenced requirements N1 + N2 + N3

P1 Requirements R1 references to Doc1-1 R2 references to Doc1-2 P2 Requirements R3 references to Doc1-1 R4 references to Doc1-3

For links between a high level folder and a lower level folder, each document in the high level folder behaves like if it has combined coverage links with the documents in the lower level folder. When a high level document, or an element (section, requirements, etc.) of the high level document is selected:

Reqtify displays the folder and the coverage ratio between folders. Reqtify displays the combined coverage ratio between the selected high level document and the combination of all the documents in the lower level folder. Reqtify displays the coverage information between elements in the high level document and the document at the lower level in the standard way.

94

Reqtify

Using Folders

When a high level document or an element (section, requirement, etc.) of the high level document is selected, the lower level display behaves as if you have the configuration shown at the right. In addition, you can expand / collapse the folder and Reqtify displays the coverage ratio between folders.

In the case of a coverage link between the high level folder and the lower level folder, each lower level document is considered to cover all the documents in the high level folder. When a high level document, or an element (section, requirement, etc.) of the high level document is selected:

Reqtify displays the folder and the coverage ratio between folders. Reqtify displays, in the standard format, the coverage ratio between elements of the low level document and the high level documents.

When a lower level document, or an element (section, requirement, etc.) of the lower level document is selected, the high level display behaves like the configuration shown at the right. In addition, you can expand / collapse the folder and Reqtify displays the coverage ratio between folders.

User Manual

95

Managing the Analysis Results

Coverage Links between Documents in a Folder

Direct links between documents contained in a folder can be created using folder ports (see the section concerning project configuration to learn more). In this case configuration looks like:
Folder 1 Doc1-1 : N1 Requirements Doc1-2 : N2 Requirements Doc1-3 : N3 Requirements

Calculation of % between folders : Sum of referenced requirements N1 + N2 + N3

Folder 2
P1 Requirements R1 references to Doc1-1 R2 references to Doc1-2 P2 Requirements R3 references to Doc1-1 R4 references to Doc1-3

In the case of direct links between documents folders, coverage information is displayed in the same way as when the documents are not in a folder.

Coverage Links between a Lower Level Folder and a High Level Document
Direct links between a folder can be created using folder ports (see the section concerning project configuration to learn more). In this case configuration looks like:
Folder 1 Doc1-1 : N1 Requirements Doc1-2 : N2 Requirements Doc1-3 : N3 Requirements

Folder 2 Calculation of % between folders : Sum of referenced requirements N1 + N2 + N3

P1 Requirements R1 references to Doc1-1 R2 references to Doc1-2 P2 Requirements R3 references to Doc1-1 R4 references to Doc1-3

96

Reqtify

Using Folders

In the case of coverage links between a high level document and a lower level folder, the high level document behaves like if it has combined coverage links with the documents in the lower level folder. When a high level document, or an element (section, requirement, etc.) of the high level document is selected:

Reqtify displays the folder and the coverage ratio between folders. Reqtify displays the combined coverage ratio between the high level document selected and the combination of all documents in the lower level folder. Reqtify displays the coverage ratio between elements of the high level document and the lower level document in the standard way.

In the case of coverage links between a high level document and a lower level folder, when a lower level document, or an element (section, requirement, etc.) of the lower level document is selected:

Reqtify displays the folder and the coverage ratio between folders. Reqtify displays the coverage ratio between elements of the lower level document and the high level document in the standard way.

The information displayed is equivalent to the information displayed in the configuration shown at right. In addition, you can expand / collapse the folder and Reqtify displays the coverage ratio between folders.

User Manual

97

Managing the Analysis Results

Coverage Links between Lower Level Documents and a High Level Folder
Direct links between documents contained in a folder can be created using folder ports (see the section concerning project configuration to learn more). In this case configuration looks like:
Folder 1 Doc1-1 : N1 Requirements Doc1-2 : N2 Requirements Doc1-3 : N3 Requirements

Folder 2 Calculation of % between folders : Sum of referenced requirements N1 + N2 + N3

P1 Requirements R1 references to Doc1-1 R2 references to Doc1-2 P2 Requirements R3 references to Doc1-1 R4 references to Doc1-3

In the case of coverage links between a low level document and a high level folder, the low level document is considered as covering all the documents contained in the high level folder. When a high level document, or an element (section, requirement, etc.) of the high level document is selected:

Reqtify displays the folder and the coverage ratio between folders. Reqtify displays the coverage information between elements of the lower level document and the high level documents in the standard way.

In the case of coverage links between a low level document and a high level folder, when a low level document, or an element (section, requirement, etc.) of the low level document is selected:

Reqtify displays the folder and the coverage ratio between folders. Reqtify displays the coverage information between elements of the lower level document and the high level documents in the standard way.

98

Reqtify

Using Macro-requirement

The information displayed is equivalent to the information displayed in the configuration at the right. In addition, you can expand / collapse the folder and Reqtify displays the coverage ratio between folders.

Using Macro-requirement
A macro-requirement supports the concept of hierarchy between requirements. A macrorequirement contains requirements and passes on its properties to them. A macrorequirement goes along with section break.

Propagation of Elements Attached to the Macrorequirement

Elements attached to a macro-requirement (attribute, text, or link other than a coverage link) are also attached to requirements and derived requirements contained in the macrorequirement.

MR
Text

MR
Text

A Text

A Text

Text

Text

Text

A Text

A Text A Text

R DR
Text

R DR

Text

A Text
Text

A Text
MR R DR
Macro-Requirement Requirement Derived Requirement

Attribute with its text

Text

Text propagation

User Manual

99

Managing the Analysis Results

Coverage of Requirements Contained in a Macrorequirement

If requirements contained in a macro-requirement are referenced individually, the macrorequirement is considered as covered. The coverage ratio is equal to the number of referenced requirements contained in the macro requirements over the number of requirements contained in the macro requirement.

MR

Coverage = = 75%

Text

A Text

Downstream document
R R

Text

Text

A Text A Text

R DR DR

Text

A Text
Text

A Text
Text

A Text
MR R DR
Macro-Requirement Requirement Derived Requirement

Text

Attribute with its text Text Coverage

Text

If the macro-requirement is referenced directly by a low level element, it is considered to be 100% covered, and all requirements and derived requirements are considered to be covered by the covering element. The macro-requirement is considered uncovered if it is not 100% covered. If the macro-requirement references a higher level requirement, all the requirements contained in the macro-requirements are also considered as covering the higher level requirement. A macro-requirement existing in an intermediate document without referencing any high level requirement remains a macro-requirement.

100

Reqtify

Using Macro-requirement

MR

Coverage = 100%

Text

A Text

Downstream document
R R

Text

Text

A Text A Text

R DR DR

Text

A Text
Text

A Text
Text

A Text
MR R DR
Macro-Requirement Requirement Derived Requirement

Text

Attribute with its text Text Coverage

Text

If a macro-requirement references a higher level requirement, all the requirements contained in the macro-requirement are considered as covering the higher level requirement as well.

User Manual

101

Managing the Analysis Results

MR
Upstream document

Coverage = 100%

Text

A Text

R R

Text

Text

A Text A Text

R R
DRR DRR

Text

A Text
Text

A Text
Text

A Text
MR R DR
Macro-Requirement Requirement Derived Requirement

Text

Attribute with its text Text Coverage

Text

Note The macro-requirements support a real concept of hierarchy, as explained in this section. It is also possible to display the requirements with an indentation, or in other words, without a concept of hierarchy but with an indented tree. This is possible thanks to an advanced customization of the requirement element in the type.

Using Requirements Hierarchy

A requirements hierarchy is corresponding to nested requirements. This is authoring-tool oriented. It is able to perform this function because of the hierarchical definitions of requirements by regular expressions in a redefined type. Unlike the macro-hierarchy concept, the requirements hierarchy simply manages a nested display of requirements which must follow each other. No rules are propagated to the contained requirements and a requirements hierarchy does not pass on its properties to its contained requirements. Moreover it does not go along with section break or section changes.

102

Reqtify

Using Requirements Hierarchy

R
Text

R
Text

A Text

A Text

Text

Text

A Text

A Text

R R DR
Text

R R DR

R DR

Requirement Derived Requirement

Attribute with its text Text

Text

The requirements hierarchy allows you to capture information for requirements organized like the following:

User Manual

103

Creating Information

During the project life cycle, you will have to establish your requirement traceability either in the project files or by adding information from Reqtify, or possibly both. In addition to the traceability information inserted in the source documents, models, code files, etc. you can use Reqtify to create:

References (coverage links) Links (non-coverage links) Attributes Reference attributes Texts

This section gives you information about the helpful features you can use to quickly create your traceability information and about how you can create additional traceability information using Reqtify. You can read about these topics in:

Adding Traceability Information in your Project Documents Adding Information from ReqtifyBasic Capabilities Adding information from ReqtifyAdvanced Capabilities Using Marks

User Manual

105

Creating Information

Adding Traceability Information in your Project Documents

When you create a project, Reqtify knows the documents to be analyzed and the applied analysis types. Thus Reqtify knows when a given document is covered by other documents, and knows the definitions of the expected "References" (thanks to the type of analysis applied to the covering documents). For some of the interfaced tools, you can use Reqtify to make requirements available directly in the third party tool environment. Afterwards you will use the linkage capabilities provided by this tool to create the traceability information. However for text-oriented documents such as Word files, FrameMaker files and code files, you need to add coverage information as text strings. You can effectively use Reqtify project workspace to create coverage links in a source file or a text file. These actions are explained in this section.

Features for Inserting Coverage Information in Project Files

In the project, right click a high level requirement in the Selection column. As shown in the following figure, the context menu contains a Copy item and a Copy For submenu. The Copy item allows you to copy the requirement name in order to paste it in the source or text files. The Copy For submenu contains the reference types defined in the type of analysis for the document covering the requirement you selected in the Selection column.

To use this feature, carry out as follows:

1 2 3

Select a requirement to reference then select the Coverage Link type you want to create from the Copy For submenu. Use Navigate to open the covering (downstream) document. Paste the copied information in the covering document, either in the section or below the low-level requirement that is covering the selected requirement.

106

Reqtify

Adding Information from ReqtifyBasic Capabilities

In the same time, Reqtify inserts the requirement identifier, it also inserts a string compliant with the syntax you defined for the kind of coverage link. The coverage information is inserted in the document as shown in the following figure:

See the Customization Guide to learn more about the customization of this feature.

Adding Information from ReqtifyBasic Capabilities

You can add information from Reqtify without modifying the source documents of the project:

Coverage links (references) Links (only if you defined Types for Added ElementsSee the Advanced Capabilities section) Attributes Reference Attributes Text

Adding Covering Links

You can use the Graphical View to create coverage links. These coverage links are displayed in green in the Graphical View with a reference attribute Internal Creation To create a covering link, follow these steps:

1 2

Make a multiple selection of the requirements you want to link. You can use the [Ctrl] key to create a multiple selection / de-selection. Right click and select Create Covering Links > InternalType Coverage (the name InternalType Coverage may depend on your project configuration).

User Manual

107

Creating Information

New links are displayed in green. To delete a covering link first select it, then right click and select Remove in the context menu. You can delete the link only if it has been created from Reqtify.

Adding Attributes
Use Reqtify to add attributes to captured requirements. To create an attribute, follow these steps:

Select a requirement in the Selection column in the project workspace of the Management view, the Coverage Analysis view or the Impact Analysis view. In the Graphical view, select a requirement and use the Attributes pane in the lower half of the view. Right click and select Add an Attribute in the context menu, then Define a Boolean attribute or Define a Value attribute in the context submenu, as shown in the following figure.

108

Reqtify

Adding Information from ReqtifyBasic Capabilities

Note If you have already created attributes, they will be directly available in the context submenu underneath the Define items.

The dialog box shown in the following figure opens:

Enter the attribute name and click OK to validate.

If you selected Define a Value attribute, the additional dialog box shown in the following figure opens:

Enter the attribute value and click OK to validate.

User Manual

109

Creating Information

The attribute is displayed underneath the requirement, as shown in the following figure, and in the Attributes panes when the requirement is selected.

Modification of the Added Attributes

Use the Requirement Details view to modify the created attributes. They are displayed in columns in the same way as attributes captured in the project documents, as shown in the following figure. However, these columns can be edited, as follows:

1 2 3

Double click in the table cell to edit the value of an attribute. Select a cell containing an attribute value, right click and select Copy from the context menu. Select cells in which you want to insert the value (you can use the [Ctrl] key to make multiple selections). Right click and select Paste in the context menu.

To rename the attribute, follow these steps:

Right click the header of the attribute column in the Requirement Details view. As shown in the following figure, then select Rename in the context menu.

110

Reqtify

Adding Information from ReqtifyBasic Capabilities

The dialog box shown in the following figure opens. Rename the attribute and click OK to confirm.

Deleting Added Attributes

To remove an attribute from a given requirement, follow these steps:

Select the attribute in the Selection column in the project workspace of the Coverage Analysis view or the Impact Analysis view. In the Graphical view, select a requirement and use the Attributes pane in the lower half of the view. Right click and select Remove in the context menu.

To remove a category of attributes, follow these steps:

1 2

Use the Requirement Details view. Right click the header of the attribute column and select Delete in the context menu, as shown in the following figure.

Adding Reference Attributes

Use Reqtify to add reference attributes to captured references (coverage links). To create a Reference Attribute from the Coverage Analysis View or Impact Analysis View, follow these steps:

1 2

Select a requirement in the Selection column. Select a covering element in the Downstream column or a covered element in the Upstream column.

User Manual

111

Creating Information

Right click the element selected in the Downstream or Upstream column then select Add a reference attribute in the context menu or in the specific down area. Next select Define a Boolean Reference Attribute or Define a Value Reference Attribute in the context submenu, as shown in the following figure.

Note If you have already created reference attributes, they will be directly available in the context submenu underneath the Define items.

The dialog box shown in the following figure opens:

Enter the reference attribute name and click OK to validate.

If you selected Define a Value Reference Attribute, the additional dialog box shown in the following figure opens:

Enter the reference attribute value and click OK to validate.

112

Reqtify

Adding Information from ReqtifyBasic Capabilities

The reference attribute is displayed either underneath the covered requirement in the Upstream Coverage Information column, or underneath the covering requirement in the Downstream Coverage Information column, as shown in the following figure. In both circumstances it will also be shown in the Reference Attributes panes in the lower half of each view.

Deleting Added Reference Attributes

To remove a reference attribute, follow these steps:

Select the reference attribute from either the Upstream Coverage Information column, or in the Downstream Coverage Information column, or in the Reference Attributes panes in the lower half of each view. Right click and select Remove selected attributes in the context menu.

Adding Text
You can add some text to sections and requirements captured by Reqtify. To add text, follow these steps:

1 2

Select a section or a requirement in the Selection column of the Coverage Analysis view or the Impact Analysis view. Right click and select Add Text in the context menu.

User Manual

113

Creating Information

The dialog box shown in the following figure opens:

Enter the text you want to add and click OK to validate. The added text is displayed in the Text pane of each view when the element is selected.

When a section or a requirement has already some text added, the context menu item is Edit Added Text and not Add Text. Select Edit Added Text to edit the text. The dialog box shown in the following section opens and already contains the added text. After completing these steps you will be able to edit the text.

Consistency Checking for Added Information

When you re-analyze a project, Reqtify checks to make sure that the information created can be related to elements captured in the project documents.

For example, if a text has been added to a requirement but the requirement has been deleted from the original document, Reqtify opens a dialog box listing the information added from Reqtify but no longer captured in the project documents.

The rule Elements modified but not existing anymore in original document is also activated in the Rule Check section.

114

Reqtify

Adding Information from ReqtifyAdvanced Capabilities

If you confirm that the element is removed, and once you have managed the impact of this removal on your added information, you can remove the added information. From the Rule Check section, double click the element listed as no longer existing, and Reqtify navigates to the element in the project workspace. Right click and select Remove from the context menu.

Adding Information from ReqtifyAdvanced Capabilities

Basic capabilities allow you to create information, but there are a few limitations:

You are supposed to create all the categories of attributes before adding the attributes themselves. You can create only one type of coverage link, and only coverage links. You cannot create links.

All these limits are removed if you use a customized Type for added elements. A Type for added element allows you to define any kind of link, coverage link, attributes, etc. Once a Type for added elements has been defined to manage additional information, it can be re-used for all projects (such as for the other types files). When this type has been added in the project document as a Modification Document, you can add information as described in the Basic Capabilities.

The Customization Guide gives you all the details concerning creation and customization of Types for added elements. However the concepts concerning added elements use for projects are considered in this User Manual. You can use the Added-Information-Advanced demo example installed with Reqtify to train yourself on these concepts.

Including Types for Added Elements in your Project Configuration

In the project configuration, add Modification Documents to project documents you want to modify. See the section about Modification documents to learn more about how to insert these documents.

User Manual

115

Creating Information

As shown below, select the type for the added document from the Type of Analysis. You do not need to edit the other fields.

Adding Covering Links

You can use the Link Details View to create coverage links. These coverage links are displayed by a check mark in the Link Details view. To create a coverage link with a specific reference, follow these steps:

1 2 3

Select an element in the left area. Select a link type (reference). Click in the check box near the requirement to cover.

A check is added next to the covered requirement. A message is added in the Information area.

116

Reqtify

Adding Information from ReqtifyAdvanced Capabilities

Note It is possible to create a coverage link even if a coverage link already exists between these requirements with another link type (green square).

You can use the Graphical View to create coverage links. These coverage links are displayed in green in the Graphical View. To create a covering link, follow these steps:

1 2

Make a multiple selection of the requirements you want to link. You can use the [Ctrl] key to create a multiple selection / de-selection. Right click, select Create Covering Links then select a covering link.

Adding Links
You can use the Graphical View to create links. These links are displayed with a green dotted arrow in the Graphical View. To create a link, follow these steps:

1 2

Make a multiple selection of the requirements you want to link. You can use the [Ctrl] key to create a multiple selection / de-selection. Right click, select Create Links then one of the links coming from the modification file.

User Manual

117

Creating Information

Deleting Links
When a link or covered link is created from Reqtify and if this link destination disappears, the link becomes invisible, follow this method to delete the link:

1 2

Select the link/cover link origin from a Reqtify view. An additional item Delete link on undefined requirement has been added in the Edit menu. Click this option to delete the corresponding link.

From the Link Details view, the behavior varies a little. If you select the origin of the link, an Undefined Requirements section appears in the covered documents tree. In this section are listed the requirements which become undefined. Uncheck the requirements to delete the links.

118

Reqtify

Adding Information from ReqtifyAdvanced Capabilities

Assigning Attributes
You can use the Requirement Details view to create attributes. Attributes defined in the Type for added elements become new columns in the Requirements Details view.

Consult the Adding Attributes section in the Basic Capabilities section to learn more about this feature.

Assigning reference attribute

To assign values to reference attributes from the Link Details view, follow these steps:

1 2

Create a covering link or select a covering link with a check mark. The Reference Attributes area becomes enabled.

User Manual

119

Creating Information

Several kinds of reference attributes can be represented in the Reference Attributes area. Depending on the attribute creation in the added type for modification, the displaying in the Reference Attributes area changes. If the reference attribute has been defined as a Boolean attribute in the type for added element, then the field is displayed as a check box. Check or uncheck this check-box to choose the value:

If the reference attribute has been defined without specific values in the type for added element, then type a value in the field:

If the reference attribute has been defined with specific values in the type for added element, then select an available value in the combo-box which shows the choice:

If the reference attribute has been defined with specific values in the type for added element and is defined as multi-valued then check the required values in the combo-box which shows the choice:

The field contains the set of selected values.

120

Reqtify

Adding Marks

To assign values to reference attributes from the Graphical View, follow these steps:

1 2 3

Create a covering link or select a covering link in green. Right click in the Reference Attributes area. Select Add a reference attribute submenu, available reference attributes are listed Select a reference attribute. A dialog box opens to enter the reference attribute value.

Adding Marks
Use Marks to manage requirements changes and impact analysis, or to quickly analyze input documents:

Once results analysis are highlighted by orange icons to show the modifications detected by Reqtify. Reqtify can automatically assign a Modification mark to the elements having an orange icon (not to the parents of the orange icons, only the elements themselves). Marks are persistent you will have to remove them individually or globally according to your change analysis process. When you select a modified requirement in the Selection column, you see the covered or covering elements in the Coverage Analysis or Impact Analysis columns. Marks can be used in these columns as well, to indicate that an element is impacted by the initial change and need to be specifically tracked. Marks help you to quickly find elements, through dedicated capabilities of the Search feature. For example, you can immediately find elements concerned by Safety.

Automatic and Persistent Highlight of Modifications

When Reqtify re-analyzes the project documents, it automatically detects and highlights changes by displaying orange icons on modified elements, as shown in the following figure.

See the section about Detection of Requirement Changes to learn more.

Orange icons display the differences between the previous analysis and the current one, so they can disappear if project documents are re-analyzed without being modified.

User Manual

121

Creating Information

You can automatically apply Marks to modified elements. They will be more persistent, so you will be able to perform your impact analysis and remove marks when corresponding activities are completed.

Select Marks > Modifications in the Edit menu or from the contextual menu or the project workspace. Marks (orange circles) are automatically added to all modified elements, and are displayed even if the project document is re-analyzed, as shown in the following figure.

To navigate from one mark to the next one, select Marks > Next from the context menu or from the Edit menu. The [F2] key is a helpful shortcut. To navigate from one mark to the previous one, select Marks > Previous from the context menu or from the Edit menu. The [Shift + F2] key is a helpful shortcut.

Once you reviewed the impact of modifications, you can remove the marks:

Individuallyselect the marked element and select Marks > Remove marks from the Edit menu or from the context menu to remove all the marks of the element. Globallyall the marks of a given category will be removed if you select Marks > Remove all marks from the Edit menu or from the context menu. Recursivelyto remove a mark and all its children in one click, select Marks > Remove marks recursively from the context menu or from the Edit menu or from the context menu.

122

Reqtify

Adding Marks

Automatic Highlight of Search Results

Marks can be used to highlight the results of a search action. In order to the Find dialog box contains a button Mark all, as shown in the following figure.

If you click Mark all, all the elements found will be automatically highlighted with Marks. If you hover over an element, information is displayed to indicate which information is found for this element, as shown in the following figure.

The Find dialog box contains a Marked by field, allowing you to quickly search for the elements previously marked.

You can navigate to the next or to the previous mark by clicking on the Next or the Previous button.

User Manual

123

Creating Information

Creating your own marks

Reqtify enables you to create your own marks. To create a mark follow these steps:

Select Marks > Edit from the Edit menu or from the context menu. The dialog box shown in the following figure opens:

2 3 4 5 6

Click

to create a new mark.

Use the Display name tab to name your mark or define a text. Note that this text will be displayed in the project workspace if you hover over the mark icon. Click Click to change the color of the mark. to delete an existing mark.

Click OK to validate your mark definition.

Use this principle to create few marks.

124

Reqtify

Adding Marks

Using Your Own Marks

Once created, a mark is available in the bottom of the Marks menu, as shown in the following figure.

Note Only ten created marks are accessible from this menu.

Now, you can apply or remove the marks:

Individually: select an element in the Selection column and select Marks > <your mark> from the Edit menu or from the context menu. Collectively: select several elements in the Selection column, using the [Ctrl] key to make a multiple selection, and select Marks > <your mark> from the Edit menu or from the context menu.

You can apply few marks on an element, only four marks will be visible. The navigation works like for other default marks.

Shortcuts to Add Marks

A mark can be put on a requirement using a keyword shortcut. Shortcuts are CTRL+n where n is the number ot the mark. Nine marks shortcuts are available using the numeral keys of the keyboard.

User Manual

125

Creating Information

Visualizing Marks on Deleted Elements

When marked elements are deleted, it is always possible to visualize elements which were marked.

This information is displayed in the Deleted marks tab when a mark type is selected. Click Delete in the contextual menu if you want to erase the mark set on a deleted element.

Using Marks in Filters

It is possible to filter elements on a condition even if they are marked or not. When you create your condition, select an element type and in the second field of the condition, select Is Marked By or Is Not Marked By. Read the Filters section to learn more about the creation of filters.

Suspicious Links Management

A suspicious link is a link that must be verified. A link becomes suspicious when a covered requirement or a covering element has changed. A change is for instance a text modification. To use the suspicious link management, the Activate suspicious link management option needs to be checked in the Project pane of Options. If the User Management plugin is installed, users can manage rights concerning suspicious links on their projects.

When modifications have been done on the Reqtify project, whereas the suspicious link management is activated, Reqtify indicated suspicious links. To mark a link as suspicious, Reqtify will add a red mark on it. This mark is visible in the Graphical View and in the Link Details view. Suspicious marking is possible even if no type for added elements have been associated to types. See Link Details chapter to have details on this view.

126

Reqtify

Suspicious Links Management

In the following case, the text of PS_USB_REQ2 requirement has changed and it became New Text of PS_USB_REQ2. Reqtify shows the modification with a red icon in the Graphical View and marks the covering link as suspicious, when the project is reloaded.

In the Link Details view, covering links with the selected link type and marked as suspicious are underlined in red.

Covering links with another link type and marked as suspicious are underlined in orange.

User Manual

127

Creating Information

Unmark a suspicious link

Once the requirement modification has been validated, the suspicious mark can be removed. To remove a mark, right click a link in the Graphical View then select Unmark suspicious link in the contextual menu.

The corresponding same item is available in the Link Details contextual menu, when clicking a suspicious link in the view.

128

Reqtify

Suspicious Links Management

Mark a link as suspicious

Links can manually be marked as suspicious. To mark a link as suspicious, select a link, right click and select the Mark as suspicious link item in the contextual menu. This menu item is only available on non-suspicious links.

The corresponding same item is available in the Link Details contextual menu, when clicking a link in the view.

User Manual

129

Detection of Requirement Changes

Reqtify offers features to detect and manage requirement changes and impact analysis:

An automatic system of orange icons displays the changes between two consecutive analyses. The marks are used to highlight the modified requirements in order to manage individual impact analysis. The snapshots are used to archive project analysis results from time to time and to compare the results between saved archives, or the current results with one of the saved archives.

You can read about these topics in:

Automatic Detection of Modified Elements Managing Changes using Marks Using Snapshots

Automatic Detection Modified Elements

Every time the project is analyzed, Reqtify automatically displays the differences from results of the previous analysis. The detected changes are displayed in the project workspace using orange icons. The following figure shows that a modification has been detected for PS_USB_REQ1. The orange icons are propagated throughout the document level, so you can get the information concerning modifications even if document tree is collapsed.

User Manual

131

Detection of Requirement Changes

The orange icon displayed depends on the modification: Flag Meaning New element Modified element Moved element: the element is not modified but located underneath a different parent element. Note As orange icons automatically display the differences between two consecutive analyses, they will disappear after the next analysis if no other changes have been detected. If you want a more persistent display of modifications, use the Snapshots and/or the Marks.

Managing Changes using Marks

Marks can be used to manage requirements changes and impact analysis.

Once analysis results are highlighted by orange icons to show the modifications detected by Reqtify, select Edit > Marks > Modifications. Reqtify automatically adds a Modification mark to the elements that have an orange icon (not to their parents as it does for the orange icons, but only to the elements themselves). Marks are persistent; you will have to remove them individually or globally according to your change analysis process. When you select a modified requirement in the Selection column, you will see the covered or covering elements in the Coverage Analysis or Impact Analysis columns. Marks can be used in these columns as well, to indicate that an element is impacted by the initial change and needs to be specifically tracked.

Read the Using Marks chapter to learn more about use of Marks.

132

Reqtify

Using Snapshots

Using Snapshots
The Snapshots are used to archive the project analysis results from time to time during your project lifecycle. Using snapshots process you can compare the current analysis results with any of the saved snapshots, or compare one snapshot with another snapshot. To open the snapshot editor window, click Snapshots. in the toolbar or select File > Edit

The snapshot editor dialog box contains three panes:

The Snapshots pane displays the list of previously saved snapshots. The Differences pane can display either the list of differences between the current analysis results and the analysis results saved in the snapshot selected in the Snapshots list or the list of differences between two snapshots selected in the Snapshots list. The Difference Comments pane displays information entered by the user, typically the rationale of the modification or any helpful information. This text area can be edited only if you select an element concerning the current analysis results from the Differences tree.

The snapshot editor dialog box also displays the name of the filter applied.

User Manual

133

Detection of Requirement Changes

The snapshot editor dialog box contains five menus:

File Display Reports Tool Help

The File menu contains the following items: Item Make a snapshot of the current project Properties Delete Close Description Saves the current analysis results as a snapshot Displays the Information dialog box for the selected snapshot Deletes the selected snapshot Quits the snapshot editor dialog box.

The Display menu contains the following items: Item View element history Description When you select an element from the list of differences, the display changes to show you the list of modifications of the selected element throughout its history. Displays the list of snapshots (default display mode of the snapshot editor dialog box). Opens an additional window, equivalent to the main window but in read-only mode, displaying the analysis results for the selected snapshot. Navigates to the selected element in the file containing it.

View snapshots Selected snapshot view

Navigate

134

Reqtify

Using Snapshots

The Reports menu offers the following functions: Item Snapshots Comparison Description Report containing the list of differences between the current analysis results and the selected snapshot, or between two selected snapshots. Report containing the impact analysis between the current analysis results and the selected snapshot, or between two selected snapshots.

Snapshots Impact Analysis

The Tool menu offers the following functions: Item Evaluate Description Opens the OTScript Evaluator.

The Help menu offers the following functions: Item Help topics Description Opens the User Manual and Customization Guide of the online help files.

Creating a Snapshot
To create a snapshot, follow these steps:

Select File > Make a snapshot of the current project. The Snapshot information dialog box opens:

Enter a Name and a Description for your snapshot. Click OK to validate.

User Manual

135

Detection of Requirement Changes

The created snapshot is now displayed in the Snapshots pane.

Using Snapshots to Compare Results

If you have at least one snapshot saved for your project, Reqtify allows you to compare the saved results with other analysis results: either the current results or the one saved in another snapshot.

If you want to compare the current analysis results with a previously saved snapshot, just select a saved snapshot from the Snapshots pane. The Differences pane displays the list of differences between the results of the saved snapshots and the results for the current analysis of your project document. If you want to compare two snapshots, select them in the Snapshots pane using the [Ctrl] key to make a multiple selection. The Differences pane displays the list of differences.

You can expand the tree to see what the differences are. The following figure shows a modification of the text of the PS_USB_REQ1 requirement. The trees in the Differences pane are arranged by categories of modifications, inserted underneath the name of the document.

136

Reqtify

Using Snapshots

Element History
The snapshot editor proposes a display mode that shows the history of a selected element across the saved snapshots. Select an element in the Differences list and select Display > View element history or View element history in the context menu.

The snapshot editor dialog box changes and you see only one pane for the selected element, showing the modification that has occurred for each snapshot.

To return to the default display mode, select Display > View snapshots or View snapshots in the context menu.

Opening a Snapshot
You can use Reqtify to view the analysis results previously saved as a snapshot. Double click on a snapshot in the Snapshots list of the Snapshot editor dialog box or select a snapshot by selecting Display > Selected snapshot view or Selected snapshot view in the context menu. A new window opens in which you can navigate the same way as in the Reqtify main window. Even if this snapshot window is read-only, you can apply filters or open the configuration dialog box to see what was the project configuration was when the snapshot had been saved.

Snapshots Troubleshooting
When the user saves a project from project with file mode to project with database mode, if snapshots were made in file mode, they are also integrated in the database. To avoid conflicts, the snapshots directory is renamed snapshots_old. The snapshots files are not requested anymore.

User Manual

137

Rules Check and Error Messages

The results of checks are grouped together in the Rule check section, at the top of the Selection column in the project workspace. Rules can be customized by trained users and/or by our experts to provide additional value in support of your requirements management process.

Take time to review all rule violations before analyzing the project analysis results. A double click on an element in this section navigates directly to this element in its document tree. In the project workspace, elements violating a defined rule are displayed in red or orange, depending on the gravity level. More information is displayed in the Messages pane when you select an element violating a rule.

The following chapter describes the errors and warning messages of rules check and some recommended corrective actions if a corrective action be identified and suggested.

Critical Error Messages

Critical errors are not located in the Rule check section. These kinds of errors appear in a dialog box which prevents the opening of the corresponding project. The following table shows the identified critical errors messages: Error Messages
Non-existent section or key

Explanation
A Reqtify file such as .type file, .ini file or .rqtf file is corrupted or is defined with an inconsistent definition of a section or a key.

Corrective Action
Users must avoid manual modification of Reqtify files. Correct manual modifications if this is the cause of the problem.

User Manual

139

Rules Check and Error Messages

Error Messages
Several error cases have been identified. For most cases corrective actions are proposed. Unfortunately, it is impossible to imagine the solutions to all the problems that may appear.

Try to solve the errors with the following helpful information. The impact analysis must be redone after a corrective action.

The following table shows the identified errors messages: Error Messages
Analysis error

Explanation
An error has been identified in the intermediate file. For example, this could happen when: the XML file has invalid format problems occur during conversion there is a file access error to an intermediate file

Corrective Action
Try to re-launch the loading and the conversion.

Bad requirement level Closing expression found without opening expression

Bad nesting of requirements according to the defined type. The analyzed information contains a closing expression without the expected opening expression. This error can only affect requirements, macro-requirements or sections expressions. For example, this could happen when: the source file structure or the intermediate file contains some inconstancies, such as the lack of closing expression the analysis type contains an incomplete definition of parents/children combination for sections

Change the document structure. Modify the document to insert the missing opening expression. Modify the document to delete the additional closing expression.

140

Reqtify

Error Messages

Error Messages
COM error

Explanation
The COM dialog with an interfaced tool fails. For example, causes could be: the declaration of an obsolete COM library another application is using the same COM interface at the same time the tool is not installed or is not correctly installed

Corrective Action
Reinstall the tool. Treat the COM error.

If this error is persistent, contact your IT administrator or the Support Team.

Conversion problem

The document cannot be analyzed by Reqtify. For example, this could happen when the document to be analyzed has: an unknown format an obsolete format such as a Word 95 file

No corrective action can be proposed.

Converter not found

The project configuration has been defined with a type of analysis based on a converter not available in the current project configuration. For example, this could happen when a specific converter has been developed for a user and the user has upgraded his Reqtify version. A converter is used to analyze the input information and to produce an intermediate file. See the section about Reqtify architecture to learn more.

Add the converter from the old version into the new one. Rewrite the converter. Load a new converter.

Cover link source not found

The capture information defined as a coverage link source in the analyzed document has not been found. See Defining References section in the Customization Guide to learn more. This error may appear when the user defines two parentheses groups in his reference regular expression. The first parentheses group is for the target and the second one is assigned to the source by default and this source cannot be found.

Verify the source Verify the regular expression definition

User Manual

141

Rules Check and Error Messages

Error Messages
Covered document not found

Explanation
The .rqtf file corresponding to the project configuration has been corrupted. In this file a covered document is declared but the document itself is not defined in the configuration.

Corrective Action
Users must avoid manual modification of Reqtify files. In this case the user can resave the project from the project editor. Users must avoid manual modification of Reqtify files. In this case the user can resave the project from the project editor. Change the parent/child relationship.

Covering document not found

The .rqtf file corresponding to the project configuration has been corrupted. In this file a covering document is declared but the document itself is not defined in the configuration.

Cyclic graph creation not allowed

This error happens when we define a P parent of an E element and if this P parent is already a child of E. The capture information from the analyzed document defined as a document in a coverage link or a link has not been found. See Defining References and Defining Links sections in the Customization Guide to learn more.

Document not found

Verify the document Verify the regular expression definition

Document not readable

The document is not available for analysis. For example, this could happen when: the User does not have the proper rights in the case of a remote access to the file the file may not exist because it has been moved the type of analysis does not match the file type

Check the access rights or ask the administrator. Move or create the missing file. Correct the type of analysis.

Embedded document not found

This happens if a document included in a folder is not found. The .rqtf file is corrupted.

Users must avoid manual modification of Reqtify files. Correct manual modifications if this is probably the cause of the problem. Contact the Support Team.

142

Reqtify

Error Messages

Error Messages
Entity tag found in macro-requirement

Explanation
An entity has been found between the opening and the closing tags of a macrorequirement definition. For process reasons, entities are not allowed in macro-requirements.

Corrective Action
Delete the entity.

File access error

This system error corresponds to a file access error.

Look at the parameter error to correct the error. Remove the deletion of the element expression.

Impossible to delete

An element to delete has been captured, but the element itself does not exist. For example, this could happen when the analysis type has been defined to delete requirements marked as obsolete. See expression to delete an element advanced options creation.

Invalid parent type

Unexpected parent in the hierarchy.

Modify the type to establish a good parent/child relationship. define a requirement delete the reference

Inverse reference without requirement

A reference with an is covered by element has been found in the document outside a requirement definition. See the inverse regular expression to know more about is covered by. The capture information defined as a link source in the analyzed document has not been found. See the section about Defining Links in the Customization Guide and more specifically information about Fields.

Link source not found

verify the source verify the regular expression definition

Link to undefined requirement

The target requirement of a reference has not been found anywhere in the project. For example, this could happen when: a defined requirement has disappeared a typing error has been made on the requirement name the downstream element references a requirement filtered by an Analysis Filter

Define the requirement in one downstream document. Correct the typing error. Cancel the filter effect.

Macro-requirement defined several times

A macro-requirement is defined several times in the same document.

Rename the macrorequirement.

User Manual

143

Rules Check and Error Messages

Error Messages
Non-covering entity

Explanation
An entity is found without a reference to a higher level requirement. For example, this could happen when there are dead codes within a code.

Corrective Action
Delete the non-covering entity.

Opening expression found without closing expression

The analyzed information contains an opening expression but the closing expression expected to close the previous analyzed expression is missing. Only requirements, macro-requirements or sections expressions can be concerned. For example, this could happen when: the source file structure, or the intermediate file contains some inconstancies, such as the lack of a closing expression the analysis type contains an incomplete definition of parents/children combination for sections

Modify the document to insert the missing closing expression.

Parent not found

The capture information from the analyzed document defined as a parent in a section has not been found. See the section about Defining Sections in the Customization Guide and more specifically information about Fields.

Verify the parent. Verify the regular expression definition.

Post-processing error

Error in the post-processing.

This error has a parameter. Consult this parameter to correct. Redefine the replacement in the Project Editor. Rename the requirement.

Replacement document not found

In composite projects, the replacement document has not been found.

Requirement defined several times

A requirement or a derived requirement is defined several times in the same document. For example, a requirement cannot have the same name definition as a derived requirement.

Requirement defined in several documents, and the documents are covered by a shared document

Two documents are covered by the same document and each of them contains a requirement, a derived requirement or a macro-requirement whose identifier is identical to an identifier contained in the other document.

Define the requirements of the documents more precisely.

144

Reqtify

Error Messages

Error Messages
Section with same identifier

Explanation
Two sections of the same hierarchical level have the same identifier. For example, this could happen when two titles have the same identifier number.

Corrective Action
Correct the sections in the document to be analyzed.

Self covering requirement Too many results found. A capture expression may be wrong

A requirement reference references itself.

Delete or modify the coverage. If you do need to capture more than 50 000 results with the same expression it would be necessary to increase the maxFoundResults limit. Edit your .ini file and define a variable
maxFoundResults=<your number> in the [General]

This message appears when the same regular expression captures more than 50 000 results on one analyzed document. It avoids a memory consumption that is too large (and sometimes a crash) in the case of a bad regular expression. For instance, such error can appear when 10 regular expressions are providing more than 5000 results. Simple case with requirements captured from table rows:
(7000 requirement rows) x (1 requirement identifier + 1 requirement label + 1 requirement text + 7 attribute values) = 70000 results

section. Create this section if it does not exist. Do not hesitate to contact the Support Team for assistance.

Traceability Graph Violation

In this case, the coverage is made at a level too high. This occurs because an element references a requirement of a document not declared as covered for the document containing the reference. Double-click on a Traceability graph violation error in the Rule check of Reqtify to reach the source object. To visualize the target object of a Traceability graph violation error, select a source object then open the Message pane.

If the reference is appropriate, create a coverage link between the two documents to allow direct traceability. Otherwise delete or modify the coverage.

Unauthorized attribute value

The analyzed document contains an attribute of an enumerated attribute with a value out of the defined list of values.

Add the new value to the enumerated attribute in the types. Modify the value in the document with a correct one.

User Manual

145

Rules Check and Error Messages

Error Messages
Uncovered requirement

Explanation
A requirement, a derived requirement or a macro-requirement is not referenced in any covering document. No error is raised for requirements of low level documents. This rule is not applied in a self-covering document case.

Corrective Action
Define the coverage of the requirement.

Undefined covering requirement/entity

The covering element does not exist anymore or contains a typing error. For example, the high level requirement "is covered by" a low level requirement that is captured but undefined.

Rename the covering element. Define the covering element.

Unknown document type

The project configuration has been defined with a type of analysis not available in the project configuration. For example, this could happen when: a project defined with a local type by a User A, has been opened by a User B with a Reqtify configuration that does not include the type defined by User A the types file has been lost or the file has been moved a type is not available anymore

Reqtify automatically replaces the initial Type of Analysis by the default LostType one. add the document type to the configuration recover the file or move the file at the dedicated place select a type for the document

Unknown element type

This situation happens when a reference element type does no longer exist in the rqtf file. A regular expression or an XML syntax has been defined to define the parent element.

Contact the Support Team for assistance.

Unknown parent element

Contact the Support Team for assistance.

146

Reqtify

Warning Messages

Warning Messages
Several warning cases have been identified. For most of the cases corrective actions are proposed. Even if it is only a warning, it is better to avoid warnings in your analysis project. Try to solve warnings with the helpful information found below. The impact analysis must be redone after a corrective action. The following table shows the identified warning messages: Warning Messages
Attribute defined several times

Explanation
An attribute has been captured several times in the same requirement. For example, this could happen when a requirement capture has failed in the document, because it does not comply with the analysis type definition. These requirement attributes are captured but are linked to the previous requirement.

Corrective Action
Remove the redefined attribute.

Bad section level

Bad nesting of sections or bad section type definition. The captured sections from the analyzed document are not following the hierarchy defined in the type of analysis. For example, a Word heading 3 section underneath a heading 1 section.

fix the hierarchy issue in your source document correct the type of analysis activate the option Ignore structure in the project configuration editor for the concerned document. See this option in the Project Configuration / Description.

Element modified but not found in original document

An element has been captured from a modification document, but the same element is not found in the original document supposed to be modified. An attribute had been added to a requirement from Reqtify but now the requirement has been deleted from the original document. Two links are defined on the same element.

Delete the element from the modification document.

Element with parent not found in the original document

Remove the attribute from Reqtify.

Link defined several times

Delete one of the links.

User Manual

147

Rules Check and Error Messages

Warning Messages
Reference attribute defined several times

Explanation
A reference attribute has been captured several times in the same requirement For example, this could happen when a requirement capture has failed in the document, because it does not comply with the analysis type definition. These requirement reference attributes are captured but are linked to the previous requirement.

Corrective Action
Remove the redefined reference attribute.

Reference attribute without reference

A reference attribute has been captured but could not be attached to a reference.

add a reference delete the reference attribute

Requirement defined in several documents, and the documents are covered by different documents

A requirement, a derived requirement or a macro-requirement of a document is also captured in another document.

Define more precisely the requirements of the documents.

Information Messages
Few information messages are located in the Rule check section. The following table shows the identified warning messages: Information Messages
Derived requirement

Explanation
Derived requirements are listed in Derived requirement part of the Rule check.

148

Reqtify

Generating Reports

This section gives you information about generated reports. Reqtify supports several generation formats:

RTF for Word MIF for FrameMaker Interleaf HTML Text only Excel

Reqtify generates the following default reports:

Note

Traceability MatrixLists the upstream to downstream covered links and the downstream to upstream covering links. Analysis ResultsSummarizes the coverage analysis for a project. Project DescriptionDescribes the project and its documents. Upstream Impact AnalysisLists the upstream traceability information for selected elements of the project. Downstream Impact AnalysisLists the downstream traceability information for selected elements of the project. Synthesis of Added InformationSummarizes any added attributes, references, text and covering links in the project. Rules CheckingContains a summary of any rules highlighted by the project.

The Support Team and our experts can provide report templates corresponding to your specific needs concerning requirement management. Do not hesitate to contact us.

User Manual

149

Generating Reports

Generating the Traceability Matrix Report

Select Reports > Library Reports > Traceability Matrix. Reqtify opens the dialog box shown in the following figure.

Select at least two documents (only the root element of the document tree) and click Continue. Reqtify opens a Save As dialog box. Select a style and a format for report generation from the Type drop-down list box, the location of your report file, and name the report.

150

Reqtify

Generating the Traceability Matrix Report

Reqtify generates a bi-directional traceability matrix, such as the example shown in the following figure.

User Manual

151

Generating Reports

Generating the Analysis Results Report

Select Reports > Library Reports > Analysis Results. You do not have to select any element before generation as the report is a summary of the project information. Reqtify opens a Save As dialog box. Select a style and a format for report generation from the Type drop-down list box, the location of your report file, and name the report. Reqtify generates the Analysis Results report, such as the example shown in the following figure.

152

Reqtify

Generating the Project Description Report

Generating the Project Description Report

Select Reports > Library Reports > Project Description. You do not have to select any element before generation as the report is a summary of the project information. Reqtify opens a Save As dialog box. Select a style and a format for report generation from the Type drop-down list box, the location of your report file, and name the report. Reqtify generates the Project Description, such as the example shown in the following figure.

User Manual

153

Generating Reports

Generating the Upstream Impact Analysis Report

This report lists the upstream traceability information for a low level element selected in the project. Select Reports > Library Reports > Upstream Impact Analysis. Reqtify opens the dialog box shown in the following figure.

Select one or several low level elements and click Continue. Reqtify opens a Save As dialog box. Select a style and a format for report generation from the Type drop-down list box, the location of your report file, and name the report. Reqtify generates the Upstream Impact Analysis report, such as the example shown in the following figure.

154

Reqtify

Generating the Downstream Impact Analysis Report

Generating the Downstream Impact Analysis Report

This report lists the downstream traceability information for a high level requirement selected in the project. Select Reports > Library Reports > Downstream Impact Analysis. Reqtify opens the dialog box shown in the following figure.

Select one or several high level requirements and click Continue. Reqtify opens a Save As dialog box. Select a style and a format for report generation from the Type drop-down list box, the location of your report file, and name the report. Reqtify generates the Downstream Impact Analysis report, such as the example shown in the following figure.

User Manual

155

Generating Reports

Generating the Synthesis of Added Information Report

Select Reports > Library Reports > Synthesis of Added Information. You do not have to select any element before generation as the report is a summary of the project information. Reqtify opens a Save As dialog box. Select a style and a format for report generation from the Type drop-down list box, the location of your report file, and name the report. Reqtify generates the Synthesis of Added Information report, such as the example shown in the following figure.

156

Reqtify

Generating the Rules Checking Report

Generating the Rules Checking Report

Select Reports > Library Reports > Rules Checking. You do not have to select any element before generation as the report is a summary of the project information. Reqtify opens a Save As dialog box. Select a style and a format for report generation from the Type drop-down list box, the location of your report file, and name the report. Reqtify generates the Rules Checking report, such as the example shown in the following figure.

Customizing your Report Style

You can customize the style of your report for each generation format by editing templates. Default templates are located in the <installation_dir>\Config\Doc_Templates directory. See the section about configuration files to learn more about the management of the customized templates.

User Manual

157

Generating Reports

Templates are files that use the format (and the extension) corresponding to the report generation format:

Templates for RTF (Word) generation shall be named <template-name>.rtf Templates for Excel generation shall be named <template-name>.xls Templates for HTML generation shall be named <template-name>.htm etc.

By defining different templates, you can create different styles for the same content, depending on your generation format or final usage of the generated report.

All the templates contain two tags: %endheader and %begintrailer, as shown in picture of the customized Downstream Impact Analysis report, at the end of next section. The text between those tags will be replaced by the analysis results generated from Reqtify, but the formatting defined will be used for generation.

Word document generation

For example, consider the Downstream impact analysis report generated using the default Portrait.rtf template. The result looks like the report shown in the following figure (the default style shown in the following figure may change depending on your Reqtify configuration).

158

Reqtify

Customizing your Report Style

You can customize the portrait.rtf file, modify the Word styles (take care to modify the Word styles themselves, using Format > Styles) and create a new template my_style.rtf, such as the one shown in the following figure.

When you generate reports, Reqtify opens a Save As dialog box: the my_style template is available in the Type drop-down list box. Select it, select the location of your report file, name the report and click OK to generate.

User Manual

159

Generating Reports

You get a report with the same content but with the styles you have defined, as the example shown in the following figure for our example.

OLE and Rich text object can be generated in a word document.

Excel generation
Reqtify can generate document content in several spreadsheets. User can add a simple PAGE BREAK tag in their favorites excel templates in order to generate one document section per sheet. As a result you can have automatically one matrix/table per sheet for instance instead of a very long single sheet.

To specify the spreadsheet name in which the report will be generated, the user has to specify the START_REPORT tag in the target cell where the report will be generated.

160

Reqtify

Overview of the Product Work Files

This section gives an overview of the files used by Reqtify.

Note 1 Modification of these files may lead to abnormal behavior, or even data losses. Users manually editing the files do so at their own risk. In case of any doubt, contact the Support Team BEFORE modifying the files.

Note 2 Most of the files are defined with the objective to support multi-language capability of the product, including Chinese and Japanese. For this reason, files are saved using the UTF8 format and not a plain text or ANSI format. Saving these files in ANSI or other non UTF8 format may break the product opening process. If you decide to directly edit a file, please use a text editor supporting the UTF8 format and be sure to save the edited file in the same format as the original one.

Reqtify takes into account configuration files located:

In its installation directory: in this case the default or user-defined configuration is available for all projects. In the project directory: in this case the configuration (always user-defined) is available only for the project.

You can read about these topics in:

Main Configuration Files in the Installation Directory Adding Configuration Files in the Project Directory Project Files

User Manual

161

Overview of the Product Work Files

Main Configuration Files in the Installation Directory

Types Definition
The files defining the default types of analysis are located in the <Installation directory>\Config\Types directory. This directory contains subdirectories; each subdirectory is displayed as a folder in the Reqtify types editor:

Config directory and subdirectories

Types hierarchy in the Types editor

Each subdirectory contains some files with the .types extension.

162

Reqtify

Main Configuration Files in the Installation Directory

These files have the following structure: [Types] Names=<type1>,<type2> [type1] (type1 definition) [type2] (type2 definition)

type1, type2, are the types displayed underneath the folder in the Types Editor.
If the .types files are read-only, types cannot be modified from the Types Editor.

Report Templates
Templates for reports generation (structure and contents) are located in the <installation_dir>\Config\Doc_models directory. The files located in this subdirectory are XML files created from the Reports Editor. The Support Team or our Experts can provide you with ready to use reports compliant with your requirements management process and needs. They have to be dropped in that subdirectory.

Templates for Report Styles

Templates defining the style of your reports according to the generation format (RTF, HTML, Excel,) are located in the <installation_dir>\Config\Doc_templates directory.

Templates are files using the format (and the extension) corresponding to the report generation format, and that can be edited directly in the editing tool (Word for RTF, HTML editor for HTML, etc.):

Templates for RTF (Word) generation shall be named <template-name>.rtf Templates for HTML generation shall be named <template-name>.htm etc.

Once created, these templates can be selected from the Type drop-down list box of the Save As dialog box, which opens when you select a report generation.

User Manual

163

Overview of the Product Work Files

Adding Configuration Files in the Project Directory

When you perform an additional customization in your project environment, configuration files are located in the project directory, or in subdirectories. You can also add configuration files in the project directory, or in its subdirectories, to make a configuration available only for the project. Note Select File > Open Project Directory to quickly open the project directory.

Types Definition
The <project_name>.types file contains the information about the different types of analysis created for your project from the Types Editor. Reqtify will also take into account all the files contained in the project directory with the .types extension. Therefore, if you customize default types:

You can make them available for all projects by locating those files in the installation directory. See the section about Default configuration files to learn more. You can make them available for any other project by copying the types file into the new project directory. You do not have to rename it.

Report Templates
The doc_models subdirectory contains XML file(s) for reports created from the Reports Editor. Reqtify will also take into account all the files contained in the doc_models subdirectory of the project directory. Therefore, if you customized reports:

You can make them available for all projects by locating those files in the installation directory. See the section about Default configuration files to learn more. You can make them available for any other project by copying the file into the new project directory; in a doc_models subdirectory (create it if it does not already exist).

164

Reqtify

Project Files

Templates for Report Styles

The doc_templates subdirectory contains file(s) for report styles. Reqtify will also take into account all the files contained in the doc_templates subdirectory of the project directory. Therefore, if you customized report styles:

You can make them available for all projects by locating those files in the installation directory. See the section about Default configuration files to learn more. You can make them available for any other project by copying the file into the new project directory; in a doc_templates subdirectory (create it if it does not already exist).

As for default ones, these templates can be selected from the Type drop-down list box of the Save As dialog box opened when you select a report generation.

Project Files
Project Configuration File
The <project_name>.rqtf file contains the definition of the project configuration, defined from the project editor window. This file is located in the project directory.

Analysis Results File

The file <project_name>.rqtfimage is created after the first analysis of project information. This file contains the analysis results. This file is in a binary and is proprietary, therefore you cannot edit it. If you delete it, Reqtify will re-analyze all the project documents to re-create this file. Note If you want to exchange information between teams or with the Support Team, you can send the rqtfimage files and use the product as a viewer: Select File > Open and select Project snapshot from the File Type drop-down list box of the Open dialog box.

The project directory may contain a subdirectory called Snapshots. These files contain the analysis results saved as snapshots using the Snapshot editor. They are named automatically with the following syntax:

<project_nameYYMMDDHHNN>.rqtfimage

User Manual

165

Overview of the Product Work Files

The information YYMMDDHHNN specifies the date the file was saved:

YY is the year MM is the month DD is the day HHNN is the time in hours and minutes

Information File
The file <project_name>.dat contains comments associated with elements, entered from the snapshot editor (Difference Comments pane). This file may not exist.

Filter Definition File

The file <project_name>.filters contains the definitions of project filters created from the Filters editors, and the status of the current filter activated for the project. The file also contains information concerning display filters such as users selection about show/hide requirements, show/hide empty sections, etc. This file may not exist. The filter file is located in the project directory. Several filters files can be placed in the project directory, they are all taken into account.

Sharing Filter Files

Some filter files can be placed in library to be used for each project. Copy the filter file into the filters directory of <Installation directory>\Config directory to place the filter in library

166

Reqtify

Environment Variables Declaration

Environment Variables Declaration

The positioning of some environment variables allows you to parameterize certain data such as the redefinition of directories.

TMP Environment Variable

The temporary files generated by Reqtify are principally intermediate files, when these files are not stored. By default these temporary files take place into the user temporary directory:

<User Local Settings>\Temp

It is possible to change the temporary files location by moving the TMP environment variable. This is useful when temporary files take a lot of place.

To redefine the temporary files location, follow these steps:

1 2 3

Open the Options dialog box (Tools > Options). Create a new environment variable named TMP. In the Value field, assign the new temporary files location.

User Manual

167

Overview of the Product Work Files

Debugging Directory
When the tools coupled with Reqtify encounter problems, they return debugging files placed into the <User Application Data>\TNI\<Reqtify> directory. To modify the location of these files, follow these steps: Edit the .ini file. In the [General] section (create this section if it does not exist), define the variable: ApplicationDataDir. Assign the new location to the ApplicationDataDir key.

168

Reqtify

Appendix: Command Line Options

This section presents all other available Reqtify command line options.

-l <eng|fra|jpn>
This option allows the user to run Reqtify in another language than the default (computer related) one. -l must be followed by: * eng for English * fra for French * jpn for Japanese Example: Reqtify -l eng

Config="<ConfigDir1>, <ConfigDir2>, ..."

This option allows you to run the application loading several configuration directories. This is useful when files are shared between several users. In this case, a common configuration directory can be created containing its own types, otscript, images, doc_models directories. Then running Reqtify with the Config option allows to use this shared configuration directory. Example: Reqtify Config="C:\Program Files\...\Reqtify x.x\config,S:\Shared\config_200901" Note The first configuration directory must be the tool config directory. Note The path to specify for configuration directories must be an absolute path.

User Manual

169

Appendix: Command Line Options

-regserver
This option allows you to register COM server adding entries to the operating system registry. Example: Reqtify -regserver Note This option is Windows-compatible only.

-unregserver
This option allows you to remove registry entries added through '-unregserver' command. Example: Reqtify -unregserver Note This option is Windows-compatible only.

-sync
This option allows you to run the application in X synchronous mode. The synchronous mode forces the X server to perform each X client request immediately and not use buffer optimization. It makes the program easier to debug and often much slower. Note This option is Linux-compatible only.

170

Reqtify

Index

A
Access .................................................. 55 Accumulate information .......................... 64 Add a composite project .......................... 56 Add a cover ..................................... 56, 57 Add a document............................... 56, 57 Add a folder .................................... 56, 59 Add a modification document ............. 56, 63 Add a reference attribute ............. 32, 35, 40 Add an attribute .................... 31, 32, 35, 40 Add high level requirements .................... 24 Add link ................................................ 47 Added information ............................ 23, 65 Adding marks ...................................... 121 Analysis filter................................... 87, 89 Analysis results .................................... 165 Ask for reloadings .................................. 70 Attributes................................... 16, 23, 84 Display selection .................................. 84 Automatically position documents ............. 39

Cleanup link .......................................... 58 Close .................................................. 134 Collapse root sections ............................. 39 Combined coverage ................................ 61 Concurrent access ............................ 51, 52 Configuration window ....................... 49, 53 Copy .........................22, 31, 34, 39, 42, 58 Copy for ....................... 22, 31, 34, 39, 106 Copy requirement ID .............................. 42 Cover ................................................... 56 adding .......................................... 56, 57 Coverage analysis view ..................... 27, 29 menu ................................................. 31 Coverage ratio Combined coverage .............................. 90 General case ....................................... 90 Create covering links ........................ 23, 40 Create links ..................................... 23, 40

D
Debugging directory ............................. 168 Delete ...... 22, 31, 32, 34, 35, 39, 40, 42, 58 Delete an element .................................. 56 Delete link ............................................ 47 Delete selected attributes ............. 32, 35, 41 Deleted marks ..................................... 126 Dependency .......................................... 56 Derived requirements ....................... 15, 23 Directory creation when drag and drop ...... 70 Display filter .................................... 87, 89 Display only requirements ....................... 46 Document

B
Back .................................................... 22 Block reloading ...................................... 55

C
Category assigning ............................................ 66 Changes detection ................................ 131 Checking rules ....................................... 78

User Manual

171

Index

adding .......................................... 56, 57 checking dates ..................................... 72 opening after generation ....................... 70 Documentation menu ............................................... 135 Documents detail area minimizing .......................................... 56 restoring ............................................. 56

Filter creating .............................................. 85 deleting .............................................. 85 Impact on coverage ratio ...................... 92 Filters definition ................................... 166 Find 22, 31, 34 in the tree ................................ 22, 31, 34 next ................................................... 22 previous ............................................. 22 Folder adding .......................................... 56, 59 adding cover ....................................... 60 document adding in .............................. 60 ports .................................................. 60 Folders ........................................... 59, 93 Font changing ............................................. 70 Forward ................................................ 22

E
Edit filters ............................................. 21 Edit menu ....................................... 22, 57 Edit project ........................................... 21 Edit reports ........................................... 24 Edit snapshots ....................................... 21 Edit text ......................................... 32, 35 Edit types ............................................. 21 Element deleting .............................................. 56 Empty sections ...................................... 23 Enable debugging................................... 70 Entities ........................................... 15, 23 Environment variables defining .............................................. 71 Evaluate .................................... 32, 35, 39 Exit 21 Expand all sections ................................. 40 Export document to DOORS ..................... 24 Export document to RequisitePro .............. 24

G
Graphical view ................................. 27, 36 menu ................................................. 38

H
Hide selected documents .............. 31, 34, 39

I
Ignore structure..................................... 55 Impact analysis view ........................ 27, 33 menu ................................................. 34 Impact mode document names displaying ............. 70, 81 Importing functions ................................ 65 Information file .................................... 166 Intermediate file .................................... 55

F
File menu .............................................. 21 File or directory ..................................... 55 Files definition *.dat files ......................................... 166 *.filters files ...................................... 166 *.rqtf files ......................................... 165 *.rqtfimage files ................................. 165 *.types files ............................... 162, 164 report templates ..................163, 164, 165 snapshot files .................................... 165

K
Kind ..................................................... 56 Cover ................................................. 56 Dependency ........................................ 56

172

Reqtify

Index

L
Launch supervisor .................................. 70 Link details ..................................... 27, 43 menu ................................................. 46 Links .............................................. 16, 23 Log file opening .............................................. 72 LostType ............................................. 146

Project comparaison after loading ..................... 73 import ................................................ 65 Rules .................................................. 73 Project configuration ...................... 53, 165

R
Recent files ........................................... 21 Redo .............................................. 22, 57 Reference attributes ............................... 16 References ............................................ 16 Reload ....................................... 21, 32, 35 Reload all .............................................. 21 Remove all marks ................................ 122 Remove marks .................................... 122 Remove marks recursively..................... 122 Rename .......................................... 21, 42 Reports Analysis results ..................... 24, 149, 152 Downstream impact analysis......... 149, 155 Forward impact analysis ........................ 25 Project description................. 24, 149, 153 Rules checking ...................... 25, 149, 157 Synthesis of added information 25, 149, 156 Traceability matrix ................ 24, 149, 150 Upstream impact analysis ....... 25, 149, 154 Reports generation ............................... 149 Reports menu ........................................ 24 Requirement details ......................... 27, 41 menu ................................................. 42 Requirements .................................. 15, 23 Requirements hierarchy .................. 99, 102 Reverse links ................................... 23, 40 Rule check .................................... 78, 139 Rules delete ................................................. 73 deselect all .......................................... 73 select all ............................................. 73

M
Macro-requirements ......................... 15, 99 Management view .................................. 27 Mark all .............................................. 123 Marks .................................. 22, 31, 34, 39 Modification document adding .......................................... 56, 63 Modified elements ................................ 131

N
Name ............................................. 54, 56 Navigate . 23, 29, 31, 34, 39, 42, 47, 58, 134 New ..................................................... 21 Non covering entities .............................. 23 Number of recent files defining .............................................. 70

O
Open .................................................... 21 Open project directory ............................ 21 Options........................................... 24, 69 add new profile .................................... 75 delete selected profile ........................... 75

P
Password .............................................. 50 defining .............................................. 72 Paste......................................... 22, 42, 58 Product work files.......................... 161, 169 Profiles ................................................. 75

S
Save .................................................... 21

User Manual

173

Index

Save as ................................................ 21 Sections ............................................... 15 Show all elements ............................ 38, 39 Show hidden documents .............. 31, 34, 39 Show the covered requirements ............... 46 Snapshot editor Display menu .................................... 134 File menu .......................................... 134 Snapshots comparison ....................................... 135 Delete .............................................. 134 Files ................................................. 165 Properties ......................................... 134 Selected snapshot view ....................... 134 Snapshot of current project ................. 134 subdirectory ...................................... 165 View element history .......................... 134 View snapshots .................................. 134 Sort by default....................................... 42 Sort by identifier .................................... 42 Sort requirements .................................. 46 Sources to target ................................... 56 Stay on top ........................................... 70

TMP environment variable ..................... 167 Tools menu ........................................... 24 Type of analysis ..................................... 54

U
Uncovered requirements ......................... 23 Undefined requirements .......................... 23 Undo .............................................. 22, 57 Update period adding ............................. 70

V
Value ................................................... 55 Variable ................................................ 55 View coverage analysis ................................. 29 graphical............................................. 36 impact analysis .................................... 33 link details .......................................... 43 management ....................................... 27 requirement details .............................. 41 View graph for selection .................... 37, 39 View menu ............................................ 23

T
Temporary files directory ...................... 167 Texts.................................................... 17

Z
Zoom ................................................... 40

174

Reqtify