Condividi tramite

Procedura dettagliata: migrazione di elementi di lavoro ClearQuest a Team Foundation

  • Articolo

Aggiornamento: novembre 2007

In questa procedura dettagliata viene illustrato il processo per spostare gli elementi di lavoro ClearQuest in Gestione elementi di lavoro di Team Foundation. In Team Foundation è inclusa un'utilità di conversione, CQConverter.exe, che è possibile utilizzare per eseguire questa migrazione.

Nel corso di questa procedura dettagliata si completeranno le seguenti attività:

  • Configurazione del processo di migrazione. Modifica dei file di configurazione per gestire il processo di migrazione.

  • Analisi del database ClearQuest . Esecuzione del convertitore ClearQuest per l'analisi del database ClearQuest corrente. In base all'analisi vengono generati un report e un insieme di file che descrive i tipi di elementi di lavoro presenti in ClearQuest.

  • Definizione del mapping della migrazione. Modifica dei file XML generati durante l'analisi del database ClearQuest per personalizzare il processo di migrazione.

  • Migrazione del database ClearQuest a Gestione elementi di lavoro di Team Foundation   Utilizzo dei file di configurazione e di mapping generati durante l'analisi del database per migrare i dati.

  • Esame del report di migrazione. Individuazione delle cause di eventuali errori e avvisi rilevati durante la migrazione ed esame dello stato di migrazione.

Prerequisiti

Per completare questa procedura è necessario che nel computer in cui si intende eseguire CQConverter.exe sia installato il seguente software:

  • Team Explorer

  • Client autonomo ClearQuest versione 2003.06.00

    Nota:

    È possibile, ma non è stato verificato, il funzionamento delle versioni 2002.05.20 e 2003.05.00.

Occorre inoltre indicare come si desidera mappare i nomi utente di ClearQuest ai nomi di dominio Windows utilizzati da Gestione elementi di lavoro di Team Foundation. Accertarsi di includere nomi utente di dimensione non superiore a quella già in uso.

Ai fini del completamento della procedura risultano inoltre utili le informazioni e le conoscenze riportate di seguito:

  • Nozioni di base di XML.

  • Un elenco delle modalità di mapping degli elementi di lavoro presenti in ClearQuest a Gestione elementi di lavoro di Team Foundation. Includere informazioni sulle trasformazioni necessarie. Ad esempio, è possibile mappare un campo stringa in ClearQuest a un campo intero in Gestione elementi di lavoro di Team Foundation.

Autorizzazioni necessarie

Per eseguire queste procedure, è necessario essere membro del gruppo di sicurezza Service Accounts. È inoltre necessario essere membro del gruppo di sicurezza Readers o disporre dell'autorizzazione Visualizza elementi di lavoro in questo nodo impostata su Consenti. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server. È inoltre necessario disporre dell'autorizzazione Super User per il database ClearQuest. Per ulteriori informazioni, vedere la guida dell'amministratore di ClearQuest.

Attività pre-migrazione

Prima di avviare la migrazione, eseguire le attività riportate di seguito:

  • Pianificare il periodo in cui bloccare il database ClearQuest. Un metodo ottimale consiste nel bloccare il database per impedire agli utenti di creare nuovi elementi di lavoro durante il processo di migrazione. Il convertitore ClearQuest non rileva le modifiche degli elementi di lavoro durante la conversione. Per informazioni sul blocco del database ClearQuest, vedere la documentazione ClearQuest.

  • Creare i progetti Team di Visual Studio Issue Tracking. Creare i progetti Team e stabilire quali elementi di lavoro rientrano in un determinato progetto. Per ulteriori informazioni sulla creazione di progetti Team di Gestione elementi di lavoro di Team Foundation, vedere Procedura dettagliata: creazione di un nuovo progetto Team.

  • Aggiungere l'account utente in uso per l'esecuzione del convertitore al gruppo Service Accounts. Per eseguire il convertitore CQConverter sono necessarie le autorizzazioni dell'account del servizio. Aggiungere l'account utente che eseguirà il convertitore nel gruppo Service Accounts sul Team Foundation Server con l'utilità TFSSecurity. Per ulteriori informazioni, vedere Comandi dell'utilità della riga di comando TFSSecurity.

