Promotion State Access Rights
This topic describes access rights for promotion states.
Overview
Each view has its own set of promotion states. Access to these states is controlled by the “Define promotion model” right, which is available from the
View node of the
Access Rights dialog at the view and project levels. A user with the
Define promotion level
right can do anything to the promotion model, for example create and delete states, edit their properties, promote a label from one state to another. Promotion is a subset of editing properties. Anyone who can edit the properties of a state can also promote that state and reorder the states within the view.
Access rights that govern access to individual promotion states.These Generic object rights and Promotion state specific rights are available from the Promotion State node of the Access Rights dialog at the view and project levels. They also appear on the access rights for individual promotion states. The rights for an individual promotion state are checked at the state level; if necessary, the checking continues at the view level and eventually the project level. If a user is granted a given right at one level, there is no need to check the next.
When a right is granted at the view level, it applies to all states in the view, unless access is denied at the state level. When a right is granted at the project level, it applies to all the states in all the views within the project, unless access is denied at the state or view levels.
Generic object rights
Change object access rights |
Change the access rights for an individual promotion state. If you change this setting, be sure that you remain one of the users who can change access rights. This right is a generic object right. After creating a promotion state, you must exit and reenter the Promotion dialog if you want to set access rights for the newly created state. |
Promotion State specific rights
Modify label assignment |
Change the label assigned to an individual state either by clicking the Promote button or editing the label property. No other properties for the state can be edited unless the user also has the Define promotion model access right from the View node. This right is a promotion state specific right. |
Setting Promotion State Access Rights at the Project or View Level
Setting promotion state access rights is very similar to setting other access rights. The access rights can be set at the project or view level as well as for individual promotion states.
To set promotion state access rights at the project or view level, do the following.
-
Select Project > Access Rights or View > Access Rights.
The Access Rights dialog box opens.
- Select the View node.
- Click Add. The Assign Access Rights To dialog box opens.
-
Select a user or group. Users are listed by their user names and groups are listed by their paths (excluding the All Users group).
-
Select Grant and click OK.
Caution: Never select Deny unless you are creating an exception. Deny records must be created before grant records.
-
Select/clear the appropriate check boxes. Selecting or clearing the check box for a category, such as Generic object rights for a project, selects or clears all the access right check boxes for that category. The category check box has only two states. When it is cleared, the access right check boxes for that category are either all cleared or mixed: some selected and some cleared.
Caution: Clicking Delete removes the selected user or group from the User and Groups list in the Access Rights dialog box. The selected user or group loses any previously set access rights to the Server.
- Click OK.
Setting Access Rights for Individual Promotion States
To set access rights for individual promotion states, do the following:
-
Select View > Promotion.
The Promotion dialog box opens.
- Select a promotion state from the list.
Note: You can create the promotion state in the Promotion dialog box. However, you must click Apply before you can set access rights. After you click Apply (or close and reopen the dialog), the Access Rights button is enabled.
-
Click Access Rights.
The Promotion State Access Rights dialog box opens.
-
Click Add.
The Assign Access Rights To dialog box opens.
-
Select a user or group. Users are listed by their user names and groups are listed by their paths (excluding the All Users group).
- Click OK.