Prozessvorlagen-Plug-In für Versionskontrolle

Artikel
08/20/2008

Aktualisiert: November 2007

Mit dem Plug-In für Versionskontrolle werden die anfänglichen Versionskontroll-Sicherheitsberechtigungen für ein Teamprojekt sowie Eincheckhinweise definiert, und es wird festgelegt, ob exklusives Auschecken erforderlich ist. Der Name des Plug-Ins lautet Microsoft.ProjectCreationWizard.VersionControl. Die XML-Datei für die Versionskontrolle hat den Namen VersionControl.xml und befindet sich im Ordner Versionskontrolle in der Ordnerhierarchie der Prozessvorlage. Sie können die Namen der XML-Datei und des Ordners ggf. ändern.

Geben Sie in der XML-Datei eine oder mehrere Aufgaben mit den zugehörigen Abhängigkeiten an. Im Allgemeinen benötigen Sie nur eine Aufgabe zum Konfigurieren der Versionskontrolleinstellungen. Ein Beispiel für eine Aufgabe zum Festlegen von Versionskontrolleinstellungen finden Sie in der Datei VersionControl.xml in der Prozessvorlage für MSF for Agile Software Development.

Hinweis:
Team Foundation Server enthält keinen Mechanismus für die Bereitstellung clientseitiger Plug-Ins, Richtlinien oder anderer Änderungen. Wenn Sie Plug-Ins, Richtlinien oder andere Änderungen für Team Explorer bereitstellen möchten, müssen Sie ein eigenes Verteilungs- und Installationsprogramm verwenden.

Eincheckhinweise

Eincheckhinweise werden vom Entwickler beim Einchecken von Code bereitgestellt. Sie beschreiben, wie oder ob sich die Codeänderungen auf Teamprozesse auswirken. Beispielsweise kann ein Eincheckhinweis darüber informieren, ob die Änderung Teil einer Sicherheitsüberprüfung war und Einzelheiten zu den bei der Sicherheitsüberprüfung vorgenommenen Änderungen enthalten.

Verwenden Sie das checkin_note-Element, um einen Eincheckhinweis zu definieren.

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

In der folgenden Tabelle werden die Attribute für das checkin_note-Element beschrieben.

Attribut	Beschreibung
label	Die Bezeichnung, die den Eincheckhinweis beschreibt. Die Bezeichnung ist für den Benutzer im Dialogfeld Anstehende Eincheckvorgänge sichtbar, wenn er einen Eincheckvorgang ausführt.
required	Gibt an, ob der Eincheckhinweis über einen Wert verfügen muss. Wenn das Attribut auf true festgelegt ist, muss der Eincheckhinweis über einen Wert verfügen. Bei False kann ein Wert optional angegeben werden.
order	Gibt eine Ordnungszahl an, um festzulegen, in welcher Reihenfolge die Eincheckhinweise angezeigt werden sollen. Dieses Attribut ist optional.

Das folgende Beispiel veranschaulicht, wie Sie die Eincheckhinweise für MSF for Agile Software Development anpassen und einen zusätzlichen Eincheckhinweis mit der Bezeichnung "Documentation Impact" bereitstellen, für den kein Wert erforderlich ist.

<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>

Exklusives Auschecken

Sie können steuern, ob eine Datei von mehreren Personen gleichzeitig ausgecheckt werden kann. Verwenden Sie das exclusive_checkout-Element, um Eigenschaften für das Auschecken anzugeben.

<exclusive_checkout required=""/>

Wenn das required-Attribut auf true festgelegt ist, kann eine Datei jeweils nur von einer Person ausgecheckt werden. Wenn es auf false festgelegt ist, kann eine Datei von mehreren Personen gleichzeitig ausgecheckt werden, und Änderungen der verschiedenen Benutzer müssen beim erneuten Einchecken der Datei ausgeglichen werden.

Im folgenden Beispiel wird veranschaulicht, wie Sie festlegen, ob exklusives Auschecken erforderlich ist.

<exclusive_checkout required="true"/>

Letzte Version bei Auschecken abrufen

