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

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

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

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

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

本主題內容

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

• 指定要上傳的查詢

• QUERIES 項目參考

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

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

建立工作項目查詢的檔案

每個查詢定義都必須使用 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 項目的選擇性子項目。 指定要用來建立預設查詢的查詢定義檔。

回到頁首

請參閱

概念

尋找 Bug、工作和其他工作項目

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