Content matrix

RestAPI documentation

• Application Structure Resources - 1.10.0
• Engineering Resources - 1.10.0
• Health Results Resources - 1.10.0
• Quality and Sizing Model Resources - 1.10.0
• Report Service - 1.10.0
• Server Services - 1.10.0
• User Session Services - 1.10.0

Resolved issues

New features - All dashboards

Chinese language locale now fully translated

All dashboard interface text has now been fully translated in to Chinese (zh_CN) and is available in:

Engineering Dashboard: CATALINA_HOME\webapps\CAST-Engineering\engineering\locales\zh_CN\translation.json
Health Dashboard: CATALINA_HOME\webapps\CAST-Health\portal\locales\zh_CN\translation.json

This means that you can select the Chinese language "out of the box" and all items will now be displayed in the target language. See also Dashboard localization.

New features - CAST Health Dashboard

DASHBOARDS-1016 - Addition of module filter in Trend tiles drill down pages

When drilling down from the Trends tiles to view detailed information, it is now possible to select the module you want to filter on:

Click to enlarge

The module filter is available in the following high level options:

• Sizing Indicators
• Health Measures
• Best Practices

By default All Modules will be selected providing the equivalent of an Application level view. The list of modules available for selection varies with the selected time period: if a module is not present in the selected period then All Modules is be selected by default.

New features - CAST Engineering Dashboard

DASHBOARDS-909 - Atlassian JIRA integration

The 1.10.0 release of the CAST Engineering Dashboard introduces an Atlassian JIRA integration that allows Atlassian JIRA tickets to be created directly from the interface of the CAST Engineering Dashboard. More specifically, one JIRA ticket can be created per violation that has been added to the Action Plan. Multiple tickets can also be created at the same time.

By default in 1.10.0, this feature is not active and therefore requires configuration before it can be used.

Enabling JIRA integration

Edit the following file:

CATALINA_HOME\webapps\CAST-Engineering\engineering\resources\ced.json

Add a new parameter called "JIRAConfig": true, into the "configuration" section as shown below:

{
	"description": "used as a placeholder for as much as possible relevant default application parameters, please do not edit manually",
	"configuration": {
		"defaultLanguage": "English",
		"description": "To configure new language for application, define customLanguages as [{'label': 'languageName', 'value': 'localeFolderName'}]",
		"customLanguages": [],
		"requestAccess": false,
		"JIRAConfig": true,
		"confirmLogout": true,
		"filterHealthFactor": true,
		"violationsCount" : 5000,
		"reportCategory": [

Save the file and restart the host Apache Tomcat server for the changes to be applied. After the feature is active, the following will now be visible in the Action Plan:

Configuring the JIRA integration

To configure the JIRA integration feature, create a new file called jira.properties in the following location (you can also download a sample jira.properties file with "dummy" data in it):

CATALINA_HOME\webapps\CAST-Engineering\WEB-INF\

Fill in the following information to connect to your own JIRA instance. Save the file and restart the host Apache Tomcat server for the changes to be applied.

jira.url=
jira.userName=
jira.userPassword=
jira.issueType=
jira.projectKey=

https://jira.company.com/rest/api/2/

https://jira.company.com/plugins/servlet/project-config/PROJECTKEY/summary

Using the JIRA integration

To create a ticket for one single violation that has been added to the Action Plan, select the violation and choose Create JIRA ticket for selected violations:

The ticket will then be created and if successful a popup will be displayed:

You can create multiple tickets by selecting multiple violations and then choosing the Create JIRA ticket for selected violations. By default a maximum of 10 tickets can be created in one go - if you attempt to create more than this, a popup will be displayed:

If you attempt to create a ticket for a violation and the corresponding ticket already exists in JIRA, the following message will be displayed:

JIRA ticket fields populated by CAST

The following fields in the JIRA ticket are auto populated by CAST as follows:

https://jira.company.com/plugins/servlet/project-config/PROJECTKEY/summary

Modifying the ticket creation limit

By default, a maximum of 10 tickets can be created in one go. If you would like to change this limit, edit the following file:

CATALINA_HOME\webapps\CAST-Engineering\engineering\resources\ced.json

Add a new parameter called violationsCountForJIRA into the configuration section and specify the limit you want to use - for example 20 has been chosen below. Save the file and restart the host Apache Tomcat server for the changes to be applied.

{
	"description": "used as a placeholder for as much as possible relevant default application parameters, please do not edit manually",
	"configuration": {
		"defaultLanguage": "English",
		"description": "To configure new language for application, define customLanguages as [{'label': 'languageName', 'value': 'localeFolderName'}]",
		"customLanguages": [],
		"requestAccess": false,
		"JIRAConfig": true,
		"confirmLogout": true,
		"filterHealthFactor": true,
		"violationsCount": 5000,
		"violationsCountForJIRA": 20
		"reportCategory": [

DASHBOARDS-982 - Ability to generate a specific type of custom report (Word, Excel, PowerPoint)

The 1.9.x release of the CAST Engineering Dashboard introduced the notion of report generation direct from the dashboard interface. Custom reports can now be generated based in the presence of Report Generator templates. Up until now, no distinction was made for the type of report (Word, Excel, PowerPoint), however this has now been introduced by the addition of the filetype parameter.

To enable and define the reports for the category, edit the following file:

CATALINA_HOME\webapps\CAST-Engineering\engineering\resources\ced.json

Find the following configuration section:

{
	"id": "custom",
	"label": "Custom Reports",
	"reportTemplates":[]
}

To add your report for a custom template called Executive summary PPT.pptx, AEP Sample Report.xlsx and My Custom Template 2019.docx change it as follows. Save the file and restart the host Apache Tomcat server for the changes to be applied:

{
	"id": "custom",
	"label": "Custom Reports",
	"reportTemplates":[
		{
            "templateLabel": "Executive summary PPT",
            "templateId": "Executive+summary+PPT",
            "fileType":"pptx"
		},
		{
            "templateLabel": "AEP Sample Report",
            "templateId": "AEP+Sample+Report",
            "fileType":"xlsx"
		},
		{
			"templateLabel": "My Custom Template 2019",
			"templateId": "My+Custom+Template+2019",
			"fileType":"docx"
		}   
	]
}

DASHBOARDS-966 - Deleted module data in previous snapshot

It is now possible to view data for modules that existed in the previous snapshot but have been deleted from the current snapshot. The data is available in the All Modules drop down when looking at a previous snapshot (previously, any deleted modules were listed in this drop down but were greyed out and could not be accessed):

Improvements to Miscellaneous reports

It is now possible to filter the results of Miscellaneous reports by Health Measure (TQI is selected by default):

Drill down to violation source code is also possible for some reports:

DASHBOARDS-775 - Show More option added to Continuous Improvement violation list

A Show More button has been added to the list of violations displayed in the Continuous Improvement page. By default, only 10 violations are displayed to improve performance. 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 Engineering Dashboard json configuration options).