Azure DevOps サービス |Azure DevOps Server |Azure DevOps Server 2022
作業項目をリンクして関連する作業と依存関係を追跡し、ファイルを添付してチームと情報を共有します。 次のフィールドを使用して作業項目のクエリを実行します。
ヒント
この記事の後半でAIを使用してこのタスクを支援することができます。また、作業を開始するには、Azure DevOps MCP ServerでAIサポートを有効にする方法を参照してください。
- 添付ファイル数
- (ディスカッション) コメント数
- 外部リンク数
- ハイパーリンク数
- リンクのコメント
- 関連リンク数
- リモート リンクの数
- 添付ファイル数
- (ディスカッション) コメント数
- 外部リンク数
- ハイパーリンク数
- リンクのコメント
- 関連リンク数
フィールドの詳細な説明については、「 リンクと添付ファイルに関連付けられているフィールド」を参照してください。
必須コンポーネント
| カテゴリ | 必要条件 |
|---|---|
| アクセス レベル | - 共有クエリを表示して実行するには、プロジェクト メンバー である必要があります。 - 共有クエリを追加して保存するには:少なくとも Basic アクセス。 |
| Permissions | クエリを追加するフォルダーの貢献権限が許可に設定されていること。 既定では、 共同作成者 グループにはこのアクセス許可がありません。 |
Note
パブリック プロジェクトの 利害関係者 アクセス権を持つユーザーは、 Basic アクセス権を持つユーザーと同様に、クエリ機能にフル アクセスできます。 詳細については、「利害関係者アクセスクイック リファレンス」を参照してください。
| カテゴリ | 必要条件 |
|---|---|
| アクセス レベル | - 共有クエリを表示して実行するには、プロジェクト メンバー である必要があります。 - 共有クエリを追加して保存するには、少なくとも ベーシックアクセスが必要です。 |
| Permissions | クエリを追加するフォルダーの貢献権限が許可に設定されていること。 既定では、 共同作成者 グループにはこのアクセス許可がありません。 |
サポートされている演算子とマクロ
整数フィールドを指定する句には、次の演算子を使用します。
= , <> , > , < , >= , <=
=[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field]
In, Not In
Was Ever
ツリー ビューで階層項目の一覧を表示する
クエリを作成し、 作業項目のツリー を選択して開始します。 Query Editorは、次の例を示しています。
Note
テスト プラン、テスト スイート、テスト ケースの階層ビューを表示するクエリは作成できません。これらの項目は親子リンク型を使用してリンクされないためです。 直接リンク クエリを使用して、テスト関連の作業項目を一覧表示するか、[テスト 計画] ページで階層を表示します。
フィルターとクエリ句のオプション
リンクされた作業項目のフィルター オプションを変更し、Query Editorのオプションを使用してクエリ句を追加します。
フィルターの対象
これらのクエリ句を含める
作業項目 645 の子項目のみ
最上位作業項目のフィルターに追加する:
ID = 645
タスクまたはバグ
リンクされた作業項目のフィルターに追加する:
Work Item Type In Task,Bug
チームに割り当てられた項目 (Web)
上位と下位の両方のフィルターに追加する:
Assigned to In Group [Fabrikam Fiber]\Web
自分に割り当てられたタスクの親項目
[フィルター] オプションを [リンクされた作業項目を最初に照合する] に変更する
リンクされた作業項目のフィルターに追加する:
Assigned To = @Me
リンクされた依存に基づいて項目の一覧を表示する
次の例では、他のチームおよびプロジェクトが管理する作業に依存する項目を返す依存リンク クエリを示します。
次のクエリでは、先行リンクと後続リンクの種類を使用して 、Fabrikam 領域のパスとプロジェクトの下にある作業項目にリンクするすべてのプロジェクトの作業項目を検索します。
- [ プロジェクト間でクエリを実行] を選択して、他のプロジェクトの依存するリンクされた作業項目を含めます。
- Fabrikam プロジェクトで定義されている項目にリンクする作業項目をフィルター処理するには、 Fabrikam 句の下に領域パス を追加します。
- [ リンクが一致するアイテムのみを返す] を選択し、[ 選択したリンクの種類を返す ] を選択して 、先行タスク または 後続タスクとしてリンクされている作業項目のみを返します。
孤立したユーザー ストーリーの一覧を表示する
機能の下でユーザー ストーリーを整理する場合は、次のいずれかのアクションを実行して、親のないストーリーをすばやく見つけます。
- プロダクト バックログを開き、表示オプションで親の表示をオンします。
- [ 親のないストーリー (アジャイル)] または [ 親のないバックログアイテム (スクラム)] セクションまでスクロールします。
または、 作業項目と直接リンク クエリを使用して、紐付けされていないバックログ項目を検索します。 たとえば、次のクエリでは、親リンクがないAzure DevOps チームのアクティブなユーザー ストーリーが一覧表示されます。
リンクと添付ファイルに関連付けられているフィールド
次の表では、リンクと添付ファイルに関連付けられているフィールドについて説明します。 これらのフィールドのほとんどは作業項目フォームには表示されませんが、すべての作業項目の種類について追跡されます。
添付ファイル数
作業項目に添付され、作業項目トラッキング データベースに格納されるファイルの数。
参照名=System.AttachedFileCount、 データ型 = 整数
Note
Azure Boards (クラウド サービス) では、作業項目に最大 100 個の添付ファイルを追加できます。 作業項目を保存するときに、エラー メッセージで結果をさらに追加しようとします。
コメント数
作業項目の [ディスカッション] セクションに追加されたコメントの数。
参照名=System.CommentCount、 データ型 = 整数
作業項目から、プル要求、コミット、変更セット、その他の種類のリンクなど、作業項目ではない成果物へのリンクの数。
参照名=System.ExternalLinkCount、 データ型 = 整数
作業項目に含まれるハイパーリンクの数。
参照名=System.HyperLinkCount、 データ型 = 整数
リンクコメント
リンクを作成したチーム メンバーからのコメントが含まれます。 このフィールドは、作業項目フォームのリンク一覧に列として表示されるように構成できます。 (Query Editorはこのフィールドをサポートしていません)。
参照名=System.Links.Comment、 データ型 = PlainText
リンクの説明
作業項目の種類、ID、およびリンク先の作業項目のタイトルが含まれます。 このフィールドは、作業項目フォームのリンク一覧に列として表示されるように構成できます。 (Query Editorはこのフィールドをサポートしていません)。
参照名=System.Links.Description、 データ型 = PlainText
バックログまたはクエリ結果リストに列オプションとして含めると、親作業項目の タイトル が表示されます。 内部的には、作業項目の ID が 整数フィールドに格納されます。
Note
親フィールドを列として追加するか、親作業項目の ID を指定することでクエリ句内でそれを指定することができます。
参照名=System.Parent、 データ型 = 整数
親と子、先行処理と後続処理、関連など、作業リンクの種類を使用する作業項目に定義されているリンクの数。 完全な一覧については、「リンクの種類のリファレンス」をご覧ください。
参照名=System.RelatedLinkCount、 データ型 = 整数
Azure DevOps サービスでのみ使用できます。 ある作業項目から別の組織で定義されている作業項目へのリンクの数。 同じMicrosoft Entra IDが組織を管理する必要があります。 サポートされているリンクの種類には、使用元、生成対象、リモート関連などがあります。 詳細については、「作業項目へのリンクを追加と、リモート作業項目へのリンク」をご覧ください。
参照名=System.RemoteLinkCount、 データ型 = 整数
関連する作業や他のオブジェクトを視覚化する
Visual Studio Marketplace の [Azure DevOps] タブから使用可能な Work アイテム視覚化拡張機能を使用して、作業項目内の関連する作業項目とオブジェクトを表示します。
カスタム リンクの種類を追加する、またはリンク コントロールをカスタマイズする
リンクの種類の追加については、リンクの種類の管理 (witadmin) に関する記事をご覧ください。
作業項目間のリンクの作成をサポートするすべてのタブは、作業項目フォームの LinksControl 要素を使用します。 この要素は、フィルター処理を制御し、リンクできる作業項目の種類を制限します。 また、作成できるリンクの種類と、別のプロジェクトの作業項目をリンクできるかどうかを制御します。 リンク コントロールと制限をカスタマイズするには、作業項目の種類の LinksControlOptions の定義を変更します。 LinksControlOptions XML 要素を参照してください。
リンク一覧の既定のデータ フィールド
リンク一覧に列を追加または削除したり、既定の列や列の順序をカスタマイズすることができます。 詳しくは、「LinksControlOptions XML 要素」をご覧ください。
AI を使用してリンクと添付ファイルでクエリを実行する
エージェント モードで Azure Boards MCP Server が AI エージェントに接続されている場合は、自然言語プロンプトを使用して、リンクと添付ファイルに基づいて作業項目を検索できます。
| Task | プロンプトの例 |
|---|---|
| リンクされていないアイテムを検索する | Find active user stories with no child task links |
| 添付ファイルのクエリ | List bugs that have attached files |
| 開発リンクを確認する | Show work items with no linked commits or pull requests |
| 頻繁にリンクされているアイテムを検索する | Find work items with more than 3 related links |
| 依存関係チェーンのトレース | Show all work items in <Contoso> that have predecessor links and list what they depend on |
| 外部リンクを含むアイテムを検索する | List work items in <Contoso> that have hyperlinks in their links |
| 親子整合性の監査 | Show child work items in <Contoso> whose parent is in the Closed state but the child is still Active |
| テスト ケースにリンクされているアイテムを検索する | List user stories in the current sprint for <Contoso> that have linked test cases and show the test outcome |
| 添付ファイルの肥大化を識別する | Show work items in <Contoso> that have more than 5 attachments |
| プロジェクト間のリンクを検索する | List work items in <Contoso> that have related links to work items in other projects |
Note
エージェント モードと MCP サーバーでは自然言語が使用されるため、これらのプロンプトを調整したり、フォローアップの質問をして結果を絞り込むことができます。