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

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

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

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

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

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

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

パラメーター

• id: 既存のクエリの ID。 --path または --wiql を指定しない限り、必須です。
• 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