Viewing historical requirement versions

A requirement is automatically versioned when a document snapshot is created and a requirement is modified later.

For example, a document named File Export includes a requirement named Image File Formats. When the first draft of the document is complete, you create a snapshot named Before Initial Review that includes the current version of the Image File Formats requirement. After the review cycle is complete, you modify the Image File Formats requirement. When you save the changes, a version of the old requirement, which is identified in the snapshot as version 1, is created.

You can view historical requirement versions, compare a historical version to the current version or another historical version, or roll back the current requirement version to a historical version.

Requirement versions are read-only and you can only perform the following actions on them:

• Enter requirement review workflow events, such as Review Note and Comment
• View, extract, and open files attached to the current requirement version
• Get, view local copies, and view the history of source control files attached to the current requirement version
• View information about Jira issues attached to the current requirement version

• View, send, and reply to email
• Generate test cases
• Create issues
• Print requirements

1. Click the Versions tab when you are editing or viewing a requirement.

The historical requirement versions are displayed.

2. Select a version and click View to view it.

The requirement version opens. All information in the requirement when the version was created is displayed. Information on the following tabs is limited:

• Overview and Workflow—Displays activities performed on the historical version and previous versions only.
• Traceability—Not displayed. Only the current requirement version can be in requirement relationships and links.
• Files—Displays files and source control files attached to the current requirement version only.
• Folders—Not displayed. Only the current requirement version can be in a folder.
• History—Displays history from the date the requirement was created to the date the version was created only.
• Jira Issues—Displays information about Jira issues attached to the current requirement version only.

3. Select a version and click View Differences to compare it with the current version. You can also select two versions to compare them. See Viewing all changes between requirement versions.

4. If you are editing a requirement, select a version and click Make Current to roll back the current version to the historical version. See Rolling back requirements.

5. Click OK when you finish.