Limitazioni del convertitore

Prima di avviare la migrazione, è necessario verificare le limitazioni del convertitore ClearQuest e il modo in cui tali limitazioni possono influire sugli utenti dell'organizzazione. Per ulteriori informazioni, vedere la classe Utilità da riga di comando CQConverter per la migrazione di database ClearQuest.

Definizioni

Nella procedura dettagliata vengono utilizzati i seguenti termini:

  • Tipo di elemento di lavoro. I tipi di elementi di lavoro sono i blocchi predefiniti di base di un sistema di gestione degli elementi di lavoro. Bug, requisiti e attività sono esempi di tipi di elementi di lavoro.

  • Entità. Unità di base dei dati in ClearQuest. Un errore, ad esempio, potrebbe essere collegato a un cliente e appartenere a un determinato progetto. L'errore, il cliente e il progetto sono tutte entità.

  • Campo. Negli elementi di lavoro sono inclusi campi che contengono informazioni sull'elemento di lavoro. Un elemento di lavoro errato, ad esempio, potrebbe avere campi quali aperto da, stato, risoluzione, cronologia, collegamenti e allegati.

  • Stati. Posizione del processo in cui potrebbe trovarsi un elemento di lavoro. Un bug, ad esempio, potrebbe essere Aperto, Assegnato, Risolto o Posposto.

  • Comportamento di campi (regole di campo). Definizione del comportamento dei campi nei diversi stati. È possibile, ad esempio, che il campo Corretto in, non sia modificabile quando si crea un nuovo bug, ma che richieda un valore al momento della transizione del bug nello stato Risolto.

Configurazione del processo di migrazione

Durante questo passaggio vengono modificati i file di configurazione del convertitore ClearQuest per la gestione del processo di migrazione.

File di configurazione

Il file di configurazione è un file XML che fornisce impostazioni per il convertitore ClearQuest. Le impostazioni vengono specificate nelle seguenti sezioni del file XML:

<ClearQuest>

La sezione ClearQuest contiene informazioni sul database ClearQuest che si intende migrare.

  • ConnectionName. Nome della connessione ClearQuest.

  • UserDatabase. Nome del database utente ClearQuest.

  • QueryName. Nome di una query salvata in ClearQuest.

  • UserID   ID utente di ClearQuest. L'ID utente specificato deve disporre dell'autorizzazione Super User per il database ClearQuest.

<VSTS>

Nella sezione VSTS sono contenute tutte le informazioni sul server Gestione elementi di lavoro di Team Foundation e sul progetto team in cui si sta eseguendo la migrazione.

  • URI. Nome descrittivo o URI completo di Team Foundation Server. Ad esempio, "MyAtServer" o "http://MyAtServer:8080".

  • ProjectName. Nome del progetto team Gestione elementi di lavoro di Team Foundation.

Altre impostazioni di configurazione

Le altre sezioni del file XML consentono di specificare le impostazioni seguenti:

  • ExitOnError. In questa sezione viene accettato un valore True o False. Specificare True se si desidera interrompere il convertitore ClearQuest in caso di errori nella migrazione di alcuni elementi di lavoro.

    Nota:

    Questa impostazione viene applicata solo a errori non irreversibili. In caso di errori irreversibili, ad esempio quando è impossibile connettere il convertitore ClearQuest a ClearQuest, il convertitore verrà sempre chiuso anche se il valore dell'impostazione è False.

  • OutputDirectory. Specificare la directory in cui spostare i file generati. Se non si specifica una directory di output, il convertitore crea una directory con il nome dell'entità di base per generare file di output. Se la directory esiste già, il convertitore sovrascrive i file di questa directory.

Creazione del file di configurazione

