Introduction

At the core of the measurement mechanisms that are used during an analysis is the Assessment Model: a set of rules, sizing/quality measures and distributions in a hierarchy of parent Technical Criteria and Business Criteria that are used to grade an Application and to provide information about any defects (code violations) in the Application's source code. The set of rules, sizing/quality measures and distributions are predefined and preconfigured according to established best practices, however, it is possible to modify some aspects in order to match your own environment, for example:

• The weight (i.e. "importance") of a rule in its parent Technical Criterion. This value can be changed if some contributions are thought more or less important in a given context.
• The criticality of a rule (i.e. whether the rule is considered "critical" or not in a given context). This allows you to "threshold" the grade of the aggregated rule with the lowest grade of its "critical" contribution.
• Whether a rule is enabled or disabled in the next analysis.

Need for homogenity

Modifying the Assessment Model is considered standard practice, however, these updates must be performed with care as the legitimacy of trend and comparison information greatly depends on the methodology you use for the update. If the Assessment Model is not homogeneous over time then context and assessment information cannot be compared. Even for one-shot assessments, users will tend to compare assessment results - outside of the dashboard context - from their previous experiences. Homogeneity is therefore as important in this one-shot perspective as in a multiple assessment perspective and you should proceed with care.

Available options

The Assessment Model options are available under the Config option:

Click to enlarge

On accessing the option, a list of Business Criteria (also known as Health Factors) are displayed:

Click to enlarge

Clicking a Business Criteria will reveal a list of child contributing Technical Criteria (by default 10 rows are listed, further rows are displayed using the pagination options at the bottom of the list):

Click to enlarge

Clicking a Technical Criteria will reveal a list of child contributing rules that are triggered during an analysis/snapshot:

Making changes to the Assessment Model

Locate the rule you want to change (either in the list or using the search option) and then make the necessary changes, for example:

Click to enlarge

Applying the changes

Any changes you make will not be applied until a new analysis is run. You can start a new analysis direct in the Assessment Model page, see also Application onboarding with Fast Scan - re-run deep analysis - optional:

Click to enlarge

Shared customization option

When the Share Assessment Model Settings option is enabled (see Administration Center - Settings - Assessment Model Strategy), two things will occur:

• Users with the Application Owner role (whether at Global or Resource level) will no longer be able to make any changes to the Assessment Model for any application managed in Console (the settings in the  Application - Config - Assessment Model page are visible but cannot be modified).
• Any rule that is customized and shared across all Assessment Models will have an icon displayed as shown below:

Update Assessment Model option

This option is only available if your login has been granted the ADMIN role:

This option is aimed at the following scenarios:

• You want to perform a complete reset of your Assessment Model and apply an uncustomized Assessment Model based on the default Assessment Model delivered with AIP Core and the currently installed extensions.
• You have installed a new release of an extension and you want to ensure that all changes to weight, criticality, thresholds etc. that are implemented in the new release of the extension are applied in the next snapshot. Ordinarily, when a new release of an extension is installed AND that extension includes an Assessment Model fragment which includes changes to weight, criticality, thresholds etc., Console will NOT apply the changes since the policy is to reduce the impact on analysis results. The Update Assessment Model option therefore provides a means to apply the changes provided in the extension release.

This option will perform the following actions:

• create a brand new Assessment Model using a combination of the base Assessment Model delivered with AIP Core on the Application's Node, and the Assessment Model fragments delivered with the currently installed extensions for your Application.
• apply this new Assessment Model for all future snapshots you action

You will need to generate a new snapshot to ensure that the new Assessment Model is applied and used.