次の方法で共有

作業項目をオブジェクトにリンクする

Azure DevOps Services |Azure DevOps Server 2022 および Azure DevOps Server 2019

作業項目リンクは、2 つの作業項目または 1 つの作業項目と別のオブジェクトの間の関連付けです。 リンクは、オブジェクト間のリレーションシップを表します。 作業項目のリンクを使って、追跡可能性のための依存関係および関連する作業の追跡、情報の共有、複数のチームや製品が関係する複雑なプロジェクトの管理、コードの変更の追跡、テストなどを行うことができます。

前提条件

カテゴリ 必要条件
プロジェクト アクセス プロジェクト メンバー。
アクセス許可 - 共同作成者 または プロジェクト管理者 セキュリティ グループのメンバー。
- 作業項目の表示または変更を行うには: [このノードの作業項目を表示する] および [このノードの作業項目を編集する] アクセス許可を [許可] に設定します。 既定では、共同作成者グループではこのアクセス許可が [許可する] に設定されています。 詳細については、「作業追跡のアクセス許可とアクセスを設定する」を参照してください。
- クラシック リリース パイプラインの統合オプションを構成するには、リリースのアクセス許可 を編集します。
- 作業項目をコミットおよび pull request にリンクするには、作業項目に割り当てられたエリア パスについて、[このノードの作業項目の編集] アクセス許可が [許可] に設定されている必要があります。 既定では、共同作成者グループにはこのアクセス許可があります。
- 作業項目を表示するには、作業項目に割り当てられているエリア パスについて [このノードの作業項目の表示] アクセス許可を [許可] に設定している必要があります。
アクセスレベル 作業項目を追加または変更するには: 少なくとも利害関係者アクセスが必要です。 パブリックプロジェクトの利害関係者アクセス権を持つユーザーは、ベーシックアクセス権を持つユーザーと同様に、バックログとボード機能に完全にアクセスできます。 詳細については、「利害関係者アクセスクイック リファレンス」を参照してください。
定義されたイテレーション 計画 ペインを使用するためには、チーム管理者 がイテレーション（スプリント）パスを定義し、チーム イテレーションを構成しました。
カテゴリ 必要条件
プロジェクト アクセス プロジェクト メンバー。
アクセス許可 - 共同作成者 または プロジェクト管理者 セキュリティ グループのメンバー。
- 作業項目の表示または変更を行うには: [このノードの作業項目を表示する] および [このノードの作業項目を編集する] アクセス許可を [許可] に設定します。 既定では、共同作成者グループではこのアクセス許可が [許可する] に設定されています。 詳細については、「作業追跡のアクセス許可とアクセスを設定する」を参照してください。
- クラシック リリース パイプラインの統合オプションを構成するには、リリースのアクセス許可 を編集します。
- 作業項目をコミットおよび pull request にリンクするには、作業項目に割り当てられたエリア パスについて、[このノードの作業項目の編集] アクセス許可が [許可] に設定されている必要があります。 既定では、共同作成者グループにはこのアクセス許可があります。
- 作業項目を表示するには、作業項目に割り当てられているエリア パスについて [このノードの作業項目の表示] アクセス許可を [許可] に設定している必要があります。
アクセスレベル 作業項目を追加または変更するには: 少なくとも利害関係者アクセスが必要です。 パブリックプロジェクトの利害関係者アクセス権を持つユーザーは、ベーシックアクセス権を持つユーザーと同様に、バックログとボード機能に完全にアクセスできます。 詳細については、「利害関係者アクセスクイック リファレンス」を参照してください。
定義されたイテレーション 計画 ペインを使用するためには、チーム管理者 がイテレーション（スプリント）パスを定義し、チーム イテレーションを構成しました。

次の種類のリンクは、作業項目と他のオブジェクト間のリレーションシップを管理するのに役立ちます。

