Création de règles de synchronisation

Vous devez créer des règles de synchronisation pour les types d'enregistrement ClearQuest que vous prévoyez de mapper à des éléments Rational Team Concert.
Avant de commencer

Vous pouvez utiliser l'assistant d'installation de ClearQuest Connector pour créer des règles de synchronisation ou des modèles de règle de synchronisation. Toutefois, une fois que vous avez généré des règles de synchronisation à l'aide de l'assistant, vous devez quand même vérifier et modifier ces règles avant de les utiliser. Cette rubrique décrit comment créer et modifier des règles à l'aide de l'éditeur Règle de synchronisation sur le client Eclipse Rational Team Concert.

Pour créer, modifier et supprimer des règles de synchronisation, vous devez disposer d'une licence d'accès Developer ou ClearQuest Connector Client. En outre, la zone de projet doit être configurée pour octroyer des droits à votre rôle utilisateur. Pour définir des droits d'accès, ouvrez la zone de projet, cliquez sur l'onglet Configuration du processus, cliquez sur Configuration de projet > Droits d'accès, sélectionnez un rôle, puis sélectionnez Connecteurs d'élément dans la liste Actions autorisées.

Démarrez bien la passerelle ClearQuest avant de créer une règle de synchronisation ; sinon, les listes de l'éditeur Règle de synchronisation ne sont pas alimentées par les zones des types d'enregistrement ClearQuest.

A propos de cette tâche
Pour plus de détails sur la création d'une feuille de travail de planification avant de créer des règles de synchronisation, voir Planification de règles de synchronisation. En plus des rubriques de cette section, reportez-vous au site https://jazz.net/wiki/bin/view/Main/WritingSyncRules pour des exemples de mappage de types de zone d'enregistrement ClearQuest à des propriétés d'élément Rational Team Concert.

