Configuring Promotion States

When creating promotion states, many administrators assign <current> to the initial promotion state instead of a view label, because that state always uses the tip revisions. They also often assign <current> to later promotion states for which no view labels currently exist. These states may receive a view label later, when the files associated with a view label meet the criteria required by the state. Alternatively, a view label may be promoted from the preceding state to the label-less state.

In this topic:

Creating a New Promotion State

To create a new promotion state, do the following:

1. Choose StarTeam > View > Promotion from the main menu.

   The Properties dialog box opens.

2. Select the Promotion node.

   The Promotion page of the Properties dialog box displays the states currently created for this view. The final state displays at the top of the list.

3. Click View > Promotion.

   The Promotion dialog box displays the states currently created for this view. The final state appears at the top of the list.

4. Click Add to open the Promotion State dialog box.
5. Type the Name and Description of the promotion state.

6. Assign a view label to this state by selecting it from the View Label drop-down list.

   The labels are listed in reverse chronological order, based on the time at which they were created. You can change the label when appropriate by using this dialog box or assign it to the next state by promoting it.

7. Click OK to close the Promotion State dialog box, and OK again to close the Promotion dialog box.

Back to top

Editing or Deleting a Promotion State

To edit or delete a promotion state, do the following:

1. Click View > Promotion.

   The Promotion dialog box displays the states currently created for this view. The final state appears at the top of the list.

2. Select a promotion state.

3. Click Edit.

   The Promotion State dialog box opens.

4. Modify the Name, Description, or View Label.
5. Click OK to close the Promotion State dialog box, and OK again to close the Promotion dialog box.

Back to top

Moving the Promotion State Up or Down

To move promotion states up or down, do the following:

1. Click View > Promotion.

   The Promotion dialog box displays the states currently created for this view. The final state appears at the top of the list.

2. Select a promotion state from the list and click Move Up or Move Down.

Back to top

Modifying Access Rights of a Promotion State

To modify access rights of a promotion state, do the following:

1. Click View > Promotion.

   The Promotion dialog box displays the states currently created for this view. The final state appears at the top of the list.

2. Select a promotion state from the list and click Access Rights.

   The Promotion State Access Rights dialog box displays.

3. Do one of the following:

   • Click Add to specify a group or specific user to grant or deny specific access privileges. Check the specific access rights and select Grant or Deny.
   • Select an existing user or group and change which access privileges they have.

Back to top