リストとボードの分類およびフィルター処理のために作業項目タグを追加する

Azure DevOps サービス |Azure DevOps Server |Azure DevOps Server 2022

作業項目にタグを付けて、定義したカテゴリで製品バックログまたは作業項目クエリをすばやくフィルター処理します。 タグは、定義した 1 つまたは 2 つのキーワード フレーズに対応します。 タグは、バックログまたはクエリをフィルター処理したり、クエリを定義したりするニーズをサポートします。

タグの追加と変更は、Web ポータルまたは Visual Studio 用のチーム エクスプローラー プラグインから行うことができます。 また、 Excel でクエリを開いて、タグを一括変更することもできます。

タグは、「作業項目クエリの定義」の説明に従ってテキスト文字列を使用するよりも 、作業項目をフィルター処理する場合に適しています。 タグは、チームではなくプロジェクトに関連付けられた共有リソースです。 プロジェクトに複数のチームが含まれる場合、すべてのチームが同じ一連のタグを追加し、そこから作業します。

Tip

この記事の後半でAIを使用してこのタスクを支援することができます。また、作業を開始するには、Azure DevOps MCP ServerでAIサポートを有効にする方法を参照してください。

Prerequisites

Category	Requirements
Permissions	作業項目を表示、フォロー、編集するには: - このノードの作業項目を表示する (許可) - このノードの作業項目を編集する (許可) デフォルトでは、 Contributors グループにこれらの権限が与えられます。 詳細については、「作業追跡権限を設定する」を参照してください。 新しいタグを追加するには: - プロジェクト レベルのタグ定義の作成権限 (許可) デフォルトでは、 Contributors グループにこの権限が与えられます。
アクセス レベル	- プロジェクト メンバー 新しいタグを追加したり、pull requests に従ったりするには: 少なくとも Basic 作業項目を表示またはフォローするには: 少なくとも 利害関係者 作業項目を含む電子メールを送信するには: 共同作成者 グループのメンバーである必要があります

Note

• 進捗状況を確認し、作業項目について話し合いたいが、コードには貢献しないメンバーに 利害関係者 アクセス権を割り当てます。 作業項目、バックログ、ボード、ダッシュボードを表示できます。
• 既定では、パブリック プロジェクト の共同作成者 と 利害関係者 は、新規および既存のタグを追加できます。 プライベート プロジェクトでは、 共同作成者 のみが新しいタグを追加できます。 タグ作成権限を変更するには、プロジェクト レベルで タグ定義の作成 権限を設定します。 詳細については、 プロジェクトレベルのアクセス許可の変更に関する記事を参照してください。

作業項目にタグを追加する

タグは 400 文字以下で、 , (コンマ)、 ; (セミコロン)、その他の書式設定文字などの区切り記号は含めないようにする必要があります。

推奨事項: タグに @ 文字を使用しないでください。 @ 文字で始まるタグは、作業項目クエリでは使用できません。 @ 文字はクエリ内のマクロを示すため、タグはタグとして認識されません。

Web ポータルで、作業項目を開き、タグを追加します。 [タグの追加] を選択し、キーワードを入力します。 または、以前に割り当てたタグの一覧からクリックします。

複数のタグを同時に追加するには、タグをコンマで区切って入力します。 タグは大文字小文字を区別します。

タグ バーに表示されるタグは、既に作業項目に割り当てられています。 タグの割り当てを解除するには、タグの x を選択 。

タグを一括で追加または削除する

作業項目を一括更新して、Web ポータルからタグを追加または削除できます。 Web ポータルを使用して他のフィールドを一括変更するのと同じ方法でタグを一括変更します。 または、 Excel を使用してタグを一括で追加または削除することもできます。

Note

ボードでは、Visual Studioやその他のクライアントからのタグの一括変更はサポートされていません。

タグに基づいて作業項目のクエリを実行する

タグに基づいて作業項目にクエリを実行するには、クエリをサポートするために使用するタグごとに句を追加します。

Tip

AND/OR 句のグループ化方法については、「グループ句」を参照してください。 クエリの WIQL 構文を表示するには、 WIQL クエリ エディター拡張機能をインストールします。これにより、クエリ エディター エントリの WIQL バージョンを確認できます。

Contains 演算子または Does Not Contain 演算子を使用できます。 @文字で始まるタグは、クエリ エディターが@文字をマクロとして解釈するため、作業項目クエリでは使用できません。 詳細については、「作業項目クエリを定義する」を参照してください。

たとえば、 Web または Serviceとしてタグ付けされているすべての作業項目のクエリを次に示します。

Note

タグが添付されていない作業項目はクエリできません。 この機能をサポートする要求に投票する場合は、Developer Community ページの 空のタグを検索できます。

バックログまたはクエリ結果でのタグの表示