Pour créer une règle de synchronisation, procédez comme suit :

  1. Connectez-vous au client Rational Team Concert.
  2. Dans la vue Artefacts de l'équipe, cliquez à l'aide du bouton droit de la souris sur la connexion au référentiel et sélectionnez Administrer > Règles de synchronisation. Dans la vue Règles de synchronisation, cliquez sur la zone de projet à l'aide du bouton droit de la souris et sélectionnez Nouveau > Règle de synchronisation. Pour éditer une règle de synchronisation existante, développez le noeud de la zone de projet pour afficher les règles de synchronisation. Cliquez deux fois sur une règle pour l'ouvrir dans l'éditeur Règle de synchronisation.
  3. Dans l'éditeur de règle de synchronisation, entrez un nom unique pour la règle dans la propriété Nom. L'utilisation d'une convention de dénomination similaire à celle des packages Java™ permet de définir des noms uniques. Par exemple : com.sapphire.clearquest.NomSchéma.TypeEnregistrement, NomSchéma correspondant au nom du schéma ClearQuestet TypeEnregistrement, au nom du type d'enregistrement à synchroniser, dans le schéma.
  4. Dans la section Mappage de type, sélectionnez le type d'élément à synchroniser avec le type d'enregistrement ClearQuest. La propriété Gestionnaire d'élément a comme valeur le gestionnaire qui crée et synchronise le type d'élément que vous avez sélectionné. Dans la zone Référentiel externe, sélectionnez la connexion au référentiel externe à utiliser lors du traitement de cette règle de synchronisation. Sélectionnez Gestionnaire ClearQuest (enregistrements non-utilisateur) comme Gestionnaire externe de tous les types d'enregistrement, exceptés les utilisateurs. Pour les types d'enregistrement utilisateurs, sélectionnez Gestionnaire ClearQuest (enregistrements utilisateur). Remarque : Les éléments des utilisateurs Rational Team Concert n'appartenant pas à une zone de projet, vous ne pouvez avoir qu'une règle de synchronisation pour le type d'enregistrement utilisateurs par Jazz Team Server. Dans la zone Type externe, sélectionnez le type d'enregistrement ClearQuest que vous voulez synchroniser avec l'élément Rational Team Concert.

    Lorsqu'un élément de travail est créé, sa zone Type est obligatoire. Les règles de synchronisation que vous créez pour mapper les types d'enregistrement à des éléments de travail doivent indiquer comment définir la valeur de la zone Type de l'élément de travail. Pour plus de détails, voir Mappage de types d'enregistrement à des types d'élément de travail.

  5. Dans la section des zones d'équipe activées, sélectionnez et désélectionnez des zones d'équipe pour restreindre la portée de la règle de synchronisation. Par défaut, tous les éléments Rational Team Concert associés à une zone de projet contenant des règles de synchronisation sont des candidats à la synchronisation sortante. Vous pouvez ne créer des enregistrements ClearQuest que pour les éléments associés à certaines zones d'équipe. Si une zone d'équipe parent est sélectionnée, toutes ses zones d'équipe enfant le sont également. Vous pouvez sélectionner une zone d'équipe enfant sans sélectionner sa zone d'équipe parent.
  6. Utilisez la zone Nombre maximal de cycles pour spécifier le nombre de cycles de synchronisation que doit tenter le ClearQuest Connector avant que l'opération de synchronisation n'échoue. Lors de la création d'une règle de synchronisation pour un type d'enregistrement avec état, sélectionnez Synchroniser tous les états d'élément. Pour les types d'enregistrement sans état, ne sélectionnez pas Synchroniser tous les états d'élément.
  7. Dans la section Mappages de propriété, indiquez quelles propriétés d'élément de travail sont mappées à quelles zones de type d'enregistrement ClearQuest. Cliquez sur Ajouter pour créer un mappage. Sélectionnez une propriété d'élément et une propriété externe correspondante (zone de type d'enregistrement ClearQuest). Pour mapper une relation d'élément de travail, sélectionnez l'une des propriétés d'élément suivantes : Associé, Blocs, DependsOn, Parent ou Enfant. Sélectionnez ensuite la propriété externe qui fait référence à l'enregistrement ClearQuest associé. Au lieu d'ajouter les mappages un par un, vous pouvez cliquer sur Initialiser pour créer un ensemble de mappages initial en fonction des noms de propriété correspondants (partiellement ou intégralement). Vous pouvez ensuite parcourir la liste des mappages et en supprimer ou en modifier si nécessaire.

    La section Détails du mappage affiche les détails du mappage sélectionné dans le tableau Mappages des propriétés. Pour supprimer une entrée dans la zone Propriété de l'élément ou Propriété externe, sélectionnez Aucun sous Propriété de l'élément ou Propriété externe. Utilisez la zone Synchronisation pour spécifier le sens de synchronisation. L'option Entrée/Sortie permet une synchronisation bidirectionnelle. L'option Entrée ne permet une synchronisation qu'entre la base de données d'utilisateurs ClearQuest et les éléments Rational Team Concert. L'option Sortie ne permet une synchronisation que des éléments Rational Team Concertvers la base de données d'utilisateurs ClearQuest. L'option Identificateur de l'élément est sélectionnée lorsque la propriété est utilisée comme clé de recherche pour le mappage d'un élément à un enregistrement ClearQuest. L'option Identificateur externe est sélectionnée lorsque la zone ClearQuest est utilisée comme clé de recherche pour le mappage d'un enregistrement ClearQuest vers un élément Rational Team Concert. Généralement, vous n'avez pas besoin de définir les zones Identificateur de l'élément ou Identificateur externe. Si la passerelle ClearQuest est active, l'éditeur Règle de synchronisation définit ces deux zones si nécessaire.

    Par défaut, lorsque les modifications apportées aux enregistrements ClearQuest sont synchronisées avec les éléments Rational Team Concert, l'opération de mise à jour est exécutée à l'aide du compte utilisateur Jazz que la passerelle ClearQuest utilise pour se connecter au référentiel Jazz. La zone Modificateur externe permet de configurer la règle de synchronisation de sorte que les modifications soient enregistrées dans le contexte de l'utilisateur qui les apporte. Pour plus de détails, voir Configuration des règles de synchronisation des utilisateurs externes.

    Si une valeur de propriété est une référence à un autre objet pour lequel une règle de synchronisation est définie, sélectionnez cette règle de synchronisation dans la liste Règle de synchronisation de référence. Par exemple, si le type d'enregistrement ClearQuest contient une zone avec une référence au type d'enregistrement utilisateurs, sélectionnez la règle de synchronisation du type d'enregistrement utilisateurs. Lors de la synchronisation, cette règle de synchronisation est traitée et une référence de l'élément Rational Team Concert à l'utilisateur Jazz est établie. Si une propriété est une référence à un autre élément de travail, vous pouvez spécifiez toute règle de synchronisation d'élément de travail comme règle de synchronisation de référence. L'opération de synchronisation utilise la règle de synchronisation appropriée lorsqu'elle détermine le type de l'objet référencé. Supposons par exemple que les types d'élément de travail Incident et Amélioration contiennent chacun la propriété DuplicateOf, qui est une référence à un autre élément de travail. Le mappage de propriété de DuplicateOf dans la règle de synchronisation Incident spécifie la règle de synchronisation Incident comme règle de synchronisation de référence. De même, le mappage de propriété de DuplicateOf dans la règle de synchronisation Amélioration spécifie la règle de synchronisation Amélioration comme règle de synchronisation de référence. Si l'opération de synchronisation détermine qu'un incident est marqué comme doublon d'une amélioration, elle utilise la règle de synchronisation Amélioration.

    Utilisez la section Transformateur de valeur pour spécifier tout traitement spécial à effectuer pour convertir les données propagées entre l'élément Rational Team Concert et la zone de l'enregistrement ClearQuest. Laissez l'option Aucune transformation sélectionnée si vous n'avez pas besoin de convertir des données ; sinon, désélectionnez-la pour activer les autres zones. Le ClearQuest Connector offre les transformateurs de valeur ci-après. Vous pouvez ajouter des transformateurs en créant des extensions de plug-in.

    Tableau 1. Transformateurs du ClearQuest Connector
    Nom du transformateur Description
    Connecter la zone au transformateur d'attribut personnalisé Mappe la valeur d'un attribut personnalisé d'un élément de travail à une zone d'un enregistrement ClearQuest référencée par une zone d'un autre enregistrement.
    Transformateur des détails du contributeur Non utilisé avec le ClearQuest Connector .
    Afficher les zones d'enregistrement référencées dans le transformateur d'attribut personnalisé Mappe le contenu d'un enregistrement ClearQuest référencé à un attribut personnalisé d'élément de travail de sorte que le contenu puisse être affiché dans l'éditeur d'élément de travail.
    Transformateur de zone de projet Non utilisé avec le ClearQuest Connector .
    Transformateur d'horodateur/jours Convertit une chaîne qui identifie le nombre de jours d'un enregistrement ClearQuest en nombre de millisecondes, qui est utilisé par l'horodatage pour déterminer l'heure.
    Transformateur d'action de l'élément de travail Détermine l'action à effectuer lors du passage d'un état à un autre au cours de la synchronisation entrante. Cela est nécessaire si la définition du flux de travaux de l'élément Rational Team Concert contient des transitions d'état ambiguës où plusieurs actions sont possibles pour passer d'un état à un autre.

    Contrairement aux types d'enregistrement Rational ClearQuest, les types d'élément de travail Rational Team Concert autorisent plusieurs actions pour passer d'un état à un autre. Si vous n'utilisez pas Transformateur d'action de l'élément de travail pour synchroniser les éléments qui contiennent plusieurs actions pour les transitions d'état, une opération de synchronisation qui suit une transition d'état génère une erreur indiquant que l'enregistrement ClearQuest ne peut pas passer à un autre état.

    Transformateur de pièces jointes de l'élément de travail Convertit une pièce jointe Rational Team Concert en pièce jointe d'enregistrement ClearQuest.
    Transformateur de catégorie de l'élément de travail Gère la structure hiérarchique des catégories Rational Team Concert mappées à des enregistrements ClearQuest lorsque la valeur correspond à un chemin d'accès.
    Transformateur de commentaires de l'élément de travail Convertit un commentaire Rational Team Concert en une remarque d'enregistrement ClearQuest.
    Transformateur d'étiquettes de l'élément de travail Convertit les étiquettes d'un élément de travail en mots clés dans un enregistrement ClearQuest.

    Certains transformateurs de valeurs peuvent nécessiter des propriétés supplémentaires pour pouvoir convertir les données. Si nécessaire, cliquez sur Définir d'autres propriétés sortantes dont le transformateur a besoin et sélectionnez les propriétés dans la boîte de dialogue Propriétés requises.

    Utilisez la section Mappages de valeur pour spécifier des valeurs à mapper entre des éléments et des enregistrements. Cliquez sur Ajouter. Entrez une valeur d'élément et la valeur de zone d'enregistrement ClearQuest correspondante. S'il n'existe pas de mappage un à un de toutes les valeurs, désignez-en un comme valeur par défaut. Par exemple, la zone Priorité ClearQuest peut contenir quatre valeurs (1, 2, 3 et 4) et la priorité Priorité Team Concert peut contenir trois valeurs (Elevée, Moyenne et Faible). Si vous mappez Elevée à 1 et 2, sélectionnez 1 ou 2 comme valeur externe Par défaut. Pour spécifier une valeur vide pour une zone d'enregistrement ClearQuest, laissez la valeur vide. Au lieu d'ajouter les mappages de valeur un par un, vous pouvez cliquer sur Initialiser pour créer un ensemble de mappages initial en fonction des noms de valeur correspondants (partiellement ou intégralement). Vous pouvez ensuite parcourir la liste et supprimer ou éditer des mappages de valeurs si nécessaire.

    Rational ClearQuest et Rational Team Concert permettent d'identifier respectivement les enregistrements et les éléments en double. Pour synchroniser les éléments en double, mappez la propriété d'élément DuplicateOf à la propriété externe original. Dans la zone Règle de synchronisation de référence, sélectionnez la règle de synchronisation utilisée pour les éléments de travail.

  8. Cliquez sur Sauvegarder pour sauvegarder votre travail.
Que faire ensuite

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


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