È possibile creare il file di configurazione mediante qualsiasi editor di testo, ad esempio il Blocco note.

Per creare il file di configurazione

  1. Raccogliere le informazioni riportate di seguito:

    • Nome della connessione ClearQuest.

    • Nome del database ClearQuest.

    • ID e password utente amministratore ClearQuest. Accertarsi che tale utente amministratore disponga delle autorizzazioni per inviare problemi inerenti ClearQuest.

    • Nome del server Gestione elementi di lavoro di Team Foundation

    • Nome del progetto team Gestione elementi di lavoro di Team Foundation (progetto team in cui eseguire la migrazione degli elementi di lavoro).

  2. Creare una query in ClearQuest per selezionare gli elementi di lavoro che si desiderano migrare in Gestione elementi di lavoro di Team Foundation e salvarla. Salvare la query con un nome qualsiasi, ad esempio TransitionQuery.

  3. Scegliere una directory per archiviare i file prodotti durante la fase di analisi.

  4. Copiare il seguente file di configurazione XML in un editor di testo.

    <?xml version="1.0" encoding="utf-8"?>
<WorkItemConverter>
  <Source id="ClearQuest">
    <ClearQuest>
      <ConnectionName>CQRep</ConnectionName> 
      <UserDatabase>TEST</UserDatabase> 
      <QueryName>Public Queries/All Defects</QueryName> 
      <UserID>admin</UserID>
    </ClearQuest>
  </Source>
  <VSTS>
    <URI>AdventureWorksServer</URI>
    <ProjectName>AdventureWorksProject</ProjectName> 
  </VSTS>
  <ExitOnError>true</ExitOnError>
  <OutputDirectory>DefectSchema</OutputDirectory>
</WorkItemConverter>

  5. Modificare il file per specificare le impostazioni con le informazioni raccolte nei passaggi precedenti. In <QueryName>, ad esempio, specificare il nome della query TransitionQuery e includere il relativo percorso. Per le informazioni sul contenuto di ciascuna sezione, vedere la sezione precedente "File di configurazione".

    Nota:

    La password non viene immessa nel file, ma viene richiesta successivamente dallo strumento di conversione ClearQuest durante il processo di migrazione.

  6. Salvare il file.

    È possibile, ad esempio, salvare il file come CqConverterConfig.xml.

Analisi del database ClearQuest

Durante l'analisi del database ClearQuest, il convertitore ClearQuest per Team Foundation esegue l'analisi del database ClearQuest e crea i seguenti file XML:

  • File di definizione del tipo di elemento di lavoro (WITD) di Gestione elementi di lavoro di Team Foundation relativo a ciascun tipo di entità ClearQuest contenente stati, transizioni di stati, campi, tipi di campi e comportamento di campi, ad esempio obbligatorio o facoltativo.

  • Un file di mapping campi predefinito che mappa campi e valori ClearQuest a campi e valori Gestione elementi di lavoro di Team Foundation.

  • Un file di mapping utenti per eseguire il mapping tra gli utenti di ClearQuest e gli utenti di Windows. Questo file viene applicato all'intero sistema.

  • Un file di mappa dello schema contenente riferimenti ad altri file XML (ad esempio il file SchemaMap che contiene i nomi di entità) e al file di mapping campi con il percorso dei nomi dei file WorkItem generati e dei file fieldMap.

  • Un file di report e di avviso (CQAnalysisReport.xml).

