Conversione dei dati con gli strumenti di aggiornamento di VSS

Gli strumenti di aggiornamento di Visual SourceSafe sono un metodo pratico per eseguire un unico aggiornamento unidirezionale della codebase da Visual SourceSafe a Team Foundation Server (TFS).Utilizzare gli strumenti per l'aggiornamento dei dati solo quando si è pronti ad interrompere l'accesso a Visual SourceSafe e ad iniziare la gestione in TFS.

TFS e Visual SourceSafe presentano notevoli differenze funzionali.Di conseguenza, gli strumenti di aggiornamento di Visual SourceSafe modificano determinati tipi di dati durante l'aggiornamento.

In questo argomento

• Come vengono creati gli insiemi di modifica

• Come vengono condivisi e bloccati gli elementi

• Come vengono trasferiti i dati cronologici

  • Trasferimento dei dati relativi al nome utente, alla data e all'ora

  • Modalità di conversione di tipi di eventi specifici

• Come vengono trasferite le associazioni di controllo della versione

Come vengono creati gli insiemi di modifica

I gruppi di controllo della versione di TFS raggruppa le modifiche apportate a più file in un'unica unità quando un utente archivia un set di modifiche.Quest'unica unità è nota come insieme di modifiche.

Visual SourceSafe non dispone di una funzionalità equivalente agli insiemi di modifiche.Tuttavia, durante il processo di conversione, ogni set di modifiche viene raggruppato in un insieme di modifiche purché si verificano le condizioni seguenti:

• Le modifiche non entrano in conflitto l'una con l'altra.Ad esempio, nessuna delle due azioni influisce sullo stesso file o cartella.

• Le modifiche si sono verificate a non più di alcuni minuti l'una dall'altra.

• Le modifiche sono state archiviate dallo stesso utente.

• Le modifiche presentano lo stesso commento di archiviazione.

Come vengono condivisi e bloccati gli elementi

In Visual SourceSafe è possibile condividere un file tra più cartelle.Le modifiche apportate a un file condiviso vengono replicate nelle cartelle in cui viene condiviso il file.Nel controllo della versione di TFS non è disponibile una funzionalità equivalente.Durante l'aggiornamento, viene eseguito l'aggiornamento dei file condivisi nel progetto di Visual SourceSafe creando una copia indipendente aggiuntiva dell'elemento nel server per il controllo della versione di TFS.

Il controllo della versione di TFS non dispone inoltre di una funzionalità equivalente a quella di blocco in Visual SourceSafe.Durante l'aggiornamento, gli elementi bloccati nel progetto di Visual SourceSafe vengono convertiti negli elementi con etichetta nel controllo della versione del server TFS.Per ulteriori informazioni, vedere la sezione successiva.

Come vengono trasferiti i dati cronologici

Ogni evento nella cronologia di un elemento nel database di Visual SourceSafe viene trasferito in Team Foundation Server come un insieme di modifiche.Una volta completato l'aggiornamento, è possibile visualizzare questi dati nella finestra Cronologia.Per ulteriori informazioni, vedere Ottenere la cronologia di un elemento.

Alcune modifiche ai dati si verificano durante l'aggiornamento.

Trasferimento dei dati relativi al nome utente, alla data e all'ora

Mentre viene eseguito l'aggiornamento di ogni voce nella cronologia di un elemento nel database Visual SourceSafe a un insieme di modifiche in Team Foundation Server, si verificano le seguenti modifiche:

• Il timestamp nell'insieme di modifiche viene impostato sulla data e sull'ora di quando è stato eseguito l'aggiornamento dell'elemento.

• Il timestamp originale viene archiviato nel campo Commento dell'insieme di modifiche.

• Il nome utente viene archiviato nel campo utente o Commento dell'insieme di modifiche, a seconda del risultato del processo di mapping degli utenti.

  [!NOTA]

  Se si desidera controllare quali i nomi utente sono assegnati ai dati cronologici, è necessario utilizzare VssUpgrade.Vedere Specificare la modalità di aggiornamento dei nomi utente.

Modalità di conversione di tipi di eventi specifici

Viene eseguito l'aggiornamento di eventi quali la modifica, la ridenominazione e l'eliminazione dal database di Visual SourceSafe in insiemi di modifiche in Team Foundation Server in modo semplice.Gli strumenti di aggiornamento, tuttavia, convertono alcuni eventi in modi imprevisti, come illustrato nella tabella seguente.

