查詢工作項目

  • 發行項

請使用搜尋方塊來尋找工作項目。 輸入 ID 或使用篩選條件。 如果需要工作項目的一般清單、使用樹狀查詢的階層式清單或使用直接連結查詢顯示相依性的清單，請使用查詢編輯器來選擇查詢類型。

您可以在 Visual Studio Online、Team Web Access (TWA) 和 Team Explorer 中建立查詢。 此外，也可以在 Excel 或 Project 中開啟查詢以執行大量修改。

使用搜尋方塊，依據識別碼尋找工作項目。

在 [搜尋工作項目] 方塊中輸入識別碼，然後選擇搜尋圖示。

[搜尋工作項目] 文字方塊

您可以使用 內容功能表項目圖示 內容功能表加入篩選條件，根據指派、狀態、關鍵字或工作項目類型來列出項目。

例如，輸入 A=@Me T=Task 以列出指派給您的所有工作。

開啟和編輯一般清單查詢

定義查詢的最簡單的方法是從現有的共用查詢開始進行。 下列範例示範如何修改隨附於 Agile 流程範本的 [待處理的 Bug] 共用查詢，以尋找所有已關閉的 Bug。 範例是根據透過網頁瀏覽器提供的使用者介面。

  1. 開啟共用查詢。 例如，開啟 [待處理的 Bug] 或類似的一般清單查詢。

    開啟共用查詢，例如待處理的 Bug

       

  2. 編輯查詢以尋找已關閉的 Bug，然後執行查詢。 使用 加入附件 (插入新篩選行)，在目前子句上方插入子句。 使用 刪除子句 (移除篩選行) 刪除子句。

    一般清單查詢的 [編輯器] 檢視

       

  3. 將查詢儲存到 [我的查詢] 資料夾。

    另存查詢為、資料夾=我的查詢

       

    若要將查詢儲存到 [共用的查詢] 資料夾，您必須是小組系統管理員、Project Administrators 群組的成員，或已將資料夾的 [參與] 權限設為允許。

建立查詢

在 Team Explorer 中，從 TWA 的查詢頁面或工作項目頁面的 [新增] 功能表開始。

開啟新查詢

群組子句以精簡清單

已群組的子句會當做與查詢其餘部分區隔的單一單元來運作，這種方式就類似在數學方程式或邏輯運算式周圍放置括號。 群組中第一個子句的 [及] 或 [或] 運算子會套用至整個群組。

在下一個範例中，第一個運算式會傳回優先權 1 的所有工作項目以及任何優先權的所有待處理 Bug。 第二個運算式會傳回所有作用中的優先權 1 工作項目以及所有優先權 1 Bug，不論它們是否待處理。

群組子句

邏輯運算式
使用 or/and 邏輯運算式來篩選

Priority=1 OR (Work Item Type=Bug AND State=Active)
使用 and/or 邏輯運算式來篩選

Priority=1 AND (Work Item Type=Bug OR State=Active)

若要群組一個或多個子句，請選取子句並選擇 群組查詢子句 群組子句圖示。

群組選取的查詢子句

如果查詢結果未傳回您預期的一組工作項目，請執行下列步驟：

  • 確定每個子句都是依您想要的方式定義。

  • 驗證每個子句的 [及/或] 指派。 如果結果包含的工作項目數目超出預期，則通常表示存在 [或] 子句，而不是 [及] 子句。

  • 判斷是否需要分組或變更查詢子句的群組以及每個群組子句的 [及/或] 指派。

  • 加入更多查詢子句來精簡查詢篩選準則。

  • 檢閱可用於指定欄位、運算子和值的選項。

使用樹狀查詢以檢視階層式清單

使用樹狀查詢 (樹狀查詢) 檢視工作項目的多層式巢狀清單。 例如，您可以檢視所有待處理項目及其連結的工作。

顯示樹狀查詢的 [結果] 清單

展開 (展開節點 (Team Web Access)) 或摺疊 (摺疊節點 (Team Web Access)) 摺疊分葉節點，以便專注於樹狀結構的不同部分。

定義父工作項目和子工作項目的篩選準則。

樹狀查詢篩選條件

若要尋找連結的子系，請選取 [先比對最上層工作項目]。 若要尋找連結的父代，請選取 [先比對連結工作項目]。

使用直接連結查詢以檢視相依性

