Einchecken von Arbeit in die Team-Codebase

Auf der Seite Ausstehende Änderungen (Tastatur: STRG + 0, P) können Sie den Code in der Codebase des Teams einchecken.

Was möchten Sie tun?

• Angeben der Dateien, die eingecheckt werden sollen

• Zuordnen von Arbeitsaufgaben

• Einchecken der Änderungen

• Auflösen der Eincheckrichtlinienwarnungen

• Durchführen eines begrenzten Eincheckvorgangs

• Benachrichtigungen abonnieren

• Über die Eingabeaufforderung arbeiten

• Abrufen von Tipps

Angeben der Dateien, die eingecheckt werden sollen

Sie können angeben, welche Dateiänderungen Sie einchecken möchten, indem Sie sie zwischen den Abschnitten Eingeschlossene Änderungen und Ausgeschlossene Änderungen der Seite Ausstehende Änderungen ziehen. Sie können auch den Umfang für das Einchecken festlegen, wenn Sie in anderen Bereichen von Visual Studio arbeiten:

• Wählen Sie im Projektmappen-Explorer eine der folgenden Optionen aus:

  • Projektmappe

  • Mindestens ein Codeprojekt

  • Mindestens eine Datei

  Wenn Sie die Elemente ausgewählt haben, öffnen Sie das Kontextmenü, und wählen Sie Einchecken aus.

• Wählen Sie im Quellcodeverwaltungs-Explorer ein oder mehrere Elemente mit ausstehenden Änderungen oder einen oder mehrere Ordner aus, die Elemente mit ausstehenden Änderungen enthalten. (Elemente mit ausstehenden Änderungen werden mit diesem Symbol gekennzeichnet: ). Öffnen Sie das Kontextmenü für die ausgewählten Elemente, und wählen Sie Einchecken aus.

Zuordnen von Arbeitsaufgaben

In der Regel ändern Sie Dateien in der Codebase, um eine Aufgabe abzuschließen, einen Fehler zu reparieren oder die Anforderung eines anderen Arbeitsaufgabentyps zu erfüllen. Wenn Sie die Änderungen einchecken, sollten Sie solche Arbeitsaufgaben den Änderungen zuordnen, die Sie einchecken. Dies hat folgende Vorteile:

• Ein Teammitglied, das die Arbeitsaufgabe überprüft, kann eine direkte Verknüpfung mit dem Changeset herstellen, um die Aufgaben anzusehen, die Sie ausgeführt haben.

• Ein Teammitglied, das die Versionsgeschichte einer von Ihnen geänderten Datei überprüft, kann das Changeset und die Arbeitsaufgaben anzeigen, aufgrund derer die Änderung vorgenommen wurde.

• Wenn Sie die Änderungen im automatisierten Buildsystem erstellen (z. B. mit einem CI-Build oder einemAbgegrenzten Eincheckbuild), können die Teammitglieder sehen, in welchem fertig gestellten Build die Aufgabe abgeschlossen oder der Fehler behoben wurde.

So ordnen Sie dem Eincheckvorgang Arbeitsaufgaben zu:

• Klicken Sie im Abschnitt Verknüpfte Arbeitsaufgaben auf den Link Arbeitsaufgabe nach ID hinzufügen.

• Ziehen Sie eine Arbeitsaufgabe vom einem Abfragefenster in den Abschnitt Verknüpfte Arbeitsaufgaben.

Wählen Sie neben jeder Arbeitsaufgabe aus, wie sie mit den eingecheckten Elementen verknüpft werden soll: Zuordnen oder Lösen (nur verfügbar, wenn sich die Arbeitsaufgabe nicht bereits in einem Zustand befindet, der diese Beziehung verhindert, wie beispielsweise Gelöst, Fertig oder Geschlossen).

Einchecken der Änderungen

So checken Sie die Änderungen ein

1. Wählen Sie in Team Explorer die Option Startseite und dann Ausstehende Änderungen (Tastatur: STRG + 0, P) aus.

2. Geben Sie auf der Seite Ausstehende Änderungen einen Kommentar ein, damit die Teamkollegen, die später die Verlaufsgeschichte der Dateien überprüfen und verstehen müssen, nachvollziehen können, was Sie gemacht haben. Beispiel: Implementierter Einkaufswagencontroller.

