导入和导出过程配置 [witadmin]

  • 项目

自定义过程配置以修改你通过 Team Web Access (TWA) 查看的 Agile 计划工具页的显示。 一些其他工具需要你将工作流状态映射到元状态映射。

有关如何自定义 Agile 计划工具页的概述，请参见配置和自定义团队项目的敏捷计划工具.

备注

如果你收到错误消息 TF400917，则表示 TWA 出现了无效的配置。使用 witadmin importcommonprocessconfig 将过程配置文件重新导入到团队项目。你将收到解决该错误所需的消息。

要管理团队项目的过程配置，请使用 witadmin 命令行工具导出和导入过程配置 XML 定义文件。 若要了解过程配置，请参阅过程配置 XML 元素参考.

用于自定义 WIT 对象的进程

  • exportprocessconfig：将过程配置定义导出到 XML 文件或命令提示符窗口。

  • importprocessconfig：导入过程配置定义 XML 文件。

若要运行 witadmin 命令行工具，请在安装了 Visual Studio 或团队资源管理器的情况下打开命令提示符窗口，然后输入：

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

在 32 位版本的 Windows 上，将 %programfiles(x86)% 替换为 %programfiles%。

要求

  • 要导出过程配置定义，你必须是团队项目或集合的有效用户。

  • 要导入过程配置定义，你必须是以下安全组的成员：“Team Foundation 管理员”或“项目管理员”。

有关详细信息，请参阅Team Foundation Server 权限参考。

witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName [/f:FileName] [/e:encoding] 

witadmin importprocessconfig /collection:CollectionURL [/p:ProjectName] /f:FileName [/e:encoding] [/v]

参数

参数

描述

/collection:CollectionURLx

必需。 指定集合的 URL。 你必须使用以下格式指定 URI：http://ServerName:Port/VirtualDirectoryName/CollectionName

如果不指定虚拟目录，则必须使用以下格式指定 URI：

http://ServerName:Port/CollectionName。

/p:ProjectName

必需。 指定你要导出或导入过程配置的团队项目。 此团队项目必须在使用 /collection 参数指定的集合中定义。 在指定 /v 切换时，你无需指定团队项目。

/f:FileName

要导出或导入的过程配置的 XML 定义文件的路径和名称。

备注

如果客户端计算机正在运行 Windows Vista，你可能没有特定文件夹的权限。如果你尝试将全局列表导出到没有权限的位置，注册表虚拟化技术会自动重定向导出的文件并将其保存到虚拟存储。有关详细信息，请参见 Microsoft 网站上的以下页面：注册表虚拟化和 Windows Vista 中的通用文件和注册表虚拟化问题。若要避免此重定向，你可以将文件导出到具有权限的位置。

/e:Encoding

可选。 .NET Framework 2.0 编码格式的名称。 指定的编码将用于导出或导入 XML 数据。 例如，/e utf-7 指定 Unicode (UTF-7) 编码。 如果省略此参数，则 witadmin 将尝试检测编码，并且如果检测失败，将使用 UTF-8。

/v

可选。 验证定义过程配置的 XML，但是不导入定义文件。

/? 或 help

在“命令提示符”窗口中显示有关命令的帮助。

备注

备注

安装 VS TFS 2013 将升级现有的团队项目。它们将使用过程配置文件，该文件将 Agile 配置文件与 TFS 2012 中支持的通用配置文件结合在一起。下列 witadmin 命令及其对应的配置文件已经被弃用：

  • exportagileprocessconfig

  • exportcommonprocessconfig

  • importagileprocessconfig

  • importcommonprocessconfig

如果你正在更新升级的团队项目，请参见更新升级的团队项目以访问新功能.

如果你在升级到 TFS 2013.3 后访问现有测试计划或测试套件时遇到问题，请参见手动更新团队项目以支持测试管理.

示例

在每个示例中应用下面的值：

  • 集合的 URL：http://AdventureWorksServer:8080/tfs/DefaultCollection

  • 团队项目：Contoso

  • 服务器网站的端口号：8080

将字段添加到快速添加面板

你可以为任何快速添加面板添加字段。 例如，下面的示例将**“业务价值”**添加到产品积压工作 (backlog) 面板中。

添加“业务价值”字段后的“积压工作(Backlog)”面板

