Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Installing the Add-on

The Delegated Project Admin Pro for JIRA add-on is available in the Atlassian Marketplace. It can be installed via the Universal Plugin Manager in JIRA.

Once the add-on has been installed and a valid license has been supplied, a JIRA administrator Administrator can access the Delegated Project Admin configuration pages by choosing Add-ons from the JIRA administration menu and then locating the Delegated Project Admin section in the left sidebar.

Selecting what to delegate

The first step in configuring the Delegated Project Admin Pro add-on is to adjust the settings on the Select What to Delegate screen to indicate which configuration types can be modified by your delegated project administratorsDelegated Project Administrators.
 

There are 2 possible modes for delegating certain aspects of project configuration to delegated project administratorsDelegated Project Administrators, as noted by the left and right sections of the screen:

  1. Basic "Guided Path", which allows them to switch a project from one scheme to another.
  2. Full "Self-Service", which allows them to define customize a "Process Template", which is a set of configuration options controlling the issue types, fields and workflow that can be applied to a project. These configuration options include switching from one scheme to another and also editing a scheme to customize its behavior In Self-Service mode, the Delegated Project Administrator can also edit the Notification and Permission Schemes to customize them as desired.

The changes resulting from Self-Service mode can have a more significant impact on a project than Guided Path mode. Hence, it is best to use caution when configuring Self-Service mode. That being said, the Delegated Project Admin add-on ensures each change individual changes – from either mode – can be rolled back by a JIRA administrator Administrator or a delegated project administratorDelegated Project Administrator.

An administrator A JIRA Administrator can choose to delegate only via Guide Path mode, only Self-Service mode, or both. Please note that your selections on this screen will not be put into effect until you have selected your delegated project administrators Delegated Project Administrators on the Select Who to Empower screen.

Guided Path

For each scheme type shown in the Guided Path section, click the  icon to open a Delegation screen:
 

From this screen, you can configure which options are available to delegated project administratorsDelegated Project Administrators

  • None (Delegation disabled) - This will disable delegation for this particular type of scheme.
  • All existing schemes - This will allow delegated project administrators allows Delegated Project Administrators to select from all of the relevant schemes in your instance.
  • Exclude only specific schemes - This allows the JIRA administrator you to select which of the relevant schemes SHOULD NOT be available for delegated project administrators Delegated Project Administrators to select from.
  • Include only specific schemes - This allows the JIRA administrator you to select which of the relevant schemes SHOULD be available for delegated project administrators Delegated Project Administrators to select from.


When "Exclude only specific schemes" is selected, you can select each desired scheme in the "Select schemes to exclude" dropdown and they will appear at the bottom of the popup.

Click the Image Removed icon next to Once a scheme to remove it from the listhas been added to the list, it can be removed by clicking the adjacentImage Added icon.


When "Include only specific schemes" is selected, you can select each desired scheme in the "Select schemes to include" dropdown and they will appear at the bottom of the popup.

Click the Image Removed icon next to Once a scheme to remove it from the listhas been added to the list, it can be removed by clicking the adjacent Image Added icon.

Click Close when you are through making changes. This screen will be dismissed and the Select What to Delegate screen will be updated to reflect your selections.

Continue clicking the Image Added icon for each remaining scheme type shown in the Basic "Guided Path" section to ensure its delegation is set as desired.

Self-Service

The As mentioned above, a Process Template is a set of configuration options controlling the issue types, fields and workflow that can be applied to a project. In the Self-Service section allows you to select which issue types, fields, workflows, statuses, and groups , the items shown for Issue Types, Fields, Workflows and Statuses are used within a Process Template and indicate what will be available for your delegated project administrators Delegated Project Administrators to select from when adjusting their own a Process Templates Template while in Self-Service mode.

Note that the Self-Service section on this Select What to Delegate screen does not list any schemes. This is because Self-Service effectively allows your delegated project administrators to build what we refer to as a Process Template – a collection of whichever items in this section you choose to delegate – that can be applied to a project to govern its behavior.

For each of these items, click the Image Removed icon Projects can have one or more Process Templates associated with them. For instance, you may have a project that supports multiple issue types. Three issue types use one set of field and the fourth issue type has a different set of fields. In this scenario, two Process Templates would be needed in order to ensure the appropriate behavior is carried out for the project.

The Groups item is used within Process Templates. Instead, it indicates what groups, if any, should be available for your Delegated Project Administrators to select from when editing Permission Schemes or Notification Schemes while in Self-Service mode.

Click the Image Added icon for any of the items shown in the Self-Service section to open a Delegation screen:

 

From this screen, you can configure which options are available to delegated project administratorsDelegated Project Administrators

  • None (Delegation disabled) - This will disable delegation for this particular item.
  • All existing <items> - This will allow delegated project administrators Delegated Project Administrators to select from all of the relevant items in your instance.
  • Exclude only specific <items> - This allows the JIRA administrator you to select which of the relevant items SHOULD NOT be available for delegated project administrators Delegated Project Administrators to select from.
  • Include only specific <items> - This allows the JIRA administrator you to select which of the relevant items SHOULD be available for delegated project administrators Delegated Project Administrators to select from.


When "Exclude only specific <items>" is selected, you can select each desired item in the "Select <items> to exclude" dropdown and they will appear at the bottom of the popup.

