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

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

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

HTML レポート（できれば zip アーカイブ内）を生成するようにビルドスクリプトを構成します。
レポートをビルドアーティファクトとしてサーバーに公開するように構成します。この時点で、アーカイブがビルドアーティファクトで使用可能であることを確認できます。
レポートタブを構成して、ビルドまたはプロジェクトレベルで追加のタブとしてレポートを利用できるようにします（以下を参照）。

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

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

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

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

オプション	説明
タブタイトル	Web UI に表示されるレポートタブの一意のタイトルを指定します。
からアーティファクトを入手する	ビルド構成を選択し、アーティファクトがタブに表示されるビルドを指定します。レポートを最後に成功した、固定された、終了したビルドから取得するか、指定したビルド番号のビルドから取得するか、指定したタグの付いた最後のビルドから取得するかを選択します。
開始ページ	レポートページのコンテンツとして表示されるアーティファクトへのパスを指定します。パスは、ビルドアーティファクトディレクトリのルートからの相対パスである必要があります。アーカイブからファイルを使用するには、`path-to-archive!relative-path` 構文を使用します。たとえば: `javadoc.zip!/index.html` サポートされているアーカイブのリストを参照してください。フィールドの横にあるファイルブラウザーを使用して、アーティファクトを選択できます。ここではパラメーター参照がサポートされています（例: `%parameter%.zip!index.htm`）。

オプション

説明

タブタイトル

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

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

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

開始ページ

レポートページのコンテンツとして表示されるアーティファクトへのパスを指定します。パスは、ビルドアーティファクトディレクトリのルートからの相対パスである必要があります。
アーカイブからファイルを使用するには、path-to-archive!relative-path 構文を使用します。たとえば: javadoc.zip!/index.html サポートされているアーカイブのリストを参照してください。

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

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

オプション	説明
タブタイトル	Web UI に表示されるレポートタブの一意のタイトルを指定します。
開始ページ	レポートページのコンテンツとして表示されるアーティファクトへのパスを指定します。パスは、ビルドアーティファクトディレクトリのルートからの相対パスである必要があります。アーカイブからファイルを使用するには、`path-to-archive!relative-path` 構文を使用します。たとえば: `javadoc.zip!/index.html` サポートされているアーカイブのリストを参照してください。フィールドの横にあるファイルブラウザーを使用して、アーティファクトを選択できます。ここではパラメーター参照がサポートされています（例: `%parameter%.zip!index.htm`）。

オプション

説明

タブタイトル

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

開始ページ

2025 年 4 月 07 日

関連ページ：

アーティファクトのビルド

アーティファクトのビルドはビルドによって生成されたファイルです。通常、これらにはディストリビューションパッケージ、WAR ファイル、レポート、ログファイルなどが含まれます。ビルド構成を作成するときは、一般設定を構成するページでビルドのアーティファクトへのパスを指定します。アーティファクトストレージ：TeamCity には、統合された軽量ビルドアーティファクトリポジトリが含まれています。アーティファクトは、サーバーアクセス可能ファイルシステムまたは外部ストレージに保存されます。ビルドが終了すると...

ビルド結果を扱う

TeamCity には、ホームと設定という 2 つのメインモードがあります。ホームモードでは、プロジェクトレベルとビルド構成レベルでビルド結果が蓄積されます。新しい TeamCity UI を使用している場合は、プロジェクトサイドバーを介してこの階層間を移動できます。各モードには、独自の詳細レベルがあります。プロジェクト全体のビルド統計を確認するには、プロジェクトホームにアクセスしてください。単一のビルド構成の詳細を参照するには、その名前をクリックしてビルド構成ホームを開きます。ホームページで特...

プロジェクト管理者ガイド

このセクションでは、プロジェクト管理に焦点を当てます。TeamCity プロジェクトとビルド構成の作成、ビルドステップの設定、依存関係チェーンの構成などについて説明します。基本的な TeamCity ワークフロー：次のダイアグラムは、基本的な TeamCity ワークフローを示しています。TeamCity サーバーはリポジトリの変更を検出しました。サーバーはこの変更をデータベースに書き込みます。ビルド構成に添付されたトリガーは、データベース内の関連する変更を検出し、ビルドを開始します。トリガー...

ビルドパラメーターの設定

パラメーターは、TeamCity 設定およびビルドスクリプトの構文を介して参照するペアです。パラメーター部分は、生の値 () にすることも、別のパラメーターへの参照 () を含めることもできます。パラメーター型：TeamCity は 3 種類のパラメーターをサポートしています。構成パラメーター — ビルド構成内で設定を共有することを主な目的とするパラメーター。これらのパラメーターを使用して、テンプレートから作成された構成やレシピを使用する構成をカスタマイズすることもできます。TeamCity は...

テストメタデータの報告

TeamCity でのテスト実行は、テストステータス、実行時間、出力を補完するいくつかの追加情報（メタデータ）に関連付けることができます。この情報は、追加のログ、スクリーンショット、数値、タグなどを提供するために使用できます。サービスメッセージを使用して、この種の追加テストデータを TeamCity で報告し、TeamCity UI で表示できます。追加のテストデータの報告：追加のテストデータは、サービスメッセージを使用して、次の属性とともに報告されます。（オプション）は、同じテストの異なるメ...