Suppression Rules

Introduction

When you work on a project, Studio Pro performs consistency checks, which may result in warnings. Warnings identify issues that are not critical, but point to something that might be a problem. These warnings are shown in the Errors pane.

While warnings can be valuable, there are some situations where you might want to disable them, such as the following ones:

• You made a deliberate choice in your project that leads to a warning, and you know this will not lead to problems.
• You are using an Marketplace module that contains warnings and you do not want to change the Marketplace module.
• The number of warnings is so large that the Warnings tab is not usable anymore, and you want to temporarily disable some of them.

With Suppression rules it is possible to disable warnings. You can suppress warnings from the Errors pane and manage them via the Suppression rules option. It is also possible to suppress warnings for all Marketplace modules.

Suppression Rule Logic

Suppression rules are for one user and for one instance of a project. The warnings that you suppress are not shared between users or projects, so warnings will not be suppressed for your team members working on the same project.

Suppression rules are stored locally in the project directory, in a file called project-settings.user.json. When committing your changes to the Team Server, Studio Pro will ignore this file.

However, it is possible to export and import suppression rules manually. For more information on how to export and import warning, see Exporting Your Suppression Rules and Importing Your Suppression Rules sections.

Suppressing a Warning in the Errors Pane

From the Errors pane, you can suppress a warning for a document, a module, or the entire project:

Suppressing a Warning for a Specific Document

To suppress a warning for a specific document only, do the following:

1. Right-click the warning you would like to suppress.
2. Select Suppress this warning > For the document {Document name}.

The warning is only suppressed for the specific document. If the same warning appears in another document (for example, on another page), it will still be displayed for that document.

Suppressing a Warning for a Specific Module

To suppress a warning for a specific module, do the following:

1. Right-click the warning you would like to suppress.
2. Select Suppress this warning > For the module {Module name}.

The warning is suppressed for the whole module. If the same warning appears in another module, it will still be displayed for that module.

Suppress a Warning for the Entire Project

To suppress a warning for the entire project, do the following:

1. Right-click the warning you would like to suppress.
2. Select Suppress this warning > For the entire project.

The warning is suppressed for the whole project and the list of warnings is updated in the Errors pane.

For more information on how to edit or delete a suppression rule, see the Managing Suppression Rules section.

Managing Suppression Rules

You can add, edit, delete, export, or import suppression rules. You can also suppress warnings from the Marketplace.

Suppressing AMarketplace Warnings

To suppress Marketplace warnings, do the following:

1. Click the Suppression rules button in the Errors pane.

   

2. In the Manage Suppression Rules dialog box, check the Suppress warnings from Marketplace modules option.

   

3. Click OK to apply the new setting.

Warnings from Marketplace modules are suppressed.

Adding a Rule

For more advanced cases, you may want to manually add a new rule. This gives you full control over the settings that the rule uses, when deciding which warnings to suppress.

To manually add a new rule, follow the steps below:

1. Click the Suppression rules button in the Errors pane.

2. In the Manage Suppression Rules dialog box, select the New button:

   

3. In the Add Suppression Rule dialog box, set the necessary options to add the rule (for more information on settings, see the Rule Setting section.

   

4. Confirm your choice by clicking OK.

5. Click OK in the Manage Suppression Rules dialog box to save your changes.

The suppression rule is created.

Editing a Rule

To edit an existing rule, follow the steps below:

1. Click the Suppression rules button in the Errors pane.

2. In the Manage Suppression Rules dialog box, select the Edit button:

   

3. In the Edit Suppression Rule dialog box, edit options to change the rule (for more information on settings, see the Suppression Rule Settings section.

   

4. Confirm your choice by clicking OK.

5. Click OK in the Manage Suppression Rules dialog box to save your changes.

The suppression rule is edited.

Deleting a Rule

To delete the existing rule, follow the steps below:

1. Click the Suppression rules button in the Errors pane.

2. In the Manage Suppression Rules dialog box, click the Delete button:

   

The suppression rule is deleted.

Importing Suppression Rules

To import suppression rules, do the following:

1. Click the Suppression rules button in the Errors pane.

2. In the Manage Suppression Rules dialog box, select the Import button:

   

3. Browse to the folder where you would like to import (the file extension that you are importing must be .suppressions.json).

4. Click Open to select the file.

5. In a confirmation pop-up window, click OK to dismiss it:

   

6. Click OK in the Manage Suppression Rules dialog box.

The list of warnings is updated.

Exporting Your Suppression Rules

To export your suppression rules, do the following:

1. Click the Suppression rules button in the Errors pane.

2. In the Manage Suppression Rules dialog box, select the Export button:

   

3. Browse to the folder where you wish to export the rules (by default the file name is <your app name>.suppressions.json).

4. Click the Save button to save the exported rules.

5. In a confirmation pop-up window, click OK to dismiss it:

   

6. Click OK in the Manage Suppression Rules dialog box.

Your suppression rules are exported. Another user can import that file to use the same suppression rules.

Suppression Rule Settings

The table below describes the available settings:

Read More

• Errors Pane
• Consistency Errors