Analisi di un database ClearQuest
Aggiornamento: novembre 2007
Nella fase di analisi il convertitore legge lo schema dal database ClearQuest e genera file che rappresentano lo schema nel formato Team Foundation. Il convertitore utilizza la query ClearQuest per determinare il tipo di entità di base ClearQuest. Una query in ClearQuest si basa su un tipo di entità. Il convertitore determina inoltre i tipi di entità associati con il tipo di entità di base. Le entità associate dell'entità di base sono quelle a cui l'entità di base fa riferimento, ossia le entità presenti nel tipo di entità di base come riferimento o elenco di riferimenti. L'elenco di entità a cui si fa riferimento esclude le seguenti entità:
I tipi di entità a cui potrebbe venire fatto riferimento come duplicato di.
Entità utente La migrazione degli utenti viene eseguita in base alla gestione degli utenti in Team Foundation. Team Foundation non gestisce gli utenti come entità.
Entità allegato La migrazione degli allegati viene eseguita in base alla gestione degli allegati principale di Team Foundation. Team Foundation non gestisce gli allegati come entità.
Cronologia La migrazione della cronologia viene eseguita in base alla gestione della cronologia principale di Team Foundation. Team Foundation non gestisce la cronologia come entità.
Gruppi Il convertitore non esegue la migrazione dei gruppi di ClearQuest. I gruppi vengono gestiti in modo diverso in Team Foundation.
Ratl_replicas Per questa entità non esiste un concetto equivalente in Team Foundation.
Fase di analisi
Al prompt dei comandi di Visual Studio 2008, eseguire il comando seguente:
CQConverter /c:analyze /m:CqConverterConfig.xml
.gif "Nota") Nota: |
|---|
Per analizzare il database ClearQuest, l'ID utente specificato nel file CqConverterConfig.xml deve disporre delle autorizzazioni Super User. Per ulteriori informazioni, vedere il Manuale dell'amministratore di ClearQuest. È inoltre necessario essere un membro del gruppo Service Accounts nel server Team Foundation Server specificato. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server. |
Il convertitore di ClearQuest potrebbe impiegare alcuni minuti per completare l'esecuzione. Al termine della fase di analisi vengono generati diversi file.
File di configurazione del convertitore
I dati per il convertitore devono essere specificati in un file di configurazione. Per ulteriori informazioni, vedere File di configurazione del convertitore degli elementi di lavoro.
File di output
Durante la fase di analisi vengono generati diversi file di output, che vengono salvati nella cartella specificata dall'elemento <DirectoryOutput> nel file di impostazioni della migrazione. Se non è specificata alcuna directory, il convertitore crea una cartella con lo stesso nome del tipo di entità di base di ClearQuest. Se la cartella esiste già, il contenuto della cartella viene sovrascritto con i nuovi file XML generati.
Al termine della fase di analisi vengono creati i seguenti file.
File XML di definizione dei tipi di elemento di lavoro Questi file rappresentano i tipi di elemento di lavoro nel formato di Team Foundation e vengono utilizzati per creare i tipi di elemento di lavoro in Team Foundation. Vengono generati un file per l'entità primaria e un file per ogni entità a cui viene fatto riferimento con i nomi <TipoEntità>.xml. Ad esempio, un tipo di elemento di lavoro dei difetti genera il file Defect.xml.
File XML di mapping dei campi Questi file specificano il mapping dei campi tra i tipi di record di ClearQuest e i tipi di elemento di lavoro di Team Foundation e qualsiasi trasformazione dati da applicare durante la migrazione dei dati. Questi file hanno una relazione uno-a-uno con i file di tipi di elemento di lavoro. Ciascun file di mapping campi specifica il mapping per il tipo di elemento di lavoro corrispondente. A questi file viene assegnato il nome <NomeEntità>FieldMap.xml. Ad esempio, un tipo di elemento di lavoro dei difetti genera il file DefectFieldMap.xml.
File XML di mapping utenti Il nome di questo file è UserMap.xml e specifica il mapping tra gli utenti di ClearQuest e gli utenti di Team Foundation. Questo file potrebbe essere necessario perché ClearQuest utilizza un database utenti distinto e i nomi utente di ClearQuest potrebbero non corrispondere agli account utente Windows richiesti da Team Foundation.
File di mappa di schema XML Il nome di questo file è SchemaMap.xml e contiene i nomi di tutti i file descritti precedentemente nonché indica mapping aggiuntivi tra i tipi di elemento di lavoro e i file associati.
File XML di report di analisi Il nome di questo file è CQAnalysisReport.xml. Insieme al file viene generata la cartella _AnalysisReport_Files contenente immagini e un foglio di stile per la visualizzazione corretta del file in un browser.
Il file di log CQConverter.log
Nota:Indipendentemente dal numero di campi di un particolare elemento di lavoro selezionato in una query, tutti i campi presenti in un tipo di elemento di lavoro vengono selezionati dal convertitore per l'analisi. I file di output contengono riferimenti a tutti i campi.
File di definizione del tipo di elemento di lavoro
I file di definizione del tipo di elemento di lavoro catturano lo schema di un tipo di elemento di lavoro nel formato Team Foundation. È possibile utilizzare questo file per creare un nuovo tipo di elemento di lavoro in Team Foundation. Un file di definizione del tipo di elemento di lavoro specifica i campi nel tipo di elemento di lavoro, gli stati e le transizioni di stato, le regole e l'interfaccia utente per la visualizzazione dell'elemento di lavoro. Per ulteriori informazioni sui file di definizione del tipo di elemento di lavoro, vedere Personalizzazione dei tipi di elemento di lavoro.
Nelle sezioni seguenti viene illustrato come vengono generati questi tipi di elemento di lavoro.
Mapping dei tipi di campo
Il convertitore esegui il mapping tra i tipi di campo in ClearQuest e i tipi di campo appropriati in Team Foundation, come descritto nella seguente tabella.
Tipo di campo di ClearQuest |
Tipo di campo di Team Foundation |
|---|---|
ATTACHMENT_LIST |
Non applicabile. Per questo tipo di campo la migrazione viene eseguita sotto forma di allegato invece che di campo in Team Foundation. |
DATE_TIME |
DateTime |
INT |
Integer |
MULTILINE_STRING |
Testo normale |
REFERENCE |
Non applicabile. Per questo tipo di campo la migrazione viene eseguita sotto forma di collegamento invece che di campo in Team Foundation. |
REFERENCE_LIST |
Non applicabile. Per questo tipo di campo la migrazione viene eseguita sotto forma di collegamento invece che di campo in Team Foundation. |
SHORT STRING |
Stringa |
DBID |
Non sottoposto a migrazione. Questo tipo di campo è riservato per i campi di sistema in ClearQuest e non è obbligatorio negli elementi di lavoro di cui viene eseguita la migrazione. |
ID |
Stringa. Per questo tipo di campo la migrazione viene eseguita sotto forma di campo vsts sourceid in Team Foundation. |
JOURNAL |
Non applicabile. Questo tipo di campo è riservato per i campi di sistema in ClearQuest e la sua migrazione viene eseguita sotto forma di cronologia in Team Foundation. |
Stato |
Stringa. Questo tipo di campo è riservato per i campi di sistema in ClearQuest e la sua migrazione viene eseguita sotto forma di campo State di sistema in Team Foundation. |
Mapping dei campi
Ogni tipo di elemento di lavoro in ClearQuest utilizza campi di sistema, come esistono campi di sistema nei tipi di elemento di lavoro di Team Foundation. Il convertitore esegui il mapping tra i campi di sistema di ClearQuest e i campi di sistema in Team Foundation come appropriato. Oltre ai campi di sistema, esistono altri campi che sono in genere presenti nei tipi di elemento di lavoro di ClearQuest. Il convertitore esegui il mapping di tali campi ai campi di Team Foundation appropriati.
Nella seguente tabella viene descritto come il convertitore esegue il mapping dei campi di sistema.
Campo di sistema di ClearQuest |
Campo di sistema di Team Foundation |
|---|---|
ID |
vsts sourceid |
Stato |
Stato |
Nella seguente tabella viene descritto come il convertitore esegue il mapping dei campi comuni.
Campo di ClearQuest |
Campo di sistema di Team Foundation |
|---|---|
Headline |
Title |
Descrizione |
Descrizione |
Submitter |
Creato da |
Submit_Date |
Created Date |
Owner |
Assigned To |
User_name (cronologia) |
Changed By |
action_timestamp (cronologia) |
Changed Date |
Gestione del comportamento dei campi
È possibile specificare il comportamento dei campi in ClearQuest. È inoltre possibile specificare un comportamento diverso per i campi in base allo stato dell'elemento di lavoro. Il convertitore presenta delle limitazioni sulla migrazione del comportamento negli elementi di lavoro di ClearQuest. Ad esempio, il convertitore esegue la migrazione del comportamento del campo specificato solo allo stato iniziale, cioè lo stato di un elemento di lavoro appena creato.
Il comportamento definito per altri stati non viene esaminato o generato nella fase di analisi. Tuttavia Team Foundation supporta la definizione di questi comportamenti ed è possibile aggiungerli manualmente nei tipi di elemento di lavoro dopo la fase di analisi. Per ulteriori informazioni su come personalizzare il comportamento per i tipi di elemento di lavoro in Team Foundation, vedere Definizione del flusso di lavoro degli elementi di lavoro.
La migrazione del comportamento degli elementi di lavoro viene eseguita come descritto nella seguente tabella.
Comportamento |
Descrizione |
|---|---|
Obbligatorio |
La migrazione di questo comportamento viene eseguita in Team Foundation. Per specificare Obbligatorio in Team Foundation, applicare l'elemento <OBBLIGATORIO> nella definizione del tipo di elemento di lavoro. |
Facoltativo |
La migrazione di questo comportamento viene eseguita in Team Foundation. Poiché Facoltativo è il comportamento predefinito di un campo in Team Foundation, non sono necessari altri elementi nella definizione del tipo di elemento di lavoro. |
Di sola lettura |
Non è possibile eseguire la migrazione di questo comportamento. |
Use_hook |
Non è possibile eseguire la migrazione di questo comportamento. |
Campi aggiunti dal convertitore nei tipi di elemento di lavoro
Il convertitore genera i seguenti campi in ogni tipo di elemento di lavoro oltre ai campi presenti nei tipi di elemento di lavoro di ClearQuest.
Campi necessari per il funzionamento del convertitore
Non rimuovere questi campi dai tipi di elemento di lavoro per non compromettere la migrazione. Se non si desidera visualizzarli, è possibile rimuoverli dall'interfaccia utente (form) dell'elemento di lavoro. Si consiglia di mantenere questi campi in sola lettura per impedire agli utenti di modificarli. Di seguito sono elencati questi campi:
Campo per l'ID ClearQuest di un elemento di lavoro sottoposto a migrazione.
<FIELD name="vsts sourceid" refname="Microsoft.TeamFoundation.Converters.vsts_sourceid" type="String"/>Campo per il database ClearQuest da cui proviene un elemento di lavoro sottoposto a migrazione.
<FIELD name="vsts sourcedb" refname="Microsoft.TeamFoundation.Converters.vsts_sourcedb" type="String"/>Campo utilizzato per gestire lo stato della migrazione di un dato elemento di lavoro.
<FIELD name="Migration Status" refname="Microsoft.TeamFoundation.Converters.Migration_Status" type="String"/>Campi di sistema in Team Foundation. Quando è presente una corrispondenza tra i campi di sistema in Team Foundation e quelli in ClearQuest, viene generato il file XML di mapping appropriato. Per i campi di sistema in Team Foundation per cui non esiste una corrispondenza con i campi di sistema in ClearQuest vengono generati campi aggiuntivi in ciascun tipo di elemento di lavoro. Questi campi vengono identificati con un commento simile al seguente file XML:
<!--State is a core field in Team Foundation Work Item Tracking and we recommend that you use this field because it best suits the purpose-->
Gestione dei campi elenco
Per i campi in ClearQuest potrebbe essere definito un insieme di valori validi o suggeriti. Durante la lettura dei campi e dei rispettivi tipi il convertitore determina se il campo è di tipo elenco e in tal caso raccoglie anche i valori di elenco validi o suggeriti. Queste informazioni vengono catturate nei file di definizione del tipo di elemento di lavoro nella sezione del campo corrispondente. Individuare gli elementi <AllowedValues> o <SugggestedValues>.
Gestione degli stati e delle transizioni di stato
Le definizioni del tipo di entità basate sullo stato nello schema ClearQuest supportano:
Un insieme di stati.
Transizioni tra stati, dette Azioni.
Comportamento del campo associato agli stati.
Il convertitore cattura le azioni e gli stati di ClearQuest come stati e transizioni di stato nelle definizioni del tipo di elemento di lavoro di Team Foundation.
Gestione del form dell'elemento di lavoro
Il convertitore non esegue la migrazione delle informazioni del form dal database ClearQuest a Team Foundation, bensì crea un form dell'elemento di lavoro predefinito come parte dello schema generato durante la fase di analisi. Questo form predefinito però non assomiglia a quello originale in ClearQuest. Il form predefinito presenta una formattazione semplice e quasi sempre richiede modifiche per migliorarne l'usabilità. Per informazioni sulla modifica dei form degli elementi di lavoro, vedere Definizione del form elemento di lavoro.
Controlli sul form
È possibile inserire diversi controlli in un form di un elemento di lavoro in ClearQuest, nonché in Team Foundation. Team Foundation supporta un insieme predefinito di controlli che è possibile utilizzare. Alcuni controlli disponibili in ClearQuest non sono disponibili in Team Foundation. Sebbene durante la migrazione venga conservata la quantità massima di dati, le diversità nei controlli si ripercuote sulla visualizzazione dei dati nel form in Team Foundation. I seguenti controlli non sono supportati in Team Foundation.
Controlli ActiveX
Controllo Calendar
Controllo casella di controllo
Controllo casella combinata
Controllo base duplicata
Controllo dipendenti duplicati
Controllo padre/figlio
Controllo immagine
Controllo pulsante di comando
Controllo casella di riepilogo
Controllo visualizzazione elenco
Controllo pulsante di opzione
Controllo casella di testo statico
Come parte della pianificazione della migrazione è necessario valutare il possibile effetto dell'assenza di questi controlli per gli utenti.
File di mapping dei campi
II file di mapping campi specifica il mapping dei campi e dei valori.
Mapping campi
I file di mapping campi specificano il mapping tra i campi di ClearQuest e i campi di Team Foundation. Per la maggior parte dei campi in ClearQuest, a eccezione dei campi di sistema e comuni, esiste un'associazione uno-a-uno in Team Foundation. È necessario mantenere i file di mapping dei campi sincronizzati con le modifiche apportate ai campi nei file di definizione dei tipi di elemento di lavoro. Se, ad esempio, si rinomina un campo nel file di definizione dei tipi di elemento di lavoro, è necessario modificare il file di mapping di conseguenza. Analogamente, se si eliminano campi dal file di definizione dei tipi di elemento di lavoro, è necessario eliminare gli stessi campi dal file di mapping dei campi corrispondente.
Mapping dei valori
I file di mapping campi specificano inoltre come i dati dei campi devono essere trasformati durante la migrazione. Per impostazione predefinita, non viene generato alcun mapping dei valori, ma è possibile specificare i mapping dei valori se si desidera trasformare i dati durante la migrazione. Per specificare le trasformazioni, definire i mapping dei valori per indicare, ad esempio, che al valore "Pri1" deve corrispondere "1".
Il file di mapping campi è un file XML. Nell'esempio riportato di seguito viene illustrato come eseguire il mapping di campi e valori:
<?xml version="1.0"?>
<FieldMaps xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<!-- Title is a core field in Team Foundation Work Item Tracking and we recommend that you use this field because it best suits the purpose-->
<FieldMap from="Headline" to="Title" />
<FieldMap from="Submitter" to="Submitter">
<ValueMaps refer="UserMap" />
</FieldMap>
<!-- Created Date is a core field in Team Foundation Work Item Tracking and we recommend that you use this field because it best suits the purpose-->
<FieldMap from="Submit_Date" to="Created Date" />
<!-- Assigned To is a core field in Team Foundation Work Item Tracking and we recommend that you use this field because it best suits the purpose-->
<FieldMap from="Owner" to="Assigned To">
<ValueMaps refer="UserMap" />
</FieldMap>
</FieldMaps>
Per ulteriori informazioni sul mapping campi, vedere Schema del file di mapping campi.
Mapping ai campi Percorso area e Percorso iterazione
Nella gestione degli elementi di lavoro di Team Foundation gli elementi di lavoro sono organizzati in una gerarchia di aree strutturali e iterazioni. Per ulteriori informazioni, vedere Procedura: modificare le aree progetti Team e Procedura: modificare le iterazioni di un progetto Team.
I percorsi consentono di raggruppare gli elementi di lavoro strutturalmente per rappresentare i componenti, i progetti o le applicazioni utilizzati dal team. Le iterazioni consentono di raggruppare gli elementi di lavoro in base a eventi principali, quali attività cardine e fasi di progetto. I campi di sistema Percorso area e Percorso iterazione definiscono queste informazioni in Team Foundation. Poiché in ClearQuest non è disponibile questo concetto, il convertitore fornisce un valore predefinito per questi campi, in base a cui tutti gli elementi di lavoro vengono inseriti nella radice di Percorso area e Percorso iterazione.
Sebbene ClearQuest non disponga dei campi Percorso area e Percorso iterazione, è possibile che questi concetti vengano utilizzati in altro modo. Ad esempio, è possibile che un campo nei tipi di elemento di lavoro rappresenti il progetto a cui l'elemento di lavoro appartiene. Ciò corrisponde grosso modo al concetto di Percorso area. Analogamente, è possibile disporre di un altro campo, denominato "Fix By" che indichi il punto entro il quale si desidera che uno specifico elemento di lavoro venga corretto. Considerare la possibilità di eseguire il mapping di questi campi a Percorso area e Percorso iterazione, in modo che gli elementi di lavoro vengano distribuiti in nodi diversi e non inseriti tutti nel nodo principale. Specificare questi mapping nei file di mapping campi del tipo di elemento di lavoro come spiegato in precedenza.
Nel seguente file XML di esempio viene eseguito il mapping di un campo di ClearQuest denominato Tree Path con i possibili valori Area1 e Area2.
<FieldMap from="Tree Path" to="Area Path" exclude="false">
<ValueMaps>
<ValueMap from="Area1" to="Area1" />
<ValueMap from="Area2" to="Area2" />
</ValueMaps>
</FieldMap>
Nel seguente file XML di esempio viene eseguito il mapping di un campo di ClearQuest denominato Fix By con i possibili valori Alpha e Beta.
<FieldMap from="Fix By" to="Iteration Path" exclude="false">
<ValueMaps>
<ValueMap from= "Alpha" to="Alpha"/>
<ValueMap from= "Beta" to="Beta"/>
</ValueMaps>
</FieldMap>
File di mapping utenti
Nel file di mapping utenti è specificato il mapping utenti tra ClearQuest e Team Foundation. Per ulteriori informazioni, vedere Schema del file di mapping utenti.
File di mappa dello schema
Il file di mappa dello schema specifica il tipo di elemento di lavoro di origine, il tipo di elemento di lavoro di destinazione, il file di definizione dell'elemento di lavoro e il file di mapping campi. Per ulteriori informazioni, vedere Procedura: modificare il file di mappa dello schema.
File di report di analisi
Al termine della migrazione viene generato un file di report di analisi con nome CQAnalysisReport.xml nella cartella in cui è stato eseguito CQConverter. Viene inoltre creata la cartella _MigrationReport_Files contenente i file immagine e un foglio di stile per la visualizzazione del report in un browser. Al termine dell'analisi aprire questo file per visualizzare eventuali errori o avvisi rilevati durante la fase di analisi. Il report di analisi contiene le seguenti informazioni:
**Riepilogo **Informazioni riassuntive sull'analisi.
**Errori **Eventuali errori rilevati durante l'analisi. È necessario correggere tutti gli errori elencati.
**Avvisi **Eventuali avvisi rilevati durante l'analisi. Gli avvisi richiedono l'intervento dell'utente, ma non devono essere per forza corretti.
Output Questa sezione elenca i file di output generati.
File di log
Il convertitore genera il file di log CQConverter.log che viene utilizzato per il debug e in genere non è necessario esaminarlo. Il file di log viene creato nella cartella in cui è stato eseguito CQConverter. Questo file contiene i messaggi di analisi e può essere utile per il debug di problemi rilevati durante l'esecuzione del convertitore.
Il livello di analisi viene controllato mediante l'impostazione del valore dell'attributo MinLevelForAllSource nel file CQConverter.exe.config, che si trova nella stessa cartella di CQConverter.exe. È possibile impostare un valore compreso tra 1, ovvero il livello di analisi minimo, e 4, ovvero il livello di analisi massimo.
| Nota: |
|---|
Si tenga presente che le prestazioni del convertitore sono più lente a livelli di analisi superiori e il file di log può diventare molto grande. |
File degli errori
Il convertitore genera inoltre un file contenente tutti gli errori rilevati durante l'esecuzione del convertitore. A questo file viene assegnato il nome ConverterErrors.txt e viene generato nella stessa cartella in cui è stato eseguito CQConverter.
Vedere anche
Attività
Procedura: modificare il file di mappa dello schema
Concetti
File di configurazione del convertitore degli elementi di lavoro
Riferimenti
Schema del file di mapping utenti
Altre risorse
Personalizzazione dei tipi di elemento di lavoro