通过

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

  • 项目

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

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

重要

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

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

主题内容

  • 创建工作项查询文件

  • 指定要上载的查询

  • QUERIES 元素参考

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

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

创建工作项查询文件

必须使用 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 的可选子元素。

指定的默认权限分配给共享查询。 有关更多信息，请参见Assigning Permissions for Work Item Queries。

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 元素的可选子元素。

指定要用于创建默认查询的查询定义文件。

返回页首

请参见

概念

查询工作项

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