Viewing Item History

Purpose

View the history of an item to see the various transactions that have occurred such as revision creation, or actioning. The revision history shows when an item was revised and the person who created the revision. The action history shows when an item was actioned and the person who actioned it.

In the desktop client, you can view an item's pedigree to see how successive revisions of an item are related in time and origin. The pedigree shows all events, including branches and merges. You can also view the item’s deployment history in the Deployment tab of the web client by clicking the Deployment history button.

PRIVILEGES  No privilege required.

To view the history of an item:

  1. In an Items list, select the item.

  2. Select Item | History.

NOTE  You can compare the content of item revisions from this dialog box. For details, see Comparing Item Revisions and Files.

The History dialog displays the history of various operations that have been performed on the item, such as checked in, actioned, or exported into another project.

NOTE  In some circumstances, Dimensions CM may create pseudo merge entries in the history. This will occur, for example when a revision is created in a branch from a revision on another branch, and then the next revision is created from a revision on a different branch.

To filter the content of the Item History dialog box:

  1. From the Filter list select a category.

  2. In the Filter box enter the text string that you want to use as a filter. The item history list is filtered to only include entries that contain that string.

To filter the content of the Item History dialog box based on the Change Type:

  1. From the Filter list click Change Type and unselect a change type that you want to remove from the item history list. To include the change type again, reselect it.

  2. Repeat step 1 to unselect additional change types.

  3. To reselect all change types select All changes.

To filter the content of the Item History dialog box based on a date range:

  1. To only display entries in the list from a specified date, select the From check box and select the date.

  2. To only display entries in the list up to a specified date, select the To check box and select the date.

To sort the content of the Item History dialog box based on the columns:

Click the column header to sort by that column. Click the column again to reverse the sort order.

To add or remove columns from the display in the Item History dialog box:

Right-click the column header and select a field from the list to either hide or display that column. Fields already displayed have a tick against them.

To view the deployment history of an item:

Click the Deployment History button. This will take you to the web client Deployment tab with the History tab displayed showing deployment/build event entries for the item.

To compare item revisions:

Do one of the following:

See Comparing Item Revisions and Files for further details.

To open one or more item revisions in a new window:

Select the item revisions, right-click, and select Open new window.

To view the pedigree of an item:

Right-click and select Pedigree.

You see the item in the Pedigree window.

Related Topics

Selecting Items

Working in the Pedigree Window