Team Foundation 中的命名限制

Visual Studio Team Foundation Server (TFS) 中许多组件的命名都具有特定的限制。 这些限制有助于保证一致的用户体验,并提供与其他程序的兼容性。 这些限制可包括长度、特殊字符、唯一性或其他特性。

本主题包含以下小节:

服务器、集合、帐户、组和计算机名称限制:

  • 一般注意事项

  • TFS 帐户名称

  • TFS 组帐户名称

  • 计算机名称

  • 团队项目集合名称

项目和工作项跟踪名称限制:

  • 团队项目名称

  • 团队名称

  • 工作项

  • 工作项自定义

  • 过程模板

生成和代码名称限制:

  • Team Foundation 版本控制

  • Team Foundation Build

一般注意事项

本主题中的长度限制表示为允许的 Unicode 字符的数量。 有关 Unicode 的详细信息,请参见“关于 Unicode 和字符集”(https://go.microsoft.com/fwlink/?LinkId=76837)。 代理项字符由两个 Unicode 字符组成,长度限制中会将其算作两个字符。

与其他操作系统文件一样,还禁止 ASCII 控制字符 (ASCII 1-31) 和代理项的组合形式。 有关应用于文件名的操作系统限制的常规信息,请参阅命名文件、路径和命名空间

Team Foundation Server 帐户名称限制

用户帐户可标识 TFS 中的用户。 这些帐户可能是 Windows 用户帐户、Active Directory 帐户或其他帐户类型。 如果你需要如何将用户添加到在 TFS、SharePoint 产品和 SQL Server Reporting Services 中使用的组的示例,请参阅向团队项目添加用户.

将用户添加到 TFS 时,该用户名必须遵循特定的 Team Foundation Server 限制。 下表描述了这些限制。

限制类型

限制

帐户名称长度

  • 不能超过 256 个 Unicode 字符

唯一性

  • 不得与 TFS 中任何其他帐户名称相同

保留的组名

  • 项目和服务器级别上都不能命名为 $NAMESPACE

特殊字符限制

  • 不得包含以下可打印字符:"/ \ [ ] : | < > + = ; ? *

  • 不能包含 ASCII 值在 1-31 范围内的不可打印字符

  • 不能以句点 (.) 结束

  • 不能包含逗号 (,)

  • 不得包含以下 Unicode 类别:LineSeparator、ParagraphSeparator、Control、Format、OtherNotAssigned

备注

将现有用户帐户添加到 Team Foundation Server。无法在 TFS 中创建用户帐户。

Team Foundation Server 组帐户名限制

Team Foundation 组帐户允许你将特定权限应用到一组用户。 Team Foundation 组可以由 Windows 用户帐户、Windows 组帐户、Active Directory 组帐户、Team Foundation 组帐户或这些帐户类型的任意组合构成。 有关使用组管理用户的详细信息,请参见 Team Foundation Server 部署中的用户、组和权限管理 TFS 中用户或组。 如果你需要如何将新成员添加到在 TFS、SharePoint 产品和 SQL Server Reporting Services 中使用的组的示例,请参阅向团队项目添加用户.

创建或更改 Team Foundation 组帐户时,必须遵循特定的 Team Foundation Server 限制。 下表描述了这些限制。

限制类型

限制

组帐户名长度

  • 不能超过 256 个 Unicode 字符

唯一性(集合级别组帐户)

  • 不能与团队项目集合中的组帐户的任何其他名称匹配

唯一性(项目级别组帐户)

  • 不能与同一项目中的任何其他组名匹配

保留的组名

  • 项目和服务器级别上都不能命名为 $NAMESPACE

特殊字符限制

  • 不得包含以下可打印字符:"/ \ [ ] : | < > + = ; ? *

  • 不能包含 ASCII 值在 1-31 范围内的不可打印字符

  • 不能以句点 (.) 结束

  • 不能包含逗号 (,)

备注

你不在 Team Foundation Server 中创建用户帐户。

计算机名称限制

在 TFS 安装过程中,计算机名称与该服务器的名称相关联。

操作系统和 Active Directory 都对计算机名称有特定的限制规定。 有关重命名计算机的详细信息,请参见“重命名计算机”(https://go.microsoft.com/fwlink/?LinkId=76839)。 有关 Active Directory 的详细信息,请参见“Windows Server 2003 Active Directory”(https://go.microsoft.com/fwlink/?LinkId=47541)。

团队项目集合名称限制

团队项目集合的名称标识一组团队项目和与这些项目关联的资源。 团队项目集合是用于在 TFS 中定义和控制一组团队项目的组织结构。 团队成员在连接到 TFS 中的团队项目时,将使用团队项目集合的名称。 有关详细信息,请参阅管理团队项目集合.

下表描述了对集合名称的限制。

限制类型

限制

长度

  • 不能超过 64 个 Unicode 字符

唯一性

  • 不能与 Team Foundation Server 部署中的任何其他集合名称相同。

  • 如果部署包括 SharePoint 产品或 SQL Server Reporting Services,则不能与现有 SharePoint 站点、报表服务器或 Reporting Services 网站的名称和完整路径相同。

特殊字符

  • 不能包含任何 Unicode 控制字符或代理项字符。

  • 不得包含以下可打印字符:/ : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ]

  • 不能包含省略号 (…) 或双句点 (..)

  • 不能以下划线 (_) 开头

  • 不能以句点 (.) 开头或结束

保留名称

  • 不能为系统保留名称,如 PRN、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、COM10、LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、NUL、CON、AUX、Web 或 WEB

    有关保留名称的详细信息,请参见 Microsoft 网站上的此页面:文件名、路径和命名空间

项目名称限制

TFS 中的项目名称标识一个组成特定 TFS 项目的集合,集合中包含工作项、文档、报表、团队生成以及版本控制树。 团队成员将使用此项目名称连接到 TFS 中的项目。

下表描述了对项目名称的限制。

限制类型

限制

长度

  • 不能超过 64 个 Unicode 字符

唯一性

不能与团队项目集合、支持该集合的 SharePoint Web 应用程序或支持该集合的 SQL Server Reporting Services 实例中的任何其他名称相同

特殊字符

  • 不得包含任何 Unicode 控制字符或代理项字符

  • 不得包含以下可打印字符:/ : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ]

  • 不能包含省略号 (…) 或双句点 (..)

  • 不能以下划线 (_) 开头

  • 不能以句点 (.) 开头或结束

