工作项跟踪对象的命名约定

所有工作项跟踪对象都与一个或多个名称关联。大多数对象都具有友好显示名称,并且除工作项类型和全局列表之外的所有对象都与引用名称关联。友好名称就是字段的唯一、用户可见的标识符,用于确保在一个项目集合中所有团队项目和工作项类型间的一致性。引用名称由 Team Foundation Server 在内部使用,定义之后无法进行更改。

下表总结了每个工作项跟踪对象必须满足的命名要求。

工作项跟踪对象

引用名称

友好名称

工作项类型

不适用

每个工作项类型的名称最长可为 255 个 Unicode 字符,在一个团队项目中必须唯一。

工作项字段

必选。请参见引用名称要求。

字段名称最长可为 128 个 Unicode 字符,在一个团队项目集合中必须唯一。

链接类型

必选。请参见引用名称要求。

可为每个链接类型定义两个友好名称:前向名称和反向名称。这些名称最长可为 128 个 Unicode 字符,对于为一个团队项目集合定义的所有链接类型必须唯一。

类别

必选。请参见引用名称要求。

类别友好名称最长可为 128 个 Unicode 字符,在一个团队项目中必须唯一。

全局列表

不适用

每个全局列表的名称最长可为 254 个 Unicode 字符,在一个团队项目集合中必须唯一。

主题内容

  • 友好名称要求

  • 引用名称要求

  • 字段引用名称和可移植性要求

  • 字段引用名称示例

友好名称要求

除了在本主题前面列出的表中总结的要求外,所定义的友好名称还应满足以下要求:

  • 名称不能是空的。

  • 名称不能有前导空白或尾随空白。

  • 名称不能包含反斜杠 (\) 字符。

  • 字段名称不能包含以下字符:反斜杠 (\)、句点 (.) 以及左方括号和右方括号 ([])。

  • 名称不能包含两个或更多连续空格。

引用名称要求

每当添加或创建工作项字段、链接类型或类别时,都必须定义引用名称。所有引用名称最长可为 70 个 Unicode 字符。

可以使用字母数字字符、下划线字符和连字符来定义引用名称。每个引用名称必须至少包含一个句点 (.),但不能以句点作为名称的开头或结尾。引用名称不能以数字或下划线开头,而且不能包含多个连续的连字符,例如 (--)。

字段引用名称和可移植性

工作项类型定义语言包括“字段引用名称”的概念。字段引用名称可帮助您在 Team Foundation 项目集合之间移植定义,还允许第三方集成查找和引用特定字段。这些名称是全局唯一的,正如 .NET Framework 应用程序中的命名空间是全局唯一的一样。

不能对字段引用名称进行重命名。例如,如果您将字段名称“Title”更改为“Header”,则该字段的字段引用名称将保持不变。字段的集成和内部表示形式应使用字段引用名称,而不是取决于字段名称本身。

System 命名空间仅用于定义 Team Foundation 系统功能所必需的所有核心系统字段。Team Foundation Server 禁止您创建自己的 System.X 字段,因为这可能会影响 Team Foundation Server 的功能。

Microsoft 命名空间用于定义在 Microsoft Solutions Framework (MSF) 过程模板的工作项类型定义中定义的字段。但 Team Foundation Server 并不禁止您创建自己的 Microsoft.X 字段。然而,强烈建议不要采用此做法,因为这可能会影响 Team Foundation Server 的功能

客户和合作伙伴可以为自定义工作项类型创建自己的字段命名空间。

有关系统字段以及由 MSF for Agile Software Development 5.0 版定义的字段的说明,请参见工作项字段参考 (Visual Studio ALM)

字段引用名称示例

下面的示例演示各个命名空间中有效的字段引用名称。

ms194941.collapse_all(zh-cn,VS.110).gif系统命名空间示例

System.Id

System.Title

System.CreatedBy

System.CreationDate

System.ChangedBy

System.ChangedDate

System.State

System.Reason

ms194941.collapse_all(zh-cn,VS.110).gifMicrosoft 命名空间示例

Microsoft.Common.Status

Microsoft.Common.Priority

Microsoft.Scheduling.Duration

Microsoft.Scheduling.PercentComplete

Microsoft.Testing.TestCaseName

ms194941.collapse_all(zh-cn,VS.110).gif其他命名空间中的示例

客户和合作伙伴也可以定义自己的命名空间,以支持他们的自定义工作项类型。例如,虚拟公司 Trey Research 可能会定义以下自定义工作项类型:

TreyResearch.Common.Severity

TreyResearch.Common.Phase

TreyResearch.RiskManagement.RiskType

TreyResearch.RiskManagement.Resolution

虚构的软件公司 A.Datum Corporation 可能会定义以下工作项类型:

A_Datum.Common.BusinessPriority

A_Datum.Bug.FoundInPhase

A_Datum.Bug.FixInPhase

请参见

参考

FIELD(定义)元素

概念

自定义项目跟踪数据、窗体、工作流及其他对象