作業項目クエリの表示、実行、または電子メールでの送信

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

Visual Studio 2019 | Visual Studio 2022

自分や自分のチームに割り当てられている作業項目を見つけるには、クエリを実行します。 多くの作業項目クエリは、プロセスで事前に定義されています。 チームのメンバーが、自分が表示して実行できる共有クエリを作成している場合があります。 多くの場合、既に利用できるクエリ定義を基にして新しいクエリを定義する方が簡単です。

前提条件

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

注意

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

クエリを開く

ブラウザー

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

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

ヒント

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

Visual Studio

重要

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

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

   

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

   

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

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

Azure Boards でクエリを実行する

クエリを実行するには、フォルダーを展開し、クエリのタイトルを選択します。 ビューが開き、クエリの [結果] が表示されます。

Azure DevOps コマンド ライン インターフェイスを使ってクエリを実行することもできます。

ブラウザー

ヒント

[クエリ] ページは、他の Web ポータル ページと同様に、最後に進んだビューを記憶し、そのビューに戻ります。

1. [すべて] を選択して、定義したすべてのクエリやプロジェクト内で共有されているすべてのクエリを確認できるページを開きます。

   

2. 必要に応じて [マイ クエリ] を選択します。

   • 自分に割り当てられているすべての作業項目を表示するには、[自分に割り当て済み] を選択します。 このクエリでは、@Me マクロを使って、自分に割り当てられているすべての作業項目を一覧表示します。
   • フォローしているすべての作業項目を表示するには、[フォローする作業項目] を選択します。 このクエリでは、@Follows マクロ (@Follows) の ID) を使って、フォローを選択したすべての作業項目を一覧表示します。 詳細については、作業項目または pull request のフォローに関する記事を参照してください。

3. [共有クエリ] を選択してフォルダーを展開し、共有クエリとして保存されたクエリにアクセスします。

4. 階層リンク内のフォルダーを選択して、クエリ フォルダーを開きます。

   

Visual Studio

重要

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

• チーム エクスプローラーの [作業項目] ページで、クエリのコンテキスト メニューを開き (マウスで右クリック)、[結果の表示] を選択します。 または、クエリをダブルクリックして開きます。

  

コマンド ラインからクエリを実行する

CLI で az boards query コマンドを使ってクエリを実行できます。 開始するには、「Azure DevOps CLI の概要」を参照してください。

az boards query [--id]
                [--org]
                [--path]
                [--project]
                [--wiql] 

パラメーター

• id: 既存のクエリの ID。 --path または --wiql を指定しない限り、必須です。
• wiql: 作業項目クエリ言語形式のクエリ。 --id または --path を指定する場合は無視されます。
• path: 既存のクエリのパス。 --id を指定する場合は無視されます。
• org: Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。 既定として設定されていない場合、または git config を使用して取得された場合は必須です。 例: --org https://dev.azure.com/MyOrganizationName/.
• project: プロジェクトの名前または ID。 az devops configure -d project=NAME_OR_ID を使用して、既定のプロジェクトを構成できます。 既定として設定されていない場合、または git config を使用して取得された場合は必須です。

例

次のコマンドは、指定した ID でクエリを実行し、結果をテーブル形式で表示します。

az boards query --id 6c286d74-26a5-4cce-bfcf-bf9123495bfe  --output table

Priority    Node Name         Work Item Type    Title                             Remaining Work
----------  ----------------  ----------------  --------------------------------  ----------------
1           Voice             Bug               Apply fix elsewhere as needed
2           CMMI              Bug               Slow response on form
1           Fiber             Bug               Check issues with permissions     0
2           Fiber             Bug               Voicemail hang issue              0
2           FabrikamBB        Bug               Research slow response time
1           FabrikamBB        Bug               Fix performance issues            0 

次のコマンドは、指定した WIQL でクエリを実行し、結果をテーブル形式で表示します。

az boards query --wiql "SELECT [Microsoft.VSTS.Common.Priority], [System.NodeName], [System.WorkItemType], [System.Title], [Microsoft.VSTS.Scheduling.RemainingWork], [System.AssignedTo], [System.State], [System.Tags], [System.AreaPath] FROM workitems WHERE [System.WorkItemType] = 'Bug' AND [System.AreaPath] = 'Fabrikam Fiber' ORDER BY [System.WorkItemType]" --output table

Priority    Node Name       Work Item Type    Title                  Remaining Work
----------  --------------  ----------------  ----------------       ----------------
2           Fabrikam Fiber  Bug               Slow response on form
2           Fabrikam Fiber  Bug               Check permissions
2           Fabrikam Fiber  Bug               Fix performance issue
2           Fabrikam Fiber  Bug               Secure Sign-in 