保留名称

  • 不能为系统保留名称,如 PRN、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、COM10、LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、NUL、CON 或 AUX

  • 有关保留名称的详细信息,请参阅命名文件、路径和命名空间

团队名称限制

TFS 团队名称标识在项目中以团队形式工作的一组个人或组。 团队成员将使用此名称连接到 Team Web Access 中的团队。 团队名称必须是可作为有效的 URL 的一部分呈现的名称。 此外,单个项目内的每个团队名称必须是唯一的,但对于在团队项目集合中的不同项目中使用同一团队名称没有限制。 有关在团队中工作的详细信息,请参阅 添加另一个团队或团队层次结构

下表描述了团队名称的限制。

限制类型

限制

长度

  • 不能超过 64 个 Unicode 字符

唯一性

不得与项目中的任何其他名称相同

特殊字符

  • 不得包含任何 Unicode 控制字符或代理项字符

  • 不得包含以下可打印字符:/ : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ]

  • 不能包含省略号 (…) 或双句点 (..)

  • 不能以下划线 (_) 开头

  • 不能以句点 (.) 开头或结束

保留名称

  • 不能为系统保留名称,如 PRN、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、COM10、LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、NUL、CON 或 AUX

  • 有关保留名称的详细信息,请参阅命名文件、路径和命名空间

工作项限制

Microsoft Visual Studio Application Lifecycle Management 使用项(例如,Bug、要求、任务和风险)跟踪项目的进度。 这些项统称为工作项。 本部分描述对存储在工作项中的数据的限制。

工作项附件限制

可以将文件附加到工作项。 下表描述了对工作项附件的限制。

限制类型

限制

文件大小

  • 默认情况下,工作项文件附件的大小限制是 4,096 KB。 该值可以由 Team Foundation 管理员更改。 管理员可设置的最大大小为 2 GB。

  • 默认大小:4,096 KB

  • 最大大小:2 GB

工作项区域和迭代限制

工作项包含一个用于**“项目区域”的字段和一个用于“项目迭代”**的字段。 这两个字段用于按逻辑分组组织和显示工作项。

**“项目区域”“项目迭代”**是由多个节点项组成的路径,节点项之间以反斜杠 (\) 字符分隔。 节点由 Team Foundation Server 管理员定义,反映项目区域和项目周期。 下表描述了对节点和路径的限制。

限制类型

限制

节点长度

  • 不能超过 255 个字符

节点的特殊字符

  • 不能包含 Unicode 控制字符

  • 不能包含任何以下字符:\ / $ ? * : " & > < # % | +

  • 不能包含本地文件系统禁止的字符。 有关 Windows 字符限制的详细信息,请参阅命名文件、路径和命名空间

保留名称

  • 不能仅由一个句点 (.) 或两个句点 (..) 组成

  • 不能为系统保留名称,如 PRN、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、COM10、LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、NUL、CON 或 AUX

  • 有关保留名称的详细信息,请参阅命名文件、路径和命名空间

路径长度

  • 不能超过 4000 个 Unicode 字符

路径层次深度

  • 不能超过 14 层

工作项自定义限制

Team Foundation Server 使用诸如缺陷、要求、任务和风险等项来跟踪项目的进度。 这些项统称为工作项。