リンクの種類のカテゴリ 説明
ビルド 作業項目を (ビルド内で検出またはビルドに統合された) ビルド番号に接続します。
コード 作業項目をブランチ、変更セット、コミット、pull request、タグ、またはバージョン管理された項目に接続します。
GitHubの 作業項目を GitHub リポジトリ ブランチ、コミット、イシュー、または pull request に接続します。
リモート作業 異なる組織で定義された作業項目を接続します。これらの項目は、URL を介して消費、提供、または遠隔で関連付けられています。
要件 URL を使用して作業項目をストーリーボードに接続します。
テスト 作業項目をテスト添付ファイルまたは結果に接続します。
ウィキ 作業項目を Wiki ページに接続します。
作業項目: 作業項目を、次のような作業の側面に接続します。
- 〜に影響される
- 影響
- 子
- 複製
- 重複する
- ハイパーリンク
- リリース段階で統合
- 親
- 先行処理
参照元
- リファレンス
- 関連項目
- 共有ステップ
- 後続処理
-テストケース
- テストした人
- テスト

リモート リンクの種類、ハイパーリンク、添付ファイル、親/子、関連、先行リンクの種類など、作業リンクの種類の詳細については、「 作業リンクの種類」を参照してください。 Azure DevOps SLI を使用して指定できるすべてのリンクの種類の一覧については、 az boards work-item relation list-type コマンドを実行します。

さまざまな機能を使用して、 親/子 リンクの種類を使用するリンクをリンクまたは変更できます。 一部の機能は、使用している Azure DevOps のバージョンによって異なります。 これらのリンクを管理するには、次のオプションを参照してください。

これらのツールを使用すると、ワークフローと設定に基づいて親子リンクを柔軟に管理できます。

Web ポータルで別の作業項目へのリンクを追加するには、次の手順を実行します。

  1. リンクする作業項目を開きます。

  2. 作業項目フォームでは、このタスクを実行する 2 つの方法から選択できます。

    • [関連作業] セクションに移動し、[リンクの追加]>[既存の項目] を選択します。
    • リンクを選択します >リンクを追加>既存項目。

    スクリーンショットは、[リンク] タブから既存の作業項目へのリンクを追加するための強調表示されたボタンのシーケンスを示しています。

  3. [リンクの種類] ドロップダウン リストで、作成するリンクの種類 (子、親、または関連など) を選択します。

  4. リンクする作業項目のフィールド に、リンク先の作業項目の ID を入力するか、ドロップダウンメニューから選択して、リンクの追加を選択してください。

    次の例では、ID が 280 のテスト ケースにリンクの種類として関連を使用しています。

    [リンクを追加] ダイアログ、Web ポータル、既存の作業項目のスクリーンショット。

    リンクは一度に 1 つだけ追加できます。 複数の ID をコンマやスペースで区切って入力することはできません。

    複数の作業項目にリンクするには、その ID をコンマまたはスペースで区切って入力します。 別のプロジェクト内の項目にリンクするための ID がわからない場合は、[その他の操作] を選択します。

  1. pull request の説明で、「#」を入力して #ID 作業項目ピッカーをトリガーします。 一覧には、最近変更した作業項目または割り当てられた 50 個の作業項目が表示されます。

    PR の説明に記号 # を入力したときに生成された作業項目リストのスクリーンショット。

  2. 推奨される作業項目の一覧を絞り込むには、作業項目の種類、ID、またはタイトルに一致する最大 5 つのキーワードを入力します。

    シンボル # の後にキーワードを入力し、検索で結果の作業項目を入力するスクリーンショット。

詳しくは、pull request、コミット、コメントからの作業項目へのリンクに関する記事をご覧ください。

  1. Web ポータルから、バックログまたはクエリ結果ページを開きます。

  2. リンクを追加するには、 作業項目を複数選択 (強調表示) します。

  3. 選択した作業項目に対して [その他のアクション] を選択し、[リンクの追加] を選択してから、[既存の項目へのリンク] または [新しい作業項目へのリンク] を選択します。

    次の例では、製品バックログから複数の項目を選択し、既存のアイテムへのリンク... を選択します。

    バックログのコンテキスト メニューのスクリーンショット、バックログでの項目を複数選択し、コンテキスト メニューを開き、既存作業項目に対する [リンクの追加] を選択します。

  4. [リンクの種類] ドロップダウンメニューから選択します。たとえば、[親]、[子]、または[関連]です。

  5. [作業項目] フィールドに、リンクしたい作業項目の ID を入力し、次に[リンク追加]を選択します。

  1. Web ポータルから作業項目を開いて、[リンク] を選びます。

  2. [その他の操作]>[リンクの編集] を選択します。

    [リンク] タブのスクリーンショット、[その他のアクション] を開いて、[リンクの編集] を選択します。

  3. 変更後のリンクの種類を選択してから、[保存] をクリックします。

    [リンクの編集] ダイアログのスクリーンショット。

