Teilen über

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 Ihrem Label können Sie einen großen Satz von Dateien anzeigen, erstellen oder sogar in den Zustand zurückversetzen, in dem sie sich befanden, als Sie das Label angewendet haben.

Voraussetzungen

  • Um eine Kennzeichnung anzuwenden, müssen Sie die Berechtigung Kennzeichnung auf Zulassen festlegen.
  • Um Kennzeichnungen zu suchen, aufzulisten oder zu sehen, müssen Sie die Berechtigung Lesen auf Zulassen festlegen.
  • Zum Ändern oder Löschen einer Bezeichnung muss die Berechtigung Bezeichnungen verwalten auf Zulassen festgelegt sein.

Etiketten verwenden

In vielen Softwareprojekten, wenn der Code ein angemessenes Qualitäts- und Stabilitätsniveau erreicht hat, erstellt und veröffentlicht das Team eine neue Version des Produkts. Das Team muss die aktuelle Version jeder Datei markieren. Auch wenn sich die Dateien weiterhin ändern, kann das Team weiterhin die neue Version jeder Datei in ihrem Projekt abrufen und erstellen.

Theoretisch könnten Sie die ID der einzelnen Änderungen für jede Datei manuell aufzeichnen. Aber diese Art von Prozess ist nicht praktisch. TFVC macht den Job einfach. Wenden Sie eine Bezeichnung auf den Ordner, den Branch oder das Projekt an, das die Dateien enthält. Sie können dem Etikett einen Namen geben, der Ihrer bevorzugten Benennungskonvention entspricht. Einige Beispiele für Bezeichnungsnamen sind: "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 aus 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 gleichen Vorteile wie das Erstellen einer Filiale, in der Regel aber mit geringeren Kosten und 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

Anmerkung

Wenn Sie Visual Studio verwenden, um eine bereits vorhandene Bezeichnung anzuwenden, entfernt der Vorgang die Bezeichnung aus allen Dateiversionen und wendet dann die Bezeichnung an. Ü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 das Etikett 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 ist die am häufigsten verwendete Option. Wenn Sie die Bezeichnung für eine bestimmte Version benötigen, wählen Sie eine der folgenden Optionen aus:

    • Änderungssatz: Geben Sie die Nummer des Änderungssatzes in das Feld Änderungssatz ein. 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 im Feld Datum an, oder wählen Sie ein Datum aus dem Kalender im Dropdownmenü aus.

    • Bezeichnung: Geben Sie eine vorhandene Bezeichnung an, auf der die neue Bezeichnung basiert. 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.

    • Arbeitsbereich-Version: Erstellen Sie die Kennzeichnung 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.

Anmerkung

Wenn Sie eine Bezeichnung anwenden, die einen bereits vorhandenen Namen verwendet, warnt Das System Sie und fragt, ob Sie den Vorgang fortsetzen möchten. Wenn Sie OK auswählen, um fortzufahren, entfernt TFVC das Label aus allen Elementen, die sich nicht in dem Pfad befinden, auf den Sie das Label 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 das Label 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 des vorhandenen Etiketts 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 Label finden, um die Liste der Labels zu filtern und das vorhandene Label zu suchen, auf das Sie das neue Label 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.

Finden und arbeiten Sie mit 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 Ihre Suche, indem Sie eine 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 sind Sie sich des Namens eines Labels möglicherweise nicht sicher, aber Sie wissen, dass das Label auf ein bestimmtes Objekt unter Versionskontrolle 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 Label anzuzeigen oder zu bearbeiten, klicken Sie mit der rechten Maustaste auf das Label, und wählen Sie dann Edit Labelaus. 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.

Laden Sie markierte Versionen von Dateien in Ihren Arbeitsbereich herunter.

Das Labeln einer Gruppe von Dateien ist wie das Erstellen einer Momentaufnahme davon, wie sie zu einem bestimmten Zeitpunkt vorlagen. 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 erläutert, wie Sie die bezeichneten Versionen einer Gruppe von Dateien in Ihren Arbeitsbereich herunterladen.

  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 zur Verwendung 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. Oben im Fenster zeigt ein Feld den Kommentar an, den Sie bearbeiten können.

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

  • Fügen Sie ein Element zum Etikett hinzu
  • Entfernen eines Elements aus der Bezeichnung
  • Ändern der Version einer Datei
  • Ausführen anderer Aktionen an einem Element

Füge ein Element zur Bezeichnung hinzu

  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 Sie die Bezeichnung für eine bestimmte Version benötigen, wählen Sie in der Liste Version eine Version aus:

    • Letzte Version: Wenden Sie die Kennzeichnung auf die letzte Version an, die sich in der Versionsverwaltung befindet.

    • Änderungssatz: Geben Sie die Nummer eines Änderungssatzes in das Feld Änderungssatz ein. 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 im Feld Datum an, oder wählen Sie ein Datum aus dem Kalender im Dropdownmenü aus.

    • Kennzeichnung: Geben Sie eine vorhandene Kennzeichnung an, auf der die neue Kennzeichnung 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.

    • Arbeitsbereich-Version: Erstellen Sie die Kennzeichnung für die Version in Ihrem Arbeitsbereich.

  4. Wählen Sie OKaus.

  5. Wählen Sie Datei>Speichern aus.

Entfernen eines Elements aus der Bezeichnung

  1. Suchen Sie im Fenster "Label" die Sammlung, das Projekt, den Branch, den Ordner oder die Datei, die Sie aus diesem Label entfernen möchten.

  2. Klicken Sie mit der rechten Maustaste auf das Element, und wählen Sie Aus Bezeichnung entfernen aus. Das Etikett wird vom Artikel 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. Wählen Sie einen der folgenden Werte aus:

    • Letzte Version: Wenden Sie die Kennzeichnung auf die letzte Version an, die sich in der Versionsverwaltung befindet.

    • Änderungssatz: Geben Sie die Nummer des Änderungssatzes in das Feld Änderungssatz ein. 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 im Feld Datum an, oder wählen Sie ein Datum aus dem Kalender im Dropdownmenü aus.

    • Kennzeichnung: Geben Sie eine vorhandene Kennzeichnung an, auf der die neue Kennzeichnung 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.

    • Arbeitsbereich-Version: Erstellen Sie die Kennzeichnung für die Version in Ihrem Arbeitsbereich.

  4. Wählen Sie Datei>Speichern aus.

Andere Aktionen an einem bezeichneten Element ausführen.

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 Befehl label, um eine Bezeichnung anzuwenden oder zu entfernen. Weitere Informationen finden Sie unter Label-Befehl (Team Foundation-Versionskontrolle).

    Tipp

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

Nächste Schritte