Creating custom HTML/XML/Junit reports

Via the run log QF-Test provides a detailed log about the actions it executed during a test run. The overall results of this run log can be summarized in other reports like the HTML/XML/Junit report.

A not well documented – but gladly used – feature is that it is possible to adapt/change the style/content of these reports to the own needs. Nevertheless, in order to do so, basic programming knowledges are inevitably needed.

The HTML/XML/Junit reports are customizable. So the content of the “name” and “package” attribute can get changed.

The HTML/XML/JUnit reports are generated via an XSLT-Transformation. The therefore needed XSLT sheets are located in the directory <Path to the QF-Test installation directory>\qftest\qftest-$(version)\report.

If you are changing these Sheets, you may want to copy/move them to <Path to the QF-Test installation directory>\qftest\report.

As the XSL transformation sheets in this directory are preferred over the XSLT sheets in the <Path to the QF-Test installation directory>\qftest\qftest-$(version)\report directory. Thus, your modified XSLT sheets will then also be used by later QF-Test versions. However – as an disadvantage – whenever a new QF-Test version is coming out with any XSLT-Sheets improvements, you will not notice these improvements anymore (as QF-Test will keep using the Sheets in the <Path to the QF-Test installation directory>\qftest\report directory).

Notes

The XSLT Identity Transformation may be used in order to get the original XML document out of which the HTML/XML/JUnit-Reports are getting generated:

<xsl:stylesheet version="1.0"  
 xmlns:xsl="http://www.w3.org/1999/XSL/Transform">  
  <xsl:template match="@*|node()">  
    <xsl:copy>  
      <xsl:apply-templates select="@*|node()"/>  
    </xsl:copy>  
  </xsl:template>  
 </xsl:stylesheet>

When generating an HTML report, you may want that QF-Test copies additional files (like additional JavaScript or stylesheet files) into the generated target directory. It is possible to inform QF-Test about such files. Therefore one simply creates a file with the name ‘files-to-copy.txt’. In this text file the additional JavaScript, stylesheet or image files are specified. (One file by line.)