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

Summary: Documentation for the ISO-5055 Index extension.

Extension ID

com.castsoftware.omg-ascqm-index

Description

ISO-5055 is a standard that is published by ISO: https://www.iso.org/standard/80623.html.

This extension will compute Quality Software Characteristic Measures as Business Criteria and Quality Measure Elements as Technical Criteria. All CAST rules that are tagged with a ISO-50555 related tag will contribute to the various Quality Measure Elements / Quality Software Characteristic Measures thereby allowing specific compliance ratios, grades and rule violations to be reported.

Compatibility

ProductReleaseSupported
AIP Core≥ 8.3.24(tick)

CAST Engineering Dashboard

≥ 1.5(tick)
CAST Health Dashboard≥ 1.17(tick)
CAST Security Dashboard≥ 1.18(tick)

ISO-5055 version

April 2021(tick)

Download and installation instructions

Configuration requirements

Generate a snapshot

A new snapshot must be generated (after the extension is installed) before results can be viewed. If you do not immediately see changes in the dashboard, please consider restarting Apache Tomcat/the web application and/or emptying your browser cache.

Set filterHealthFactor option to false

Only required in Engineering/Security Dashboard ≤ 1.17:

 Click here to expand...

Before results can be viewed, you must ensure that the "filterHealthFactor": option is set to false. To do so, locate the following file:

CATALINA_HOME\webapps\<webapp>\engineering\resources\ed.json

Find the following line (near the start of the file):

"filterHealthFactor": true,

If the option is set to true (default position) please change it false. If it is false already, there is nothing further to do:

"filterHealthFactor": false,

Following any changes you make, save the ed.json file and then restart your application server so that the changes are taken into account.

You can find out more about the options available in the ced.json/ed.json file in Engineering Dashboard json configuration options.

Optional Health Dashboard configuration options

It is possible to modify some of the default tiles provided out of the box and also add additional tiles in the CAST Health Dashboard for use with ISO-5055 data. See Manual configuration of Dashboard tiles using ISO-5055 data for more information.

These customizations can be used in the following Health Dashboard releases:

  • ≥ 1.27.0-funcrel
  • ≥ 2.1.0-funcrel

What results can you expect?

Once the analysis/snapshot generation has completed, you can view the results in the dashboards:

Assessment Model

Various Business and Technical Criteria will be added by the extension:

ISO-5055-Index

1061000ISO-5055-IndexBusiness Criterion
Note that the ISO-5055-Index Business Criterion has all Technical Criteria listed below as contributors.

ISO-5055-Maintainability

1061001ISO-5055-Maintainability
1061046CWE-407
1061056CWE-478
1061057CWE-480
1061058CWE-484
1061061CWE-561
1061065CWE-570
1061066CWE-571
1061088CWE-783
1061105CWE-1041
1061108CWE-1045
1061110CWE-1047
1061111CWE-1048
1061114CWE-1051
1061115CWE-1052
1061116CWE-1054
1061117CWE-1055
1061121CWE-1062
1061122CWE-1064
1061128CWE-1074
1061129CWE-1075
1061131CWE-1079
1061132CWE-1080
1061135CWE-1084
1061136CWE-1085
1061137CWE-1086
1061138CWE-1087
1061141CWE-1090
1061143CWE-1093
1061145CWE-1095

ISO-5055-Performance-Efficiency

1061002ISO-5055-Performance-Efficiency
1061044CWE-401
1061045CWE-404
1061049CWE-424
1061085CWE-772
1061086CWE-775
1061106CWE-1042
1061107CWE-1043
1061109CWE-1046
1061112CWE-1049
1061113CWE-1050
1061118CWE-1057
1061120CWE-1060
1061124CWE-1067
1061126CWE-1072
1061127CWE-1073
1061140CWE-1089
1061142CWE-1091
1061144CWE-1094

ISO-5055-Reliability

1061003ISO-5055-Reliability
1061021CWE-119
1061022CWE-120
1061023CWE-123
1061024CWE-125
1061026CWE-130
1061027CWE-131
1061029CWE-170
1061030CWE-194
1061031CWE-195
1061032CWE-196
1061033CWE-197
1061034CWE-248
1061035CWE-252
1061038CWE-366
1061039CWE-369
1061040CWE-390
1061041CWE-391
1061042CWE-392
1061043CWE-394
1061044CWE-401
1061045CWE-404
1061047CWE-415
1061048CWE-416
1061049CWE-424
1061051CWE-456
1061053CWE-459
1061054CWE-476
1061057CWE-480
1061058CWE-484
1061060CWE-543
1061062CWE-562
1061064CWE-567
1061067CWE-595
1061068CWE-597
1061074CWE-662
1061076CWE-667
1061077CWE-672
1061078CWE-681
1061079CWE-682
1061080CWE-703
1061081CWE-704
1061083CWE-758
1061084CWE-764
1061085CWE-772
1061086CWE-775
1061089CWE-786
1061090CWE-787
1061091CWE-788
1061094CWE-805
1061095CWE-820
1061096CWE-821
1061097CWE-822
1061098CWE-823
1061099CWE-824
1061100CWE-825
1061101CWE-833
1061102CWE-835
1061103CWE-908
1061108CWE-1045
1061114CWE-1051
1061119CWE-1058
1061123CWE-1066
1061125CWE-1070
1061130CWE-1077
1061131CWE-1079
1061133CWE-1082
1061134CWE-1083
1061138CWE-1087
1061139CWE-1088
1061146CWE-1096
1061147CWE-1097
1061148CWE-1098

ISO-5055-Security

