Page tree
Skip to end of metadata
Go to start of metadata

Page frame name:

FRAME_METRIC_DETAIL

Please note that this page is now deprecated and should no longer be used. It will be removed in a future version. In addition, screenshots have not been updated.

For each metric - i.e., Health Factor, Rule Compliance, Technical Criterion, quantity Metric, quality Metric, Quality Rule and Distribution -, the CAST Engineering Dashboard features a Metric Detail page.

Note that in essence, the Drill-Down section helps investigate the root cause, while the Roll-Up section helps investigate consequences of the context under scrutiny.

Overview section

This section displays the grade, status (displayed with color-coding) and description of the selected Metric:

For the lowest-level metrics, a more detailed overview section is displayed:

Drill Down section

The Drill Down section has different displays depending on the item it is displayed.

For high-level metrics, it contains a Sub-Metric section showing values of metrics that contributed to the selected metric (if any; in the case of the lowest-level Metrics, there is no lower level) and a Sub-Component section showing values of the selected metric for child nodes (if any; in case of lowest-level Module nodes, there is no lower level).

Note that the Drop Down selector enables you to hide details about metrics with a specific weight value. Because the weight value can be customized in CAST ADG Admin, the values in this list are simply "helpers" as it is impossible to list all values.

In the case of Functional Weight, the Drill Down list will show Unadjusted Data Functions (both legacy and enhanced) and Unadjusted Transactional Functions (both legacy and enhanced):


At Distribution/Quality Rule based metric levels:

  • An Object Listthat displays:
    • A Failed/Successful Checks matrix displaying the number of artifacts that have either failed the current metric or successfully passed the current metric - note that the Failed Checks value is sometimes greater than the number of objects that are actually in violation as displayed in the List of Very High Risk Objects (see below). This is due to the fact that some objects are shared between multiple components, and as such, one failed check is counted for each component, whereas the component is only recorded once in the List of Very High Risk Objects.
    • the objects that are responsible for the metric value at the module level.
    • A List of Very High Risk Objectsthat displays very high risk objects for the selected Metric. In addition, you can:
      • Select an object and either add it to the Action Plan Improvement - Action Plan or add it to an Exclusion List to exclude the item from the next snapshot generation process. For old snapshots an inactive tick-box and text field are displayed to show the definition of exclusion for the displayed Snapshot (once defined and taken into account, an exception excluded from the computing is displayed in the dedicated section below)
      • Directly access information about a particular object by clicking the URL (the Object Detail page will be displayed)
      • View the object's Source Code using the icon (see Violation Viewer)

When you request a very large list - typically a list of more than 500 rows - Internet Explorer will prompt you to stop the execution of a script with the following message 'A script on this page is causing Internet Explorer to run slowly. If it continues to run, your computer may become unresponsive'. Simply cancel the action to keep displaying the list.

In addition, in the case of Quality Rule-, Distribution-, and measure-based Metrics, the sub-metric sub-section automatically turns into an object-level drill-down sub-section, providing a summary of the Metric computation (respectively size and share of compliant and non-compliant object population, size and share of object distribution categories, measure) and a list of the objects involved.

For a distribution:

  • Display of the share (%) of each category of the distribution
  • Size and share of each category of objects in the selected context
  • Hyperlink to Object Detail Page
  • Object feature value

Note that the following is true:

  • Value = the optional value returned by the diagnostic: a diagnostic may return a value, text, a percentage, another object etc., it depends on the diagnostic itself.
  • New Violation = indicates if this is a new violation (useful in comparison scenarios)
  • Changed Numerical Value = indicates if the value has changed (useful in comparison scenarios)

For a Quality Rule:

  • Size and share of compliant and non-compliant objects in the selected context
  • Hyperlink to Object Detail Page
  • Object feature value

Note that the following is true:

  • Value = the optional value returned by the diagnostic: a diagnostic may return a value, text, a percentage, another object etc., it depends on the diagnostic itself.
  • New Violation = indicates if this is a new violation (useful in comparison scenarios)
  • Changed Numerical Value = indicates if the value has changed (useful in comparison scenarios)

For a measure:

  • Hyperlink to Object Detail Page
  • Object feature value

Assessment Corner section

The Assessment Corner section (Business Criteria only) shows:

  • a cross-examination of Cyclomatic Complexity information with - respectively - low documentation level and high fan-out (Transferability and Robustness Business Criteria)
  • a 'top 50' list that lists the 50 objects that violate the largest number of Quality Rule-based Metrics that participate to the selected Business Criterion through Technical Criteria
  • and a table and graphical split of the number of violations per Technical Criteria that participate in the selected Business Criterion

Roll Up section

This section contains a Parent Metric section showing values of metrics in which the selected metric contributes (if any; in the case of highest-level Application Health Factors and Rule Compliance, there is no higher level) and a Parent Component section showing value of the selected metric for parent node (if any; in case of highest-level Application node, there is no higher level).

The display of this section and its content depends on the context. As a Roll-Up section, its display depends on the existence of a level on top of the context under scrutiny in which to roll-up. E.g.: there are no upper-levels to "Health Factor" and "Rule Compliance" and there are no upper-levels to the "Application" node.

The following additional information is also displayed:

  • Super-metric sub-section providing more aggregated information on:
    • Technical Criteria when looking at quality Metrics,
    • Health Factors / Rule Compliance when looking at Technical Criterion
    • Quality Metrics when looking at a Quality Rule/Distribution/measure
  • Super-component sub-section providing more aggregated information on:
    • Application when looking at a Module

List of Exceptions section

This section shows the objects, applications and modules that were intentionally excluded from the most recent Snapshot calculation (if any). There are two distinct sub-sections:

The first section lists any Applications or Modules that have been excluded from the Snapshot calculation via the CAST Management Studio. In the below example, the Application called "MEUDON_APP" has been excluded:

This type of exclusion is managed in the Dashboard Service editor of the CAST Management Studio:

The second section lists individual objects that have been excluded from the most recent Snapshot calculation via the List of Very High Risk objects (see above):

Note that no exclusions will be displayed in this section until you have re-run the Snapshot calculation.

Action Plan on current Metric section

This section is available for individual metrics:

It lists all objects that have been selected "for action" in relation to the current selected metric. See Improvement - Action Plan for more information about the Action Plan view.

 

  • No labels