Evento Visual SourceSafe	Come è stato eseguito l'aggiornamento nel controllo della versione TFS
Aggiunta file o cartella	Questo insieme di modifiche è il primo evento della cronologia di ogni file e cartella di cui viene eseguito l'aggiornamento.Diversamente da quanto avviene in Visual SourceSafe, nessun evento viene registrato per il padre di ogni elemento figlio da esso contenuto.
Creazione di un ramo	La condivisione è una precondizione per l'esecuzione del branching in Visual SourceSafe, ma il controllo della versione di TFS non supporta la condivisione. Di conseguenza, l'aggiornamento di un file sottoposto a branching crea una copia del file nella cartella di destinazione. Viene eseguito l'aggiornamento dei file condivisi dal database di Visual SourceSafe al controllo della versione di TFS copiando la versione del file esistente al momento della condivisione e inserendo la copia nella cartella di destinazione.Successivamente, ogni insieme di modifiche viene replicato in entrambe le copie del file fino a quando non si verifica l'evento di creazione del ramo.
Etichetta	Elementi contrassegnati in modo implicito: in Visual SourceSafe, quando si contrassegna una cartella, gli elementi che contiene sono contrassegnati in modo implicito.Il processo di aggiornamento etichetta in modo esplicito tutti gli elementi aggiornati nel progetto team. File etichettati in modo esplicito: in Visual SourceSafe, quando un file singolo viene etichettato in modo esplicito, viene creata una nuova versione del file. Il processo di aggiornamento trasferisce l'etichetta alla versione disponibile nel controllo della versione TFS, ma non crea una nuova versione. Nota Se il database di Visual SourceSafe contiene numerose etichette che vengono applicate a una grande quantità di file, è possibile prolungare il processo di aggiornamento.Se si desidera escludere questi dati, è necessario utilizzare VssUpgrade e configurarlo affinché ignori le etichette.Vedere <Label migrate="false" />.
Spostamento cartella	L'evento di spostamento cartella crea una nuova versione della cartella nel controllo della versione TFS. Se si sta utilizzando VSSConverter, non eseguirà l'aggiornamento della cronologia completa degli elementi nelle cartelle spostate a meno che non venga eseguito contemporaneamente l'aggiornamento delle cartelle di origine e destinazione.Vedere Rivedere e risolvere i problemi rilevati dalla funzionalità Analizza. Nota Se l'evento di spostamento della cartella è associato a un evento di ripristino, è possibile che l'aggiornamento della cronologia relativa ai dati non venga eseguito correttamente.
Ripristino	Non viene eseguito l'aggiornamento di alcun dato della cronologia che si verifica prima di un evento di ripristino.
Blocco e sblocco	Il controllo della versione di TFS non supporta il blocco.Gli strumenti di aggiornamento eseguono l'aggiornamento di un file bloccato creando due etichette. L'etichetta PINNED_LATEST viene applicata alle versioni bloccate dei file e alla versione più recente dei file sbloccati.L'etichetta PINNED viene applicata solo alle versioni bloccate dei file.Dopo l'aggiornamento, l'etichetta PINNED_LATEST consentirà di recuperare gli stessi file restituiti dal comando Leggi ultima versione di Visual SourceSafe.Tuttavia, un'eccezione possibile è che l'etichetta PINNED_LATEST restituisca file differenti se si sono verificati eventi diversi dall'archiviazione dopo il blocco di un file, ad esempio ridenominazione o eliminazione del file.
Condivisione	Il controllo della versione di TFS non supporta la condivisione.Viene eseguito l'aggiornamento dei file condivisi dal database di Visual SourceSafe al controllo della versione di TFS copiando la versione del file esistente al momento della condivisione e inserendo la copia nella cartella di destinazione.Successivamente, ogni insieme di modifiche viene replicato in entrambe le copie del file.
Annullamento dell'eliminazione di file o cartelle	Durante un aggiornamento di eventi di annullamento dell'eliminazione di un file o di una cartella, gli strumenti riproducono l'evento per creare la nuova versione del file e della cartella nel controllo della versione TFS. Gli strumenti di aggiornamento creano un insieme di modifiche che include il nome del file o della cartella, la data e l'ora in cui ne è stata annullata l'eliminazione e il nome utente.

Come vengono trasferite le associazioni di controllo della versione

Gli strumenti di aggiornamento trasferiscono le associazioni di controllo della versione per ogni soluzione.

Passo successivo

Preparare l'aggiornamento da Visual SourceSafe