Working with Labels

A Label tags a version of a file or complete folder structure, allowing you to go back later and retrieve the file or folder based on the label name you gave it, rather than having to remember the version number. Vault Standard’s Labels are similar to Visual SourceSafe labels. Once applied, the label remains associated with the version of the file or folder structure it was labeled at, even as new modifications are made on the original objects.

To activate the Label dialog box, select a file or folder, and then do one of the following:

You can label any version of a file or folder. In the case of a labeled folder, all sub-items of the folder will be stamped with an “inherited” label tag. Any file or folder can be labeled, including $/.

Labels do not increment the version numbers of the object after application. As such, they do not occur as part of a changeset, and always are applied immediately.

The label’s text must be unique regardless of case. This also includes inherited labels. Although a Label’s text must be unique per object, there can be multiple labels associated with one specific version.

Deleted Items

When an item is deleted, the label remains, even though you can’t see the labels applied to an item while it is deleted. However, deleted items that had inherited labels applied to them will be retrieved during a Get Label operation on the ancestor, and will be displayed when viewing the label.

For example, if you label $/foo, then label $/foo/bar, and then delete $/foo/bar, you will not be able to retrieve the label on $/foo/bar (because it is currently deleted, and you can’t get any information on it other than it is deleted). However, getting the label on $/foo will retrieve $/foo/bar as it existed at the time of the label.

When an item is obliterated, any labels applied directly against that item will be removed from the database. Additionally, the obliterated item will be removed from any inherited labels. A Get on a label will not retrieve obliterated items.

Pinned Items

You can label a file that is currently pinned at a previous version and it will be applied to the pinned version, not the current version

Shared Items

You can label a shared file or folder. The label will create the label for the shared object and appear in the history of all shared links.

Because shared items will have labels applied from ancestors of any of its shared links, it is a requirement that label text be unique across all labels applied to any shared item.

Viewing Labels

Select Show Labels to view labels applied to the currently selected file or folder, including inherited labels that were applied above the file or folder.

From the same dialog you can also view labels that have been applied to items below the currently selected folder (e.g., recursively search the tree from this folder downward to find labels that have been applied to sub-files and sub-folders).

Label Promotion

Label Promotion is when you modify the contents of a label. Through Label Promotion, you can change the text of the label as well as the associations of file or folder versions of a specific label.

If the label has been applied to a folder, promotion will allow you to:

  • Add files found in the current version of the source directory, which do not exist in the label’s folder.

  • Change versions of current files found in the label’s folders to previous or later versions.

  • Delete files and sub folders from the label.

Once a label has been promoted, it is no longer associated with a single version of the folder the label was applied to. As such, there are operations that can no longer be performed on the label. These include:

  • Share

  • Branch

  • Pin

Label promotion is accomplished from within the Show Labels dialog.

Copy Label

The Copy Label function allows you to create a new label based on the contents of an existing label.

Copy Label can occur anywhere within a given label path, as long as the provided label sub-path is valid within the label. For example, if a label is applied at $/Parent/child1/child2, you can copy label at child2.

Copy Label honors repository security. If a user does not have RCA rights to a path in a sub-folder of a label, the Copy Label command will not label those folder structures.

To copy a label, right click on a folder or file in the repository tree and select "Show Labels." Right-click on a label in the list of labels and select Copy Label. The Copy Label command is also under the Label menu in Show Labels window.

The Copy Labelcommand is only enabled when a single label is selected on either the Labels or Recursive Labels tab.

Once invoked, the client will display the Copy Label dialog. It will fill in the new label name with the existing label's name appended with "- Copy" in the Label's text box. If you wish, you can enter an alternate name for the label copy and enter a comment. Click "OK" to create the new label.

Note

If a label has been promoted, the newly created label copy will have the same promotion changes as the promoted label, unless a copy of the label was made in a subpath that has not been promoted.