Utilizzare le etichette per eseguire uno snapshot dei file

Le etichette consentono di eseguire uno snapshot dei file in modo da potervi fare riferimento in futuro. Tramite l'etichetta, è possibile visualizzare, compilare o ripristinare numerosi file allo stato in cui si trovavano quando è stata applicata l'etichetta.

Autorizzazioni necessarie

Per applicare un'etichetta, è necessario che l'autorizzazione Etichetta sia impostata su Consenti. Per trovare, elencare o visualizzare le etichette, è necessario che l'autorizzazione Lettura sia impostata su Consenti. Per modificare o eliminare un'etichetta, è necessario essere proprietario dell'etichetta o disporre dell'autorizzazione Amministra etichette impostata su Consenti.

In questo articolo

• Utilizzo di etichette

• Applicare un'etichetta

• Rinominare un'etichetta

• Elencare, trovare, visualizzare, modificare e rimuovere etichette

• Scaricare versioni dei file con etichetta nell'area di lavoro

• Utilizzare la finestra Etichetta per gestire le etichette

• Ripristinare i file alla versione con etichetta

• Utilizzare le etichette dalla riga di comando

Utilizzo di etichette

In molti progetti software, quando il codice raggiunge un livello ragionevole di qualità e stabilità, il team compilerà e rilascerà una nuova versione del prodotto. Il team deve contrassegnare la versione corrente di ogni file in modo che, anche se i file continuano a cambiare, il team possa ancora ottenere e compilare la nuova versione di ogni file nel progetto.

Sebbene questo tipo di processo non sia pratico, teoricamente, è possibile registrare manualmente l'ID di ogni set di modifiche per ogni file. Controllo della versione di Team Foundation semplifica il processo: viene applicata un'etichetta alla cartella, il ramo o il progetto team che contiene i file. È possibile assegnare all'etichetta un nome che segua la convenzione di denominazione desiderata. Alcuni esempi di nomi di etichetta includono: "Sprint 5", "M1", "Beta2" e "Versione finale candidata 0".

Dopo aver applicato l'etichetta, è possibile utilizzarla per qualificare operazioni quali compilazione, creazione di un ramo, unione, confronto e acquisizione di versioni specifiche di file e cartelle.

A volte è necessario modificare un'etichetta dopo averla applicata. Controllo della versione di Team Foundation consente di applicare un'etichetta a file aggiuntivi, rimuovere un'etichetta da determinati file e anche modificare la versione di un file specifico a cui è applicata l'etichetta.

Suggerimento
L'applicazione di un'etichetta fornisce molti dei vantaggi offerti dalla creazione di un ramo, ma in genere implica costi e complessità inferiori.

Applicare un'etichetta

Applicare un'etichetta

1. In Esplora controllo codice sorgente fare clic con il pulsante destro del mouse sull'insieme, il progetto team, il ramo, la cartella o il file a cui si desidera applicare un'etichetta quindi fare clic su Applica etichetta.

   Verrà visualizzata la finestra di dialogo Nuova etichetta.

2. Immettere un nome per l'etichetta nella casella Nome.

3. (Facoltativo) Immettere i commenti nella casella Commento.

4. Nell'elenco Versione, per impostazione predefinita viene selezionato Ultima versione. Questa è l'opzione più utilizzata, ma se è necessario assegnare l'etichetta a una versione specifica, è possibile selezionare una delle altre opzioni seguenti:

   • Se si sceglie Set di modifiche è possibile specificare il numero del set di modifiche nella casella Set di modifiche. In alternativa, fare clic sui puntini di sospensione (…) per aprire la finestra di dialogo Trova insiemi di modifiche. Per ulteriori informazioni, vedere Ottenere informazioni relative a un insieme di modifiche.

   • Se si sceglie Data è possibile specificare una data nella casella Data oppure selezionare una data dal calendario nel menu a discesa.

   • Scegliendo Etichetta, è possibile specificare un'etichetta esistente sulla quale basare la nuova etichetta. Digitare il nome dell'etichetta nella casella Etichetta o fare clic sui puntini di sospensione (…) per aprire la finestra di dialogo Trova etichetta. Per ulteriori informazioni, vedere Trovare, modificare e rimuovere etichette.

   • Se si sceglie Versione area di lavoro verrà creata l'etichetta per la versione che si trova nell'area di lavoro.

5. Una volta definite le impostazioni desiderate, eseguire una delle operazioni seguenti:

   • Per applicare l'etichetta, fare clic su Crea.

   • Per applicare e successivamente modificare l'etichetta, fare clic su Crea e modifica. In questo modo viene applicata l'etichetta e quindi viene visualizzata la finestra Etichetta. Per ulteriori informazioni sull'utilizzo della finestra Etichetta per modificare un'etichetta, vedere Utilizzare la finestra Etichetta per utilizzare etichette.

