Team Foundation 的命名限制
Visual Studio Team Foundation Server (TFS) 中许多组件的命名都具有特定的限制。 这些限制有助于保证一致的用户体验,并提供与其他程序的兼容性。 这些限制可包括长度、特殊字符、唯一性或其他特性。
本主题包含以下小节:
一般注意事项
Team Foundation Server 组帐户名限制
计算机名称限制
团队项目集合名称限制
团队项目名称限制
团队名称限制
工作项限制
工作项自定义限制
过程模板限制
Team Foundation Build 限制
版本控制限制
请参见
一般注意事项
本主题中的长度限制表示为允许的 Unicode 字符的数量。 有关 Unicode 的更多信息,请参见“About Unicode and Character Sets”(关于 Unicode 和字符集)(https://go.microsoft.com/fwlink/?LinkId=76837)。 代理项字符由两个 Unicode 字符组成,长度限制中会将其算作两个字符。
与其他操作系统文件一样,还禁止 ASCII 控制字符 (ASCII 1-31) 和代理项的组合形式。 有关操作系统对文件名的限制的一般信息,请参见“Naming a File”(文件命名)(https://go.microsoft.com/fwlink/?LinkId=76838)。
Team Foundation Server 组帐户名限制
Team Foundation 组帐户允许您将特定权限应用到一组用户。 Team Foundation 组可以由 Windows 用户帐户、Windows 组帐户、Active Directory 组帐户、Team Foundation 组帐户或这些帐户类型的任意组合构成。 有关 Users, groups, and permissions in Team Foundation Server deployments 中的用户和组的更多信息,请参见配置用户、组和权限。 如果想要怎样在 TFS、SharePoint 产品和 SQL Server Reporting Services 中添加新成员的示例演示,请参见向团队项目中添加用户。 如果要了解如何检查您帐户权限的更多信心,请参见 管理我的个人资料和查看我的权限。
创建或更改 Team Foundation 组帐户时,必须遵循特定的 Team Foundation Server 限制。 下表描述了这些限制。
限制类型 |
限制 |
---|---|
组帐户名长度 |
|
唯一性(集合级别组帐户) |
|
唯一性(项目级别组帐户) |
|
保留的组名 |
|
特殊字符限制 |
|
备注
您不在 Team Foundation Server 中创建用户帐户。
计算机名称限制
在 TFS 安装过程中,计算机名称与服务器的名称相关联。
操作系统和 Active Directory 都对计算机名称有特定的限制规定。 有关重命名计算机的更多信息,请参见“Rename a Computer”(重命名计算机)(https://go.microsoft.com/fwlink/?LinkId=76839)。 有关 Active Directory 的更多信息,请参见“Windows Server 2003 Active Directory”(https://go.microsoft.com/fwlink/?LinkId=47541)。
团队项目集合名称限制
团队项目集合的名称标识一组团队项目和与这些项目关联的资源。 团队项目集合是用于在 TFS 内定义和控制一组团队项目的组织结构。 团队成员在连接到 TFS 中的团队项目时,将使用团队项目集合的名称。有关更多信息,请参见使用团队项目集合组织服务器。
下表描述了对集合名称的限制。
限制类型 |
限制 |
---|---|
Length |
|
唯一性 |
|
特殊字符 |
|
保留名称 |
|
项目名称限制
在 TFS 中的项目名称标识一个 TFS 在组成特定项目的集合,集合中包含工作项、文档、报表、团队项目生成以及版本控制树。 团队成员将使用此项目名称连接到 TFS 中的项目。
下表描述了对项目名称的限制。
限制类型 |
限制 |
---|---|
Length |
|
唯一性 |
不能与团队项目集合、支持该集合的 SharePoint Web 应用程序或支持该集合的 SQL Server Reporting Services 实例中的任何其他名称相同 |
特殊字符 |
|
保留名称 |
|
团队名称限制
在 TFS 的团队名称标识在 TFS 中的项目集体作为团队一起工作。 团队成员将使用此项目名称连接到 Team Web Access 中的此团队。 团队名称必须是有效的 URL 可呈现的名称的一部分。 此外,单个项目内每个团队名称必须是唯一的,但是,在团队项目集合中的不同项目不禁止使用同一个团队名称。 有关使用 团队入门 中的项目的详细信息,请参阅。
下表描述了对团队名称的限制。
限制类型 |
限制 |
---|---|
Length |
|
唯一性 |
不能与项目中的任何其他名称相同 |
特殊字符 |
|
保留名称 |
|
工作项限制
Microsoft Visual Studio Application Lifecycle Management 使用项(例如 bug、要求、任务和风险)跟踪项目的进度。 这些项统称为工作项。 本部分描述对存储在工作项中的数据的限制。
工作项附件限制
可以将文件附加到工作项。 下表描述了对工作项附件的限制。
限制类型 |
限制 |
---|---|
文件大小 |
|
工作项区域和迭代限制
工作项包含一个用于**“项目区域”的字段和一个用于“项目迭代”**的字段。 这两个字段用于按逻辑分组组织和显示工作项。
**“项目区域”和“项目迭代”**是由多个节点项组成的路径,节点项之间以反斜杠 (\) 字符分隔。 节点由 Team Foundation Server 管理员定义,反映项目区域和项目周期。 下表描述了对节点和路径的限制。
限制类型 |
限制 |
---|---|
节点长度 |
|
节点的特殊字符 |
|
保留名称 |
|
路径长度 |
|
路径层次深度 |
|
工作项自定义限制
Team Foundation Server 使用诸如缺陷、要求、任务和风险等项来跟踪项目的进度。 这些项统称为工作项。
团队项目的管理员可以决定在项目级别上或在过程模板中更改工作项类型定义。 有关如何自定义工作项类型的更多信息,请参见自定义项目跟踪数据、窗体、工作流及其他对象。 本节描述了您在自定义工作项和与工作项关联的元素时将遇到的限制。
工作项字段名称限制
每个工作项类型包含一个或多个工作项字段。 这些字段定义了存储在工作项类型中的信息。 工作项字段名称唯一标识每个工作项字段。
下表描述了对工作项字段名称的限制。
限制类型 |
限制 |
---|---|
Length |
不能超过 128 个 Unicode 字符 |
特殊字符 |
|
范围 |
|
工作项字段引用名称限制
每个工作项字段都有一个关联的字段引用名称。 字段引用名称唯一标识每个字段,在指定后便不能更改。 下表描述了对字段引用名称的限制。
限制类型 |
限制 |
---|---|
Length |
|
特殊字符 |
|
唯一性 |
|
工作项字段帮助文本限制
您可以选择通过使用 <HELPTEXT> 标记将帮助文本与工作项字段关联。 系统将在运行时显示此文本,以帮助用户了解应在字段中输入哪些内容。 有关工作项字段帮助文本的更多信息,请参见定义工作项字段的帮助文本。
下表描述了对工作项字段帮助文本的限制。
限制类型 |
限制 |
---|---|
Length |
|
范围 |
与字段名和字段类型不同,字段帮助文本的应用范围限定为特定团队项目中的特定工作项类型。 |
全局列表限制
全局列表是列表项值的集合,该集合由所有 Team Foundation Server 在 Team Foundation Server 实现中存储并在全局范围使用。 在定义工作项类型时,您可能会发现一些工作项字段共享一组相同的可能值。 使用全局列表可以一次定义这些值并在多个工作项类型中共享这些值。 有关更多信息,请参见定义全局列表。
全局列表 (GLOBALLIST) 包含一个或多个列表项(LISTITEM 元素)。
下表描述了对列表项的限制。
限制类型 |
限制 |
---|---|
Length |
|
特殊字符 |
|
范围 |
|
下表描述了对全局列表的限制。
限制类型 |
限制 |
---|---|
项个数 |
全局列表不能为空。 它必须至少包含一个 LISTITEM 元素。 |
唯一性 |
|
过程模板限制
过程模板是默认工作项、工作项查询、产品模板、报告、安全组和指南的集合,它影响 Team Foundation 项目的结构。 Team Foundation Server 包含两个默认的过程模板,从而提供两种不同的软件周期管理风格。 可以自定义这些模板以满足您的组织的独特需求。 有关更多信息,请参见自定义过程模板。
下表描述了对过程模板的限制。
限制类型 |
限制 |
---|---|
过程模板名称长度 |
不能超过 256 个 Unicode 字符。 |
过程模板名称的唯一性 |
|
过程模板文件大小 |
过程模板文件大小不能超过 2 GB(兆字节)。 |
Team Foundation Build 限制
Team Foundation Build 允许在一台计算机上管理生成过程的所有方面。 通过使用 Team Foundation Build,您可以同步源代码、编译应用程序、运行关联的单元测试、执行代码分析、在文件服务器上发布生成,以及发布生成报告。
生成计算机限制
Team Foundation Build 是独立于 Team Foundation Server 应用层、数据层或 Visual Studio 客户端的单独安装。 您可以指定单独的计算机。 或者,也可以将生成版本并行安装在客户端计算机或服务器上。
下表描述了对生成计算机的限制。
限制类型 |
限制 |
---|---|
磁盘空间 |
必须具有足够的磁盘空间用于生成(磁盘空间不足将导致生成失败)。 |
生成目录 |
必须为本地路径(例如,C:\生成目录)。 |
放置位置目录 |
必须为 UNC 路径(例如,\\server\share)。 |
放置位置权限 |
每个生成的版本都放在放置文件夹中的新目录中。
|
Team Foundation 生成服务帐户 |
如果在初始安装后更改 TFS Service 帐户,则必须确保符合以下条件。
|
防火墙问题 |
如果生成计算机启用了防火墙,则请确保 tfsbuildservice 程序位于例外列表中。 |
生成类型名称
Team Foundation Build 使用生成类型来配置将在团队项目中生成单个解决方案或一组解决方案的条件。 若要完成生成,必须创建新生成类型或使用现有的生成类型。 有关生成类型的更多信息,请参见定义生成过程。
下表描述了对生成类型名称的限制。
限制类型 |
限制 |
---|---|
唯一性 |
不能与项目中的任何其他生成类型名称相同 |
特殊字符 |
|
生成质量名称
生成质量允许向完成的生成附加质量级别或完成状态。 Team Foundation Build 还允许为生成质量类型创建新值。 有关更多信息,请参见创建生成定义。 有关默认生成质量值的列表,请参见对已完成生成的质量进行评级。
下表描述了对生成质量名称的限制。
限制类型 |
限制 |
---|---|
Length |
不能超过 256 个 Unicode 字符 |
唯一性 |
不能与 Team Foundation Build 计算机中的任何其他生成质量名称相同 |
版本控制限制
Team Foundation 版本控制提供了一个中央存储库,用于存储团队中的文件以及管理这些文件所需的命令。 还提供可自定义的签入策略、分支、合并、搁置以及许多其他功能。
版本控制路径
下表描述了版本控制路径上的限制。
限制类型 |
限制 |
---|---|
服务器源管理文件夹路径长度 |
|
本地文件夹的路径长度 |
|
请参阅:优化工作区。
向版本控制添加文件
版本控制系统存储许多不同类型的文件。 有关如何将现有 Visual Studio 项目或解决方案添加到版本控制中的更多信息,请参见设置开发计算机并开始使用版本控制。
下表描述了应用于要添加到版本控制中的文件和文件夹的限制。
限制类型 |
限制 |
---|---|
文件扩展名 |
|
文件夹 |
|
标签名称
在 Team Foundation 版本控制中,标签是应用于特定修订集的名称。 可以向版本控制中的一组不相关文件附加标签。 这使您能够将这些文件作为组进行检索或处理。 下表描述了对标签名称的限制。
限制类型 |
限制 |
---|---|
Length |
不能超过 64 个 Unicode 字符 |
特殊字符 |
|
搁置集
通过使用搁置集,您可以暂时保留一批挂起的更改,并可以选择在以后从您的工作区移除这些挂起的更改。 您可以在以后将搁置集中的更改还原到您的工作区中或将这些更改放入其他用户的工作区。
下表描述了对搁置集名称的限制。
限制类型 |
限制 |
---|---|
Length |
不能超过 64 个 Unicode 字符 |
特殊字符 |
|
工作区名称
工作区是 Team Foundation 版本控制中文件和文件夹的客户端副本。 创建多个工作区时,客户端计算机上可以有同一版本控制文件夹的不同版本。 有关工作区的更多信息,请参见管理工作区。 下表描述了对工作区名称的限制。
限制类型 |
限制 |
---|---|
Length |
不能超过 64 个 Unicode 字符 |
特殊字符 |
|