TeamCity On-Premises 2026.2 Help

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 レポートは NOT サポートされています: スキーマのレイアウトと要素が完全に異なります。

    • PMD

    • チェックスタイル

    • JSLint XML レポート

  • コード重複ツール は:

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

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

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

XML レポート処理の設定

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

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

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

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

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

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

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

2026 年 9 月 11 日