Labels gebruiken om een momentopname van uw bestanden te maken in Azure-opslagplaatsen

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

TfVC-labels (Team Foundation Version Control) bieden een manier om een momentopname van uw bestanden te maken. Later kunt u teruggaan naar die momentopname. Met behulp van uw label kunt u een grote set bestanden weergeven, bouwen of zelfs terugdraaien naar de status waarin ze zich bevonden toen u het label hebt toegepast.

Vereisten

  • Als u een label wilt toepassen, moet de machtiging Label zijn ingesteld op Toestaan.
  • Als u labels wilt zoeken, weergeven of weergeven, moet de machtiging Lezen zijn ingesteld op Toestaan.
  • Als u een label wilt wijzigen of verwijderen, moet u de eigenaar zijn van het label of de machtiging Beheer ister labels instellen op Toestaan.

Labels gebruiken

In veel softwareprojecten, wanneer de code een redelijk kwaliteitsniveau en stabiliteit heeft bereikt, bouwt en publiceert het team een nieuwe versie van het product. Het team moet de huidige versie van elk bestand markeren. Zelfs als de bestanden blijven veranderen, kan het team nog steeds de nieuwe versie van elk bestand in hun project ophalen en bouwen.

Theoretisch kunt u de id van elke wijzigingenset voor elk bestand handmatig vastleggen. Maar dit soort proces is niet praktisch. TFVC maakt de taak eenvoudig. Pas een label toe op de map, vertakking of project die de bestanden bevat. U kunt het label een naam geven die volgt op de naamconventie die u wilt gebruiken. Enkele voorbeelden van labelnamen zijn: 'Sprint 5', 'M1', 'Bèta2' en 'Release Candidate 0'.

Nadat u het label hebt toegepast, kunt u het gebruiken om in aanmerking te komen voor bewerkingen zoals bouwen, vertakken, samenvoegen, vergelijken en verkrijgen van specifieke versies van bestanden en mappen.

Soms besluit u dat u het label moet wijzigen nadat u een label hebt toegepast. TFVC biedt een manier om een label toe te passen op aanvullende bestanden, een label uit bepaalde bestanden te verwijderen en te wijzigen op welke versie van een specifiek bestand een label van toepassing is.

Tip

Het toepassen van een label biedt veel van dezelfde voordelen als het maken van een vertakking, maar meestal met lagere kosten en complexiteit. Het nadeel is dat voor grote databases bewerkingen zoals het samenvoegen veel langer duren dan gebruikelijk bij het uitvoeren van een label.

Een label toepassen

Notitie

Wanneer u Visual Studio gebruikt om een label toe te passen dat al bestaat, verwijdert de bewerking het label uit alle bestandsversies en past u het label vervolgens toe. Vanaf de opdrachtprompt is de labelbewerking echter additief. Zie de opdracht Label (Team Foundation Version Control).

  1. Selecteer in Visual Studio in het menu Beeld de optie Overige Windows-broncodebeheerverkenner>.

  2. Klik in Broncodebeheerverkenner met de rechtermuisknop op de verzameling, het project, de vertakking, de map of het bestand waarop u een label wilt toepassen en selecteer vervolgens Geavanceerd>label toepassen. Het dialoogvenster Nieuw label wordt weergegeven.

  3. Voer in het vak Naam een naam in voor het label.

  4. (Optioneel) Voer een opmerking in het vak Opmerking in.

  5. In de lijst Versie is de meest recente versie standaard geselecteerd. Deze optie is de optie die meestal het meest wordt gebruikt. Als u het label nodig hebt om een specifieke versie te bereiken, selecteert u een van de volgende opties:

    • Wijzigingenset: Geef het aantal wijzigingenset op in het vak Wijzigingenset . U kunt ook het beletselteken (...) selecteren om het dialoogvenster Wijzigingensets zoeken te openen. Zie Wijzigingensets zoeken en weergeven voor meer informatie.

    • Datum: Geef een datum op in het vak Datum of selecteer een datum in de agenda in de vervolgkeuzelijst.

    • Label: Geef een bestaand label op waarop het nieuwe label moet worden gebaseerd. Voer de labelnaam in het vak Label in of selecteer het beletselteken (...) om het dialoogvenster Label zoeken te openen. Zie Labels zoeken, bewerken en verwijderen voor meer informatie.

    • Werkruimteversie: Maak het label voor de versie in uw werkruimte.

  6. Wanneer u tevreden bent met uw instellingen, voert u een van de volgende stappen uit:

Notitie

Wanneer u een label toepast dat gebruikmaakt van een naam die al bestaat, waarschuwt het systeem u en vraagt u of u wilt doorgaan. Als u OK selecteert om door te gaan, verwijdert TFVC dat label uit items die zich niet in het pad bevinden waarop u het label toepast.

De naam van een label wijzigen

