版本控制流程範本外掛程式

發行項
08/21/2008

更新：2007 年 11 月

版本控制外掛程式會定義 Team 專案的初始版本控制安全性權限、簽入提示，以及是否需要獨佔簽出。此外掛程式的名稱是 Microsoft.ProjectCreationWizard.VersionControl，而版本控制 XML 檔的名稱則是 VersionControl.xml，位於流程範本資料夾階層架構的 [版本控制] 資料夾中。如果有需要，您可以變更此 XML 檔案和資料夾的名稱。

在 XML 檔中，指定一或多項工作及其相依性。一般而言，只需要一項工作就能進行版本控制設定。如需指定版本控制設定之工作的範例，請參閱 MSF for Agile Software Development 流程範本中的 VersionControl.xml 檔。

注意事項：
Team Foundation Server 並未包含部署用戶端外掛程式、原則或其他修改的機制。如果您想要將外掛程式、原則或其他修改部署至 Team 總管，就必須使用您自己的散發與安裝程式。

簽入提示

簽入提示是由開發人員在程式碼簽入時所提供，以說明程式碼變更是如何 (或是否) 影響小組流程。例如，簽入提示可以指出變更是否是安全性檢閱的一部分，並包含和安全性檢閱有關之變更的詳細資訊。

請使用 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"/>

簽出時取得最新的版本

您可以為 Team 專案設定預設的簽出行為。請使用 get_latest_on_checkout 項目來指定簽出行為。

<get_latest_on_checkout required=""/>

如果 required 屬性是設為 true，表示會在您每一次簽出時下載最新版本的項目或提示。此行為與 Visual SourceSafe 內的簽出行為類似。

如果 required 屬性是設為 false，表示簽出作業會將您工作區內的本機版本簽出。這是預設行為。

下列範例說明如何將預設的簽出行為指定為在簽出時取得最新版本的項目。

<get_latest_on_checkout required="true"/>

使用權限

版本控制具有一組特定的權限，您可以針對流程範本設定這些權限。經由指定權限，即可定義安全性群組與個人可以對版本控制下的項目執行哪些動作。

使用此權限項目 (Element) 可允許、拒絕，或是允許及拒絕某個識別 (Identity) 的權限。

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

下表將說明權限項目的屬性。

allow

指出要授與的權限。這些權限是以逗號分隔的文字格式來加以指定。

拒絕

識別要撤銷的權限。這些權限是以逗號分隔的文字格式來加以指定。

注意事項：
拒絕的權限優先於允許的權限。

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>

請參閱

共用方式為