解决配置功能时收到的错误

项目
06/09/2015

您可以纠正配置功能向导显示的错误和警告。这些问题是因团队项目中的定义与上载到团队项目集合的过程模板中的定义发生冲突而导致出现的。您应更改过程模板以纠正该错误并重新运行该向导。或者，您可以更改团队项目，然后重新运行该向导。

主题内容

纠正配置功能向导报告的错误
- 通过修改过程模板来纠正错误
- 通过修改团队项目或团队项目集合来纠正错误
- 问题和解决方法
纠正配置功能向导报告的警告
- 纠正有关向工作项类型添加 ACTION 语句的警告
- 添加情节提要链接控件

备注

如果在执行下列过程时遇到问题，你也许能够在 Team Foundation Server (TFS) 的论坛上找到解决方案，这些论坛位于 Microsoft 网站的以下页面上：工作项跟踪和过程模板。

所需权限

若要下载和上载过程模板，您必须是**“项目集合管理员”组的成员。如果显式设置安全权限，则必须将团队项目集合的“管理过程模板”权限设置为“允许”**。
若要运行 witadmin 命令行工具，您必须是以下某个组的成员：“Team Foundation Administrators”、“项目集合管理员”或团队项目的“项目管理员”。

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

纠正配置功能向导报告的错误

您可以通过修改用于配置新功能的过程模板或通过修改团队项目来纠正错误。在纠正错误后，请重新运行该向导。

通过修改过程模板来纠正错误

通过执行下列步骤修改过程模板：

从 Team Foundation Server 下载过程模板。请参阅下载过程模板的最新版本。
修改工作项类型、类别或过程配置的定义文件。请参见自定义工作跟踪对象以支持团队的进程
将过程模板上载到 Team Foundation Server。请参阅为团队项目集合上载、下载和删除过程模板。

另请参阅更新自定义过程模板以访问新功能。

通过修改您的团队项目或团队项目集合来纠正错误

若要纠正错误或警告，可以选择使用 witadmin 命令来修改团队项目或团队项目集合。请参阅witAdmin：自定义和管理用于跟踪工作的对象。

可以导出类型定义，更改字段定义，然后根据需要导入类型定义。请参阅导入、导出和管理工作项类型 [witadmin]。

问题和解决方法

若要纠正下表中列出的错误，请对过程模板或团队项目采取相应的纠正措施，然后重新运行该向导。

