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

On this page:

Target Audience:

  • Consumers of the information (i.e. those that will be using the CAST Application Analytics Dashboard)
  • CAST AI Administrators
Summary: This page provides instructions for using the CAST Application Analytics Dashboard, i.e. how to login, what information is available etc.

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:

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:

http://<server>:[<port>]/CAST-AAD

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:

Note that:

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.

Note that the email address and text for both options can be modified. Please see: CAST-AAD-AED - Lost password and request access configuration.

Password lost

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.

Request access

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.

Note that the CAST Application Analytics Dashboard features a server cache to improve the speed of data display. This does mean, however, that very recent changes in data (i.e. a new snapshot generation) may not instantly appear in the dashboard. If this is the case, the server cache needs to be manually reloaded. See CAST-AAD-AED - Reload the cache.

Landing page

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:

Single Application

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.

Multiple Applications

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:

Note that this is known as filtering and is explained in more detail below.

Clickable tiles

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:

Overview

This section is visible in both the Multi-application and Application landing pages.

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):

Evolution

This section is visible in both the Multi-application and Application landing pages

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)

This section is visible in the Application landing page only.

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.

Note that if no data is displayed in the EFP tiles, then this means that only one snapshot is available therefore no comparison can be made.

Clicking a tile

Note that the tiles are fully configurable by the CAST AI Administrator. Please see CAST-AAD - Tile management for more information.

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.:

  • AFP
    • Function Point information:
      • Number of Automated Functions Points (AFP)
      • Number of Data Function Points
      • Number of Transactional Function Points.
      • etc.
    • Sizing information:
      • Number of Decision Points
      • Number of Critical Violations
      • Number of Critical Violations per Function Point
  • EFP
    • 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:

Columns
Description
Type
Occurs
Element TypeWhether this object is a Data Function or a TransactionString1
Object NameFull nameString1
Nb of FPsNumber of Function Points for this OMG-compliant Automated Function Points FunctionInteger1
TypeOMG-compliant Automated Function Points Function typeString0..1
DETData Element TypeInteger0..1
RETRecord Element TypeInteger0..1
EIFExternal Interface FileInteger0..1
ILF Internal Logical FileInteger0..1
FTRFile Type ReferencedInteger0..1
Object TypeType of this OMG-compliant Automated Function Points FunctionString1
Module nameName of a functional module containing this OMG-compliant Automated Function Points FunctionString1
TechnologyTechnology to which this OMG-compliant Automated Function Points Function belongsString1

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:

Columns
Description
Type
Occurs
Element TypeWhether this object is a Data Function or a TransactionString1
Object NameFull nameString1
Nb of FPsNumber of Function Points for this OMG-compliant Automated FunctionInteger1
FP detailsDetails on the Function Points for this OMG-compliant Automated FunctionString1
Object TypeType of this IOMG-compliant Automated FunctionString1
Module nameName of a functional module containing this OMG-compliant Automated FunctionString1
TechnologyTechnology to which this OMG-compliant Automated Function belongsString1

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:

Note:

  • 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 usernameAvailable options
noneOnly 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_ADMINIn 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.

Snapshot selection

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.

Scope selection

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).

Filters

Your CAST Administrator can manually add additional categories to enhance the filtering possibilities. Please see CAST-AAD - Tag and category management for more information.

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:

When applying a scope to a tile, the global filter still applies (except that Applications outside the initial scope are not considered, i.e. if we select to display scores for a specific Vendor, only applications from that Vendor will be displayed after the filter applies).

Combining filters

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:

Violation filters

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 Configure access to the CAST Application Engineering Dashboard/CAST Engineering Dashboard from the CAST Application Analytics Dashboard in 2.2.3. Snapshot generation and validation), you can drill down into the CAST Application Engineering Dashboard - AED 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.

  • No labels