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 and download files attached to the current requirement version
  • View paths to 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
  • Run requirement reports from the Run Report area in the Actions menu

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

The historical requirement versions are displayed.

2. Click a version 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:

  • 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.
Click Diff with current to compare the historical requirement version with the current version. See Viewing all changes between requirement versions.

3. Expand a version to view the document snapshots it is included in. See Viewing requirement document snapshots.

Click the Expand All button to expand all versions or the Collapse All button to collapse expanded versions.

4. 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.

5. 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.