Per analizzare il database ClearQuest

  1. Al prompt dei comandi di Visual Studio 2008, eseguire il comando seguente:

    CQConverter.exe /c:analyze /m:CqConverterConfig.xml

    Il completamento dell'esecuzione con il convertitore ClearQuest può richiedere diversi minuti.

    Nota. Per ulteriori informazioni sui comandi ClearQuest Converter, vedere Utilità da riga di comando CQConverter per la migrazione di database ClearQuest.

  2. Nella directory di output specificata nel file di configurazione cercare i file XML riportati di seguito. Questi file vengono utilizzati successivamente nel processo di migrazione:

    • File WITD per ciascun tipo di entità ClearQuest denominato NomeEntità.xml. Ad esempio, un file per l'entità errore ClearQuest sarebbe denominato Defect.xml.

    • File di mapping campi per ciascun tipo di entità ClearQuest. Questi file specificano il modo in cui i campi e i relativi valori in ciascuna entità ClearQuest saranno mappati ai campi corrispondenti nel tipo di elemento di lavoro Gestione elementi di lavoro di Team Foundation. Ad esempio, un file per l'entità errore ClearQuest sarebbe denominato DefectFieldMap.xml.

    • File di mapping utenti. File che specifica il modo in cui gli utenti di ClearQuest devono essere mappati agli utenti di Gestione elementi di lavoro di Team Foundation.

    • File schemamap.xml. File che descrive i mapping di schema e campi.

  3. Nella directory in cui è stato eseguito il convertitore, cercare il file CQAnalysisReport.xml per verificare gli avvisi e gli errori prima della migrazione.

Definizione della mapping della migrazione

In base all'analisi viene generato un insieme di file che acquisisce le informazioni dal database ClearQuest. Potrebbe essere necessario modificare alcuni di questi file per eseguire la migrazione desiderata per il database. È necessario almeno modificare il file di mapping utenti e il file di definizione del tipo di elemento di lavoro.

Per ulteriori informazioni sulla modifica del file di definizione di un tipo di elemento di lavoro, vedere Procedura dettagliata: personalizzazioni di base per un tipo di elemento di lavoro.

Modifica del file di mappa dello schema

Per modificare il file schemamap.xml

  1. Aprire il file Schemamap.xml.

    Di seguito è riportato un esempio di questo file:

    <Mappings>
  <SchemaMaps>
    <SchemaMap SourceEntity="Defect" TargetWIT="Defect"
      WITDFile="Defect.xml" FieldMapFile="DefectFieldMap.xml"/> 
    <SchemaMap SourceEntity="Customer" TargetWIT="Customer"
      WITDFile="Customer.xml" FieldMapFile="CustomerFieldMap.xml"/> 
  </SchemaMaps>
  <UserMap File="UserMap.xml" /> 
</Mappings>

  2. Modificare le sezioni di questo file nel modo appropriato.

    • SourceEntity. Assicurarsi che questa sezione contenga l'entità ClearQuest corretta.

    • TargetWIT. Assicurarsi che questa sezione faccia riferimento al tipo di elemento di lavoro corretto da creare in Gestione elementi di lavoro di Team Foundation.

    • WITDFile. In questa sezione viene specificato il file XML di definizione del tipo di elemento di lavoro (WITD).

    • FieldMapFile. In questa sezione viene specificato il file XML di mapping campi.

    • UserMap   Questa sezione specifica il file XML di mapping utenti.

Modifica del file di mapping utenti

Il convertitore ClearQuest utilizza i file di mapping utenti per mappare gli ID utente nel database ClearQuest agli ID utente di Gestione elementi di lavoro di Team Foundation equivalenti. Grazie alla conversione dei valori dei campi degli ID utente in valori validi in Gestione elementi di lavoro di Team Foundation è possibile mantenere le informazioni cronologiche sugli elementi di lavoro. In Gestione elementi di lavoro di Team Foundation vengono utilizzati ID utente di dominio Windows.

Durante la fase di analisi il convertitore ClearQuest genera una versione predefinita del file di mapping utenti. Accertarsi che questo file sia corretto prima di proseguire con la conversione poiché, in caso di problemi, il controllo del convertitore su questo file avrà esito negativo.

Per modificare il file di mapping utenti

  1. Aprire il file usermap.xml. Di seguito viene riportato un esempio:

    <UserMappings">
  <UserMap From="admin" To="admin" />
  <UserMap From="user" To="user" />
  <UserMap From="QE" To="QE" />
  <UserMap From="lead" To="lead" /> 
  <UserMap From="engineer" To="engineer" />