作業項目を新しい作業項目にリンクするには、次の手順のようにします。

  1. 作業項目から、[リンク]>[リンクを追加]>[新しい項目]を選択します。

    作業項目に新しい項目リンクまたは既存の項目リンクを追加するためのスクリーンショット シーケンス。

  2. リンクの種類と作業項目の種類を指定し、新しい作業項目とオプションのコメントのタイトルを入力します。 [+ リンクの追加] を選択します。

    [リンクの追加] ダイアログ、[新しい作業項目へのリンク] のスクリーンショット。

    新しい作業項目が開きます。

  3. 追加情報を入力し、作業項目を保存します。

    新しい作業項目として懸案事項が追加されたスクリーンショット。

他の Azure DevOps 組織で定義されているオブジェクトに作業項目をリンクするには、次の手順のようにします。 これを行うことができるのは、両方の組織が同じ Microsoft Entra ID を使ってユーザーを管理している場合のみです。

  1. 作業項目から、[リンク] >[リンクの追加]>[既存のアイテム]を選択します。

    スクリーンショットは、新しく作成された作業項目にリンクを追加するシーケンスを示しています。

  2. [リンクの種類] ドロップダウン メニューから、次のいずれかのリモート リンクの種類を選択します。

    • 使用対象 または Produces For: 異なる組織で定義され、異なるチームによって管理されている作業項目の依存関係を追跡する場合。
    • リモート関連: リンクされる作業項目が異なる組織で定義され、異なるチームによって管理されていますが、相互依存関係が強くない場合。

  3. リモート作業項目の URL を入力し、[リンクの追加] を選択します。

    次の例では、Remote Related リンクの種類を使用して、remotelinkingtest2 組織、RemoteLinking プロジェクトに存在する作業項目 ID 350 にリンクします。

    作業項目リンクの削除のスクリーンショット。

    [リンク] タブで、作業項目へのすべてのリンクの数が管理されます。 Remote Link Countfield は、別のプロジェクトまたは組織で定義されている作業項目にリンクする作業項目に追加されたリンクの数を保持します。

    次の例では、 クラウド アイコンが付いた 2 つのリモート リンクがユーザー ストーリーに追加されているのを示しています。

    [ユーザー ストーリー] フォームのスクリーンショット、[リンク] タブ、2 つの外部リンクが表示されています。

Azure Boards と GitHub リポジトリを接続すると、[GitHub ブランチ]、[GitHub コミット]、[GitHub 問題] および [GitHub pull request] に作業項目をリンクできます。 Azure Boards を使用して作業の計画と追跡を行っている間は、ソフトウェア開発に GitHub を使用できます。

重要

作業項目をリンクできるのは、リポジトリが Azure Boards に接続されている GitHub オブジェクトのみです。 詳しくは、「Azure Boards を GitHub に接続する」と、pull request、コミット、コメントからの作業項目へのリンクに関する記事をご覧ください。

詳細については、「GitHub コミット、プル リクエスト、ブランチ、問題を作業項目にリンクする」および「プル リクエストで作業項目を自動完了する」を参照してください。

  1. バックログまたはクエリの結果ページから、新しい Git ブランチにリンクする作業項目を複数選択します。

  2. [ アクション] アイコンを選択し、[新しいブランチ...] を作成します。詳細については、「作業項目を Git 開発オブジェクトにリンクする」を参照してください。

    バックログのコンテキスト メニューのスクリーンショット、複数のバックログ項目の Git ブランチへのリンクを選択します。

