Folder Versions

The Folder Versions dialog box shows all versions of the TOP folder in a list. Each version of a folder corresponds to a changeset that changed some part of the folder or its descendants. This dialog box lists the versions and allows you to view the changeset that caused the folder to increment its version number. For more information, please see History Explorer.

To open the dialog box, select a file or folder, then:

Folder Tree Versions for:

The path of the selected folder is displayed at top. The list shows all the versions for the selected item. The columns include:

  • Version

  • Date

  • User

  • Comment

Select a version to make the controls on the dialog box available. You can also double-click an item in the list to get the details for that transaction.

Close

Click Close to close the Tree Version dialog box.

Details

Click Details to view the Version Details.

Diff

Click Diff to bring up the default Diff Program on two selected versions or to show the diff between that version and its previous version if only one version is selected.

Share

Click Share to bring up the Share dialog box for the selected version of the tree. This will share the folder, then pin the new share link it to the version selected.

Branch

Click Branch to open the Copy Branch dialog box and branch the selected version.

Label

Click Label to open the Label dialog box and label the selected version.

Pin/Unpin

Click Pin to pin the selected version. If the selected version is already pinned, the button will say Unpin. Click Unpin to unpin the selected version.

View Tree

Click View Tree to view the tree at the time of the selected version. This brings up a window with a tree view and file list containing the entire folder tree for that selected version. This allows you to get selected files or folders from within that tree.

Get Tree

Click Get Tree to open the Get Latest Version dialog box. Click OK to download the entire tree associated with the version.

Version List

The Version List displays all changes to the database that match the current query. It displays changes to the repository at the location they happened – it does not list folder versions that cascade up as a result of a change.

Only one entry exists per change, except for shared items. For example, adding a file to the repository lists the file as the change item and does not list all the incremented folder versions up to the root node that happens as a result of the change. If a query includes multiple links in a shared file or folder, all links in the share will report the same action separately.

Recursive operations list history for every item affected. For example, recursively adding an entire folder of files as part of one check in will display every file that was added as a separate entry in this list (unless filtered out by one of the filter criteria).

Double-clicking an item in the list brings up the details of the change.

See the menu items section for information on the menu items available from this dialog.

This list contains the following columns:

  • Name – The item the operation occurs on.

  • User – The user who made the change.

  • Date – The date and time the change was added to the repository.

  • Version – The version number of the file or folder that resulted from the change, if applicable.

  • Action – The action used that created the change to the repository.

  • Comment – The user comment.

The following table lists how actions affect what is displayed in the list.

Action

Parent Folder Action

Item History Action

Add Folder

Add File

Create Folder

Added [item name]

Created

File Check In

(no entry)

Checked In

Delete File

Delete Folder

Deleted [item name]

(no entry)

Undelete File

Undelete Folder

Undeleted [item name]

(no entry)

Obliterate File

Obliterate Folder

“Obliterated [item name]”

(no entry)

Pin File

Pin Folder

Pinned [item name] at version [number]

(no entry)

Move

(To Parent Folder): “Moved [item] from [from folder]”

(From Parent Folder): “Moved [item] to [to folder]”.

(no entry)

Renamed File

Renamed Folder

Renamed [old item name] to [new item name

Renamed from [old item name] to [new item name]

Share File

Share Folder

(Destination folder only):

Shared [repos path of shared item] as [new link item]

 New item lists all history from other share links.

Share Branch File

Share Branch Folder

Branched [item name] from share

Branched from share

Copy Branch File

Copy Branch Folder

Branched [item name] from [trunk item path]

Branched from [trunk item path]

Property Change

(no entry)

[Property name] changed to [new property value]

File Label

(no entry)

(no entry)

Folder Label

(Destination Parent)) Labeled [from item path] as [to item name)

(Source Parent): (no entry)

(Destination Folder) Labeled from [from item path]

(Source Folder) (no entry)

(Every new file/folder created within the destination folder) Labeled from [item path]

For more information, please see History Explorer.