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

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

作業項目をタグ付けすることで、定義したカテゴリ別にプロダクト バックログまたは作業項目クエリをすばやくフィルター処理できます。 タグは定義した 1 つまたは 2 つのキーワード フレーズに対応するため、バックログやクエリをフィルタリングし、クエリを定義するニーズを満たすことができます。

クエリの定義/ベスト プラクティスに関するページで説明されているように、作業項目のフィルター処理には、テキスト文字列を使用するよりもタグを使用する方が適しています。

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

注意

タグは共有リソースのため、チームではなくプロジェクトに関連付けられています。 プロジェクトに複数のチームが含まれる場合、すべてのチームが同じ一連のタグを追加し、そこから作業します。

前提条件

• ユーザーがプロジェクトに追加されている必要があります。
• 作業項目を表示または変更するには、[このノードの作業項目の表示] および [このノードの作業項目の編集] アクセス許可を [許可] に設定している必要があります。 既定では、共同作成者グループにはこのアクセス許可が設定されています。 詳細については、「作業追跡のアクセス許可とアクセスを設定する」を参照してください。
• 新しいタグを作業項目に追加するには、Basic 以上のアクセス権が付与されていて、プロジェクト レベルの [Create new tag definition] (新しいタグ定義の作成) アクセス許可が [許可] に設定されている必要があります。 既定では、共同作成者グループにはこのアクセス許可が設定されています。 利害関係者に対してアクセス許可が明示的に設定されている場合でも、アクセス レベルによって禁止されているため、新しいタグを追加するアクセス許可はありません。 詳細については、「利害関係者アクセスクイック リファレンス」を参照してください。
• すべてのプロジェクト メンバー (閲覧者グループのメンバーも含む) が、作業項目を含む電子メールを送信できます。

Note

パブリック プロジェクトの利害関係者権限を持つユーザーは、新しいタグを追加できます。

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

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

ヒント

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

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

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

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

注意

既定では、パブリック プロジェクトのすべての共同作成者と利害関係者に、新規および既存のタグを追加するアクセス許可が付与されます。 プライベート プロジェクトの利害関係者は、既に定義されているタグを追加できますが、新しいタグを追加することはできません。 新しいタグを作成する権限を付与または制限するには、プロジェクト レベルで [タグ定義の作成] 権限を設定します。 詳しくは、「プロジェクト レベルで権限を変更する」を参照してください。

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

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

注意

Visual Studio またはその他のサポートされているクライアントのタグの一括変更はサポートされていません。

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

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

ヒント

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

たとえば、ここでは Web または Service のいずれかのタグが付けられているすべての作業項目に対してクエリを実行します。

ヒント

AND/OR 句をグループ化する方法については、マネージド クエリの作成と保存に関する記事の「句のグループ化」を参照してください。 クエリの WIQL 構文を表示するには、WIQL クエリ エディター拡張機能をインストールしてください。これを使用すると、クエリ エディターのすべてのエントリについて WIQL バージョンを表示できます。

注意

タグが一切アタッチされていない作業項目のクエリを実行する機能はサポートされません。 この機能のサポート要求に賛成投票したい場合は、Developer Community ページの「空のタグを検索したい」で投票できます。

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

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

一覧表示される作業項目に割り当てられたタグがすべて表示されます。

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

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

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

フィルタリングするタグのボックスにチェックを入れます。 [OR] を選択したままにすると、選択したすべてのタグに対して論理 OR を実行できます。 または、[AND] オプションを選択すると、選択したすべてのタグで論理 AND を実行できます。

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

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

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

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

ボード上のタグの色分け

かんばんボード カードのタグを色分けすることで強調表示できます。 これらの色は構成したかんばんボードにのみ表示されます。 バックログやタスクボードには表示されません。 詳細については、カードのカスタマイズ (color-code タグ) に関するページを参照してください。

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

注意

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

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

関連記事

• クエリ エディターを使用してクエリを一覧表示し、管理する
• カードにタグを表示する
• Web ポータルから作業項目を一括変更する
• Excel から作業項目を一括変更する

Marketplace 拡張機能

• Marketplace Tags Manager

タグの数の制限

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

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

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

追加したタグ (100 個以下) を使用して作業項目を保存すると、タグを追加できます。

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