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

• Om du vill använda en etikett måste du ha behörigheten Etikett inställd på Tillåt.
• Om du vill hitta, lista eller visa etiketter måste du ha läsbehörigheten inställd på Tillåt.
• Om du vill ändra eller ta bort en etikett måste du äga etiketten eller ha behörigheten Administrera etiketter 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.

Använda en etikett

1. I Visual Studio går du till menyn Visa och väljer Annan Windows-källkontrollutforskare>.

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>tillämpa etikett. Dialogrutan Ny etikett visas.

3. I rutan Namn anger du ett namn för etiketten.

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

5. I listan Version är den senaste versionen 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:

   • Ändringsuppsättning: Ange antalet ändringar i rutan Ändringsuppsättning . 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.

   • Arbetsyteversion: Skapa etiketten för versionen på 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 använder etiketten och visar sedan fönstret Etikett . Mer information om hur du använder fönstret Etikett för att redigera en etikett finns i Använda fönstret Etikett för att arbeta med etiketter.

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 Avancerad>tillämpa etikett. Dialogrutan Ny etikett visas.

2. I rutan Namn anger du ett namn för etiketten.

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

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

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

   • Ange namnet på den befintliga etiketten.

   • Om du inte är säker på namnet på den befintliga etiketten väljer du b bläddra-knappen med ellipserna (...) bredvid rutan Etikett . 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 Arkivkällkontroll>>Sök efter>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 Projekt väljer du det projekt som innehåller den etikett som du vill hitta.

   • I textrutan Ägare anger du namnet eller aliaset för etikettens ägare.

3. Välj Sök. I listan Resultat visas etiketter som matchar de sökvillkor som du har angett.

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

   • Om du vill visa eller redigera en etikett markerar du den och väljer Redigera. Fönstret Etikett visas. Mer information finns i Använda fönstret Etikett för att arbeta med etiketter.

   • Om du vill ta bort en etikett markerar du den och väljer Ta bort.

   • Välj Stäng.

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ända 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 historik 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 Källkontrollutforskaren högerklickar du på den projektsamling, projekt, gren eller mapp som innehåller de objekt som du vill ladda ned och väljer sedan Avancerad>hämta specifik version. Dialogrutan Hämta visas.

2. I listan Typ väljer du Etikett och anger sedan 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.

   Dricks

   Du kan markera och hålla ned Ctrl- eller Skift-tangenterna 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 i listan Version :

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

   • Ändringsuppsättning: Ange antalet ändringar i rutan Ändringsuppsättning . 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.

   • Arbetsyteversion: Skapa etiketten för versionen på din arbetsyta.

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 märkt version. Dialogrutan Ändra etikettversion visas.

3. Välj ett av följande värden:

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

   • Ändringsuppsättning: Ange antalet ändringar i rutan Ändringsuppsättning . 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.

   • Arbetsyteversion: Skapa etiketten för versionen på 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:

• Visa (endast filer)
• Visa historik
• Jämför (endast filer)
• Kommentera (endast filer)
• Hämta den här versionen

Arbeta från kommandotolken

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

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

  Dricks

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

Nästa steg

• Hitta och visa ändringsuppsättningar
• Skapa och arbeta med arbetsytor
• Referens för behörigheter och grupper
• Använda grenar för att isolera risker i Team Foundation Version Control
• Använda Source Control Explorer för att hantera filer under versionskontroll