クエリ ディレクトリ、クエリ フォルダー、階層リンク

Note

[お気に入り] または [チームのお気に入り] にフォルダーを追加することはできません。

ブラウザー

[クエリ] ページにはディレクトリに焦点を当てたビューが含まれており、フィルター処理して関心のある特定のクエリを検索できます。 [クエリ] ページで作業する場合は、サブフォルダー、フォルダー、またはページに進むことができます。

また、セレクター メニューからお気に入りのクエリを選択したり、すべてのクエリを参照したりすることもできます。その場合、[すべてのクエリ] ページに戻ります。

Visual Studio

[作業項目] ページには、Web ポータルで定義されているのと同じフォルダー構造が表示されます。 Visual Studio を使って行った変更が Web ポータルに反映されます。

フォルダーの展開と折りたたみ、フォルダー名の変更、フォルダー間でのクエリのドラッグ アンド ドロップを行うことができます。 詳細については、「クエリの管理と整理」を参照してください

詳しくは、クエリに関する FAQ、移動、フォルダーに関する記事を参照してください。

[すべて] と [お気に入り] でサポートされているタスク

各クエリの一覧ページから、次の表に示すように、クエリを表示および実行するほとんどのタスクを実行できます。 [マイ クエリ] に保存するクエリと、お気に入りに追加したクエリのみが [お気に入り] に表示されます。 チームがお気に入りに追加できるのは、[共有クエリ] に保存されたクエリのみです。

タスク	お気に入り (ブラウザー)	すべて (ブラウザー)	作業項目 (チーム エクスプローラー)
自分または自分が所属しているチームのお気に入りに追加されたクエリをすべて表示する	✔️		✔️
現在のプロジェクトのすべてのクエリまたは共有クエリを表示する		✔️	✔️
クエリを実行し、クエリのコンテキスト メニューを開く	✔️	✔️	✔️
コンテナー フォルダーまたはクエリ フォルダーの展開または折りたたみ	✔️	✔️	✔️
クエリの一覧をフィルター処理する	✔️	✔️
クエリをお気に入りに追加する (Web ポータルの場合は、 を選択)		✔️
クエリをお気に入りから外す (Web ポータルの場合は、 を選択)	✔️	✔️	✔️
新しいクエリを追加: を選択する	✔️	✔️	✔️

クエリの一覧をフィルター処理する

フィルター ボックスにキーワードを入力して、[お気に入り] ページまたは [すべて] ページに表示されるクエリのセットをフィルター処理します。 フィルター処理について詳しくは、バックログ、ボード、クエリ、計画のフィルター処理に関する記事を参照してください。

詳しくは、クエリに関する FAQ、移動、フォルダーに関する記事を参照してください。

クエリ項目を電子メールで送信する、またはクエリ URL を共有する

ブラウザー

[クエリ エディター] または [結果] ビューから、書式設定されたクエリ項目の一覧を電子メールで送信したり、クエリ URL をコピーしたりできます。

アクション アイコンを選択してメニューを開き、一覧表示されるオプションから、[クエリを電子メールで送る] または [クエリの URL をコピー] を選択します。

電子メールは、システムによって認識されるプロジェクト メンバーの個々のアドレスにのみ送信できます。 宛先行にチーム グループまたはセキュリティ グループを追加することはサポートされていません。 システムで認識されないメール アカウントを追加すると、メールの受信者の 1 人以上がメールで送信された作業項目を閲覧するアクセス許可を持っていないというメッセージが表示されます。

注意

プロジェクト メンバーではないユーザーに書式設定された一覧を電子メールで送信するには、「作業項目の一覧をコピーする」で説明されている [HTML としてコピー] オプションを使う必要があります。 オンプレミスの Azure DevOps の場合、すべての電子メール アクションで SMTP サーバーを構成する必要があります。 SMTP サーバーが構成されていない場合は、[HTML としてコピー] を使用してこれを回避できます。

Visual Studio

書式設定されたクエリの一覧を電子メールで送信するには、コンテキスト メニューから [Microsoft Outlook に送信] オプションを選択します。

注意

この機能を使うには、Microsoft Outlook がインストールされている必要があります。 オンプレミスの Azure DevOps の場合、すべての電子メール アクションで SMTP サーバーを構成する必要があります。 SMTP サーバーが構成されていない場合は、Web ポータルから [HTML としてコピー] を使用してこれを回避できます。

次のステップ

クエリを定義する

関連記事

• クエリとクエリ フォルダーの管理
• バックログ、ボード、クエリ、計画の対話的なフィルター処理
• 列オプションの変更
• 個人またはチームのお気に入りを設定する
• キーボード ショートカット