-
Notifications
You must be signed in to change notification settings - Fork 0
AutotestReportingApi
The Autotest Reporting API allows you to embed TKO spreadsheets, tables and graphs into your own HTML pages. This can be used to create powerful, customizable dashboards based on Autotest results.
Currently, only graphs are supported. Spreadsheets and tables are coming soon.
In order to use the Autotest Reporting API, your HTML page needs to load the Autotest Reporting API Javascript library and then call it to create widgets. Here's a simple skeleton:
<!DOCTYPE html> <head> <script type="text/javascript" src="http://your-autotest-server/embedded-tko/autotest.EmbeddedTkoClient.nocache.js"> <script type="text/javascript"> function initialize() { Autotest.initialize("http://your-autotest-server"); // code to setup widgets goes here. for example: var plot = Autotest.createMetricsPlot(document.getElementById("plot_canvas")); plot.refresh(...); // see below } </script> </head> <body onload="initialize()"> <!-- document outline goes here. for example: --> <div id="plot_canvas"></div> </body>
The first script tag loads the Autotest Reporting API library. The
initialize()
function then calls Autotest.initialize()
, which
tells the library where to find the Autotest server running the TKO web
interface. Finally, it can proceed to call Autotest.create*
methods
to create widgets. All Autotest.create*
methods accept a DOM Element
to which they will attach themselves.
You can create a MetricsPlot widget using
Autotest.createMetricsPlot(parentElement)
. Metrics plot widgets have
one method, refresh(parameters)
. This interface will be changing
soon so it won't be documented in detail; please see the example in
frontend/client/src/autotest/public/EmbeddedTkoClientTest
or
ask showard if you would like to use it and have questions.