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

Azure DevOps Services |Azure DevOps Server 2020 |Azure DevOps Server 2019 |TFS 2018

Visual Studio 2022 |Visual Studio 2019 |Visual Studio 2017 |Visual Studio 2015 |Visual Studio 2013

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

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

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

Query Editor, web browser.

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

在本文中,您將了解:

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

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

選取查詢篩選

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

注意

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


篩選功能

巨集



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

必要條件

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

注意

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

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

開啟查詢

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

Open Boards>Queries, vertical nav

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

提示

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

從網頁瀏覽器開啟Boards > Queries

From your web browser, open Boards>Queries

定義一般清單查詢

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

Screenshot to Add new query, new experience.

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

Screenshot of Query Editor with flat list of work items selected.

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

Screenshot to Queries page, Choose New query from the drop down menu.

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

Screenshot of Query Editor with flat list of work items selected, TFS 2018 and earlier versions.

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

跨專案或專案內查詢

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

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

Screenshot of Query Editor with Query across projects checked.

核取 [跨專案查詢],您可以新增[小組Project] 欄位,以篩選為選取的專案數目。

Screenshot of Query Editor with Team Project and other fields added to filter.

注意

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

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

定義 子句

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

範例查詢子句

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

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

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

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

Screenshot of Query Editor showing how to add a clause.

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

提示

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

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

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

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

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

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

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

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

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

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

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

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

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

注意

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

Screenshot of Query Results List showing a Tree Query.

Screenshot of Query Results List showing a Tree Query, TFS 2018 view.

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

Screenshot of Query Editor view of Tree of work items.

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

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

Screenshot of Direct Links Query Results.

Screenshot of Query Editor, Direct Links Query.

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

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

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

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

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

And/Or 邏輯運算式

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

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

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

Group 子句

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

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

提示

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

查詢 群組子句 邏輯運算式
1 Screenshot showing a group clause query. Filters are set up for the Work item type field and either the State field or the Assigned to field. Screenshot of a logical expression. An AND operator groups the Work item type, State, and Assigned to fields. An OR operator groups the State and Assigned to fields.
2 Screenshot showing a group clause query, with filters for both the Work item type field and one of either the State field or the Assigned to field. Screenshot of a logical expression. An AND operator groups the Work item type with the State or Assigned to fields, which are grouped by an OR operator.
3 Screenshot showing a group clause query. Filters are set up for either the Work item type field or both the State field and the Assigned to field. Screenshot of a logical expression. An OR operator links the Work item type to both the State and the Assigned to fields, which are linked by an AND operator.

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

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

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

Screenshot of Web portal, Query Editor, Group Selected Query Clauses.

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

Screenshot of Web portal, Query Editor, Group multiple query clauses.

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

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

取消群組子句

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

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