该面板只显示包含在所选 WIT 的 WIT 定义的 FIELDS 部分中的字段。 例如，如果选择 Bug WIT，则仅显示标题，因为没有为 Bug 定义“业务价值”。 若要将另一个 WIT 添加到面板中，请将它添加到要求类别中，如此处所述。

  1. 如果你不具有团队项目的管理权限，请获取这些权限。

  2. 打开已安装 Visual Studio 或团队资源管理器的命令提示符窗口，然后输入：

    cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

    在 32 位版本的 Windows 上，将 %programfiles(x86)% 替换为 %programfiles%。 你可以免费下载团队资源管理器。

  3. 导出过程配置文件。

    witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"

    CollectionURL 的一个示例是 http://MyServer:8080/tfs/TeamProjectCollectionName。

  4. 将字段引用名称添加到 AddPanel 部分。

    例如，下列语法将**“优先级”**元素添加到面板。

    <AddPanel>
   <Fields>
      <Field refname="System.Title" />
      <Field refname="Microsoft.VSTS.Common.BusinessValue" />
   </Fields>
</AddPanel>

    提示：

    • 使用此索引可查找字段的引用名称。

    • 为针对“要求类别”定义的工作项类型添加所有必需的字段。 那样，在你通过面板添加积压工作 (backlog) 项时，你就可以避免需要打开工作项窗体来填充它们。

  5. 导入过程配置文件。

    witadmin importprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"

  6. 刷新积压工作 (backlog) 页来查看更新的面板。

更元状态映射以支持测试管理器

如果你自定义测试计划或测试套件的 WORKFLOW 部分，你必须将状态映射到元状态。 它可支持 Visual Studio 2013.2 或更早版本中的测试管理器客户端。

在以下示例中，已更新测试计划工作流以使用设计、测试和已签署状态。 为了支持向后兼容性，TestPlanWorkItems 已添加到过程配置定义的 ProjectProcessConfiguration 部分。

WORKFLOW

元状态映射

 
<WORKFLOW>
      <STATES>
        <STATE value="Design" />
        <STATE value="Testing" />
        <STATE value="Signed Off" />
      </STATES>
      <TRANSITIONS>
        <TRANSITION from="" to="Design">
          <REASONS>
            <DEFAULTREASON value="New test plan" />
          </REASONS>
        </TRANSITION>
     <TRANSITION from="Design" to="Testing">
          <REASONS>
            <DEFAULTREASON value="Authoring complete" />
          </REASONS>
        </TRANSITION>        
     <TRANSITION from="Testing" to="Signed Off">
          <REASONS>
            <DEFAULTREASON value="Signed Off testing" />
          </REASONS>
        </TRANSITION>
        <TRANSITION from="Signed Off" to="Design">
          <REASONS>
            <DEFAULTREASON value="Reactivating to authoring phase" />
          </REASONS>
        </TRANSITION>
        <TRANSITION from="Signed Off" to="Testing">
          <REASONS>
            <DEFAULTREASON value="Reactivating to run tests" />
          </REASONS>
        </TRANSITION>
        <TRANSITION from="Testing" to="Design">
          <REASONS>
            <DEFAULTREASON value="Back to authoring" />
          </REASONS>
        </TRANSITION>
      </TRANSITIONS>
    </WORKFLOW>
 
<TestPlanWorkItems category="Microsoft.TestPlanCategory" pluralName="Test Plans" singularName="Test Plan">
    <States>
      <State type="InProgress" value="Design" />
      <State type="InProgress" value="Testing" />
      <State type="Complete" value="Signed Off" />
    </States>
  </TestPlanWorkItems>
<TestSuiteWorkItems category="Microsoft.TestSuiteCategory" pluralName="Test Suites" singularName="Test Suite">
    <States>
      <State type="Proposed" value="In Planning" />
      <State type="InProgress" value="In Progress" />
      <State type="Complete" value="Completed" />
    </States>
  </TestSuiteWorkItems>

如果你修改测试套件工作流，那么如果要映射新状态，则必须进行类似的更新。 你将在 TestSuiteWorkItems 部分中添加它。 请参阅过程配置 XML 元素参考。

问题解答

问：在 TFS 升级后，我可以进行哪些自定义并继续使用“配置功能”向导更新我的团队项目？

**答：**你可以自定义快速添加面板。 配置功能向导将更新你的团队项目，并且你将获取对最新功能的访问权限。

其他更改可能会要求你在更新团队项目时执行某些手动操作。 要了解你可以安全地进行和避免哪些自定义，请参见自定义工作跟踪体验：在你进行自定义之前，了解维护和升级的影响。

问：何时需要将工作流状态映射到元状态？

**答：**当你向以下 WIT 添加或移除工作流状态时，你应该考虑更新过程配置以添加或删除相应的元数据映射。

  • 属于要求类别或任务类别的 WIT：元状态映射支持 Agile 计划工具的显示。

  • 属于 Bug 类别的 WIT：用于支持**“我的工作”**工具的元状态映射（Agile 和基于 CMMI 的团队项目）。

  • 测试计划和测试套件：仅当你支持团队成员从基于 Visual Studio 2013.2 或更早版本的测试管理器版本连接到 TFS 时，必须映射对这些 WIT 的工作流的更新。

    仅在升级到 TFS 2013.3 后提供测试计划和测试套件 WIT（在此下载页上提供）。

    如果在连接到团队项目时收到**“应用程序已检测到意外错误”**的错误，请更新元状态映射。

    TFS 升级后出现的应用程序故障错误消息

