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

  • 發行項

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

若要尋找指派給您或小組的工作專案，請執行查詢。 許多工作專案查詢都是使用您的程式預先定義的。 小組成員可能已建立共用查詢，您可以檢視和執行。 通常，藉由建置已可供您使用的查詢定義，即可更輕鬆地定義新的查詢。

必要條件

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

注意

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

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

開啟查詢

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

Open Boards>Queries, vertical nav

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

提示

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

從網頁瀏覽器開啟Boards > Queries。

From your web browser, open Boards>Queries

在 Azure Boards 中執行查詢

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

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

提示

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

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

    Web portal, choose Boards>Queries>All page

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

    • 若要檢視指派給您的所有工作專案，請選擇 [指派給我]。 此查詢會使用 @Me 宏來列出指派給您的所有工作專案。
    • 若要檢視您追蹤的所有工作專案，請選擇 [追蹤的工作專案]。 此查詢會使用 中的 @Follows)@Follows宏 (識別碼，列出您選擇遵循的所有工作專案。 若要深入瞭解，請參閱 遵循工作專案或提取要求。

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

  4. 選擇階層連結內的資料夾以開啟查詢資料夾。

    Screenshot of queries breadcrumb example.

從命令列執行查詢

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

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

參數

  • id：常設查詢的識別碼。 除非指定路徑或--wiql，否則為必要專案。
  • wiql：工作專案查詢語言格式的查詢。 指定 if--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

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

查詢資料夾

注意

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

[查詢] 頁面包含目錄焦點檢視，您可以篩選以尋找感興趣的特定查詢。 在 [查詢] 頁面中工作時，您可以流覽至子資料夾、資料夾或頁面。

Queries breadcrumbs

此外，您也可以從選取器功能表選擇您最愛的查詢，或者，您可以選擇流覽所有查詢，這會傳回 [ 所有查詢 ] 頁面。

Screenshot of Queries, Query selector.

[ 查詢 ] 頁面會在左窗格中顯示資料夾結構。 您可以展開和折迭資料夾、重新命名資料夾，以及將查詢從一個資料夾拖放到另一個資料夾。 若要深入瞭解，請參閱 管理和組織查詢。

Screenshot of Queries page, TFS 2018 and earlier versions.

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

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

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


Task		 我的最愛
(Browser) 		全部
(Browser) 		工作項目
(Team Explorer)
檢視您所屬的所有我的最愛查詢、您的或小組 ✔️ ✔️
檢視目前專案的所有查詢或共用查詢 ✔️ ✔️
執行查詢，開啟查詢的操作功能表 ✔️ ✔️ ✔️
展開或折迭容器檔案夾或查詢資料夾 ✔️ ✔️ ✔️
篩選查詢清單 ✔️ ✔️
將入口網站的查詢 (加入我的最愛，請選擇 Favorite [) ✔️
為入口網站取消偏好查詢 (，請選擇 [) ✔️ ✔️ ✔️
新增查詢：選擇 ✔️ ✔️ ✔️

篩選查詢清單

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

Screenshot showing all queries in the project filtered by WIT IQ keyword criteria.

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

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

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

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

Web portal, Query Editor/Results, Open Actions menu, Choose Email query or Copy query URL
您只能傳送電子郵件給系統所辨識之專案成員的個別位址。 不支援將小組群組或安全性群組新增至該行。 如果您新增系統無法辨識的電子郵件帳戶，您會收到一則訊息，指出電子郵件的一或多個收件者沒有讀取郵件工作專案的許可權。

注意

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

選擇 [複製查詢 URL]。 若要傳送電子郵件查詢專案，請參閱 複製工作專案清單。

Web portal, Query Editor/Results, Copy query URL

注意

使用 電子郵件查詢，系統會將格式化清單傳送給您選取的小組成員。 若要以電子郵件將格式化清單傳送給不屬於專案的人員，您必須使用複製工作專案清單中所述的[複製為 HTML] 選項。 所有電子郵件動作都需要 設定 SMTP 伺服器。 如果您沒有設定 SMTP 伺服器，您可以使用 複製為 HTML來解決此問題。

接下來嘗試這個

定義查詢