Creating View Labels

View labels, usually used as build labels by default, can be extremely useful when you want to label every folder and item in a particular view.

To create a view label, do the following:

  1. Open the view to which you want to apply the label.
  2. Choose View > Labels.

    The Labels Properties dialog box opens.

  3. Click New.

    The View Label dialog box opens.

  4. Type a name and description for the label. The maximum name length is 64 characters and the description length is 254 characters.
  5. Select one of the following:

    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.

  6. Optionally, 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, the view label will still be attached to change requests, but the setting of the Addressed In Build property will not change.
  7. Optionally, to freeze the label so that the revisions attached to it cannot be changed, check Freeze.
  8. Click OK.

Note: It is always important to synchronize the dates and times of the computers that run the StarTeam clients and the StarTeam Server. However, if they are not synchronized and you select the current time as a label's configuration, the label may not be immediately visible.