On this page:

Target Audience:

  • Consumers of the information (i.e. those that will be using the CAST Application Engineering Dashboard)
  • CAST AI Administrators

Summary: This page provides instructions for managing Exclusions in the CAST Application Engineering Dashboard.

Introduction

The CAST Application Engineering Dashboard features the ability to Exclude objects from a future snapshot - this can be useful when the object is violating an AIP Quality Rule, but is irrelevant:

Note that:

  • using the Exclude feature will affect grades when a new snapshot is generated or when a snapshot is consolidated. This is because the violations that are excluded will not be included in the new results. This impact will be seen in the CAST Application Analytics Dashboard - CAST AAD.
  • Exclusions are available when viewing data from a previous snapshot, however, the ability to edit Exclusions is only available from the most recent snapshot.

Permissions required to manage Exclusions

FeaturePermission required

To edit Exclusions - i.e. add/remove objects.

Your user login must have the EXCLUSION_MANAGER role.

Notes:

  • Roles can be assigned at user level (when using Default Authentication mode) or via user or group (when using Standard LDAP authentication). Please see CAST-AED - Configuring user authentication for more information.
  • You can view Exclusions in read-only mode if your user login has not been assigned the required role.

Accessing the feature

To access the feature, there are two methods:

From the "home" or landing page, click the default Exclusion tile.


From the Side Menu bar, click the following icon:

The focus will be set to the Actions tab when using this icon - click into the Exclusions tab:



Exclusions

Note that using the Exclude feature will affect grades when a new snapshot is generated or when a snapshot is consolidated. This is because the violations that are excluded will not be included in the new results. This impact will be seen in the CAST Application Analytics Dashboard - CAST AAD.

Two sub-pages are available in the Exclusion tab:

You can swap between the two sub-pages using the drop down menu:

Example of Scheduled exclusion sub-page:

Note that when violations are listed in the Active Exclusions sub page, the total number of exclusions is displayed in blue:

Column key

The following columns are available for both sub-pages:


This check box allows you to manage the violation. A Manage button will appear when a violation is ticked:

Active ExclusionsScheduled Exclusions

This Manage button allows you to:

  • Update the Comment and Priority given to a violation when it was added to the scheduled Exclusion list
  • Remove the violation from the active or scheduled Exclusion list (see CAST-AED - Exclusion management).
  • Add the related violations to the Action Plan (scheduled Exclusion list only)

Note that:

  • the check box is only visible if your login has the EXCLUSION_MANAGER role
  • the Add the related violations to the Action Plan option requires the QUALITY_MANAGER role
Status

Displays the status of the violation in the Exclusion list:

  • To add > the violations has been added to the Exclusion list since the last full snapshot or consolidation action was processed - it will be excluded in the next full snapshot or consolidation action
  • To remove > the violation was previously in the Active Exclusion list and has been manually removed. The violation will be taken into account once again in the next full snapshot or consolidation action and will then move out of the Exclusion list entirely (see CAST-AED - Exclusion management).
Note that this column is only visible in the Scheduled Exclusions list.
CommentDisplays the free text comment assigned to the violation when it was added to the Exclusion list. This comment can be modified using the check box and Manage button.
RuleThe name of the Quality Rule for which the violation has been added to the Exclusion list (violations can appear multiple times in the Exclusion list).
Object Name LocationThe name of, and information about the violation that has been added to the Exclusion list.
Last Update

The date the violation was last updated - i.e. any of the following:

  • added to the Exclusion list
  • comment edited

This icon, when clicked, will take you direct to the Source Code page for the violation in question.

Note that this column is only visible in the Scheduled Exclusions list.

Use this option to export the contents of the Scheduled or Active Exclusion list to an Excel file. See Exporting data to Microsoft Excel file format for more information.

Note that all columns are sortable (in ascending/descending alphabetical/numerical order) by clicking the column header.

Adding violations (objects) to the Exclusion list



Note that you can add multiple violations to the Exclusion list in one go:

Note also that if there are many violations, a Show More button will be displayed (this is to improve the performance of the display). If there are many violations in the Action Plan, a Show More button will be displayed (this is to improve the performance of the display). You can choose to display more using the various options (+10, +100 etc.). By default an upper maximum of 5000 violations is set when the "All" option is clicked. You can change the upper maximum if required (see the violationsCount option in CAST-AED - Dashboard wide configuration options in json).

Removing violations (objects) from the Exclusion list

If you would like to remove a violation that has already been added to the Exclusion list, you can do so as follows:

Updating comments for violations (objects) that are already present in the Exclusion list

If you have added specific violations to the Exclusion with a specific comment, you can alter the comments directly, without having to remove the violation from the Exclusion and then re-add it. You can do this from the Exclusion list itself - note though that it is only possible to update comments from the Scheduled Exclusion list.

Note that if you select multiple violations for comment update and these violations have different existing comments, then the new comment you enter will apply to all the selected violations, replacing the existing comment.