Surround SCM stores all of the activities performed on a source file. You can view a file’s history and work with a historic version of the file.
1. Select a file and choose Activities > History.
The History dialog box opens. If you select an image file, it is displayed in the lower right corner for Add, Check In, Promote, Rebase, and Rollback events. Click the Thumbnail button to view thumbnails.
Note: You can change the columns in the History dialog box. To display a column, right-click a column and select the column you want to add from the menu. Click and drag the column to change its location. To hide a column, right-click a column and select the column you want to hide. The Version and Action columns cannot be hidden.
2. Select a Filter by user option. You can view actions performed by a specific user or all users.
The System user is used by triggers to change workflow states and custom field values.
3. Select a Filter by action option. You can view specific actions, only actions that changed the file contents, or all actions performed on the file.
4. Select Additional events to display all file workflow events, custom field values, or label events.
5. Expand the parent branch file history for Add from branch and Rebase events, or child branch file history for Promote from events.
File changes in the ancestor branch after the add, promote, or rebase are not included.
Tip: The file version changes when you check in, promote, and rebase files. Select the File contents changed filter to view files with content changes.
6. Select a file version and click a button to perform an action.
| Button | Action |
|---|---|
|
|
View history details for the selected version. See Viewing file history details. |
|
|
View differences for the selected versions. See Viewing file differences. |
|
|
Generate a report of differences between versions. See Generating file differences reports. |
|
|
Retrieve a copy of the selected version. See Getting files. |
|
|
Check out the selected version. See Checking out files. |
|
|
View the selected version. See Viewing files in Surround SCM. |
|
|
Edit the file. See Editing files in Surround SCM. |
|
|
Revert to a previous file version. See Rolling back files. |
|
|
View branches that contain changes made in the selected version. See Tracking duplicated changes. |
|
|
Review changes made in the selected version. See Reviewing changes between file versions. |
|
|
Add the selected version to a code review. See Adding files to code reviews. |
|
|
View code reviews for the selected version. See Viewing code reviews files are included in. |
|
|
Attach the selected version to an item in TestTrack item or an external issue tracking tool. See Attaching source files to TestTrack items or Attaching source files to external issues. |
|
|
View the TestTrack item the selected version is attached to. See Viewing TestTrack items. |
|
|
View the committed changelist. This option is only enabled if the action was performed as part of a changelist. See Working with committed changelists. |
|
|
Set the workflow state for the file. See Changing workflow states. |
|
|
Label the selected version. See Labeling files. |
|
|
View labels applied to the selected version. See Viewing labels. |
7. Click Close when you finish.
Note: You can also view removed file history. Select a repository and choose Activities > Properties. Click the Removed Items tab. Select a file and click History.