[列のオプション] を開き、プロダクト バックログまたは作業項目クエリに [タグ] フィールドを追加します。 オプションが表示されない場合は、 その他のコマンド を選択して、オプションのメニューから選択します。

一覧表示された作業項目に追加されたすべてのタグが表示されます。

タグを使用してリストをフィルタリングする

Web ポータルからタグを使用してバックログ、ボード、クエリ結果をフィルタリングできます。

まず、 フィルター を選択します。

フィルター処理するタグを選択します。 [OR] を選択したままにすると、選択したすべてのタグに対して論理 OR を実行できます。 または、 [AND] オプションを選択すると、選択したすべてのタグで論理 AND を実行できます。

タグを削除、解除、または管理する

Azure DevOps Web UI を使用してタグを削除することはできません。

タグを削除する必要がある場合は、Azure DevOps REST API または .NET クライアント ライブラリ を使用して、削除できるスクリプトまたはアプリケーションを作成します。 その他の例については、Azure-DevOps-Admin-CLI を参照してください。

もう 1 つのオプションは、 Marketplace Tags Managerをインストールすることです。これにより、 [ボード] または [作業] の下に [タグ] ページが追加され、タグを管理 (削除を含む) できます。

ボード上のタグの色分け

ボードカード上のタグを色分けして強調表示します。 これらの色は、設定したボードにのみ表示されます。 バックログやタスクボードには表示されません。 詳細については、「 タグの色を割り当てる」を参照してください。

作業項目をグラフ化し、タグでグループ化する

クエリベースのグラフをタグでグループ化することはできませんが、ダッシュボードに追加したタグで [作業項目のグラフ] ウィジェットをグループ化することはできます。 この機能はパブリック プレビュー段階にあります。 これを有効化するには、「機能を管理または有効にする」を参照し、 [ダッシュボードの作業項目グラフ ウィジェットのタグごとにグループ化する] をオンにします。

作業 項目のグラフ ウィジェットをタグ別にグループ化するには、「グラフをダッシュボードに 追加する」で説明されているのと同じ手順を実行します。 フラット リスト クエリに、クエリ句または列オプションとして タグ が含まれていることを確認します。 次に、 [グループ化] のオプションとして [タグ] を選択します。 一部のタグのみを表示するようにグラフをフィルタリングするには、 [選択したタグ] ラジオ ボタンを選択し、グラフに表示するタグを選択します。

タグの数の制限

ハード リミットはありませんが、プロジェクト コレクションに 100,000 を超えるタグを作成すると、パフォーマンスに悪影響を与える可能性があります。 また、タグ コントロールのオートコンプリート ドロップダウン メニューは最大 200 個のタグを表示します。 200 個を超えるタグが定義された状態で入力を開始すると、タグ コントロールによって関連するタグが表示されます。

作業項目に 100 を超えるタグを割り当てることができないか、次のメッセージが表示されます。

TF401243: Failed to save work item because too many new tags were added to the work item.

追加したタグ (100 以下) 付きの作業項目を保存すると、さらにタグを追加できます。

クエリの対象にするタグは 25 個未満に制限してください。 それ以上の数のタグをクエリの対象にすると、タイムアウトが発生する可能性があります。

AI を使用して作業項目タグのクエリと管理を行う

エージェント モードで Azure Boards MCP Server が AI エージェントに接続されている場合は、自然言語プロンプトを使用して、タグに基づいて作業項目を検索および更新できます。

Task	プロンプトの例
タグ付けされたアイテムを検索する	Find all active work items tagged with "security" in my project
タグを一括で追加する	Add the tag "tech-debt" to all active bugs in the current sprint
タグ付けされていないアイテムを検索する	List work items with no tags assigned in the <Contoso> area path
複数のタグでクエリを実行する	Find user stories tagged with both "performance" and "P1"
使用中のすべてのタグを一覧表示する	Show all distinct tags used on work items in project <Contoso> sorted by usage count
古いタグをクリーンアップする	List tags in <Contoso> that are used on fewer than 2 work items
タグを置き換える	Find all work items in <Contoso> tagged "wontfix" and replace that tag with "by-design"
条件によるタグ付け	Add tag "needs-review" to all user stories in <Contoso> that were resolved in the last week but have no linked pull request
タグ パターンの分析	Show the count of active work items per tag in area path <Contoso\\Frontend>
タグの不一致を見つける	List work items in <Contoso> tagged "sprint-goal" that aren't assigned to the current sprint

Note

エージェント モードと MCP サーバーでは自然言語が使用されるため、これらのプロンプトを調整したり、フォローアップの質問をして結果を絞り込むことができます。

関連コンテンツ

• 作業項目クエリを定義する
• ボード のカードをカスタマイズする
• Web ポータルから作業項目を一括変更する
• Excel から作業項目を一括変更する

Marketplace 拡張機能

• Marketplace Tags Manager