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

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

Visual Studio 2019 |Visual Studio 2022

若要找出指派給您或小組的工作專案，您可以執行查詢。 您的程式可能包含數個您可以存取和執行的預先定義查詢。 通常，藉由修改現有的查詢定義，更容易建立新的查詢。

注意

本文中使用的瀏覽器影像來自預設啟用的新面板中樞功能。 如果未啟用此功能，您可能會使用先前的面板體驗。 若要顯示先前體驗的影像，請選取本文的 Azure DevOps Server 2022 版本。

必要條件

• 存取層級：
  • 擁有 項目關係人 存取權以檢視及執行共享查詢。 根據預設，所有項目成員都有項目關係人存取權。 如需詳細資訊，請參閱 變更共用查詢或資料夾的許可權。
  • 具有 基本 存取權或更新版本以新增和儲存共享查詢。
• 許可權： 將 [參與] 權限設定為 [允許 ] 以加入查詢的資料夾。 根據預設， 參與者 群組沒有此許可權。

注意

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

開啟查詢

瀏覽器

從您的專案中，選擇 [ 面板 > 查詢]，然後選擇 [ 全部]。

[ 查詢 ] 頁面會開啟至 [ 我的最愛] 索引 標籤，其中列出您設定為我的最愛的查詢。 您可以選擇 [ 所有 ] 索引標籤，以檢視您為專案定義和共用查詢的所有查詢。

提示

您或您的小組已選擇作為我的最愛的查詢顯示在 [ 我的最愛 ] 頁面上。 [我的最愛] 查詢和其他物件也會出現在您的 [專案 ] 頁面上。 如需詳細資訊，請參閱 設定個人或小組我的最愛。

Visual Studio

重要

強烈建議每個人都使用 默認檢視，而不是此舊版檢視 。 其設計目的是要根據您的工作分派、後續、提及或最近的更新，快速存取工作項目清單。 舊版檢視已不再增強，我們預期會在未來的Visual Studio版本中將其移除。

1. 從 [Team Explorer] 首頁，選擇 [ 工作專案]。

   

2. 若要開啟查詢，請開啟查詢的操作功能表（以滑鼠右鍵單擊），然後選擇 [ 檢視結果]。 或者，按兩下查詢以開啟它。

   

或者，選取下列其中一個選項：

• 編輯查詢：開啟所選查詢的 查詢編輯器。
• 新增查詢：使用預設的新查詢選項開啟 查詢編輯器。
• 在 Microsoft Excel 中開啟 （Flat）： 在 excel 中開啟查詢Microsoft。
• 傳送至 outlook Microsoft： 開啟
• 剪下：剪下查詢。 然後，您可以將查詢貼到不同的資料夾下。
• 複製：複製查詢。 然後，您可以將查詢貼到相同的資料夾或不同的資料夾下。
• 刪除： 刪除查詢。
• 重新命名： 可讓您重新命名查詢。
• 新增至我的最愛： 將查詢新增至 [我的最愛] 區段。
• 新增至 Team Favorites： 將查詢新增至 Team Favorites 區段。
• 安全性： 開啟查詢的許可權對話框。

在 Azure Boards 中執行查詢

若要執行任何查詢，請展開資料夾，然後選擇查詢的標題。 檢視隨即開啟以顯示查詢 結果。

您也可以使用 Azure DevOps 命令行介面來執行查詢。

瀏覽器

提示

[ 查詢 ] 頁面與其他入口網站頁面一樣，會記住您上次前往的檢視，並將您傳回該檢視。

1. 選擇 [全部 ] 以開啟頁面，您可以在其中檢視您定義或共用於專案內的所有查詢。

   

2. 視需要選擇 [我的查詢 ]。

   • 若要檢視指派給您的所有工作專案，請選擇 [指派給我]。 此查詢會 使用@Me 巨集來列出指派給您的所有工作專案。
   • 若要檢視您追蹤的所有工作專案，請選擇 [追蹤的工作專案]。 此查詢會 使用 @Follows 巨集 （ID 在 中 @Follows) 列出您遵循的所有工作專案。 如需詳細資訊，請參閱 遵循工作專案或提取要求。

3. 選擇 [共享查詢 ] 展開資料夾，並存取儲存為共用查詢的查詢。

Visual Studio

重要

強烈建議每個人都使用 默認檢視，而不是此舊版檢視 。 其設計目的是要根據您的工作分派、後續、提及或最近的更新，快速存取工作項目清單。 舊版檢視已不再增強，我們預期會在未來的Visual Studio版本中將其移除。

• 從 [Team Explorer 工作專案] 頁面，開啟查詢的操作功能表（以滑鼠右鍵按兩下），然後選擇 [ 檢視結果]。 或者，按兩下查詢以開啟它。

  

從命令行執行查詢

您可以使用 az boards query 命令，在 CLI 中執行查詢 。 若要開始使用，請參閱 開始使用 Azure DevOps CLI。

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

