Above and beyond the configuration possibilities that are available for Tiles and Categories/Tags, there are additional advanced configuration options as listed below:
- Configure the page title
- Configure language
- Configure the ability to request access when not able to log in
- Configure scroll direction
- Configure time period options
- Configure logout confirmation
- Configure tag filtering options
- Configure the number of Applications displayed in Evolution details pages
- Configure user preference persistence
- Configure tile drill down options
- Choose a default language
- Configure session timeout interval
- Configure AEP/EFP export to XLSX or CSV
- Configure API timeout period
- Configure the snapshot threshold
How to configure the options
The options listed above are governed by .json files located in the following locations
Where are the options?
- For cmp.json/cmp-ISO.json and app.json / app-ISO.json, the options are available at the very start of the file.
- For app-navigation.json, the options are located throughout the file.
Modifying the options
To modify the options, edit the .json file with a text editor (Notepad or other similar application). CAST recommends creating a copy of the default file that can be used as a replacement if an error occurs during editing.
Viewing the changes in your browser
There is no need to restart the application server or application itself if you edit and save the .json files: changes are immediate on saving the files. However, you may find that the changes are not immediately visible in the Health Dashboard. This is because the .json file is loaded into the browser's cache, therefore CAST recommends that you empty your browser cache to force the changes to become visible.
If you are using Google Chrome the following tip can be used to automatically empty the browser cache:
- Tap F12 to open the Developer Tools window at the bottom of the page.
- Click the Settings icon (a cog) to the right of the Developer Tools window
- Tick the Disable cache (while DevTools is open) option and close the Settings window.
- In this state, when you then tap F12 followed by F5 to refresh the page, the browser cache will be automatically emptied.
cmp.json / cmp-ISO.json
Configure the page title
Used to display a title in each landing page:
By default this is set to:
Note that the app.json file is located as shown below (this is the only dashboard wide option that is available in both the cmp.json / cmp-ISO.json and app.json files):
|Choose a default language||defaultLanguage|
By default, the dashboard language is set to English. Other languages will be available in the Change Language drop down list when a locale is added (see Dashboard localization for more information). When the Change Language option is used, the new language is configuration is stored in the local browser cache, therefore, if the cache is emptied, then the language will reset to the default (which is set to English out of the box).
If you would prefer to have a different language as the default for all users, then change this parameter to match the official name of the locale you have added. You need to ensure that the locale exists as described in Dashboard localization).
Enables you to choose the language you require
By default, the Engineering Dashboard is delivered with language display set to English: all messages and text displayed in the dashboard is only displayed in English. However, it is now possible to set a specific locale and provided that a translation of the default English text and messages has been configured, the dashboards will then display text and messages in the chosen language.
See Dashboard localization for more information.
|Configure scroll direction||horizontalScroll|
Used to determine the scroll direction for the areas within the dashboard pages. By default this is set to "false", as such, areas are placed vertically on top of each other and scrolling is applied vertically.
Change this value to "true" to enable horizontal scrolling - i.e. areas are placed side by side.
Configure the ability to request access when not able to log in
Used to determine whether a "Can't access" link is displayed on the login screen. By default this is set to "false" and the link is not displayed. Change this value to "true" to enable the link. This link enables a user who is not able to log in (for example because they have forgotten their login credentials or if they have not yet been granted access) to send an email to the dashboard administrator requesting access:
See Lost password and request access configuration for more information about how to modify the template emails that are sent out when a user uses this option.
Enable Appmarq insight
Appmarq data (anonymous statistics collected from a large range of industry-wide applications) is integrated into the CAST Health Dashboard and enabled by default. This integration allows you to compare the application health and delivery performance of your applications against data from a wide-range of industry peers (see Health Dashboard - Appmarq Insight for more information).
Out-of-the box, AppMarq data integration is already enabled. If you would prefer not to see this data, you can disable it by changing this value to false:
|Force column to display as Failed||failedRatio|
Drilling down from a Health Measure tile (TQI, Robustness, Efficiency, Security, Changeability, Transferability) or the Top Critical Rules tile will display a list of structural rules that have been triggered during the source code analysis/snapshot with various statistics. One of the columns displayed is labelled "%Compliance" (when drilling down from a Health Measure Tile) or "%Failed" (when drilling down from the Top Critical Rules tile.
You can force the column to be displayed as "%Failed" regardless of where the user drills down from by changing the value to true:
Configure logout confirmation
When a user logs out of the Health Dashboard, a confirmation message will be displayed by default:
If you would like to deactivate this confirmation message, simply change
|Configure user preference persistence|
During navigation with the Health Dashboard, you may be selecting filters, grouping or different periods than are configured by default. If the parameter persistNavigationFilters is set to true (the default is false), the web application will try and record your preferences in the browser's cache. By doing so, when you access the dashboard another time, if those parameters are not set in the URL, those from the cache will be used instead, enabling you to pursue navigation with the same filtering/grouping parametrization.
If you access a page with parameters already set in the URL, they will be used instead. Any time you change one of these parameters, the parameters will be saved again in the cache for future use.
The persistence only applies to
|Defines how long the session timeout will operate||alertTimeoutInterval||N/A|
By default the dashboard will listen for GET or POST requests and when none are detected a timeout will occur. When the timeout occurs a dialog box will be displayed - this indicates (in the upper right corner) how many seconds are remaining before a re-login will be required - the default remaining seconds is set to 10. Clicking Continue will return to the session without requiring a login.
To change the remaining seconds, add the following parameter to the file, where xx = the number of seconds:
For example, 30 seconds has been defined:
|Configure time period options|
This option enables fine tuning of the time period options for evolution data that are available to users in the top right hand corner of the dashboard:
These options are explained in more detail in Health Dashboard - GUI (see Time period selection).
|Configure tag filtering options|
When set to true:
Users only get access to categories/tags that match the Application's full scope (i.e. tags that do not apply to any Application accessible to the user are not displayed).
When set to false:
Users can see all categories and related tags regardless of whether any Applications are assigned to them. Filtering on visible tags with no Applications will lead to a blank display however.
|Configure the number of Applications displayed in Evolution details pages||Evolutions|
This option defines the number of Applications that are included in the Evolution details pages (i.e. the pages accessed when clicking an Evolution tile either at multi or single Application level). The default value is set to 10 Applications - beware when configuring a high number of Applications as it can significantly impact performance. The parameter can be overridden by plugin specific configuration.
|Configure API timeout period||timeoutPeriod|
Valid only for ≥ 1.23 releases.
This option sets the API timeout period (i.e. for fetching data). By default this is set to 60000ms (1 minute). After the set time period, a timeout will occur and the Health Dashboard will no longer attempt to fetch that specific data.
Increasing the timeout period can be useful when you have a large number of applications configured in the Health Dashboard, or you have Applications that are very big - if you are consistently finding that the Health Dashboard is not fetching all data (i.e. tiles are empty), then you should increase the timeout period in steps until the data loads correctly.
|Configure snapshot threshold||snapshotThreshold|
Valid only for ≥ 2.2.0 releases.
This option sets the snapshot threshold value. By default this is set to 1500. Several slow loading tiles will not be displayed if the snapshot count is above this threshold. This is designed to improve performance when loading the multi-app portfolio home page.
The tiles that will be removed from are as follows:
The time period selector will not function if the number of snapshots is above the threshold - in other words, the value will remain same in all tiles even if you select a different time period.
app.json / app-ISO.json
Configure AEP/EFP export to XLSX or CSV
This option defines the format used to export AEP or legacy EFP data. By default it is set to XLSX (Excel) format. You can change this to CSV formation if necessary as follows:
Configure tile drill down options
Only valid for ≤ 1.21 releases. This configuration has been removed in more recent releases.
By default, this option is not present (and it therefore set to "false"). Adding it into the parameters section of the "id": "healthFactors", will force the "% Compliance" column when drilling down from tiles to be changed from "% Compliance" to "% Failed":
Click to enlarge:
|Configure measures used for Snapshot Comparison||Various||N/A|
Only valid for ≤ 1.20 releases. This configuration has been removed in more recent releases.
It is possible to customize the measures used in the Snapshot Comparison section by modifying the "indicators" listed below: