Exemplarische Vorgehensweise: Anpassen von Eincheckrichtlinien und -hinweisen
Mit Team Foundation können Sie benutzerdefinierte Eincheckvorgänge erstellen, einschließlich:
Erstellen von Vorlagen und Anforderungen für Eincheckhinweise
Sie können eigene Felder zum Erfassen von Eincheckinformationen erstellen, die die Angabe bestimmter Informationen durch den Benutzer beim Eincheckvorgang erfordern.Diese Informationen werden, ähnlich wie ein Eincheckkommentar, zusammen mit anderen Details von Changesets beibehalten und können der E-Mail-Benachrichtigung an die anderen Teammitglieder beigefügt werden.
Definieren von Eincheckrichtlinien
Sie können benutzerdefinierte Eincheckregeln definieren, um Einschränkungen für die Änderungen zu erzwingen, für die ein Commit an den Quellcodekontrollserver ausgeführt wird.Beispielsweise kann ein Projektadministrator Regeln für die Validierung von Quellcodeänderungen vor dem Durchführen eines Commits an den Server definieren.Im Lieferumfang von Team Foundation sind Eincheckrichtlinien enthalten, mit denen überprüft werden kann, ob Arbeitsaufgaben Änderungen zugeordnet sind, Komponententests erfolgreich durchgeführt und statische Analysen des Quellcodes fehlerfrei ausgeführt werden.Diese Richtlinien können durch ein Plug-In-Modell erweitert werden, sodass Sie zusätzliche Anforderungen einfach durch Erstellen eines neuen Richtlinien-Plug-Ins erzwingen können.Die Eincheckrichtlinien, die auf ein Teamprojekt angewendet werden, hängen von dem MSF-Prozess ab, der vom Teamprojekt verwendet wird.
In dieser exemplarischen Vorgehensweise wird beschrieben, wie Sie Eincheckhinweise hinzufügen und wie Sie eine Eincheckrichtlinie definieren, die eine Zuordnung von Arbeitsaufgaben bei jedem Einchecken erfordert.
Erforderliche Berechtigungen
Um diese exemplarische Vorgehensweise abzuschließen, müssen Sie über die auf Zulassen festgelegten Berechtigungen Auschecken und Serverebeneninformationen bearbeiten verfügen.Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.
Erstellen von Eincheckhinweisen
Sie können in Team Foundation eigene Felder für Eincheckhinweise eines Teams definieren, und Sie können Benutzeranforderungen für das Einchecken auf Stammordnerebene für den Server definieren (z. B. $/folder1).Diese Ordner entsprechen den Teamprojekten.Die Einstellungen gelten dann für den gesamten Quellcode in diesen Ordnern.Wenn ein Benutzer Überarbeitungen in einen Ordner auf dem Server einchecken möchten, für den benutzerdefinierte Eincheckhinweise oder -anforderungen gelten, wird der Benutzer aufgefordert, die Angaben im Dialogfeld Einchecken oder im Fenster Einchecken zu vervollständigen.Eincheckhinweise können optional oder erforderlich sein. Die einzige Überprüfung von erforderlichen Hinweisen besteht darin, dass die Länge des angegebenen Texts größer als 0 (null) ist.
So fügen Sie Eincheckhinweise hinzu und konfigurieren diese
Klicken Sie in Team Explorer mit der rechten Maustaste auf ein Teamprojekt, klicken Sie auf Teamprojekteinstellungen und dann auf Quellcodeverwaltung.
Das Dialogfeld Einstellungen für Quellcodeverwaltung wird angezeigt.
Klicken Sie auf die Registerkarte Eincheckhinweise und dann auf Hinzufügen.Das Dialogfeld Eincheckhinweis hinzufügen wird angezeigt.
Geben Sie im Dropdown-Listenfeld unter Name den Namen ein, den Sie für den neuen Eincheckhinweis verwenden möchten, z. B. "DOC-Auswirkungen" für das Dokumentationsteam.
Wählen Sie optional Bei Eincheckvorgängen erforderlich aus, und klicken Sie auf Hinzufügen. (Hierdurch wird beim Eincheckvorgang das Hinzufügen von Text für diesen Eincheckhinweis erforderlich.)
Darüber hinaus können Sie die Reihenfolge der Eincheckhinweise verändern, indem Sie einen Eincheckhinweis auswählen und mithilfe der Pfeiltasten verschieben.
Wenn Sie mit den Einstellungen für die Eincheckhinweise zufrieden sind, klicken Sie auf OK.
Der neue Eincheckhinweis wird ab sofort bei Eincheckvorgängen angezeigt.
Um die neuen Eincheckhinweise anzuzeigen, checken Sie eine Datei aus einem ordnungsgemäß konfigurierten Stammordner aus und bearbeiten Sie diese. Checken Sie dann dieÜberarbeitung an der Eingabeaufforderung ein.Wenn Sie den Channel "Eincheckhinweise" im Dialogfeld Einchecken auswählen, sollten die benutzerdefinierten Felder angezeigt werden.
Konfigurieren von vordefinierten Eincheckrichtlinien
Wenn Sie weitere Anpassungen für die Eincheckvorgänge vornehmen möchten, können Sie vordefinierte Eincheckrichtlinien konfigurieren, mit denen die Übereinstimmung von Änderungen mit Organisationsstandards überprüft wird.
So konfigurieren Sie eine vordefinierte Eincheckrichtlinie
Klicken Sie in Team Explorer mit der rechten Maustaste auf das Teamprojekt, klicken Sie auf Teamprojekteinstellungen und dann auf Quellcodeverwaltung.
Das Dialogfeld Einstellungen für Quellcodeverwaltung wird angezeigt.
Klicken Sie auf die Registerkarte Eincheckrichtlinien und dann auf Hinzufügen.
Das Dialogfeld Eincheckrichtlinie hinzufügen wird angezeigt.
Wählen Sie im Listenfeld unter Eincheckrichtlinie den gewünschten Richtlinientyp aus, und klicken Sie auf OK. Die verfügbaren Richtlinientypen sind Builds, Codeanalyse, Testrichtlinie sowie Arbeitsaufgaben.
Wenn Sie Builds ausgewählt haben, wird der Liste die Richtlinie hinzugefügt.Gemäß dieser Richtlinie muss ein vorheriger Build erfolgreich sein, bevor alle neuen Änderungen eingecheckt werden können.
Wenn Sie Codeanalyse ausgewählt haben, wird das Dialogfeld Codeanalyserichtlinien-Editor angezeigt.Klicken Sie auf die Felder für die auszuführenden Codeanalysetypen.Die Optionen lauten Einchecken von Dateien erzwingen, sodass nur Dateien enthalten sind, die Teil der aktuellen Projektmappe sind, C/C++-Codeanalyse erzwingen (/analyze) und Codeanalyse für verwalteten Code erzwingen.Wenn Sie Codeanalyse für verwalteten Code erzwingen auswählen, wählen Sie im Fenster Regeleinstellungen für die Analyse von verwaltetem Code die gewünschten Regeleinstellungen aus.Klicken Sie auf OK.Weitere Informationen über die Verwendung von Codeanalysetools finden Sie unter Richtlinien für die Verwendung von Codeanalysetools.
Wenn Sie Testrichtlinie ausgewählt haben, wird das Dialogfeld Testrichtlinie angezeigt.Klicken Sie auf Durchsuchen, um eine Metadatendatei anzugeben, wählen Sie den gewünschten Test aus, und klicken Sie dann auf OK.
Wenn Sie Arbeitsaufgaben ausgewählt haben, wird der Liste eine Richtlinie hinzugefügt, nach der beim Einchecken eine Arbeitsaufgabe zugeordnet werden muss.
Wenn Sie mit den Einstellungen für die Eincheckrichtlinien zufrieden sind, klicken Sie auf OK.Die neuen Eincheckrichtlinien werden ab sofort bei Eincheckvorgängen angezeigt.
Um die Eincheckrichtlinie anzuzeigen, checken Sie eine Datei aus dem Ordner aus, für den Sie die Richtlinie gerade definiert haben, und bearbeiten Sie die Datei. Checken Sie die Überarbeitung dann mithilfe des Dialogfelds Einchecken oder des Fensters Ausstehende Änderungen in Visual Studio ein.Sie können alternativ auch tf checkin an der Eingabeaufforderung eingeben.Weitere Informationen finden Sie unter Befehl Checkin.
Wenn Sie den Channel Richtlinienwarnungen im Dialogfeld oder im Toolfenster auswählen, wird eine Meldung angezeigt, die angibt, ob die von Ihnen vorgenommenen Änderungen den definierten Eincheckrichtlinien entsprechen.Wenn Sie im Channel Arbeitsaufgaben keine Arbeitsaufgaben ausgewählt haben, wird eine Meldung angezeigt, die angibt, dass gegen die Richtlinie verstoßen wird.Wechseln Sie zum Channel Arbeitsaufgabe, und wählen Sie eine Arbeitsaufgabe aus, die Sie Ihrer Änderung zuordnen möchten, um die Richtlinie zu erfüllen.Alternativ können Sie auch mit dem Einchecken fortfahren, ohne die Richtlinie zu erfüllen.In diesem Fall werden Sie aufgefordert zu erklären, warum Sie die Eincheckrichtlinie überschrieben haben.