错误	问题	过程模板解决方法	团队项目解决方法
TF400613：类别“{0}”中指定的工作项类型“{1}”不存在。	团队项目缺少所需的工作项类型，因为它已被重命名、移除或未添加。重命名指定的工作项类型定义，或从随 TFS 升级安装的过程模板的最新版本导入缺少的工作项类型。	更改指定类别中定义的工作项类型以指定现有的工作项类型。	若要重命名工作项类型，请使用 witadmin renamewitd。若要添加缺少的工作项类型，请在最新的过程模板中找到它并使用 witadmin importwitd 将其导入。请参阅导入、导出和管理工作项类型 [witadmin]。
TF400614：类别“{0}”不存在。	选定用于更新团队项目的过程模板中的类别定义文件缺少所需类别。添加缺少的类别。	将缺少的类别添加到过程模板中。请参阅使用类别对工作项类型进行分组。	使用 witadmin importcategories 将缺少的类别添加到团队项目中。请参见导入和导出类别 [witadmin]
TF400617：工作项类型“{1}”中的字段“{0}”的类型与现有字段的类型冲突。	所添加的工作项类型中定义的字段的数据类型与团队项目集合中定义的数据类型不匹配。更正工作项类型定义中的分配，然后重新运行该向导。备注升级 Visual Studio Team Foundation Server 2012 会将“说明”字段 (System.Description) 从纯文本的字段类型更改为 HTML，以支持图像和超链接的文本格式设置和插入。在最新版本的 Team Foundation Server 中，您可以在 PlainText 和 HTML 之间切换数据类型。	下载过程模板，打开类型定义，查找 FIELD 分配，修改 type 特性以匹配为集合定义的特性，然后上载过程模板。请参见 FIELD（定义）元素引用提示若要确定分配给字段的类型，请运行 witadmin listsfields。	使用 witadmin changefield 并指定 type 特性。请参阅管理工作项字段 [witadmin]。备注仅当类型为 PlainText 或 HTML 时，您才能更改团队项目集合的类型定义。
TF400618：工作项类型“{1}”中的字段“{0}”的报告类型与现有字段的报告类型冲突。	分配给工作项类型定义中的字段的报告特性与团队项目集合中定义的特性不匹配。	下载过程模板，打开类型定义，查找 FIELD 分配并修改 reportable 特性以匹配为集合定义的特性。然后上载过程模板。请参见 FIELD（定义）元素引用	使用 witadmin changefield 并指定 reportingtype 特性。请参阅管理工作项字段 [witadmin]。
TF400619：工作项类型“{1}”中的字段“{0}”的 SyncNameChanges 与现有字段的 SyncNameChanges 冲突。	分配给工作项类型定义中字段的 syncnamechanges 特性与团队项目集合中定义的特性不匹配。此特性指定某个人名在 Active Directory 中变更时是否更新此人名字段。	下载过程模板，打开类型定义，查找 FIELD 分配，对其进行修改以匹配集合中的定义，然后上载过程模板。请参阅FIELD（定义）元素引用。	使用 witadmin changefield 命令并指定 /syncnamechanges 参数。请参阅管理工作项字段 [witadmin]。
TF400620：工作项类型“{1}”中的字段“{0}”的友好名称与现有字段的友好名称冲突。	分配给工作项类型定义中的字段的友好名称必须与团队项目集合中定义的名称匹配。	下载过程模板，打开类型定义，查找 FIELD 分配，并对其进行修改以匹配为集合定义的分配。然后上载过程模板。	若要更改团队项目集合的友好名称，请使用 witadmin changefield 命令并指定 /name 参数。请参阅管理工作项字段 [witadmin]。
TF400621：工作项类型“{1}”中的字段“{0}”的引用名称已被某个链接类型使用。	分配给字段的每个引用名称和链接类型在团队项目集合中必须是唯一的。	如果链接类型已激活且正在使用链接工作项，请下载过程模板，打开类型定义，查找 FIELD 分配并修改 refname 分配以匹配为集合定义的分配。然后上载过程模板。提示若要确定某个链接类型是否正在使用中，请创建直接链接查询，然后使用该链接类型对链接到另一个工作项的所有工作项进行筛选。	如果链接类型未激活且未用于在团队项目集合中链接工作项，请将其删除。您可以使用 witadmin deletelinktype 删除链接类型。请参阅管理链接类型 [witadmin]。
TF400624：类别“{0}”的友好名称与类别“{1}”冲突。	必须为团队项目的每个类别指定一个唯一的引用名称和友好名称。您可以通过重命名过程模板或团队项目中的现有类别“{1}”来纠正此错误。	下载过程模板，修改类别文件以重命名类别，然后上载过程模板。请参阅使用类别对工作项类型进行分组。	使用 witadmin exportcategories 导出类别文件，修改分配给类别“{1}”的友好名称，然后导入文件。请参阅导入和导出类别 [witadmin]。
TF400654：无法配置规划工具。	CommonConfiguration 文件中定义的映射指定在为团队项目定义的工作项类型中不存在的字段或状态。	下载过程模板，修改 CommonConfiguration 文件以更正映射，然后上载过程模板。请参见自定义过程配置	使用 witadmin exportwitd 导出工作项类型，添加缺少的字段或状态，然后导入工作项类型。请参阅导入、导出和管理工作项类型 [witadmin]。

若要了解更多信息，请参见下列主题：

纠正配置功能向导报告的警告

若要解决下表中列出的警告，请按解决方法步骤进行操作，然后重新运行该向导。