如何解决过程配置错误？

**答：**当你对团队项目进行以下更改之一时，你将需要更新 WIT、类别或过程配置的定义。 若要避免错误，始终按以下顺序进行更改：(1) WIT，(2)类别，(3) 过程配置。

自定义

更新或验证 WIT 定义

更新或验证过程配置定义

向要求类别添加 WIT

（WIT 可以属于要求类别或任务类别，但不能同时属于这两者。）

若要包含以下字段：

  • 积压工作 (backlog) 优先级 (Scrum) 或堆栈级别（Agile 或 CMMI）

    （必须匹配分配到过程配置文件中的 type=Order 的字段值）

  • 工作量 (scrum)、情景点 (Agile)、或大小 (CMMI)

    （必须匹配分配到过程配置文件中的 type=Effort 的字段值）

  • 分配到过程配置文件中的 type=Team 的区域路径或字段值

  • 过程配置文件的 AddPanel 部分中所含的所有字段（字段必须在 FIELDS 部分内定义，但无需包含在 FORM 部分中）。

若要包含必需的元状态映射：

  • 将每个工作流状态的开头映射到 type="Proposed"

  • 将每个你希望在看板上显示的中间工作流状态映射到 type="InProgress"

  • 将每个工作流状态的结尾映射到 type="Complete"

    你可以仅将一个状态映射到 type="Complete"

包含用于定义与 WIT 相关联的颜色代码的条目。 例如：

<WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="Product Backlog Item" />

更改要求类别中的 WIT 的工作流

不可用

包含如上所述的必需元状态映射用于向要求类别添加 WIT。

向任务类别添加 WIT

若要包含以下字段：

  • 积压工作 (backlog) 优先级 (Scrum) 或堆栈级别（Agile 或 CMMI）

  • 活动（Scrum 或 Agile） 或专业 (CMMI)

    （必须匹配分配到过程配置文件中的 type=Activity 的字段值）

  • 剩余工作

    （必须匹配分配到过程配置文件中的 type=RemainingWork 的字段值）

  • 分配到过程配置文件中的 type=Team 的区域路径或字段值

  • （可选）原始工作和完成的工作（仅限 Agile 和 CMMI）

若要包含必需的元状态映射：

  • 将每个工作流状态的开头映射到 type="Proposed"

  • 将每个你希望在任务版上显示的中间工作流状态映射到 type="InProgress"

  • 将每个工作流状态的结尾映射到 type="Complete"

    你可以仅将一个状态映射到 type="Complete"

包含用于定义与 WIT 相关联的颜色代码的条目。 例如：

<WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Task" />

更改任务类别中的 WIT 的工作流

不可用

包含如上所述的必需元状态映射用于向任务类别添加 WIT。

向 Bug 类别添加 WIT（仅限 Agile 和 CMMI）

更改 Bug 类别中的 WIT 的工作流（仅限 Agile 和 CMMI）

不可用

若要包含必需的元状态映射：

  • 将每个工作流状态的开头映射到 type="Proposed"

  • 将每个你希望在“我的工作”上显示的中间工作流状态映射到 type="InProgress"

  • 将每个工作流状态的结尾映射到 type="Complete"

    你可以仅将一个状态映射到 type="Complete"

若要了解更多信息，请参见 使用“我的工作”支持 Bug 更新状态。

从要求类别或任务类别移除 WIT

不可用

删除仅与该 WIT 相关联的元状态映射

从团队项目移除 WIT

从类别文件移除 WIT。

移除任何仅与你移除的 WIT 相关联的元状态映射和为你移除的 WIT 定义颜色代码的 WorkItemColor 元素。

问：如何自定义 TWA 中的 Agile 计划工具中出现的其他功能？

**答：**某些自定义可通过用户界面执行。 其他自定义组要编辑过程配置或其他团队项目对象。 有关概述，请参阅配置和自定义团队项目的敏捷计划工具。

问：是否要使用两个或两个以上的项目组合积压工作 (backlog)？

**答：**默认值体验支持一个项目组合积压工作 (backlog) 级别。 你最多可添加五个级别，如下所述向敏捷项目组合管理添加积压工作 (backlog).

问：你是否想添加或更改任务板或产品积压工作 (backlog) 上显示的 WIT？

**答：**如果你已添加自定义 WIT，并希望将其添加到积压工作 (backlog) 或任务板中，则可以这样做。 不能将它们同时显示在两个位置中。 通过阅读以下部分了解操作方式：向积压工作 (backlog) 或任务板添加 Bug。