Importation d'un lot d'enregistrements ClearQuest

Le ClearQuest Connector inclut un outil d'importation qui permet de créer des éléments correspondants dans un référentiel Jazz pour un lot d'enregistrements ClearQuest.
A propos de cette tâche
Par exemple, vous pouvez utiliser l'outil d'importation pour créer des éléments de travail Rational Team Concert qui correspondent à un lot d'incidents dans une base de données d'utilisateurs ClearQuest. Les nouveaux éléments de travail sont synchronisés avec les incidents. Les modifications que vous apportées à un élément de travail sont propagées à l'incident correspondant et celles que vous apportez à un incident sont propagées à l'élément de travail correspondant.

L'outil d'importation utilise les paramètres définis dans le fichier cqconnector.properties. L'assistant d'installation de ClearQuest Connector met à jour le fichier cqconnector.properties en fonction des choix que vous effectuez dans l'assistant. Vous pouvez également éditer directement le fichier cqconnector.properties pour définir les paramètres. Pour obtenir une description de ces paramètres, voir Modification des paramètres du service Connector. Exécutez l'outil d'importation plusieurs fois ; une fois pour chaque type d'enregistrement. Cette approche permet de vérifier que la synchronisation d'un type d'enregistrement a abouti avant de passer au prochain type d'enregistrement.

Certains types d'enregistrement peuvent dépendre d'autres types d'enregistrement. Vous devez d'abord exécuter l'outil d'importation sur les types d'enregistrement dont dépendent d'autres types d'enregistrement. Par exemple, dans l'exemple de schéma DefectTrackingInterop, la synchronisation du type d'enregistrement Incident dépend de la synchronisation réussie des types d'enregistrement Projet et Utilisateurs. Par conséquent, utilisez d'abord l'outil d'importation sur les types d'enregistrement Projet et Utilisateurs. Une fois que vous avez vérifié que la synchronisation de ces types d'enregistrement a abouti, exécutez l'outil d'importation sur le type d'enregistrement Incident.

La syntaxe de l'outil d'importation est la suivante :

synctool
recordType=nom-type-enregistrement
jazzServer=url
projectArea=nom_zone-projet 

Pour importer des enregistrements, procédez comme suit :

  1. Accédez au répertoire répertoire_installation\gateway.
  2. Exécutez la commande synctool. L'outil d'importation recherche le dossier des requêtes désigné par le paramètre cq.queryTreeRoot dans le fichier cqconnector.properties. S'il détecte une requête dans le dossier de zone de projet du type d'enregistrement spécifié, il utilise cette requête pour sélectionnez les enregistrements à importer. S'il n'existe aucune requête, l'outil d'importation sélectionne tous les enregistrements de ce type. Si vous avez un grand nombre d'enregistrements du type d'enregistrement à importer, exécutez plusieurs fois l'outil d'importation, en modifiant chaque fois la requête, de sorte que chaque appel sélectionne un sous-ensemble du nombre total d'enregistrements. Par exemple, vous pouvez ajuster la requête pour sélectionner les enregistrements en fonction de leur date de création. En outre, définissez bien les requêtes de sorte qu'elles ne sélectionnent que les enregistrements que vous prévoyez d'utiliser dans Rational Team Concert. Généralement, vous n'avez pas besoin d'inclure les enregistrements à l'état fermé.

    Chaque fois que vous ajoutez ou supprimez une requête ou que vous ajoutez une règle de synchronisation, vous devez arrêter et redémarrer la passerelle ClearQuest de sorte que le ClearQuest Connector utilise les nouveaux critères de synchronisation.

    Exemple sous Windows® :

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

    Sous Linux®, utilisez ./synctool pour lancer la ligne de commande.

  3. Ouvrez le client Rational Team Concert et vérifiez que l'outil d'importation a créé les enregistrements utilisateur pour les enregistrements ClearQuest sélectionnés par la requête. Dans la vue Artefacts de l'équipe, développez le dossier Mes zones d'équipe. Cliquez deux fois sur une zone d'équipe pour l'ouvrir. Dans la zone Membres, cliquez sur Ajouter pour ajouter les nouveaux utilisateurs à la zone d'équipe. Pour affecter des rôles aux utilisateurs, sélectionnez chaque utilisateur de la table Membres et cliquez sur Rôles de processus.
  4. Exécutez la commande synctool en spécifiant un autre type d'enregistrement. Par exemple, le type d'enregistrement Projet.
  5. Sur le client Rational Team Concert, vérifiez que l'outil d'importation a créé les éléments de catégorie correspondants pour les enregistrements de projet ClearQuest sélectionnés par la requête. Dans la vue Artefacts, cliquez sur la zone de projet à l'aide du bouton droit de la souris et sélectionnez Ouvrir. Dans l'éditeur Zone de projet, cliquez sur l'onglet Catégories d'éléments de travail. Sélectionnez la catégorie qui correspond à l'enregistrement de projet ClearQuest. Sélectionnez la zone d'équipe à associer à la catégorie. Cliquez sur Associer. Répétez cette étape pour chaque catégorie créée par l'outil d'importation en contrepartie des enregistrements de projet ClearQuest. Cliquez sur Sauvegarder pour sauvegarder la modification dans la zone de projet. Une fois que vous avez associé une catégorie à une zone d'équipe, les éléments de travail possédant cette propriété de catégorie sont associés à l'équipe appropriée.
  6. Exécutez la commande synctool en spécifiant un autre type d'enregistrement. Par exemple, le type d'enregistrement Incident.
  7. Sur le client Rational Team Concert, vérifiez que l'outil d'importation a créé les éléments de travail correspondants pour les incidents ClearQuest sélectionnés par la requête.
Résultats
Si l'outil d'importation sélectionne un enregistrement actuellement synchronisé avec une autre zone de projet sur le même Jazz Team Server, il déconnecte cet enregistrement de cette zone de projet pour pouvoir le synchroniser avec la zone de projet que vous spécifiez sur la ligne de commande.

Commentaires en retour

Etes-vous satisfait ? Vous pouvez faire part de vos commentaires à l'adresse Jazz.net (enregistrement requis) : Commentaire dans les forums ou soumettre un bogue