Azure Boards と Azure DevOps でクエリを管理および整理する

  • [アーティクル]

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

Visual Studio 2019 | Visual Studio 2022

クエリ フォルダーを追加して、個人用または共有のクエリを整理します。 その後、これらのフォルダーにクエリを追加したり、既存のクエリを移動したりできます。 クエリとクエリ フォルダーは、Web ポータルまたはサポートされているクライアント (Visual Studio チーム エクスプローラーなど) から作成できます。

注意

Visual Studio 2019 でクエリを作成して管理するには、作業項目エクスペリエンスをレガシ オプションに設定する必要があります。 また、Visual Studio からはクエリをクエリ フォルダーに一括でドラッグ アンド ドロップできますが、Web ポータルからは実行できません。

前提条件

  • 共有クエリを表示して実行するには、利害関係者アクセス権が必要です。 既定では、すべてのプロジェクト メンバーに利害関係者アクセス権があります。 詳細については、共有クエリまたはフォルダーのアクセス許可の変更に関するページ参照してください。
  • 共有クエリを追加して保存するには、Basic 以上のアクセス権が必要です。
  • クエリを追加するフォルダーに対する投稿アクセス許可が [許可] に設定されている必要があります。 既定では、共同作成者グループにはこのアクセス許可が ''ありません''。

注意

パブリック プロジェクトの利害関係者アクセスが付与されたユーザーは、基本アクセスが付与されたユーザーと同様に、クエリ機能へのフル アクセス権を持っています。 詳細については、「利害関係者アクセスクイック リファレンス」を参照してください。

  • 既定では、利害関係者アクセスが付与されたすべてのプロジェクト メンバーとユーザーが、すべての共有クエリを表示して実行することができます。 共有クエリ フォルダーまたは共有クエリに設定されているアクセス許可は変更することができます。 詳細については、「クエリのアクセス許可を設定する」を参照してください。
  • [共有クエリ] でクエリを追加して保存するには、基本以上のアクセス権が付与されている必要があります。 また、クエリを追加するフォルダーに対する投稿アクセス許可が [許可] に設定されている必要があります。 既定では、共同作成者グループにはこのアクセス許可がありません。

クエリを開く

Web ブラウザーから、(1) 正しいプロジェクトが選択されていることを確認し、(2) [Boards] > [クエリ] を選んでから、(3) [すべて] を選択します。

[Boards] > [クエリ] を開く、縦型ナビゲーション

[クエリ] を開くのが初めての場合は、ページに [お気に入り] が表示されます。 このページには、お気に入りとして指定したクエリの一覧が表示されます。 それ以外の場合は、[すべて] を選択して、ユーザーが定義したすべてのクエリと、プロジェクトに対して定義された共有クエリを表示できます。

ヒント

[お気に入り] ページには、ユーザーまたはチームがお気に入りとして選択したクエリが表示されます。 [プロジェクト] ページには、お気に入りのクエリと共に他のオブジェクトも表示されます。 詳細については、「個人またはチームのお気に入りを設定する」を参照してください。

クエリを実行、編集、保存する

クエリを定義する最も簡単な方法は、既存の共有クエリから開始することです。 次の例では、アジャイル プロセス テンプレートに用意されている "アクティブなバグ" 共有クエリを変更して、すべての終了したバグを検索する方法を示します。 これらの例は、Web ポータルで提供されるユーザー インターフェイスに基づいています。

  1. 共有クエリを開きます。 たとえば、Web ポータルから、"アクティブなバグ" か、同様の単純なリストのクエリを開きます。

    アクティブなバグのクエリを実行する

    ヒント

    Visual Studio チーム エクスプローラーで作業している場合は、[作業] ページを開いてクエリと共有クエリにアクセスします。 チーム エクスプローラーが表示されない場合は、最上位レベルのメニューから [表示] > [チーム エクスプローラー] を選択します。

  2. 終了したバグを検索するようにクエリを編集してから、そのクエリを実行します。 現在の句の前に句を挿入するには、新しいフィルター行を挿入 を使用します。 句を削除するには、このフィルター行を削除 を使用します。 クエリのスコープは、現在のプロジェクトに自動的に設定されます。 複数のプロジェクトで定義されている作業項目を検索する方法については、プロジェクト間でのクエリの実行に関する記事を参照してください。

    Web ポータル、[クエリ] ページ、新しいクエリ エクスペリエンス、単純なリストのクエリのエディター ビュー

  3. マイ クエリ フォルダーにクエリを保存します。

    [クエリとして保存] ダイアログ、新しいエクスペリエンス

    共有クエリ フォルダーにクエリを保存するには、プロジェクト管理者グループのメンバーであるか、フォルダーの [投稿] アクセス許可が [許可] に設定されている必要があります。 詳細については、「クエリのアクセス許可を設定する」を参照してください。

クエリの名前を変更またはクエリを削除する

