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.

With a StarTeam perspective or view open, choose StarTeam > View > Labels or StarTeam > View > Properties from the main menu. The Properties dialog box opens.
In the Properties 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.
Click New.
The View Label dialog box opens.
Type a name and description for the label. The maximum name length is 64 characters and the description length is 254 characters.
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.
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.
Optionally, to freeze the label so that the revisions attached to it cannot be changed, check Freeze.
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.