向过程模板添加工作项查询

项目
08/12/2011

通过向过程模板中添加工作项查询，可以为团队项目定义团队查询的初始集合和查询文件夹结构。所有团队成员都使用查询来查找必须对其执行操作的 Bug、任务和其他工作项。

工作项查询指定用于生成工作项列表（例如，活动 Bug 或已关闭任务的列表）的条件。工作项查询文件的扩展名为 .wiq，并存储在 Microsoft Solutions Framework (MSF) 过程模板的 WorkItem Tracking 文件夹的 Queries 子文件夹中。

重要事项
MSF 过程模板定义了多个查询。有关更多信息，请参见团队查询 (Agile)和团队查询 (CMMI)。查询定义依赖过程模板中的工作项的字段和类型。另外，“门户”插件中上载的一些工作簿依赖查询定义。

指定在 WorkItemTracking 插件中作为任务上载的查询定义。可能需要此任务，因为过程模板中的多个项目可能会依赖查询。此外，上载查询这一任务依赖于成功完成上载工作项类型这一任务。指定要在 taskXml 元素中上载的每个查询文件。

主题内容

创建工作项查询文件
指定要上载的查询
QUERIES 元素参考

从过程模板创建团队项目后，您可以使用查询编辑器添加、删除和更改团队查询。有关更多信息，请参见查找 Bug、任务和其他工作项。

有关如何将查询权限分配给各组的信息，请参见控制对功能区域的访问。有关如何创建查询文件夹的信息，请参见使用 WorkItemTracking 插件来定义和自定义用于跟踪工作项的对象。

创建工作项查询文件

必须使用 WorkItemQuery 父元素在其自己的扩展名为 .wiq 的文件中指定每个查询定义，且必须遵循 wiq.xsd 文件中定义的架构。您可以从 Microsoft 网站上的以下页面下载用于跟踪工作项的架构文件：Process Template and Work Item Schemas for Visual Studio Team Foundation（Visual Studio Team Foundation 的过程模板和工作项架构）。

下面的示例演示了定义工作项查询的高级语法结构：

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

有关如何创建要添加到过程模板的工作项查询的更多信息，请参见定义要添加到过程模板中的工作项查询。

返回页首

指定要上载的查询

若要在过程模板中包括工作项查询，请在 workitems.xml 文件中创建一个或多个任务，可以在下载过程模板的文件夹的“\WorkItem Tracking”文件夹中找到该文件。使用 Query 元素可指定工作项查询文件。例如，下面的 XML 指定要上载的 ActiveBugs.wiq 文件中定义的查询，该查询名为 Active Bugs。

<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" />` 如下面的示例所示，您可以上载 ActiveBugs.wiq 文件中定义的查询，该查询标记为“Active Bugs”。 <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、任务和其他工作项

其他资源

使用 WorkItemTracking 插件来定义和自定义用于跟踪工作项的对象