Nota

Quando si applica un'etichetta con un nome già esistente, il sistema genera un messaggio di avviso e viene richiesto se si desidera continuare. Facendo clic su OK per continuare, qualsiasi elemento non contenuto nel percorso al quale si applica l'etichetta non disporrà più di quell'etichetta.

Rinominare un'etichetta

Sebbene non sia possibile modificare il nome di un'etichetta esistente, è possibile applicare facilmente una nuova etichetta esattamente agli stessi file e le stesse versioni a cui è applicata un'altra etichetta.

Applicare un'etichetta basata su un'etichetta esistente

1. In Esplora controllo codice sorgente, fare clic con il pulsante destro del mouse sul nodo dell'insieme di progetti (il nodo radice), quindi fare clic su Applica etichetta.

   Verrà visualizzata la finestra di dialogo Nuova etichetta.

2. Immettere un nome per l'etichetta nella casella Nome.

3. (Facoltativo) Immettere un commento nella casella Commento.

4. Selezionare Etichetta dall'elenco Versione.

   Viene visualizzata la casella Etichetta.

5. Eseguire una delle operazioni seguenti:

   • Immettere il nome dell'etichetta esistente.

   • In caso di dubbi sul nome dell'etichetta esistente, fare clic sul pulsante sfoglia con i puntini di sospensione (...) accanto alla casella Etichetta.

     Verrà visualizzata la finestra di dialogo Trova etichetta.

     Utilizzare le opzioni nella finestra di dialogo Trova etichetta per filtrare l'elenco di etichette e individuare l'etichetta esistente a cui applicare quella nuova. Per ulteriori informazioni, vedere Trovare, modificare e rimuovere etichette.

6. Fare clic su Crea.

7. (Facoltativo) Dopo aver creato la nuova etichetta, è possibile rimuovere l'etichetta obsoleta. Per ulteriori informazioni, vedere Trovare, modificare e rimuovere etichette.

Elencare, trovare, visualizzare, modificare e rimuovere etichette

È possibile elencare e trovare le etichette in due modi: la finestra di dialogo Trova etichetta e la scheda Etichetta nella finestra Cronologia. Dopo avere trovato l'etichetta desiderata, è possibile visualizzarla, modificarla, rimuoverla o utilizzare i file a cui viene applicata.

Trovare e utilizzare etichette tramite la finestra di dialogo Trova etichetta

1. In Esplora controllo codice sorgente, nel menu File scegliere Controllo del codice sorgente quindi Etichetta e Trova etichetta.

   Verrà visualizzata la finestra di dialogo Trova etichetta.

2. (Facoltativo) Perfezionare la ricerca eseguendo almeno uno dei passaggi seguenti:

   • Nella casella di testo Nome, immettere il nome dell'etichetta.

   • Nell'elenco Progetto, selezionare il progetto team che contiene l'etichetta desiderata.

   • Nella casella di testo Proprietario, digitare il nome o l'alias del proprietario dell'etichetta.

3. Scegliere Trova.

   Nell'elenco Risultati vengono visualizzate le etichette che corrispondono ai criteri di ricerca immessi.

4. (Facoltativo) Eseguire una delle operazioni seguenti:

   • Per visualizzare o modificare un'etichetta, selezionarla e fare clic su Modifica.

     Viene visualizzata la finestra Etichetta. Per ulteriori informazioni, vedere Utilizzare la finestra Etichetta per gestire le etichette.

   • Per eliminare un'etichetta, selezionarla e fare clic su Elimina.

   • Scegliere Chiudi.

A volte pur non essendo certi del nome dell'etichetta, si conosce l'elemento a cui è stata applicata l'etichetta sotto controllo della versione. Nella procedura riportata di seguito viene descritto come trovare e quindi utilizzare un'etichetta in una situazione simile.

Elencare e utilizzare etichette che si applicano a un elemento specifico

1. In Esplora controllo codice sorgente fare clic con il pulsante destro del mouse sull'elemento a cui si applica l'etichetta che si desidera trovare, quindi scegliere Visualizza cronologia.

   Viene visualizzata la finestra Cronologia.

2. Fare clic sulla scheda Etichette per visualizzare l'elenco di etichette che si applicano a questo elemento.

3. (Facoltativo) Eseguire una delle operazioni seguenti:

   • Per visualizzare o modificare un'etichetta, fare clic con il pulsante destro del mouse su di essa e selezionare Modifica etichetta.

     Viene visualizzata la finestra Etichetta. Per informazioni sull'utilizzo di questa finestra, vedere Utilizzare la finestra Etichetta per gestire le etichette.

   • Per eliminare un'etichetta, fare clic con il pulsante destro del mouse su di essa e selezionare Elimina etichetta.

   • Fare clic con il pulsante destro del mouse sull'etichetta e selezionare altre azioni quali Leggi questa versione e Confronta.

