Befehl Checkin
Aktualisiert: November 2007
Führt einen Commit für die im aktuellen Arbeitsbereich ausstehenden Änderungen auf dem Server für die Team Foundation-Versionskontrolle aus.
Erforderliche Berechtigungen
Damit Sie den Befehl checkin verwenden können, muss die Berechtigung Einchecken auf Zulassen festgelegt sein. Um die /author-Option zu verwenden, muss die Berechtigung Änderungen anderer Benutzer einchecken ebenfalls auf Zulassen festgelegt sein. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.
tf checkin [/author:author name] [/comment:("comment"|@comment file)]
[/noprompt] [/notes:(“Note Name”=”note text”|@notefile)]
[/override:reasonfile|@reason] [/recursive] [/saved] [/validate]
[itemspec]
Parameter
Argument |
Beschreibung |
|---|---|
authorname |
Der vom Benutzer angegebene Wert für die /author-Option. |
comment |
Ein vom Benutzer bereitgestellter Kommentar über den Eincheckvorgang. |
@comment file |
Der vom Benutzer bereitgestellte Pfad zu einer Datei auf dem Datenträger, die den Kommentar für das Einchecken enthält. |
NoteFieldName=NoteFieldValue |
Legt den Wert des Felds für den Eincheckhinweis fest. Sie können mehrere, durch Semikolons getrennte Ausdrücke der Form "Feld=Wert" bereitstellen. |
Notefile |
Der vom Benutzer bereitgestellte Pfad zu einer Datei auf dem Datenträger, die die Feldnamen und -werte für den Eincheckhinweis im Format "Feld=Wert" enthält. Eine durch Semikolons getrennte Hinweisdatei kann mehrere Zeilen umfassen, zum Beispiel: feld1=wert1; feld2=wert der mehrere Zeilen umfasst;. |
Reasonfile |
Eine vom Benutzer bereitgestellte Beschreibung des Grunds für das Ignorieren der Eincheckrichtlinie. Wenn ein Grund angegeben wird, wird den Team Foundation-Administratoren per E-Mail eine Benachrichtigung über das Umgehen der Richtlinien und diese Erklärung gesendet. |
itemspec |
Gibt eine Datei oder einen Ordner für das Einchecken an. Weitere Informationen über das Verfahren, mit dem Team Foundation durch Analysieren der Dateispezifikationen die Elemente bestimmt, die innerhalb des Bereichs liegen, finden Sie unter Befehlszeilenoptionen. |
Option |
Beschreibung |
|---|---|
/author |
Identifiziert den Autor der angegebenen oder impliziten ausstehenden Änderungen, damit ein Benutzer Änderungen anstelle eines anderen Benutzers einchecken kann. Erfordert die CheckinOther-Berechtigung. |
/comment |
Ordnet dem Changeset einen Kommentar zu. |
/noprompt |
Unterdrückt alle Eingabeaufforderungen. |
/notes |
Stellt einen oder mehrere Eincheckhinweise bereit, die dem Changeset zugeordnet werden können. |
/override |
Ermöglicht Ihnen das Überschreiben von Eincheckrichtlinien. Diese Option ist nur dann erforderlich, wenn Sie trotz einer Eincheckrichtlinie einen Eincheckvorgang durchführen möchten. |
/recursive |
Checkt alle Elemente im angegeben oder impliziten Arbeitsordner sowie in den Unterordnern ein. |
/saved |
Wenn das Einchecken fehlschlägt oder vom Benutzer abgebrochen wird oder wenn der Benutzer die Änderungen aufnimmt, werden die ausgewählten Änderungen, Kommentare, Arbeitsaufgaben, Eincheckhinweise und ggf. die Gründe für das Überschreiben von Richtlinien auf dem Computer gespeichert. Bei Verwendung mit /noprompt checkt die Option /saved die Änderungen mit den Kommentaren and allen anderen gespeicherten Informationen ein, sofern solche vorhanden sind. |
/validate |
Mit der Option /validate können Sie das Einchecken testen, ohne diesen Vorgang tatsächlich auszuführen. Mit der Option /validate werden beim Einchecken die Eincheckrichtlinien und Eincheckhinweise ausgewertet. Außerdem werden Konflikte ermittelt, ohne dass tatsächlich ein Eincheckvorgang durchgeführt wird. Alle Probleme, wie Konflikte, die von dieser Option identifiziert werden, müssen gelöst werden, bevor Sie das Element einchecken. |
Hinweise
Eine ausstehende Änderung umfasst das Hinzufügen, Löschen, Umbenennen, Bearbeiten, Verzweigen und Wiederherstellen von Dateien und Ordnern sowie filetype. Einige Änderungen, z. B. das Bearbeiten und Umbenennen, können gleichzeitig auf ein Element angewendet werden. Eine ausstehende Änderung wurde noch nicht für das Einchecken übermittelt. Weitere Informationen über ausstehende Änderungen sowie eine vollständige Liste der ausstehenden Änderungen in Team Foundation finden Sie unter Ausstehende Änderungen.
Mit dem Befehl checkin wird auf dem Server für die Team Foundation-Versionskontrolle ein Changeset aus einer dynamisch definierten Reihe ausstehender Änderungen, Arbeitsaufgaben, benutzerdefinierten Kommentaren und Systemmetadaten erstellt. Außerdem werden die Änderungen für andere Benutzer verfügbar gemacht. Andere Benutzer können die Änderungen mit dem Befehl get abrufen. Mit den Befehlen history und changeset zeigen Sie Informationen aus Changesets für die von Ihnen übermittelten Änderungen an.
.gif "Hinweis") Hinweis: |
|---|
Da ausstehende Änderungen über die Befehlszeile eingecheckt werden können, besteht die Möglichkeit, dass das Kontextmenü vom Quellcodeverwaltungs-Explorer nicht immer mit dem Status der ausstehenden Änderungen synchronisiert ist. |
Weitere Informationen zur Suche nach dem Befehlszeilendienstprogramm tf finden Sie unter Befehle des Befehlszeilendienstprogramms "Tf".
Der Eincheckvorgang
Der Eincheckvorgang wird atomar ausgeführt. Das bedeutet, dass der Vorgang entweder vollständig erfolgreich durchgeführt wird oder vollständig fehlschlägt. Wenn eine der Änderungen in der Liste der ausstehenden Änderungen nicht auf den Server für die Team Foundation-Versionskontrolle übermittelt werden kann, wird für keine der Änderungen ein Commit durchgeführt und kein Changeset erstellt. Wenn z. B. während des Vorgangs die Netzwerkverbindung ausfällt, schlägt der gesamte Vorgang fehl.
Der erste Schritt beim Eincheckvorgang ist das Auswerten der ausstehenden Änderungen in Bezug auf die Einhaltung der Eincheckrichtlinien. Sie können Eincheckrichtlinien in der Befehlszeile mit der Option /override überschreiben. Sie müssen einen Grund für das Überschreiben der Richtlinien angeben. Dieser Grund wird auf dem Server für die Team Foundation-Versionskontrolle beibehalten und zu einem Attribut der Changesets nach dem Commit. Die Option /override ist hauptsächlich für die Verwendung in Skripts vorgesehen. Weitere Informationen finden Sie unter Gewusst wie: Überschreiben einer Eincheckrichtlinie.
Wenn sich eine Version eines Elements in der Liste ausstehender Änderungen von der letzten Version auf dem Server für die Team Foundation-Versionskontrolle unterscheidet, fordert Sie Team Foundation zunächst zum Auflösen von Konflikten zwischen Ihrer Version und der letzten Version auf dem Server für die Team Foundation-Versionskontrolle auf. Wenn Sie z. B. Version 4 von stellar.cs ausgecheckt haben und die letzte Version auf dem Server für die Team Foundation-Versionskontrolle Version 6 ist, werden Sie zum Auflösen der Konflikte aufgefordert. Wenn die Option /noprompt angegeben wird, wird das Dialogfeld Auflösen angezeigt, in dem Sie Versionsunterschiede ermitteln und auflösen können. Nachdem Sie die Unterschiede aufgelöst und den Code getestet haben, können Sie erneut versuchen, die Änderungen einzuchecken.
Beispiele
Im folgenden Beispiel wird das Dialogfeld Einchecken angezeigt, in dem bereits ausstehende Änderungen ausgewählt wurden, die in einem Sammelvorgang mit allen ausstehenden Änderungen im Arbeitsbereich eingecheckt werden sollen, der c:\projects zugeordnet ist. Wenn Sie auf Einchecken klicken, werden die Elemente einzeln an ein Changeset auf dem Server für die Team Foundation-Versionskontrolle übermittelt. Anschließend wird überprüft, ob die Version auf dem server für die Team Foundation-Versionskontrolle seit dem Auschecken des Elements nicht verändert wurde. Wenn das Einchecken erfolgreich ist, erstellt Team Foundation ein Changeset und zeigt deren Nummer für spätere Verweise an.
c:\projects>tf checkin
Im folgenden Beispiel werden alle ausstehenden Änderungen im aktuellen Arbeitsbereich zusammen mit dem angegebenen Kommentar auf den Server für die Team Foundation-Versionskontrolle übermittelt, um ein neues Changeset zu erstellen.
c:\projects>tf checkin /comment:"Re-implemented Pi calculator" /noprompt
Im folgenden Beispiel werden die ausstehenden Änderungen an 314.cs übermittelt, wobei alle Revisionen im aktuellen Arbeitsbereich als ausstehend beibehalten werden.
c:\projects>tf checkin 314.cs /noprompt
Siehe auch
Aufgaben
Exemplarische Vorgehensweise: Anpassen von Eincheckrichtlinien und -hinweisen
Gewusst wie: Einchecken von ausstehenden Änderungen
Konzepte
Senden von Änderungen an den Versionskontrollserver
Referenz
Befehlszeilensyntax (Team System)