CAST AIP 8.2.x Documentation
Page tree
Skip to end of metadata
Go to start of metadata
On this page
Useful links

Platform administration information

Assessment Model adaptation

Assessment Model adaptation designates all the changes that one can perform on the existing configuration.

Please refer to the Assessment Model enrichment chapter to handle the addition of new indicators.

Quality Model review [and adaptation to your context]

To perform these checks:

  1. Open the targeted Assessment Model (cf. Assessment Model configuration access)
  2. Select the Quality Model tab:

Business Criteria review [and adaptation]

  • Select the Business Criteria sub-tab:

  • Successively select each Business Criterion

  • Review the Active and Detached status of each criterion:

Active status > If an item is deactivated, it and any sub items (Technical Criteria/Quality Rules etc.) belonging to it will no longer be taken into account during the snapshot generation process.This is designed to be a temporary action, i.e. it can be changed easily and quickly between snapshots.

Detached status > The Detach option will "cut" the links the current item has to all its immediate child items (i.e. Technical Criteria) in the Grade Contributors tab and the item will no longer be included in the snapshot calculation. Note that this option cannot be reversed using the "Attach" option, as such the item will lose all links to any immediate child items.

  • Review the list of contribution in the Grade Contributors sub-sub-tab: aggregation weight, critical contributions:

Starting with AIP 7.1

The Business Criteria are edited in their own editor (as opposed to embedded editor in 7.0.x releases) to ease the readability.

  • If a Technical Criteria is missing, add a new Grade Settings using the Add button, then select the criterion you require from the Technical Criteria in-line drop-down list and adjust the weight and critical contribution option:

  • If you do not require a contribution, delete the Technical Criterion

Technical Criteria review [and adaptation]

Select the Technical Criteria sub-tab:

  • Successively select each Technical Criterion
  • Review the Active and Detached status of each criterion:

Active status > If an item is deactivated, it and any sub items (Quality Rules etc.) belonging to it will no longer be taken into account during the snapshot generation process.This is designed to be a temporary action, i.e. it can be changed easily and quickly between snapshots.

Detached status> The Detach option will "cut" the links the current item has to The Detach option will "cut" the links the current item has to all its immediate child items (i.e. Quality Rules/Distributions/Measures) in the Grade Contributors tab and all its immediate parent items (i.e. Business Criteria) in the Grade Impacts tab. In addition, the item will no longer be included in the snapshot calculation. Note that this option cannot be reversed using the "Attach" option, as such the item will lose all links to any immediate parent/child items.

  • Review the list of contributions in the Grade Contributors and Grade Impacts sub-sub-tabs: aggregation weight, critical contribution

Starting with AIP 7.1

The Technical Criteria are edited in their own editor (as opposed to embedded editor in 7.0.x releases) to ease the readability.

  • If a Business Criteria is missing from the Grade Impacts sub-sub-tab, add a new Grade Settings using the Add button (the GUI will take you back to the Business Criterion tab), then select it from the Business Criteria in-line drop-down list and adjust the weight and critical contribution option.

  • If a Quality Rule, Distribution, or Measure is missing from the Grade Contributors sub-sub-tab, add a new Grade Settings using the Add button, then select it from the Quality Rule, Distribution, or Measure in-line drop-down list and ajust the weight and critical contribution option:

  • If you do not require a contribution, delete the entry

Quality Rules review [and adaptation]

Select the Quality Rules sub-tab:

  • Successively select each Quality Rule
  • Review the Active and Detached status of each item:

Active status > If an item is deactivated, it will no longer be taken into account during the snapshot generation process.This is designed to be a temporary action, i.e. it can be changed easily and quickly between snapshots.

Detached status> The Detach option will "cut" the links the current item has to all its immediate parent items (i.e. Technical Criteria) in the Grade Impacts tab and the item will no longer be included in the snapshot calculation. Note that this option cannot be reversed using the "Attach" option, as such the item will lose all links to any immediate parent items.

Quality indicators that require a configuration and mutually exclusive quality indicators are delivered inactive so as not to disturb the quality assessment if not properly configured.

  • Review the list of contributions in the Grade Impacts sub-sub-tab: aggregation weight, critical contribution:

Starting with AIP 7.1

The Quality Rules are edited in their own editor (as opposed to embedded editor in 7.0.x releases) to ease the readability.

  • If a Technical Criteria is missing in the Grade Impacts sub-sub-tab, add a new Grade Settings using the Add button (the GUI will take you back to the Technical Criterion tab), then select it from the Technical Criteria in-line drop-down list and adjust the weight and critical contribution option:

  • If you do not require a contribution, delete the entry
  • With Advanced audience option activated, review the list of Contextual Parameters used in the Parameters sub-sub-tab:

The Contextual Parameters tab (at the same level as the Quality Model tab) lets you also review all Contextual Parameters at the same time.

  • With Advanced audience option set, review the list of compliance-to-grade thresholds used to turn rule compliance percentage into the 1 to 4 grade in the Grade Thresholds sub-sub-tab:

