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

  • [アーティクル]

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

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

タグは、 パフォーマンスの高いクエリを作成するためのガイダンスで説明されているように、テキスト文字列を使用するよりも作業項目をフィルター処理する方が適しています。

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

Note

タグは共有リソースであり、チームではなくプロジェクトに関連付けられています。 プロジェクトに複数のチームが含まれている場合、すべてのチームが同じタグのセットに追加され、作業されます。

前提条件

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

Note

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

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

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

ヒント

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

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

作業項目に 1 つ以上のタグを追加する

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

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

Note

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

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

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

[作業項目の編集] ダイアログで、複数の作業項目に一括追加します。

Note

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

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

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

ヒント

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

たとえば、ここでは、タグ付けされたすべての作業項目または .WebService

タグに対してクエリを実行するクエリ エディターのスクリーンショット。

ヒント

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

Note

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

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

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

[列オプション] ダイアログボックスで、選択した列にタグを追加して表示します。

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

[タグ] 列が追加された [View]\(製品のバックログ\) のスクリーンショット。

タグを使用してリストをフィルター処理する

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

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

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

タグの列を追加して表示

タグの削除、削除、または管理

タグ自体を削除することはできません。 しかし、タグが現在割り当てられているすべての作業項目からタグを削除すると、システムによってタグが削除されます。 割り当て先のないタグが使用されないまま 3 日間を経過すると、システムによって自動的に削除されます。

タグのスペルを間違えた場合は、スペルミスのタグを作業項目に割り当てないでください。3 日以内に自動的に削除されます。

もう 1 つのオプションは、Marketplace Tags Manager をインストールすることです。このマネージャーは、[Boards] または [Work] の下にタグ ページを追加してタグを管理します。

ボード上のカラー コード タグ

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

[ボード>の設定] の [タグの色]>ダイアログ

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

Note

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

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

作業項目別グラフ、構成、タグ別グループ化のスクリーンショット。

Marketplace 拡張機能

タグの数の制限

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

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

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

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

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

製品バックログの既定の列ビューにタグを追加する

製品バックログの列フィールドとして [タグ ] フィールドを追加するには、ProcessConfiguration ファイルを含むように System.Tags変更します。 方法については、 プロセス構成 XML 要素のリファレンスを参照してください。