Jaa


Get the history of an item

TFS 2017 | TFS 2015 | TFS 2013

Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015 | Visual Studio 2013

One advantage of a version control system is that you can look back in time to get detailed information about what changes have been made to your files. Team Foundation version control maintains historical data related to every version of every file that has ever been checked in.

Often when you look over the history of a file, folder, or branch, you are trying to solve a problem or answer a question. By using the Team Foundation version control History window, you can more easily resolve questions and situations such as the following:

  • What changes have been made in the past weeks or months?

  • What work item was completed by this change to the file?

  • Who checked in this change? What did they say about the change? What did they change?

  • Unexpected changes occurred in this file, causing a bug in an area of the product that we thought was stable. Who made this change, and why did they make it?

  • A change in this branch fixes a bug that also needed to be fixed in other branches. How can I make sure that the change was merged to those branches?

Use the History window to get detailed historical data about a project, branch, folder, or file.

Prerequisites

You must be one of the Contributors for your project. To learn more, see Default TFVC permissions.

To display the History window:

  • In Source Control Explorer, select an item, open its shortcut menu, and then choose View History.

    Tip

    You can customize the position of the window by right-clicking the title and then choosing one of these options: Float, Dock, or Dock as Tabbed Document.

  • Use the History Command.

The History window displays the historical data about the item in two tabs:

  • The Changesets tab lists every change (including edits, renames, and merges) made to the item.

  • The Labels tab lists every label that has been applied to the item.

Changesets Tab

The Changesets tab displays detailed data about every change that has been made to an item. All changesets that have modified the item are listed in a table that includes the following columns:

  • Changeset The ID of the changeset.

  • User The name of the user who checked in the changeset.

  • Date The date and time the changeset was checked in.

  • Comment The comment entered by the user who checked in the changeset.

Note

If you open this window by using the History command and you are displaying data about a project, branch, or folder, then the history of children items (for example, the files contained by a folder) is shown only if you use the /recursive option.

If the item is a file, then additional data is displayed in the following columns:

  • Change The types of changes that were made to the file with the changeset. Examples of values that can appear in this column include add, edit, rename, and merge.

  • Path The path to the file.

Tip

Sometimes you need to share this kind of data with someone else. You can select one or more rows from the table in the Labels tab, right-click them, click Copy to copy the data to the clipboard, and then paste the data into an e-mail message, document, or spreadsheet.

Common Tasks

By using the Changesets tab, you can perform the following tasks:

Task

Supporting content

View the item as it existed when the changeset was checked in: Double click the changeset or right-click it, and then click View. (This command is available only if the item is a file.)

None

Get more details about a changeset: Right-click a changeset and then click Changeset Details to get information such as:

  • Other source files that are part of the changeset.
  • Work items associated with the changeset.
  • Any check-in notes left for reviewers.

Compare a past version with the current version: Right-click a changeset and then click Compare.

Compare a past version with another past version:

  1. Select a changeset.
  2. Press and hold the CONTROL key and then select the second changeset.
  3. Right-click the second changeset and click Compare.

Get a past version of the item: Right-click a changeset and then click Get This Version to download the past version of the item to your workspace.

View which users made specific changes within a file: Right-click a changeset and then click Annotate. (This command is available only if the item is a file.)

Get more details about a merge: If the changeset resulted from a merge change, you can expand this item. Expand the node to display the changesets that were merged into this item from another branch. (This command is available only if the item is a file.)

None

Get more details about changes that were made before a rename change: If the changeset includes a rename change, you can expand this item. Expand the node to display the changesets that occurred before the rename change was made.

None

View other branches to which this changeset has been merged: Right-click the changeset and click Track Changeset.

Roll back changes from one changeset Select a single changeset and choose Rollback Entire Changeset.

Roll back changes from two or more consecutive changesets Select a set of consecutive changesets and choose Rollback.

Display non-recursive history of a folder You can get this data only from the command prompt.

Labels tab

All labels that have been applied to the item are listed in a table that includes the following columns:

  • Name The name of the label.

  • User The user who applied the label.

  • Date The date and time the label was applied.

  • Changeset The changeset to which the label applies.

  • Comment The comment made by the user who applied the label.

Note

When you display historical data about a project, branch, or folder, the data about labels applied to children items (for example, the files contained by a folder) is not shown.

 

Tip

Sometimes you need to share this kind of data with someone else. You can select one or more rows from the table in the Labels tab, right-click them, click Copy to copy the data to the clipboard, and then paste the data into an e-mail message, document, or spreadsheet.

Common Tasks

Task Supporting content
View the item as it existed when the labeled changeset was checked in: Right-click a label and then click View. (This command is available only if the item is a file.) None
Edit the label: Right-click the label and click Edit Label. Use labels to take a snapshot of your files
Delete the label: **Right-click the label and click **Delete Label. Use labels to take a snapshot of your files
Compare a past version of the item with the current version: Right-click a label and then click Compare to compare a past version of the item with the current version. Compare files Compare folders
Get a past version of the item: **Right-click a label and then click **Get This Version to download the past version of the item to your workspace. Download (get) files from the Server
View other branches to which the labeled changeset has merged: **Right-click the label and click **Track Changeset. (This command is available only if the item is a file.) View where and when changesets have been merged
View which users made specific changes within the labeled version of a file: Right-click a changeset and then click Annotate. (This command is available only if the item is a file.) View file changes using annotate