Attaching Labels to Items

If you are dealing with an item or set of items that you want to group together, you can create a new revision label, attach an existing label to the item or an item revision, review all labels, or move a revision label.

Note: A Label can be attached to only one revision of an item.

This topic describes how to attach labels to items.

Creating a New Revision Label for Selected Items

To create a new revision label for selected items, do the following:

  1. Select a folder from the folder tree.
  2. Click the component tab containing the items you want to label.
  3. Select one or more items in the upper pane.
  4. Right-click the selected item(s) and choose Labels > New.

    The Attach a New Revision dialog box opens.

  5. Type a name and description for the label. The maximum name length is 64 characters and the description length is 254 characters.
  6. Optionally, check Frozen to ensure that only the selected item revision can have this label.

  7. Indicate what item revision is to receive this label by selecting a configuration option. The choices are:

    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.

Back to top

Attaching an Existing View or Revision Label to Selected Items

To attach an existing view or revision label to selected items, do the following:

  1. Select a folder from the folder tree.
  2. Click the component tab containing the items you want to label.
  3. Right-click the selected item(s) and choose Labels > Attach.

    The Attach a Label dialog box opens. This dialog box lists all existing labels and identifies them as view or revision labels. By default, both the View Labels and Revision Labels options are selected.

  4. Select one or more items in the Server Explorer, any StarTeam Cross-Platform Client view, or in the Eclipse Explorers.
  5. If selecting items from the Server Explorer or a StarTeam Cross-Platform Client view, right-click and choose Labels > Attach. If selecting items from an Eclipse Explorer, right-click and choose Team > Labels > Attach.

    The Attach a Label dialog box opens. By default, both the View Labels and Revision Labels options are selected.

  6. Select a label from the list.

  7. Indicate what item revision is to receive this label by selecting a configuration option. The choices are:

    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.

Back to top

Attaching an Existing View or Revision Label to a Specific Item Revision

To attach an existing view or review label to a specific item revision, so the following:

  1. Select a folder from the folder tree.
  2. Click the component tab containing the items you want to label.
  3. Right-click an item revision in the Label pane and choose Attach.

    The Attach a Label dialog box opens. This dialog box lists all existing labels and identifies them as view or revision labels. By default, both the View Labels and Revision Labels options are selected.

  4. Clear View Labels or Revision Labels to limit the list to one specific type of label.
  5. Select a label from the list.

  6. Indicate what item revision is to receive this label by selecting a configuration option. The choices are:

    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.
  7. Click OK.

Back to top

Reviewing All Labels Attached to Item Revisions

To review all labels attached to item revisions, do the following:

  1. Select a folder from the folder tree.
  2. Click the component tab containing the items you want to label.

  3. Select the item in the upper pane, then click the Label tab in the lower pane.

    This displays the Label pane which shows all revisions for the item.

  4. Right-click a revision in the Label pane to display all of its labels.

Back to top

Moving a Revision Label from One Item Revision to Another

To move a revision label from one item revision to another, do the following:

  1. Select a folder from the folder tree.
  2. Click the component tab containing the items you want to label.
  3. Select the item in the upper pane, then click the Label tab in the lower pane.

    This displays the Label pane which shows all revisions for the item.

  4. Right-click a revision in the Label pane to display all of its labels.
  5. Select a specific label and drag it from one revision to the another.

Back to top