Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020
使用查詢，根據您指定的欄位準則列出缺陷、使用者故事或其他工作項目。 團隊執行這些清單來優先處理工作、大量更新項目或檢視層級。 語義搜尋提供了值得探索的重疊和互補功能。
使用受管理的查詢來：
- 使用網頁入口批次更新工作項目
- 分級和更新工作專案
- 檢閱工作專案的階層
- 與隊友共用工作專案清單
您可以從入口網站或 Visual Studio Team Explorer 建立查詢和查詢資料夾。 您在一個用戶端中所做的變更會出現在其他用戶端中，因為所有變更都會儲存在工作追蹤資料存放區中。
開始使用查詢
如果您要開始使用，請閱讀 檢視、執行或透過電子郵件傳送工作專案查詢。 如需查詢編輯器工作和範例查詢的快速參考，請參閱 查詢快速參考。
- 若要尋找指派給您的工作專案，請使用 @Me 巨集作為子句中 [指派給] 欄位的值。
- 所有具有標準存取權的有效使用者都可以在 「我的查詢」下建立查詢和資料夾。 若要在 「共用查詢」下建立查詢或資料夾，您必須具有「貢獻」權限。 請參閱 設定查詢的許可權。
- 透過新增條件來修改任何查詢，以專注於產品區域、疊代或其他欄位。 若要修改查詢， 請開啟查詢編輯器。
- 在 Excel 中開啟任何查詢，以更新欄位並將變更發佈至資料庫。
- 透過為平面清單查詢建立圓餅圖、直欄圖或趨勢圖來視覺化其狀態或進度。 如需詳細資訊，請參閱 圖表。
查詢功能
下列各節摘要說明您用來定義和管理工作專案查詢的函式。
- 使用查詢編輯器定義查詢篩選器。
- 在子句中使用查詢巨集來動態地鎖定欄位。
- 從 [查詢結果] 頁面管理查詢結果和資料夾。
查詢篩選條件
下表摘要說明每個 Azure DevOps 版本支援的查詢篩選函式。
注意
受控查詢不支持鄰近搜尋，但語意搜尋確實支援。 此外，語意搜尋同時 * 支援 和 ? 作為通配符，而且您可以使用多個通配符來比對多個字元。 如需詳細資訊，請參閱 功能工作項目搜尋。
篩選函式
查詢支援
支援的版本
文字字串搜尋 （單一文字、多行文字、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
所有版本
尋找域值符合分隔集合中任何值的工作，例如一組工作項目類型、工作流程狀態或挑選清單值。 將值與清單分隔符分隔，對應至針對用戶端電腦定義的區域設定。 例如，您可以使用逗號 （，）。
所有版本
根據布爾值域值尋找工作專案。
所有版本
根據透過討論新增的關鍵詞或詞組，尋找工作專案。
所有版本
根據工作項目的數據行、泳道或 [執行/完成] 狀態來尋找工作專案。
所有版本
根據關鍵詞或選取欄位來篩選查詢結果。
所有版本
若要大量移動、複製或貼上查詢子句，請安裝並使用 WIQL編輯器。
支援的巨集
下表摘要說明 Azure DevOps 版本支援的查詢巨集或變數。 您可以使用其中一些巨集來篩選通知。
注意
您只能從入口網站使用特定巨集。 其中包括@CurrentIteration、@CurrentIteration +/- n、@Follows、@MyRecentActivity、@RecentMentions、@RecentProjectActivity和@TeamAreas巨集。 將查詢導出至 Excel、通知篩選或從 Team Explorer 或 REST API 練習時，不支援這些巨集。
如需範例的詳細描述和連結，請參閱 查詢欄位、運算元和巨集。
巨集
查詢支援
支援的版本
尋找任何工作項目類型、Work Item Type=[Any]或任何狀態。 State=[Any]
所有版本
尋找工作位置 Identity field=logged in user。
所有版本
尋找工作位置 Date-Time field=today。
所有版本
尋找在一或多個項目中定義的工作。
所有版本
尋找小組目前反覆運算中定義的工作。
所有版本
尋找小組目前反覆專案的 +/- n 中定義的工作。
所有版本
尋找目前登入使用者的工作，如下 ID In @Follows： 。
所有版本
尋找最近變更的工作專案、 ID In @MyRecentActivity 另請參閱 檢視和新增工作專案、工作項目頁面。
所有版本
尋找選取的日期時間欄位在目前日期、月份、周或年份內，加上加減位移的工作，例如： Closed Date>=@StartOfDay-7。
所有版本
尋找指派給指定小組的區域路徑或反覆項目路徑的工作，例如，請參閱 依區域或反覆專案路徑查詢。
所有版本
查詢結果和查詢管理功能
下列功能支援使用查詢結果、儲存和共用查詢等等。
-
匯入/匯出查詢 （csv）
-
匯入/匯出查詢 （.wiq）
-
開啟並執行查詢
-
發佈/重新整理查詢 （Excel）
-
執行 REST API 查詢
-
複製和儲存查詢
-
設定查詢許可權
不支援的功能
查詢僅支援工作專案以及與其他工作專案連結的項目。 管理查詢不支援：
- Test Plans、測試套件和測試案例的層次視圖（這些項目不使用父子連結）。 相反地，請透過 [測試 > 測試計劃] 頁面檢視階層。
- 顯示連結物件的檢視，例如組建、發行、程式碼或其他非工作項目物件。
- 列出從一個專案連結至另一個專案的工作項目。
- 將跨專案查詢匯出至 Excel （直接連結查詢匯出為一般清單）。
查詢類型（一般、直接連結、樹狀結構）
Azure Boards 支援三種查詢類型;查詢旁邊的圖示會指出其類型。 根據您需要的結果選擇類型。
查詢類型
使用指引
工作專案的一般清單
- 列出要執行大量更新的項目
- 分級工作項目清單
- 建立查詢圖表並將它新增至儀錶板
- 建立圖表來計算項目或對數值欄位進行求和
- 將清單匯出至 Excel 以更新欄位
工作專案和直接連結
- 列出相依於其他工作專案的專案
- 尋找相關或相依項目
- 列出連結的工作項目以進行批量更新
- 歸類關聯的工作項目，包括測試相關的連結
- 尋找孤立的待辦專案 （沒有父項的專案）
注意
工作專案和直接鏈接 查詢會以一般清單的形式導出至 Excel。 Excel 會將它們匯入為一般清單，因為 Excel 不支援修改多個連結類型。
工作專案的樹狀結構
- 列出父子關係的相關工作專案或其他樹狀拓撲連結類型的專案樹狀結構。
- 排序工作項目的階層式清單
- 將階層式清單匯出至 Excel 以更新欄位或修改階層
若要深入了解連結類型，請參閱 連結類型參考。
我的查詢、共用查詢和我的最愛
只有您可以檢視和執行儲存在 「我的查詢」下的查詢。 將查詢收藏，使其出現在查詢選取器中。
儲存在 「共用查詢」 下的查詢對具有專案存取權的每個人都可見。 在資料夾中組織共享查詢並收藏它們以便快速存取。 您可以設定資料夾和查詢的權限，以防止其他人移動或編輯它們。
如需詳細資訊，請參閱
- 管理查詢和查詢資料夾
- 設定查詢許可權
- 將查詢 設為我的最愛，並 設定個人或小組我的最愛
查詢目錄、查詢資料夾和階層連結
「 查詢」 頁面提供「我的最愛」和「全部」標籤。 每個索引標籤都會顯示一個目錄檢視，您可以篩選以尋找特定查詢。
當您瀏覽 [查詢] 頁面時，您可以開啟資料夾、子資料夾或查詢頁面。
當您進行選取時，階層連結會出現在頁面頂端。 使用它們來導覽至資料夾、子資料夾或查詢頁面。
您也可以從已開啟的查詢下拉功能表中選取喜愛的查詢，或返回 [所有 查詢] 頁面。
如需詳細資訊，請參閱 查詢常見問題、瀏覽和資料夾。
查詢圖表和小工具
從一般清單查詢建立圓餅圖、長條圖、樞紐分析表和趨勢圖（查詢結果必須是 1000 個或更少的工作項目）。 將查詢圖表新增至儀表板、重新命名，並視需要重新設定。
查詢型小工具會在儀表板上顯示查詢資訊（例如，目前作用中的 Bug 數目或工作專案的互動式清單）。 若要深入了解，請參閱：
新增自訂欄位以支持查詢
若要新增查詢的自訂欄位，請參閱 自訂您的工作追蹤體驗。
Taskboard 與查詢清單專案
如果工作面板內容與已建立查詢的結果不同，請參閱 工作面板專案與查詢清單專案對照 以取得詳細資訊。
全文搜索查詢和定序設定
如果您搭配 Contains 或 Contains Words 運算子使用全文搜索查詢，請確定 SQL Server 定序對應到具有已註冊斷詞器的語言。 不支援的語言可能會產生非預期的結果。
如需詳細資訊，請參閱
REST API
若要以程式設計方式與查詢互動，請參閱下列其中一個 REST API 資源：