Viewing quality profiles

For information about the how a quality profile works, see the Understanding quality profiles page.

Retrieving quality profiles

See Retrieving your organizations to access your organization and navigate to Quality Profiles. The Quality Profiles page opens with:

1. On the left-hand side, you will see a list of profile sets by language. Quality profiles inherited from a parent profile are displayed under their parent and with a left indent. This list includes the following columns:

   • The Projects column shows the count of projects associated with a quality profile. Alternatively, it displays DEFAULT when the profile is the language’s default (any profile not explicitly associated with a quality profile is associated with the organization’s default profile).

   • The Rules column shows the total count of active rules within the profile. Additionally, if any of these active rules are deprecated, their number will also be indicated with a pink background.

   • The Updated column shows when the quality profile was last updated.

   • The Used column shows when the quality profile was last used during a project analysis.

2. On the right-hand side, you will see different sections with information relating to details associated with existing quality profiles:

   • The Deprecated Rules section lists the quality profiles that contain deprecated rules.

   • The Recently Added Rules section lists newly added rules and shows whether they are currently active in each profile.

   • The Stagnant Profiles section lists the custom profiles that have not been updated for more than one year.

Viewing a quality profile

On the Quality Profiles page:

1. To view a specific language, select a language in Filter by at the top of the left-hand side list of quality profiles.

2. Select the quality profile you want to view. The quality profile is displayed as illustrated below.

The quality profile page includes the following sections:

1. Inheritance: shows the quality profile with its possible parent(s) and / or children. For each profile, the number of active, inactive, and overridden rules in the profile is shown. Select a number to view the corresponding list of rules.

2. Projects: shows the projects explicitly associated with the quality profile.

3. Rule breakdown: shows statistics about active and inactive rules contained in the quality profile. Select a statistic to view the corresponding rules.

If you have the Administer Quality Profiles permission, you will also see a Permissions section under the Projects section. The Permissions section shows the users and groups authorized to manage this quality profile.

Comparing quality profiles

You can compare quality profiles of the same language.

To compare one profile with another:

1. In the SonarQube UI, retrieve one of the quality profiles you want to compare (quality-profile-1).

2. In the top right corner of the quality profile page, select the three-dot button, and select Compare in the menu. The comparison page opens.

3. In Compare with, select the profile to be compared to (quality-profile-2). The comparison results are displayed on the page as illustrated below. The left column corresponds to quality-profile-1 and the right column to quality-profile-2. In the comparison results, you can select a rule to inspect it.

In the example shown below, the comparison reveals the following differences between the two example profiles: My ABAP profile and Sonar way.

1. In part 1, the first column shows that My ABAP profile includes one rule that Sonar way excludes. In the second column shows that My ABAP profile excludes two rules that Sonar way includes.

2. In part 2, one rule has a different configuration in My ABAP profile that it does in the Sonar way.

Viewing the overridden rules of a quality profile

A rule is considered overridden in a custom quality profile if this profile defines, for this rule, different configurable parameters than its parent quality profile.

To view the overridden rules of a quality profile:

1. Retrieve the quality profile as described above. The number of overridden rules in the profile (if any) is shown in the Inheritance section.

2. Select the <X> overridden rules hyperlink. The list of overridden rules is displayed.

3. In the list, select a rule on the Rules page and navigate to the Quality Profiles section to Change, Revert, or Deactivate the rule completely.

Viewing the change history of a quality profile

1. Retrieve the quality profile as described above.

2. In the top right corner of the profile page, select See Changelog. The profile change history opens and lists the different actions performed on rules in the quality profile:

   • Date: action date.

   • User: user who performed the action.

   • Action: action type (the user activated, deactivated, or updated the rule).

   • Rule: rule on which the action was performed.

   • Updates:

     • For an Updated action: describes the update.

     • For an Activated action: shows the rule’s severity level.

Viewing the projects associated with a quality profile

The Projects section of a quality profile shows the projects associated with the profile. See Retrieving a quality profile above.

Viewing the quality profiles where a rule is active

To view the quality profiles where a given rule is active:

1. See Retrieving your organizations to access your organization.

2. Go to the Rules page and retrieve the rule.

3. In the rule page, navigate to the bottom to the Quality Profiles section. The section lists all quality profiles where the rule is active.

Related pages

• Understanding quality profiles

• Creating a quality profile

• Editing a quality profile

• Associating with projects

• Changing default quality profile

• Maintaining quality profiles

• Granting permissions to users

• Quality profile