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

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

工作项查询指定用于生成工作项列表的条件，比如活动 bug 或已关闭的任务的列表。 工作项查询的文件的扩展名为 .wiq 并且存储在 Microsoft Solutions Framework (MSF) 过程模板的“工作项跟踪”文件夹的“查询”子文件夹中。

指定要作为任务在“工作项跟踪”插件内上载的查询定义。 可能需要此任务，因为过程模板中的多个项目可能取决于查询。 此外，要上载查询的任务依赖于上载工作项类型的任务的成功完成。 你在 taskXml 元素中指定要上载的每个查询文件。

主题内容

• 为工作项查询创建文件

• 指定要上载的查询

• QUERIES 元素参考

从过程模板创建团队项目后，你可以使用查询编辑器来添加、删除和更改查询。 有关详细信息，请参阅查询工作项。

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

为工作项查询创建文件

必须在查询的文件中以 .wiq 为扩展名指定每个查询定义，通过使用 WorkItemQuery 父元素，而且要符合 wiq.xsd 文件中定义的架构。 你可从 Microsoft 网站上的以下页面中下载用于跟踪工作项的架构文件：Visual Studio Team Foundation 的过程模板和工作项架构。

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

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

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

返回页首

指定要上载的查询

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

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

将要上载的查询集作为一项任务添加到 WorkItemTracking 插件中。

下面的示例演示如何指定任务以创建一个名为“产品管理”的查询文件夹和将一个名为“所有用户情景”的查询上载到该文件夹。

<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 allow="ListOfPermissions" identity="GroupName" />

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

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

<QUERIES>
   . . . 
</QUERIES>

返回页首

请参见

概念

查询工作项

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