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 :
- 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.
- 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.
- 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.
- 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.
- 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 . 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.