版本控制过程模板插件

项目
08/18/2008

更新：2007 年 11 月

版本控制插件定义团队项目的初始版本控制安全权限、签入说明，以及是否需要独占签出。插件的名称为 Microsoft.ProjectCreationWizard.VersionControl。版本控制 XML 文件的名称为 VersionControl.xml，并位于过程模板文件夹层次结构中的 Version Control 文件夹中。如果需要，可以更改 XML 文件和文件夹的名称。

在 XML 文件中，指定一个或多个任务以及它们的依赖项。通常，只需要一个任务就可以配置版本控制设置。有关指定版本控制设置的任务的示例，请参见 MSF for Agile Software Development 过程模板中的 VersionControl.xml 文件。

说明：
Team Foundation Server 并不包括用于部署客户端插件、策略或其他修改的机制。如果您希望将插件、策略或其他修改部署到团队资源管理器，则必须使用您自己的分发和安装程序。

签入说明

签入说明由开发人员在签入代码时提供，以描述代码更改如何或者是否与团队过程相关。例如，签入说明可以指示更改是否属于安全检查的一部分，并包括与安全检查有关的更改的详细信息。

使用 checkin_note 元素定义签入说明。

<checkin_note label="" required="" order=""/>

下表描述了 checkin_note 元素的属性。

属性	说明
label	描述签入说明的标签。当用户执行签入时，将在“挂起签入”对话框中向用户显示该标签。
required	指定签入说明是否必须具有值。如果设置为 true，则签入说明必须具有值。如果设置为 false，则值是可选的。
order	指定一个序号，以指示显示签入说明的顺序。此属性是可选的。

下面的示例说明如何自定义 MSF for Agile Software Development 签入说明，以提供一个不必具有值的名为“Documentation Impact”的附加签入说明。

<taskXml>
   <checkin_note label="Code Reviewer" required="false" order="1"/>
   <checkin_note label="Security Reviewer" required="false" order="2"/>
   <checkin_note label="Performance Reviewer" required="false" order="3"/> 
   <checkin_note label="Documentation Impact" required="false"/>
</taskXml>

独占签出

您可以控制是否可由多个人员同时签出一个文件。使用 exclusive_checkout 元素指定签出属性。

<exclusive_checkout required=""/>

如果将 required 属性设置为 true，则一次只有一个人员可以签出某个文件。如果设置为 false，则多个人员可以同时签出某个文件，并且他们在签入文件时必须对更改进行协调。

下面的示例演示如何指定独占签出是必需的。

<exclusive_checkout required="true"/>

签出时获取最新版本

可以为团队项目配置默认的签出行为。使用 get_latest_on_checkout 元素指定签出行为。

<get_latest_on_checkout required=""/>

如果必需的属性设置为 true，则项或提示的最新版本将在每次签出时下载。此行为与 Visual SourceSafe 中的签出行为类似。

如果必需的属性设置为 false，则签出操作将签出工作区中的本地版本。这是默认行为。

下面的示例说明如何将默认的签出行为指定为签出时获取项的最新版本。

<get_latest_on_checkout required="true"/>

权限

版本控制具有一组特定的权限，您可以为过程模板配置这些权限。指定权限将定义安全组和每个人可以对实施了版本控制的项执行哪些操作。

使用 permission 元素可允许、拒绝或允许和拒绝标识的权限。

<permission allow="" identity=""/>
<permission deny="" identity=""/>
<permission allow="" deny="" identity=""/>

下表描述了 permission 元素的属性。

allow

标识要授予的权限。权限以逗号分隔的文本进行指定。

deny

标识要撤消的权限。权限以逗号分隔的文本进行指定。

说明：
拒绝的权限优先于允许的权限。

identity

指定要应用此权限的 Team Foundation Server 安全组、Windows 组或 Windows 标识。

下表描述了可以为版本控制指定的权限。

权限	说明
Read	可以读取文件或文件夹的内容。
PendChange	可以签出、添加、删除、分支、合并或取消删除变更集，以及执行其他与变更集关联的活动。
Checkin	可以签入更改。
Label	可以对项应用标签。
Lock	可以锁定某项，以便其他用户不能对其进行更新。
ReviseOther	可以更改其他人的变更集注释和签入说明的内容。
UnlockOther	可以移除其他人的锁定。
UndoOther	可以撤消其他人的挂起的更改。
LabelOther	可以修改其他人的标签。
AdminProjectRights	可以为版本控制配置安全设置。
CheckinOther	可以作为其他用户执行签入。转换实用工具需要此权限。

说明：
如果运行时找不到某个标识的权限，将会在该标识所属的任何其他组中搜索权限。如果找不到相应的权限，默认操作是拒绝该权限。

下面的示例演示如何授予权限以允许“Contributors”组修改实施了版本控制的文件。

<taskXml>
   <permission allow="Read, PendChange, Checkin, Label, Lock"
               identity="[$$PROJECTNAME$$]\Contributors"/>
</taskXml>

请参见

通过

版本控制过程模板插件

签入说明

独占签出

签出时获取最新版本

权限

请参见

任务

概念

其他资源

其他资源