Side by Side Version Compare

In Storyteller, you can compare two previous versions of artifacts that don't include the most recent version in a side-by-side view to visualize and report on change.

To compare two previous versions of an artifact:

  1. When viewing the artifact you want to compare previous versions for, click the History tab in the Utility Panel.
  2. Select the two previous versions that do not include the most recent version you want to compare.
  3. Click the Side by Side icon at the top of the History tab.
  4. The Side by Side Compare modal is displayed. It contains separate tabs for the properties, relationships, attachments, document references, and sub-artifacts for both previous versions of the artifact.
    The values displayed are those which differ between versions.
    Each tab displays the following information:

    Tab

    Description

    Properties

    By default, displays any properties that have changed such as Name, Description, and any other additional properties the artifact versions might have.

    Relationships

    Displays the trace discrepancies between the artifact versions. Specifically, this tab presents the artifact ID and name of the trace artifact, in addition to which version contains the trace.

    This is defined with an indicator in the corresponding artifact version column with the trace, and also indicates the direction of the trace according to the following:

    Attachments

    Displays any changes in attachments by illustrating the name of the attachment and which of the two artifact versions that it resides in.

    Document References

    Displays any changes in document references indicated by the name of the document reference and which of the two artifact versions that it resides in.

    Sub-artifacts

    Indicates changes at the sub-artifact level between the two artifact versions. Examples might include the addition of a shape in the Universal Model Editor, or a glossary term change (in the case of a glossary term change, the same tab is labeled as Terms instead of Sub-artifacts).

    The exact change is not displayed, however links to the artifacts are provided so discrepancies can be investigated before a value to restore is selected.

    Summary

    Lists and displays all the values you have selected to restore and the trace direction of any traces being restored.

    Depending on how many values have been changed, some tabs may not display any values, whereas others may not be available. For example, if the artifacts do not contain any sub-artifacts, the Sub-artifacts tab is not available.
    Select the Show only differing values toggle to display only the values that have changed. If the toggle is unselected, the Side by Side Compare modal displays all values for the two artifact versions, with the values that haven't changed in grey.