Integrity Error Types

On this page:

Detected integrity errors

This article lists and describes the configuration error types the Integrity Check app can detect. For example, you can find and resolve duplicate, inconsistent and missing objects, and invalid JQLs. Find the duplicate custom fields in your configuration to speed up your Jira or find the missing objects in filter to improve the experience for your users.

Duplicate object

When there is more than one configuration object of the same type with the same name, this leads to an integrity error. Jira allows creating only custom fields with the same name. The rest of the configuration element types should have unique names.
Having duplicate configuration elements may lead to inconsistent configuration, causing problems to your Jira users with their daily activities or preventing admins from deploying snapshots with Configuration Manager for Jira.

Solution

Rename the object(s) so all the same type elements have unique names.

Inconsistent object

Jira's UI has naming rules for some configuration objects and, as a result, doesn't allow using some characters in the name. Integrity Check registers and shows you an error if it detects an illegal character in a configuration element's name.

Solution

Rename the object so it doesn't contain illegal characters.

Missing object

A reference to a missing configuration element. For example:

  • Notification scheme refers to a "User picker" custom field that is not available on the system.

  • Workflow post-function refers to a missing custom field.

You may have multiple configuration objects referring to the same missing object (custom field, for example). In that case, all the errors related to the missing element will be grouped into one error showing all the references to that object.

Solution

To solve the problem, remove all the references to the missing object or create it so it's available on the system.

Invalid JQL

Invalid JQL can be a part of different configuration elements in Jira. To fix such integrity errors, you first need to correct the invalid JQL. In some cases, you need to edit it directly in the database because you might not be able to perform it from the UI.

Solution

To solve the problem, please correct the JQL entry in the Jira UI. If it is not possible to update it from the UI (you get an error), you need to correct the JQL query directly in the database. For detailed instructions on how to fix invalid JQL entries in different configuration elements, please refer to the following knowledge base article.

Unknown error

An error that does not fall into any of the categories listed above is considered an Unknown error. In that case, you can download a zip file containing information that should help analyze the problem and send it to our support team to help you solve the problem. 

Additional checks

If you need additional checks included in the product, please log an "Additional Integrity Check" issue in our Issue Tracker.