作業項目を既存のビルドにリンクするには、次の手順のようにします。 これらのビルドは、プロジェクト内、または組織内またはコレクション内の他のプロジェクトに含めることができます。

注

この機能では、Azure DevOps Server 2020.1 更新プログラムのインストールが必要です。 詳しくは、Azure DevOps Server 2020 Update 1 RC1 リリース ノートの Boards に関する説明をご覧ください。

  1. 作業項目から、[リンク] >[リンクの追加]>[既存のアイテム]を選択します。

  2. [リンクの追加] ダイアログで、ビルド リンクの種類 (Build、Found in build、Integrated in build のいずれかを選択します。 ビルド番号を指定します。

    ビルド番号は、パイプライン名とビルド名の組み合わせです。 ビルド番号がわからない場合は、[ビルドの検索]を選択します。

    スクリーンショットには、強調表示されたボタン、[ビルドの検索] が表示されています。

  3. ビルドの検索をフィルタリングするためのパラメーターを選択します。

    別のプロジェクト内のビルドにリンクするには、リンク先のビルドが含まれるプロジェクトを最初に選びます。

    たとえば、ビルド番号を指定したり、ビルド パイプラインを選択したり、ビルド結果 ( All、 ucceeded、 partially succeeded、 failed、 canceled など) を選択。 または、[結果] に [成功] を選択した状態で、[ビルドの検索] を選択して、リンクできる利用可能なビルドを一覧表示します。

    プロジェクトが選択され、ビルドが一覧表示された [ビルドの検索] ダイアログのスクリーンショット。

  4. リストからリンクしたいビルドを選んで、次に を選択し [の確認] をクリックしてください。

  5. [リンク 追加] を選択して操作を完了します。

    [ビルド番号] が入力された [リンクの追加] ダイアログのスクリーンショット。

ソフトウェアを開発する際に、どのコードの変更やビルドが作業項目の完了をサポートするのかを取り入れることができます。 チームは、コード ベースへの変更の監査証跡を通じて、どのような作業が行われたか、バグがどのように修正されたかを理解できます。

これらのリンクの構築に使用されるリンクの種類は次のとおりです: Branch、 Build、 Changeset、 Commit、 ビルド、 ビルド、 Pull 要求、 バージョン管理されたアイテム、および リリース環境で統合。 これらの型は、次の図に表示されます。

devops リンクの種類の概念図。

ヒント

作業項目を作成するとき、その作業項目から開発を開始します。 ブランチ、コミット、pull request を作成するときに作業項目 ID を追加することもできます。 Git では、コミット リンクの種類を使って、作業項目とコミットをリンクすることができます。 その方法は次のとおりです。

  • 変更をコミットする前に、Visual Studio 2022 の [Git 変更] または以前のバージョンの Visual Studio の[チーム エクスプローラー] に作業項目 ID を追加します。

    変更をコミットする前に作業項目 ID を追加したり項目をドラッグしたりするスクリーンショット。

  • git-commit コマンドを使い、コメントに作業項目 ID を含めます。 たとえば、#35 Catch null exception のようなコメントをコミットに適用します。 コミットをプッシュすると、システムにより、そのコミットと作業項目 #35 の間にコミット リンクが作成されます。

  • 作業項目から Git 開発用の [開発] コントロールを使用します。 詳細については、「 Drive Git development from a work item in Azure Boards」を参照してください。

次の図に示すように、[デプロイ] コントロールには、2 つのリリース ステージのリリース情報が表示されます。 これには、Azure Boards と統合するように構成されたリリース パイプラインの Git コミットまたはプル要求にリンクされた作業項目が含まれます。

リリースが対象としている複数の環境のスクリーンショット。

デプロイの制御

デプロイ コントロールには、作業項目のリリース ステータスの管理と追跡に役立ついくつかの機能が用意されています。 次の一覧に、これらの機能の概要を示します。

  • 既定の外観: 展開コントロールは、既定で作業項目フォームにおいて、User Story (Agile)、Product Backlog Item (Scrum)、Issue (Basic)、Requirement (CMMI)、Feature、Epic、Bug、Task、Test Case の作業項目タイプに表示されます。

  • カスタム作業項目の種類: 継承されたプロセスを使用するカスタム作業項目の種類が自動的に有効になります。

  • リリース情報: [デプロイ] コントロールには、Azure Boards に統合されたリリース パイプラインの 2 つのステージのリリース情報が表示されます。

  • リンクされた作業項目: このコントロールには、このパイプラインの Git コミットまたは pull request にリンクされている作業項目のみが表示されます。

  • 視覚的な分析情報: さまざまなリリース環境に展開される作業項目の状態を視覚的に把握し、各リリース ステージにすばやく移動して実行します。

    作業項目フォーム、[デプロイ] コントロールのスクリーンショット。

  • コミットの関連付け: ビルド内のコミットに関連付けられている作業項目には、リリースの状態が表示されます。

  • プロジェクト スコープ: 同じプロジェクト内の作業項目のみが、リリース パイプラインが定義されている場所にリンクされます。

    リリースが対象としている複数の環境を示すスクリーンショット。

  • ステージの可視性: 作業項目を開くと、ステージをリアルタイムで表示できます。

    テスト、ステージング、運用、開発など、リリース設定ステージのスクリーンショット。

[デプロイ] コントロールを設定するには、次の手順のようにします。

注

デプロイ コントロールを使用するには、クラシック リリース パイプラインを構成する必要があります。 YAML パイプライン用に定義されたリリース ステージへのリンクはサポートされていません。

  1. 「複数ステージの継続的デプロイ (CD) パイプラインを定義する」の説明に従って、クラシック リリース パイプラインを定義し、リリース ステージを設定します。

  2. パイプラインを構成します。

  3. Azure Repos Git リポジトリ内のコミットまたは pull request に、1 つ以上の作業項目をリンクします。 詳細については、以下を参照してください:

  4. パイプラインを実行します。

Team Foundation バージョン管理 (TFVC) を使用すると、作業項目をバージョン管理の変更セットまたはバージョン管理されたソースコードファイルに、変更セット および バージョン付き項目 リンクの種類を使用して関連付けることができます。 保留中の変更をチェックインすると、または [担当作業] を使って変更をチェックインすると、作業項目が変更に自動的にリンクされます。 詳細については、「 作業の確認」を参照してください。

チーム エクスプローラー、My Work、保留中の変更、チェックインのスクリーンショット。

テスト関連のリンクの種類は、テスト ケース管理作業項目を相互に、または他の作業項目にリンクします。 Web ポータルまたは Microsoft Test Manager から、テスト スイート用に定義されたテスト ケースと、テスト計画用に定義されたテスト スイートを表示することができます。 これらのオブジェクトは、リンクの種類を介して相互にリンクされません。

テスト対象/テスト担当者リンクの種類を使って、作業項目をテスト ケースにリンクできます。 作業項目を他の作業項目にリンクするために使用するのと同じリンク コントロールを使用します。

次の図では、テスト管理作業項目の種類で使用できるすべてのリンクの種類が示されています。 テスト管理オブジェクト間のほとんどのリンクは、 Test ページまたは Microsoft Test Manager からタスクを実行することによって発生します。

テスト オブジェクトのリンクに使用されるリンクの種類のスクリーンショット。

たとえば、テスト ケースに共有ステップを追加すると、テスト ケース/共有ステップのリンクの種類を使って、自動的にリンクされます。 詳細については、「テスト ケース間でステップを共有する」を参照してください。

ステップを示すテスト作業項目フォームのスクリーンショット。

[共有ステップの挿入] ダイアログのスクリーンショット。

[テスト] セクションから、自動的にリンクされるテスト プラン、テスト スイート、テスト ケースを追加できます。 特定のリンクの種類を使用してこれらの項目を追加することはできません。 テスト システムは、テスト ケースとテスト計画に対するテスト結果の関連付けを作成および管理します。

ハイパーリンクまたはストーリーボードのリンクの種類を使って、作業項目をネットワーク共有上にある Web サイト、ネットワーク共有、またはドキュメントにリンクできます。 どちらのリンクの種類も一方向リンクです。 これらのリンクの種類を追加するには、前に説明したのと同じコントロールを使用します。

ストーリーボード リンクの種類を使用する場合は、作業項目の仕様を提供するストーリーボードまたはドキュメントを指定します。 このリンクの種類により、チームは共有ファイルにアクセスし、コメントを追加できます。

作業項目を URL にリンクするためのハイパーリンクまたはストーリーボードのリンクの種類のスクリーンショット。

Azure DevOps には、依存関係を表示し、関連する作業を追跡するいくつかの方法が用意されています。

  • クエリ エディター: クエリ エディターを使用して、特定の作業項目にリンクされているすべての作業項目を表示するカスタム クエリを作成できます。
  • バックログとボードの: バックログ ビューとボード ビューでは、作業項目間の親子関係が表示され、依存関係を一目で確認できます。
  • 依存関係トラッカー: 依存関係トラッカーは、作業項目間の依存関係を視覚的に表す Power BI レポートです。

作業項目にリンクされているすべてのオブジェクトの一覧を表示するには、次の手順のようにします。

  1. 作業項目を開き、[リンク] を選びます。 [リンク] タブでは、リンクされているすべてのオブジェクトの数が示されます。 リンクされたオブジェクトは、リンクの種類ごとにグループ化され、各グループの個数も示されます。

    リンク オブジェクトの数を含む [リンク] タブのスクリーンショット。

  2. (省略可能) 各グループを展開したり、折りたたんだりします。また、対応する列タイトルを選んで、各グループ内を [状態]、[最終更新]、または [コメント] で並べ替えます。

    たとえば、次の [リンク] タブは、作業項目の 64 個のリンク オブジェクトの一部を表示します。

    多くのリンク オブジェクトが含まれる [リンク] タブのスクリーンショット。

    感嘆符 が前に付いているリンクは、ビルド、リリース、または他のオブジェクトが削除されていることを示します。 アイテム保持ポリシーのため、これらのオブジェクトは一定の期間が過ぎると自動的に削除されます。

リンクされた作業項目のクエリ

階層リンクに基づいて項目をフィルター処理するには、[作業項目のツリー] クエリの種類を使います。 すべてのリンクの種類に基づいて項目をフィルター処理するには、[作業項目とダイレクト リンク] を使います。

特定のリンクの種類で他の作業項目にリンクされている作業項目を検索するには、プライマリとセカンダリの作業項目のセットを示すクエリを使います。

  • プライマリ セットはフィールド条件を満たしています。
  • セカンダリ セットは、プライマリ セットにリンクされます。

リリース内で作業項目のクエリを実行することはできませんが、外部リンクを使って作業項目のクエリを実行することはできます。 検索を絞り込むには、クエリ フィルターをさらに追加します。

詳細については、「リンクまたは添付ファイル数による作業項目の照会」を参照してください。

Test Plans、テスト スイート、テスト ケースの階層ビューを表示するクエリを構築することはできません。 これらの項目は、親/子やその他のリンクの種類を使って一緒にリンクされません。 階層は、 Test>Test Plans ページでのみ表示できます。 詳細についてはテスト計画およびテスト スイートの作成 を参照してください。

作業項目のリンクを削除するには、次の手順のようにします。

  1. 作業項目を開きます。
  2. [リンク] タブを選んで、リンクの一覧を表示します。
  3. 削除するリンクを選んでから、[リンクの削除] を選びます。
  4. リンクを削除することを確認します。

作業項目がコミットまたはプル要求にリンクされると、その作業項目は引き続きリリース ステージの一部として表示されます。 たとえば、テスト条件に合格しなかった作業項目がある場合は、その項目をビルドとリリースから削除できます。

作業項目を削除して今後のビルドとリリースに関与しないようにするには、直近のコミットと pull request へのリンクを削除します。

関連コンテンツ