Planification de règles de synchronisation

Avant de créer des règles de synchronisation, vous devez analyser le ou les types d'enregistrement ClearQuest à synchroniser avec des éléments de travail Rational Team Concert et créer un plan de mappage des zones des types d'enregistrement aux propriétés des éléments de travail.
A propos de cette tâche
Il est préférable que la personne qui planifie et crée les règles de synchronisation corresponde à la personne qui a créé et géré le schéma ClearQuest. Il est également nécessaire de posséder les connaissances de base de Jazz et de bien comprendre les zones de projet et les éléments de travail.

Il n'est pas pratique de mapper chaque type d'enregistrement à un type d'élément de travail. Les deux types doivent être similaires en termes d'objectif, de zones requises et de modèle de transition d'état. Vérifiez tous les types d'enregistrement définis dans le schéma pour la base de données d'utilisateurs à connecter à une zone de projet Jazz et identifiez les types d'enregistrement qui représentent des candidats appropriés pour la synchronisation.

Vous pouvez utiliser l'assistant d'installation de ClearQuest Connector pour créer les versions initiales des règles de synchronisation, mais vous devez éditer ces règles pour spécifier des détails de mappage supplémentaires. Vous devez au moins éditer les règles de synchronisation pour spécifier comment définir la propriété Catégorie des éléments de travail.

Tout au long de la procédure de planification ci-après, relevez les informations sur votre type d'enregistrement dans la feuille de travail jointe. Créez une feuille de travail pour chaque type d'enregistrement à synchroniser. Utilisez la feuille de travail lorsque vous commencez à créer éditer des règles de synchronisation. Si vous utilisez l'assistant d'installation de ClearQuest Connector pour créer les versions initiales des règles de synchronisation, ouvrez ces règles de synchronisation dans l'éditeur de règle de synchronisation, comparez les détails du mappage aux exigences de votre feuille de travail de planification et identifiez les éventuels écarts.

