Parent page: Managing Lifecycles for Items
A managed content server provides great flexibility for deciding who can make particular state transitions for an Item Revision in that server - the action of transitioning a revision from one state, to another different state, as defined by the lifecycle definition employed for its parent Item. It is possible to prohibit standard (non-administrative) users from transitioning between specific lifecycle states on-the-fly, while opening up permissions to more than just Server Administrators. You have the ability to specify permissions at the global level - as part of global server operation permissions - and also at the individual state transition level. The latter act in conjunction with those settings at the global level, and facilitate fine-tuning of permissions for those more important transitions (for example setting an Item Revision to be Ready for Production).
With various levels of permission control, you can define a lifecycle state transition strategy that adheres to your organization's preferred approach.
Permissions can be defined at two levels:
- Globally - defining which users and/or roles can perform state transitions, for the entire range of defined transitions across all defined lifecycle definitions.
- Locally - specifying permissions at the individual state transition level.
Global State Transition Permissions
Global state transition permissions are defined and managed from within Altium Designer, using the Edit Operation Permissions dialog. Access to this dialog is made from the Data Management - Servers page of the Preferences dialog. For the active server whose permissions you wish to browse/modify, click the Properties control at the right-hand side, and choose the Operations command from the associated menu.
The server operation entry of significance here is Move revision between lifecycle states.
Access and configure, at the global level, who is permitted to perform lifecycle state transitions.
For a new managed content server, the default permission settings for this operation are:
Define additional permissions as required (click the Add button). State transition permissions at this global level can be assigned to the following entities:
- Administrators (itself a defined role).
- Collaborator (this is a user who has edit rights for an Item/Revision).
- Owner (for released data, this is the person who created the initial Item).
- Specific user-defined Role.
- Specific User.
Local State Transition Permissions
Permissions for a particular state transition are defined in the associated State Transition Properties dialog, accessed from the applicable States and Transitions region of the lifecycle definition currently being configured in the Edit Lifecycle Definitions dialog.
To edit the properties of a transition, click to select it, then click on the control, at the far right.
Access controls for defining permissions for the state transition being edited.
The State Transition Permissions field reflects the type of permission control that is to be employed for the transition. While two entries are listed - Controlled and Using Approvals - an Altium 365 Workspace and Altium Concord Pro support only the former.
The Controlled permission type allows you to refine exactly who can perform this transition, through specification of one or more users and/or roles. This type of local permission control is used in combination with permissions set at the global level (see How Permissions are Applied). Use the controls in the region below to define permitted entities accordingly. By default, the Public entity is added, meaning that all users at this local level are permitted to perform the transition.
With Controlled permissions, you can switch from public access, to only those users/roles specified.
How Permissions are Applied
For a user to be able to perform the state transition, the following conditions must be met:
- They must have permission at the global level to Move revision between lifecycle states (defined in the Edit Operation Permissions dialog).
- They must have permission at the local level for this particular state transition.
- They must also be a collaborator for the Item Revision whose lifecycle state is being transitioned (i.e. they must have editing rights).