Per ulteriori informazioni sulle modalità di utilizzo della scheda etichetta nella finestra Cronologia, vedere Visualizzare i dati cronologici.

Scaricare versioni dei file con etichetta nell'area di lavoro

L'assegnazione di etichette a un set di file corrisponde a creare uno snapshot di un determinato momento della loro esistenza. Settimane o mesi dopo avere creato questo snapshot, potrebbe essere necessario visualizzare o utilizzare i file nello stato in cui erano al momento della creazione dello snapshot. Nella procedura riportata di seguito viene descritto come scaricare le versioni con etichetta di un set di file nell'area di lavoro.

Scaricare versioni dei file con etichetta nell'area di lavoro

1. In Esplora controllo codice sorgente, fare clic con il pulsante destro del mouse sull'insieme di progetti, il progetto team, il ramo o la cartella che contiene gli elementi che si desidera scaricare, quindi fare clic su Leggi versione specifica.

   Verrà visualizzata la finestra di dialogo Leggi.

2. Dall'elenco Tipo, selezionare Etichetta quindi il nome dell'etichetta nella casella Etichetta o fare clic sui puntini di sospensione (…) per aprire la finestra di dialogo Trova etichetta. Per ulteriori informazioni sull'utilizzo di questa finestra di dialogo, vedere Trovare, modificare e rimuovere etichette.

3. Esaminare e, se appropriato, selezionare una qualsiasi delle opzioni aggiuntive nella finestra di dialogo Leggi.

4. Fare clic su Leggi.

Utilizzare la finestra Etichetta per gestire le etichette

Dopo avere aperto la finestra Etichetta tramite una delle procedure riportate in precedenza, è possibile iniziare a utilizzare l'etichetta. Nella casella riportata nella parte superiore della finestra viene visualizzato il commento, modificabile.

È possibile utilizzare la finestra Etichetta per effettuare le seguenti attività:

• Aggiungere un elemento all'etichetta

• Rimuovere un elemento dall'etichetta

• Modificare la versione di un file

• Eseguire altre azioni su un elemento

Aggiungere un elemento all'etichetta

1. Nella finestra Etichetta, fare clic su Aggiungi elemento.

   Verrà visualizzata la finestra di dialogo Scegli versione elemento.

2. Nella finestra di dialogo Scegli versione elemento individuare e quindi selezionare l'elemento da aggiungere.

   Suggerimento
   È possibile premere e tenere premuti i tasti CONTROL o MAIUSC, quindi selezionare più elementi.

3. (Facoltativo) Se è necessario assegnare l'etichetta a una versione specifica, è possibile selezionare una delle seguenti opzioni dall'elenco Versione:

   • Se si sceglie Ultima versione l'etichetta verrà applicata alla versione più recente inclusa nel controllo della versione.

   • Se si sceglie Set di modifiche è possibile specificare il numero del set di modifiche nella casella Set di modifiche. In alternativa, fare clic sui puntini di sospensione (…) per aprire la finestra di dialogo Trova insiemi di modifiche. Per ulteriori informazioni, vedere Ottenere informazioni relative a un insieme di modifiche.

   • Se si sceglie Data è possibile specificare una data nella casella Data oppure selezionare una data dal calendario nel menu a discesa.

   • Scegliendo Etichetta, è possibile specificare un'etichetta esistente sulla quale basare la nuova etichetta. Digitare il nome dell'etichetta nella casella Etichetta o fare clic sui puntini di sospensione (…) per aprire la finestra di dialogo Trova etichetta. Per ulteriori informazioni, vedere Trovare, modificare e rimuovere etichette.

   • Se si sceglie Versione area di lavoro verrà creata l'etichetta per la versione che si trova nell'area di lavoro.

4. Scegliere OK.

5. Scegliere Salva dal menu File.

Rimuovere un elemento dall'etichetta

1. Nella finestra Etichetta, individuare l'insieme, il progetto team, il ramo, la cartella o il file che si desidera rimuovere da questa etichetta.

2. Fare clic con il pulsante destro del mouse sull'elemento e selezionare Rimuovi da etichetta.

   L'etichetta viene rimossa dall'elemento. Se l'elemento è un insieme di progetti, un progetto team, un ramo o una cartella, l'etichetta viene rimossa anche da tutti gli elementi che contiene.

3. Scegliere Salva dal menu File.

Modificare la versione di un file