Pour planifier vos règles de synchronisation, procédez comme suit :

  1. A l'aide du type d'élément de travail Cas d'utilisation de Rational Team Concert, développez le cas d'utilisation qui décrit comment votre équipe prévoit de travailler dans Rational Team Concert. Le cas d'utilisation doit indiquer le processus (tel que Scrum), les types d'élément de travail et les flux de travaux que votre équipe a l'intention d'utiliser.
  2. A partir du cas d'utilisation, identifiez quels types d'enregistrement ClearQuest sont à synchroniser avec quels types d'élément de travail. Si aucun type d'élément de travail Rational Team Concert prêt à l'emploi ne correspond à un type d'enregistrement ClearQuest à synchroniser, vous pouvez créer un type d'élément de travail qui corresponde à ce type d'enregistrement.
  3. Vous pouvez mapper un type d'enregistrement ClearQuest à plusieurs types d'élément de travail. Par exemple, votre type d'enregistrement peut être général, tel que Demande de modification, et contenir une zone qui le qualifie de Bogue ou d'Exigence de version. Dans ce cas, indiquez le nom de la zone ClearQuest que vous utilisez pour qualifier le type d'enregistrement et répertoriez les valeurs de zone et les types d'élément de travail correspondant.
  4. Définissez le sens de synchronisation entre le type d'enregistrement et le type d'élément de travail. Si vous prévoyez d'importer un ensemble d'enregistrements d'une base de données d'utilisateurs ClearQuest dans unréférentiel Jazz, et que vous demandez à votre équipe de ne travailler que dans Rational Team Concert, le sens de synchronisation est uniquement Inclus dans. Si vous avez l'intention d'utiliser à la fois Rational Team Concert et Rational ClearQuest, la synchronisation est Inclus dans et Sortie.
  5. Identifiez l'ensemble des zones requises dans le type d'enregistrement ClearQuest et dans le type d'élément de travail correspondant. Si vous utilisez le processus Scrum, les types d'élément de travail Incident et Tâche ne requièrent des entrées que dans les zones Récapitulatif et Classé selon (Catégorie). Dans la page Présentation de l'éditeur Elément de travail, les zones requises sont identifiées par un astérisque.

    Pour afficher les zones requises du type d'enregistrement ClearQuest, ouvrez le schéma dans ClearQuest Designer. Cliquez sur Démarrer > Tous les programmes > IBM Rational > IBM Rational ClearQuest > ClearQuest Designer. Dans l'assistant Ouvrir le schéma, sélectionnez le schéma du type d'enregistrement à synchroniser. Dans la sous-fenêtre de navigation, développez le dossier Types d'enregistrement, le dossier du type d'enregistrement spécifique, puis le dossier Etats et actions. Cliquez deux fois sur Comportements. La matrice Comportements identifie les zones requises comme Obligatoire.

  6. Pour chacune des zones ClearQuest requises, identifiez une zone dans le type d'élément de travail auquel vous pouvez mapper la zone ClearQuest. De la même manière, pour chaque zone de type d'élément de travail requise, identifiez une zone ClearQuest correspondante. Lors du choix d'une zone de mappage appropriée, prenez en compte la signification de la zone et le type de zone. Pour afficher les types de zone des types d'enregistrement ClearQuest, ouvrez le schéma du type d'enregistrement dans ClearQuest Designer. Dans la sous-fenêtre de navigation, développez le dossier Types d'enregistrement, le dossier du type d'enregistrement spécifique, puis cliquez deux fois sur Zones pour ouvrir la matrice Zones.

    Pour afficher les types de zone dans Rational Team Concert, connectez-vous au client Rational Team Concert. Dans la vue Artefacts de l'équipe, cliquez deux fois sur la zone de projet pour l'ouvrir dans l'éditeur Zone de projet. Cliquez sur l'onglet Configuration du processus. Développez Configuration de projet, Données de configuration, puis Eléments de travail. Cliquez sur Présentations de l'éditeur. Sélectionnez la présentation d'éditeur du type d'élément de travail que vous synchronisez. Dans la zone Présentation de l'éditeur, développez les onglets et les sections pour afficher la liste des présentations (zones). Le type apparaît entre parenthèses après chaque nom de zone.

  7. Si le type d'élément de travail ne possède pas de zones appropriées pour le mappage de certaines des zones de type d'enregistrement ClearQuest requises, créez ces zones dans le type d'élément de travail. Dans la page Configuration de projet, développez Configuration de projet, Données de configuration, puis Eléments de travail. Cliquez sur Types. Sélectionnez la catégorie de types d'élément de travail. Dans la zone Attributs personnalisés, cliquez sur Ajouter. Entrez un nom pour la zone et sélectionnez un type compatible avec le type de zone ClearQuest correspondant. Cliquez sur OK. Cliquez sur Sauvegarder pour sauvegarder les modifications que vous avez apportées au type d'élément de travail.
  8. Si le type d'enregistrement ne possède pas de zones appropriées pour le mappage de certaines des zones de type d'élément de travail requises, créez ces zones dans le type d'enregistrement en ajoutant des lignes à la matrice Zones.
  9. Lors de la synchronisation entrante, la propriété de catégorie d'un élément de travail doit être définie car l'élément de travail est associé à une zone d'équipe en fonction de sa catégorie. Dans Rational Team Concert, vous pouvez fournir les informations de catégorie des manières suivantes :
    • Connectez un enregistrement ClearQuest sans état à une catégorie
    • Mappez une ou plusieurs zones d'enregistrement ClearQuest de type chaîne à une catégorie
    • Mappez une valeur externe vide à une valeur de catégorie fixe
    • Mappez, mais ne connectez pas un ou plusieurs enregistrements ClearQuest à une catégorie

    Reportez-vous à la rubrique Edition de règles de synchronisation pour spécifier des catégories pour plus d'informations sur ces méthodes, puis choisissez l'une des méthodes à utiliser.

  10. Identifiez les zones d'enregistrement ClearQuest supplémentaires à synchroniser avec des zones d'élément de travail. Identifiez les zones d'élément de travail correspondantes. Si nécessaire, créez des zones dans le type d'élément de travail en ajoutant des attributs personnalisés.
  11. Identifiez les zones d'enregistrement ClearQuest à afficher dans l'élément de travail, mais à ne pas synchroniser avec une zone d'élément de travail.
  12. Certaines des zones à synchroniser possèdent-elles des listes d'options de valeurs, telles qu'une zone Priorité ou Gravité ? Pour chacune des zones de ce type, identifiez le mappage des valeurs de la zone d'enregistrement ClearQuest à la zone d'élément de travail. S'il n'existe pas de mappage un à un de toutes les valeurs, désignez-en un comme valeur par défaut.
  13. Certaines des zones à synchroniser requièrent-elles un traitement spécial de leurs valeurs avant que ces dernières puissent être envoyées aux zones d'enregistrement ClearQuest ou aux zones d'élément de travail correspondantes ?

    Le ClearQuest Connector offre les transformateurs de valeur ci-après.

    Tableau 1. Transformateurs de 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 note sur l'enregistrement ClearQuest. Vous devez utiliser le module Notes standard fourni avec Rational 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.

    Identifiez les zones qui requièrent une transformation et répertoriez les transformateurs requis.

  14. Si le type d'enregistrement inclut des pièces jointes, vous pouvez créer une règle de synchronisation de sorte que lorsqu'un enregistrement ClearQuest est synchronisé avec un élément de travail, les pièces jointes à l'enregistrement et l'élément de travail sont également synchronisés. Indiquez si vous prévoyez de synchroniser les pièces jointes.
  15. Identifiez les zones d'enregistrement ClearQuest que vous prévoyez de synchroniser qui correspondent à des zones de type référence. Vous devez créer des règles de synchronisation pour les types d'enregistrement référencés par ces zones.
  16. Certaines des zones d'enregistrement ClearQuest que vous prévoyez de synchroniser possèdent-elles des points d'ancrage qui établissent des dépendances avec d'autres zones ? Par exemple, un point d'ancrage associé à une zone peut utiliser la valeur qu'un utilisateur entre dans cette zone pour déterminer comment définir la valeur d'une autre zone. Dans ce scénario, vous devez identifier l'ordre dans lequel les points d'ancrage doivent être exécutés pour que les zones d'enregistrement ClearQuest reçoivent les valeurs appropriées.

    Le fichier cqconnector.properties inclut le paramètre cq.orderedProperties.record-type, qui permet de spécifier l'ordre dans lequel les valeurs des zones d'enregistrement ClearQuest doivent être définies. Toutes les zones que vous ne spécifiez pas avec cq.orderedProperties.record-type sont traitées après les zones spécifiées.

    Une autre manière de spécifier l'ordre consiste à utiliser la propriété Zones dépendantes du web sur les zones de la définition de formulaire dans ClearQuest Designer. Si vous spécifiez à la fois la propriété Zones dépendantes du web et le paramètre cq.orderedProperties, le ClearQuest Connector utilise l'ordre spécifié avec le paramètre cq.orderedProperties.


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