TeamCity On-Premises
 
Get TeamCity On-Premises

Including Third-Party Reports in the Build Results

Edit pageLast modified: 26 February 2021

If your reporting tool produces reports in HTML format, you can extend TeamCity with a custom tab to show the information provided by the third-party reporting tool. The report provided by your tool can be then displayed either on the Build Results page, or on the Project Home page.

Example of a custom report tab

The general flow is as follows:

  1. Configure the build script to produce the HTML report (preferably in a zip archive).

  2. Configure publishing the report as the build artifact to the server: at this point you can check that the archive is available in the build artifacts.

  3. Configure the Report tab to make the report available as an extra tab on the build or project level (see below).

Report tabs support project hierarchy. There are two types of tabs available:

  • Build-level: appears on the Build Results page for each build that produced an artifact with the specified name. These report tabs are defined in a project and are inherited in its subprojects. To override an inherited Report tab in a subproject, create a new report tab with the same name as the inherited one in the subproject.

  • Project-level: appears on the Project Home page for a particular project only if a build within the project produces the specified reports' artifact.

To configure a report tab, go to the Project Settings | Report Tabs and select the type of report tab you want to add.

For a project report tab, specify the following:

For a build report tab, specify the following: