Detaching Labels

This topic describes how to detach labels.

Detaching a Label from a Rolled-back View

Sometimes you need to detach a label from an item in a rolled-back view. For example, suppose you deleted a file that had view labels attached to it. Later you created a build label based on one of the view labels that was attached to the deleted file. If you roll back the view to the new build label in order to perform a build, the deleted file reappears in your view. If you do not want that file in this build, you can detach the new build label from that file. If you try to detach any other label from the rolled-back view, an error message informs you that you can detach only the label to which the view has been rolled back.

Note: You can attach and detach any labels from items in current view configurations, but you cannot see deleted items in those configurations. You can detach view labels from deleted items only if you roll back the view to a configuration based on the label you want to detach.

To detach a label from a view that has been rolled-back to a previous revision, do the following:

  1. Click a component tab in the upper pane and select an item.
  2. Click the Label tab in the lower pane.
  3. Right-click the label you wish to remove and choose Detach.
  4. Click OK.

The item from which the label is detached will disappear after a refresh.

Back to top

Detaching a Label from a Specific Revision

If you decide not to include certain items in a view or revision label, you can detach the label from those items individually or as a group. Generally, the items from which labels are detached are files or folders.

To detach a label from a specific item revision, do the following:

  1. Select a folder from the folder tree or in the upper pane on the Folder tab.
  2. Click a component tab in the upper pane and select an item.
  3. Click the Label tab in the lower pane.
  4. Expand a revision in the Label pane to see all labels attached to it as children of the revision.
  5. Right-click the label you wish to remove and choose Detach.
  6. Click OK.

Back to top

Detaching Labels from Folders

If you decide not to include certain folders in a view or revision label, you can detach the label from those folders.

Note: You can attach and detach any labels from items in current view configurations, but you cannot see deleted items in those configurations. You can detach view labels from deleted items only if you roll back the view to a configuration based on the label you want to detach.

To detach a view or revision label from a folder and its contents, do the following:

  1. Right-click the folder in the Folder Tree or on the Folder tab and choose Folder > Labels to open the Labels dialog box.

    This dialog box lists the labels currently attached to this folder.

  2. Select the label to be detached from the folder.
  3. Click Detach.
  4. Optionally, if you are detaching a revision label, select one of the following options:

    • Folder Only
    • Folder And Items Contained In Folder
    • Everything In Subtree Rooted At Folder
  5. Click OK.

Note: When you detach a view label from a folder, the label is automatically detached from the items that the folder contains. It is also automatically detached from the child folders and their contents.

The folder from which the label is detached will disappear after a refresh.

Back to top

Detaching Labels from Items

If you decide not to include certain items in a view or revision label, you can detach the label from those items individually or as a group. Generally, labels are detached from files or folders.

Note: You can attach and detach any labels from items in current view configurations, but you cannot see deleted items in those configurations. You can detach view labels from deleted items only if you roll back the view to a configuration based on the label you want to detach.

To detach a view or revision label from selected items, do the following:

  1. Select one or more items in the Server Explorer or in one of the Eclipse Explorers.
  2. Select a folder from the folder tree or in the upper pane on the Folder tab.
  3. Click a component tab in the upper pane and select an item.
  4. Right-click the selected items and choose Labels > Detach.

    The Detach a Label dialog box opens and displays all existing labels, identifying them as view or revision labels. By default, both View Labels and Revision Labels are selected.

  5. Optionally, clear either View Labels or Revision Labels to limit the display list to a specific type of label.
  6. Select a label from the list.
  7. Click OK.

Back to top