參數

• id：現有查詢的識別碼。 除非指定 --path 或--wiql，否則為必要專案。
• wiql：工作專案查詢語言 （WIQL） 格式的查詢。 如果 --id 指定 或 --path ，則會忽略 。
• path：現有查詢的路徑。 指定 if--id 時忽略。
• 組織：Azure DevOps 組織 URL。 您可以使用 來設定預設組織 az devops configure -d organization=ORG_URL。 如果未設定為預設或使用 git config來挑選，則為必要項。 範例：--org https://dev.azure.com/MyOrganizationName/。
• 專案：專案的名稱或識別碼。 您可以使用 來設定預設專案 az devops configure -d project=NAME_OR_ID。 如果未設定為預設或使用 git config來挑選，則為必要項。

範例

下列命令會執行具有指定識別碼的查詢，並以數據表格式顯示結果。

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 

查詢目錄、查詢資料夾和階層連結

注意

您無法將資料夾新增至 我的最愛 或 小組我的最愛。

瀏覽器

[ 查詢 ] 頁面包含 [ 我的最愛 ] 和 [ 所有 ] 索引標籤。每個都包含目錄焦點檢視，您可以篩選以尋找感興趣的特定查詢。

當您在 [查詢 ] 頁面中工作時，可以移至資料夾、子資料夾或查詢頁面。

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

Visual Studio

[ 工作專案 ] 頁面會顯示與入口網站中所定義相同的資料夾結構。 透過 Visual Studio 所做的變更會反映在入口網站中。

您可以展開和折疊資料夾、重新命名資料夾，以及將查詢從某個資料夾拖放到另一個資料夾。 如需詳細資訊，請參閱 管理和組織查詢

如需詳細資訊，請參閱 查詢常見問題、瀏覽和資料夾。

所有和我的最愛支援的工作

您可以執行大部分的工作，以檢視和執行每個查詢清單頁面的查詢，如下表所示。 只有您在 [我的查詢] 下儲存的查詢，且我的最愛會顯示在 [我的最愛] 底下。 只有儲存在共用查詢底下的 查詢 ，才能由小組最愛。

Task	我的最愛 （瀏覽器）	全部 （瀏覽器）	工作項目 （Team Explorer）
檢視您所屬的所有最愛查詢、您的或小組	✔️		✔️
檢視目前專案的所有查詢或共享查詢		✔️	✔️
執行查詢，開啟查詢的操作功能表	✔️	✔️	✔️
展開或折疊容器資料夾或查詢資料夾	✔️	✔️	✔️
篩選查詢清單	✔️	✔️
我的最愛查詢 （針對入口網站，選擇 ）		✔️
取消查詢 （針對入口網站，選擇 ）	✔️	✔️	✔️
新增查詢：選擇	✔️	✔️	✔️

篩選查詢清單

在篩選方塊中輸入關鍵詞，以篩選顯示在 [我的最愛 ] 或 [所有 ] 頁面上的查詢集。 若要深入了解篩選，請參閱 篩選待辦專案、面板、查詢和計劃。

如需詳細資訊，請參閱 查詢常見問題、瀏覽和資料夾。

電子郵件查詢專案或共用查詢 URL

瀏覽器

您可以從 [查詢編輯器] 或 [結果] 檢視，以電子郵件傳送格式化的查詢專案清單，或複製查詢 URL。

選擇更多動作圖示 以開啟功能表，然後從列出的選項中選取 [ 電子郵件查詢 ] 或 [複製查詢 URL]。

您只能將電子郵件傳送給系統可辨識之項目成員的個別位址。 不支援將小組群組或安全組新增至「To」行。 如果您新增系統無法辨識的電子郵件帳戶，您會收到一或多個電子郵件收件者無權讀取已郵寄工作項目的郵件。

注意

若要將格式化清單電子郵件傳送給非項目成員的人員，您必須使用複製工作項目清單中所述的 [複製為 HTML] 選項。 針對內部部署 Azure DevOps，所有電子郵件動作都需要 設定 SMTP 伺服器。 如果您沒有設定 SMTP 伺服器，您可以使用複製為 HTML 來解決此問題。

Visual Studio

您可以從操作功能表選擇 [傳送至Microsoft Outlook ] 選項，以傳送格式化的查詢清單。

注意

此功能需要您安裝 Microsoft Outlook。 針對內部部署 Azure DevOps，所有電子郵件動作都需要 設定 SMTP 伺服器。 如果您沒有設定 SMTP 伺服器，您可以從入口網站使用 複製為 HTML 來解決此問題。

下一步

定義查詢

相關文章

• 管理查詢和查詢資料夾
• 以互動方式篩選待辦專案、面板、查詢和計劃
• 變更數據行選項
• 設定個人或小組我的最愛
• 鍵盤快速鍵