Delete configuration elements

Delete configuration elements

Power Admin for Jira lets you use an advanced and safe delete action to remove configuration elements and manage their dependencies during this operation.

Before Power Admin deletes a configuration element, it searches for its usages, and if they are found, it removes the references from the detected dependent objects. This way, Power Admin securely removes the element and preserves the integrity of your project configurations.

There are specific cases when deleting a configuration element is not safe. For those cases, Power Admin doesn't allow the delete action.

Use cases

Let's review the specific use cases for deleting configuration elements:

Delete is NOT allowed for:

• Locked configuration elements

• Jira default configuration elements

• Priority used by a Jira Service project

• Configuration elements that are used by other objects

Delete is NOT allowed for the following configuration elements in cases where they are used by other configuration elements:

• Permission schemes

• Workflow schemes

• Issue type screen schemes

• Issue security schemes

• Workflows

• Screen schemes

• Issue types

• Issue type schemes

• Priority schemes

• Statuses

• Resolutions

Delete IS allowed for the following configuration elements even if they are used by other configuration elements:

• Notification schemes

• Screens

• Custom fields

• Priorities

Delete configuration elements that are in use

When deletion is allowed for configuration elements that are in use, Power Admin for Jira will take care of updating all references to these elements in order to preserve the integrity of the configuration.

When a notification scheme is deleted:

The notification scheme will automatically be removed from projects that are using it.

When a screen is deleted:

The screen will automatically be removed from screen schemes and workflows that are using it.

When a custom field is deleted:

The custom field will automatically be removed from all configuration elements that are using it:

• Schemes - issues security schemes, permissions schemes, notification schemes.

• Workflows - if there is a condition, validator, or post-function using the custom field, it will automatically be removed from the transition.

• Filter - if a custom field is used in a filter, the part of the JQL that uses the field will be removed to preserve the integrity of the filter.

• Agile Board - the custom field will be removed from all JQLs, card layouts, or issue detail views.

• Dashboard - the custom fields will be removed from columns in gadgets. If the custom field is used in a gadget in any other way, the gadget itself will be removed from the dashboard.

Delete action

1. You can delete a configuration element using the Delete button in the actions bar.

2. You can also delete a configuration element from the Actions column in the table with dependent configuration elements.
   
   

   Open

   

    

Why is the delete button disabled

In cases where the delete action is not allowed (see the Use cases section above), the Delete button is disabled, and there is a tooltip explaining why.

Open

Delete objects that are in use by service projects

Service projects cannot be deleted through Power Admin for Jira, however, objects associated with them can. There are a few corner cases that should be noted when attempting to delete elements that are used by one or more service projects.

Deleting custom fields used by Legacy Automation - IF statements

Power Admin allows you to delete a custom field used in an IF statement in Legacy Automation. If the IF statement contains multiple clauses, the clause containing the custom field will be removed without any issues. However, if the IF statement has only one clause (2), the custom field will still be removed, but its JQL reference will remain in the clause. Additionally, when you go to Legacy Automation, you will see an error (1) for the affected rules.