TeamCity On-Premises 2024.07 Help

Including Third-Party Reports in the Build Results

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:

Option

Description

Tab title

Specify a unique title of the report tab that will be displayed in the web UI.

Get artifacts from

Select the build configuration and specify the build whose artifacts will be shown on the tab. Select whether the report should be taken from the last successful, pinned, finished build or the build with the specified build number or the last build with the specified tag.

Start page

Specify the path to the artifacts to be displayed as the contents of the report page. The path must be relative to the root of the build artifact directory.
To use a file from an archive, use the path-to-archive!relative-path syntax, for example: javadoc.zip!/index.html. See the list of supported archives.

You can use the file browser chechoutdirBrowser.png next to the field to select artifacts. Parameter references are supported here, for example, %parameter%.zip!index.htm.

For a build report tab, specify the following:

Option

Description

Tab title

Specify a unique title of the report tab that will be displayed in the web UI.

Start page

Specify the path to the artifacts to be displayed as the contents of the report page. The path must be relative to the root of the build artifact directory.
To use a file from an archive, use the path-to-archive!relative-path syntax, for example: javadoc.zip!/index.html. See the list of supported archives.

You can use the file browser chechoutdirBrowser.png next to the field to select artifacts. Parameter references are supported here, for example, %parameter%.zip!index.htm.

Last modified: 26 February 2021