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.
Pour créer une règle de synchronisation, procédez comme suit :
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.
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.
| 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.
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.
Etes-vous satisfait ? Vous pouvez faire part de vos commentaires à l'adresse Jazz.net (enregistrement requis) : Commentaire dans les forums ou soumettre un bogue