ReqView projects are organized into one or more documents grouping the same type of project artifacts. For example, high-level stakeholder requirements, system requirements, software requirements, tests, or risk registers.
Each project in your organization should have a unique ID (for example “ReqView”). Also, all documents within a project should have a unique ID (for example “SRS” or “TESTS”).
A document consists of document objects organized into a tree hierarchy with numbered sections, similarly as in a Word document. Document objects are identified by an automatically generated unique ID and consist of a section heading, a rich text description, and a discussion.
For each document, you can define additional custom attributes, thereby extending information about document objects. For example, for requirements you can define a status attribute allowing management of requirements lifecycle.
A traceability link represents a relationship between document objects stored in the same project. You can define several types of traceability links for a project. For example, “satisfaction” type for links from downstream requirements to the related upstream requirements, “verification” type for links from verification tests to the related requirements, and so forth. It is important to maintain the way of linking to ensure consistent traceability reports.
The following diagram illustrates the structure of a typical SW development project with two traceability levels:
Level 1 Document:
Level 2 Documents:
Traceability Links Types:
The following diagram illustrates the structure of a typical system development project with three traceability levels:
Level 1 Documents:
Level 2 Documents:
Level 3 Documents:
Types of Traceability Links:
ReqView stores current project data in a persistent local application storage and automatically restores the project state after application restart. Note: No project data are sent to the Internet unless you explicitly upload your project to Google Drive.
Save the current project on your local or network file system either as a Project Folder or a Project File. The project is saved in JSON format (see ReqView Open File Data Format), the advantage of which is that the data are human readable. You do not need to install any database server. The JSON files can be easily managed in a Version Control System (VCS), such as SVN, GIT, HG.
A Project Folder stores all project data in separate files. The folder contains a project.json file with configuration of project documents and traceability.
Each document is stored as a separate file in the document's subfolder, and each attachment file is stored in the attachments subfolder. The following image shows a sample Project Folder structure on the file system:
ReqView Project Folder
| project.json
|
+---attachments
| SRS-326_0_ReqView File Data Format.pdf
| SRS-40_0_Overview.png
|
\---documents
NEEDS.json
SRS.json
TESTS.json
The advantage of Project Folders is that they keep the project documents and attachments separated on the file system. Storing Project Folders on a shared drive enables team collaboration by more editors, see Shared Drive.
A Project File stores all project data (configuration, document objects, attachments and traceability links) in a single file with .reqw extension so that you can easily send it by email or share it to the cloud.
To open a Project Folder, click File and select Open Folder, or press CtrlO. Similarly, to open a Project File, click File and select Open File.
Each open project is displayed in a separate application window. To edit the current project in another application window, click Project and select New Project Window. Place the new window on another monitor or place both application windows side-by-side to review and edit the project conveniently.
The application saves the last position of each application window and restores it after it is restarted.
All your modifications of an open project are automatically saved to the local application storage and restored when the application is restarted. To save the current project to the file system, click File and select Save, or press CtrlS.
Note: ReqView Web Application will save a new Project File into the browser download folder because it cannot directly access your file system from security reasons.
To save the current project as a new Project Folder stored on your file system, click File and select Save As Folder, or to save it as a new Project File click File and select Save As File. In the Save Options dialog, you can choose a new project ID and check Save History option to store the history of all requirement changes with the project.
You may prefer to uncheck Save History option if you manage the saved project in a version control system (such as SVN or GIT) that stores the history of changes externally.
Warning: Unchecking Save History will limit the following features after reopening the project:
To close the current project while leaving the current application window open, click Project and select Close Project. Then, you can open another project in the same window. You can also close the project by closing all application windows of the project.
Note: Closing the last application window will quit the application and the current project will be restored when the application is started next time.
To create a new project, click Project and select Create Project. In the Create Project dialog, choose a preferred type of the created project and enter a unique project ID:
For more information about predefined document templates see Requirements Document Templates.
After the new project is created, you can add more documents in the new project as described in the next section. You can also adjust configuration of traceability link types, see Requirements Traceability Links > Configure Project Traceability.
Note: To ensure project consistency, you cannot change project and document IDs in the application .
To create a new document, click Project and select Add Document. In the New Document dialog, choose a preferred type of the document, enter a document ID unique in the project and a document name:
After the new document is created, you can adjust the document structure or further customize document attributes, see Custom Document Attributes.
To open a document, open the Project left pane listing all documents (already open documents are shown in bold cursive) and click on the desired document ID. The open document is displayed as a new tab placed at the bottom of the requirements table. You can change order of document tabs by drag & drop.
To open all documents in the current project, click Project and select Open All Documents or click the Open All Documents button displayed in the center pane under the “No document is open.” message.
To close a document, click on the icon of the corresponding document tab or press CtrlW shortcut.
To delete the current document, click Project and select Delete Document.
Note: All traceability links involving the deleted document are removed from the project.
To change the order of currently open documents, simply drag & drop the document tabs displayed under the requirements table.
To change the order of documents in a project persistently, click the button located in the Project pane toolbar and reorder documents in the Reorder Documents dialog.
Note: If your project was opened from a Project File, then the new order is saved when you save the Project File. However, if your project was opened from a Project Folder, then the new order is immediately saved into the Project Folder to minimize editing conflicts.
For detailed information about configuring project traceability, see Requirements Traceability Links > Configure Project Traceability.
You can reuse the structure and custom attributes configuration of a document by saving the document as a Document Template file. Document Templates preserve the document hierarchy, section headings, text description of objects, and the value of custom attributes. However, Document Templates do not store object IDs, discussion, history, or any traceability links.
To save the current document as a Document Template file, click File, mouseover Save As Template, and select Current Document. Name the file and click OK. Then share the file on a network drive.
To create a new document from a Document Template file, click Project, select Add Document and choose Custom Template option in the New Document dialog.
Note: All document objects stored in Document Templates are assigned new IDs in the cloned document.
Tip: If you define a custom Document Template with an xhtml
custom attribute with help
flag set to true
then you can provide for each document section detailed instructions, which the application displays in the Instructions pane, see Custom Attributes > Examples > Instructions for an example.
You can reuse the whole configuration of a project by saving the project as a Project Template. Project Templates store a collection of Document Templates and traceability links configuration.
To save the current project as a Project Template file, click File, mouseover Save As Template, and select Project. Name the file and click OK.
To create a new project from a Project Template file, click Project, select Create Project and choose Clone Project option in the Create Project dialog.
Browse the example Demo Project illustrating how to manage user needs, software requirements specification, risks, tests and high-level design for a SW product.