TeamCity オンプレミス 2026.1 ヘルプ

XML レポート処理

XML レポート処理 ビルド機能を使用すると、外部ツールによって生成されたレポートファイルを TeamCity で使用できます。TeamCity はディスク上の指定されたファイルを解析し、その結果をビルド結果として報告します。

レポート解析は、サービスメッセージを介してビルド内から開始することもできます。

XML レポート処理は以下をサポートします。

  • テストフレームワーク :

    • JUnit Ant タスク

    • Maven Surefire/Failsafe プラグイン

    • NUnit コンソールの XML レポート

    • TRX レポート

    • Google Test XML レポート

    • CTest からの XML 出力

  • コードインスペクションツール :

    • SpotBugs (旧称 FindBugs、コードインスペクションのみ): SpotBugs ネイティブ形式のみがサポートされています (対応する xsd(英語) を参照)。SpotBugs Maven プラグインによって生成される XML レポートはサポートされていません。スキーマレイアウトと要素が完全に異なります。

    • PMD

    • チェックスタイル

    • JSLint XML レポート

  • コード重複ツール :

    • PMD コピー / 貼り付け検出機能 XML レポート

バンドルされている XML Report Processing プラグインは、指定されたレポートパスを監視し、一致するファイルが検出されると、それらは指定されたレポートタイプに従って解析されます。一部のレポートタイプでは、部分的に保存されたファイルの解析がサポートされているため、最初のデータが利用可能になるとすぐにレポートが開始され、ディスクに書き込まれるにつれてより多くのデータがレポートされます。

プラグインは、ビルドの開始以降に更新されたファイルのみを考慮に入れます(最後の修正ファイルのタイムスタンプによって決定されます)。

XML レポート処理の設定

XML レポート処理をビルド機能として追加し、その設定を構成します。

  • レポートタイプを選択し、+|-:path の形式で監視ルールを指定して、コンマまたは改行で区切ります。

+|-: 接頭辞のないパスは、インクルードとして扱われます。Ant スタイルのワイルドカードがサポートされています。たとえば、+dir/**.xml dir ディレクトリに .xml 拡張子を持つすべてのファイルを含めるを意味し、-:**/test_old.xmlすべてのディレクトリで、test_old.xml ファイルを除外しますを意味します。

  • ビルドログへの詳細なログ記録を有効にするには、詳細出力オプションをオンにします。

  • FindBugs レポート処理の場合は、エージェント上の FindBugs インストールへのパスを指定する必要があります。これは実際のバグパターン、カテゴリ、それらのメッセージを取得するために使用されます。

  • FindBugs、PMD、Checkstyle コードインスペクションレポート処理の場合、最大エラーおよび警告制限を指定できます。これを超えると、ビルドが失敗します。制限がない場合は、これらのフィールドを空白のままにします。

実装の詳細については、XML テスト報告(英語)リポジトリを参照してください。プラグインは 2023 年 7 月から社内で開発されているため、リポジトリは更新されなくなりましたが、参照用に引き続き利用できます。

2026 年 4 月 07 日

関連ページ:

ビルド機能を追加する

ビルド機能は、追加の機能を有効にするために任意のビルド構成に追加できる機能です。例: ステータス発行者のコミットビルド機能は、コードファイルを保存する VCS に TeamCity ビルド結果を公開し、調査自動割り当ては最新の変更によってビルドが壊れたユーザーを識別し、これらの問題を解決するタスクを自動的に割り当てます。構成されたビルド機能は、削除することなくいつでも一時的に無効にできます。TeamCity ビルドの特徴:TeamCity には、構成に追加できる次のビルド機能が付属しています。A...

サービスメッセージ

サービスメッセージは、ビルドに関するコマンド / 情報をビルドスクリプトから TeamCity サーバーに渡す特別に構成されたテキストです。TeamCity、それらはビルドの標準出力ストリームに書き込まれる必要があり、ビルドステップから出力またはエコーされますによって処理されます。例:echo ##teamcity[<messageName> 'value']echo

ビルドチェックアウトディレクトリ

ビルドチェックアウトディレクトリは、特定の VCS ルートからのビルドソースがチェックアウトされる TeamCity エージェントマシン上のディレクトリです。ビルド構成が同じ VCS ルートで構成されている場合、このディレクトリは複数のビルド構成間で共有できます。詳細については、デフォルトのチェックアウトディレクトリおよびカスタムチェックアウトディレクトリを参照してください。チェックアウトプロセス:チェックアウトプロセスは、次のように VCS チェックアウトモードの影響を受けます。エージェント側チ...

VCS ラベリング

TeamCity は、バージョン管理システムで特定のビルドのソースに(自動または手動で)ラベルを付ける(タグを付ける)ことができます。適用されたラベルとその適用ステータスのリストは、ビルド結果の変更タブに表示されます。自動 VCS ラベル付け:TeamCity を設定して、ビルドのステータスに応じてビルドのソースに自動的にラベルを付けることができます。ラベル付けは標準の通知イベントではありません。ビルドが終了した後にバックグラウンドで実行され、ビルドステータスには影響しません。ただし、現在のビ...