Click the Image Removed icon next to Once an item to remove it from the listhas been added to the list, it can be removed by clicking the adjacentImage Added icon.

When "Include only specific <items>" is selected, you can select each desired item in the "Select <items> to include" dropdown and they will appear at the bottom of the popup.

Click the Image Removed icon next to Once an item to remove it from the listhas been added to the list, it can be removed by clicking the adjacentImage Added icon.

Click Close when you are through making changes. This screen will be dismissed and the Select What to Delegate screen will be updated to reflect your selections. Continue clicking the Image Added icon for each remaining item shown in the Full "Self-Service" section to ensure its delegation is set as desired.

When you are through configuring what to delegate, click Select what who to delegate for those you've empowered at empower for each delegation approach at the bottom of the screen to move to the next step.


Selecting who to empower

sThe Select Who to Empower screen is where you will identify the project administrators who can perform actions against the items you selected on the previous screen.
Image Added 

In order to perform delegated administrative functions on a given project, a user must fall into one these categories:

  1. User Type: JIRA Administrator, which refers to members of the jira-administrators group. Members of this group do not have to have the "Administer Project" permission.
  2. User Type: Project Administrator, which refers to someone with the "Administer Project" permission.
  3. User Type: Trusted Project Lead, which refers to someone with the "Administer Project" permission AND who has been set as the Project Lead. 
  4. Group: <groupname>, which refers someone with the "Administer Project" permission AND who is a member of the named group.

These first 3 categories appear on this screen by default. The fourth – Group: <groupname> – must be added for each group you wish to empower, by clicking Add a 'Trusted Adin Group' to empower.

As you can see, there is one column pertaining to Guided Path mode and (in blue) many columns pertaining to Self-Service mode. For each row, select the checkboxes that correspond to the type of project administration functions you want to delegate. When you are through making changes, click Save to save your changes or click Cancel to discard them.

Guided Path

In the Basic "Guided Path" section, each checkbox indicates the type of scheme that the Delegated Project Administrator will be able to switch to another existing scheme. Note that the checkboxes in this section have no effect unless you have delegated that type of scheme on the Select What To Delegate screen.

Self-Service

The Full "Self-Service" section is, by its very nature, more complicated. Here is what each checkbox means:

CheckboxDelegation It AllowsUI available to
Delegated Project Administrators
on the main Self-Service screen,
when checkbox is selected 

Types of Activity that
Delegated Project Administrators
can rollback via History popup (Image Added),
when checkbox is selected 

Self Service: EnableEntering and exiting Self-Service mode
  • Image Added (in Guided Path mode)
  • Image Added (in Self-Service mode)
  • N/A
Process Templates: CustomizeRenaming, cloning, or removing a Process Template
  • Image Added to rename the Process Template
  • Image Added to clone and customize the Process Template
  • Image Added to remove the Process Template
  • There is no History and Rollback capability for Process Template changes. However, to restore a project to its previous configuration as it stood prior to entering Self-Service mode, the Delegated Project Administrator can click the Exit Self-Service Mode button.
Issue Types: SelectAdding or removing an Issue Type
  • Image Addedto add an Issue Type
  • Image Added to remove an Issue Type
  • All Issue Type-related activity that has occurred will be visible in the History popup.
  • All activity listed in the Delegation It Allows column can be rolled back.
Fields: SelectAdding or removing a Field from the Create, Edit and View screens.
  • Image Addedto add a Field
  • Image Added to remove a Field
  • All Field-related activity that has occurred will be visible in the History popup.
  • All activity listed in the Delegation It Allows column can be rolled back.
Fields: EditMaking a Field required or optional, adding or removing a Field from the Create/Edit/View screens, and reordering a Field on the Create/Edit/View screens.
  • Image Added to edit the Field to make it required or optional, add or remove it from the Create/Edit/View screens, or reorder it on the Create/Edit/View screens
  • All Field-related activity that has occurred will be visible in the History popup.
  • All activity listed in the Delegation It Allows column can be rolled back.
Workflow: SwitchAssociate the project with another existing Workflow
  • Image Added to switch the Workflow
  • All Workflow-related activity that has occurred will be visible in the History popup.
  • All activity listed in the Delegation It Allows column can be rolled back.
Workflow: EditAdd a step/transition to the Workflow, edit the Fields available on the transition screen, reorder the Fields available on the transition screen
  • Image Addedto add a step/transition to the Workflow
  • Image Added to remove a Workflow step
  • Image Added to edit or reorder the Fields available on the transition screen
  • All Workflow-related activity that has occurred will be visible in the History popup.
  • All activity listed in the Delegation It Allows column can be rolled back.
Groups: SelectAllow the referencing of a Group or Group Custom Field Value (within a Permission Scheme or Notification Scheme), as long as a field of that type was delegated in the Fields section of the Select What To Delegate screen.
  • N/A
  • N/A
Notifications: EditEdit a Notification Scheme to add or remove notification recipients
  • Image Added to edit a Notification Scheme
  • N/A
Permissions: EditEdit a Permission scheme to grant or revoke a permission
  • Image Added to edit a Permission Scheme
  • N/A


Anchor
TrustedGroup
TrustedGroup
Adding a Trusted Admin Group to empower