警告	问题	解决方法
TF400609：无法向工作项类型“{1}”添加操作“{0}”，因为状态“{2}”不存在。	缺少必需的 STATE。	请参见通过向工作项类型添加 ACTION 语句来纠正错误。
TF400610：无法向工作项类型“{1}”添加操作“{0}”，因为从状态“{2}”到“{3}”的转移不存在。	缺少必需的 TRANSITION 语句。	请参见通过向工作项类型添加 ACTION 语句来纠正错误。
情节提要：无法将选项卡插入到类别“{2}”中的工作项类型“{1}”中。	类型定义中缺少 TabGroup 元素。	请参见添加情节提要链接控件。

纠正有关向工作项类型添加 ACTION 语句的警告

为了支持“我的工作”功能，配置功能向导将两个 ACTION 语句插入到任务工作项类型定义的工作流转换部分中。如果缺失了状态或缺失了从新状态到活动状态的转换或从活动状态到新状态的转换，您都将收到一个警告。

若要解决此警告，请检查指定的工作项类型的工作流。如有必要，请修改工作流以匹配工作流状态和转换（为与用于创建团队项目的 TFS 相匹配的已升级的 TFS 上安装的过程模板的最新版本而定义）。然后重新运行该向导。有关基于 Agile 过程模板的团队项目，请参见更新敏捷团队项目的工作流。

若要了解更多信息，请参见下列主题：

添加情节提要链接控件选项卡

借助新增的情节提要功能，您现在可以将工作项链接到情节提要。为此，您需要将**“情节提要”**链接控件选项卡添加到工作项类型的定义中。如果配置功能向导没有或无法添加该选项卡，您可以手动添加它。在升级后的 TFS 上安装的最新版本的过程模板中，Storyboard 链接控件选项卡将显示在所有积压工作 (backlog) 工作项类型上，例如产品积压工作 (backlog)、用户情景和要求。

备注

如果工作项 FORM 部分中缺失 TabGroup 元素，则配置功能想到无法添加“情节提要”链接控件选项卡。下面的过程仅添加“情节提要”选项卡。若要为您的积压工作 (backlog) 项类型添加标准选项卡集，请参见团队项目的最新版本的过程模板中的类型定义。请参阅下载过程模板的最新版本。

若要运行 witadmin 命令行工具，请在安装了 Visual Studio 或团队资源管理器的情况下打开命令提示符窗口，然后输入：
```
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
```
在 32 位版本的 Windows 上，将 %programfiles(x86)% 替换为 %programfiles%。

通过用您的数据替换显示的参数来导出积压工作 (backlog) 项的类型定义文件：

witadmin exportwitd  /collection:CollectionURL /p:"ProjectName" /n:"TypeName" /f:"DirectoryPath\FileName.xml"
   
Where:
   CollectionURL specifies the URL of the team project collection
   ProjectName specifies the name of your team project defined within the collection
   TypeName specifies the name of your backlog item, for example User Story or Product Backlog Item.
   
Use the following format for CollectionURL:  http://ServerName:Port/VirtualDirectoryName/CollectionName
For example: http://srvalm:8080/tfs/DefaultCollection.

使用文本编辑器（如“记事本”）打开文件。

将此代码片段添加到积压工作 (backlog) 类型的 </Layout> 结束标记之前：

<TabGroup>
<Tab Label="Storyboards"> 
   <Control Name="StoryboardsControl" Type="LinksControl"> 
      <LinksControlOptions> 
         <WorkItemLinkFilters FilterType="excludeAll" /> 
         <ExternalLinkFilters FilterType="include"> 
            <Filter LinkType="Storyboard" /> 
         </ExternalLinkFilters> 
         <LinkColumns> 
            <LinkColumn RefName="System.Title" /> 
            <LinkColumn LinkAttribute="System.Links.Comment" /> 
         </LinkColumns> 
      </LinksControlOptions> 
   </Control> 
</Tab> 
</TabGroup>

保存并关闭文件。

通过键入此命令导入类型定义文件，并用您的数据替换显示的参数：

witadmin importwitd /collection:CollectionURL /p:"ProjectName" /f:"DirectoryPath\FileName.xml"

确认该选项卡显示在积压工作 (backlog) 项中。

请参见

概念

更新升级的团队项目以访问新功能