使用直接連結查詢 (直接連結查詢) 追蹤相依於其他追蹤工作的工作項目，例如工作、Bug、問題或功能。 例如，您可以檢視相依於其他要實作項目或要修正 Bug 的待處理項目。

直接連結查詢結果

使用直接連結查詢來追蹤小組所擁有、其他小組所處理的相依性，或管理小組對其他小組所做的認可。 指定最上層及連結工作項目的篩選準則，然後選取用來篩選相依性的連結類型。

直接連結查詢編輯器

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

  • 僅傳回具有指定之連結的工作項目：傳回第一層工作項目，但前提是這些工作項目已連結至連結工作項目篩選準則所指定的工作項目。

  • 傳回所有最上層工作項目：不論連結工作項目的篩選準則為何，都會傳回所有第一層工作項目。 如果連結至第一層的第二層工作項目符合連結工作項目篩選準則，就會回傳這些工作項目。

  • 僅傳回沒有指定之連結的工作項目：傳回第一層工作項目，但前提是這些工作項目未連結至連結工作項目篩選準則所指定的工作項目。

問與答

問：我可以使用哪些查詢運算子和變數？

答：可供選擇的運算子和變數取決於您選取的欄位。 有四個變數，分別為專案名稱欄位 [@Project]、人員名稱欄位 [@Me]、日期時間欄位 [@Today] 以及 [任何]。 請參閱 查詢欄位、運算子、值和變數。

問：還有哪些其他查詢範例？

**答：**請參閱範例工作項目查詢和範例搜尋方塊查詢。

問：如何製作查詢結果的圖表？

**答：**您可以從 Visual Studio Online 和 TWA 繪製任何一般清單查詢結果的圖表。 您必須是 TWA 的進階存取群組成員。

或者，也可以開啟 Excel 中的查詢並使用 Excel 功能產生圖形。

問：如何根據目前衝刺或反覆項目自動更新查詢？

**答：**未提供自動的方式執行此動作，您必須手動更新查詢，使其指向目前衝刺。 如果您的 Team 專案是以 Scrum 或 Agile 為基礎，您會在 [目前衝刺] 或 [目前反覆項目] 資料夾下看到一組查詢。 若要讓每一個查詢傳回目前衝刺中定義的項目，您必須根據日期將反覆項目路徑更新為目前的反覆項目。

您可以將其儲存為 .wiq 檔案，以變更您的許多查詢。 開啟 Team Explorer 的查詢，選擇 [編輯查詢]，然後選擇 [檔案、另存新檔]，將每一個查詢儲存為 .wiq 檔案。 以下為已更新為支援「發行 2\衝刺 59」的進行中查詢範例。

<?xml version="1.0" encoding="utf-8"?>
<WorkItemQuery Version="1">
  <Wiql>
    SELECT [System.Id],
           [System.WorkItemType],
           [System.Title],
           [System.AssignedTo],
           [System.State],
           [Microsoft.VSTS.Scheduling.RemainingWork],
    FROM WorkItems 
      WHERE [System.TeamProject] = @project and 
            [System.IterationPath] under 'FabrikamPrime\Release 2\Sprint 59' and 
            [System.WorkItemType] in group 'Microsoft.TaskCategory' and 
            [System.State] = 'In Progress' 
      ORDER BY [System.AssignedTo],
               [Microsoft.VSTS.Common.BacklogPriority],
               [System.Id] 
   </Wiql>
</WorkItemQuery>

問：如何加入或變更結果清單中的資料行？

**答：**開啟 [資料行選項] 加入或移除資料行、變更資料行順序，以及變更資料行內的排序次序。

[資料行選項] 對話方塊中的 [顯示資料行] 索引標籤

此外，也可以在結果清單中，將資料行拖曳至新位置，並選取資料行標題以變更依據資料行的排序次序。

問：我可以使用標記來篩選查詢嗎？

**答：**如果您使用 Visual Studio Online，或是內部部署 TFS 含有透過 TFS 2013 Update 2 而加入的更新，則答案為可以，否則內部部署不適用。

若是 Visual Studio Online 且具有 Visual Studio 2013 Update 2，您可以選擇 [標記] 做為要篩選的欄位。 此外，您也可以從 Excel 開啟查詢，並大量修改指派給工作項目的標記。 您也可以使用 Visual Studio 將標記加入至工作項目。

