TeamCity On-Premises 2024.03 Help

将第三方报告包含在构建结果中

如果您的报告工具以 HTML 格式生成报告,您可以通过自定义选项卡来扩展 TeamCity,以显示第三方报告工具提供的信息。 您的工具所提供的报告可以在 构建结果 页面或 项目主页 页面上显示。

自定义报告选项卡示例

一般流程如下:

  1. 配置构建脚本以生成 HTML 报告(最好是在 zip 归档文件中)。

  2. 配置将报告发布为服务器上的 构建工件:在这个阶段,您可以检查存档是否在构建工件中可用。

  3. 配置 Report 标签,使报告作为构建或项目级别额外的标签可用(见下文)。

报告选项卡支持项目层级。 有两种类型的标签页可供选择:

  • 构建级别:在每个生成了具有指定名称的工件的构建的构建结果 页面上出现。 这些报告选项卡在项目中定义,并在其子项目中继承。 要覆盖子项目中继承的 Report 标签页,请在子项目中创建一个与继承标签页同名的新报告标签页。

  • 项目级别:只有在项目中的构建产生指定报告的工件时,才会出现在特定项目的项目主页上。

要配置报告选项卡,请前往 项目设置 | 报告选项卡,并选择您想要添加的报告选项卡类型。

对于一个 project report tab,请指定以下内容:

选项

描述

标签页标题

在网页用户界面中设定一个独特的报告标签标题。

获取工件

选择构建配置并指定将在标签页上显示其工件的构建。 选择报告应取自最后一次成功、固定、完成的构建,还是具有指定构建号的构建,或者具有指定标签的最后一次构建。

启动页

指定作为报告页面内容显示的工件的路径。 路径必须相对于构建工件目录的根目录。
要使用存档中的文件,请使用 path-to-archive!relative-path 语法,例如: javadoc.zip!/index.html。 查看支持的归档文件列表。

您可以使用字段旁边的文件浏览器 chechoutdirBrowser.png 选择工件。 参数引用在此处得到支持,例如, % \parameter% .zip!index.htm

对于 build report tab,请指定以下内容:

选项

描述

标签页标题

在网页用户界面中设定一个独特的报告标签标题。

启动页

指定作为报告页面内容显示的工件的路径。 路径必须相对于构建工件目录的根目录。
要使用存档中的文件,请使用 path-to-archive!relative-path 语法,例如: javadoc.zip!/index.html。 查看支持的归档文件列表。

您可以使用字段旁边的文件浏览器 chechoutdirBrowser.png 选择工件。 参数引用在此处得到支持,例如, % \parameter% .zip!index.htm

最后修改日期: 16日 7月 2024年