用于支持与测试、生产和版本控制的集成的字段

项目
06/09/2015

通过添加与 Team Foundation Build、Microsoft 测试管理器和 Team Foundation 版本控制集成的字段，你可以自定义工作项 (WIT) 来包含由自动化过程生成的信息。

与 Team Foundation Build 集成的字段

Team Foundation Build 是 Team Foundation Server 的自动生成系统。你可以通过使用 Team Foundation Build 配置生成过程，并且 Team Foundation Build 可以在生成失败时生成工作项。它还可以将生成信息添加到在特定生成中解决的工作项。为了让它正常工作，Team Foundation Build 要求将以下两个字段添加到工作项类型定义：“发现版本”和“集成版本”。

在 Team Foundation Server 提供的默认过程模板中，**“发现版本”和“集成版本”**字段显示在 Bug 的类型定义中。这些字段将 Bug 与发现或修复这些 Bug 的生成关联。你可以使用以下代码片段将这些字段添加到 WIT 定义中。

<FIELD name="Found In" refname="Microsoft.VSTS.Build.FoundIn" type="String" reportable="dimension">
    <HELPTEXT>Product build number (revision) in which this item was found</HELPTEXT>
        <SUGGESTEDVALUES>
          <LISTITEM value="&lt;None&gt;" />
        </SUGGESTEDVALUES>
</FIELD>
<FIELD name="Integration Build" refname="Microsoft.VSTS.Build.IntegrationBuild" type="String" reportable="dimension">
    <HELPTEXT>Product build number this bug was fixed in</HELPTEXT>
        <SUGGESTEDVALUES>
          <LISTITEM value="&lt;None&gt;" />
        </SUGGESTEDVALUES>
</FIELD>

若**“发现版本”字段存在于 WIT 定义中，Team Foundation Build 将在生成失败时创建一个工作项，并将“发现版本”字段设置为刚刚失败的生成的生成号。如果“发现版本”**字段缺失，Team Foundation Build 不会为已失败的生成创建工作项，但其他一切会按预期方式运行。

若**“集成版本”字段存在于 WIT 定义中，Team Foundation Build 将确定在每个生成中解决的工作项，然后更新这些工作项，以在“集成版本”字段中设置解决它们时使用的生成号。如果“集成版本”**字段缺失，Team Foundation Build 不会在工作项中存储生成号，但其他一切会按预期方式运行。

与变更集和工作项的生成关联

基于默认生成模板的标准生成会将变更集和工作项关联到生成。它的实现方法是通过首先检索给定生成的生成定义的上一个成功生成的标签，然后确定哪些变更集包括在当前版本中（不包括在上一个版本中）。某些或所有变更集可能拥有与它们关联的工作项，并且这些工作项与生成相关联。此操作是作为 AssociateChangesetsAndWorkItems 活动的一部分实现的。

生成和全局列表自动填充

首次使用 Team Foundation Build 对团队项目进行生成排队时，TFS 会自动添加标记为“生成 - <团队项目名称>”的全局列表。每次运行生成时，LISTITEM 将添加到使用此生成名称的全局列表。

通过将 GLOBALLIST 元素添加到 FIELD 定义，你可以提供生成的下拉菜单，以供用户从中进行选择。例如：

<FIELD name="Found In" refname="Microsoft.VSTS.Build.FoundIn" type="String" reportable="dimension">
    <HELPTEXT>Product build number (revision) in which this item was found</HELPTEXT>
        <SUGGESTEDVALUES>
          <LISTITEM value="&lt;None&gt;" />
        </SUGGESTEDVALUES>
        <SUGGESTEDVALUES expanditems="true" filteritems="excludegroups">
          <GLOBALLIST name="Builds - TeamProjectName" />
        </SUGGESTEDVALUES>
</FIELD>

与 Microsoft 测试管理器集成的字段

使用测试管理器，你可以在测试失败时自动创建 Bug 或其他类型的工作项。有关详细信息，请参阅在 Microsoft 测试管理器中提交 Bug。

使用此方式创建工作项后，将在**“系统信息”和“重现步骤”**字段中捕获有关重现 Bug 的系统和步骤信息。

你可以使用以下代码片段，将这些字段添加到你为跟踪缺陷而创建的工作项类型。

<FIELD name="System Info" refname="Microsoft.VSTS.TCM.SystemInfo" type="HTML" />
<FIELD name="Repro Steps" refname="Microsoft.VSTS.TCM.ReproSteps" type="HTML" />

有关测试管理器使用的其他字段的详细信息，请参见生成和测试集成字段引用.

与 Team Foundation 版本控制集成的字段

Team Foundation 版本控制中提供的某个功能可允许你在签入代码时关联或解决工作项。进行代码更改时，你可能已经处理了某个特定的工作项，此时你可以在处理完该代码后，从源代码管理签入窗口设置该关联。

要使 Team Foundation 版本控制能够解决工作项，要求工作项包含特定的操作。然后，源代码管理系统将查询工作项跟踪，以确定工作项是否支持该操作；如果它确实支持该操作，它还会查询转换的源和目标状态。如果已找到该操作，源代码管理系统可以根据签入代码时设置的转换对工作项进行转换。

备注

使用 Checkin 操作时，你必须设置合理的“自”和“至”状态以反映你所需的状态转换。

有关操作的详细信息，请参见基于状态、转换或原因自动进行字段赋值.

签入操作的示例

<TRANSITION from="Active" to="Resolved">
....
    <ACTIONS>
        <ACTION value="Microsoft.VSTS.Actions.Checkin"/>
    </ACTIONS>
....  
</TRANSITION>