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

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

Visual Studio 2019 |Visual Studio 2022

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

必要條件

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

注意

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

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

開啟查詢

瀏覽器

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

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

提示

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

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

Visual Studio

注意

若要在 Visual Studio 2019 中開啟、檢視和執行查詢，您必須將 [工作專案] 體驗設定 為舊版選項。

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

   

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

   

或是選取下列其中一個選項：

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

在 Azure Boards 中執行查詢

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

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

瀏覽器

提示

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

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

   

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

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

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

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

   

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

篩選查詢清單

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

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

Email查詢專案或共用查詢 URL

瀏覽器

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

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

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

注意

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

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

注意

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

Visual Studio

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

注意

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

接下來嘗試這個

定義查詢

相關文章

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