在 Azure Boards 中使用受控查詢來追蹤您的工作
Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019 |TFS 2018
根據您使用查詢指定的欄位準則，列出 Bug、使用者劇本或其他工作專案。 然後，您可以使用小組、分級工作或大量更新工作專案來檢閱這些清單。 除了 Managed 查詢之外，語意搜尋工具還提供一些值得探索的重迭和不同功能。
使用受控查詢來支援這些作業：
- 使用入口網站大量更新工作專案
- 分級和更新工作專案
- 檢閱工作專案的階層
- 與小組成員共用工作專案清單
您可以從入口網站或 Visual Studio Team Explorer 建立查詢和查詢資料夾。 您在一個用戶端中所做的變更會反映在其他用戶端，因為所有變更都會儲存在工作追蹤資料存放區中。
開始使用查詢
如果您剛開始使用，請閱讀 檢視、執行或以電子郵件傳送工作專案查詢。 如需查詢編輯器工作和範例查詢的快速參考，請參閱 查詢快速參考。
- 若要尋找指派給您的工作專案，請將 @Me 宏新增為其中一個查詢子句中 [ 指派 給] 欄位的值。
- 具有標準存取權的所有有效使用者可以在 [ 我的查詢 ] 區域下建立查詢和資料夾。 若要在 [共用查詢] 下建立查詢和查詢資料夾，您必須擁有 「參與」許可權集合。 如需詳細資訊，請參閱 設定查詢的許可權。
- 您可以藉由新增準則來專注于產品區域、反復專案或其他欄位，來修改任何查詢。 若要修改查詢， 請開啟查詢編輯器。
- 您可以在 Excel中開啟任何查詢。 您也可以更新一或多個工作專案的欄位，並將變更發佈至資料庫以追蹤工作專案。
- 您可以針對一般清單查詢建立圓形圖、直條圖或趨勢圖，以 視覺化方式呈現狀態或進度 。
查詢功能
下列各節提供定義和管理工作專案查詢所支援之函式的概觀。
- 查詢篩選準則是透過查詢編輯器來定義。
- 您可以為特定欄位選取查詢宏，以建立查詢子句。
- 查詢結果和查詢管理功能是可透過 [查詢結果] 頁面取得的功能。
查詢篩選
下表摘要說明每個 Azure DevOps 版本支援的查詢篩選函式。
注意
受控查詢不支援鄰近搜尋，不過語意搜尋確實支援。 此外，語意搜尋同時 * 支援 和 ? 作為萬用字元，而且您可以使用多個萬用字元來比對多個字元。 若要深入瞭解，請參閱 功能工作專案搜尋。
Filter 函數
查詢支援
支援的版本
文字字串 ( 單一文字、多行文字、RTF 文字)
搜尋不區分大小寫。
所有版本
萬用字元 = *
所有版本
根據直接連結或拓撲/階層式連結類型尋找工作專案。
根據 MODE (WIQL 語法 篩選連結的工作專案)
所有版本
使用 AND 和 OR 布林運算子分組和巢狀子句。
所有版本
根據欄位比對與先前的值尋找工作專案。
支援的運算子： Was Ever 根據特定日期定義的值尋找工作專案。
支援的運算子： ASOF (WIQL 語法)
所有版本
使用宏來建立相對於日期、其他工具的查詢，例如小組區域路徑、小組反復專案等等。
所有版本
在組織或集合中的一或多個專案中尋找工作專案。 預設值為目前的專案。 使用 [小組專案] 欄位來查詢兩個或多個專案。
所有版本
根據兩個欄位彼此比較的方式尋找工作專案。
支援的運算子： =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field]
所有版本
根據工作專案是否包含標記來尋找工作專案。
支援的運算子： Contains, Does Not Contain
所有版本
根據空白或非空白 HTML/RTF 欄位尋找工作專案。
支援的運算子： Is Empty, Is Not Empty
Azure DevOps 2019 到 Azure DevOps Server 2022，Azure DevOps Services
尋找域值符合分隔集中任何值的工作，例如一組工作專案類型、工作流程狀態或挑選清單值。 使用針對用戶端電腦定義之地區設定的對應清單分隔符號，來分隔值。 例如，您可能會使用逗號 (,)。
所有版本
根據布林域值尋找工作專案。
所有版本
根據透過討論新增的關鍵字或片語尋找工作專案。
所有版本
根據工作流程看板資料行、泳道或執行/完成狀態尋找工作專案。
Azure DevOps 2019 到 Azure DevOps Server 2022，Azure DevOps Services
根據關鍵字或選取欄位來篩選查詢結果。
Azure DevOps 2019 到 Azure DevOps Server 2022，Azure DevOps Services
若要大量移動、複製或貼上查詢子句，請安裝和使用 WIQL 編輯器。 若要深入瞭解，請參閱 跨服務與增強查詢作業
支援的巨集
下表摘要說明 Azure DevOps 版本支援的查詢宏或變數。 您可以使用其中一些宏來篩選通知。
注意
您只能從入口網站使用特定宏。 其中包括 @CurrentIteration、 @CurrentIteration +/- n、 @Follows、 @MyRecentActivity、 @RecentMentions、 @RecentProjectActivity和 @TeamAreas 宏。 將查詢匯出至 Excel、通知篩選或從 Team Explorer 或 REST API 練習時，不支援這些宏。
如需範例的詳細描述和連結，請參閱 查詢欄位、運算子和宏。
巨集
查詢支援
支援的版本
尋找任何工作專案類型、 Work Item Type=[Any] 或任何 State。 State=[Any]
所有版本
尋找工作，其中 Identity field=logged in user 。
所有版本
尋找工作，其中 Date-Time field=today 。
所有版本
尋找一或多個專案中定義的工作。
所有版本
尋找小組目前反復專案中定義的工作。
所有版本
尋找小組目前反覆運算的 +/- n 中定義的工作。
Azure DevOps 2019 到 Azure DevOps Server 2022，Azure DevOps Services
尋找登入使用者目前登入的工作如下： ID In @Follows 。
所有版本
尋找最近變更的工作專案、 ID In @MyRecentActivity 另請參閱 檢視和新增工作專案、工作專案頁面。
所有版本
尋找選取日期時間欄位在目前日、月、周或年內加上/減號位移的工作，例如： Closed Date>=@StartOfDay-7 。
Azure DevOps 2019 到 Azure DevOps Server 2022，Azure DevOps Services
尋找指派給指定小組的區域路徑或反復專案路徑的工作，如需範例，請參閱 依區域或反復專案路徑查詢。
Azure DevOps 2019 到 Azure DevOps Server 2022，Azure DevOps Services
查詢結果和查詢管理功能
下列功能支援使用查詢結果、儲存和共用查詢等等。
- 匯入/匯出查詢 (csv)
- 匯入/匯出查詢 (.wiq)
- 開啟並執行查詢
- (Excel) 發佈/重新整理查詢
- 執行 REST API 查詢
- 儲存查詢
- 設定查詢許可權
- 分級查詢結果
不支援的功能
工作專案查詢僅支援查詢連結至其他工作專案的工作專案和工作專案。 以下是 Managed 查詢不支援的一些工作：
- Test Plans、測試套件和測試案例的階層式檢視。 這些專案不會使用父子連結類型連結在一起。 相反地，您可以透過 [測試 > Test Plans] 頁面檢視階層。
- 顯示連結化物件的檢視，例如組建、發行、程式碼或其他非工作專案物件。
- 列出從某個專案連結到另一個專案的工作專案。
- 將跨專案查詢匯出至 Excel。 直接連結查詢會匯出至 Excel 做為一般清單。
查詢類型 (一般、直接連結、樹狀結構)
Azure Boards支援三種查詢類型。 每個查詢旁的圖示會指出查詢類型。 使用下列指引，根據您想要使用查詢完成的工作來選取查詢類型。
查詢類型
用法指導方針
工作項目一般清單
- 列出要對欄位進行大量更新的專案
- 分級工作專案清單
- 建立查詢圖表並將它新增至儀表板
- 建立圖表以取得專案計數或加總欄位
- 將專案清單匯出至 Excel 以更新欄位
工作項目和直接連結
- 列出相依于其他工作專案的專案
- 尋找相關專案或相依于其他工作專案
- 列出連結的工作專案以對欄位進行大量更新
- 分級連結的工作專案清單
- 列出與測試相關的連結工作專案
- 尋找孤立待辦專案、沒有父項的工作專案
注意
工作專案和直接連結 查詢會以一般清單的形式匯出至 Excel。 直接連結查詢會匯入為一般清單，因為修改多種連結類型不是 Excel 中支援的功能。
工作項目樹狀結構
- 列出Parent-Child相關工作專案或其他樹狀拓撲連結類型的樹狀結構
- 分級工作專案的階層式清單
- 將專案的階層式清單匯出至 Excel，以更新欄位或修改階層
若要深入瞭解連結類型，請參閱 連結類型參考。
我的查詢、共用查詢和我的最愛
您只能使用查詢目錄，在 [ 我的查詢 ] 底下檢視並執行您所儲存的查詢。 此外，您也可以將其中一個查詢加入我的最愛，使其出現在查詢選取器內。
您可以在 共用查詢 下儲存的查詢，由具有專案存取權的每個人檢視。 共用查詢可以組織在資料夾內，並由您或小組使用我的最愛。 此外，您也可以設定資料夾和查詢的許可權，以防止其他人移動或編輯它們。
如需詳細資料，請參閱：
查詢目錄、查詢資料夾和階層連結
[查詢] 頁面包含目錄焦點檢視，您可以篩選以尋找感興趣的特定查詢。 在 [查詢] 頁面中工作時，您可以流覽至子資料夾、資料夾或頁面。
此外，您也可以從選取器功能表選擇您最愛的查詢。 或者，您可以選擇流覽所有傳回您至 [ 所有查詢 ] 頁面的查詢。
如需詳細資訊，請參閱 查詢常見問題、巡覽和資料夾。
查詢圖表和小工具
您可以從一般清單查詢快速建立圓形圖、橫條圖、樞紐和趨勢圖。 查詢必須是一般清單，並傳回 1000 個或更少的工作專案。 您可以將查詢圖表新增至儀表板、重新整理及重新設定它們。
查詢型小工具支援在儀表板上呈現查詢資訊。 例如，作用中 Bug 的數目，或您可以與其互動的工作專案清單。 若要瞭解查詢圖表和小工具，請參閱下列文章：
新增自訂欄位以支援查詢
若要新增自訂欄位以支援您的查詢需求，請參閱 自訂您的工作追蹤體驗。
任務板與查詢清單專案
您可能會注意到並想知道工作面板的內容為何與其建立的查詢所列出的內容不同？ 若要深入瞭解，請參閱 工作面板專案與查詢清單專案。
全文檢索搜尋查詢和定序設定
若要支援全文檢索搜尋查詢，SQL Server資料庫的定序設定應該對應至已向 SQL Server 註冊斷詞工具的語言。 如果您使用不支援的語言，當您執行工作專案查詢來指定 包含 或 包含文字字串的 Words 運算子時，可能會收到非預期的結果。
如需詳細資訊，請參閱下列文章：
REST API
若要以程式設計方式與查詢互動，請參閱下列其中一個 REST API 資源：