Creating View Labels

View labels can be extremely useful when you want to label every folder and item in a particular view.
  1. Do one of the following:
    • With a StarTeam perspective or view open, choose StarTeam > View > Labels or StarTeam > View > Properties from the main menu.
    • In the Server Explorer, right click on the view node, and choose Labels or Properties from the context menu.
    • In the Navigator or Package Explorers, right click on the project, and choose Properties or Team > Labels.
    The Properties dialog box opens.
  2. In the resulting dialog box, do one of the following:
    • If opened from the Navigator or Package Explorers, expand StarTeam Provider and select Labels (for view).
    • If opened from the StarTeam main menu or Server Explorer, select Labels.
    This View tab lists existing view labels in reverse chronological order, based on the time at which they were created.
  3. Click New to create a new label and add its name to the list box. The View Label dialog box opens.
  4. Type a name and description for the label in the appropriate text boxes. The maximum label name length is 64 characters, and the description length is 254 characters.
  5. Optional: Check Use As Build Label to update each change request that has Next Build as the setting for its Addressed In Build property. If this option is not selected, change requests will still have the view label, but it will not affect the setting of the Addressed In Build property.
  6. Optional: To freeze the label so that the revisions attached to it cannot be changed, check Frozen.
  7. Select one of the following options:
    Current Configuration
    Attaches the label to the tip revision.
    Labeled Configuration
    Attaches the label to the revision with a specified label. The labels are in reverse chronological order based on the time at which they were created.
    Promotion State Configuration
    Attaches the label to the revision currently in a specified promotion state. (Actually, the label is attached to the revision that has the promotion state's current view label.)
    Configuration As Of
    Attach the label to the revision that was the tip revision at a specified date and time.
  8. Click OK.
Note: If you select the current time for the label configuration, it is important to synchronize the dates and times of the computers that run the clients and the server. Otherwise, the labels may not be immediately visible.
Parent topic: Working with Views