</UserMappings>

  2. Verificare i dati di mapping utenti ed eventualmente apportare correzioni, aggiunte ed eliminazioni. Il lato "to" del mapping utenti deve essere un utente Team Foundation Server esistente.

  3. In Gestione elementi di lavoro di Team Foundation aggiungere tutti gli utenti specificati nel file di mapping utenti. Per ulteriori informazioni sull'aggiunta di utenti, vedere Procedura: aggiungere utenti a un gruppo di progetto Team.

    Nota:

    Se si desidera che il mapping di un qualsiasi utente di ClearQuest in Team Foundation Server durante la migrazione venga eseguito senza conversioni, è possibile eliminare le righe relative a tale utente dal file di mapping utenti. Se non si desidera eseguire alcun mapping utenti, è possibile eliminare tutte le righe che specificano il mapping utenti nella sezione <UserMap>. È necessario eliminare solo le singole voci nella sezione <UserMap>, senza eliminare la sezione o eventuali altre parti del file.
    Attenzione:

    Se gli utenti non vengono mappati a utenti di Team Foundation Server validi durante la migrazione, potrebbe essere necessario correggere i campi utente negli elementi di lavoro quando si inizia a utilizzarli. Per quanto il convertitore venga eseguito senza convalida dei valori dei campi, appena verrà avviata la modifica degli elementi di lavoro sarà necessario fornire utenti validi per i campi utente.

Modifica del file di mapping campi

Il convertitore ClearQuest utilizza i file di mapping campi per eseguire il mapping tra i campi di tutte le entità di ClearQuest e i campi degli elementi di lavoro di Gestione elementi di lavoro di Team Foundation equivalenti.

Per modificare il file di mapping campi

  1. Aprire uno dei file di mapping campi, ad esempio, DefectFieldMap.xml. Di seguito viene riportato un esempio:

    <FieldMap from="Criticality" to="Severity">
  <ValueMaps>
        <ValueMap from="1-Critical" to = "1"/>
        <ValueMap from="2-Major" to = "2"/>
  </ValueMaps>
</FieldMap>

  2. Esaminare le righe di mapping campi (a partire da ValueMap) e verificare che il campo indicato dopo "from" sia mappato al campo corretto indicato dopo "to". Per aggiungere mapping campi, inserire ulteriori righe ValueMap. I valori devono essere presenti nell'elenco dei valori consentiti, se specificato nel file di schema; in questo caso, defect.xml.

    Nota:

    Se i mapping campi vengono modificati, verificare che i campi obbligatori nel form dell'elemento di lavoro siano mappati.

  3. Aprire gli altri file di mapping campi e modificarli in base alle esigenze.

Descrizione di una definizione del tipo di elemento di lavoro

Dopo la fase di analisi, il convertitore genera definizioni del tipo di elemento di lavoro (WITD) per ciascun tipo di record ClearQuest. Ad esempio, un file per il tipo di record errore ClearQuest viene denominato Defect.xml. Nell'ambito del processo di generazione dello schema, il convertitore genera un elemento di lavoro predefinito durante la fase di analisi. Tuttavia, poiché il form predefinito è dotato della formattazione minima, sarà presumibilmente necessario apportare delle modifiche per ottenere il layout degli elementi di lavoro desiderato. Per ulteriori informazioni sulla modifica del file di definizione di un tipo di elemento di lavoro, vedere Procedura dettagliata: personalizzazioni di base per un tipo di elemento di lavoro e Procedura dettagliata: personalizzazioni avanzate per un tipo di elemento di lavoro.

Migrazione degli elementi di lavoro ClearQuest

