TeamCity On-Premises 2026.2 Help

サードパーティレポートをビルド結果に含める

レポートツールが HTML フォーマットのレポートを生成する場合、カスタムタブで TeamCity を拡張し、サードパーティのレポートツールが提供する情報を表示できます。 わ。 ツールによって提供されるレポートは、 ビルド結果 ページまたは プロジェクトホーム ページのいずれかに表示できます。

カスタムレポートタブの例

一般的な流れは次のとおりです。

  1. HTML レポート(できれば zip アーカイブ内)を生成するようにビルドスクリプトを構成します。

  2. レポートを ビルドアーティファクト としてサーバーに公開するよう構成します: この時点で、アーカイブがビルドアーティファクトで利用できることを確認できます。

  3. レポート タブを構成して、ビルドまたはプロジェクトレベルで追加のタブとしてレポートを利用できるようにします(以下を参照)。

レポートタブはプロジェクト階層をサポートします。 利用可能なタブは 2 種類あります。

  • ビルドレベル: 指定された名前のアーティファクトを生成した各ビルドの ビルド結果 ページに表示されます。 これらのレポートタブはプロジェクトで定義され、そのサブプロジェクトに継承されます。 サブプロジェクトで継承された レポート タブをオーバーライドするには、サブプロジェクトで継承されたタブと同じ名前で新しいレポートタブを作成します。

  • プロジェクトレベル: 特定のプロジェクトのビルドが指定されたレポートのアーティファクトを生成する場合にのみ、特定のプロジェクトの プロジェクトホーム ページに表示されます。

レポートタブを構成するには、 プロジェクト設定 | レポートタブ に移動し、追加するレポートタブの種類を選択します。

プロジェクトレポートタブ では、以下を指定します。

オプション

説明

タブタイトル

Web UI に表示されるレポートタブの一意のタイトルを指定します。

からアーティファクトを入手する

ビルド構成を選択し、アーティファクトがタブに表示されるビルドを指定します。 レポートを最後に成功した、固定された、終了したビルドから取得するか、指定したビルド番号のビルドから取得するか、指定したタグの付いた最後のビルドから取得するかを選択します。

開始ページ

レポートページの内容として表示するアーティファクトへのパスを指定します。 パスは、ビルドアーティファクトディレクトリのルートに対する相対パスである必要があります。
アーカイブ内のファイルを使用するには、 アーカイブへのパス!相対パス 構文を使用します。例: javadoc.zip!/インデックス.htmlサポートされているアーカイブのリストを参照してください。

フィールドの横にあるファイルブラウザー chechoutdirBrowser.png を使用して、アーティファクトを選択できます。 ここでは パラメーター参照がサポートされています(例: %\パラメーター%.zip!インデックス.htm)。

ビルドレポートタブ では、以下を指定します。

オプション

説明

タブタイトル

Web UI に表示されるレポートタブの一意のタイトルを指定します。

開始ページ

レポートページの内容として表示するアーティファクトへのパスを指定します。 パスは、ビルドアーティファクトディレクトリのルートに対する相対パスである必要があります。
アーカイブ内のファイルを使用するには、 アーカイブへのパス!相対パス 構文を使用します。例: javadoc.zip!/インデックス.htmlサポートされているアーカイブのリストを参照してください。

フィールドの横にあるファイルブラウザー chechoutdirBrowser.png を使用して、アーティファクトを選択できます。 ここでは パラメーター参照がサポートされています(例: %\パラメーター%.zip!インデックス.htm)。

2026 年 9 月 11 日