Remember:

  • the thresholds have to be distinct and strictly ascending or descending
  • using below 0% or above 100% thresholds is allowed to support never-4 or never-1 grade policies (e.g.: configure the model so that even 100% non-compliance gets you a 2 at most by picking 101% and 100% for the last two thresholds)

Quality Distributions review [and adaptation]

With Advanced audience option set, select the Quality Distributions sub-tab:

  • Successively select each Quality Distribution
  • Review the Active and Detached status of each item:

Active status > If an item is deactivated, it will no longer be taken into account during the snapshot generation process.This is designed to be a temporary action, i.e. it can be changed easily and quickly between snapshots.

Detached status> The Detach option will "cut" the links the current item has to all its immediate parent items (i.e. Technical Criteria) in the Grade Impacts tab and the item will no longer be included in the snapshot calculation. Note that this option cannot be reversed using the "Attach" option, as such the item will lose all links to any immediate parent items.

  • Review the list of contribution in the Grade Impacts sub-sub-tab: aggregation weight, critical contribution:

Starting with AIP 7.1

The Quality Distributions are edited in their own editor (as opposed to embedded editor in 7.0.x releases) to ease the readability.

  • If a Technical Criteria is missing from the Grade Impacts sub-sub-tab, add a new Grade Settings using the Add button (the GUI will take you back to the Technical Criterion tab), then select it from the Technical Criteria in-line drop-down list and adjust the weight and critical contribution option:

  • If you do not require a contribution, delete the entry

  • Review the list of Contextual Parameters used in the Parameters sub-sub-tab:

The Contextual Parameters tab (at the same level as the Quality Model tab) lets you also review all Contextual Parameters at the same time.

  • Review the list of split share-to-grade thresholds used to turn distribution split share percentage into the 1 to 4 grade in the Settings sub-sub-tab upon selection Grade Thresholds sub-sub-sub-tab of each one of the four categories:

Remember:

  • the thresholds have to be distinct and strictly ascending or descending.
  • using below 0% or above 100% thresholds is allowed to support never-4 or never-1 grades policies
  • Category Position is used to identify the sequence of situations to avoid the most (1st Category contains objects in a situation you want to avoid the most, while the 4th Category contains objects in the situation you want to be the most)

Quality Measures review [and adaptation]

With Advanced audience option set, select the Quality Measures sub-tab:

  • Successively select each Quality Measure
  • Review the Active and Detached status of each item:

Active status > If an item is deactivated, it will no longer be taken into account during the snapshot generation process.This is designed to be a temporary action, i.e. it can be changed easily and quickly between snapshots.

Detached status> The Detach option will "cut" the links the current item has to all its immediate parent items (i.e. Technical Criteria) in the Grade Impacts tab and the item will no longer be included in the snapshot calculation. Note that this option cannot be reversed using the "Attach" option, as such the item will lose all links to any immediate parent items.

  • Review the list of contribution in the Grade Impacts sub-sub-tab: aggregation weight, critical contribution:

Starting with AIP 7.1

The Quality Measures are edited in their own editor (as opposed to embedded editor in 7.0.x releases) to ease the readability.

  • If a Technical Criteria is missing from the Grade Impacts sub-sub-tab, add a new Grade Settings using the Add button (the GUI will take you back to the Technical Criterion tab), then select it from the Technical Criteria in-line drop-down list and adjust the weight and critical contribution option:

  • If you do not require a contribution, delete the entry

  • Review the list of Contextual Parameters used in the Parameters sub-sub-tab:

The Contextual Parameters tab (at the same level as the Quality Model tab) lets you also review all Contextual Parameters at the same time.

  • Review the list of value-to-grade thresholds used to turn measure value in the Grade Thresholds sub-sub-tab:

Remember:

  • the thresholds have to be distinct and strictly ascending or descending

Consolidation Settings review [and adaptation]

With Advanced audience option set, select the Consolidation Settings sub-tab:

  • Review the option value:

Remember:

Default behavior is "simple average" for which each Module has the same weight as any other when it comes to computing Application-level grade

Non-default behavior are available to tune the model so that the most critical Modules weights more when it comes to computing Application-level grade (or the "largest" using any Sizing Measure or any Background Facts if uploaded).

E.g.: suppose you have Application A composed of Module M1 and M2; Module M1 contains 100 artifacts and features a grade of 3.00 for a given Quality Rule while Module M2 contains 300 artifacts and features a grade of 2.00 for the same Quality Rule; when you select the "number of artifacts" as a consolidation mode, Application A will feature a grade of 2.25 based on the following computations (100 x 3.00 + 300 x 2.00) / (100 + 300).

When using a Sizing Measure for which a Module can get a null value, this means the Module grades will not impact the Application-level grades.

In case all Modules have a null value on the selected Sizing Measure, the Application-level grades are back to the "simple average" method.

Contextual Parameters review [and adaptation]

Select the Contextual Parameters tab:

  • Review the list of Parameters:

