共用方式為

將工作項目查詢加入至流程範本

  • 發行項

您可以將工作項目查詢加入至流程範本，藉以定義 Team 專案的一組初始小組分享和查詢資料夾結構。 所有小組成員都使用查詢尋找他們必須採取行動的錯誤 (bug)、工作和其他工作項目。

工作項目查詢的作用是指定用於產生工作項目清單的準則，例如待處理的 Bug 或已關閉工作的清單。 工作項目查詢檔的副檔名為 .wiq，儲存在 Microsoft Solutions Framework (MSF) 流程範本 [WorkItem Tracking] 資料夾的 [Queries] 子資料夾中。

重要

適用於 Microsoft 的流程範本會定義數個查詢。如需詳細資訊，請參閱 共用查詢 (Scrum)、共用查詢 (Agile)和共用查詢 (CMMI)。查詢定義取決於流程範本中工作項目的欄位和類型。此外，在 Portal 外掛程式中上傳的某些活頁簿視查詢定義而定。

您可以在 WorkItemTracking 外掛程式中指定查詢定義當做工作上傳。 由於流程範本中的數個成品可能會相依於某個查詢，因此可能需要這個工作。 此外，上傳查詢的工作相依於成功完成上傳工作項目類型的工作。 您要指定每個查詢檔案在 taskXml 項目中上傳。

本主題內容

  • 建立工作項目查詢的檔案

  • 指定要上傳的查詢

  • QUERIES 項目參考

從流程範本建立 Team 專案之後，您可以使用查詢編輯器新增、移除以及變更查詢。 如需詳細資訊，請參閱查詢工作項目。

如需如何將查詢使用權限指派給群組的詳細資訊，請參閱控制功能區域的存取權。 如需如何建立查詢資料夾的詳細資訊，請參閱使用工作項目追蹤外掛程式定義用於追蹤工作項目的物件。

建立工作項目查詢的檔案

每個查詢定義都必須使用 WorkItemQuery 父項目，在自己的檔案中，以 .wiq 副檔名指定，並符合在 wiq.xsd 檔案中定義的結構描述。 您可以從 Microsoft 網站的下列頁面下載用於追蹤工作項目的結構描述檔案：Visual Studio Team Foundation 的流程範本和工作項目結構描述 (英文)。

下列範例示範定義工作項目查詢的高階語法結構：

<WorkItemQuery Version="1">
<TeamFoundationServer>collectionURL</TeamFoundationServer>
<TeamProject>TeamProjectName</TeamProject>
  <Wiql>
      WorkItemQueryLanguage
  </Wiql>
</WorkItemQuery>

如需如何建立要新增至流程範本之工作項目查詢的詳細資訊，請參閱定義要加入至流程範本的工作項目查詢。

回到頁首

指定要上傳的查詢

若要在流程範本中包含工作項目查詢，請在 workitems.xml 檔中建立一個或個項工作 (您可以在位於下載流程範本之存放資料夾底下的 [\WorkItem Tracking] 資料夾中找到此檔案)。 使用 Query 項目指定工作項目查詢的檔案。 例如，下列 XML 會指定在要上傳且名稱為 Active Bugs 之 ActiveBugs.wiq 檔案中定義的查詢。

<Query name="Active Bugs" fileName="WorkItem Tracking\Queries\ActiveBugs.wiq" />

您可以在 WorkItemTracking 外掛程式中新增要當做工作上傳的一組查詢。

下列範例示範如何指定工作，以建立名稱為 Product Management 的查詢資料夾，並將名稱為 All User Stories 的查詢上傳到該資料夾。

<task id="Queries" name="Stored Query Definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage=" Work item queries uploaded" />
   <dependencies>
      <dependency taskId="WITs" />
   </dependencies>
   <taskXml>
      <QUERIES>
         <QueryFolder name="Product Management" >
            <Query name="All User Stories" fileName="WorkItem Tracking\Queries\AllUserStories.wiq" />
         </QueryFolder>
         . . .
      </QUERIES>
   </taskXml>
</task>

如需詳細資訊，請參閱使用工作項目追蹤外掛程式定義用於追蹤工作項目的物件。

回到頁首

QUERY 項目

下列語法顯示 QUERIES 項目及其子項目的結構。

<QUERIES>
   <Permission />
   <QueryFolder >
      <Query />
   </QueryFolder>
</QUERIES>

下表描述您用於指定查詢資料夾結構、權限，以及要上傳之查詢的項目。 您可以在 WorkItemTracking 外掛程式檔案的 taskXml 容器項目中指定這些項目。

元素

語法

描述

Permission

 
<permission allow="ListOfPermissions" identity="GroupName" />

Query 的選擇性子項目。

指定指派給分享查詢的預設權限。 如需詳細資訊，請參閱指派工作項目查詢的權限。

Query

 
<Query name="QueryName" fileName="QueryFilePathName" />

您可以上傳標示為 "Active Bugs"，且在 ActiveBugs.wiq 檔案中定義的查詢：

<Query name="Active Bugs" fileName="WorkItem Tracking\Queries\ActiveBugs.wiq" />

QUERIES 的必要子項目。

指定 .wiq 檔案的名稱和路徑，這個檔案會定義要上傳的查詢。

QueryFolder

 
<QueryFolder name="FolderName">
   <Query />
</QueryFolder>

QUERIES 的選擇性子項目。

指定查詢資料夾的名稱。

QUERIES

 
<QUERIES>
   . . . 
</QUERIES>

用於 WorkItemTracking 外掛程式之 taskXml 項目的選擇性子項目。

指定要用來建立預設查詢的查詢定義檔。

回到頁首

請參閱

概念

查詢工作項目

使用工作項目追蹤外掛程式定義用於追蹤工作項目的物件