Dela via


Använda etiketter för att ta en ögonblicksbild av dina filer i Azure Repos

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

Visual Studio 2019 | Visual Studio 2022

Med TFVC-etiketter (Team Foundation Version Control) kan du ta en ögonblicksbild av dina filer. Senare kan du referera tillbaka till ögonblicksbilden. Med hjälp av etiketten kan du visa, skapa eller till och med återställa en stor uppsättning filer till det tillstånd som de befann sig i när du använde etiketten.

Förutsättningar

  • För att tillämpa en etikett måste du ha behörigheten Etikett inställd på Tillåt.
  • Om du vill hitta, lista eller visa etiketter behöver du ha behörigheten Läs inställd på Tillåt.
  • Om du vill ändra eller ta bort en etikett måste du äga etiketten eller ha behörigheten Administreringsetiketter inställd på Tillåt.

Använda etiketter

I många programvaruprojekt, när koden har nått en rimlig nivå av kvalitet och stabilitet, skapar och släpper teamet en ny version av produkten. Teamet måste markera den aktuella versionen av varje fil. Även om filerna fortsätter att ändras kan teamet fortfarande hämta och skapa den nya versionen av varje fil i projektet.

Teoretiskt sett kan du registrera ID för varje ändringsuppsättning för varje fil manuellt. Men den här typen av process är inte praktisk. TFVC gör jobbet enkelt. Använd en etikett på mappen, grenen eller projektet som innehåller filerna. Du kan ge etiketten ett namn som följer den namngivningskonvention du föredrar. Några exempel på etikettnamn är: "Sprint 5", "M1", "Beta2" och "Release Candidate 0".

När du har tillämpat etiketten kan du använda den för att kvalificera åtgärder som att skapa, förgrena, slå samman, jämföra och hämta specifika versioner av filer och mappar.

Ibland när du har tillämpat en etikett bestämmer du dig för att du behöver ändra den. TFVC ger dig ett sätt att tillämpa en etikett på ytterligare filer, ta bort en etikett från vissa filer och ändra vilken version av en specifik fil som en etikett gäller för.

Tips

Att använda en etikett ger många av samma fördelar som att skapa en gren, men vanligtvis med lägre kostnad och komplexitet. Kompromissen är att för stora databaser kan operationer som sammanslagning ta mycket längre tid än normalt när man arbetar med en etikett.

Använda en etikett

Not

När du använder Visual Studio för att tillämpa en etikett som redan finns tar åtgärden bort etiketten från alla filversioner och tillämpar sedan etiketten. Från kommandotolken är dock etiketteringsåtgärden additiv. Se kommandot Label (Team Foundation Version Control).

  1. I Visual Studio går du till menyn Visa och väljer Andra Windows>Source Control Explorer.

  2. Högerklicka på samlingen, projektet, grenen, mappen eller filen som du vill använda en etikett på i Källkontrollutforskaren och välj sedan Avancerad>Använd etikett. Dialogrutan Ny etikett visas.

  3. I rutan Namn anger du ett namn på etiketten.

  4. (Valfritt) I rutan Kommentar anger du en kommentar.

  5. I listan version är senaste version markerad som standard. Det här alternativet är det som används oftast. Om du behöver etiketten för att rikta in dig på en viss version väljer du något av följande alternativ:

    • Changeset: Ange antalet ändringar i rutan Changeset. Du kan också välja ellipserna (...) för att öppna dialogrutan Sök efter ändringar. Mer information finns i Hitta och visa ändringsuppsättningar.

    • Datum: Ange ett datum i rutan Datum eller välj ett datum i kalendern på den nedrullningsbara menyn.

    • Etikett: Ange en befintlig etikett som den nya etiketten ska baseras på. Ange antingen etikettnamnet i rutan Etikett eller välj ellipserna (...) för att öppna dialogrutan Sök etikett. Mer information finns i Hitta, redigera och ta bort etiketter.

    • Workspace Version: Skapa etiketten för versionen i din arbetsyta.

  6. När du är nöjd med inställningarna gör du något av följande:

    • Om du vill använda etiketten väljer du Skapa.

    • Om du vill använda etiketten och sedan ändra den när den har tillämpats väljer du Skapa och redigera. Den här åtgärden tillämpar etiketten och visar sedan etikettfönstret . Mer information om hur du använder fönstret Etikett för att redigera en etikett finns i Använd fönstret Etikett för att arbeta med etiketter.