[お気に入り] ページまたは [すべて] ページで、クエリの アクション アイコンを選択して、そのクエリを実行、編集、名前変更、または削除します。

新しいクエリ エクスペリエンス、[お気に入り] ページ、クエリ コンテキスト メニュー

共有クエリの場合は、次のいずれかのタスクを実行することもできます。

  • [チーム クエリに追加]: チームを選択し、そのクエリをチームのお気に入りとして追加します
  • [セキュリティ...]: クエリのアクセス許可を設定します。 詳細については、「クエリのアクセス許可を設定する」を参照してください。
  • [ダッシュボードに追加]: 選択したチーム ダッシュボードにクエリ タイル ウィジェットを追加します。 詳細については、「ダッシュボードにウィジェットを追加する」を参照してください。

クエリ フォルダーを追加してそのフォルダーに項目を移動する

ヒント

共有クエリまたは共有フォルダーの名前を変更または移動するには、削除アクセス許可と、クエリの移動先フォルダーに対する投稿アクセス許可が必要です。 アクセス許可を表示または設定する方法については、クエリとクエリ フォルダーに対するアクセス許可の設定に関する記事を参照してください。

[Boards] > [クエリ] > [すべて] ページからクエリ フォルダーを追加します。

  1. [すべて] を選択します。 クエリ フォルダーを追加する場所に応じて、マイ クエリまたは共有クエリを展開します。

  2. フォルダーを追加するには、既存のフォルダーのまたは上部のコンテナー フォルダーの アクション アイコンを選択し、[新しいフォルダー] を選択します。

    アクション メニューを開き、[新しいフォルダー] を選択する

  3. [新しいフォルダー] ダイアログで、フォルダーの名前を入力します。 フォルダーの場所を変更する場合は、[フォルダー] ドロップダウン メニューから場所を選択します。

    フォルダーの名前と場所を入力します。

  4. 項目をフォルダーに移動するには、クエリをフォルダーにドラッグ アンド ドロップします。 Web ポータルでは、フォルダーの外部からフォルダーにドラッグできるクエリは 1 つのみです。

    必要に応じて、既存のクエリの [その他のコマンド] を選択し、[ 編集] を選択して、[名前を付けて保存] を選択できます。 [クエリを名前を付けて保存] ダイアログで、クエリを保存するフォルダーを選択します。

    [クエリに名前を付けて保存] ダイアログ

チームのお気に入りとしてクエリを保存する

共有クエリをチームのお気に入りとして保存するには、チームのメンバーである必要があります。

ダッシュボードにクエリを追加するには、クエリの アクション アイコン ( コンテキスト アイコン) メニューを開き、特定のダッシュボードに追加するか、チームのお気に入りとして追加します。

チームとクエリを共有するには、[共有クエリ] コンテナーの下のフォルダーにクエリを追加します。 クエリを共有クエリ フォルダーに保存するには、プロジェクト コレクション管理者グループのメンバーになるか、自身のアクセス許可を共有クエリの下位にあるフォルダーに設定する必要があります。

ダッシュボードまたはチームのお気に入りへの共有クエリの追加のみが可能で、その場合にはチーム管理者またはプロジェクト管理者のアクセス許可が必要です。

  1. クエリをチームのお気に入りとして保存するには、[クエリ] ページからそのクエリの [その他のアクション] または コンテキスト メニューを開きます。

  2. [チームのお気に入りに追加] を選択し、一覧に表示されているチームの中から選択します。 メンバーであるチームのみが一覧に表示されます。

    チームのお気に入りとしてクエリを保存するスクリーンショット。

ダッシュボードにクエリ タイルを追加する

クエリ タイルには、クエリ内の作業項目の数が表示されます。 クエリはダッシュボードからすぐに開くこともできます。 クエリ タイルは、次の手順を使用して [クエリ] ページから、またはダッシュボードへのウィジェットの追加で説明する手順に従って、ダッシュボードに追加できます。

注意

共有クエリはダッシュボードにのみ追加できます。 また、チーム ダッシュボードにウィジェットを追加または編集するには、チームのメンバーであるか、ダッシュボードを編集するためのアクセス許可が付与されている必要があります。

  1. [クエリ] ページからクエリをダッシュボードに追加するには、そのクエリの アクション アイコン ( コンテキスト アイコン) メニューを開きます。

    [その他のアクション] メニューのスクリーンショット、[ダッシュボードに追加] を選択します。

  2. [ダッシュボードの選択] ダイアログで、クエリを追加するダッシュボードを選択します。

    [ダッシュボードの選択] ダイアログのスクリーンショット。

  3. ダッシュボードを開き、クエリ タイルが追加されたことを確認します。 クエリ タイルを構成して、既定の色を変更したり、指定した条件付きルールに基づいてタイルの色を指定したりできます。

    クエリ タイル ウィジェットの [構成] ダイアログのスクリーンショット。