作業項目をオブジェクトにリンクする
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
作業項目のリンクは、2 つの作業項目の間、または作業項目と別のオブジェクトとの間の関係が記述されている関連付けです。 作業項目のリンクを使って、追跡可能性のための依存関係および関連する作業の追跡、情報の共有、複数のチームや製品が関係する複雑なプロジェクトの管理、コードの変更の追跡、テストなどを行うことができます。
- 作業項目をさまざまなオブジェクトにリンクする
- 作業項目を他の作業項目にリンクする
- 複数の作業項目をリンクする
- 既存のリンクのリンクの種類を変更する
- 作業項目を新しい作業項目にリンクする
- 作業項目を異なるプロジェクトの作業項目にリンクする (組織間)
- 作業項目を pull request にリンクする
- 作業項目を GitHub オブジェクトにリンクする
- 複数の項目を新しい Git ブランチにリンクする
- 作業項目をビルドにリンクする
- 作業項目を配置にリンクする
- 作業項目を TFVC のコード開発にリンクする
- 作業項目をテストにリンクする
- 作業項目を Web サイト、ネットワーク共有、ストーリーボード、ドキュメントにリンクする
- 依存関係を表示し、関連する作業を追跡する
- リンクされた作業項目のクエリを実行する
- Azure CLI を使用してリンクを追加、削除、または表示する
- 作業項目のリンクを削除する
この記事では、次のタスクを行う方法について説明します。
- 作業項目をさまざまなオブジェクトにリンクする
- 作業項目を他の作業項目にリンクする
- 複数の作業項目をリンクする
- 既存のリンクのリンクの種類を変更する
- 作業項目を新しい作業項目にリンクする
- 作業項目を pull request にリンクする
- 作業項目を GitHub オブジェクトにリンクする
- 複数の項目を新しい Git ブランチにリンクする
- 作業項目をビルドにリンクする
- 作業項目を配置にリンクする
- 作業項目を TFVC のコード開発にリンクする
- 作業項目をテストにリンクする
- 作業項目を Web サイト、ネットワーク共有、ストーリーボード、ドキュメントにリンクする
- 依存関係を表示し、関連する作業を追跡する
- リンクされた作業項目のクエリを実行する
- Azure CLI を使用してリンクを追加、削除、または表示する
- 作業項目のリンクを削除する
前提条件
前提条件 | 説明 |
---|---|
プロジェクト管理者または共同作成者のメンバー | 共同作成者 または プロジェクト管理者 セキュリティ グループのメンバーとして プロジェクトに追加される 必要があります。 |
利害関係者アクセス | 作業項目を追加または変更するには、 利害関係者 以上のアクセス権が付与されている必要があります。 パブリック プロジェクトの 利害関係者 アクセス権を持つユーザーは、 Basic アクセス権を持つユーザーと同様に、バックログとボード機能へのフル アクセス権を持っています。 詳細については、「利害関係者アクセスクイック リファレンス」を参照してください。 |
共同作成者メンバーまたは許可するアクセス許可 | - 作業項目を表示または変更するには、[このノードの作業項目の表示] と [このノードの作業項目の編集] アクセス許可が [許可] に設定されている必要があります。 既定では、共同作成者グループではこのアクセス許可が [許可する] に設定されています。 詳しくは、作業追跡のためのアクセス許可とアクセス権の設定に関する記事をご覧ください。 - クラシック リリース パイプラインの統合オプションを構成するには、リリースを編集するためのアクセス許可が必要です。 - 作業項目をコミットと pull request にリンクするには、作業項目に割り当てられたエリア パスについて、[このノードの作業項目の編集] アクセス許可が [許可] に設定されている必要があります。 既定では、共同作成者グループにはこのアクセス許可が設定されています。 - 作業項目を表示するには、作業項目に割り当てられているエリア パスについて [このノードの作業項目の表示] アクセス許可が [許可] に設定されている必要があります。 |
定義された繰り返し | [計画] ウィンドウを使用するには、チーム管理者がイテレーション (スプリント) パスを定義し、チーム イテレーションを構成する必要があります。 |
前提条件 | 説明 |
---|---|
プロジェクト管理者または共同作成者のメンバー | 共同作成者 または プロジェクト管理者 セキュリティ グループのメンバーとして プロジェクトに追加される 必要があります。 |
利害関係者アクセス | 作業項目を追加または変更するには、 利害関係者 以上のアクセス権が付与されている必要があります。 |
共同作成者メンバーまたは許可するアクセス許可 | - 作業項目を表示または変更するには、[このノードの作業項目の表示] と [このノードの作業項目の編集] アクセス許可が [許可] に設定されている必要があります。 既定では、共同作成者グループではこのアクセス許可が [許可する] に設定されています。 詳しくは、作業追跡のためのアクセス許可とアクセス権の設定に関する記事をご覧ください。 - クラシック リリース パイプラインの統合オプションを構成するには、リリースを編集するためのアクセス許可が必要です。 - 作業項目をコミットと pull request にリンクするには、作業項目に割り当てられたエリア パスについて、[このノードの作業項目の編集] アクセス許可が [許可] に設定されている必要があります。 既定では、共同作成者グループにはこのアクセス許可が設定されています。 - 作業項目を表示するには、作業項目に割り当てられているエリア パスについて [このノードの作業項目の表示] アクセス許可が [許可] に設定されている必要があります。 |
定義された繰り返し | [計画] ウィンドウを使用するには、チーム管理者がイテレーション (スプリント) パスを定義し、チーム イテレーションを構成する必要があります。 |
前提条件 | 説明 |
---|---|
プロジェクト管理者または共同作成者のメンバー | 共同作成者 または プロジェクト管理者 セキュリティ グループのメンバーとして プロジェクトに追加される 必要があります。 |
利害関係者アクセス | 作業項目を追加または変更するには、 利害関係者 以上のアクセス権が付与されている必要があります。 |
共同作成者メンバーまたは許可するアクセス許可 | 作業項目を表示または変更するには、 [このノードの作業項目の表示] および [このノードの作業項目の編集] アクセス許可を [許可]に設定している必要があります。 既定では、 共同作成者 グループではこのアクセス許可が [許可する]に設定されています。 詳細については、「作業追跡のアクセス許可とアクセスを設定する」を参照してください。 |
定義された繰り返し | [計画] ウィンドウを使用するには、チーム管理者がイテレーション (スプリント) パスを定義し、チーム イテレーションを構成する必要があります。 |
リンクの種類
次の種類のリンクは、作業項目と他のオブジェクトの間のさまざまな関係を管理するのに役立ちます。
リンクの種類 | 列 2 |
---|---|
Hyperlink | 作業項目を任意の URL またはネットワーク共有に接続します |
外部リンクの種類 | 作業項目をコード オブジェクト、ビルド、Wiki ページなどの外部オブジェクトに接続します |
リモート作業リンクの種類 | 異なる組織で定義されている作業項目を接続します |
GitHub リンクの種類 | 作業項目を GitHub リポジトリのコミット、イシュー、または pull request に接続します |
作業リンクの種類 | 選ばれたテスト ケース管理作業項目を含む作業項目をリンクします |
親/子、関連、先行処理-後続処理などのリンクの種類について詳しくは、リンクの種類の参照の作業リンクの種類に関する記事をご覧ください。
作業項目をさまざまなオブジェクトにリンクする
作業項目をさまざまなオブジェクトにリンクするには、次の手順のようにします。
- Web ポータルから、リンク元の作業項目を開くか、新しい作業項目を作成します。
- [リンク] タブを選んで、[リンク先] を選びます。
- [リンクの種類] ドロップダウン リストで、作成するリンクの種類を選びます。
- [リンク先] フィールドで、リンク先のオブジェクトを入力するか選びます。 リンクの種類に応じて、次のオブジェクトを入力または選択できます。 詳細については、各オブジェクトを選んでください。
- (省略可能) リンクを説明するコメントを入力します。
- OK を選択してリンクを作成します。
ヒント
他にも機能があり、リンクをすばやく使ったり、親/子リンクの種類を変更したりできます (一部の機能はバージョンに依存します。詳しくは、リンク先の記事をご覧ください)。
- バックログ項目をポートフォリオ バックログ項目にリンクするか、これらの項目間のリンク構造を変更するには、マッピング ペインを使ってバックログを整理します。 または、[親を表示します] を選び、ツリー階層内で項目をドラッグ アンド ドロップすることができます。
- タスクを作成してバックログ項目にリンクするには、スプリント バックログ ページを使います。Web ポータルから項目をドラッグ アンド ドロップしてリンク構造を変更することもできます。
- ツリー階層のリンク構造をインデント ()、レベル上げ ()、変更するには、Web ポータルのバックログから項目の親の変更や並べ替えを行うか、チーム エクスプローラーのツリー クエリを使います。
- 作業項目の追加や削除、またはリンク構造の変更を行うには、Excel を使用します。 「Excel での作業項目の一括追加または変更」を参照してください。
作業項目を他の作業項目にリンクする
Web ポータルから別のユーザー ストーリー、エピック、フィーチャー、バグ、イシュー、またはタスクへのリンクを追加するには、次の手順のようにします。
- 別の作業項目にリンクする作業項目を開きます。
- 作業項目フォームで、[関連作業] セクションを選びます。
- [リンクの追加] を選んでから、[既存の項目] を選びます。
- [リンクの種類] ドロップダウン リストで、作成するリンクの種類 (親、子、関連など) を選びます。
- [作業項目] フィールドにリンク先の作業項目の ID を入力して、[OK] を選びます。 次の例では、リンクの種類として [関連] を使用し、3 つの項目を ID が 400 のバグにリンクします。
リンクは一度に 1 つだけ追加できます。 複数の ID をコンマやスペースで区切って入力することはできません。
複数の作業項目にリンクするには、その ID をコンマまたはスペースで区切って入力します。 ID がわからない場合、または別のプロジェクトの項目にリンクする場合は、[その他の操作] を選びます。
- (省略可能) [クエリ結果] ページで作業している場合は、変更した作業項目を一括保存します。 バックログから作業しているときは、作業項目は自動的に保存されます。
複数の作業項目をリンクする
選択した作業項目の 1 つの […] コンテキスト メニューを開き、[リンクの追加] を選択してから、[既存の項目...] または [新しい項目...] を選択します。
次の例では、プロダクト バックログから複数選択し、[既存の項目] を選んでいます。
既存リンクのリンクの種類を変更する
Web ポータルから作業項目を開いて、[リンク] を選びます。
[その他の操作]>[リンクの編集] を選択します。
変更後のリンクの種類を選択してから、[保存] をクリックします。
作業項目を保存します。
作業項目を新しい作業項目にリンクする
作業項目を新しい作業項目にリンクするには、次の手順のようにします。
新しい作業項目について、リンクの種類、作業項目の種類、タイトルを指定します。 [OK] を選択します。 選択した種類の作業項目が開きます。
追加情報を入力し、作業項目を保存します。
(省略可能) [クエリ結果] ページで作業している場合は、変更した作業項目を一括保存します。
作業項目をリモート作業項目にリンクする (組織間)
Microsoft Entra ID を使っている組織は、組織をまたいで異なるプロジェクトに存在する作業項目にリンクできます。 示されているように、次のリンクの種類を使います。
- 使用元/生成対象リンクの種類は、異なる組織で定義され、異なるチームによって管理される作業項目の依存関係を追跡したい場合に使います。
- リモート関連リンクの種類は、リンクされる作業項目が異なる組織で定義され、異なるチームによって管理されているが、厳密に型指定された相互依存関係がない場合に使います。
他の Azure DevOps 組織で定義されているオブジェクトに作業項目をリンクするには、次の手順のようにします。 これを行うことができるのは、両方の組織が同じ Microsoft Entra ID を使ってユーザーを管理している場合のみです。
次のリモート リンクの種類のいずれかを選びます。
- Consumes From/Produces For (使用元/生成対象): 異なる組織で定義され、異なるチームによって管理される作業項目の依存関係を追跡する場合。
- リモート関連: リンクされる作業項目が異なる組織で定義され、異なるチームによって管理されていますが、相互依存関係が強くない場合。
[リンクの追加] ダイアログで、リンクの種類を選び、リモート作業項目の URL を入力して、[OK] を選びます。
次の例では、リンクの種類として [リモート関連] を使用し、remotelinkingtest2 組織の RemoteLinking プロジェクトに存在している作業項目 ID 350 にリンクします。
[リンク] タブで、作業項目へのすべてのリンクの数が管理されます。 [リモート リンク数] フィールド では、作業項目に追加された、別のプロジェクトまたは組織の作業項目へのリンクの数が管理されます。
次の例では、 クラウド アイコンが付いた 2 つのリモート リンクがユーザー ストーリーに追加されているのを示しています。
作業項目を pull request にリンクする
pull request の説明で、「
#
」を入力して#ID
作業項目ピッカーをトリガーします。 一覧には、最近変更した、または自分に割り当てられている、50 個の作業項目が表示されます。作業項目の種類、ID、またはタイトルに一致する最大 5 つのキーワードを入力して、候補の作業項目の一覧を絞り込みます。
詳しくは、pull request、コミット、コメントからの作業項目へのリンクに関する記事をご覧ください。
Azure Boards と GitHub リポジトリを接続すると、作業項目を GitHub コミット、GitHub プル リクエスト、GitHub ヴランチ および GitHub 問題にリンクできます。 これにより、Azure Boards を使って作業の計画と追跡を行いながら、ソフトウェアの開発に GitHub を使用できます。
Azure Boards と GitHub リポジトリを接続すると、作業項目を GitHub のコミットや GitHub の pull request にリンクできます。 これにより、Azure Boards を使って作業の計画と追跡を行いながら、ソフトウェアの開発に GitHub を使用できます。
重要
作業項目をリンクできるのは、リポジトリが Azure Boards に接続されている GitHub オブジェクトのみです。 詳しくは、「Azure Boards を GitHub に接続する」と、pull request、コミット、コメントからの作業項目へのリンクに関する記事をご覧ください。
詳細については、「GitHub コミット、プル リクエスト、ブランチ、問題を作業項目にリンクする」および「プル リクエストで作業項目を自動完了する」を参照してください。
複数の作業項目を新しい Git ブランチにリンクする
バックログまたはクエリ結果のページで、新しい Git ブランチにリンクする複数の作業項目を選択し、 アクション アイコンを選んでから、[新しいブランチ] を選びます。詳細については、Git 開発オブジェクトへの作業項目のリンクに関する記事を参照してください。
作業項目をビルドにリンクする
作業項目を既存のビルドにリンクするには、次の手順のようにします。 このようなビルドは、自身のプロジェクト内のものか、自身の組織やコレクションの他のプロジェクト内のものです。
注意
この機能では、Azure DevOps Server 2020.1 更新プログラムのインストールが必要です。 詳しくは、Azure DevOps Server 2020 Update 1 RC1 リリース ノートの Boards に関する説明をご覧ください。
作業項目の [リンク] タブで、[リンクの追加]>[既存の項目] を選びます。
[リンクの追加] ダイアログで、ビルドのリンクの種類 ([ビルド]、[発見されたビルド]、[ビルドに統合]) から 1 つ選択し、ビルド番号を指定します。
ビルド番号 (パイプラインとビルド名の組み合わせ) がわからない場合は、 アイコンを選択して検索できます。
[Link builds] (ビルドのリンク) ダイアログで、ビルドの検索をフィルター処理するパラメーターを選択します。
別のプロジェクト内のビルドにリンクするには、リンク先のビルドが含まれるプロジェクトを最初に選びます。
たとえば、ビルド番号を指定し、ビルド パイプラインとビルド結果 ([すべて]、[成功]、[一部成功]、[失敗]、または [キャンセル]) を選択できます。 または、[結果] で [すべて] を選択した状態で、[検索] を使用して、リンクできるビルドを一覧表示します。
一覧からリンク先のビルドを選んで、[OK] を選びます。
[リンクの追加] ダイアログで [OK] を選んで操作を完了します。
[リンクの追加] ダイアログで、作業項目を既存のビルドにリンクできます。
作業項目の [リンク] タブで、[リンクの追加]>[既存の項目] を選択します。
[リンクの追加] ダイアログで、ビルドのリンクの種類 ([ビルド]、[発見されたビルド]、[ビルドに統合]) から 1 つ選択し、ビルド番号を指定します。
ビルド番号 (パイプラインとビルド名の組み合わせ) がわからない場合は、 アイコンを選択して検索できます。
[Link builds] (ビルドのリンク) ダイアログで、ビルドの検索をフィルター処理するパラメーターを選択します。
たとえば、ビルド番号を指定し、ビルド パイプラインとビルド結果 ([すべて]、[成功]、[一部成功]、[失敗]、または [キャンセル]) を選択できます。 または、[結果] で [すべて] を選択した状態で、[検索] を使用して、リンクできるビルドを一覧表示します。
一覧からリンク先のビルドを選んで、[OK] を選びます。
[リンクの追加] ダイアログで [OK] を選択して操作を完了します。
作業項目を配置にリンクする
ソフトウェアを開発する際に、どのコードの変更やビルドが作業項目の完了をサポートするのかを取り入れることができます。 これにより、チームは、コード ベースへの変更の監査証跡を通じて、どのような作業が行われたか、またはバグがどのように修正されたかを理解できます。
次の図に示すように、これらのリンクの構築に使われるリンクの種類は、ブランチ、ビルド、変更セット、コミット、ビルドで見つかる、ビルドに統合されている、pull request、バージョン管理された項目、リリース環境で統合、となっています。
ヒント
作成時には作業項目から開発を進めることをお勧めします。 ブランチ、コミット、pull request を作成するときに作業項目 ID を追加することもできます。 Git では、コミット リンクの種類を使って、作業項目とコミットをリンクすることができます。 これは、次の方法で行うことができます。
- 変更をコミットする前に、Visual Studio チーム エクスプローラーで作業項目 ID を追加します。
- git-commit コマンドを使い、コメントに作業項目 ID を含めます。 たとえば、
#35 Catch null exception
のようなコメントをコミットに適用します。 コミットをプッシュすると、システムにより、そのコミットと作業項目 #35 の間にコミット リンクが作成されます。 - [開発] コントロールを使って、作業項目から Git 開発を進めます。
次の図に示すように、[デプロイ] コントロールには、2 つのリリース ステージのリリース情報が表示されます。 これには、Azure Boards と統合するように構成されたリリース パイプラインの Git コミットまたはプル要求にリンクされた作業項目が含まれます。
デプロイの制御
作業項目フォームには、開発オブジェクトを表示し、そこにすばやく移動するための、2 つのコントロールが用意されています。 [デプロイ] コントロールについてはこの記事で説明します。[開発] コントロールについては、作業項目からの Git 開発の推進に関する記事で説明されています。
既定では、デプロイ コントロールは、ユーザー ストーリー (アジャイル)、プロダクト バックログ項目 (スクラム)、イシュー (基本)、要件 (CMMI)、フィーチャー、エピック、バグ、タスク、およびテスト ケースの作業項目の種類を対象に、作業項目フォームに表示されます。
継承されたプロセスを使用するカスタム作業項目の種類では、自動化が有効になっています。 [デプロイ] コントロールには、Azure Boards に統合されたリリース パイプラインの 2 つのステージのリリース情報が表示されます。
このコントロールには、このパイプラインの Git コミットまたは pull request にリンクされている作業項目のみが表示されます。 異なるリリース環境にデプロイされた作業項目の状態に関する分析情報を表示し、各リリース ステージと実行にすばやく移動することもできます。
ビルド内のコミットに関連付けられている作業項目には、リリースの状態が表示されます ただし、同じプロジェクト内の作業項目のみが、リリース パイプラインが定義されている場所にリンクされます。
作業項目を開くと、ステージをリアルタイムで確認できます。
[デプロイ] コントロールを設定するには、次の手順のようにします。
Note
デプロイ コントロールを使用するには、クラシック リリース パイプラインを構成する必要があります。 YAML パイプライン用に定義されたリリース ステージへのリンクはサポートされていません。
- 「複数ステージの継続的デプロイ (CD) パイプラインを定義する」の説明に従って、クラシック リリース パイプラインを定義し、リリース ステージを設定します。
- 「作業の追跡をサポートするためのパイプラインの構成」、「配置の状態を Boards に報告する」の説明に従ってパイプラインを構成し、デプロイの状態を Boards に報告します。
- Azure Repos Git リポジトリ内のコミットまたは pull request に、1 つ以上の作業項目をリンクします。 詳細については次を参照してください:
- パイプラインを実行します。
作業項目を TFVC のコード開発にリンクする
Team Foundation バージョン管理 (TFVC) では、変更セットとバージョン管理された項目のリンクの種類を使って、作業項目をバージョン コントロールの変更セットまたはバージョン管理されたソース コード ファイルにリンクできます。 保留中の変更をチェックインすると、または [担当作業] を使って変更をチェックインすると、作業項目が変更に自動的にリンクされます。
作業項目をテストにリンクする
テスト関連のリンクの種類は、テスト ケース管理作業項目を相互に、または他の作業項目にリンクします。 Web ポータルまたは Microsoft Test Manager から、テスト スイート用に定義されたテスト ケースと、テスト計画用に定義されたテスト スイートを表示することができます。 ただし、これらのオブジェクトがリンクの種類を介して相互にリンクされることはありません。
テスト対象/テスト担当者リンクの種類を使って、作業項目をテスト ケースにリンクできます。 前に説明した、作業項目を他の作業項目にリンクするために使うのと同じリンク コントロールを使います。
次の図では、テスト管理作業項目の種類で使用できるすべてのリンクの種類が示されています。 テスト管理オブジェクト間のほとんどのリンクは、[テスト] ページまたは Microsoft Test Manager からタスクを実行することで発生します。
たとえば、テスト ケースに共有ステップを追加すると、テスト ケース/共有ステップのリンクの種類を使って、自動的にリンクされます。 詳細については、「テスト ケース間でステップを共有する」を参照してください。
[テスト] からは、テスト計画、テスト スイート、テスト ケースを追加できます。これらはリンクされていますが、特定のリンクの種類を介してではありません。 また、テスト システムは、テスト ケースやテスト計画に対するテスト結果の関連付けを作成し、管理します。
作業項目を Web サイト、ネットワーク共有、ストーリーボード、ドキュメントにリンクする
ハイパーリンクまたはストーリーボードのリンクの種類を使って、作業項目をネットワーク共有上にある Web サイト、ネットワーク共有、またはドキュメントにリンクできます。 これらのリンクの種類は、どちらも一方向のリンクです。 これらのリンクの種類を追加するには、上で作業項目のリンクに関して説明したものと同じコントロールを使用できます。
ストーリーボードのリンクの種類を使うときは、作業項目の仕様を提供するストーリーボードかドキュメントを指定するように、リンクを区別します。 このリンクの種類を使うと、チームが共有ファイルにアクセスして、コメントを追加できるようになります。
依存関係を表示し、関連する作業を追跡する
Azure DevOps には、依存関係を表示し、関連する作業を追跡するための、いくつかの方法が用意されています。 • クエリ エディター: クエリ エディターを使うと、特定の作業項目にリンクされているすべての作業項目を表示するカスタム クエリを作成できます。 • バックログとボード: バックログとボードのビューには、作業項目間の親子関係が表示され、依存関係を一目で確認できます。 • 依存関係トラッカー: 依存関係トラッカーは、作業項目間の依存関係を視覚的に表す Power BI レポートです。
作業項目にリンクされているすべてのオブジェクトの一覧を表示するには、次の手順のようにします。
- 作業項目を開き、[リンク] を選びます。 [リンク] タブでは、リンクされているすべてのオブジェクトの数が示されます。 リンクされたオブジェクトは、リンクの種類ごとにグループ化され、各グループの個数も示されます。
- (省略可能) 各グループを展開したり、折りたたんだりします。また、対応する列タイトルを選んで、各グループ内を [状態]、[最終更新]、または [コメント] で並べ替えます。
たとえば、次の [リンク] タブは、作業項目の 64 個のリンク オブジェクトの一部を表示します。
感嘆符 が前に付いているリンクは、ビルド、リリース、または他のオブジェクトが削除されていることを示します。 アイテム保持ポリシーのため、これらのオブジェクトは一定の期間が過ぎると自動的に削除されます。
リンクされた作業項目のクエリ
階層リンクに基づいて項目をフィルター処理するには、[作業項目のツリー] クエリの種類を使います。 すべてのリンクの種類に基づいて項目をフィルター処理するには、[作業項目とダイレクト リンク] を使います。
特定のリンクの種類で他の作業項目にリンクされている作業項目を検索するには、プライマリとセカンダリの作業項目のセットを示すクエリを使います。 プライマリ セットはフィールドの条件を満たすもので、セカンダリ セットはプライマリ セットにリンクされているものです。 リリース内で作業項目のクエリを実行することはできませんが、外部リンクを使って作業項目のクエリを実行することはできます。 検索を絞り込むには、クエリ フィルターをさらに追加します。
クエリの例については、リンクとアタッチのクエリに関する記事を参照してください。
Test Plans、テスト スイート、テスト ケースの階層ビューを表示するクエリを構築することはできません。 これらの項目は、親/子やその他のリンクの種類を使って一緒にリンクされません。 階層は、[テスト]>[Test Plans] ページでのみ、見ることができます。
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 が cebd7ef5-4282-448b-9701-88c8637581b7 に対応しています。 出力を表示するために表形式が使用されます。 他の形式については、「Azure CLI コマンドの出力形式」を参照してください。
作業項目のリンク
1 つまたは複数の作業項目を 1 つの作業項目にリンクするには、az boards work-item relation add コマンドを入力します。
構文
必須パラメーターには、リンク先の作業項目の ID とリンクの種類が含まれます。 サポートされているリンクの種類は、Parent、Child、Related、Remote Related などです。 指定できるすべてのリンクの種類の一覧を確認するには、az boards work-item relation list-type コマンドを実行します。
同じ組織内で定義されている作業項目の場合は、作業項目 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/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2850
Child https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2808
Child https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2820
Child https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2856
Parent https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2811
Child https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2876
Child https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2801
Child https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2877
Child https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2805
Child https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_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/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2850
Child https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2808
Child https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2820
Child https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2856
Parent https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2811
Child https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2876
Child https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2801
Child https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2877
Child https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_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/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2932
Successor https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2932
Remote Related https://dev.azure.com/fabrikam-fiber5/847568d2-6541-4a99-a240-228510ccbff7/_apis/wit/workItems/1777
Parent https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2930
Predecessor https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2933
Attached File https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/attachments/1cc6c026-b4ed-420c-bfe6-065be726cba7
リンクされた作業項目の情報を表示するには、ブラウザーに一覧表示される URL のいずれかを入力します。 添付ファイルの URL を選択して、添付ファイルをダウンロードします。
作業項目のリンクを削除する
作業項目のリンクを削除するには、次の手順のようにします。
- リンクがある作業項目を開くか、クエリ結果から選びます。
- [リンク] タブを選んで、リンクの一覧を表示します。
- 削除するリンクを選んでから、[リンクの削除] を選びます。
- リンクを削除することを確認します。
コミットまたは pull request にリンクされた作業項目は、リリース ステージの一部として引き続き表示されます。 たとえば、テスト条件に合格しなかった作業項目がある場合は、その項目をビルドとリリースから削除できます。
作業項目を削除して今後のビルドとリリースに関与しないようにするには、直近のコミットと pull request へのリンクを削除します。
次のステップ
関連する作業や他のオブジェクトを視覚化します。 Visual Studio Marketplace の [Azure DevOps] タブから入手できる作業項目視覚化拡張機能をダウンロードします。