您可以透過 Team Foundation Server Plug-in for Eclipse，依標記篩選查詢，不過，您無法從使用者介面加入或修改標記。 您必須使用入口網站來加入和修改標記。

若是沒有 TFS 2013 Update 2 的內部部署 TFS，您可以將標記顯示為查詢結果中的資料行，而且可以依據標記篩選清單，但是您無法將標記當做子句加入至篩選準則。

問：我可以使用查詢結果快速修改連結關聯性嗎？

**答：**您可以透過 Team Explorer plug-in for Visual Studio，縮排 (Indent)、凸排 (凸排)，以及拖曳工作項目來修改階層架構。

此外，也可以在 Excel 或 Project 中開啟查詢，大量修改父子式連結和前置任務/後續任務連結關聯性。

問：如何防止某人變更我與小組共用的查詢？

答：將查詢的權限設定為讀取。

問：如何將查詢加入至 [共用的查詢] 或做為 [小組的最愛]？

**答：**若要將查詢儲存至 [共用的查詢] 資料夾，請加入成為 Project Administrators 群組的成員，或是將您的權限設定給 [共用的查詢] 之下的資料夾.。

若要加入查詢做為小組的最愛，請開啟查詢的 內容功能表項目圖示 內容功能表，然後將查詢加入做為小組的最愛。 您必須是小組系統管理員，才能將查詢加入至 [小組的最愛]。

只能將共用的查詢加入至 [小組的最愛]，而且僅當您擁有小組系統管理員權限時才能這樣做。

問：我可以將資料夾加入至小組的最愛嗎？

答：不需要。 您只能加入 [我的查詢] 下方和 [共用的查詢] 下方的資料夾。

問：我可以透過電子郵件傳送查詢嗎？

**答：**可以。 請參閱 TFS 工作項目和查詢的電子郵件 URL 連結。

問：我可以定義開啟查詢的超連結嗎？

**答：**可以。 定義超連結最簡單的方法是，建立符合您想要項目的查詢，然後複製查詢的 URL。 超連結使用工作項目查詢語言 (WIQL) (類似 Transact-SQL)，且符合這個語法：

**http://ServerName:**Port/ /tfs/CollectionName/TeamProjectName/**q.aspx?pname=Project&wiql=**WorkItemQueryLanguage

例如，下列超連結會列出 AdventureWorksProject 專案中組建編號定義為 9.0.30304 之所有 Bug 的 ID、標題和狀態。

http://AdventureWorks:8080/tfs/ /q.aspx?pname=AdventureWorksProject&wiql==SELECT [System.ID], [System.Title], [System.State] FROM WorkItems WHERE [System.TeamProject]='AdventureWorksProject' AND [System.WorkItemType]='Bug' AND [System.FoundIn]='9.0.30304' http://Server1:8091/tfs/web/wi.aspx?id=9035

問：我可以匯出查詢嗎？

**答：**可以。 從 Team Explorer 的查詢編輯器中，使用 [檔案] 功能表將查詢儲存為 .wiq 檔案。 當您建立 Team 專案時，共用查詢是根據在流程範本中定義的 .wiq 檔案建立。

問：工作面板的內容為什麼與使用其建立的查詢所列的內容不同？

**答：**您可以將工作指派給反覆項目，但無法將它們連結至父待處理項目。 這些項目將會顯示在已建立的查詢中，但是不會顯示在工作面板本身。 TFS 會先執行查詢，然後套用一些背景流程，再顯示工作面板項目。

這三個原因會導致屬於工作分類的工作項目不會出現在衝刺待處理項目或工作面板上：

  • 工作尚未連結至父待處理項目。 只有已連結至反覆項目路徑設定為衝刺之父產品待處理項目 (Scrum)、使用者劇本 (Agile) 或需求 (CMMI) 的 Bug 和工作，才會顯示在衝刺待處理項目頁面上。

  • 該工作是其他工作的父項。 如果您已建立工作階層，則只會出現階層底部的子層級工作。

  • 工作的連結父項對應至為其他小組定義的待處理項目。 或者，工作的父待處理項目區域路徑不同於工作的區域路徑。

問：我可以程式設計方式查詢工作項目嗎？我可以建立動態查詢嗎？

**答：**可以。 請參閱 查詢 Bug、工作和其他工作項目。

請參閱

概念

選擇 Team Foundation 用戶端以支援您的工作