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

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

Visual Studio 2019 |Visual Studio 2022

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

必要條件

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

注意

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

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

開啟查詢

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

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

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

提示

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

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

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

在 Azure Boards 中執行查詢

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

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

提示

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

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

    入口網站,選擇 [面板 > 查詢 > 全部] 頁面

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

    • 若要檢視指派給您的所有工作專案,請選擇 [指派給我]。 此查詢會使用 @Me 宏來列出指派給您的所有工作專案。
    • 若要檢視您追蹤的所有工作專案,請選擇 [追蹤的工作專案]。 此查詢會使用 中的 @Follows)@Follows宏 (識別碼來列出您選擇遵循的所有工作專案。 若要深入瞭解,請參閱 遵循工作專案或提取要求
  3. 選擇 [共用查詢 ] 以展開資料夾,並存取儲存為共用查詢的查詢。

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

    查詢階層連結範例的螢幕擷取畫面。

從命令列執行查詢

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

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

參數

  • id:常設查詢的識別碼。 除非指定 --path 或--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 

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

查詢資料夾

注意

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

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

查詢階層連結

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

查詢、查詢選取器的螢幕擷取畫面。

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

查詢頁面、TFS 2018 和舊版的螢幕擷取畫面。

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

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

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


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

篩選查詢清單

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

顯示依 WIT IQ 關鍵字準則篩選之專案中所有查詢的螢幕擷取畫面。

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

Email查詢專案或共用查詢 URL

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

選擇 動作圖示以開啟功能表,然後從列出的選項中選取,Email查詢複製查詢 URL

入口網站、查詢編輯器/結果、開啟動作功能表、選擇Email查詢或複製查詢 URL
您只能傳送電子郵件給系統所辨識之專案成員的個別位址。 不支援將小組群組或安全性群組新增至 行。 如果您新增系統無法辨識的電子郵件帳戶,您會收到一則郵件,指出電子郵件的一或多個收件者沒有讀取郵件工作專案的許可權。

注意

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

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

入口網站、查詢編輯器/結果、複製查詢 URL

注意

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

接下來嘗試這個