Not

När du använder en etikett som använder ett namn som redan finns varnar systemet dig och frågar om du vill fortsätta. Om du väljer OK att fortsätta tar TFVC bort etiketten från alla objekt som inte finns i sökvägen som du använder etiketten på.

Byt namn på en etikett

Du kan inte ändra namnet på en befintlig etikett. Men du kan enkelt använda en ny etikett på exakt samma filer och samma versioner som en annan etikett gäller för.

  1. Högerklicka på projektsamlingsnoden (rotnoden) i Källkontrollutforskaren och välj sedan Avancerat>Använd etikett. Dialogrutan Ny etikett visas.

  2. I rutan Namn anger du ett namn på etiketten.

  3. (Valfritt) I rutan Kommentar anger du en kommentar.

  4. I Version listan väljer du Etikett. Etikettrutan visas.

  5. Utför något av följande steg:

    • Ange namnet på den befintliga etiketten.

    • Välj bläddra-knappen med ellipserna (...) bredvid rutan Etikett om du inte är säker på namnet på den befintliga etiketten. Dialogrutan Sök etikett visas. Använd alternativen i dialogrutan Sök etikett för att filtrera listan med etiketter och hitta den befintliga etikett som du vill använda den nya etiketten på. Mer information finns i Hitta, redigera och ta bort etiketter.

  6. Välj Skapa.

  7. (Valfritt) När du har skapat den nya etiketten kan du ta bort den gamla etiketten. Mer information finns i Hitta, redigera och ta bort etiketter.

Lista, hitta, visa, redigera och ta bort etiketter

Det finns två sätt att lista och hitta etiketter: dialogrutan Sök etikett och fliken Etikett i fönstret Historik. När du har hittat etiketten som du är intresserad av kan du visa, redigera eller ta bort den. Du kan också arbeta med de filer som etiketten gäller för.

Hitta och arbeta med etiketter med hjälp av dialogrutan Sök etikett

  1. I Källkontrollutforskaren går du till menyraden och väljer Arkiv>Källkontroll>Hitta>Hitta etikett. Dialogrutan Sök etikett visas.

  2. (Valfritt) Förfina sökningen genom att utföra ett eller flera av följande steg:

    • I textrutan Namn anger du namnet på etiketten.

    • I listan Project väljer du det projekt som innehåller den etikett som du vill hitta.

    • I textrutan Ägare anger du namnet eller aliaset på etikettens ägare.

  3. Välj Hitta. Listan Resultat visar etiketter som matchar de sökvillkor som du angav.

  4. (Valfritt) Utför något av följande steg:

Lista och arbeta med etiketter som gäller för ett visst objekt

Ibland kanske du inte är säker på namnet på en etikett, men du vet att etiketten har tillämpats på ett visst objekt under versionskontrollen. I följande procedur beskrivs hur du hittar och arbetar med en etikett i den här situationen.

  1. Högerklicka på ett objekt som etiketten tillämpades på i Källkontrollutforskaren och välj sedan Visa historik. Fönstret Historik visas.

  2. Välj fliken Etiketter för att visa listan med etiketter som gäller för det här objektet.

  3. (Valfritt) Utför något av följande steg:

    • Om du vill visa eller redigera en etikett högerklickar du på etiketten och väljer sedan Redigera etikett. Fönstret Etikett visas. Information om hur du använder det här fönstret finns i Använd fönstret Etikett för att arbeta med etiketter.

    • Om du vill ta bort en etikett högerklickar du på etiketten och väljer sedan Ta bort etikett.

    • Högerklicka på etiketten och välj sedan en annan åtgärd, till exempel Hämta den här versionen eller Jämför.

Mer information om hur du använder etikettfliken i fönstret Historik finns i Hämta historiken för ett objekt.

Ladda ned etiketterade versioner av filer till din arbetsyta

Att märka en uppsättning filer är som att ta en ögonblicksbild av hur de fanns vid en viss tidpunkt. Veckor eller månader efter att du har tagit den här ögonblicksbilden kan du behöva visa eller arbeta med filerna som de fanns i ögonblicksbilden. Följande procedur beskriver hur du laddar ned de märkta versionerna av en uppsättning filer till din arbetsyta.

  1. I Source Control Explorer högerklickar du på den projektsamling, projekt, gren eller mapp som innehåller de objekt som du vill ladda ned och väljer sedan Avancerat>Hämta specifik version. Dialogrutan Hämta visas.

  2. I listan Typ väljer du Etikettoch anger sedan antingen etikettnamnet i rutan Etikett eller väljer ellipserna (...) för att öppna dialogrutan Sök etikett. Mer information om hur du använder den här dialogrutan finns i Hitta, redigera och ta bort etiketter.

  3. Välj andra lämpliga alternativ i dialogrutan Hämta.

  4. Välj Hämta.