U kunt de naam van een bestaand label niet wijzigen. Maar u kunt eenvoudig een nieuw label toepassen op precies dezelfde bestanden en dezelfde versies waarop een ander label van toepassing is.

  1. Klik in Broncodebeheerverkenner met de rechtermuisknop op het projectverzamelingsknooppunt (het hoofdknooppunt) en selecteer vervolgens Geavanceerd>label toepassen. Het dialoogvenster Nieuw label wordt weergegeven.

  2. Voer in het vak Naam een naam in voor het label.

  3. (Optioneel) Voer een opmerking in het vak Opmerking in.

  4. Selecteer Label in de versielijst. Het vak Label wordt weergegeven.

  5. Voer een van de volgende stappen uit:

    • Voer de naam van het bestaande label in.

    • Als u niet zeker bent van de naam van het bestaande label, selecteert u de bladerknop met het beletselteken (...) naast het vak Label . Het dialoogvenster Label zoeken wordt weergegeven. Gebruik de opties in het dialoogvenster Label zoeken om de lijst met labels te filteren en het bestaande label te zoeken waarop u het nieuwe label wilt toepassen. Zie Labels zoeken, bewerken en verwijderen voor meer informatie.

  6. Selecteer Maken.

  7. (Optioneel) Nadat u het nieuwe label hebt gemaakt, kunt u het oude label verwijderen. Zie Labels zoeken, bewerken en verwijderen voor meer informatie.

Labels weergeven, weergeven, bewerken en verwijderen

Er zijn twee manieren om labels weer te geven en te zoeken: het dialoogvenster Label zoeken en het tabblad Label in het venster Geschiedenis . Nadat u het gewenste label hebt gevonden, kunt u het bekijken, bewerken of verwijderen. U kunt ook werken met de bestanden waarop het label van toepassing is.

Labels zoeken en ermee werken met behulp van het dialoogvenster Label zoeken

  1. Selecteer in Broncodebeheerverkenner op de menubalk het zoeklabel voor>bestandsbronbeheer.>> Het dialoogvenster Label zoeken wordt weergegeven.

  2. (Optioneel) Verfijn uw zoekopdracht door een of meer van de volgende stappen uit te voeren:

    • Voer in het tekstvak Naam de naam van het label in.

    • Selecteer in de lijst Project het project met het label dat u wilt zoeken.

    • Voer in het tekstvak Eigenaar de naam of alias in van de eigenaar van het label.

  3. Selecteer Zoeken. In de lijst Met resultaten worden labels weergegeven die overeenkomen met de zoekcriteria die u hebt ingevoerd.

  4. (Optioneel) Voer een van de volgende stappen uit:

    • Als u een label wilt weergeven of bewerken, selecteert u het en selecteert u Bewerken. Het venster Label wordt weergegeven. Zie Het venster Label gebruiken om met labels te werken voor meer informatie.

    • Als u een label wilt verwijderen, selecteert u het en selecteert u Verwijderen.

    • Selecteer Sluiten.

Labels weergeven en gebruiken die van toepassing zijn op een specifiek item

Soms weet u niet zeker van de naam van een label, maar u weet dat het label is toegepast op een bepaald item onder versiebeheer. In de volgende procedure wordt uitgelegd hoe u in deze situatie een label kunt vinden en ermee kunt werken.

  1. Klik in Broncodebeheerverkenner met de rechtermuisknop op een item waarop het label is toegepast en selecteer vervolgens Geschiedenis weergeven. Het venster Geschiedenis wordt weergegeven.

  2. Selecteer het tabblad Labels om de lijst met labels weer te geven die van toepassing zijn op dit item.

  3. (Optioneel) Voer een van de volgende stappen uit:

    • Als u een label wilt weergeven of bewerken, klikt u met de rechtermuisknop op het label en selecteert u Label bewerken. Het venster Label wordt weergegeven. Zie Het venster Label gebruiken om met labels te werken voor meer informatie over het gebruik van dit venster.

    • Als u een label wilt verwijderen, klikt u met de rechtermuisknop op het label en selecteert u Label verwijderen.

    • Klik met de rechtermuisknop op het label en selecteer een andere actie, zoals Deze versie ophalen of Vergelijken.

Zie De geschiedenis van een item ophalen voor meer informatie over het gebruik van het tabblad Label in het venster Geschiedenis.

Gelabelde versies van bestanden downloaden naar uw werkruimte

