Importazione di un batch di record ClearQuest

ClearQuest include uno strumento di importazione che consente di creare elementi corrispondenti in un Jazz per un batch di record ClearQuest.
Informazioni su questa attività
Ad esempio, è possibile utilizzare lo strumento di importazione per creare gli elementi di lavoro Rational Team Concert che corrispondono a un batch di difetti in un database utente ClearQuest. I nuovi elementi di lavoro sono sincronizzati con i difetti. Le modifiche apportate a un elemento di lavoro vengono propagate nel difetto corrispondente e le modifiche effettuate in un difetto sono propagate nell'elemento di lavoro corrispondente.

Lo strumento di importazione utilizza la serie di parametri nel file cqconnector.properties. La procedura guidata di installazione di ClearQuest aggiorna il file cqconnector.properties in base alle scelte effettuate. È inoltre possibile modificare il file cqconnector.properties direttamente per impostare i parametri. Vedere Modifica dei parametri del servizio Connector per le descrizioni dei parametri. Eseguire lo strumento di importazione diverse volte, una volta per ogni tipo di record. Questo approccio consente di verificare che la sincronizzazione di un tipo di record abbia esito positivo prima di passare al successivo tipo di record.

Alcuni tipi di record potrebbero avere una dipendenza da altri tipi di record. È necessario eseguire lo strumento di importazione sui tipi di record da cui altri tipi di record dipendendo per primi. Ad esempio, nello schema DefectTrackingInterop di esempio, la sincronizzazione del tipo di record difetto dipende dalla sincronizzazione riuscita del progetto e dei tipi di record degli utenti. Utilizzare quindi per prima cosa lo strumento di importazione nei tipi di record degli utenti e del progetto. Dopo aver verificato la corretta sincronizzazione dei tipi di record, eseguire lo strumento di importazione nel tipo di record Difetto.

La sintassi dello strumento di importazione è la seguente:

synctool recordType=record-type-name jazzServer=url projectArea=project-area-name 

Per importare i record:

  1. Passare alla directory install-directory\gateway.
  2. Eseguire il comando synctool. Lo strumento di importazione cerca la cartella delle query che il parametro cq.queryTreeRoot nomina nel file cqconnector.properties. Se trova una query nella cartella dell'area progetto per il tipo di record specificato, utilizza tale query per selezionare i record da importare. Se non esiste nessuna query, lo strumento di importazione seleziona tutti i record del tipo di record. Se si dispone di un grosso numero di record del tipo di record da importare, considerare di eseguire lo strumento di importazione diverse volte, modificando la query ogni volta, in modo che ogni attivazione selezioni un sottoinsieme del numero totale. Ad esempio, si potrebbe regolare la query per selezionare i record in base alla data di creazione. Accertarsi inoltre di definire le query in modo che si selezionino solo i record sui i quali si pensa di lavorare in Rational Team Concert. In genere, non è necessario includere i record in uno stato chiuso.

    Tutte le volte che si aggiunge o rimuove una query o si aggiunge una regola di sincronizzazione, è necessario arrestare e riavviare il gateway ClearQuest in modo che ClearQuest utilizzi i nuovi criteri di sincronizzazione.

    Esempio, in Windows®:

    synctool recordType="users" jazzServer="https://cqconnector:cqconnector@localhost:9443/jazz" projectArea="Reporting"

    In Linux®, utilizzare ./synctool per avviare la riga di comando.

  3. Aprire il client Rational Team Concert e verificare che lo strumento di importazione abbia creato i record utente per i record ClearQuest selezionati dalla query. Nella vista Risorse utente del team, espandere la cartella Aree team personali. Fare doppio clic su un'area team per aprirla. Nell'area Membri, fare clic su Aggiungi per aggiungere nuovi utenti nell'area team. Per assegnare i ruoli agli utenti, selezionare ogni utente nella tabella Membri e fare clic su Ruoli del processo.
  4. Eseguire il comando synctool specificando un tipo di record diverso. Ad esempio, il tipo di record Progetto.
  5. Nel client Rational Team Concert verificare che lo strumento di importazione abbia creato elementi della categoria corrispondenti per i record di progetto ClearQuest selezionati dalla query. Nella vista Risorse utente del team, fare clic con il tasto destro del mouse nell'area progetto e selezionare Apri. Nell'editor dell'area progetto, fare clic sulla scheda Categorie elementi di lavoro. Selezionare la categoria che corrisponde al record del progetto ClearQuest. Selezionare l'area team che si desidera associare alla categoria. Fare clic su Associa. Ripetere questa fase per ogni categoria che lo strumento di importazione ha creato per farla corrispondere ai record del progetto ClearQuest. Fare clic su Salva per salvare la modifica nell'area progetto. Dopo aver associato una categoria a un'area team, gli elementi di lavoro con tale proprietà della categoria sono associati al team appropriato.
  6. Eseguire il comando synctool specificando un tipo di record diverso. Ad esempio, il tipo di record Difetto.
  7. Nel client Rational Team Concert, verificare che lo strumento di importazione abbia creato gli elementi di lavoro corrispondenti per i difetti ClearQuest selezionati dalla query.
Risultati
Se lo strumento di importazione seleziona un record che è attualmente sincronizzato in una diversa area progetto nello stesso Jazz Team Server, scollega tale record dall'area progetto in modo che possa sincronizzare il record con l'area progetto specificata nella riga di comando.

Feedback

Queste informazioni sono state utili? È possibile fornire un feedback su Jazz.net (è richiesta la registrazione): commenta nei forum o segnala un bug