Utilità da riga di comando VSSConverter per la migrazione dei controlli del codice sorgente

Articolo
09/12/2008

Aggiornamento: novembre 2007

Utilizzare l'utilità da riga di comando VSSConverter per analizzare e migrare i database di Visual SourceSafe in Controllo della versione di Team Foundation.

VSSConverter.exe si trova in <unità>:\Programmi\Microsoft Visual Studio 9.0\Common7\IDE ed è anche disponibile dal prompt dei comandi di Visual Studio

Nota importante:
VSS Converter richiede Microsoft Visual SourceSafe 2005 o una versione più recente.

Le seguenti opzioni globali sono disponibili per tutti i comandi di VSSConverter.

Opzione	Descrizione
/?, /h, /help	Consente di visualizzare la Guida in linea.

Informazioni conservate dopo la migrazione

Quando si esegue la migrazione da Visual SourceSafe a Controllo della versione di Team Foundation, vengono conservate le informazioni cronologiche seguenti:

Aggiunta di file o cartelle Vengono salvati il nome del file o della cartella, la data e l'ora di aggiunta e il nome dell'utente.
Eliminazione di file o cartelle Vengono salvati il nome del file o della cartella, la data e l'ora di eliminazione e il nome dell'utente.
Annullamento dell'eliminazione di file o cartelle Vengono salvati il nome del file o della cartella, la data e l'ora di annullamento dell'eliminazione e il nome dell'utente.
Ridenominazione di file o cartelle Vengono salvati il nome precedente e quello nuovo del file o della cartella, la data e l'ora della ridenominazione e il nome dell'utente.
Modifica di file Vengono salvati la data e l'ora di archiviazione e il nome dell'utente.
Modifica di etichette Vengono salvati il nome dell'etichetta, la data e l'ora di modifica e il nome dell'utente.

Spostamento di cartelle Vengono salvati il percorso precedente e quello nuovo, la data e l'ora dello spostamento e il nome dell'utente.

Nota:
Le informazioni sugli spostamenti di cartelle in un database di Visual SourceSafe vengono conservate in Controllo della versione di Team Foundation solo se viene eseguita contemporaneamente la migrazione delle cartelle di origine e destinazione.

Informazioni non conservate dopo la migrazione

Lo strumento di conversione non conserva le informazioni cronologiche relative alle seguenti azioni di Visual SourceSafe:

Condivisione Poiché la condivisione non è supportata in Controllo della versione di Team Foundation, La migrazione dei file Visual SourceSafe condivisi in Controllo della versione di Team Foundation viene eseguita copiando in una cartella di destinazione la versione del file al momento dell'inizio della condivisione. Da quel momento, le modifiche apportate al file condiviso vengono replicate in entrambe le copie.
Diramazione Poiché la condivisione è una precondizione della diramazione, la migrazione di un file condiviso causa la copia del file nella cartella di destinazione. Dopo la diramazione, la migrazione delle eventuali modifiche apportate a una diramazione viene eseguita nella rispettiva copia in Controllo della versione di Team Foundation.
Blocco Controllo della versione di Team Foundation non supporta il blocco. Tutti i file bloccati vengono migrati creando due etichette. L'etichetta PINNED_LATEST viene applicata alle versioni bloccate dei file e all'ultima versione dei file sbloccati. L'etichetta PINNED viene applicata solo alle versioni bloccate dei file. Dopo la migrazione, l'etichetta PINNED_LATEST recupera gli stessi file di un'operazione Leggi ultima versione di Visual SourceSafe. È tuttavia 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.
Cartelle con una combinazione di azioni di spostamento e ripristino La migrazione di una cartella che dispone di una cronologia della versione che include un'azione di spostamento in combinazione con un'azione di ripristino potrebbe non essere eseguita correttamente.

Indicatori data e ora

Il timestamp associato a un'azione non è mantenuto durante la migrazione perché viene sostituito dal timestamp al momento della conversione. Il timestamp originale di un'azione dell'utente viene aggiunto al commento come indicato nell'esempio seguente.

Visual SourceSafe prima della migrazione

Controllo della versione di Team Foundation dopo la migrazione del 2 maggio 2005 alle 15.30

Azione dell'utente: $/ProjectA/a.c checkin

Versione: 5

Timestamp: 3 giugno 2002 12.30

Commento: bug corretto nella schermata di benvenuto

Azione dell'utente: $/ProjectA/a.c checkin

Versione: 5

Timestamp: 3 giugno 2002 12.30

Commento: {03/06/2002 12.30}

Bug corretto nella schermata di benvenuto

Associazioni del controllo del codice sorgente

Tramite il convertitore VSS non viene eseguita la migrazione delle associazioni del controllo del codice sorgente. Dopo la migrazione, è necessario modificare le associazioni del controllo del codice sorgente per qualsiasi soluzione Visual Studio in modo che vengano associate a Controllo della versione di Team Foundation. Per ulteriori informazioni sulla migrazione delle associazioni del controllo del codice sorgente, vedere Procedura: eseguire la migrazione delle associazioni del controllo del codice sorgente da Visual SourceSafe

In questa sezione

Comando analyze (VSSConverter)
Descrive la sintassi e l'utilizzo del comando VSSConverter analyze.
Comando migrate (VSSConverter)
Descrive la sintassi e l'utilizzo del comando VSSConverter migrate.