Het labelen van een set bestanden is als het maken van een momentopname van hoe ze op een bepaald moment bestonden. Weken of maanden nadat u deze momentopname hebt gemaakt, moet u mogelijk de bestanden bekijken of ermee werken zoals ze in die momentopname aanwezig waren. In de volgende procedure wordt uitgelegd hoe u de gelabelde versies van een set bestanden naar uw werkruimte downloadt.

  1. Klik in Broncodebeheerverkenner met de rechtermuisknop op de projectverzameling, project, vertakking of map met de items die u wilt downloaden en selecteer vervolgens Advanced>Get Specific Version. Het dialoogvenster Ophalen wordt weergegeven.

  2. Selecteer Label in de lijst Type en voer vervolgens de labelnaam in het vak Label in of selecteer het beletselteken (...) om het dialoogvenster Label zoeken te openen. Zie Labels zoeken, bewerken en verwijderen voor meer informatie over het gebruik van dit dialoogvenster.

  3. Selecteer eventuele andere geschikte opties in het dialoogvenster Ophalen .

  4. Selecteer Ophalen.

Het venster Label gebruiken om met labels te werken

Nadat u het venster Label hebt geopend met behulp van een van de voorgaande procedures, kunt u aan de slag met het label. Boven aan het venster wordt de opmerking weergegeven die u kunt bewerken.

U kunt het venster Label gebruiken om de volgende taken uit te voeren:

  • Een item toevoegen aan het label
  • Een item uit het label verwijderen
  • De versie van een bestand wijzigen
  • Andere acties uitvoeren op een item

Een item toevoegen aan het label

  1. Selecteer Item toevoegen in het venster Label. Het dialoogvenster Itemversie kiezen wordt weergegeven.

  2. Navigeer in het dialoogvenster Itemversie kiezen naar het item dat u wilt toevoegen en selecteer het.

    Tip

    U kunt de Ctrl- of Shift-toetsen selecteren en vervolgens meerdere items selecteren.

  3. (Optioneel) Als u het label nodig hebt om een specifieke versie te bereiken, selecteert u een versie in de lijst Versie :

    • Nieuwste versie: Pas het label toe op de nieuwste versie die in versiebeheer staat.

    • Wijzigingenset: Geef het aantal wijzigingensets op in het vak Changeset . U kunt ook het beletselteken (...) selecteren om het dialoogvenster Wijzigingensets zoeken te openen. Zie Wijzigingensets zoeken en weergeven voor meer informatie.

    • Datum: Geef een datum op in het vak Datum of selecteer een datum in de agenda in de vervolgkeuzelijst.

    • Label: Geef een bestaand label op waarop het nieuwe label moet worden gebaseerd. Voer de labelnaam in het vak Label in of selecteer het beletselteken (...) om het dialoogvenster Label zoeken te openen. Zie Labels zoeken, bewerken en verwijderen voor meer informatie.

    • Werkruimteversie: Maak het label voor de versie in uw werkruimte.

  4. Selecteer OK.

  5. Selecteer Bestand>Opslaan.

Een item uit het label verwijderen

  1. Zoek in het venster Label de verzameling, het project, de vertakking, de map of het bestand dat u uit dit label wilt verwijderen.

  2. Klik met de rechtermuisknop op het item en selecteer Verwijderen uit label. Het label wordt verwijderd uit het item. Als het item een projectverzameling, project, vertakking of map is, wordt het label ook verwijderd uit alle items die het bevat.

  3. Selecteer Bestand>Opslaan.

De versie van een bestand wijzigen

  1. Zoek in het venster Label het bestand dat u wilt wijzigen.

  2. Klik met de rechtermuisknop op het bestand en selecteer Gelabelde versie wijzigen. Het dialoogvenster Labelversie wijzigen wordt weergegeven.

  3. Selecteer een van de volgende waarden:

    • Nieuwste versie: Pas het label toe op de nieuwste versie die in versiebeheer staat.

    • Wijzigingenset: Geef het aantal wijzigingenset op in het vak Wijzigingenset . U kunt ook het beletselteken (...) selecteren om het dialoogvenster Wijzigingensets zoeken te openen. Zie Wijzigingensets zoeken en weergeven voor meer informatie.

    • Datum: Geef een datum op in het vak Datum of selecteer een datum in de agenda in de vervolgkeuzelijst.

    • Label: Geef een bestaand label op waarop het nieuwe label moet worden gebaseerd. Selecteer de labelnaam in het vak Label of selecteer het beletselteken (...) om het dialoogvenster Label zoeken te openen. Zie Labels zoeken, bewerken en verwijderen voor meer informatie.

    • Werkruimteversie: Maak het label voor de versie in uw werkruimte.

  4. Selecteer Bestand>Opslaan.

Andere acties uitvoeren op een gelabeld item

Wanneer u met de rechtermuisknop op een item in het venster Label klikt, kunt u ook een van de volgende opdrachten selecteren:

Werken vanaf de opdrachtprompt

  • Gebruik de labels opdracht om labels weer te geven. Zie de opdracht Labels voor meer informatie.

  • Gebruik de label opdracht om een label toe te passen of te verwijderen. Zie de opdracht Label (Team Foundation Version Control) voor meer informatie.

    Tip

    Wanneer u de label opdracht gebruikt om een label toe te passen, kunt u een ander bereik dan het project opgeven.

Volgende stappen