The ReadyAPI reporting feature uses the JasperReports engine. You can fully customize your reports both at project and global levels with JasperReports templates, since they use an XML-like syntax.
To learn more about JasperReports and its template language, visit the official website.
You can also use a free tool, iReport, to work with your report templates. The installation package is available here. Using this tool, you can edit the JRXML files, which ReadyAPI uses to store the report templates.
To learn the basics of ReadyAPI reporting, see Getting Started With Reporting.
Working With the Reporting Window
Using the Reporting window, you can work with global and project-specific report settings. To open it, select Project > Reporting from the main menu.
Switch between the tabs to view reports, subreports, templates, or project level report parameters.
You can create, remove, and edit project level items in any way.
|You cannot edit global items in the ReadyAPI UI. If you need to edit them, apply the changes you want in a third-party editor, then click in the Reporting window, or restart ReadyAPI.|
ReadyAPI reports have the following structure:
Main Reports are the top level templates, which appear in the Create Report dialog. To view them, switch to the Available Reports tab in the Reporting window.
The Main Report template is a standard JasperReport template. Its data source is a report-specific model item. For example, when ReadyAPI creates a load test printable report, it passes the WsdlLoadTest object to the report. You can define the properties of this object as Jasper fields in the report, and then use them.
Main reports include Subreports. Subreports use the standard JasperReports subreport feature with the ReadyAPI-specific URL prefix
"subreport:". Subreports get data from a specific data source, which is available during report generation. On the Subreports tab, you can see all the available subreports and their data sources.
For example, the MetricsReport subreport gets data from the ReportMetrics data source. You can use that subreport in main reports using the following syntax:y="98" width="535" height="30" isRemoveLineWhenBlank="true">
As you can see,
subreportExpressionuses a custom
"subreport:"URL syntax. ReadyAPI uses it to locate the subreport template you need. The fields from the
TestSuiteMetricsdata source are defined in the MetricsReport template.
<field name="name" class="java.lang.String"/>
<field name="value" class="java.lang.String"/>
<field name="category" class="java.lang.String"/>
<field name="icon" class="java.lang.String"/>
<reportElement x="253" y="31" width="282" height="14"/>
<reportElement style="ColumnHeader" isPrintRepeatedValues="false" x="0" y="0" width="535" height="24" isRemoveLineWhenBlank="true"/>
<reportElement x="20" y="31" width="233" height="14"/>
Templates allow managing common blocks of the template XML code.
For example, you can use that template to add a logo to your report:
You can then insert it into a report as a property expansion.
Parameters allow you to apply changes to the report content without recompiling the template.
You can find them on the Parameters tab.
ReadyAPI passes parameter values to JasperReports as standard Jasper parameters.
For example, the following template defines the HeaderLogo parameter:
JRXML<parameter name="HeaderLogo" class="java.lang.String" isForPrompting="false">
Then, you can use the following code to apply the header logo:
JRXML<image scaleImage="Clip" hAlign="Right" isUsingCache="false" onErrorType="Blank">
<reportElement x="0" y="0" width="535" height="51"/>
|Note:||You can use property expansions within any of these templates or parameter values. For example, you can show the current user name in the report. To do that, just insert the
ReadyAPI has the Main Report** -> Subreport(*) structure. Both main reports and subreports can use multiple templates (with property expansions) or parameters (with Jasper parameters).
ReadyAPI stores all global report templates in the bin/reports directory (ReadyAPI_installation/bin/reports). The directory contains the following folders:
Templates relating to load testing reports.
Contains images that use the
Contains all global main report templates. The name of each subdirectory corresponds to the appropriate value in the Report Type column on the Available Reports tab.
Contains all global subreport templates. The name of each subdirectory corresponds to the appropriate value in the Report Type column on the Subreports tab.
Contains all global templates.
If you open one of these directories, you will see that ReadyAPI stores each template in two files:
A .jrxml file: A clean Jasper template which you can edit in any JasperReports editor or text editor.
A -config.xml file: Contains the metada of the ReadyAPI template.
To edit a global item template:
Apply the changes made to the JRXML file and save them.
Click in the Reporting window of ReadyAPI.
Styles and Images
ReadyAPI reports use the common styles.jrtx template. Use the following line to allow reports to use the template:
This file contains style definitions for various report elements, like headlines. You can edit the file to change the appearance of your reports.
As for logos and images, ReadyAPI stores them in the logos directory. You can refer to them by using the following code line:
Custom Global Reports
If you want to customize the appearance of global reports without editing the default ones, you can use the Custom Global Reports feature.
Create a local copy of the global reports directory.
Customize the templates stored in the directory in a way you need.
In ReadyAPI Preferences, specify the path to the directory on the ReadyAPI tab:
All the reports and templates in the directory you have selected will appear as global reports on the corresponding tabs of the Reporting window.
Project Level Report Storage
When you create custom project level reports, ReadyAPI stores them in the project file with the other project data. This allows you to redistribute the necessary data easily.
If you save your project as a composite project, ReadyAPI will store reports in the composite project’s directory with the structure similar to the global one. Then you can edit your reports by using external tools, as you do this when working with global reports. To reload such a report, click in the Reporting window.
Setting a Custom Report Library
You can find the path to the custom report library you saved in Preferences in the settings.xml file in your user directory.
|If you have not specified the path to a custom report library, ReadyAPI will use the default report directory (<ReadyAPI Installation>/bin/reports).|
When you run continuous integration, make sure you have prepared the settings.xml file and selected the correct location of the custom report library.
To specify the settings file to be used in Maven, add the following line to pom.xml:
To set the location in Groovy, add the line below: