在 Azure Boards 中定義工作專案查詢

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

Visual Studio 2019 |Visual Studio 2022

工作專案查詢會根據您提供的篩選準則產生工作專案清單。 然後,您可以儲存這些受控查詢並與其他人員共用。 相反地,語意搜尋會列出工作專案,但無法儲存或共用。

從入口網站或支援的用戶端建立查詢,例如 Visual Studio Team Explorer。 您也可以使用 WIQL 語法和 .wiq 檔案來定義和匯入工作專案查詢。 若要支援大量更新或新增,請使用 Excel.csv檔案匯入或匯出查詢。

從入口網站或支援的用戶端建立查詢,例如 Visual Studio Team Explorer。 您也可以使用 WIQL 語法和 .wiq 檔案來定義和匯入工作專案查詢。 若要支援大量更新或新增,請使用 Excel匯入或匯出查詢。

查詢編輯器網頁瀏覽器。

如果您發現查詢需要太長的時間才能傳回結果,請檢閱 指導方針以建立高效能的查詢

在本文中,您將了解:

  • 如何新增或建立查詢
  • 如何跨專案查詢
  • 如何分組和取消群組查詢子句
  • 如何建立工作專案的樹狀結構或直接連結查詢

如需快速存取所有查詢工作、支援的運算子,例如、 ContainsIn 、、 In Group<> (不是運算子) ,請參閱 查詢快速參考

選取查詢篩選

從查詢編輯器,練習下列篩選函式。 選擇篩選準則,以跳至具有範例查詢的文章。 除了查詢篩選之外,您也可以 以互動方式將篩選套用至查詢結果

注意

受控查詢不支援鄰近搜尋,不過語意搜尋則支援。 此外,語意搜尋同時支援 *? 做為萬用字元,而且您可以使用多個萬用字元來比對多個字元。 若要深入瞭解,請參閱 功能工作專案搜尋


篩選功能

巨集



除了您從查詢編輯器使用的篩選之外,您也可以使用 Filter函式以互動方式篩選查詢結果。 若要深入瞭解,請參閱 以互動方式篩選待辦專案、面板、查詢和計畫

必要條件

  • 根據預設,具有 專案關係 人存取權的所有專案成員和使用者都可以檢視和執行所有共用查詢。 您可以變更共用查詢資料夾或共用查詢的許可權集合。 如需詳細資訊,請參閱 設定查詢許可權
  • 若要在 共用查詢下新增和儲存查詢,您必須獲得 基本 存取權或更高許可權。 此外,您必須將 [參與] 許可權設定為 [允許 ] 以加入查詢的資料夾。 根據預設, 參與者 群組沒有此許可權。

注意

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

  • 根據預設,具有 專案關係 人存取權的所有專案成員和使用者都可以檢視和執行所有共用查詢。 您可以變更共用查詢資料夾或共用查詢的許可權集合。 如需詳細資訊,請參閱 設定查詢許可權
  • 若要在 共用查詢下新增和儲存查詢,您必須獲得 基本 存取權或更高許可權。 此外,您必須將 [參與] 許可權設定為 [允許 ] 以加入查詢的資料夾。 根據預設, 參與者 群組沒有此許可權。

開啟查詢

從網頁瀏覽器中, (1) 確認您已選取正確的專案, (2) 選擇 [ 面板 > 查詢],然後 (3) 選擇 [ 全部]。

開啟面板 > 查詢,垂直導覽

如果這是您第一次開啟 查詢,頁面會開啟至 [我的最愛]。 此頁面列出您指出的查詢是我的最愛。 否則,您可以選擇 [全部 ] 來檢視您已定義的所有查詢,以及為專案定義的共用查詢。

提示

您或小組選擇作為我的最愛的查詢會顯示在 [ 我的最愛 ] 頁面上。 [我的最愛] 查詢和其他物件也會出現在 您的 [專案] 頁面上。 若要深入瞭解,請參閱 設定個人或小組我的最愛

從網頁瀏覽器開啟 Boards > 查詢

從網頁瀏覽器開啟 Boards > 查詢

定義一般清單查詢

您可以從入口網站中的 [ 查詢 ] 索引標籤或 Team Explorer 中的 [ 工作專案 ] 索引標籤,啟動全新的新查詢。

新增查詢、新體驗的螢幕擷取畫面。

查詢編輯器會顯示下列預設設定:工作專案的一般清單工作專案類型=[Any]State=[Any]。

查詢編輯器螢幕擷取畫面,其中已選取一般工作專案清單。

您可以修改 Values新增或移除子句。 或者,將 查詢類型 變更為 [工作專案],並將連結或導向工作專案的樹狀結構

[查詢] 頁面的螢幕擷取畫面,從下拉式功能表中選擇 [新增查詢]。

查詢編輯器會顯示下列預設設定:一般工作專案清單Team Project=@Project (目前專案) 、工作專案類型=[Any],以及State=[Any]

查詢編輯器螢幕擷取畫面,其中已選取一般工作專案清單,TFS 2018 和舊版。

您可以修改 Values新增或移除子句。 或者,將 查詢類型 變更為 [工作專案],並將連結或導向工作專案的樹狀結構

跨專案或專案內查詢

預設會將新的查詢範圍限定為目前專案。 不過,您可以建立查詢來尋找組織或專案集合中定義的工作專案。 不過,您儲存的所有查詢都會儲存在特定專案下。

若要列出兩個或多個專案中定義的工作專案,請勾選 [ 跨專案查詢]。 例如,下列查詢會尋找過去 30 天內所有專案中建立的所有功能。

已核取 [跨專案查詢] 的查詢編輯器螢幕擷取畫面。

核取 [ 跨專案查詢 ] 之後,您可以新增 [Team 專案 ] 欄位來篩選至選取的專案數目。

查詢編輯器的螢幕擷取畫面,其中已新增 Team Project 和其他欄位來篩選。

注意

將多個專案名稱與對應至用戶端電腦所定義之區域設定的清單分隔符號分隔,例如逗號 (,) 。

只有在檢查[跨專案查詢]之後,才能使用[Team Project]欄位。 此外,取消核取 [跨專案查詢 ] 時,只有來自這些工作專案類型的欄位,如目前專案中定義,會出現在 [ 欄位 ] 下拉式功能表中。 核取 [ 跨專案查詢 ] 時,集合中所有專案中定義之所有工作專案類型的所有欄位都會出現在 [ 欄位 ] 下拉式功能表中。

定義 子句

您可以定義一或多個子句來建立查詢。 每個子句都會定義單一欄位的篩選準則。

範例查詢子句

及/或 欄位 運算子
指派對象 = @Me

如需根據欄位資料類型的可用運算子清單,請參閱 查詢索引快速參考

您新增的所有子句都會新增為 And 語句。 選擇 [或 ] 以變更群組。 您可以群組子句,以確保子句語句是在所需的序列中執行。

選擇 [新增子句 ] 以在查詢結尾新增另一個子句,然後選擇該子句的 [欄位]、[ 運算子] 和 [ ]。

顯示如何新增 子句的查詢編輯器螢幕擷取畫面。

例如,藉由指定 [ 指派給 ] 欄位、等於 () = 運算子,以及代表使用者身分識別的 @Me 宏,搜尋指派給您的所有工作專案。

提示

若要檢視查詢的 WIQL 語法,以及如何使用括弧來群組子句,請安裝 Marketplace Wiql 編輯器。 此延伸模組支援檢視 WIQL 語法,並將其匯出至 WIQL 檔案,以用於 REST API 呼叫。 若要深入瞭解,請參閱 工作專案查詢語言的語法 (WIQL)

如何定義查詢子句的檢查清單

  1. 在第一個空白資料列的 [欄位 ] 資料行標題下,選擇向下箭號以顯示可用欄位的清單,然後挑選清單中的專案。

    如需詳細資訊,請參閱 查詢欄位和值

  2. 在相同的資料列的 [運算子] 資料行標題下,選擇向下箭號以顯示可用的運算子清單,然後挑選清單中的專案。

    如需詳細資訊,請參閱 運算子

  3. 在相同的資料列中,于 [ ] 資料行標題下輸入值,或選擇向下箭號,然後挑選清單中的專案。

    如需如何使用宏或變數來指定目前專案、使用者、日期或其他選取範圍的詳細資訊,請參閱 變數

  4. 若要新增子句,請選擇 [新增子句]。

    您可以將 子句新增至查詢結尾,或使用對應的圖示執行下列工作:

    • 插入新的篩選行
    • 移除此篩選行
    • 群組選取的子句
    • Ungroup 子句

使用工作專案樹狀結構來檢視階層

使用工作 專案的樹狀結構查詢來檢視多層式的巢狀工作專案清單。 例如,您可以檢視所有待處理項目及其連結的工作。 若要將焦點放在樹狀結構的不同部分,請選擇 [全部展開] 或 [全部折迭]。

注意

您無法建構顯示Test Plans、測試套件和測試案例階層式檢視的查詢。 這些專案不會使用父子連結類型連結在一起。 不過,您可以建立列出測試相關工作專案的直接連結查詢。 此外,您也可以透過 [Test Plans] 頁面檢視階層

顯示樹狀結構查詢的查詢結果清單螢幕擷取畫面。

[查詢結果清單] 的螢幕擷取畫面,其中顯示樹狀結構查詢、TFS 2018 檢視。

定義父工作項目和子工作項目的篩選準則。 若要尋找連結的子系,請先選取 [比對最上層工作專案]。 若要尋找連結的父系,請先選取 [比對連結的工作專案]。

工作專案樹狀結構查詢編輯器檢視的螢幕擷取畫面。

使用[工作專案] 和[ 直接連結] 查詢來追蹤相依于其他追蹤工作的工作專案,例如工作、Bug、問題或功能。 例如,您可以檢視相依於其他要實作項目或要修正 Bug 的待辦項目。

使用直接連結查詢來追蹤跨小組的相依性。 此查詢也可協助您管理小組所做的承諾。 選擇頂端和連結工作專案的篩選準則。 然後,選取連結類型以篩選相依性。

直接連結查詢結果的螢幕擷取畫面。

查詢編輯器直接連結查詢的螢幕擷取畫面。

選擇下列其中一個選項,篩選第一層工作項目清單:

  • 僅傳回具有相符連結的專案:第一層工作專案會傳回,但只有在它們具有連結的工作專案篩選準則所指定的工作專案連結時。

  • 傳回所有最上層專案:即使連結的工作專案篩選準則,所有第一層工作專案仍會傳回。 如果第二層工作專案符合連結的工作專案篩選準則,則連結到第一層的工作專案會傳回。

  • 僅傳回沒有相符連結的專案:會傳回第一層工作專案,但只有在它們沒有連結的工作專案連結時,才會傳回連結的工作專案篩選準則。

若要深入瞭解每個連結類型,請參閱 連結、可追蹤性和管理相依性

And/Or 邏輯運算式

您可以指定 AndOr 來建立查詢子句的邏輯運算式。 指定 And 以尋找符合目前 子句和上一個子句中準則的工作專案。 指定 Or 以尋找符合目前 子句或上一個子句中準則的工作專案。

為每個工作專案欄位新增一個新子句,以精簡搜尋準則。 新增 子句,只傳回您想要的工作專案集。 如果您未收到來自查詢的結果,請加以精簡。 您可以新增、移除、群組或取消群組查詢子句,以改善查詢結果。

群組查詢子句,以與其余查詢分開的單一單位運作。 群組子句類似于將括弧放在數學方程式或邏輯語句中的運算式周圍。 當您群組子句時,群組中第一個子句的 ANDOR 會套用至整個群組。

Group 子句

群組子句會以與查詢其餘部分不同的單一單位運作。 群組子句類似于將括弧放在數學方程式或邏輯運算式周圍。 群組中第一個子句的 AndOr 運算子會套用至整個群組。

如下列範例所示,群組子句會轉譯為對應的邏輯運算式。

提示

若要檢視查詢的 WIQL 語法,請安裝 WIQL 查詢編輯器延伸模組 ,可讓您查看任何查詢 UI 專案的 WIQL 版本。 此延伸模組可讓您查看 AND/OR 群組子句的處理方式。

查詢 群組子句 邏輯運算式
1 顯示群組子句查詢的螢幕擷取畫面。[工作專案類型] 欄位和 [狀態] 欄位或 [指派給] 欄位會設定篩選。 邏輯運算式的螢幕擷取畫面。AND 運算子會將 [工作] 專案類型、[狀態] 和 [指派給] 欄位分組。OR 運算子會將 [狀態] 和 [指派給] 欄位分組。
2 顯示群組子句查詢的螢幕擷取畫面,其中包含 [工作專案類型] 欄位和其中一個 [狀態] 欄位或 [指派給] 欄位的篩選。 邏輯運算式的螢幕擷取畫面。AND 運算子會將 [工作] 專案類型與 [狀態] 或 [指派給] 欄位分組,這些欄位是由 OR 運算子分組。
3 顯示群組子句查詢的螢幕擷取畫面。篩選準則是針對 [工作專案類型] 欄位或 [狀態] 欄位和 [指派給] 欄位設定。 邏輯運算式的螢幕擷取畫面。OR 運算子會將 [工作] 專案類型連結至 [狀態] 和 [指派給] 欄位,這些欄位是由 AND 運算子連結。

這些查詢會傳回類型為 Bug 並符合下列邏輯運算式的工作專案:

  • 查詢 1AND State=Active OR Assigned to @Me
  • 查詢 2AND (State=Active OR Assigned to @Me)
  • 查詢 3OR (State=Active AND Assigned to @Me)

若要將一或多個子句分組,請加以選取,然後選擇 群組子句圖示。

入口網站、查詢編輯器、群組選取的查詢子句的螢幕擷取畫面。

您也可以將數個群組子句分組。 核取已分組之每個子句的方塊。 然後,選擇 群組子句圖示。

入口網站、查詢編輯器、群組多個查詢子句的螢幕擷取畫面。

如果您的查詢結果未傳回預期的結果,請遵循下列步驟:

  • 確定每個子句都是依您想要的方式定義。
  • 驗證每個子句的 [及/或] 指派。 如果結果包含的工作項目數目超出預期,則通常表示存在 [或] 子句,而不是 [及] 子句。
  • 判斷是否需要分組或變更查詢子句的群組以及每個群組子句的 [及/或] 指派。
  • 加入更多查詢子句來精簡查詢篩選準則。
  • 檢閱可用來指定 欄位、運算子和值的選項。

取消群組子句

若要取消群組子句,請選擇 群組子句的 ungroup 子句圖示。

在儀表板中檢視查詢結果

下列兩個小工具會顯示查詢結果。 您可以直接從這些小工具開啟工作專案。

  • 指派給我的工作:列出指派給已登入使用者的所有建議或作用中工作專案。 列出 [識別碼]、[狀態] 和 [標題] 欄位。
  • 查詢結果小工具:顯示一般、樹狀結構或直接連結查詢的結果。 您可以設定透過小工具顯示的欄位、調整資料列欄位的大小,以及展開和折迭樹狀結構及直接連結查詢。

若要深入瞭解如何將小工具新增至儀表板,請參閱 將小工具新增至儀表板

使用父標題檢視查詢結果小工具

您可以使用顯示的 標題來檢視查詢的結果。 若要這樣做,請執行下列步驟:

  1. 建立查詢,以篩選感興趣的工作專案。 查詢可以是一般清單、樹狀結構或直接連結查詢。
  2. [父 欄位] 新增為數據行。
  3. 將查詢儲存為共用查詢或 Team 我的最愛。
  4. [查詢結果] 小工具 新增至儀表板並設定查詢。 請確定 [父欄位] 已設定為顯示。

下圖說明顯示 欄位的查詢結果小工具。

顯示父資料列欄位的查詢結果小工具螢幕擷取畫面。

這就是定義查詢的基本概念。 如需查詢範例的索引,請參閱 查詢快速參考