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

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

Visual Studio 2019 |Visual Studio 2022

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

必要條件

• 您必須擁有 項目關係人 存取權，才能檢視及執行共用查詢。 根據預設，所有項目成員都有項目關係人存取權。 如需詳細資訊，請參閱 變更共用查詢或資料夾的許可權。
• 您必須具有 基本 存取權或更高許可權，才能新增和儲存共享查詢。
• 您必須將 [參與] 許可權設定為 [允許]，才能將您要新增查詢的資料夾設定為 [允許 ]。 根據預設， 參與者 群組 沒有 此許可權。

注意

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

開啟查詢

瀏覽器

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

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

提示

您或您的小組已選擇作為我的最愛的查詢顯示在 [ 我的最愛 ] 頁面上。 [我的最愛] 查詢和其他物件也會出現在您的 [專案 ] 頁面上。 如需詳細資訊，請參閱 設定個人或小組我的最愛。

Visual Studio

重要

強烈建議每個人都使用 默認檢視，而不是此舊版檢視 。 其設計目的是要根據您的工作分派、後續、提及或最近的更新，快速存取工作項目清單。 舊版檢視已不再增強，我們預期會在未來的Visual Studio版本中將其移除。

1. 從 [Team Explorer] 首頁，選擇 [ 工作專案]。

   

2. 若要開啟查詢，請開啟查詢的操作功能表（以滑鼠右鍵單擊），然後選擇 [ 檢視結果]。 或者，按兩下查詢以開啟它。

   

或者，選取下列其中一個選項：

• 編輯查詢：開啟所選查詢的 查詢編輯器。
• 新增查詢：使用預設的新查詢選項開啟 查詢編輯器。
• 在 Microsoft Excel 中開啟 （Flat）： 在 Microsoft Excel 中開啟查詢。
• 傳送至 Microsoft Outlook： 開啟
• 剪下：剪下查詢。 然後，您可以將查詢貼到不同的資料夾下。
• 複製：複製查詢。 然後，您可以將查詢貼到相同的資料夾或不同的資料夾下。
• 刪除： 刪除查詢。
• 重新命名： 可讓您重新命名查詢。
• 新增至我的最愛： 將查詢新增至 [我的最愛] 區段。
• 新增至 Team Favorites： 將查詢新增至 Team Favorites 區段。
• 安全性： 開啟查詢的許可權對話框。

在 Azure Boards 中執行查詢

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

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

瀏覽器

提示

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

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

   

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

   • 若要檢視指派給您的所有工作專案，請選擇 [指派給我]。 此查詢會 使用 @Me 宏來列出指派給您的所有工作專案。
   • 若要檢視您追蹤的所有工作專案，請選擇 [追蹤的工作專案]。 此查詢會 使用 @Follows 宏 （ID 在 中 @Follows) 列出您選擇追蹤的所有工作專案。 如需詳細資訊，請參閱 遵循工作專案或提取要求。

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

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

   

Visual Studio

重要

強烈建議每個人都使用 默認檢視，而不是此舊版檢視 。 其設計目的是要根據您的工作分派、後續、提及或最近的更新，快速存取工作項目清單。 舊版檢視已不再增強，我們預期會在未來的Visual Studio版本中將其移除。

• 從 [Team Explorer 工作專案] 頁面，開啟查詢的操作功能表（以滑鼠右鍵按兩下），然後選擇 [ 檢視結果]。 或者，按兩下查詢以開啟它。

  

從命令行執行查詢

您可以使用 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 

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

注意

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

瀏覽器

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

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

Visual Studio

[ 工作專案 ] 頁面會顯示與入口網站中所定義相同的資料夾結構。 透過 Visual Studio 所做的變更會反映在入口網站中。

您可以展開和折疊資料夾、重新命名資料夾，以及將查詢從某個資料夾拖放到另一個資料夾。 如需詳細資訊，請參閱 管理和組織查詢

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

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

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

Task	我的最愛 （瀏覽器）	全部 （瀏覽器）	工作項目 （Team Explorer）
檢視您所屬的所有最愛查詢、您的或小組	✔️		✔️
檢視目前專案的所有查詢或共享查詢		✔️	✔️
執行查詢，開啟查詢的操作功能表	✔️	✔️	✔️
展開或折疊容器資料夾或查詢資料夾	✔️	✔️	✔️
篩選查詢清單	✔️	✔️
我的最愛查詢 （針對入口網站，選擇 ）		✔️
取消查詢 （針對入口網站，選擇 ）	✔️	✔️	✔️
新增查詢：選擇	✔️	✔️	✔️

篩選查詢清單

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

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

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

瀏覽器

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

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

您只能傳送電子郵件給系統所辨識之項目成員的個別位址。 不支援將小組群組或安全組新增至該行。 如果您新增系統無法辨識的電子郵件帳戶，您會收到一或多個電子郵件收件者沒有許可權讀取郵件工作項目的郵件。

注意

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

Visual Studio

您可以從操作功能表選擇 [傳送至 Microsoft Outlook ] 選項，以傳送格式化的查詢清單。

注意

此功能需要您安裝 Microsoft Outlook。 針對內部部署 Azure DevOps，所有電子郵件動作都需要 設定 SMTP 伺服器。 如果您沒有設定 SMTP 伺服器，您可以從入口網站使用 複製為 HTML 來解決此問題。

下一步

定義查詢

相關文章

• 管理查詢和查詢資料夾
• 以互動方式篩選待辦專案、面板、查詢和計劃
• 變更數據行選項
• 設定個人或小組我的最愛
• 鍵盤快速鍵