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

この記事では、次のタスクを行う方法について説明します。

既存リンクのリンクの種類を変更する

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

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

   

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

   

4. 作業項目を保存します。

作業項目をリモート作業項目にリンクする (組織間)

Microsoft Entra ID を使っている組織は、組織をまたいで異なるプロジェクトに存在する作業項目にリンクできます。 示されているように、次のリンクの種類を使います。

• Consumes From または Produces For リンクの種類は、さまざまな組織で定義され、異なるチームによって管理されている作業項目の依存関係を追跡する場合に使用します。
• リモート関連リンクの種類は、リンクされる作業項目が異なる組織で定義され、異なるチームによって管理されているが、厳密に型指定された相互依存関係がない場合に使います。

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

1. 次のリモート リンクの種類のいずれかを選びます。

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

2. [リンクの追加] ダイアログで、リンクの種類を選び、リモート作業項目の URL を入力して、[OK] を選びます。

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

   

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

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

作業項目を pull request にリンクする

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

   

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

   

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

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

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

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

複数の作業項目を新しい Git ブランチにリンクする

バックログまたはクエリ結果のページで、新しい Git ブランチにリンクする複数の作業項目を選択し、 アクション アイコンを選んでから、[新しいブランチ] を選びます。詳細については、Git 開発オブジェクトへの作業項目のリンクに関する記事を参照してください。

作業項目をビルドにリンクする

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

1. 作業項目の [リンク] タブで、[リンクの追加]>[既存の項目] を選びます。

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

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

   

3. [Link builds] (ビルドのリンク) ダイアログで、ビルドの検索をフィルター処理するパラメーターを選択します。

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

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

   

4. 一覧からリンク先のビルドを選んで、[OK] を選びます。

5. [リンクの追加] ダイアログで [OK] を選んで操作を完了します。

   

[リンクの追加] ダイアログで、作業項目を既存のビルドにリンクできます。

1. 作業項目の [リンク] タブで、[リンクの追加]>[既存の項目] を選択します。

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

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

   

3. [Link builds] (ビルドのリンク) ダイアログで、ビルドの検索をフィルター処理するパラメーターを選択します。

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

   

4. 一覧からリンク先のビルドを選んで、[OK] を選びます。

5. [リンクの追加] ダイアログで [OK] を選択して操作を完了します。

   

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

Azure CLI を使用してリンクを追加、削除、または表示する

az boards work-item relation コマンドを使って、作業項目へのリンクの追加、削除、詳細表示を行うことができます。 詳細については、「 Azure DevOps CLI の概要」を参照してください。

リンクの種類には、作業リンク、リモート リンク、ハイパーリンク、添付ファイルがあります。 指定できるすべてのリンクの種類の一覧を確認するには、az boards work-item relation list-type コマンドを実行します。

az boards work-item relation add
az boards work-item relation remove
az boards work-item relation show

次の例では、組織は fabrikam プロジェクト ID は aaaaaa-0000-1111-2222-bbbbbbbbbbbb に対応しています。 出力を表示するために表形式が使用されます。 他の形式については、「Azure CLI コマンドの出力形式」を参照してください。

作業項目のリンク

1 つまたは複数の作業項目を 1 つの作業項目にリンクするには、az boards work-item relation add コマンドを入力します。

必須パラメーターには、リンク先の作業項目の ID とリンクの種類が含まれます。 サポートされているリンクの種類には、 Parent、 Child、 Related、 Remote Relatedがあります。 すべてのリンクタイプのリストについては、 az boards の作業項目関係リストタイプ コマンドを実行します。

同じ組織内で定義されている作業項目の場合は、作業項目 ID またはターゲット URL を指定する必要があります。 リモート組織で定義されている作業項目の場合は、ターゲット URL を指定します。 ID または URL をコンマで区切って複数の値を指定できます。

az boards work-item relation add --id
                                 --relation-type
                                 [--detect {false, true}]
                                 [--org]
                                 [--target-id]
                                 [--target-url]

次のコマンドは、作業項目 ID=2807 を作業項目 ID=2794 にリンクの種類 Child を使用してリンクします。 このコマンドは、作業項目に対して現在定義されているすべてのリンクの一覧を返します。

az boards work-item relation add --id 2794 --relation-type Child --target-id 2856 --output table
Are you sure you want to remove this relation(s)? (y/n): y
Relation Type    Url
---------------  -------------------------------------------------------------------------------------------------
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2850
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2808
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2820
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2856
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2811
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2876
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2801
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2877
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2805
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2807

リンクされた作業項目の情報を表示するには、ブラウザーに一覧表示される URL のいずれかを入力します。

作業項目のリンクを削除する

1 つの作業項目からリンクされた作業項目を 1 つ以上削除するには、az boards work-item relation remove コマンドを入力します。

必須パラメーターには、リンクを削除する作業項目の ID とリンクの種類が含まれます。 同じ組織に定義されている作業項目のみリンクを削除できます。 リモート リンクの種類を除いて、サポートされているリンクの種類を指定できます。

ターゲット作業項目 ID を指定する必要があります。 ID または URL をコンマで区切って複数の値を指定できます。

az boards work-item relation remove --id
                                    --relation-type
                                    --target-id
                                    [--detect {false, true}]
                                    [--org]
                                    [--yes]

次のコマンドは、リンクの種類 Child を使用した、作業項目 ID=2794 から作業項目 ID=2856 へのリンクを削除します。 このコマンドは、作業項目に対して現在定義されているすべてのリンクの一覧を返します。

az boards work-item relation remove --id 2794 --relation-type Child --target-id 2807 --output table
Are you sure you want to remove this relation(s)? (y/n): y
Relation Type    Url
---------------  -------------------------------------------------------------------------------------------------
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2850
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2808
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2820
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2856
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2811
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2876
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2801
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2877
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2805 

リンクされた作業項目の情報を表示するには、ブラウザーに一覧表示される URL のいずれかを入力します。

1 つの作業項目に対して作成されたリンクの詳細を表示する

1 つの作業項目にリンクされている作業項目を表示するには、az boards work-item relation show コマンドを入力します。 返される可能性があるすべてのリンクの種類の一覧を確認するには、az boards work-item relation list-type コマンドを実行します。

az boards work-item relation show --id
                                  [--detect {false, true}]
                                  [--org]

次のコマンドは、fabrikam 組織の作業項目 ID=2931 に定義されているリンクの詳細を表形式で一覧表示します。

az boards work-item relation show --id 2931 --output table
Relation Type    Url
---------------  -----------------------------------------------------------------------------------------------------------------------------------
Related          https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2932
Successor        https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2932
Remote Related   https://dev.azure.com/fabrikam-fiber5/bbbbbbbb-1111-2222-3333-cccccccccccc/_apis/wit/workItems/1777
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2930
Predecessor      https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2933
Attached File    https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/attachments/1cc6c026-b4ed-420c-bfe6-065be726cba7

リンクされた作業項目の情報を表示するには、ブラウザーに一覧表示される URL のいずれかを入力します。 添付ファイルの URL を選択して、添付ファイルをダウンロードします。