Condividi tramite

Procedura: generare il file di configurazione del convertitore

  • Articolo

Aggiornamento: novembre 2007

Il file di configurazione del convertitore è un file XML che contiene le impostazioni per il convertitore di ClearQuest all'interno di sezioni come descritto di seguito:

<ClearQuest>

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

  • ConnectionName   Nome della connessione di ClearQuest.

  • UserDatabase   Nome del database di 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 di Team Foundation Server o URI completo nel formato http://Server:Porta.

    Se si utilizzano nomi descrittivi, assicurarsi di avere aggiunto Team Foundation Server tramite Team Explorer prima di eseguire il convertitore.

  • 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. Se si imposta il valore True, 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 di cui viene eseguita la migrazione. 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 esiste già una directory con tale nome, i file presenti verranno sovrascritti.

Autorizzazioni necessarie

Per eseguire questa procedura è necessario disporre delle autorizzazioni Utente attivo e Public Folder Administrator per il database ClearQuest. Per ulteriori informazioni, vedere la guida dell'amministratore di ClearQuest.

Per creare il file di configurazione

  1. Raccogliere le seguenti informazioni:

    • Nome della connessione di ClearQuest

    • Nome del database di ClearQuest

    • ID utente e password dell'amministratore di ClearQuest. Assicurarsi che l'utente disponga delle autorizzazioni necessarie per l'inoltro di segnalazioni in ClearQuest.

    • Nome del server Team Foundation.

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

  2. Creare una query in ClearQuest per selezionare gli elementi di lavoro di cui si desidera eseguire la migrazione a Gestione elementi di lavoro di Team Foundation e salvarla. Salvare la query con un nome qualsiasi, ad esempio QueryTransizione.

  3. Scegliere una directory per archiviare i file generati 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>JoseLugo</URI>
    <ProjectName>JoseLugoProjectX</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 come QueryTransizione, incluso il relativo percorso. Per informazioni sul contenuto di ciascuna sezione, vedere la sezione precedente "File di configurazione" in questo argomento.

    Nota:

    Se nel file non viene immessa alcuna password, verrà richiesta in seguito durante il processo di migrazione.

  6. Salvare il file, ad esempio con il nome ConfigConvertitoreCQ.xml.

Nota:

Salvare il file utilizzando la codifica UTF-8. Ad esempio, se si salva il file utilizzando Blocco note, selezionare UTF-8 nella casella Codifica della finestra di dialogo Salva con nome

Vedere anche

Altre risorse

Schema di definizione del tipo di elemento di lavoro