TeamCity On-Premises 2026.2 Help

Azure Board ワークアイテム

TeamCity を Azure Board Work Items (またはチーム Foundation Work Items) と統合すると、TeamCity UI から 作業項目へのリンクを提供できます。ねこです。削除しないでください。 TeamCity は Azure DevOps サーバー (旧称チーム Foundation サーバー - バージョン 2012 以降) と Azure DevOps Services をサポートしています。

TeamCity UI で作業項目へのリンクを表示する

Azure Board Work Items との統合が有効化されている場合、TeamCity は VCS コミットのコメントに記載された作業項目 ID を自動的に検出します。 これらの ID を対応する作業項目へのリンクに変換し、UI で TeamCity ユーザーに表示します:

  • TeamCity UI で作業項目の基本的な詳細を表示するには、関連するビルド結果の 変更 タブを開き、作業項目 ID の横にあるアイコンにカーソルを合わせます。

  • ビルドで修正された作業項目は、ビルド結果の 課題 タブで表示できます。

  • ビルド構成全体 (個々のビルドだけでなく) に関連する作業項目を表示するには、 ビルド構成ホーム ページの 課題ログ タブを使用します。 リストを特定の範囲のビルドにフィルター処理したり、 解決された課題のみを表示オプションを有効にしてビルドで修正された課題のみを表示したりできます。

さらに、チェンジセットに関連する作業項目がある場合、TeamCity はそれらの情報を取得し、チェンジセットにコメントが追加されていなくても UI に情報を表示できます。

Azure ボード作業項目との統合から最大の利益を得るには、次の推奨事項に従ってください。

  • バージョン管理への変更をコミットするとき、 常に作業項目 ID を記載する はコミットへのコメントの修正に関連していました。

  • 修正された作業項目を課題トラッカーで 解決済み としてマークすると、TeamCity ログで 修正済み ステータスとして表示されます (解決の時刻は実際には重要ではありません)。

Azure Board Work Items への接続を構成する

TeamCity と Azure Board Work Items の統合を有効化するには、プロジェクトレベルで構成されるため、プロジェクト管理者権限が必要です。 プロジェクトの統合を有効にすると、そのすべてのサブプロジェクトでも統合が有効になることに注意してください。 サブプロジェクトで設定が異なる場合は、親プロジェクトの設定よりも優先されます。

統合を有効にするには、次の手順を実行します。

  1. プロジェクト設定を開き、 課題トラッカー設定タブに移動します。

  2. 次の設定で、 チーム Foundation 作業項目 タイプの新しい接続を作成します。

    • 表示名 — 接続名を指定して、他の接続と区別します。

    • サーバー URL — Azure DevOps サーバー URL を https://dev.azure.com/<組織>/<プロジェクト> (Azure DevOps サービス) または http[s]://<ホスト>:<ポート>/tfs/<コレクション>/<プロジェクト> (Azure DevOps サーバー) 形式で入力します。

    • ユーザー名 - Azure DevOps に TeamCity サーバーの実行に使用するユーザーアカウントを選択させる場合は、このフィールドを空のままにするか、 DOMAIN\ユーザー名 文字列を手動で入力します。

    • パスワード — ユーザーの 個人アクセストークンを入力します。 トークンのスコープには、TeamCity からアクセスするリポジトリに対する 作業項目 (読み取り、書き込み、管理)権限が含まれている必要があります。

    • パターン — コメントテキスト内の作業項目 ID を認識するための Java 正規表現パターンを指定します。 一致したテキスト (グループが定義されている場合は最初のグループ) が作業項目番号として使用されます。 最も一般的なケースは #(\d+) です — これにより、 1234 がテキスト #1234 の修正 から作業項目 ID として抽出されます。

カスタム解決済み状態

TeamCity は作業項目のカスタム状態をサポートしています。 例: 解決された状態をカスタマイズするには、 teamcity.tfs.workItems.resolvedStates 内部プロパティクローズ済み?|完了|修正済み|解決済み?|除去済み? に設定します。

2026 年 9 月 11 日