Comparing Requirements and Revisions

Comparing Requirements and Revisions

Overview

The comparison features of EaseRequirements provide a way to compare the values of corresponding fields of different revisions of a requirement, as well as the values of corresponding fields of different requirements. In certain cases, it also provides a way to overwrite fields from past revisions or from different requirements.

The comparison features are accessed from the Revisions section of the detail view of a requirement, where two revisions of a requirement can be selected for comparison.

User Interface

The Revision Comparison dialog shows either two revisions of one requirement or two revisions of different requirements, with the values of the corresponding fields displayed side by side, allowing the differences between the values to be easily viewed. Display options are available to configure the view as desired. For example, there is an option to display only fields with different values. An arrow placed between requirements can be used to copy values between different revisions of requirements.

Textual differences between values are shown using red and green highlighting:

  • Deleted text is highlighted in red.

  • Added text is highlighted in green.

  • Replacements are shown as a combination of red highlighted text (the old value) followed by green highlighted text (the new value).

The display of textual differences is disabled for RTE fields when using this option.

Images are displayed with a placeholder for past revisions and baselined revisions, since Jira does not track attachment history.

Operations

Purpose

Action

Purpose

Action

Compare different revisions of the same requirement

  • Select the check boxes of two revisions of a requirement in the Revisions section of the detail view of a requirement.

Overwrite the current value of a field with the value of a revision

  • Select the check box of the current revision of one requirement and the checkbox of another revision in the Revisions section of the detail view of a requirement.

  • Select the arrow in the Copy Value column of the desired field in the Revision Comparison dialog.

Compare revisions of different requirements

  • Select the check boxes of two revisions of a requirement in the Revisions section of the detail view of a requirement.

  • Select the two desired requirements in the Revision Comparison dialog.

  • Select the desired revisions of the requirements.

Overwrite the current value of a field with the value of a revision of a different requirement

  • Select the check boxes of two revisions of a requirement in the Revisions section of the detail view of a requirement.

  • Select the two desired requirements in the Revision Comparison dialog.

  • Select the revision of one of the requirements with the desired value.

  • Select the appropriate arrow in the Copy Value column of the desired field.

If the current revisions of both requirements are selected, the values can be copied in either direction.

Options

Display Fields

Use this dialog to select the desired fields for comparison. Select Reset to return the selection of fields to the default.

The selection is not retained after closing the tool.

Show changes only

Select this option to hide fields that have the same value.

Visual

Select this option to render wiki markup.