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

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

Visual Studio 2019 | Visual Studio 2022

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

Note

この記事で使用されているブラウザーの画像は、既定で有効になっている新しいボード ハブ機能を示しています。 この機能が有効になっていない場合は、以前のボード エクスペリエンスが使用されている可能性があります。 以前のエクスペリエンスに対応する画像を表示するには、この記事の Azure DevOps Server 2022 バージョンを選択します。

前提条件

• アクセス レベル:
  • 共有クエリを表示して実行するには、 project メンバー。
  • 共有クエリを追加して保存するには、少なくとも Basic アクセス権を持つ必要があります。
• アクセス許可: クエリを追加するフォルダーに対する 投稿 アクセス許可が [許可] に設定されていること。 既定では、共同作成者グループにはこのアクセス許可がありません。

注意

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

クエリを開く

ブラウザー

プロジェクトから [Boards] > [クエリ] を選択し、[すべて] を選択します。

[クエリ] ページが開き、お気に入りとして設定したクエリが [お気に入り] タブに一覧表示されます。 [すべて] タブを選択して、ユーザーが定義したすべてのクエリと、プロジェクトに対して定義された共有クエリを表示できます。

ヒント

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

Visual Studio

重要

このレガシ ビューではなく、 既定のビュー を使用することを、すべてのユーザーに強くお勧めします。 割り当て、フォロー、メンション、または最近の更新に基づいて、作業項目のリストにすばやくアクセスできるように設計されています。 レガシ ビューは拡張されなくなり、Visual Studio の今後のリリースで削除される予定です。

1. チーム エクスプローラー ホーム ページで、 [作業項目] を選択します。

   

2. クエリを開くには、(マウスで右クリックして) クエリのコンテキスト メニューを開き、 [結果の表示] を選択します。 または、クエリをダブルクリックして開きます。

   

または、次のいずれかのオプションを選択します。

• [クエリの編集]: 選択したクエリの クエリ エディター を開きます。
• [新しいクエリ]: 既定の新しいクエリ オプションを使用して クエリ エディター を開きます。
• [Microsoft Excel で開く (フラット)]: Microsoft Excel でクエリを開きます。
• [Microsoft Outlook に送信]: 開く
• [切り取り]: クエリを切り取ります。 その後、そのクエリを別のフォルダーに貼り付けることができます。
• [コピー]: クエリをコピーします。 その後、そのクエリを同じフォルダーまたは別のフォルダーに貼り付けることができます。
• [削除]: クエリを削除します。
• [名前の変更]: クエリの名前を変更できます。
• [お気に入りに追加]: クエリを [お気に入り] セクションに追加します。
• [チームのお気に入りに追加]: クエリを [チームのお気に入り] セクションに追加します。
• [セキュリティ]: クエリの [アクセス許可] ダイアログを開きます。

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

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

ブラウザー

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

   

   ヒント

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

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

   

3. [その他のアクション] メニューの [名前を付けて保存] を選択します。

   Note

   [新しいボード ハブ] 機能が有効になっていない場合、[名前を付けて保存] はページ丈夫で選択します。

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

   

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

Visual Studio

重要

このレガシ ビューではなく、 既定のビュー を使用することを、すべてのユーザーに強くお勧めします。 割り当て、フォロー、メンション、または最近の更新に基づいて、作業項目のリストにすばやくアクセスできるように設計されています。 レガシ ビューは拡張されなくなり、Visual Studio の今後のリリースで削除される予定です。

クエリを新しいクエリとして保存するには、クエリの結果を開き、ツール バーから [ファイル]>["クエリ名" に名前をつけて保存...]を選択します。

クエリの名前とフォルダーの場所を指定します。

クエリを .wiq ファイルとして保存するには、[ファイル] ラジオ ボタンを選択し、ファイルの場所を指定します。

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

ブラウザー

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

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

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

Visual Studio

重要

このレガシ ビューではなく、 既定のビュー を使用することを、すべてのユーザーに強くお勧めします。 割り当て、フォロー、メンション、または最近の更新に基づいて、作業項目のリストにすばやくアクセスできるように設計されています。 レガシ ビューは拡張されなくなり、Visual Studio の今後のリリースで削除される予定です。

[作業項目] ページで、実行、編集、名前変更、または削除を行うクエリのコンテキスト メニューを開き、対応するオプションを選択します。

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

ヒント

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

ブラウザー

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

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

2. フォルダーを追加するには、[新しいフォルダー] を選択します。

   

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

   

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

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

   

Visual Studio

重要

このレガシ ビューではなく、 既定のビュー を使用することを、すべてのユーザーに強くお勧めします。 割り当て、フォロー、メンション、または最近の更新に基づいて、作業項目のリストにすばやくアクセスできるように設計されています。 レガシ ビューは拡張されなくなり、Visual Studio の今後のリリースで削除される予定です。

Visual Studio でクエリ フォルダー構造に加えたすべての変更は、ブラウザーを更新することで Web ポータルに表示されます。

1. [作業項目] ページで、 マイ クエリ、 チーム クエリ、または既存のクエリ フォルダーのコンテキスト メニューを開き、 [新しいフォルダー]を選択します。

   

   選択した領域の下に 新しいフォルダー が追加されます。 フォルダーの名前を変更するには、フォルダーを選択します。

2. クエリをフォルダーに移動するには、クエリをフォルダーにドラッグ アンド ドロップします。 複数のクエリを選択し、フォルダーにドラッグすることも、1 つのフォルダーから別のフォルダーにドラッグすることもできます。

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

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

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

共有クエリをチームのお気に入りとして追加できるのは、チーム管理者またはプロジェクト管理者のアクセス許可を持っている場合のみです。

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

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

   

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

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

Note

チームのメンバーであるか、ダッシュボードを編集するアクセス許可が付与されている必要があります。

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

   

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

   

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

   

関連記事

• クエリに関する FAQ
• クエリのアクセス許可を設定する
• キーボード ショートカット
• プロジェクト レベルのアクセス許可を変更する