团队项目的管理员可以决定在项目级别上或在过程模板中更改工作项类型定义。 有关如何自定义工作项类型的详细信息,请参阅自定义工作跟踪对象以支持团队的进程. 本节描述了你在自定义工作项和与工作项关联的元素时将遇到的限制。

工作项字段名称限制

每个工作项类型包含一个或多个工作项字段。 这些字段定义了存储在工作项类型中的信息。 工作项字段名称唯一标识每个工作项字段。

下表描述了对工作项字段名称的限制。

限制类型

限制

长度

不能超过 128 个 Unicode 字符

特殊字符

  • 不能包含前导或拖尾空格

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

  • 不能包含句点 (.)

  • 不能包含左方括号或右方括号 ([ ])

范围

  • 工作项字段名称的范围限于整个 TFS 部署。 如果更改字段名称,则此更改将反映在包含该工作项字段的所有项目和工作项类型中。

工作项字段引用名称限制

每个工作项字段都有一个关联的字段引用名称。 字段引用名称唯一标识每个字段,在指定后便不能更改。 下表描述了对字段引用名称的限制。

限制类型

限制

长度

  • 不能超过 70 个 Unicode 字符

特殊字符

  • 不能包含连字符 (-)

  • 必须至少包含一个句点 (.)

  • 不能以句点 (.) 开头或结束

  • 不能以数字开头

  • 不能以下划线 (_) 开头

唯一性

  • 不能与 Team Foundation Server 中的任何其他字段引用名称相同

  • 在计算机使用下划线 (_) 替换这些名称中的所有句点 (.) 之后,该字段引用名称不能与任何其他字段引用名称相同

    例如,字段引用名称 My._Field 和 My_.Field 都将被计算机处理为同一名称:My__Field

工作项字段帮助文本限制

你可以选择通过使用 <HELPTEXT> 标记将帮助文本与工作项字段关联。 系统将在运行时显示此文本,以帮助用户了解应在字段中输入哪些内容。 有关工作项字段帮助文本的详细信息,请参阅将规则应用于工作项字段.

下表描述了对工作项字段帮助文本的限制。

限制类型

限制

长度

  • 不能超过 255 个 Unicode 字符

范围

与字段名和字段类型不同,字段帮助文本的应用范围限定为特定团队项目中的特定工作项类型。

全局列表限制

全局列表是列表项值的集合,该集合由所有 Team Foundation Server 在 Team Foundation Server 实现中存储并在全局范围使用。 在定义工作项类型时,你可能会发现一些工作项字段共享一组相同的可能值。 使用全局列表可以一次定义这些值并在多个工作项类型中共享这些值。 有关详细信息,请参阅定义全局列表

全局列表 (GLOBALLIST) 包含一个或多个列表项(LISTITEM 元素)。

下表描述了对列表项的限制。

限制类型

限制

长度

  • 不能超过 254 个 Unicode 字符

  • 不能为空

特殊字符

  • 不能包含前导或拖尾空白

  • 不能包含两个连续空格

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

范围

  • 因为全局列表在所有项目中都可用,所以不能包含在项目级别定义的元素,例如项目特定的组帐户定义。

下表描述了对全局列表的限制。

限制类型

限制

项个数

全局列表不能为空。 它必须至少包含一个 LISTITEM 元素。

唯一性

  • 全局列表名称不能与 Team Foundation Server 中的任何其他全局列表名称相同。

过程模板限制

过程模板是默认工作项、工作项查询、产品模板、报告、安全组和指南的集合,它影响 Team Foundation 项目的结构。 Team Foundation Server 包含两个默认的过程模板,从而提供两种不同的软件周期管理风格。 可以自定义这些模板以满足你的组织的独特需求。 有关详细信息,请参阅自定义过程模板

下表描述了对过程模板的限制。

限制类型

限制

过程模板名称长度

不能超过 256 个 Unicode 字符。

过程模板名称的唯一性

  • 必须在 Team Foundation 服务器内保持唯一。

  • 如果上载与现有模板名称相同的模板,则将覆盖现有模板。

过程模板文件大小

过程模板文件大小不能超过 2 GB(兆字节)。

Team Foundation Build 限制

Team Foundation Build 允许在一台计算机上管理生成过程的所有方面。 通过使用 Team Foundation Build,你可以同步源代码、编译应用程序、运行关联的单元测试、执行代码分析、在文件服务器上发布生成,以及发布生成报告。

生成计算机限制

Team Foundation Build 是独立于 Team Foundation Server 应用层、数据层或 Visual Studio 客户端的单独安装。 你可以指定单独的计算机。 或者,也可以将生成版本并行安装在客户端计算机或服务器上。

下表描述了对生成计算机的限制。

限制类型

限制

磁盘空间

必须具有足够的磁盘空间用于生成(磁盘空间不足将导致生成失败)。

