This documentation is no longer maintained and may contain obsolete information.
REST API
The CAST Application Intelligence Platform (AIP) is an objective and repeatable way to measure and improve the Application Software Quality of multi-platform, multi-language, and multi-sourced applications. CAST AIP stores a large amount of data about your Applications and provides results through interfaces called the Health Dashboard and the Engineering Dashboard. If you don't want to directly use either of these dashboards and prefer to develop a specific use case according to your business requirements, CAST AIP also provides a REST API solution. This API is aimed at programmers:
- Request CAST AIP data from the CAST Application Intelligence Platform in an easy way to build reports on your portfolio or a specific application
- Integrate some specific high level CAST AIP results into external Management Portals (Rational insight, Excel, BO, Qlickview, custom portal etc.)
- Push specific CAST AIP results into bug tracking solutions such as JIRA, Team Foundation Server etc.
- The CAST Report Generator uses the REST API to access the data it needs.
CAST provides documentation for using the REST API to access the data you require:
- REST API Reference Documentation
- a tutorial type documentation is also embedded into both the Health Dashboard / Engineering Dashboard and into the RestAPI.war. You can access it by using this URL:
http://server:[port]/<webapp>/static/RESTAPITutorial.html
The REST API is delivered as follows:
Health Dashboard
The REST API is delivered as part of the Health Dashboard (the dashboard uses it to display the results). By accessing the following URL in your Health Dashboard, you can start to use the API:
http://server:[port]/CAST-Health/static/default.html
Engineering Dashboard
The REST API is delivered as part of the Engineering Dashboard (the dashboard uses it to display the results). By accessing the following URL in your Engineering Dashboard, you can start to use the API:
http://server:[port]/CAST-Engineering/static/default.html
REST API WAR file
CAST also provides a standalone REST API WAR file which can be deployed and configured on your Apache Tomcat application server, in exactly the same way as the Health Dashboard / Engineering Dashboard (see Installing and configuring the CAST-RestAPI.war). This WAR does not include the Health Dashboard nor Engineering Dashboard.
You can find the WAR file in the WARS folder in your CAST AIP installation folder:
Once the WAR is deployed and configured,you can access it as follows (the first URL redirects to the second):
http://server:[port]/CAST-RestAPI/welcome.html http://server:[port]/CAST-RestAPI/static/default.html
Note that you can configure the REST API to interact with a Dashboard or a Measurement Service - simply define the relevant schema name in the context.xml file when you deploy it (see Installing and configuring the CAST-RestAPI.war).
API for CAST Analysis and Dashboard Services
The following guides describe certain tables and views that can be used to extract information.
Apache Drill for CAST AIP
The following guide provides installation and deployment instructions for Apache Drill. Apache Drill can be used with third-party Business Intelligence tools (eg Excel, Tableau, Qlickview, MicroStrategy...) or CAST field extensions to exploit the results produced by CAST AIP via the CAST RestAPI:
Integration of CAST Action plan into Atlassian JIRA
The following guide provides instructions for enabling an integration of the CAST AIP Action Plan into the Atlassian JIRA bug tracking system. CAST Action Plan items can be automatically pushed into JIRA and converted into a bug ticket that can be assigned to the development team:
Using CAST AIP data in Excel with Power Query and the RestAPI
The following guide provides information about how to setup and configure Microsoft Excel to display CAST AIP data using Power Query and the RestAPI: