Verwenden von Bezeichnungen zum Erstellen einer Momentaufnahme Ihrer Dateien in Azure Repos

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Bezeichnungen der Team Foundation-Versionskontrolle (TFVC) bietet Ihnen die Möglichkeit, eine Momentaufnahme Ihrer Dateien zu erstellen. Später können Sie auf diese Momentaufnahme zurückgreifen. Mit der Bezeichnung können Sie einen großen Satz von Dateien anzeigen, erstellen und sogar wieder in den Zustand versetzen, den sie hatten, als Sie die Bezeichnung angewendet haben.

Voraussetzungen

  • Zum Anwenden einer Bezeichnung muss die Berechtigung Bezeichnen auf Zulassen festgelegt sein.
  • Zum Suchen, Auflisten oder Anzeigen von Bezeichnungen muss die Berechtigung Lesen auf Zulassen festgelegt sein.
  • Zum Ändern oder Löschen einer Bezeichnung muss die Berechtigung Bezeichnungen verwalten auf Zulassen festgelegt sein.

Verwenden von Bezeichnungen

Wenn im Code eine angemessene Qualität und Stabilität erreicht wurde, wird das Team in vielen Softwareprojekten eine neue Version des Produkts erstellen und herausgeben. Das Team muss die aktuelle Version der einzelnen Dateien markieren. Auch wenn sich die Dateien weiter ändern, kann das Team die neue Version jeder Datei in seinem Projekt abrufen und erstellen.

Theoretisch könnten Sie die ID jedes Changesets für jede Datei manuell aufzeichnen. Aber diese Art von Verfahren ist nicht praktikabel. TFVC vereinfacht die Aufgabe. Wenden Sie eine Bezeichnung auf den Ordner, den Branch oder das Projekt an, das die Dateien enthält. Sie können der Bezeichnung einen Namen geben, der einer von Ihnen bevorzugten Benennungskonvention folgt. Beispiele für Bezeichnungsnamen: „Sprint 5“, „M1“, „Beta2“ und „Release Candidate 0“.

Nachdem Sie die Bezeichnung angewendet haben, können Sie damit Vorgänge qualifizieren, z. B. Erstellen, Branchen, Zusammenführen, Vergleichen und Abrufen von bestimmten Versionen von Dateien und Ordnern.

Möglicherweise möchten Sie die Bezeichnung ändern, nachdem Sie sie angewendet haben. TFVC bietet eine Möglichkeit, eine Bezeichnung auf zusätzliche Dateien anzuwenden, eine Bezeichnung von bestimmten Dateien zu entfernen und zu ändern, auf welche Version einer bestimmten Datei eine Bezeichnung angewendet wird.

Tipp

Das Anwenden einer Bezeichnung bietet viele der Vorteile, die auch das Erstellen eines Branches bietet, aber in der Regel mit niedrigeren Kosten und geringerer Komplexität. Der Nachteil ist, dass bei großen Datenbanken Vorgänge wie das Zusammenführen von Daten viel länger dauern können als üblich, wenn sie für eine Bezeichnung ausgeführt werden.

Anwenden einer Bezeichnung

Hinweis

Wenn Sie mithilfe von Visual Studio eine Bezeichnung anwenden, die bereits vorhanden ist, wird bei diesem Vorgang die Bezeichnung aus allen Dateiversionen entfernt, und anschließend wird die Bezeichnung angewendet. Über die Eingabeaufforderung ist dieser Bezeichnungsvorgang jedoch ein zusätzlicher Vorgang. Weitere Informationen finden Sie unter Label-Befehl (Team Foundation-Versionskontrolle).

  1. Wählen Sie in Visual Studio im Menü Ansicht die Option Andere Fenster>Quellcodeverwaltungs-Explorer aus.

  2. Klicken Sie im Quellcodeverwaltungs-Explorer mit der rechten Maustaste auf die Sammlung, das Projekt, den Branch, den Ordner oder die Datei, auf die Sie eine Bezeichnung anwenden möchten, und wählen Sie dann Erweitert>Bezeichnung anwenden aus. Das Dialogfeld Neue Bezeichnung wird angezeigt.

  3. Geben Sie im Feld Name einen Namen für die Bezeichnung ein.

  4. (Optional) Geben Sie im Feld Kommentar einen Kommentar ein.

  5. In der Liste Version ist standardmäßig Neueste Version ausgewählt. Diese Option wird am häufigsten verwendet. Wenn Sie die Bezeichnung auf eine bestimmte Version ausrichten möchten, wählen Sie eine der folgenden Optionen aus:

    • Changeset: Geben Sie die Nummer des Changesets im Feld Changeset an. Alternativ können Sie auch die Auslassungspunkte (...) auswählen, um das Dialogfeld Changesets suchen zu öffnen. Weitere Informationen finden Sie unter Suchen und Anzeigen von Changesets.

    • Datum: Geben Sie ein Datum in das Feld Datum ein, oder wählen Sie ein Datum aus dem Kalender im Dropdownmenü aus.

    • Bezeichnung: Geben Sie ein bestehende Bezeichnung an, auf dem die neue Bezeichnung basieren soll. Geben Sie entweder den Namen der Bezeichnung in das Feld Bezeichnung ein, oder wählen Sie die Auslassungspunkte (...) aus, um das Dialogfeld Bezeichnung suchen zu öffnen. Weitere Informationen finden Sie unter Suchen, Bearbeiten und Entfernen von Bezeichnungen.

    • Arbeitsbereichsversion: Erstellen Sie die Bezeichnung für die Version in Ihrem Arbeitsbereich.

  6. Wenn Sie mit Ihren Einstellungen zufrieden sind, führen Sie einen der folgenden Schritte aus:

    • Um die Bezeichnung anzuwenden, wählen Sie Erstellen aus.

    • Wählen Sie Erstellen und bearbeiten aus, um die Bezeichnung anzuwenden und anschließend zu ändern. Diese Aktion wendet die Bezeichnung an und zeigt dann das Fenster Bezeichnung an. Weitere Informationen zum Verwenden des Fensters Bezeichnung für die Bearbeitung von Bezeichnungen finden Sie unter Verwenden des Fensters „Bezeichnung“ zum Arbeiten mit Bezeichnungen.

Hinweis

Wenn Sie eine Bezeichnung mit einem Namen anwenden, der bereits vorhanden ist, wird eine Warnung angezeigt, und Sie werden gefragt, ob Sie fortfahren möchten. Wenn Sie OK auswählen, um fortzufahren, entfernt TFVC diese Bezeichnung von allen Elementen, die sich nicht in dem Pfad befinden, auf den Sie die Bezeichnung anwenden.

Umbenennen einer Bezeichnung

Sie können den Namen einer vorhandenen Bezeichnung nicht ändern. Sie können jedoch ganz einfach eine neue Bezeichnung auf genau die gleichen Dateien und dieselben Versionen anwenden, auf die eine andere Bezeichnung angewendet wird.

  1. Klicken Sie im Quellcodeverwaltungs-Explorer mit der rechten Maustaste auf den Projektsammlungsknoten (den Stammknoten), und wählen Sie dann Erweitert>Bezeichnung anwenden aus. Das Dialogfeld Neue Bezeichnung wird angezeigt.

  2. Geben Sie im Feld Name einen Namen für die Bezeichnung ein.

  3. (Optional) Geben Sie im Feld Kommentar einen Kommentar ein.

  4. Wählen Sie in der Liste Version die Option Bezeichnung aus. Das Feld Bezeichnung wird angezeigt.

  5. Führen Sie einen der folgenden Schritte aus:

    • Geben Sie den Namen der vorhandenen Bezeichnung ein.

    • Wenn Sie nicht sicher sind, wie der Name der vorhandenen Bezeichnung lautet, wählen Sie neben dem Feld Bezeichnung die Schaltfläche zum Durchsuchen mit den Auslassungspunkten („…“) aus. Das Dialogfeld Bezeichnung suchen wird angezeigt. Verwenden Sie die Optionen im Dialogfeld Bezeichnung suchen, um die Liste der Bezeichnungen zu filtern und die vorhandene Bezeichnung zu finden, auf die Sie die neue Bezeichnung anwenden möchten. Weitere Informationen finden Sie unter Suchen, Bearbeiten und Entfernen von Bezeichnungen.

  6. Klicken Sie auf Erstellen.

  7. (Optional) Nachdem Sie die neue Bezeichnung erstellt haben, können Sie die alte Bezeichnung entfernen. Weitere Informationen finden Sie unter Suchen, Bearbeiten und Entfernen von Bezeichnungen.