1061004ISO-5055-Security
1061010CWE-22
1061011CWE-23
1061012CWE-36
1061013CWE-77
1061014CWE-78
1061015CWE-79
1061016CWE-88
1061017CWE-89
1061018CWE-90
1061019CWE-91
1061020CWE-99
1061021CWE-119
1061022CWE-120
1061023CWE-123
1061024CWE-125
1061025CWE-129
1061026CWE-130
1061027CWE-131
1061028CWE-134
1061030CWE-194
1061031CWE-195
1061032CWE-196
1061033CWE-197
1061035CWE-252
1061036CWE-259
1061037CWE-321
1061038CWE-366
1061039CWE-369
1061044CWE-401
1061045CWE-404
1061049CWE-424
1061050CWE-434
1061051CWE-456
1061052CWE-457
1061055CWE-477
1061057CWE-480
1061059CWE-502
1061060CWE-543
1061063CWE-564
1061064CWE-567
1061065CWE-570
1061066CWE-571
1061069CWE-606
1061070CWE-611
1061071CWE-624
1061072CWE-643
1061073CWE-652
1061074CWE-662
1061075CWE-665
1061076CWE-667
1061077CWE-672
1061078CWE-681
1061079CWE-682
1061082CWE-732
1061085CWE-772
1061086CWE-775
1061087CWE-778
1061088CWE-783
1061089CWE-786
1061090CWE-787
1061091CWE-788
1061092CWE-789
1061093CWE-798
1061094CWE-805
1061095CWE-820
1061096CWE-821
1061097CWE-822
1061098CWE-823
1061099CWE-824
1061100CWE-825
1061102CWE-835
1061104CWE-917

Health Dashboard

v. ≥ 1.27 / ≥ 2.1.0

A dedicated ISO-5055 view is available allowing you to swap between tiles showing ISO-5055 data and tiles showing standard data. The ISO-5055 view is accessed using the drop down available at single or multi-application level as shown in the screenshots below. By default, the tiles in this view use the root ISO-5055 Business Criterion (ISO-5055), and show either of the following data by default:

ReleaseData displayed by defaultDescription
≥ 2.5.xCompliance ratio

(2.1.x - 2.4.x and ≥ 1.27.xGrades

The tiles can be modified as follows (see Manual configuration of Dashboard tiles using ISO-5055 data for more information):

  • to use any of the ISO-5055 business/technical criterion for the "qualityIndicator" parameter:
    • ISO-5055
    • ISO-5055-SECURITY
    • ISO-5055-RELIABILITY
    • ISO-5055-PERFORMANCE-EFFICIENCY
    • ISO-5055-MAINTAINABILITY
  • the "mode" can be changed manually to show any of the following, instead of the default:
    • Grade
    • Compliance ratio
    • Number of violations

v. 1.26 / 2.0 only

Five ISO-5055 specific tiles will be available at both single and multi-application level - one for the Business Criteria ISO-5055 Index and the rest for the four Technical Criteria. See Health Dashboard - Available information - ISO 5055 - Overview section for more information about how they function. In these releases, grade information is displayed by default.


v. ≤ 1.25

No tiles will be provided to display data for this extension, however it is possible to create tiles manually to display Grade, Compliance, and Violation data directly from this extension using the Industry Standard/s tile plugin available in v. ≥ 1.17. See Health Dashboard tile management for more information. Clicking on any of these tiles will display a list of the rules that have been tagged with the specified standard as provided by the extension. Compliance percentage is also displayed in a "bubble".

Examples for cmp.json and app.json

 Click here to expand...

cmp.json

Configuration to create a "gauge" tile at portfolio level (multi-app level) to show a ISO-5055-Index Business Criterion tile:

{
  "id": 1234,
  "plugin": "IndustryStandards",
  "color": "black",
  "parameters": {
	"type": "ISO-5055",
    "title": "ISO-5055-Index",
    "widget": "gauge",
    "industryStandard": {
		"id": "1061000",
		"mode": "grade",
		"format": "0.00",
		"description": "ISO-5055-Index in grade format"
    }
  }
}

app.json

Configuration to create a "number of violations" tile at application level (single app level) to show a ISO-5055-Maintainability Business Criterion tile:

{
  "id": 1236,
  "plugin": "IndustryStandard",
  "color": "orange",
  "parameters": {
	"type": "ISO-5055",    
	"title": "ISO-5055-Maintainability",
    "industryStandard": {
		"id": "1061001",
		"mode": "violations",
		"format": "0,000",
		"description": "ISO-5055-Maintainability in number of violations format" 
    }
  }
}

Engineering/Security Dashboard

v. ≥ 1.26

An ISO-5055 tile is displayed by default taking data from the Business Criterion ISO-5055 Index for the Engineering Dashboard and the Technical Criterion ISO-5055 Security for the Security Dashboard. The number of violations is shown in both cases:

Drilling down through this tile will take you to the Risk Investigation view, where the focus will be set to the ISO-5055 Assessment Model (1) showing only the ISO-5055 metrics (2):

v. ≤ 1.25

Out of the box, no tiles will be provided to display data for this extension, however it is possible to create tiles manually to display Violation data directly from this extension using the Industry Standard/s tile plugin in v. ≥ 1.18 of the Engineering Dashboard. See Engineering Dashboard tile management for more information. Clicking on the tile navigates to Risk investigation view and the specified Industry Standard will be selected in the Health Factor table.

In addition, as above, the ISO-5055 Assessment Model will be made available in the Risk Investigation view.

RestAPI

The RestAPI can be used to query both the Dashboard (AED) and Measurement (AAD) schemas for results, for example:



  • No labels