檢視、執行或電子郵件傳送工作項目查詢

Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

Visual Studio 2022

本文說明如何執行和共用查詢來存取 Azure Boards 工作專案並與之互動。 您可以檢視並執行內建或共用查詢，以識別指派給您的工作專案或符合其他準則的工作專案。

必要條件

• Azure DevOps 專案中包含指派給您或您追蹤的工作項，或是您定義或與您共用的查詢。 若要定義查詢，請參閱 定義工作專案查詢。

類別	要求
存取層級	- 若要檢視及執行共享查詢：專案成員。 - 若要新增和儲存共享查詢：需要至少 基本 存取。
許可權	將 Contribute 權限設定為 允許，讓您能夠在欲新增查詢的資料夾中進行操作。 根據預設， 參與者 群組沒有此許可權。

注意

具有公用專案項目關係人存取權的使用者具有完整查詢功能的存取權，就像具有基本存取權的使用者一樣。 如需詳細資訊，請參閱專案關係人存取快速參考。

開啟 [查詢] 頁面

若要開啟專案的 [查詢] 頁面，請選取 [面板]>[查詢]。 「 查詢」 頁面會開啟至「 我的最愛」 索引標籤，顯示您或您的團隊選擇做為我的最愛的查詢。 如需詳細資訊，請參閱 設定個人或小組我的最愛。

[ 我的最愛] 索引標籤也會顯示您在 [繼續] 下開啟的最後一次查詢。

若要查看專案中的所有個人和共用查詢，請選取 [查詢] 頁面上的 [全部] 索引標籤。 [全部] 索引標籤會顯示內建查詢、您定義的查詢，以及專案中共用的查詢。 展開 我的查詢、 共用查詢和其他資料夾以存取其查詢。

在 [查詢] 頁面的 [全部] 索引標籤上，除了您定義的查詢之外，[我的查詢] 資料夾還包含下列內建查詢：

• 指派給我 使用 @Me 巨集來列出目前專案中指派給您的所有工作項目。
• [已追蹤的工作專案] 使用@Follows巨集，在ID@Follows中來列出您所追蹤的所有工作專案。 如需詳細資訊，請參閱 遵循工作專案或提取要求。

[全部] 和 [我的最愛] 索引標籤支援的任務

您可以從 [查詢] 頁面的 [全部] 或 [我的最愛] 索引標籤執行大部分的檢視和執行查詢的工作，如下表所示。

Task	我的最愛	全部
列出所有標記為收藏的查詢，無論是您的查詢還是您所屬團隊的查詢	✔️
列出目前專案的所有查詢或共用查詢		✔️
收藏查詢		✔️
取消我的最愛查詢	✔️	✔️
篩選查詢清單	✔️	✔️
展開或收合資料夾	✔️	✔️
執行查詢或開啟查詢的內容功能表	✔️	✔️

只有內建查詢和您儲存在 [我的查詢] 底下的查詢會出現在 [我的查詢] 底下。 只有您最喜歡的查詢會出現在 「我的最愛」中。 只有儲存在共用查詢底下的 查詢 ，才能由小組最愛。

篩選查詢清單

在 [查詢] 頁面的 [我的最愛] 或 [所有] 索引標籤上的篩選方塊中輸入關鍵字，以篩選顯示的查詢。 如需詳細資訊，請參閱 以互動方式篩選待辦專案、面板、查詢和計劃。

導覽至查詢和資料夾

從「查詢」頁面的「我的最愛」或「全部」索引標籤中，您可以導覽以尋找並開啟特定查詢。

在 [全部 ] 索引標籤上，查詢頁面可以直接顯示，也可以位於資料夾或子資料夾中。 您可以瀏覽到資料夾、子資料夾或查詢頁面。

當您進行選取並開啟資料夾時，階層連結會顯示在頁面頂端。

您可以在階層連結中選取資料夾來開啟資料夾。

您也可以開啟我的最愛查詢，或從開啟查詢的下拉式功能表返回 [ 所有 查詢] 頁面。

執行查詢

若要從 [查詢] 頁面的 [我的最愛] 或 [全部] 索引標籤執行查詢，請視需要展開其資料夾，然後選取查詢。 查詢 [結果] 頁面隨即開啟。

您也可以在 [查詢] 頁面上選取查詢旁的 [更多動作] 圖示，然後從操作功能表中選取 [執行查詢] 或其他選項。

從 Azure DevOps CLI 執行查詢

您可以在 Azure DevOps 命令列介面中使用 az boards query 命令來執行 Azure Boards 查詢。 若要開始使用，請參閱 開始使用 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，例如 --org https://dev.azure.com/MyOrganizationName/。 除非設定為預設值或使用 git config取用，否則為必要。 使用az devops configure -d organization=ORG_URL 配置預設組織。
• project：專案名稱或 ID。 如果未設定為預設或使用 git config來挑選，則為必要項。 使用 az devops configure -d project=NAME_OR_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

下列命令會執行 WIQL 查詢，並以資料表格式顯示結果。

az boards query --wiql "SELECT [Microsoft.VSTS.Common.Priority], [System.NodeName], [System.WorkItemType], [System.Title], [Microsoft.VSTS.Scheduling.RemainingWork] 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

傳送電子郵件或共用查詢

從查詢 編輯器 或 結果視圖 中，您可以透過電子郵件將格式化的查詢項目清單傳送給專案成員，或複製要共用的查詢 URL。

選取右上角的 [ 更多動作 ] 圖示，然後從內容功能表中選取 [電子郵件查詢 ] 或 [ 複製查詢 URL ]。

您只能傳送電子郵件給系統辨識的個別專案成員。 不支援傳送至小組群組或安全性群組。 收件者必須具有讀取郵件工作項目的許可權。

電子郵件會透過您的預設郵件用戶端傳送，並包含查詢的鏈結，只會傳回列出的工作專案。 如需詳細資訊，請參閱 複製或克隆工作專案。

注意

若要透過電子郵件將格式化清單傳送給非專案成員的人員，請參閱 複製或透過電子郵件傳送工作專案清單。

在 Visual Studio 中檢視工作專案

在 Visual Studio 小組總管的 [工作專案] 頁面上，您可以列出已連線專案的工作專案。 查詢建立和管理必須在 Azure Boards Web 介面中完成。

在 [工作專案 搜尋] 窗格中，您可以套用篩選條件，依 [指派給]、[ 建立者]、[ 狀態] 或 [工作專案類型] 來檢視列出的工作專案。

您可以展開 [工作專案] 清單，然後選取目前檢視旁的下拉式箭號，以選取內建的 [指派給我]、[ 追蹤]、[ 提及] 或 [我的活動] 檢視。

針對列出的個別工作專案，您可以：

• 將滑鼠停留在工作專案上以顯示資訊。
• 選取工作專案標題以重新命名工作專案。
• 用滑鼠右鍵按一下工作項目，將它指派給自己或完成工作項目。
• 按兩下專案，或以滑鼠右鍵按一下，然後選取 [ 開啟 ]，以在 Azure Boards UI 中開啟工作專案。

您也可以選取 [新增工作專案] 並輸入工作專案標題來建立工作專案。 您透過 Visual Studio 所做的變更會反映在 Azure Boards 中。

後續步驟

定義工作項目查詢

相關內容

• 管理查詢和查詢資料夾
• 以互動方式篩選待辦專案、面板、查詢和計劃
• Azure Boards 中查詢的常見問題集