How to Detach a Label from Deleted Files.



How to Detach a Label from Deleted Files.


Information in this Brief applies to:

  • StarTeam 4.x to 2005


When a file is deleted from StarTeam which has labels attached to it (on any historical revision), the file will be visible when accessing a view configuration based on that label. While this is by design (because the file was indeed present at the time of the label), sometimes this is not the desired behavior. This article details how to effectively remove a label from deleted files.


To detach a label from deleted files, follow the below steps:

  1. Open the view containing the label you wish to detach from deleted files.
  2. Select View -> Labels, and click "New".
  3. Enter "Temp" as the label name, and leave the other options at their defaults ("Current configuration", and "Use as build label"). Click OK to create the label.
  4. Right-click on the root folder of the view and select Labels.
  5. Select the "Temp" label and click "Detach". This will detach the label from all folders and files in this view.
  6. With the root folder still selected, click "All Descendants" to show all files in the view.
  7. Right-click on a file in the upper-right pane and select Select -> By Label.
  8. Select the label you wish to detach from the deleted files and click OK. This will select/highlight all the (non-deleted) files in the view that have the label attached.
  9. Right-click on one of the highlighted files and select Labels -> Attach.
  10. Select the "Temp" label.
  11. In the section "Attach to items at", choose "Labeled Configuration", and then select the label to be removed in the drop-down list.
  12. Click OK, and the "Temp" label will be attached to all the (non-deleted) files in the view which have the previous label, at the appropriate historical revisions.
  13. Either delete or rename the previous label, and rename the "Temp" label to the previous label"s name.
Old KB# 28338
Comment List