Starting with AIP 7.1

The Contextual Parameters are edited in their own editor (as opposed to embedded editor in 7.0.x releases) to ease the readability.

  • The Used by sub-tab informs you about the indicators that use the selected parameter
  • The Contextual Value Overridings informs you about values used for specific technologies and / or specific object types.

Dashboard Services and exclusion review [and adaptation]

Select the Services tab and double click a Dashboard Service in the list:

  • The Dashboard Service editor will then open enabling you to review the list of Exclusions:

  • Remember the exclusion of an Application will exclude all included Modules
  • Remember the exclusion of an aggregated quality indicator will exclude all contributing quality indicators

Sizing Model review [and adaptation to your context]

Technical Size review [and adaptation]

To perform these checks:

  • Successsively select each Sizing Measure whose Sizing Measure type is Technical Size
  • Review the Active and Detached status of each item:

 

Active status > If an item is deactivated, it will no longer be taken into account during the snapshot generation process.This is designed to be a temporary action, i.e. it can be changed easily and quickly between snapshots.

Detached status> When an item is set as Detached, essentially, this is a "delete" action, but the item is preserved in the Assessment Model to avoid a situation where a new item could use the same ID and potentially cause a data incoherence. In addition, the item will still be displayed in the CAST Engineering Dashboard if you consult old snapshots where the item in question was still current.

Starting with AIP 7.1

The Sizing Measures are edited in their own editor (as opposed to embedded editor in 7.0.x releases) to ease the readability.

Functional Weight review [and adaptation]

Backfired Function Points

  • Successsively select each Sizing Measure whose Sizing Measure type is Functional Weight
  • Review the Active and Detached status of each item:

  • With Advanced audience option activated, to fine-tune the ratio in use for each technology, review the list of Contextual Parameters used in the Parameters sub-sub-tab:

and, upon edition of the parameter, you can change the ratio to use for any given technology:

With Functional Weight Sizing, the review is mostly about reviewing the Backfired FP gearing factors that are handled with the "Backfired FP ratio" contextual parameter.

 

Active status > If an item is deactivated, it will no longer be taken into account during the snapshot generation process.This is designed to be a temporary action, i.e. it can be changed easily and quickly between snapshots.

Detached status> When an item is set as Detached, essentially, this is a "delete" action, but the item is preserved in the Assessment Model to avoid a situation where a new item could use the same ID and potentially cause a data incoherence. In addition, the item will still be displayed in the CAST Engineering Dashboard if you consult old snapshots where the item in question was still current.

OMG-compliant Automated Function Points estimation

Function Points estimation configuration requires the use of the CAST Transaction Configuration Center and a valid Function Point computation license key.

Technical Debt Statistics review [and adaptation]

To perform these checks:

  • Successsively select each Sizing Measure whose Sizing Measure type is Technical Debt Statistics
  • Review the Active and Detached status of each item:
  • With Advanced audience option activated, to fine-tune the computation parameters, review the list of Contextual Parameters used in the Parameters sub-sub-tab of the Technical Debt  (ID #68001) Sizing Measure:

With Technical Debt Statistics, the review is mainly a matter of reviewing the values of the different parameters: share of issues to fix by severity level, currency unit, average fixing time by severity level, ....

Active status > If an item is deactivated, it will no longer be taken into account during the snapshot generation process.This is designed to be a temporary action, i.e. it can be changed easily and quickly between snapshots.

Detached status> When an item is set as Detached, essentially, this is a "delete" action, but the item is preserved in the Assessment Model to avoid a situation where a new item could use the same ID and potentially cause a data incoherence. In addition, the item will still be displayed in the CAST Engineering Dashboard if you consult old snapshots where the item in question was still current.

Run-Time Statistics review [and adaptation]

To perform these checks:

  • Successsively select each Sizing Measure whose Sizing Measure type is Run-Time Statistics
  • Review the Active and Detached status of each item:

With Run-Time Statistics, the review is mainly a matter of activating or disabling the indicators so that they will show in the CAST Engineering Dashboard:

  • When active, the Run-Time Statistics that have been attached to the transaction objects in the Analysis Service (using an Update CAST Knowledge Base tool for instance) will be consolidated and will show along TRI-ranked Transactions to provide some more context to end-users.
  • When inactive (default), the Run-Time Statistics that may have been attached to the transaction objects in the Analysis Service (using an Update CAST Knowledge Base tool for instance) will not be consolidated and will not show along TRI-ranked Transactions

Active status > If an item is deactivated, it will no longer be taken into account during the snapshot generation process.This is designed to be a temporary action, i.e. it can be changed easily and quickly between snapshots.

Detached status> When an item is set as Detached, essentially, this is a "delete" action, but the item is preserved in the Assessment Model to avoid a situation where a new item could use the same ID and potentially cause a data incoherence. In addition, the item will still be displayed in the CAST Engineering Dashboard if you consult old snapshots where the item in question was still current.

  • No labels