3. Einige Teams bevorzugen, dass die Teammitglieder für jeden Eincheckvorgang bestimmte Arten von Informationen bereitstellen. In einigen Fällen implementieren sie sogar eine Eincheckrichtlinie, um dies zu erzwingen. Wenn der Administrator des Teamprojekts Einchecknotizen aktiviert hat, können Sie die Informationen in den einzelnen Feldern im Abschnitt Notizen eingeben.

4. Klicken Sie auf die Schaltfläche Einchecken.

Einer der folgenden Vorgänge wird ausgeführt:

Die Änderungen werden eingecheckt.

Alle enthaltenen Dateiänderungen aus dem Arbeitsbereich werden zusammen mit dem Kommentar, den Einchecknotizen und den Links zu verknüpften Arbeitsaufgaben als ein einzelnes Changeset auf dem Server gespeichert.

Konflikte blockieren das Einchecken.

Das System zeigt Konflikte zwischen den Änderungen und der aktuellen Version der Dateien auf dem Server. Siehe Lösen von Konflikten der Team Foundation-Versionskontrolle.

Der Eincheckvorgang wird blockiert, da er gegen eine Eincheckrichtlinie verstößt.

Administratoren des Teamprojekts können Eincheckrichtlinien implementieren, um die Verwendung von empfohlenen Vorgehensweisen im Team durchzusetzen. Beispielsweise kann durch eine Eincheckrichtlinie erreicht werden, dass Teammitglieder ihren Änderungen mindestens eine Arbeitsaufgabe zuzuordnen. Weitere Informationen finden Sie unter Set and Enforce Quality Gates.

Sie können diese Eincheckrichtlinien in einigen Fällen auch bei Bedarf überschreiben. Wählen Sie im Abschnitt Richtlinienwarnungendie Option Überschreibungswarnungen aus.

Erläutern Sie im Feld Grund, warum Sie die Richtlinie überschreiben möchten.

Verwenden Sie zum Einchecken einen Ordner, der von einem Buildprozess mit abgegrenztem Eincheckvorgang gesteuert wird

Wenn Sie Änderungen in Versionskontrollordner einchecken, die von einem abgegrenzten Eincheckbuild gesteuert werden, wird das Dialogfeld Abgegrenzter Eincheckvorgang angezeigt. Informationen zum Abschließen des Eincheckvorgangs finden Sie unter Einchecken ausstehender Änderungen für einen abgegrenzten Eincheckbuild.

Benachrichtigungen abonnieren

Wenn Sie benachrichtigt werden möchten, sobald jemand Code im TFVC-Teamprojekt eincheckt, können Sie E-Mail-Benachrichtigungen abonnieren. Gehen Sie folgendermaßen vor:

Über die Eingabeaufforderung arbeiten

• Befehl Checkin: Anzeigen ausstehender Änderungen und Einchecken von Dateien

Tipps

• Sie können die Seite Ausstehende Änderungen von Team Explorer lösen und sie in einem neuen Fenster öffnen.

• Im Menü Aktionen können Sie zwischen Listenansicht und Strukturansicht wechseln.

• Bevor Sie den neuen Code einchecken, sollten Sie eine Codeüberprüfung ausführen. Siehe Halten Sie die Arbeit an, reparieren Sie einen Fehler und leiten Sie eine Codeüberprüfung.

• Sie können die ausstehenden Änderungen verwalten und ggf. rückgängig machen. Siehe Entwickeln von Code und Verwalten von ausstehenden Änderungen.

• Informationen zum Zurückstellen von Änderungen finden Sie unter Unterbrechen der Arbeit und Verwalten von Shelvesets.

• Ein Eincheckvorgang wird automatisch ausgeführt. Dieser Vorgang wird entweder vollständig erfolgreich ausgeführt oder schlägt vollständig fehl (mit einer Ausnahme). Wenn eine der Änderungen nicht an den Team Foundation-Server gesendet werden kann, wird für keine der Änderungen ein Commit ausgeführt, und es wird kein Changeset erstellt. Wenn z. B. während des Eincheckvorgangs die Netzwerkverbindung ausfällt, schlägt der gesamte Vorgang fehl.

  Die Ausnahme ist die Zuordnung von Arbeitsaufgaben zum Changeset. Wenn die Zuordnung der Arbeitsaufgaben fehlschlägt, aber alle anderen Aspekte des Eincheckens werden erfolgreich ausgeführt, wird das Changeset erstellt. Sie können eine Arbeitsaufgabe manuell einem Changeset zuordnen. Siehe Verknüpfen von Arbeitsaufgaben zur Unterstützung der Rückverfolgbarkeit.