生成目录

必须为本地路径(例如,C:\builddirectory)。

放置位置目录

必须为 UNC 路径(例如,\\server\share)。

放置位置权限

每个生成的版本都放在放置文件夹中的新目录中。

  • Team Foundation Server Service 帐户(例如,Domain\TFSSERVICE)必须对 UNC 放置位置具有“完全控制”权限。

  • UNC 放置位置必须为共享文件夹。

Team Foundation 生成服务帐户

如果在初始安装后更改 TFS Service 帐户,则必须确保符合以下条件。

  • 该帐户为“Build Services”组的成员。

  • 该帐户对临时文件夹和 ASP.NET 临时文件夹有读/写权限。

  • 该帐户对生成目录和放置位置具有“完全控制”权限。

防火墙问题

如果生成计算机启用了防火墙,则请确保 tfsbuildservice 程序位于例外列表中。

生成类型名称

Team Foundation Build 使用生成类型来配置将在团队项目中生成单个解决方案或一组解决方案的条件。 若要完成生成,必须创建新生成类型或使用现有的生成类型。 有关生成类型的详细信息,请参阅定义生成过程.

下表描述了对生成类型名称的限制。

限制类型

限制

唯一性

不能与项目中的任何其他生成类型名称相同

特殊字符

  • 不能包含以下可打印字符:$

生成质量名称

生成质量允许向完成的生成附加质量级别或完成状态。 Team Foundation Build 还允许为生成质量类型创建新值。 有关详细信息,请参阅创建或编辑生成定义。 有关默认生成质量值的列表,请参阅对已完成生成的质量进行评级.

下表描述了对生成质量名称的限制。

限制类型

限制

长度

不能超过 256 个 Unicode 字符

唯一性

不能与 Team Foundation Build 计算机中的任何其他生成质量名称相同

版本控制限制

Team Foundation 版本控制提供了一个中央存储库,用于存储团队中的文件以及管理这些文件所需的命令。 还提供可自定义的签入策略、分支、合并、搁置以及许多其他功能。

版本控制路径

下表描述了版本控制路径的限制。

限制类型

限制

服务器源代码管理文件夹路径长度

  • 单个文件夹或文件的名称包含的 Unicode 字符数不得多于 259 个。

  • 目录不能超过 388 个 Unicode 字符。

  • 目录和文件名加起来不能超过 399 个 Unicode 字符。

本地文件夹的路径长度

  • 目录不能超过 248 个 Unicode 字符。

  • 目录和文件名加起来不能超过 260 个 Unicode 字符。

另请参阅:优化工作区.

向版本控制添加文件

版本控制系统存储许多不同类型的文件。 有关如何将现有 Visual Studio 项目或解决方案添加到版本控制的详细信息,请参阅在开发计算机上设置 Team Foundation 版本控制.

下表描述了应用于要添加到版本控制中的文件和文件夹的限制。

限制类型

限制

文件和文件夹

  • 名称不得包含以下可打印字符:/ \ : * ?" < > | ;

  • 文件夹不得位于活动工作区的映射目录之外

文件名

  • 不得以 $ 开头

  • 不得包含以下可打印字符: / \ : * ?" < > | ;

标签名称

在 Team Foundation 版本控制中,标签是应用于特定修订集的名称。 可以向版本控制中的一组不相关文件附加标签。 这使你能够将这些文件作为组进行检索或处理。 下表描述了对标签名称的限制。

限制类型

限制

长度

不能超过 64 个 Unicode 字符

特殊字符

  • 不能以空格 ( ) 或句点 (.) 结束

  • 不得包含以下可打印字符:" / : < > \ | * ? @ ;

搁置集

通过使用搁置集,你可以暂时保留一批挂起的更改,并可以选择在以后从你的工作区移除这些挂起的更改。 你可以在以后将搁置集中的更改还原到你的工作区中或将这些更改放入其他用户的工作区。

下表描述了对搁置集名称的限制。

限制类型

限制

长度

不能超过 64 个 Unicode 字符

特殊字符

  • 不得包含以下可打印字符:" / : < > \ | * ? ;

工作区名称

工作区是 Team Foundation 版本控制中文件和文件夹的客户端副本。 创建多个工作区时,客户端计算机上可以有同一版本控制文件夹的不同版本。 有关工作区的详细信息,请参阅创建和使用工作区. 下表描述了对工作区名称的限制。

限制类型

限制

长度

不能超过 64 个 Unicode 字符

特殊字符

  • 不能以空格 ( ) 结尾

  • 不得包含以下可打印字符:" / : < > \ | * ? ;

请参见

任务

创建或编辑生成定义

对已完成生成的质量进行评级

概念

自定义工作跟踪对象以支持团队的进程

定义全局列表

自定义过程模板

定义生成过程

创建和使用工作区