Concept

Welcome to Integrity Check for Jira

Integrity Check for Jira is an app that helps you identify and resolve any configuration errors in your Jira instance. It is available as a standalone app and as a feature bundled with Configuration Manager for Jira (CMJ).

Its goal is to identify, report, and resolve Jira configuration problems that prevent you from performing your day-to-day activities. For example, you might have broken filters referring to missing configuration elements like custom fields. In this case, you won't be able to view the issues matching the filter. That’s where Integrity Check comes in handy, helping you fix all your configuration errors.

Resolving configuration errors in your Jira also helps improve the performance and efficiency of the entire system.

When Integrity Check is used as part of Configuration Manager for Jira, it allows you to find and resolve the problems with your Jira configuration, which prevents you from creating or deploying broken Configuration Manager snapshots.

Detect configuration errors in Jira

Integrity Check for Jira detects missing elements that are referred to by other elements in your configuration, for example (but not limited to):

  • References to missing custom fields, groups, or users in workflows (conditions, validators, post functions).

  • References to missing custom fields, groups, or users in JQL queries.

  • References to missing users and groups in project roles.

  • References to missing events.

Integrity Check verifies the consistency of all supported objects in a Jira configuration, including filters, agile boards, and dashboards.

With this app, you can run integrity checks on the whole Jira system (System scope), selected projects (Project scope), or the last failed snapshot (Snapshot scope, available only with Configuration Manager for Jira).

Learn more about the different Integrity Check scopes in the next section.

Integrity Check scopes

You can run Integrity Check for Jira for three different types of configuration scopes:

  • System Scope - System scope allows you to run an integrity check on the entire configuration of your Jira instance. You can find and resolve all the configuration integrity errors in your Jira system.

  • Project Scope - Project scope allows you to run an integrity check on the configuration of a single project or sub-set of projects. This way, you can quickly locate the errors in a project or several projects in your Jira without running a check on the entire configuration.

  • Snapshot Scope (only with Configuration Manager for Jira) - When using Integrity Check as part of Configuration Manager for Jira (CMJ), you can use the snapshot scope. It allows you to run an integrity check on the last failed snapshot to discover the root cause of your configuration errors.

A gif that showcases the three different types of integrity checks - system scope, project scope, and snapshot scope.

Jira instance integrity

If your instance contains integrity errors, you'll not be able to create or deploy CMJ snapshots that have those errors within their scope. However, if Integrity Check detects something missing, like a workflow that is not used by a particular project, you will still be able to create a snapshot of this project.

Integrity errors and quick fixes

When Integrity Check for Jira detects errors in your configuration, it shows a list of the detected violations. You can click on each violation to learn more about the configuration problem by reviewing its details. In addition, the app shows the error location and a link to navigate to the object directly.

There are different error types you can detect and resolve with Integrity Check for Jira. For more information about the errors detected by Integrity Check, visit Integrity error types.

Quick fix actions

Integrity Check for Jira gives you practical tools to fix detected configuration errors automatically. In addition, the app offers you quick fix actions for the most common problems you might face in a Jira configuration. These quick fixes allow you to resolve configuration problems with a single click.

For more information about this feature and a list of the supported actions, visit Quick fix.

Â