If you store a Project Folder on a shared drive then more editors can edit different documents exclusively at the same time. For instance, one editor can edit a system requirements specification document while another editor is editing a system verification document.
The easiest option is to set up a file share service using Server Message Block (SMB) file-sharing protocol on a Windows or Linux server in your local network. This configuration will result in the best performance and the highest security when the server is behind a firewall.
We do not recommend mapping a network drive connected using WebDAV protocol (such as SharePoint or OneDrive) because of very poor performance.
Background applications for automatic synchronization with cloud file sharing services such as Google Drive, Dropbox, OneDrive, and Box can cause unpredictable file locking issues and thus they are not supported.
When you open a Project Folder, all documents are open in Read Only Mode , which is indicated by icon. To switch a document into Exclusive Edit Mode, which allows an editor to modify the document, click Document and select Start Editing Document, or press CtrlShiftE.
Save your changes to the Project Folder after you modify the document so that another user can refresh the project. To switch back to Read Only Mode when you finish editing the document, click Document and select Finish Editing Document, or press CtrlShiftE.
Note: Project documents are unlocked as soon as you close the project or save the project into a different Project File or Project Folder. The shared Project Folder must be connected to close the project and release all locks.
To see changes from other team members, click Project and select Refresh Project, or press CtrlR. To refresh projects opened from a folder automatically on app startup, enable the Edit > Preferences > Refresh project folders on startup option.
You can manage versions of your ReqView projects in SVN, which is a very popular centralized open-source version control system (VCS) adopted by many customers because of its simplicity and robustness. Because SVN supports a centralized locking mechanism it prevents edit conflicts of document files. Therefore it is more suitable than Git, the most popular distributed VCS.
The SVN workflow in ReqView is very easy to use. It enables team collaboration even with non-technical users, who cannot use an external SVN client. With SVN workflow you can cover following steps:
Before using the SVN workflow from ReqView you (or your network administrator) should install SVN on your computer, set up a SVN repository and import your requirements project into the SVN repository, see SVN Administration.
You should save login credentials to SVN when connecting to the SVN repository the first time because ReqView does not store any passwords. If you use Tortoise SVN client then simply open the Repo-browser and in the SVN Authentification dialog enable Save authentification option.
You can also log in to an SVN repository by
svn info command:
$ svn info --username <user_name> --password <password> <svn_repository>
You can list all saved login credentials by
svn auth command.
You can check out a ReqView project from the SVN repository to a local working copy from ReqView or using
svn checkout command.
To check out the project from ReqView, click File, and select Check out from SVN. In the Check out Project from SVN dialog enter the URL of the trunk branch in the SVN repository, choose an empty folder for the working copy, and press OK.
To check out the project from the command line, switch to the parent folder of the working copy, and run:
$ mkdir <reqview_project> $ svn checkout <svn_repository>/trunk <reqview_project>
To open an SVN working copy in ReqView, click File and select Open Folder. When the open project is managed in SVN, you will see icon in the top right corner of the screen.
To display the SVN information about the SVN working copy and the last version stored in the SVN repository, click Project and select SVN Information:
The workflow for editing a project managed in an SVN repository is very similar to exclusive edit mode of Project Folder:
Enter Exclusive Edit Mode for a document by clicking Document and selecting Start Editing Document
Edit the document
Leave Exclusive Edit Mode for the document by clicking Document and selecting Finish Editing Document
Enter a commit message in the Commit Changes dialog and press OK to commit project changes to the SVN repository:
To commit project changes anytime during editing, click File and select Commit to SVN or click button in the top right corner of the screen. Note that ReqView commits project changes to SVN automatically after adding or removing a document, changing project traceability, or reordering documents.
To update the open project by changes from other users, click Project and select Refresh Project.
Advanced SVN users can also take advantage of an external SVN GUI client or SVN command line tool to do the following operations:
To display the SVN log of changes, open Revision Log dialog in TortoiseSVN or use
svn log log command:
$ svn log
To create an SVN tag from your working copy, open Copy (Branch / Tag) dialog in TortoiseSVN or use
svn copy command:
$ svn copy . "^/tags/<tag_name>" -m "Create baseline"
To checkout a SVN tag to another SVN working copy <project_baseline>, open Checkout dialog in TortoiseSVN or use
svn checkout command:
$ svn checkout <svn_repository>/tags/<tag_name> <project_baseline>
To open the project baseline in a new application window, click File, select Open Folder and choose folder <project_baseline>.
To compare the latest state of the project with a SVN tag, click Project, mouseover Compare Project, select Compare Folder, and choose folder <project_baseline>, see Compare Projects.
If you manage ReqView projects in another VCS than SVN (such as Git) you need to use external tools to resolve edit conflicts, for instance Meld text comparison tool:
To minimize edit conflicts, use the following collaboration guidelines:
For example, you can collaborate with reviewers as long as they change only reviewState and reviewComment attributes.