File di configurazione del convertitore degli elementi di lavoro

Articolo
09/12/2008

Aggiornamento: novembre 2007

Il file di configurazione degli elementi di lavoro è un file XML che contiene le impostazioni per il convertitore di ClearQuest. Le sezioni di questo file vengono descritte più avanti in questo argomento, seguite da un file di configurazione di esempio che è possibile utilizzare per creare un file di configurazione personalizzato.

Sezioni del file di configurazione

Il file XML di configurazione del convertitore di elementi di lavoro contiene diverse sezioni che specificano come eseguire la migrazione degli elementi di lavoro da ClearQuest a Team Foundation. Queste sezioni vengono descritte in dettaglio più avanti in questo argomento.

<ClearQuest>

Nella sezione ClearQuest sono contenute informazioni sul database di ClearQuest di cui verrà eseguita la migrazione.

ConnectionName Nome della connessione di ClearQuest.
UserDatabase Nome del database utenti di ClearQuest.
QueryName Nome di una query salvata in ClearQuest.
UserID ID utente di ClearQuest. È necessario utilizzare l'ID utente "admin" in quanto questo utente deve essere autorizzato a creare tutti i tipi di elemento di lavoro.

<VSTS>

Nella sezione VSTS sono contenute informazioni sul server e sul progetto team di Gestione elementi di lavoro di Team Foundation verso cui viene eseguita la migrazione.

URI Nome descrittivo o URI completo del server Team Foundation Server. Ad esempio, "ServerAT" o "http://ServerAT:8080".
ProjectName Nome del progetto team di Gestione elementi di lavoro di Team Foundation.

Altre impostazioni di configurazione

Le altre sezioni nel file XML consentono di controllare quanto segue:

ExitOnError In questa sezione è possibile impostare il valore true o false. Selezionare True per uscire in caso di errore. In questo caso, infatti, il convertitore di ClearQuest si arresta se si verifica un errore durante la migrazione di alcuni elementi di lavoro.

Nota:
Questa impostazione viene applicata solo in caso di errori non irreversibili. In caso di errore irreversibile, ad esempio se non è possibile connettersi a ClearQuest, il convertitore di ClearQuest si arresterà anche se l'impostazione è False.

OutputDirectory Specifica la directory di destinazione per i file generati. Se non si specifica una directory di output, il convertitore crea una directory con il nome dell'entità di base per la generazione dei file di output. Se esiste già una directory con tale nome, i file presenti verranno sovrascritti.

File di configurazione del convertitore degli elementi di lavoro di esempio

Di seguito è riportato un file di configurazione del convertitore degli elementi di lavoro di esempio che esegue la migrazione del database TEST di ClearQuest sulla connessione CQRep utilizzando la query All Defects nel progetto team JoseLugoProjectX in Team Foundation. Viene inoltre indicato che il convertitore deve arrestarsi in caso di errore e viene specificata la directory per i file di output creati dal convertitore.

<?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>JoseLugo</URI>
    <ProjectName>JoseLugoProjectX</ProjectName> 
  </VSTS>
  <ExitOnError>true</ExitOnError>
  <OutputDirectory>DefectSchema</OutputDirectory>
</WorkItemConverter>