1. Nella finestra Etichetta, individuare il file da modificare.

2. Fare clic con il pulsante destro del mouse sul file e selezionare Cambia versione elemento.

3. Verrà visualizzata la finestra di dialogo Scegli versione elemento.

4. Eseguire una delle operazioni seguenti:

   • Scegliere Ultima versione per applicare l'etichetta alla versione più recente inclusa nel controllo della versione.

   • Scegliere Set di modifiche, quindi specificare il numero del set di modifiche nella casella Set di modifiche. In alternativa, fare clic sui puntini di sospensione (…) per aprire la finestra di dialogo Trova insiemi di modifiche. Per ulteriori informazioni, vedere Ottenere informazioni relative a un insieme di modifiche.

   • Scegliere Data, quindi specificare una data nella casella Data oppure selezionare una data dal calendario nel menu a discesa.

   • Scegliere Etichetta, quindi specificare un'etichetta esistente sulla quale basare la nuova etichetta. Digitare il nome dell'etichetta nella casella Etichetta o fare clic sui puntini di sospensione (…) per aprire la finestra di dialogo Trova etichetta. Per ulteriori informazioni, vedere Trovare, modificare e rimuovere etichette.

   • Scegliere Versione area di lavoro, verrà creata l'etichetta per la versione che si trova nell'area di lavoro.

5. Scegliere Salva dal menu File.

Eseguire altre azioni su un elemento con etichetta

Quando si fa clic con il pulsante destro del mouse su un elemento nella finestra Etichetta, è possibile selezionare anche uno dei comandi seguenti:

• Visualizza (solo file)

• Visualizza cronologia

• Confronta (solo file)

• Annota (solo file)

• Leggi questa versione

Ripristinare i file alla versione con etichetta

È possibile utilizzare il comando tf rollback per ripristinare un set di file allo stato in cui era nelle versioni contrassegnate da un'etichetta. Per ulteriori informazioni, vedere Comando Rollback (Controllo della versione di Team Foundation).

Utilizzare le etichette dalla riga di comando

In questa sezione vengono illustrate alcune delle comuni modalità di utilizzo delle etichette dalla riga di comando.

Visualizzare le etichette dalla riga di comando

Visualizzare le etichette dalla riga di comando

1. Fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft Visual Studio 2010, Visual Studio Tools, quindi fare clic su Prompt dei comandi di Visual Studio (2010).

2. Digitare cd percorso, dove percorso è la directory che contiene l'area di lavoro da utilizzare.

3. Digitare tf labels.

Applicare e modificare etichette dalla riga di comando

L'applicazione di un'etichetta dalla riga di comando ha un effetto diverso dell'applicazione di un'etichetta tramite ALM di Visual Studio **(**come descritto precedentemente in questo argomento). Quando si utilizza ALM di Visual Studio per applicare un'etichetta che già esiste, l'operazione rimuove l'etichetta da tutte le versioni del file, quindi applica l'etichetta.

Dalla riga di comando, tuttavia, l'operazione relativa all'etichetta è aggiuntiva. Ad esempio, si supponga di applicare l'etichetta mylabel a $/DinnerNow/Features/FeatureTeamA. Se successivamente la stessa etichetta viene applicata a $/DinnerNow/Features/FeatureTeamB, l'etichetta mylabel verrà applicata a entrambe le cartelle.

Per applicare un'etichetta dalla riga di comando

1. Fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft Visual Studio 2010, Visual Studio Tools, quindi fare clic su Prompt dei comandi di Visual Studio (2010).

2. Digitare cd percorso, dove percorso è il percorso della cartella a cui si desidera applicare l'etichetta.

3. Digitare tf label mylabel . /recursive.

   Il sistema applica l'etichetta mylabel alla versione dell'area di lavoro della cartella "percorso" e a tutti i file e le cartelle in essa contenuti.

Rimuovere un'etichetta dalla riga di comando

Per rimuovere le etichette dalla riga di comando

1. Fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft Visual Studio 2010, Visual Studio Tools, quindi fare clic su Prompt dei comandi di Visual Studio (2010).

2. Digitare cd percorso, dove percorso è la directory che contiene l'area di lavoro da utilizzare.

3. Digitare tf label /delete nome etichetta, dove nome etichetta corrisponde al nome dell'etichetta che si desidera eliminare.

Vedere anche

Riferimenti

Comando Label (controllo della versione di Team Foundation)

Comando Labels

Concetti

Utilizzo degli insiemi di modifiche

Creazione di un'area di lavoro per l'utilizzo del progetto team

Autorizzazioni per Team Foundation Server

Utilizzo di Esplora controllo del codice sorgente

Altre risorse

Creazione di un ramo e unione