Sie können das Standardauscheckverhalten für das Teamprojekt konfigurieren. Verwenden Sie das get_latest_on_checkout-Element, um das Auscheckverhalten festzulegen.

<get_latest_on_checkout required=""/>

Wenn das required-Attribut auf true festgelegt ist, wird beim Auschecken eines Elements immer dessen letzte Version heruntergeladen. Dieses Verhalten ist dem Auscheckverhalten in Visual SourceSafe ähnlich.

Wenn das required-Attribut auf false festgelegt ist, wird beim Auschecken die lokale Version im Arbeitsbereich ausgecheckt. Dies ist das Standardverhalten.

Im folgenden Beispiel wird veranschaulicht, wie als Standardauscheckverhalten das Abrufen der letzten Version eines Elements festgelegt wird.

<get_latest_on_checkout required="true"/>

Berechtigungen

Die Versionskontrolle verfügt über eine bestimmte Gruppe von Berechtigungen, die Sie für eine Prozessvorlage konfigurieren können. Mithilfe von Berechtigungen können Sie festlegen, welche Aktionen Sicherheitsgruppen und Einzelbenutzer auf Elemente anwenden können, die der Versionskontrolle unterliegen.

Verwenden Sie das permission-Element, um Berechtigungen für eine Identität zuzulassen, zu verweigern oder zuzulassen und zu verweigern.

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

In der folgenden Tabelle werden die Attribute für das permission-Element beschrieben.

allow

Bezeichnet die gewährten Berechtigungen. Die Berechtigungen werden als Text angegeben, der durch Kommas getrennt wird.

Verweigern

Bezeichnet die widerrufenen Berechtigungen. Die Berechtigungen werden als Text angegeben, der durch Kommas getrennt wird.

Hinweis:
Verweigerte Berechtigungen haben Vorrang vor gewährten Berechtigungen.

identity

Gibt die Team Foundation Server-Sicherheitsgruppe, Windows-Gruppe oder Windows-Identität an, auf die diese Berechtigung angewendet wird.

In der folgenden Tabelle werden die Berechtigungen beschrieben, die Sie für die Versionskontrolle festlegen können.

Berechtigung	Beschreibung
Read	Der Inhalt einer Datei oder eines Ordners kann gelesen werden.
PendChange	Auschecken, Hinzufügen, Löschen, Verzweigen, Zusammenführen, Wiederherstellen und andere einem Changeset zugeordnete Aktivitäten können ausgeführt werden.
Checkin	Änderungen können eingecheckt werden.
Label	Auf Elemente kann eine Bezeichnung angewendet werden.
Lock	Elemente können gesperrt werden, sodass sie nicht von anderen Benutzer aktualisiert werden können.
ReviseOther	Der Inhalt der Changesetkommentare und Eincheckhinweise eines anderen Benutzers können geändert werden.
UnlockOther	Die Sperre eines anderen Benutzers kann entfernt werden.
UndoOther	Die ausstehenden Änderungen eines anderen Benutzers können rückgängig gemacht werden.
LabelOther	Die Bezeichnung eines anderen Benutzers kann geändert werden.
AdminProjectRights	Die Sicherheitseinstellungen für die Versionskontrolle können konfiguriert werden.
CheckinOther	Das Einchecken unter einem anderen Benutzernamen ist möglich. Diese Berechtigung ist für Konvertierungsdienstprogramme erforderlich.

Hinweis:
Wenn während der Laufzeit eine Berechtigung für eine Identität nicht gefunden wird, wird sie in allen anderen Gruppen gesucht, denen die Identität angehört. Wenn die Berechtigung nicht gefunden wird, besteht die Standardaktion darin, die Berechtigung zu verweigern.

Im folgenden Beispiel wird veranschaulicht, wie der Gruppe Beteiligte Personen Berechtigungen zum Ändern von Dateien gewährt werden, die der Versionskontrolle unterliegen.

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

Siehe auch

Freigeben über

Prozessvorlagen-Plug-In für Versionskontrolle

Eincheckhinweise

Exklusives Auschecken

Letzte Version bei Auschecken abrufen

Berechtigungen

Siehe auch

Aufgaben

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen