解决进程导入的验证错误
Azure DevOps Services
重要
导入过程支持托管 XML 进程模型,通过更新进程模板的 WIT 定义来管理自定义。 此功能仅适用于已使用 Azure DevOps 数据导入服务迁移到 Azure DevOps Services 的组织。 如果对 Azure DevOps Services 进程自定义有任何疑问,请与我们联系 。
如果使用继承过程模型,可以通过用户界面自定义工作跟踪,方法是 创建继承的进程。 如果使用本地 XML 进程模型,则可以自定义进程模板,请参阅 上传或下载进程模板 和 自定义进程模板。
若要了解有关流程模型的详细信息,请参阅 自定义工作跟踪。
在进程导入过程中,将验证该过程,以确保系统对自定义进程按预期工作。 如果进程验证失败,将收到错误消息列表。
如果在尝试 导入过程时收到验证错误,则需要在重试导入之前解决该错误。 每个错误都有一个链接,可了解有关特定验证失败的详细信息以及有关如何更正此错误的指导。 应用为收到的消息提供的解析修补程序(es),压缩更新的文件,然后重试导入操作。
如果刚刚开始自定义, 请查看提供的验证规则。
信息消息 - 无需执行任何操作
TF402555:删除字段 [refName] 。
正在导入的进程不包括正在更新的进程中的命名字段,因此它会作为更新操作的一部分删除。
方案示例
- 将自定义字段添加到Bug.xml工作项
<FIELD name="Foo" refname="MyCompany.CustomFields.Foo" type="String" reportable="dimension" />
- 导入过程
- 从Bug.xml中删除字段
- 导入更新的进程
系统显示有关要删除的字段的信息消息。
TF402555: Field MyCompany.CustomFields.Foo will be deleted
TF402591:现有进程 [processName]中,引用名称 [refName] 的字段不能从“[name2]”重命名为“[name1]”。
要导入的进程包含重命名的字段,该字段在当前进程(es)中使用相同的 refname
字段。
无法重命名字段名称。
TF402598:删除工作项类型 [refName] 。
要更新的进程不包括当前进程中存在的命名 WIT。 在更新现有进程的过程中,系统会从当前进程中删除命名的 WIT。
方案示例
系统显示有关删除的信息消息。
TF402598: Work item type My.LSI will be deleted
TF402601:工作项类型 [witName] 已从 [name2] 重命名为 [name1]。
该过程包含重命名的 WIT。 WIT 在现有进程中重命名。
要更新的进程包含已从当前进程中的名称重命名的 WIT。
在更新现有进程的过程中,系统会重命名当前进程中的 WIT。 引用该过程的现有项目中的所有工作项也会重命名。
方案示例
- 创建 名为“LSI”的新工作项类型
<WORKITEMTYPE name="LSI" refname="My.LSI">
- 导入过程
- 将 LSI 工作项类型重命名为实时站点事件
<WORKITEMTYPE name="Live Site Incident" refname="My.LSI">
- 导入更新的进程
系统显示有关要重命名的 WIT 的信息消息。
TF402601: Work item type My.LSI will be renamed to 'Live Site Incident' from 'LSI'
其他文件错误
TF402586:错误分析文件: [错误消息]
格式不正确的 XML 语法可能会导致分析文件错误。 缺少结束标记、缺少引号、缺少打开或右括号(< 或 >)可能会导致分析文件错误。
在错误消息中,确定并更正格式不正确的 XML 的来源。
TF402594:文件违反架构,出现以下错误: [错误消息]
进程 zip 文件中的每个 XML 文件必须符合给定架构。 架构冲突错误是由 XML 文件中的自定义 XML 标记或属性引起的。 阅读错误消息以确定架构冲突的源并相应地修复。
工作项跟踪的 FORM
架构定义将元素中的所有子元素定义为 camel 大小写,所有其他元素都定义为大写。 如果在验证类型定义文件时遇到错误,请检查元素的大小写结构。 同时,根据 XML 语法规则,开始标记与结束标记的大小写结构还必须匹配。
错误示例
自定义 XML 标记:
<WORKITEMTYPE name="Bug" refname="My.Bug">
<FOO>Hello World</FOO>
...
添加到 XML 元素的额外属性:
<WORKITEMTYPE name="Bug" refname="My.Bug" foo="hello world">
VS412450:[fileName]中的 Xml 架构验证错误。 [错误消息]
更正命名文件中的架构错误。
进程模板插件错误
ProcessTemplate.xml是定义整个进程和将导入以添加或更新进程的所有 XML 定义文件的根文件。 此文件包含创建项目时引用的所有插件和任务组。 每个任务组引用定义特定任务的从属 XML 文件(通常位于子文件夹中)。 通常,为每个插件指定一个任务组。
ProcessTemplate.xml定义文件必须符合 ProcessTemplate XML 元素引用中所述的语法和规则。
VS412457:进程包中找不到指定的文件“[fileName]”。
更正进程 zip 包以包含命名文件。
VS402452:进程模板未指定版本或指定无效版本。
编辑ProcessTemplate.xml文件以指定版本。
错误示例
ProcessTemplate.xml文件指定与敏捷进程相同的 version
GUID,这是锁定的进程。
<ProcessTemplate>
<metadata>
<name>Fabrikam Agile</name>
<description>Use this template to support Fabrikam Agile planning methods.</description>
<version type="ADCC42AB-9882-485E-A3ED-7678F01F66BC" major="7" minor="36" />
解决方法示例
指定了不同的 GUID。
<ProcessTemplate>
<metadata>
<name>Fabrikam Agile</name>
<description>Use this template to support Fabrikam Agile planning methods.</description>
<version type="7710F7A4-1F19-4054-9FBC-D94A5935221E" major="7" minor="1" />
VS412453:进程模板 zip 文件不包含必需的插件 [pluginName]。
ProcessTemplate.xml 文件中列出的所有文件及其支持的插件文件都必须存在于进程 zip 文件中。
使用搜索工具在进程文件和文件夹集中查找 filename=value 的所有实例。 然后,更新插件以删除缺少的命名文件,或将命名文件添加到其所属的进程文件夹中。
<taskList filename="WorkItem Tracking\WorkItems.xml" />
错误示例
WorkItemTracking 插件指定 fileName="WorkItem Tracking\TypeDefinitions\Epic.xml
,但它尚未添加到 WorkItem Tracking\TypeDefinitions 文件夹。
<WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Epic.xml" />
解决方法示例
将Epic.xml文件添加到 WorkItem Tracking\TypeDefinitions 文件夹。
VS412454:插件 [pluginName] 包含多个 taskList
{1}插件 {2}。 每个插件只允许一个 taskList
。
更正命名插件的ProcessTemplate.xml文件以减少定义的元素数 tasklist
。
错误示例
WorkItemTracking 插件包含两个 tasklist
语句。
<group id="WorkItemTracking" description="Workitem definitions uploading." completionMessage="Work item tracking tasks completed.">
<dependencies>
<dependency groupId="Classification" />
<dependency groupId="Groups" />
</dependencies>
<taskList filename="WorkItem Tracking\WorkItems.xml" />
<taskList filename="WorkItem Tracking\FabrikamWorkItems.xml" />
</group>
解决方法示例
<group id="WorkItemTracking" description="Workitem definitions uploading." completionMessage="Work item tracking tasks completed.">
<dependencies>
<dependency groupId="Classification" />
<dependency groupId="Groups" />
</dependencies>
<taskList filename="WorkItem Tracking\FabrikamWorkItems.xml" />
</group>
TF402575:只能在进程中包括一个类别定义文件。
错误示例
WorkItems.xml文件包含两个 CATEGORIES
语句。
<task id="Categories" name="Categories definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item type categories created">
<dependencies>
<dependency taskId="WITs" />
</dependencies>
<taskXml>
<CATEGORIES fileName="WorkItem Tracking\Categories.xml" />
<CATEGORIES fileName="WorkItem Tracking\Custom_Categories.xml" />
</taskXml>
</task>
解决方法示例
WorkItems.xml文件已更新为仅包含一个 CATEGORIES
语句。
<task id="Categories" name="Categories definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item type categories created">
<dependencies>
<dependency taskId="WITs" />
</dependencies>
<taskXml>
<CATEGORIES fileName="WorkItem Tracking\Custom_Categories.xml" />
</taskXml>
</task>
TF402576:只能在进程中包含一个 ProcessConfiguration 定义文件。
错误示例
WorkItems.xml文件包含重复 ProjectConfiguration
语句。
<taskXml>
<PROCESSCONFIGURATION>
<ProjectConfiguration fileName="WorkItem Tracking\Process\ProcessConfiguration.xml"/>
</PROCESSCONFIGURATION>
</taskXml>
<taskXml>
<PROCESSCONFIGURATION>
<ProjectConfiguration fileName="WorkItem Tracking\Process\ProcessConfiguration.xml"/>
</PROCESSCONFIGURATION>
</taskXml>
解决方法示例
WorkItems.xml文件已更新为仅包含一个 ProjectConfiguration
语句。
<taskXml>
<PROCESSCONFIGURATION>
<ProjectConfiguration fileName="WorkItem Tracking\Process\ProcessConfiguration.xml"/>
</PROCESSCONFIGURATION>
</taskXml>
TF402587:缺少必需的 ProcessConfiguration 文件。
WorkItems.xml文件指定要上传的 ProcessConfiguration 文件。 未指定文件、包含过期规范、模板中缺少指定文件或文件夹/文件名不正确。
错误示例
指定的配置已过期,并指定进程文件夹中不包含的两个文件。
<taskXml>
<PROCESSCONFIGURATION>
<CommonConfiguration fileName="WorkItem Tracking\Process\CommonConfiguration.xml"/>
<AgileConfiguration fileName="WorkItem Tracking\Process\AgileConfiguration.xml"/>
</PROCESSCONFIGURATION>
</taskXml>
解决方法示例
WorkItems.xml文件已更新,以包含正确的配置 ProjectConfiguration
语句。
<taskXml>
<PROCESSCONFIGURATION>
<ProjectConfiguration fileName="WorkItem Tracking\Process\ProcessConfiguration.xml"/>
</PROCESSCONFIGURATION>
</taskXml>
TF402577:字段 [refName] 指定已在进程 [processNames] 中的字段 [refName] 使用的友好名称 [friendlyName]。
对于导入到 Azure DevOps Services 的所有进程指定的所有 WIT 定义,友好名称必须是唯一的。
命名进程包含定义使用友好名称的字段的 WIT。
修改包含 [refName] 的进程 zip 文件中的 WIT 定义,并指定其他友好名称或使其与正在使用的现有字段匹配。
错误示例
UserStory WIT 定义包含 FIELD
具有友好名称 Product 的 Fabrikam.Product.Family 的元素。
<FIELD name="Product" refname="Fabrikam.Product.Family" type="String" reportable="dimension">
<HELPTEXT>Enter the name of the product family for this story or feature.</HELPTEXT>
</FIELD>
但是,在现有进程中,Fabrikam.Product.Versions 使用友好名称 Product。
<FIELD name="Product" refname="Fabrikam.Product.Versions" type="String" reportable="dimension">
<HELPTEXT>Enter the name of the product version for this story or feature.</HELPTEXT>
</FIELD>
解决方法示例
更新 UserStory WIT 定义以匹配现有字段。
<FIELD name="Product" refname="Fabrikam.Product.Versions" type="String" reportable="dimension">
<HELPTEXT>Enter the name of the product version for this story or feature.</HELPTEXT>
</FIELD>
TF402585:进程模板中缺少必需的 WorkItemTracking 插件引用。
必须在ProcessTemplate.xml文件的节中metadata
指定Microsoft.ProjectCreationWizard.WorkItemTracking
插件:
错误示例
ProcessTemplate.xml Microsoft.ProjectCreationWizard.WorkItemTracking
文件的节中 plugins
缺少该插件。
<plugins>
<plugin name="Microsoft.ProjectCreationWizard.Classification" wizardPage="false" />
<plugin name="Microsoft.ProjectCreationWizard.Reporting" wizardPage="false" />
<plugin name="Microsoft.ProjectCreationWizard.Portal" wizardPage="true" />
<plugin name="Microsoft.ProjectCreationWizard.Groups" wizardPage="false" />
<plugin name="Microsoft.ProjectCreationWizard.VersionControl" wizardPage="true" />
<plugin name="Microsoft.ProjectCreationWizard.TestManagement" wizardPage="false" />
<plugin name="Microsoft.ProjectCreationWizard.Build" wizardPage="false" />
<plugin name="Microsoft.ProjectCreationWizard.Lab" wizardPage="false" />
</plugins>
解决方法示例
<plugins>
<plugin name="Microsoft.ProjectCreationWizard.Classification" wizardPage="false" />
<plugin name="Microsoft.ProjectCreationWizard.Reporting" wizardPage="false" />
<plugin name="Microsoft.ProjectCreationWizard.Portal" wizardPage="true" />
<plugin name="Microsoft.ProjectCreationWizard.Groups" wizardPage="false" />
<plugin name="Microsoft.ProjectCreationWizard.WorkItemTracking" wizardPage="false" />
<plugin name="Microsoft.ProjectCreationWizard.VersionControl" wizardPage="true" />
<plugin name="Microsoft.ProjectCreationWizard.TestManagement" wizardPage="false" />
<plugin name="Microsoft.ProjectCreationWizard.Build" wizardPage="false" />
<plugin name="Microsoft.ProjectCreationWizard.Lab" wizardPage="false" />
</plugins>
类别
Categories.xml定义文件必须符合 Categories XML 元素引用中所述的语法和规则。
TF402546:类别文件缺少类别 [categoryName ] 。
ProcessConfiguration.xml文件中引用的所有类别都必须在Categories.xml文件中定义。 此外,系统要求Categories.xml文件包含以下类别的定义:
- Bug 类别
- 代码评审请求类别
- 代码评审响应类别
- 反馈请求类别
- 反馈响应类别
- 隐藏类型类别
- 需求类别
- 共享步骤类别
- 共享参数类别
- 任务类别
- 测试用例类别
- 测试计划类别
- 测试套件类别
更新Categories.xml文件以定义缺少 的 [name] 类别。
错误示例
ProcessConfiguration 引用 Epic 类别,但Categories.xml定义文件中缺少该类别。
解决方法示例
史诗类别将添加到类别文件。
<CATEGORY name="Epic Category" refname="Microsoft.EpicCategory">
<DEFAULTWORKITEMTYPE name="Epic" />
</CATEGORY>
TF402553:元素 [name] 引用未在类别文件中定义的类别 [categoryName]。
更新Categories.xml文件以定义缺少 的 [categoryName] 类别。
TF402560:已定义 [n] 类别。 仅 允许 [nn] 。
查看所有元素语句的Categories.xml文件 CATEGORY
,并确定可以删除哪些元素语句,以免超过允许的限制。
然后,查看ProcessConfiguration.xml文件以替换引用已删除类别的值。
TF402596:类别 [categoryName ] 不定义工作项类型 [witName]。
类别必须引用 /WorkItem Tracking/TypeDefinitions 文件夹中定义的 WIT,并将其列为要在WorkItems.xml插件文件中上传的任务。
查看Categories.xml文件,以获取对 /WorkItem Tracking/TypeDefinitions 文件夹中不包含的 WIT 的引用。
错误示例
为 Microsoft.EpicCategory 引用的 WIT 的名称拼写错误。
<CATEGORY name="Epic Category" refname="Microsoft.EpicCategory">
<DEFAULTWORKITEMTYPE name="EpicABC" />
</CATEGORY>
解决方法示例
<CATEGORY name="Epic Category" refname="Microsoft.EpicCategory">
<DEFAULTWORKITEMTYPE name="Epic" />
</CATEGORY>
TF402597:不支持自定义类别 [categoryName ] ,因为 ProcessConfiguration 不引用它。
只能在 ProcessConfiguration 中指定用于配置敏捷工具功能的自定义类别。
查看ProcessConfiguration.xml文件,并确定是否错过了添加对类别的支持。 否则,请从Categories.xml文件中删除 [categoryName]。
错误示例
ProcessConfiguration 不引用 Microsoft.EpicCategory,尽管它在Categories.xml定义文件中定义。
解决方法示例
PortfolioBacklog
添加到 ProcessConfiguration 以引用 Microsoft.EpicCategory。
<PortfolioBacklog category="Microsoft.EpicCategory" pluralName="Epics" singularName="Epic" workItemCountLimit="1000">
<States>
<State value="New" type="Proposed" />
<State value="Active" type="InProgress" />
<State value="Resolved" type="InProgress" />
<State value="Closed" type="Complete" />
</States>
<Columns>
<Column refname="System.WorkItemType" width="100" />
<Column refname="System.Title" width="400" />
<Column refname="System.State" width="100" />
<Column refname="Microsoft.VSTS.Scheduling.Effort" width="50" />
<Column refname="Microsoft.VSTS.Common.BusinessValue" width="50" />
<Column refname="Microsoft.VSTS.CMMI.RequirementType" width="100" />
<Column refname="System.Tags" width="200" />
</Columns>
<AddPanel>
<Fields>
<Field refname="System.Title" />
</Fields>
</AddPanel>
</PortfolioBacklog>
参考文章:
分类插件错误
Classification.xml定义文件必须符合分类插件中所述的语法和规则。
TF402511:分类插件包含重复的属性名称: [propertyName]。
错误示例
Classification.xml文件包含容器元素下properties
的第二property name="MSPROJ"
个语句。
<properties>
<property name="MSPROJ" value="Classification\FileMapping.xml" isFile="true" />
<property name="MSPROJ" value="Classification\Fabrikam_FileMapping.xml" isFile="true" />
<property name="Process Template" value="Fabrikam Agile"/>
</properties>
解决方法示例
删除重复语句。
<properties>
<property name="MSPROJ" value="Classification\Fabrikam_FileMapping.xml" isFile="true" />
<property name="Process Template" value="Fabrikam Agile"/>
</properties>
TF402512:文件 [fileName] 不存在。
Classification.xml 文件中指定的文件不在指定路径中,或者路径拼写错误。
错误示例
分类文件夹路径拼写错误。
<properties>
<property name="MSPROJ" value="Classification\Fabrikam_FileMapping.xml" isFile="true" />
<property name="Process Template" value="Agile"/>
</properties>
解决方法示例
<properties>
<property name="MSPROJ" value="Classification\Fabrikam_FileMapping.xml" isFile="true" />
<property name="Process Template" value="Fabrikam Agile"/>
</properties>
TF402513:分类插件中的名称 [pathName] 不符合 TreePath 命名限制。
Node
查看指定的元素并更改名称,使其符合支持命名约定。
参考: 添加和修改区域和迭代路径。
错误示例
路径名称包括不允许的 # 字符。
<Node StructureType="ProjectLifecycle" Name="Iteration" xmlns="">
<Children>
<Node StructureType="ProjectLifecycle" Name="Sprint #1" />
<Node StructureType="ProjectLifecycle" Name="Sprint #2" />
<Node StructureType="ProjectLifecycle" Name="Sprint #3" />
</Children>
</Node>
解决方法示例
路径名称已更正。
<Node StructureType="ProjectLifecycle" Name="Iteration" xmlns="">
<Children>
<Node StructureType="ProjectLifecycle" Name="Sprint 1" />
<Node StructureType="ProjectLifecycle" Name="Sprint 2" />
<Node StructureType="ProjectLifecycle" Name="Sprint 3" />
</Children>
</Node>
TF402514:不支持分类插件中的 Node StructureType [structureTypeName]。
该 StructureType
属性仅允许以下值: ProjectModelHierarchy
和 ProjectLifecycle
。
Node
查看已指定的元素并删除任何不受支持的属性。
错误示例
ProjectLifecycle
拼写错误。
<Node StructureType="ProjectLifecylce" Name="Iteration" xmlns="">
<Children>
<Node StructureType="ProjectLifecycle" Name="Sprint 1" />
<Node StructureType="ProjectLifecycle" Name="Sprint 2" />
<Node StructureType="ProjectLifecycle" Name="Sprint 3" />
</Children>
</Node>
解决方法示例
拼写错误的名称已被更正。
<Node StructureType="ProjectLifecycle" Name="Iteration" xmlns="">
<Children>
<Node StructureType="ProjectLifecycle" Name="Sprint 1" />
<Node StructureType="ProjectLifecycle" Name="Sprint 2" />
<Node StructureType="ProjectLifecycle" Name="Sprint 3" />
</Children>
</Node>
TF402515:分类插件中的属性属性缺失或不受支持。
该 property
元素仅允许以下属性: name
、 value
和 isFile
。
property
查看指定的元素并删除任何不受支持的属性。
错误示例
属性 value
拼写错误。
<properties>
<property name="MSPROJ" vaule="Classification\Fabrikam_FileMapping.xml" isFile="true" />
<property name="Process Template" value="Agile" />
</properties>
解决方法示例
已更正拼写错误的属性。
<properties>
<property name="MSPROJ" value="Classification\Fabrikam_FileMapping.xml" isFile="true" />
<property name="Process Template" value="Fabrikam Agile"/>
</properties>
TF402516:分类插件包含两个以上的根级别节点,不受支持。
Node
查看指定的元素并删除额外的根级别节点。
错误示例
Classification.xml文件包含容器元素下Nodes
的第二Node StructureType="ProjectLifecycle"
个语句。
<Nodes>
<Node StructureType="ProjectLifecycle" Name="Iteration" xmlns="">
<Children>
<Node StructureType="ProjectLifecycle" Name="Sprint 1" />
<Node StructureType="ProjectLifecycle" Name="Sprint 2" />
<Node StructureType="ProjectLifecycle" Name="Sprint 3" />
</Children>
</Node>
<Node StructureType="ProjectLifecycle" Name="Iteration" xmlns="">
<Node StructureType="ProjectModelHierarchy" Name="Area" xmlns="" />
</Nodes>
解决方法示例
删除第二个语句。
<Nodes>
<Node StructureType="ProjectLifecycle" Name="Iteration" xmlns="">
<Children>
<Node StructureType="ProjectLifecycle" Name="Sprint 1" />
<Node StructureType="ProjectLifecycle" Name="Sprint 2" />
<Node StructureType="ProjectLifecycle" Name="Sprint 3" />
</Children>
</Node>
<Node StructureType="ProjectModelHierarchy" Name="Area" xmlns="" />
</Nodes>
TF402523:GroupsandPermissions 插件中的区域或迭代路径“[pathName]”缺少分类插件。
将缺少 的 [pathName] 添加到Classification.xml文件,或将其从GroupsandPermissions.xml文件中删除。
错误示例
Classification.xml文件指定冲刺,而不是迭代。
teamSettings
GroupsandPermissions.xml指定迭代。
<teamSettings areaPath="Area">
<iterationPaths backlogPath="Iteration">
<iterationPath path="Iteration 1" />
<iterationPath path="Iteration 2" />
<iterationPath path="Iteration 3" />
</iterationPaths>
</teamSettings>
但是,Classification.xml指定冲刺。
<Node StructureType="ProjectLifecycle" Name="Iteration" xmlns="">
<Children>
<Node StructureType="ProjectLifecycle" Name="Sprint 1" />
<Node StructureType="ProjectLifecycle" Name="Sprint 2" />
<Node StructureType="ProjectLifecycle" Name="Sprint 3" />
</Children>
</Node>
解决方法示例
更新GroupsandPermissions.xml以使用冲刺。
<teamSettings areaPath="Area">
<iterationPaths backlogPath="Iteration">
<iterationPath path="Sprint 1" />
<iterationPath path="Sprint 2" />
<iterationPath path="Sprint 3" />
</iterationPaths>
</teamSettings>
链接类型
注意
当前导入过程中不支持自定义链接类型。
TF402561:已定义 [n] 自定义链接类型。 仅 允许 [nn] 。
查看所有元素语句的WorkItems.xml插件文件 LINKTYPE
。
删除与自定义链接类型关联的语句,以免超过允许的限制。
然后,从 LinkTypes 文件夹中删除相应的链接类型定义文件。
此外,请删除对已添加到节下FORM
某个节中的 LinksControlOptions
WIT 定义的自定义链接类型的任何引用。
TF402583:自定义链接类型 [name] 无效,因为不支持自定义链接类型。
查看所有元素语句的WorkItems.xml插件文件 LINKTYPE
。 删除指定自定义链接类型的任何语句。
然后,从 LinkTypes 文件夹中删除相应的链接类型定义文件。
WorkItems.xml插件文件中的以下 LINKTYPE
元素语句有效:
<LINKTYPES>
<LINKTYPE fileName="WorkItem Tracking\LinkTypes\Affects.xml" />
<LINKTYPE fileName="WorkItem Tracking\LinkTypes\SharedStep.xml" />
<LINKTYPE fileName="WorkItem Tracking\LinkTypes\TestedBy.xml" />
<LINKTYPE fileName="WorkItem Tracking\LinkTypes\SharedParameterLink.xml" />
</LINKTYPES>
全局列表
注意
当前导入过程功能不支持全局列表。
TF402564:已定义 [n] 全局列表。 仅 允许 [nn] 。
自定义进程模板中定义的一个或多个 WIT 包含一个 GLOBALLIST
元素。
搜索 WIT 定义文件,并将任何 GLOBALLIST
元素替换为 ALLOWEDVALUES
或 SUGGESTEDVALUES
元素。
有关参考语法,请参阅 “定义选取列表”。
TF402565:已在全局列表 [globalListName] 中定义 [n] 项。 最多 允许 [nn] 。
命名 GLOBALLIST
元素包含的项数超过允许的项。 减少元素中包含的 GLOBALLIST
列表项数,或将全局列表分段为两个或更多个元素,以便两个列表都不超过允许的最大项数。
有关参考语法,请参阅 “定义选取列表”。
进程配置
ProcessConfiguration.xml定义文件必须符合 ProcessConfiguration XML 元素引用中所述的语法和规则。
TF402543:元素 [elementName] 要求将一个工作流状态完全映射到 metastate [metastateName]。
States
更新ProcessConfiguration.xml文件中命名元素中的节,以提供缺失的元状态映射或删除额外的映射。
错误示例
RequirementBacklog
ProcessConfiguration.xml元素缺少元type="Proposed"
州映射。
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Backlog items" singularName="Backlog item">
<States>
<State value="Committed" type="InProgress" />
<State value="Done" type="Complete" />
</States>
. . .
</RequirementBacklog >
解决方法示例
添加了缺少元数据映射。
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Backlog items" singularName="Backlog item">
<States>
<State value="New" type="Proposed" />
<State value="Committed" type="InProgress" />
<State value="Done" type="Complete" />
</States>
. . .
</RequirementBacklog >
TF402547:元素 [elementName] 要求工作项类型 [witName] 至少将一个状态映射到 metastate [metastateName]。
WORKFLOW
查看为命名 WIT 定义的状态,然后更新States
ProcessConfiguration.xml文件中命名元素中的节,以提供命名 WIT 缺少的元状态映射。
TF402548:元素 [elementName] 要求将至少一个状态映射到 metastate [metastateName]。
States
更新ProcessConfiguration.xml文件中命名元素中的节,以提供缺少的元状态映射。
错误示例
RequirementBacklog
ProcessConfiguration.xml元素缺少元type="InProgress"
州映射。
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Backlog items" singularName="Backlog item">
<States>
<State value="New" type="Proposed" />
<State value="Done" type="Complete" />
</States>
. . .
</RequirementBacklog >
解决方法示例
添加了缺少元数据映射。
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Backlog items" singularName="Backlog item">
<States>
<State value="New" type="Proposed" />
<State value="Committed" type="InProgress" />
<State value="Done" type="Complete" />
</States>
. . .
</RequirementBacklog >
TF402550:元素 [elementName] 包含工作流状态 [stateName] 的多个元状态映射。
Metastate 值不能映射到多个工作流状态。
错误示例
RequirementBacklog
ProcessConfiguration.xml元素包含两个value="Active"
元州映射。
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="Story">
<States>
<State value="Active" type="Proposed" />
<State value="Active" type="InProgress" />
<State value="Resolved" type="InProgress" />
<State value="Closed" type="Complete" />
</States>
. . .
</RequirementBacklog >
解决方法示例
已更正元州映射。
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="Story">
<States>
<State value="New" type="Proposed" />
<State value="Active" type="InProgress" />
<State value="Resolved" type="InProgress" />
<State value="Closed" type="Complete" />
</States>
. . .
</RequirementBacklog >
TF402551:工作项类型 [witName] 不定义工作流状态 [stateName],这是必需的,因为 ProcessConfiguration 将其映射到元素 [elementName ] 的 metastate。
更正ProcessConfiguration.xml文件或 WORKFLOW
命名 WIT 部分以添加缺失 STATE
和 TRANSITION
元素。
错误示例
ProcessConfiguration.xml RequirementBacklog
元素指定 value="Committed"
,但UserStory.xml未将“提交”定义为状态。
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="Story">
<States>
<State value="New" type="Proposed" />
<State value="Committed" type="InProgress" />
<State value="Active" type="InProgress" />
<State value="Resolved" type="InProgress" />
<State value="Closed" type="Complete" />
</States>
. . .
</RequirementBacklog >
解决方法示例
删除了 Committed 的 State
元素。
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="Story">
<States>
<State value="New" type="Proposed" />
<State value="Active" type="InProgress" />
<State value="Resolved" type="InProgress" />
<State value="Closed" type="Complete" />
</States>
. . .
</RequirementBacklog >
TF402552:元素 [elementName] 要求为工作项类型 [witName] 将一个状态准确映射到以下状态的 metastate [metastateName] : [stateNames]。。
STATES
查看命名元素的 ProcessConfiguration.xml 文件中的部分,并确保错误消息中列出的每个 sate 都存在并映射到 metastate。
错误示例
RequirementBacklog
ProcessConfiguration.xml元素缺少工作项类型上User Story
存在的状态New
。 它应位于映射到type=Proposed"
的STATES
列表中。
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="Story">
<States>
<State value="Active" type="InProgress" />
<State value="Resolved" type="InProgress" />
<State value="Closed" type="Complete" />
</States>
. . .
</RequirementBacklog >
解决方法示例
已更正 Metastate 映射。
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="Story">
<States>
<State value="New" type="Proposed" />
<State value="Active" type="InProgress" />
<State value="Resolved" type="InProgress" />
<State value="Closed" type="Complete" />
</States>
. . .
</RequirementBacklog >
TF402554:元素 [elementName ] 指定不受支持的 metastate [metastateName]。
STATES
查看命名元素的 ProcessConfiguration.xml 文件中的节,并删除或更正命名的 metastate。
错误示例
RequirementBacklog
ProcessConfiguration.xml元素包含拼写错误的元州映射type=Proposed"
。
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="Story">
<States>
<State value="New" type="Propsed" />
<State value="Active" type="InProgress" />
<State value="Resolved" type="InProgress" />
<State value="Closed" type="Complete" />
</States>
. . .
</RequirementBacklog >
解决方法示例
已更正 Metastate 映射。
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="Story">
<States>
<State value="New" type="Proposed" />
<State value="Active" type="InProgress" />
<State value="Resolved" type="InProgress" />
<State value="Closed" type="Complete" />
</States>
. . .
</RequirementBacklog >
TF402571:进程配置中缺少必需的元素 [elementName]。
编辑ProcessConfiguration.xml文件以添加缺少的命名元素。
查看 所需元素的 ProcessConfiguration XML 元素引用 。
TF402572:在进程模板包中找不到指定文件。
zip 文件中缺少用于上传的插件文件中指定的文件。 查看为上传指定的所有文件,并确保它们包含在进程 zip 文件中。
查看 所需元素的 ProcessConfiguration XML 元素引用 。
TF402574:ProcessConfiguration 未指定必需的 TypeField
[typeField]。
编辑ProcessConfiguration.xml文件以添加缺少的命名 TypeField
元素。
查看所需TypeField
元素的 ProcessConfiguration XML 元素引用。
示例
Scrum 进程指定以下 TypeField
元素。 如果缺少其中任何一项,则会收到错误TF402574。
<TypeFields>
<TypeField refname="System.AreaPath" type="Team" />
<TypeField refname="Microsoft.VSTS.Scheduling.RemainingWork" type="RemainingWork" format="format h" />
<TypeField refname="Microsoft.VSTS.Common.BacklogPriority" type="Order" />
<TypeField refname="Microsoft.VSTS.Scheduling.Effort" type="Effort" />
<TypeField refname="Microsoft.VSTS.Common.Activity" type="Activity" />
<TypeField refname="Microsoft.VSTS.Feedback.ApplicationStartInformation" type="ApplicationStartInformation" />
<TypeField refname="Microsoft.VSTS.Feedback.ApplicationLaunchInstructions" type="ApplicationLaunchInstructions" />
<TypeField refname="Microsoft.VSTS.Feedback.ApplicationType" type="ApplicationType">
<TypeFieldValues>
<TypeFieldValue value="Web application" type="WebApp" />
<TypeFieldValue value="Remote machine" type="RemoteMachine" />
<TypeFieldValue value="Client application" type="ClientApp" />
</TypeFieldValues>
</TypeField>
</TypeFields>
TF402588:多个项目组合积压工作 [backlogNames] 已将 [backlogName] 定义为其父级。 父积压工作可能只有一个子积压工作。
只有一个子项目组合积压工作可以映射到单个父积压工作。
编辑 ProcessConfiguration 以更正父子积压工作规范。
错误示例
<PortfolioBacklog category="Microsoft.EpicCategory" parent="Microsoft.InitiativeCategory" pluralName="Epics" singularName="Epic">
...
</PortfolioBacklog>
<PortfolioBacklog category="Microsoft.FeatureCategory" parent="Microsoft.InitiativeCategory" pluralName="Features" singularName="Feature">
...
</PortfolioBacklog>
解决方法示例
将功能积压工作上的父级更改为指向 Epic 积压工作。
<PortfolioBacklog category="Microsoft.EpicCategory" parent="Microsoft.InitiativeCategory" pluralName="Epics" singularName="Epic">
...
</PortfolioBacklog>
<PortfolioBacklog category="Microsoft.FeatureCategory" parent="Microsoft.EpicCategory" pluralName="Features" singularName="Feature">
...
</PortfolioBacklog>
TF402589:项目组合积压工作 [backlogName] 引用未定义的父项目组合积压工作 [backlogName]。
ProcessConfiguration.xml定义包含引用 parent
未定义的项目组合积压工作的值。
错误示例
<PortfolioBacklog category="Microsoft.FeatureCategory" parent="Microsoft.EpicCategory" pluralName="Features" singularName="Feature">
解决方法示例
将 Epic PortfolioBacklog
添加到ProcessConfiguration.xml文件。
<PortfolioBacklog category="Microsoft.EpicCategory" pluralName="Epics" singularName="Epic">
<States>
<State value="New" type="Proposed" />
<State value="Active" type="InProgress" />
<State value="Resolved" type="InProgress" />
<State value="Closed" type="Complete" />
</States>
<Columns>
<Column refname="System.WorkItemType" width="100" />
<Column refname="System.Title" width="400" />
<Column refname="System.State" width="100" />
<Column refname="Microsoft.VSTS.Common.BusinessValue" width="50" />
<Column refname="Microsoft.VSTS.CMMI.RequirementType" width="100" />
<Column refname="System.Tags" width="200" />
</Columns>
</PortfolioBacklog>
TF402590:多个项目组合积压工作 [积压工作 1, 积压工作 2] 不定义其父级。
只有一个项目组合积压工作(顶级积压工作)可能没有父母。 所有其他积压工作都必须包括一个 parent="Microsoft.FooCategory"
特性和值。
解决方法示例
<PortfolioBacklog category="Microsoft.FeatureCategory" parent="Microsoft.EpicCategory" pluralName="Features" singularName="Feature">
402595:定义了过多的项目组合积压工作。 最多允许 5 个。
编辑ProcessConfiguration.xml文件以从PortfolioBacklogs
节中删除额外的PortfolioBacklog
元素。
有关详细信息,请查看 ProcessConfiguration XML 元素参考 。
TF400506:此元素定义表示 Bug 或缺陷的工作项的状态。
如果分区配置错误,则会发生 BugWorkItems
此错误。
为工作项类型 Microsoft.BugCategory
定义的每个状态都必须存在于节中 BugWorkItems
定义的状态值集中。 例如,如果为 Bug 工作项类型(新建、已批准、已提交、已完成)定义的工作项类型定义了以下状态,BugWorkItems
则应按如下所示配置该节:
<BugWorkItems category="Microsoft.BugCategory" pluralName="Bugs" singularName="Bug">
<States>
<States>
<State value="New" type="Proposed" />
<State value="Approved" type="Proposed" />
<State value="Committed" type="InProgress" />
<State value="Done" type="Complete" />
</States>
</BugWorkItems>
有关详细信息,请参阅 ProcessConfiguration XML 元素参考。
TF400507:每个工作项类型必须支持一个初始状态值,该值与在:BugWorkItems 中定义的状态之一匹配。
当包含在 ProcessConfiguration XML 文件的节中包含的 Microsoft.BugCategory
工作项类型指定初始状态 BugWorkItems
时,会发生此错误。 修复命名工作项类型的 XML 定义工作流状态,或更新 BugWorkItems
节以包含缺失状态(s)。
有关详细信息,请参阅 ProcessConfiguration XML 元素参考。
TF400572:必须为使用此功能配置项目进程设置。
这是由来自 TFS 2010 或更早版本的模板在项目进程设置存在之前造成的。 尝试在升级后运行“配置”功能以解析,或将 ProcessConfiguration XML 文件添加到进程模板。
工作项类型
TF402570:已定义 [n] 工作项类型。 最多 允许 [witLimit] 。
你定义了在此过程中允许的更多 WIT。 查看WorkItems.xml文件,减少它包含的 WORKITEMTYPE
语句数,并从进程中删除关联的 WIT 定义文件。
TF402573:工作项类型 WIT 未指定必需的 refname
属性。
工作项类型(Bug、用户情景、任务等)需要属性 refname
。 refname 值必须是唯一的,并且不能包含任何保留的命名空间。
namespaces-System。XXX 和 Microsoft.VSTS。XXX 由 Azure DevOps 保留。
有关详细信息,请参阅 所有 WITD XML 元素参考 。
错误示例
<WORKITEMTYPE name="Bug">
解决方法示例
<WORKITEMTYPE name="Bug" refname="MyCompany.Bug">
TF402599:工作项类型 refname [refName] 无效,因为它使用不允许的命名空间 [namespace]。
自定义字段和 WIT 的引用名称不能使用保留命名空间:系统。XXX 和 Microsoft.VSTS。XXX.
refname
编辑命名 WIT 的属性。
错误示例
<FIELD name="Custom Field" refname="Microsoft.VSTS.CustomField" type="String" />
解决方法示例
<FIELD name="Custom Field" refname="*CustomNamespace.CustomField*" type="String" />
TF402600:工作项类型引用名称 [refName] 无效。 工作项类型引用名称必须仅包含字母、无空格和至少一个句点(.)
WIT 引用名称必须遵循已建立的命名约定:仅字母、无空格和至少一个句点(.)
refname
编辑命名 WIT 的属性以满足命名要求。
错误示例
<WORKITEMTYPE name="Bug" refname="MyCompanyBug32">
解决方法示例
<WORKITEMTYPE name="Bug" refname="MyCompany.Bug">
工作项字段
TF402538:不支持字段规则 [ruleName]。
编辑 WIT 定义以删除命名规则。
导入到 Azure DevOps 不支持以下规则:MATCH
、CANNOTLOSEVALUE
、PROHIBITEDVALUES
和NOTSAMEAS
。
TF402539:字段 [refName] 仅允许以下规则: [ruleNames]。
编辑命名字段的 WIT 定义,并删除任何不允许的规则。 查看这两FIELDS
个部分。WORKFLOW
大多数系统字段都不允许指定规则。
用于系统字段的有效规则
名称 | 允许的规则 |
---|---|
System.Title | REQUIRED , DEFAULT |
System.Description | REQUIRED , DEFAULT |
System.AssignedTo | REQUIRED 、、DEFAULT ALLOWEXISTINGVALUE 、、VALIDUSER |
System.ChangedBy | REQUIRED 、、DEFAULT ALLOWEXISTINGVALUE 、、VALIDUSER |
TF402540:工作项类型 [witName] 无效,因为它指定全局列表 [GLOBALLIST]。 不支持全局列表。
VSTS 不支持全局列表。
将所有元素实例 GLOBALLIST
替换为 ALLOWEDVALUES
所有 WIT 定义文件中的元素和 LISTITEM
元素。
参考: 定义选取列表。
错误示例
<FIELD name="CustomField" refname="MyCompany.CustomField" type="String">
<ALLOWEDVALUES>
<GLOBALLIST name="Disciplines" />
</ALLOWEDVALUES>
</FIELD>
解决方法示例
<FIELD name="CustomField" refname="MyCompany.CustomField" type="String">
<ALLOWEDVALUES>
<LISTITEM value="Architecture" />
<LISTITEM value="Requirements" />
<LISTITEM value="Development" />
<LISTITEM value="Release Management" />
<LISTITEM value="Project Management" />
<LISTITEM value="Test" />
</ALLOWEDVALUES>
</FIELD>
TF402541:工作项类型 [witName] 无效,因为它引用全局列表 [globalListName]。 不支持全局列表。
VSTS 不支持全局列表。 将所有元素实例 GLOBALLIST
替换为 ALLOWEDVALUES
所有 WIT 定义文件中的元素和 LISTITEM
元素。
参考: 定义选取列表。
错误示例
<FIELD name="CustomField" refname="MyCompany.CustomField" type="String">
<ALLOWEDVALUES>
<GLOBALLIST name="Disciplines" />
</ALLOWEDVALUES>
</FIELD>
解决方法示例
<FIELD name="CustomField" refname="MyCompany.CustomField" type="String">
<ALLOWEDVALUES>
<LISTITEM value="Architecture" />
<LISTITEM value="Requirements" />
<LISTITEM value="Development" />
<LISTITEM value="Release Management" />
<LISTITEM value="Project Management" />
<LISTITEM value="Test" />
</ALLOWEDVALUES>
</FIELD>
TF402542:自定义字段 refname [refName] 无效,因为它使用不允许的命名空间 [namespace ]。
namespaces-System。XXX 和 Microsoft.VSTS。在 VSTS 中保留 XXX。 自定义字段和类型的引用名称不能使用这些命名空间。
若要修复此错误,请重命名 refname
WIT 定义文件中出现的命名字段的属性。
错误示例
<FIELD name="CustomField" refname="System.CustomField" type="String" />
- OR -
<FIELD name="CustomField" refname="Microsoft.VSTS.CustomField" type="String" />
解决方法示例
<FIELD name="CustomField" refname="MyCompany.CustomField" type="String" />
TF402544:在工作项类型 [witName] 中定义的字段 [refName],需要包含ALLOWEDVALUES
值的规则来支持 ProcessConfiguration 中指定的元素 [elementName]。
编辑命名 WIT 中的命名字段以提供缺失 ALLOWEDVALUES
的规则,并引用命名元素以获取更多详细信息。
ProcessConfiguration.xml文件元素 TypeField refname="Microsoft.VSTS.Common.Activity" type="Activity"
需要为属于任务类别的所有 WIT 中的 Microsoft.VSTS.Common.Activity 字段定义选取列表。
<TypeField refname="Microsoft.VSTS.Common.Activity" type="Activity" />
如果已将 bug 添加到任务类别,则必须确保Bug.xml文件包含命名字段,并指定与在Task.xml文件中定义的相同选取列表。
错误示例
Bug.xml定义了字段,但未定义选取列表。
<FIELD name="Activity" refname="Microsoft.VSTS.Common.Activity" type="String" reportable="dimension">
<HELPTEXT>Type of work involved</HELPTEXT>
</FIELD>
解决方法示例
更正Bug.xml
<FIELD name="Activity" refname="Microsoft.VSTS.Common.Activity" type="String" reportable="dimension">
<HELPTEXT>Type of work involved</HELPTEXT>
<SUGGESTEDVALUES>
<LISTITEM value="Development"/>
<LISTITEM value="Testing"/>
<LISTITEM value="Requirements"/>
<LISTITEM value="Design"/>
<LISTITEM value="Deployment"/>
<LISTITEM value="Documentation"/>
</SUGGESTEDVALUES>
</FIELD>
TF402545:元素 [elementName] 要求在工作项类型 [witName] 的定义中包含字段 [fieldName]。
应在命名 WIT 定义中包含一个相应的FIELD
元素,用于在ProcessConfiguration.xml文件的节中指定的AddPanel
每个field
元素。
还应在命名 WIT 的节中包含FORM
一个Control
元素。
错误示例
ProcessConfiguration.xml指定两个自定义字段。 但是,这些字段未在UserStory.xml文件中定义。
<AddPanel>
<Fields>
<Field refname="System.Title" />
<Field refname="Fabrikam.Product" />
<Field refname="Fabrikam.Technology" />
</Fields>
</AddPanel>
解决方法示例
缺少 FIELD
添加到UserStory.xml文件的元素。
<FIELD name="Product" refname="Fabrikam.Product" type="String" reportable="dimension">
<FIELD name="Technology" refname="Fabrikam.Technology" type="String" reportable="dimension">
若要支持 ProcessConfiguration 元素 [elementName],工作项类型 [witName] 必须定义 TypeField [typeField] (field refname [refName])。
在 ProcessConfiguration 中创建的 TypeField
with TypeFieldValues
. 在工作项类型中,必须引用同一项 TypeField
。
错误示例
ProcessConfiguration.xml
<TypeField refname="Custom.ApplicationType" type="ApplicationType">
<TypeFieldValues>
<TypeFieldValue value="Web application" type="WebApp" />
<TypeFieldValue value="Remote machine" type="RemoteMachine" />
<TypeFieldValue value="Client application" type="ClientApp" />
</TypeFieldValues>
</TypeField>
FeedbackRequest.xml在使用 Custom.ApplicationType 字段时,将使用 Microsoft.VSTS.Feedback.ApplicationType 字段。
<FIELD name="Application Type" refname="Microsoft.VSTS.Feedback.ApplicationType" type="String">
...
</FIELD>
解决方法示例
FeedbackRequest.xml
<FIELD name="Application Type" refname="Custom.ApplicationType" type="String">
...
</FIELD>
TF402556:要正确定义字段 [refName] ,必须将其 命名为 [fieldName] ,并将其类型设置为 [fieldType]。 提供的 [refName] 为 [fieldName] 且类型为 [fieldType]。
如果位于本地服务器并运行 tfsMigrator,则当进程过期且系统字段未正确定义时,通常会生成此错误。 在大多数情况下,需要使用 witadmin /changefield
命令来正确重命名字段。
保留字段的示例
保留系统。XXX 和 Microsoft.VSTS。XXX 字段具有必需的名称和类型值。
字段 | 名称 | 类型 |
---|---|---|
System.Id | ID | Integer |
System.Title | 标题 | 字符串 |
Microsoft.VSTS.Schedule.StoryPoints | 故事点 | 双精度 |
Microsoft.VSTS.Schedule.RemainingWork | 剩余工作 | 双精度 |
Microsoft.VSTS.Schedule.OriginalEstimate | 原始估算 | 双精度 |
Microsoft.VSTS.Schedule.CompletedWork | 已完成工作 | 双精度 |
错误示例
TF402556:要正确定义字段Microsoft.VSTS.TCM.ReproSteps,必须将其命名为“重现步骤”并将其类型设置为 HTML。 提供的 Microsoft.VSTS.TCM.ReproSteps 是“我的重现步骤”,类型为 HTML。
在Bug.xml中,友好字段名称已更改为“我的重现步骤”。
<FIELD name="My Repro Steps" refname="Microsoft.VSTS.TCM.ReproSteps" type="HTML">
<HELPTEXT>How to see the bug. End by contrasting expected with actual behavior.</HELPTEXT>
</FIELD>
解决方法示例
Bug.xml
<FIELD name="Repro Steps" refname="Microsoft.VSTS.TCM.ReproSteps" type="HTML">
<HELPTEXT>How to see the bug. End by contrasting expected with actual behavior.</HELPTEXT>
</FIELD>
TF402557:以下工作项类型中存在字段 [refName] 的不一致定义: [witName]。 确保对字段的所有引用具有相同的 RefName、 Name 和 Type。
FIELD
具有相同友好名称的字段的元素定义必须在 WIT 中保持一致。
检查以确保refname
命名字段的每个 WIT 定义中的和name
type
属性相同。
错误示例
Bug.xml
<FIELD name="Hair Color" refname="MyCompany.CustomFields.HairColor" type="String" reportable="dimension" />
UserStory.xml
<FIELD name="Hair Color 2" refname="MyCompany.CustomFields.HairColor" type="Double" reportable="dimension" />
请注意,Bug.xml name
工作项类型中的属性和 type
属性不同
解决方法示例
Bug.xml
<FIELD name="Hair Color" refname="MyCompany.CustomFields.HairColor" type="String" reportable="dimension" />
UserStory.xml
<FIELD name="Hair Color" refname="MyCompany.CustomFields.HairColor" type="String" reportable="dimension" />
TF402558:字段 [refName] 的定义与以下模板中字段的现有定义不一致: [templateNames]。
必须在已导入到 Azure DevOps Services 的流程中一致地定义字段。
系统不允许导入一个进程, FIELD
其中包含在进程 A 中以一种方式定义的元素,在进程 B 中以另一种方式定义。所有 FIELD
元素属性必须匹配。
示例
处理 A、Bug.xml
<FIELDS>
...
<FIELD name="Foo" refname="MyCompany.CustomFields.Foo" type="String" reportable="dimension" />
...
</FIELDS>
进程 B,Bug.xml
<FIELDS>
...
<FIELD name="Bar" refname="MyCompany.CustomFields.Foo" type="Double" reportable="dimension" />
...
</FIELDS>
请注意如何为 name
属性指定不同的值和 type
属性。
解决方法
确保在同一进程的所有进程中都定义相同的 refname
字段
已导入或计划导入到 Azure DevOps Services。
TF402559:字段 [refName] 的定义与现有字段不一致。 为 type
[typeName] ,但应为 [typeName]。
编辑包含命名字段的 WIT 文件,以确保指定 type
属性值在所有 WIT 中保持一致。
TF402562:已为工作项类型 [witName] 定义 [n] 字段。 仅 允许 [fieldLimit] 。
已为工作项类型 [witName] 定义 [n] 字段。 仅 允许 [fieldLimit] 。 在单个 WIT 中,只能指定指定的字段数。
编辑命名的 WIT 并删除额外的自定义字段,以减少允许限制内的字段总数。
TF402563:已为所有工作项类型定义 总共 [n] 字段。 仅 允许 [fieldLimit] 。
你已为进程中定义的所有 WIT 定义了 [n] 字段。 仅 允许 [fieldLimit] 。 这包括系统。XXX 和 Microsoft.VSTS。XXX 命名空间字段和自定义字段。
FIELDS
查看和WORKFLOW
节并确定要删除的自定义字段。
TF402566:已为工作项类型 [witName] 定义 [n] 字段规则。 允许的最大 [ruleLimit] 。
你已为命名 WIT 定义了 [n] 字段规则,该规则超出了任何一个 WIT 允许的字段规则数。
编辑命名的 WIT 并删除额外的字段规则,以减少允许限制内的字段总数。
TF402568:已为工作项类型 [witName] 定义 [syncnamechanges="true"
n] 字段。 最多允许 64 个。
为命名 WIT 定义的字段 syncnamechanges="true"
数超过了允许的限制。 这包括系统。XXX 和 Microsoft.VSTS。XXX 命名空间字段和自定义字段。
FIELDS
查看命名 WIT 的节,并确定要删除或修改的自定义字段。
示例
<FIELD name="Assigned To" refname="System.AssignedTo" type="String" reportable="dimension" syncnamechanges="true" >
...
</FIELD>
TF402569:已在工作项类型 [witName] 中为字段 [fieldName] 定义 [n] 值。 最多 允许 [listLimit] 。
为命名 WIT 中命名字段定义的元素数 LISTITEM
超过了允许的限制。
编辑命名的 WIT 以减少元素数,以免超出允许的LISTITEM
最大值。
示例
<FIELD name="Favorite Color" refname="MyCompany.CustomFields.FavColor" type="String" reportable="dimension">
<ALLOWEDVALUES>
<LISTITEM value="Color1" />
<LISTITEM value="Color2" />
<LISTITEM value="Color3" />
. . .
</ALLOWEDVALUES>
</FIELD>
请注意,bug 和用户情景 refname
值不同。
TF402584:不支持字段规则属性“for”或“not”。
任何导入到 Azure DevOps Services 的字段规则都不支持此属性 "for"
和 "not"
属性。
FIELDS
查看和WORKFLOW
部分是否存在"for"
属性并"not"
删除它们。
错误示例
<FIELD name="Title">
<READONLY for="Dev Team" not="Test Team" />
</FIELD>
解决方法示例
<FIELD name="Title">
<READONLY />
</FIELD>
TF402593:字段 [fieldName]不支持字段规则。
大多数 System 和 Microsoft.VSTS 字段不支持规则。 有关支持字段规则的完整列表,请参阅 规则和规则评估 。
编辑包含命名字段的工作项类型的定义文件,并删除为其指定的字段规则。
TF402602:字段 [refName] 必须恰好具有这些值 [values ]。
由保留命名空间-系统中的 VSTS 定义的所有字段。XXX 和 Microsoft.VSTS。不得更改 XXX。 如果要在这些选取列表字段中具有不同的值列表,请定义自己的自定义字段。
错误示例
Bug.xml定义了优先级字段,但值列表与预期值列表不同。
<FIELD name="Priority" refname="Microsoft.VSTS.Common.Priority" type="Integer" reportable="dimension">
<ALLOWEDVALUES expanditems="true">
<LISTITEM value="0"/>
<LISTITEM value="1"/>
<LISTITEM value="2"/>
</ALLOWEDVALUES>
<DEFAULT from="value" value="2" />
</FIELD>
解决方法示例
更正Bug.xml包括新字段
<FIELD name="Priority" refname="Microsoft.VSTS.Common.Priority" type="Integer" reportable="dimension">
<HELPTEXT>Business importance. 1=must fix; 4=unimportant.</HELPTEXT>
<ALLOWEDVALUES expanditems="true">
<LISTITEM value="1"/>
<LISTITEM value="2"/>
<LISTITEM value="3"/>
<LISTITEM value="4"/>
</ALLOWEDVALUES>
<DEFAULT from="value" value="2" />
</FIELD>
<FIELD name="Custom Priority" refname="Custom.Priority" type="Integer" reportable="dimension">
<HELPTEXT>Business importance. 1=must fix; 4=unimportant.</HELPTEXT>
<ALLOWEDVALUES expanditems="true">
<LISTITEM value="0"/>
<LISTITEM value="1"/>
<LISTITEM value="2"/>
</ALLOWEDVALUES>
<DEFAULT from="value" value="2" />
</FIELD>
VS402504:找不到 用户或组 [project]\Group Name。 验证工作项类型定义中使用的用户和组是否存在。
不支持自定义项目范围组。 只能引用帐户级别的作用域组。
错误示例
Bug.xml引用项目范围组。
... "[project]\Organization Leaders"
解决方法示例
创建新的帐户(集合)级别组“组织领导”,并在 XML 中相应地引用它。
... "[global]\Organization Leaders"
注意
在导入过程找到之前,新创建的全局组可能需要一些时间。
TF237094:字段“[fieldName]”使用字段名称“[fieldName]”,因此不能由字段“[refName]”使用。
字段名称已存在于其他字段中具有相同名称。 更改字段的名称。
错误示例
TF237094: Field name 'External ID' is used by the field 'Custom.ExistingField.ExternalID', so it cannot be used by the field 'Custom.NewField.ExternalID'.
解决方法示例
更改 Custom.NewField.ExternalID 的字段名称
<FIELD name="External ID" refname="Custom.NewField.ExternalID" type="string" reportable="dimension" />
工作项布局
VS403104:工作项类型 [witName] 引用所有布局中不包含的必需字段 [refName]。
如果在节点中 <Layout>
引用的工作项类型中具有必需字段,但未引用该字段, <WebLayout>
则会生成此警告。 用于 <WebLayout>
修改新窗体的布局。 有关详细信息,请参阅 WebLayout xml 参考 。
VS403073:组和 <Group Name>
:违反规则,即组只能包含标签控件之前的单个 HTML 或 WebPage 控件。
在新窗体布局中,组只能包含一个 HTMLFieldControl 或 WebPageControl。
错误示例
<Section>
<Group Label="Description:">
<Control Label="Reason For Request:" Type="HtmlFieldControl" FieldName="System.Description" />
<Control Label="Business Case For Request:" Type="HtmlFieldControl" FieldName="MB.BusinessCase" />
</Group>
</Section>
若要解决此问题,请创建两个单独的组,每个组包含一个控件。
解决方法示例
<Section>
<Group Label="Reason for Request">
<Control Label="Reason For Request:" Type="HtmlFieldControl" FieldName="System.Description" />
</Group>
<Group Label="Business Case">
<Control Label="Business Case For Request" Type="HtmlFieldControl" FieldName="Custom.BusinessCase" />
</Group>
</Section>
TF402594:文件违反架构并出现以下错误:元素“Control”不能包含子元素“Link”,因为父元素的 con帐篷模式l 为空。
错误示例
<Control Type="FieldControl" FieldName="customfield.foo" Label="Foo" LabelPosition="Left">
<Link UrlRoot="http://www.visualstudio.microsoft.com/team-services/" />
</Control>
解决方法示例
<Control Type="FieldControl" FieldName="System.Title" LabelPosition="Left" Label="Title 1"
<LabelText>
<Text>
<Link UrlRoot="http://www.visualstudio.microsoft.com/team-services/" />
Title 2
</Text>
</LabelText>
</Control>
工作流定义
TF402567:已为工作项类型 [witName] 定义 [n] 工作流状态。 允许的最大 [stateLimit] 。
已为命名 WIT 定义了 [n] 工作流状态,该状态超过了任意一个 WIT 允许的工作流状态数。
WORKFLOW
编辑命名 WIT 的节并删除额外的STATE
元素,以减少允许的限制内的状态总数。
TF402578:字段 [refName] 指定已由字段 [refName] 使用的友好名称 [friendlyName]。 在所有字段定义中,友好名称必须是唯一的。
字段名称在工作项类型中必须是唯一的。
错误示例
<FIELD name="Foo" refname="MyCompany.CustomFields.Foo" type="String" reportable="dimension" />
<FIELD name="Foo" refname="MyCompany.CustomFields.Bar" type="String" reportable="dimension" />
请注意,有两个具有名称的字段 <FIELD name="Foo"
解决方法示例
<FIELD name="Foo" refname="MyCompany.CustomFields.Foo" type="String" reportable="dimension" />
<FIELD name="Bar" refname="MyCompany.CustomFields.Bar" type="String" reportable="dimension" />
TF402579: 名称 [friendlyName] 在以下工作项类型的不同字段中多次使用: [witNames]。 字段的名称在项目集合中必须是唯一的。
引用相同的 refname="MyCompany.FieldName"
字段必须具有相同的友好名称 FIELD name="fieldname"
值。
错误示例
处理 A、Bug.xml
<FIELD name="Foo" refname="MyCompany.CustomFields.Foo" type="String" reportable="dimension" />
进程 B,Bug.xml
<FIELD name="Bar" refname="MyCompany.CustomFields.Foo" type="String" reportable="dimension" />
由于这两个字段共享相同的引用名称, refname="MyCompany.CustomFields.Foo"
因此它们还必须在导入或将导入到 Azure DevOps Services 的所有进程中指定相同的友好名称 <FIELD name="Foo"
。
TF402580:只能对单个工作项类型使用名称 [witName]。
WIT 友好名称 WORKITEMTYPE name="Name"
在进程中必须是唯一的。
错误示例
我的工作项A.xml
<WORKITEMTYPE name="My Work Item" refname="My.MyWorkItemA">
我的工作项B.xml
<WORKITEMTYPE name="My Work Item" refname="My.MyWorkItemB">
请注意这 WORKITEMTYPE name=
两种工作项类型的相同。
解决方法示例
我的工作项A.xml
<WORKITEMTYPE name="My Work Item A" refname="My.MyWorkItemA">
我的工作项B.xml
<WORKITEMTYPE name="My Work Item B" refname="My.MyWorkItemB">
TF402581:只能将 refname [refName] 用于单个工作项类型。
WIT 引用名称 refname="value"
必须在进程中是唯一的。
错误示例
Bug.xml
<WORKITEMTYPE name="Bug" refname="MyCompany.Name">
UserStory.xml
<WORKITEMTYPE name="User Story" refname="MyCompany.Name">
请注意这两个 refname
值都等于“MyCompany.Name”
解决方法示例
Bug.xml
<WORKITEMTYPE name="Bug" refname="MyCompany.Bug">
UserStory.xml
<WORKITEMTYPE name="User Story" refname="MyCompany.UserStory">
TF402582:工作项类型 [witName] 包含不支持的自定义控件 [controlName]。
Azure DevOps Services 不支持自定义控件。 FORM
查看命名 WIT 的部分,并删除已定义的任何自定义控件。
错误示例
Type="OneViewMultiValueControl"
指定自定义控件。 必须将其删除或替换为受支持的控件。
<Group Label="Engineering Alignment">
<Column PercentWidth="100">
<Control FieldName="Fabrikam.Content.Product" Type="FieldControl" Label="Product" LabelPosition="Left" />
<Control FieldName="Fabrikam.Content.Release" Type="FieldControl" Label="Milestone" LabelPosition="Left" />
<Control FieldName="Fabrikam.Content.Technology" Type="FabrikamMultiValueControl" Label="Technology" LabelPosition="Left" />
</Column>
</Group>
测试管理插件错误
位于“测试管理”文件夹中的TestManagement.xml文件必须符合“定义测试管理器的初始配置”中所述的语法和规则。
TF402533:TestManagement 插件中的元素“[elementName]”缺少 'fileName'
该属性。
将缺少的属性添加到TestManagement.xml文件中的命名元素。
TF402534:TestManagement 插件包含不受支持的任务“[taskName]”
更正TestManagement.xml文件中的命名任务。
错误示例
元素 TestResolutionStates
拼写错误。
<taskXml>
<TestResolutionSattes fileName="Test Management\TestResolutionState.xml" />
</taskXml>
解决方法示例
更正了拼写错误。
<taskXml>
<TestResolutionStates fileName="Test Management\TestResolutionState.xml" />
</taskXml>