The CAST Application Analytics Dashboard (CAST AAD) is the dashboard view of all the data surfaced through CAST AIP analysis and snapshot generation. . This includes health factors, compliance scores, risk indicators, critical violation counts, technical sizing, all related statistics and also includes Function Points for sizing. The CAST Application Analytics Dashboard will give visibility and measurement overview of IT development activities at all levels.
This documentation section provides the following information:
- How to connect and login to the CAST Application Analytics Dashboard
- What sort of information is displayed in the dashboard
- A simple explanation of the dashboard interface
If you need to know more about:
- how to install and configure the CAST Application Analytics Dashboard, please see: Installing and configuring the CAST Application Analytics Dashboard.
- how to undertake advanced configuration such as Tile management, Tags and categories etc, please see:
Connecting to the CAST Application Analytics Dashboard
To connect to the CAST Application Analytics Dashboard, browse to the URL provided to you by your CAST Administrator. This will usually be in the following format:
The login page will then be displayed:
Logging in to the CAST Application Analytics Dashboard
To login to the Application Analytics Dashboard, you need to enter a username and password and then click the Log In button.
Depending on the authentication mode configured by the CAST AI Administrator (see Installing and configuring the CAST Application Analytics Dashboard for more information) you need to login with a presupplied username and password, or your corporate username and password. If in doubt, contact your CAST AI Administrator.
Note that if you are not authorized to view any data in the CAST Application Analytics Dashboard, then upon login a message will be displayed as follows and no further use of the dashboard is allowed:
Requesting access or a password
If you need to access the CAST Application Analytics Dashboard but:
- you do not have a presupplied username/password
- your corporate login credentials do not allow access
- or you have forgotten the password for a presupplied username
then you can use the Can't access link to contact the CAST AI Administrator:
You will then be prompted to choose an option - each is explained below.
If you choose this option:
- enter your presupplied username in the USERNAME field
- click Send
A new email will be created in your default email client requesting the password for the username you specified. Send this to your CAST AI Administrator.
If you choose this option, simply click the Send button.
A new email will be created in your default email client requesting access. Send this to your CAST AI Administrator.
What information is available?
The information displayed in the CAST Application Analytics Dashboard is derived from snapshots generated by the CAST AI Administrator and provides a high level and intuitive overview of your set of Applications.
When you first log in, you will be presented with the "landing page". The contents of this page depend on the number of Applications that are present in the Measurement Service:
If snapshot data for only one Application is present, you will be presented with the Application landing page - the Application name is displayed at the top as highlighted below.
If snapshot data for multiple Applications is present, you will be presented with the Multi-application landing page - the number of Applications is displayed at the top as highlighted below:
To view data for an individual Application, click the "+" button underneath Application Analytics Dashboard and select the one you require. You will then be taken to the Application landing page:
Data is displayed in the CAST Application Analytics Dashboard in the form of clickable "tiles". The data in the tiles is divided into various sections:
Data in these tiles represents the most recent "score" of your Application or Applications for a specific Quality or Quantity measurement (i.e. the information from the most recent snapshot generated by the CAST AI Administrator) in the most recent snapshot. Each tile contains a specific type of data, for example Robustness, Security, Number of Critical Violations, Number of Lines of Code. Where you have more than one Application (by default data from all Applications is displayed when you first load the CAST Application Analytics Dashboard), the data in these tiles is either a sum of all the Applications (for example the Size tile) or is an average of all the Applications (the TQI tile):
Data in these tiles represents the evolution over time of the snapshot values for all Applications (multiple Applications) or Application (single Application) in the current scope. The Time Span selection and Filter selection determines the scope - see below for more information about this. If no data is present, this means that you only have one snapshot, therefore there is no evolution to display.
Software Enhancement Function Points (since Previous Version)
Data in these tiles deals with Function Points on a per Application basis: Function Points are used to determine the functional size of an Application - these are calculated by recent versions of CAST by default. Enhancement Function Points (EFPs) specifically measure the modifications that add, change, or delete user functions to/from an existing Application. These tiles therefore give an overview of the current situation.
Clicking a tile
Each tile in either landing page can be clicked to drill down and display more information about the selected Quality or Quantity measure. For example for the "Transferability" health factor:
In addition, you can drill down to find out why you have received a particular grade for a Health Factor by viewing the rationale behind the Quality Rule/Distribution/Measure (roll the mouse over the Quality Rule/Distribution/Measure):
You can also view the evolution of specific measures over time by clicking any tile in the Evolutions section. Note that by default, the most recent results of the 10 worst Applications for the selected measure in the selected time period will be displayed. You can select and unselect Applications as required:
Enhanced and Automated Function Point export to Microsoft Excel
The CAST Application Analytics Dashboard provides Enhanced and Automated Function Point information about your Application (accessible from the Application landing page):
The data provided (out of the box) is a simple value - e.g.:
- Function Point information:
- Number of Automated Functions Points (AFP)
- Number of Data Function Points
- Number of Transactional Function Points.
- Sizing information:
- Number of Decision Points
- Number of Critical Violations
- Number of Critical Violations per Function Point
- Function Point information:
- Added Function Points
- Modified Function Points
- Deleted Function Points
Out of the box, icons allowing the export of more detailed AFP and EFP information are available, however they are not activated (except when using the combined CAST-AAD-AED WAR file - see Installing and configuring the CAST Application Analytics Dashboard):
However, after a configuration change (please see CAST-AAD - Exporting Automated Function Point data to a Microsoft Excel or CSV file), the icons become active allowing an export to Microsoft Excel file:
When you click the icon, you will be prompted to either Open or Save the file depending on your browser:
Clicking Open will launch the program associated with the .xlsx file type (usually Microsoft Excel), while clicking Save will prompt you to choose a location to store the file for future use.The Excel file contains detailed about how the Enhanced/Automated Function Point value has been derived:
XLSX column headings
The following columns are displayed in the XLSX file:
|Element Type||Whether this object is a Data Function or a Transaction||String||1|
|Object Name||Full name||String||1|
|Nb of FPs||Number of Function Points for this OMG-compliant Automated Function Points Function||Integer||1|
|Type||OMG-compliant Automated Function Points Function type||String||0..1|
|DET||Data Element Type||Integer||0..1|
|RET||Record Element Type||Integer||0..1|
|EIF||External Interface File||Integer||0..1|
|ILF||Internal Logical File||Integer||0..1|
|FTR||File Type Referenced||Integer||0..1|
|Object Type||Type of this OMG-compliant Automated Function Points Function||String||1|
|Module name||Name of a functional module containing this OMG-compliant Automated Function Points Function||String||1|
|Technology||Technology to which this OMG-compliant Automated Function Points Function belongs||String||1|
Exporting to CSV instead of XLSX
By default, the export file format is set to Microsoft Excel (.xlsx). However, it is possible to change this to .csv if you prefer - see CAST-AAD - Exporting Automated Function Point data to a Microsoft Excel or CSV file.
If you set the export to CSV please take note that by default, the semi-colon (;) is used as the delimiter value for the CSV file. You may need to change the List Separator value in Control Panel > Region and Settings > Formats tab > Additional Settings in order for the CSV file to display correctly:
CSV column headings
The following columns are displayed in the CSV file:
|Element Type||Whether this object is a Data Function or a Transaction||String||1|
|Object Name||Full name||String||1|
|Nb of FPs||Number of Function Points for this OMG-compliant Automated Function||Integer||1|
|FP details||Details on the Function Points for this OMG-compliant Automated Function||String||1|
|Object Type||Type of this IOMG-compliant Automated Function||String||1|
|Module name||Name of a functional module containing this OMG-compliant Automated Function||String||1|
|Technology||Technology to which this OMG-compliant Automated Function belongs||String||1|
Zoom feature for multi column display
When you click specific tiles in the CAST Application Analytics Dashboard (for example the default "Robustness" tile (a QualityIndicatorResults type tile)) and you have a large number of Applications consolidated, the drill down details will display one column per Application:
This display can make reading the details of each column very difficult. If this is the case you can select (i.e. hold the left mouse button down and select the Applications you require) a certain number of Applications and the dashboard will zoom into them. In the example below, just two Applications have been selected:
- the Zoom function is available for the following tiles (see CAST-AAD - Tile management):
BackgroundFactsResults / BackgroundFactsResult
QualityIndicatorResults / QualityIndicatorResult
SizingMeasureResults / SizingMeasureResult
- that a Reset zoom button is now visible (highlighted above) to enable you to return to the default view.
CAST Application Analytics Dashboard interface
Navigating around the data in the dashboard is relatively straightforward - however, below is a brief explanation of some of the interface display options that are available to you:
Left hand navigation options
In every screen in the dashboard, the icons shown above are displayed. When clicked they will behave as follows:
|This icon will take you back to the "home" page.|
|This icon will load this current help page in your browser.|
User name button
In every screen in the dashboard, a username button will be visible displaying the user's username. Clicking the button will display a drop down menu whose contents depends on the role granted to the username (see User Roles in Installing and configuring the CAST Application Analytics Dashboard):
|Role granted to the username||Available options|
|none||Only the Logout button is displayed. By default, when clicking the button, a confirmation message will be displayed prompting the user whether they really want to log out. This confirmation message can be deactivated by CAST administrator - see CAST-AAD - Dashboard wide configuration options in json).|
|ROLE_ADMIN||In addition to the Logout button (see above), if the username has been granted the ROLE_ADMIN role, then a link to the Tags Administration page will be displayed. See CAST-AAD - Tag and category management for more information.|
By default, the CAST Application Analytics Dashboard will always display data from the most recent snapshot available for all Applications. In other words:
- When you have multiple Applications, the values you see are an aggregation of the data from the most recent snapshot for all Applications
- When you only have one Application, the values you see are taken from the most recent snapshot of the Application
However, when working at Application level (i.e. you have drilled down from the Multi-application landing page or you only have one Application) you can choose the snapshot data you would like to see by using the dropdown list:
As soon as you select the snapshot, the data in the page will update accordingly.
There are two options that enable you to choose what is displayed in the CAST Application Analytics Dashboard:
Time period selection
By default, the CAST Application Analytics Dashboard will display data for the last 3 months for SizingMeasureEvolution tiles (based on evolution) in the Overview section and for all tiles in the Evolution section - i.e tiles will display the evolution of the data over the period of time selected:
When selecting a time period, the tiles that will be affected will be shown active, those unaffected by the time period selection will be greyed out (the tiles in the Software Enhancement Function Points (since Previous Version) section are not affected by this selector).
The CAST Application Analytics Dashboard also offers you the possibility of filtering your data. By default, CAST will automatically assign the Category "Technologies" and the technology "Tags" to your Applications. In other words (and for example), Applications containing Cobol source code will be tagged with "Cobol" in the "Technologies" Category.
You can see this in action here (click the "+" button to view the filtering categories):
When using the filtering capabilities, results are displayed on an Application basis. So, for example, if you select "Cobol" in the Technologies category, the CAST Application Analytics Dashboard will automatically update and display only those Applications that contain that particular Technology:
You can also filter within specific Quality or Quantity measure information pages based on Categories (auto and manually defined). For example, in the Technical Size page:
Note that if your administrator has created a Category and no Applications have been assigned a Tag within that category, when filtering on that Category, the CAST Application Analytics Dashboard will display "No values to display" as follows:
Note about tags and categories as tile scopes
It is possible to set a specific tag / category on a specific tile (see Scope under Common plugin parameters in CAST-AAD - Tile management for more information) as a scope. When a tile has a tag / category defined as a scope, the tile will be displayed regardless of the filter applied. The tag will also be mentioned in the tile itself:
You can filter on one or more tags in the same category:
Or on one or more tags from multiple categories:
Resetting a filter
If you have configured a filter, the easiest way to reset it is to remove the tags one by one by:
- clicking the X button as highlighted below:
- using the Unselect All button:
All drill down details pages that list Quality Rule violations include a check box (Only rules with violations) that enables you to filter out any Quality Rules that do not have any violations. This allows you to focus on the information you need:
Once the check box is enabled on an indicator or page, then, during navigation around the dashboard, the filtering will remain active. Navigating to other pages that show a new list of violations will use the most recent setting applied, even though you might change the Application you are looking at. On logout or page reload, the Only rules with violations setting is reset.
Grouping by critical rules
All drill down details pages that list Quality Rule violations include a check box (Only critical rules) that enables you to group together all Quality Rules that are designated as "critical":
Grouping by Quality Rule or Technical Criterion
All drill down details pages that list Quality Rule violations include the ability to list Quality Rules by:
- Quality Rule in alphabetical order (this is the default position)
- Technical Criterion in alphabetical order, then Quality Rule in Weight order - in this mode, a Violation Sum is displayed for each Technical Criterion and each Technical Criterion can be expanded and collapsed as required:
CAST Application Engineering Dashboard / CAST Engineering Dashboard drilldown
If you are licensed to do so and your CAST AI Administrator has configured access (see in 2.2.3. Snapshot generation and validation), you can drill down into the or into the CAST Engineering Dashboard to obtain more detailed information about a specific Application or Quality indicator. To do so:
- In any tile details page, click an Application as highlighted below:
- This will bring you to the Application specific details page:
- Click the microscope icon as highlighted above.
- A warning will then be displayed, click Proceed to continue:
- The login screen for the CAST Application Engineering Dashboard (AED) or the CAST Engineering Dashboard (CED) (depending on what your administrator has configured) will now be displayed in a new tab.
- Login with the credentials supplied by your CAST AI Administrator.
- If access to AED/CED has not been configured, or you do not have appropriate licensing to access AED/CED, then a different warning will be displayed:
CAST AIP build number
The CAST AIP build number is provided in the bottom right corner of each page in the CAST Application Analytics Dashboard:
This number can be provided to CAST Support to help troubleshoot any issues you may have.