Per migrare gli elementi di lavoro

  1. Al prompt dei comandi di Visual Studio 2008, eseguire il comando seguente:

    CQConverter.exe /c:migrate /m:CqConverterConfig.xml /s:percorso\Schemamap.xml

    Dove percorso è il percorso del file di mappa di schema. Il file di mappa di schema viene generato durante la fase di analisi nella directory di output specificata.

    Nota:

    L'esecuzione del convertitore ClearQuest con database di grandi dimensioni può richiedere alcune ore.
    Nota:

    Per ulteriori informazioni sui comandi del convertitore ClearQuest, vedere Migrazione da ClearQuest.

  2. Al termine della migrazione esaminare il report corrispondente per verificare lo stato della migrazione e l'eventuale presenza di problemi, quali la mancata migrazione di errori dovuta a incoerenze nel mapping campi.

    Il report di migrazione è denominato CQMigrationReport.xml e viene creato nella cartella da cui viene eseguito il convertitore ClearQuest.

    Nota:

    Dal momento che il convertitore converte tutti gli elementi di lavoro inclusi nella query specificata, nonché tutti gli elementi di lavoro ad essi collegati, il numero effettivo degli elementi di lavoro migrati potrebbe essere diverso da quello degli elementi di lavoro presenti nella query.

  3. Se non sono stati migrati tutti gli elementi di lavoro, è possibile eseguire di nuovo la conversione dopo aver risolto i problemi delineati nel report di migrazione.

Per eseguire la migrazione di ulteriori elementi di lavoro da ClearQuest a Gestione elementi di lavoro di Team Foundation, è possibile eseguire di nuovo il processo di migrazione.

Per eseguire di nuovo la migrazione sullo stesso database ClearQuest

  1. Correggere tutti i problemi delineati nel report di migrazione relativi alla migrazione precedente.

  2. Eseguire in ClearQuest una query che restituisca gli elementi di lavoro desiderati oppure eseguire la stessa query se si intende migrare gli elementi di lavoro non migrati durante la precedente migrazione.

  3. Modificare la sezione <QueryName> nel file di configurazione per specificare il nuovo nome della query.

  4. Aprire il prompt dei comandi di Visual Studio 2008 e digitare il comando per la migrazione:

    CQConverter.exe /c:migrate /m:CqConverterConfig.xml /s:percorso\Schemamap.xml

    L'esecuzione del convertitore ClearQuest con database di grandi dimensioni può richiedere alcune ore.

    Nota:

    Per ulteriori informazioni sui comandi del convertitore ClearQuest, vedere Migrazione da ClearQuest.

  5. Una volta completata la migrazione, verificare il report di migrazione relativamente allo stato di migrazione. Il report di migrazione è denominato CQMigrationReport.xml e viene creato nella cartella da cui viene eseguito il convertitore ClearQuest.

Verifica della migrazione degli elementi di lavoro

Dopo aver effettuato la migrazione, è possibile esaminare alcuni elementi di lavoro migrati per verificare che le informazioni siano state migrate correttamente.

Per verificare gli elementi di lavoro migrati

  1. Aprire un elemento di lavoro migrato in Gestione elementi di lavoro di Team Foundation.

  2. Utilizzare il numero nel campo relativo all'ID ClearQuest per confrontare l'elemento di lavoro di Gestione elementi di lavoro di Team Foundation con il bug ClearQuest dotato dello stesso ID.

Per individuare l'elemento di lavoro di Team Foundation corrispondente a uno specifico elemento di lavoro di ClearQuest

  1. Creare una query elemento di lavoro con la clausola seguente:

    And/Or

    Campo

    Operatore

    Valore

     

    VSTS SourceID

    =

    ID elemento di lavoro ClearQuest

    Il campo VSTS SourceID corrisponde all'etichetta del campo relativo all'ID ClearQuest visualizzato nel form dell'elemento di lavoro.

    Per ulteriori informazioni sulla creazione di query elemento di lavoro, vedere Procedura: aggiungere nuove query elemento di lavoro.

  2. Eseguire la query.

Vedere anche

Attività

Procedura dettagliata: gestione elementi di lavoro

Altre risorse

Procedure dettagliate relative alla migrazione