Använd fönstret Etikett för att arbeta med etiketter

När du har öppnat fönstret Etikett med någon av föregående procedurer är du redo att börja arbeta med etiketten. Överst i fönstret visas kommentaren i en ruta som du kan redigera.

Du kan använda fönstret Etikett för att utföra följande uppgifter:

  • Lägg till ett objekt i etiketten
  • Ta bort ett objekt från etiketten
  • Ändra versionen av en fil
  • Utföra andra åtgärder på ett objekt

Lägg till ett objekt i etiketten

  1. I fönstret Etikett väljer du Lägg till objekt. Dialogrutan Välj objektversion visas.

  2. I dialogrutan Välj objektversion navigerar du till det objekt som du vill lägga till och väljer det.

    Tips

    Du kan markera och hålla ned Ctrl- eller Skift- nycklar och sedan välja flera objekt.

  3. (Valfritt) Om du behöver etiketten för att rikta in dig på en viss version väljer du en version från listan Version:

    • senaste versionen: Använd etiketten på den senaste versionen i versionskontrollsystemet.

    • Changeset: Ange antalet ändringar i rutan Changeset. Du kan också välja ellipserna (...) för att öppna dialogrutan Sök efter ändringar. Mer information finns i Hitta och visa ändringsuppsättningar.

    • Datum: Ange ett datum i rutan Datum eller välj ett datum i kalendern på den nedrullningsbara menyn.

    • Etikett: Ange en befintlig etikett som den nya etiketten ska baseras på. Ange antingen etikettnamnet i rutan Etikett eller välj ellipserna (...) för att öppna dialogrutan Sök etikett. Mer information finns i Hitta, redigera och ta bort etiketter.

    • Workspace Version: Skapa etiketten för versionen på arbetsytan.

  4. Välj OK.

  5. Välj Fil>Spara.

Ta bort ett objekt från etiketten

  1. Leta upp samlingen, projektet, grenen, mappen eller filen som du vill ta bort från den här etiketten i fönstret Etikett.

  2. Högerklicka på objektet och välj Ta bort från etikett. Etiketten tas bort från objektet. Om objektet är en projektsamling, projekt, gren eller mapp tas etiketten också bort från alla objekt som den innehåller.

  3. Välj Fil>Spara.

Ändra versionen av en fil

  1. Leta upp filen som du vill ändra i fönstret Etikett.

  2. Högerklicka på filen och välj Ändra etiketterad version. Dialogrutan Ändra etiketterad version visas.

  3. Välj något av följande värden:

    • senaste versionen: Använd etiketten på den senaste versionen som finns i versionskontroll.

    • Changeset: Ange antalet ändringar i rutan Changeset. Du kan också välja ellipserna (...) för att öppna dialogrutan Sök efter ändringar. Mer information finns i Hitta och visa ändringsuppsättningar.

    • Datum: Ange ett datum i rutan Datum eller välj ett datum i kalendern på den nedrullningsbara menyn.

    • Etikett: Ange en befintlig etikett som den nya etiketten ska baseras på. Välj antingen etikettnamnet i rutan Etikett eller välj ellipserna (...) för att öppna dialogrutan Sök etikett. Mer information finns i Hitta, redigera och ta bort etiketter.

    • Workspace Version: Skapa etiketten för versionen i din arbetsyta.

  4. Välj Fil>Spara.

Utföra andra åtgärder på ett etiketterat objekt

När du högerklickar på ett objekt i fönstret Etikett kan du också välja något av följande kommandon:

Arbeta från kommandotolken

  • Använd kommandot labels för att lista etiketter. Mer information finns i kommandot Labels.

  • Använd kommandot label för att tillämpa eller ta bort en etikett. Mer information finns i kommandot Label (Team Foundation Version Control).

    Tips

    När du använder kommandot label för att tillämpa en etikett kan du ange ett annat omfång än projektet.

Nästa steg