Auflisten, Suchen, Anzeigen, Bearbeiten und Entfernen von Bezeichnungen

Es gibt zwei Möglichkeiten, Bezeichnungen aufzulisten und zu finden: das Dialogfeld Bezeichnung suchen und die Registerkarte Bezeichnung im Fenster Verlauf. Nachdem Sie die gewünschte Bezeichnung gefunden haben, können Sie sie anzeigen, bearbeiten oder entfernen. Sie können auch mit den Dateien arbeiten, auf die die Bezeichnung angewendet wird.

Suchen nach und Verwenden von Bezeichnungen mithilfe des Dialogfelds "Bezeichnung suchen"

  1. Wählen Sie im Quellcodeverwaltungs-Explorer in der Menüleiste Datei>Quellcodeverwaltung>Suchen>Bezeichnung suchen aus. Das Dialogfeld Bezeichnung suchen wird angezeigt.

  2. (Optional) Verfeinern Sie die Suche, indem Sie einen oder mehrere der folgenden Schritte ausführen:

    • Geben Sie im Textfeld Name den Namen der Bezeichnung ein.

    • Wählen Sie in der Liste Projekt das Projekt aus, das die Bezeichnung enthält, die Sie finden möchten.

    • Geben Sie im Textfeld Besitzer den Namen oder Alias des Besitzers der Bezeichnung ein.

  3. Wählen Sie Suchen aus. In der Liste Ergebnisse werden Bezeichnungen angezeigt, die den von Ihnen eingegebenen Suchkriterien entsprechen.

  4. (Optional) Führen Sie einen der folgenden Schritte aus:

Auflisten und Verwenden von Bezeichnungen, die für ein bestimmtes Element gelten

Manchmal kennen Sie möglicherweise den Namen einer Bezeichnung nicht genau, wissen aber, dass die Bezeichnung in der Versionskontrolle auf ein bestimmtes Element angewendet wurde. Im folgenden Verfahren wird erklärt, wie Sie in dieser Situation eine Bezeichnung finden und damit arbeiten können.

  1. Klicken Sie im Quellcodeverwaltungs-Explorer mit der rechten Maustaste auf ein Element, auf das die Bezeichnung angewendet wurde, und wählen Sie dann Verlauf anzeigen aus. Das Fenster Verlauf wird angezeigt.

  2. Wählen Sie die Registerkarte Bezeichnungen aus, um die Liste der Bezeichnungen anzuzeigen, die für dieses Element gelten.

  3. (Optional) Führen Sie einen der folgenden Schritte aus:

    • Um eine Bezeichnung anzuzeigen oder zu bearbeiten, klicken Sie mit der rechten Maustaste auf die Bezeichnung und wählen dann Bezeichnung bearbeiten aus. Das Fenster Bezeichnung wird angezeigt. Informationen zum Verwenden dieses Fensters finden Sie unter Verwenden des Fensters „Bezeichnung“ für die Arbeit mit Bezeichnungen.

    • Um eine Bezeichnung zu löschen, klicken Sie mit der rechten Maustaste auf die Bezeichnung und wählen dann Bezeichnung löschen aus.

    • Klicken Sie mit der rechten Maustaste auf die Bezeichnung, und wählen Sie dann eine andere Aktion wie Diese Version abrufen oder Vergleichen aus.

Weitere Informationen zum Verwenden der Registerkarte „Bezeichnung“ im Fenster Verlauf finden Sie unter Abrufen des Verlaufs eines Elements.

Herunterladen von bezeichneten Versionen von Dateien in den Arbeitsbereich

Das Beschriften eines Satzes von Dateien ist wie das Erstellen einer Momentaufnahme der Dateien zu einem bestimmten Zeitpunkt. Wochen oder Monate, nachdem Sie diese Momentaufnahme erstellt haben, müssen Sie möglicherweise die Dateien, so wie sie in dieser Momentaufnahme vorhanden waren, anzeigen oder bearbeiten. Im folgenden Verfahren wird erklärt, wie die bezeichneten Versionen eines Satzes von Dateien in den Arbeitsbereich heruntergeladen werden.

  1. Klicken Sie im Quellcodeverwaltungs-Explorer mit der rechten Maustaste auf die Projektsammlung, das Projekt, den Branch oder den Ordner, der die herunterzuladenden Elemente enthält, und wählen Sie dann Erweitert>Bestimmte Version abrufen aus. Das Dialogfeld Abrufen wird angezeigt.

  2. Wählen Sie in der Liste Typ die Option Bezeichnung aus, und geben Sie dann entweder den Namen der Bezeichnung in das Feld Bezeichnung ein, oder wählen Sie die Auslassungspunkte (...) aus, um das Dialogfeld Bezeichnung suchen zu öffnen. Weitere Informationen zum Verwenden dieses Dialogfelds finden Sie unter Suchen, Bearbeiten und Entfernen von Bezeichnungen.

  3. Wählen Sie im Dialogfeld Abrufen alle anderen geeigneten Optionen aus.

  4. Wählen Sie Abrufen aus.

Verwenden des Fensters „Bezeichnung“ für die Arbeit mit Bezeichnungen

Nachdem Sie das Fenster Bezeichnung mit einem der vorangehenden Verfahren geöffnet haben, können Sie die Arbeit mit der Bezeichnung aufnehmen. Am oberen Rand des Fensters wird ein Feld mit dem Kommentar angezeigt, den Sie bearbeiten können.

Sie können das Fenster Bezeichnung verwenden, um die folgenden Aufgaben auszuführen:

  • Hinzufügen eines Elements zur Bezeichnung
  • Entfernen eines Elements aus der Bezeichnung
  • Ändern der Version einer Datei
  • Ausführen von anderen Aktionen mit einem Element

Hinzufügen eines Elements zur Bezeichnung

  1. Wählen Sie im Fenster Bezeichnung die Option Element hinzufügen aus. Das Dialogfeld Elementversion auswählen wird angezeigt.

  2. Navigieren Sie im Dialogfeld Elementversion auswählen zu dem Element, das Sie hinzufügen möchten, und wählen Sie es aus.

    Tipp

    Sie können die STRG- oder die UMSCHALTTASTE gedrückt halten und dann mehrere Elemente auswählen.

  3. (Optional) Wenn die Bezeichnung auf eine bestimmte Version verweisen soll, wählen Sie aus der Liste Version eine Version aus:

    • Neuste Version: Die Bezeichnung wird auf die letzte Version angewendet, die in der Versionskontrolle vorhanden ist.

    • Changeset: Geben Sie die Nummer eines Changesets im Feld Changeset an. Alternativ können Sie auch die Auslassungspunkte (...) auswählen, um das Dialogfeld Changesets suchen zu öffnen. Weitere Informationen finden Sie unter Suchen und Anzeigen von Changesets.

    • Datum: Geben Sie ein Datum in das Feld Datum ein, oder wählen Sie ein Datum aus dem Kalender im Dropdownmenü aus.

    • Bezeichnung: Geben Sie ein bestehende Bezeichnung an, auf dem die neue Bezeichnung basieren soll. Geben Sie entweder den Namen der Bezeichnung in das Feld Bezeichnung ein, oder wählen Sie die Auslassungspunkte (...) aus, um das Dialogfeld Bezeichnung suchen zu öffnen. Weitere Informationen finden Sie unter Suchen, Bearbeiten und Entfernen von Bezeichnungen.

    • Arbeitsbereichsversion: Erstellen Sie die Bezeichnung für die Version in Ihrem Arbeitsbereich.

  4. Klicken Sie auf OK.

  5. Wählen Sie Datei>Speichern aus.

Entfernen eines Elements aus der Bezeichnung

  1. Suchen Sie im Fenster „Bezeichnung“ die Sammlung, das Projekt, den Branch, den Ordner oder die Datei, die Sie aus dieser Bezeichnung entfernen möchten.

  2. Klicken Sie mit der rechten Maustaste auf das Element, und wählen Sie Aus Bezeichnung entfernen aus. Die Bezeichnung wird vom Element entfernt. Wenn das Element eine Projektsammlung, ein Projekt, ein Branch oder ein Ordner ist, dann wird die Bezeichnung auch von allen Elementen entfernt, die darin enthalten sind.

  3. Wählen Sie Datei>Speichern aus.

Ändern der Version einer Datei

  1. Suchen Sie im Fenster Bezeichnung die Datei, die Sie ändern möchten.

  2. Klicken Sie mit der rechten Maustaste auf die Datei, und wählen Sie Bezeichnete Version ändern aus. Das Dialogfeld Bezeichnete Version ändern wird angezeigt.

  3. Folgende Werte sind möglich:

    • Neuste Version: Die Bezeichnung wird auf die letzte Version angewendet, die in der Versionskontrolle vorhanden ist.

    • Changeset: Geben Sie die Nummer des Changesets im Feld Changeset an. Alternativ können Sie auch die Auslassungspunkte (...) auswählen, um das Dialogfeld Changesets suchen zu öffnen. Weitere Informationen finden Sie unter Suchen und Anzeigen von Changesets.

    • Datum: Geben Sie ein Datum in das Feld Datum ein, oder wählen Sie ein Datum aus dem Kalender im Dropdownmenü aus.

    • Bezeichnung: Geben Sie ein bestehende Bezeichnung an, auf dem die neue Bezeichnung basieren soll. Wählen Sie entweder den Namen der Bezeichnung im Feld Bezeichnung oder die Auslassungspunkte (...) aus, um das Dialogfeld Bezeichnung suchen zu öffnen. Weitere Informationen finden Sie unter Suchen, Bearbeiten und Entfernen von Bezeichnungen.

    • Arbeitsbereichsversion: Erstellen Sie die Bezeichnung für die Version in Ihrem Arbeitsbereich.

  4. Wählen Sie Datei>Speichern aus.

Ausführen von anderen Aktionen mit einem Element mit Bezeichnung

Wenn Sie im Fenster „Bezeichnung“ mit der rechten Maustaste auf ein Element klicken, können Sie auch einen der folgenden Befehle auswählen:

Über die Eingabeaufforderung arbeiten

  • Verwenden Sie den labels-Befehl, um Bezeichnungen aufzulisten. Weitere Informationen finden Sie unter Labels-Befehl.

  • Verwenden Sie den label-Befehl, um eine Bezeichnung anzuwenden oder zu entfernen. Weitere Informationen finden Sie unter Label-Befehl (Team Foundation-Versionskontrolle).

    Tipp

    Wenn Sie den label-Befehl verwenden, um eine Bezeichnung anzuwenden, können Sie einen anderen Bereich als das Projekt angeben.

Nächste Schritte