Comparer avec une version de référence

Dans cette première leçon, nous allons comparer le module courant avec l'une de ses versions de référence.
Ensuite, nous allons analyser la colonne de résultats et voir les différences de structure, d'attributs (y compris OLE), les différences de liens, différences d'objets : nouveaux/supprimés/purgés, et les différences de table.

Pour commencer, accédez au projet pour cette leçon.
Ensuite, ouvrez le module pour cette leçon.

Nous allons utiliser ce module dans les prochaines leçons.

Lancez le script de modules de comparaison en choisissant le menu Gestion de configuration > Comparer les modules.

Description rapide de la fenêtre Comparaison de modules:

  1. Méthodes de comparaison
    Méthodes pour effectuer les correspondances d'objets entre modules (et éventuellement des versions de référence).
    1. Option Comparaison par lien - Les objets dans les deux modules sont reliés. Par exemple, les objets ont été copiés en utilisant la commande Outils > Fonctions > Copier les objets... dans un module ouvert.
    2. Option Comparaison par attribut - Des objets dans deux modules ont un attribut commun avec des valeurs uniques par objet, par exemple l'attribut système "Absolute Number".
    3. Option Comparaison avec une version de référence - Pour comparer des objets entre deux versions de référence, ou une version courante et une version de référence, d'un même module.
    4. Option Comparaison avec une branche - Pour comparer des objets dans deux modules qui ont une branche commune.
  2. Champ Cible
    Le champ se rempli quand on clique sur Sélectionner la cible. Il représente le chemin d'accès au module cible de comparaison.
  3. Bouton Sélectionner la cible
    Cliquez sur ce bouton pour sélectionner le module et la version de référence.
  4. Options La cible est
    Décrit la relation temporelle de la cible à la source.
    Puisqu'une comparaison dirigée est effectuée, cela affecte la façon dont les résultats sont calculés.
    1. Option antérieure (avant changement) - Le module cible/la version de référence est plus ancien que le module source/la version de référence, à savoir les modifications apportées dans la source sont plus récentes que la cible.
    2. Option postérieure (après changement) - Le module cible/la version de référence est plus récent que le module source/la version de référence, à savoir les modifications apportées à la cible sont plus récentes que la source.
  5. Options Options de correspondance par attribut
    Si l'utilisateur a choisi l'option Comparaison par attribut, il doit choisir un attribut dans les modules source et cible pour effectuer les correspondances entre les objects.
    1. Option Attribut du module source - Choisit un attribut dans le module source pour effectuer les correspondances entre les objects.
    2. Option Attribut du module cible - Choisit un attribut dans le module cible pour effectuer les correspondances entre les objects.
  6. Options Options de comparaison
    Permet de spécifier ce qui doit être comparé entre les modules/versions de référence.
    1. Option Sélectionner les attributs à comparer - Une liste de cases représentant les attributs du module source ou de la version de référence source.
      Les attributs sélectionnés dans cette liste seront comparés à la cible.
    2. Options de Sélection
      • Option (Dé-)sélectionner - Sélectionne ou désélectionne tous les attributs dans la liste Sélectionner les attributs à comparer.
      • Option Attributs communs - Sélectionne les attributs communs à savoir "Object Heading", "Object Short Text", et "Object Text".
    3. Options Différences - Un groupe d'options pour sélectionner ce qui doit être comparer sur les objets.
      1. Option Montrer les différences structurelles - Compare les différences dans la hiérarchie des objets (parent, enfant, les relations entre frères).
      2. Option Montrer les différences d'attributs - Compare les différences entre attributs.
      3. Option Montrer les différences de liens - Compare les différences entre les liens sortants des objets.
      4. Option Montrer les objets nouveaux / supprimés - Compare l'état (création / suppression) des objets.
      5. Option Montrer les objets supprimés / purgés - Compare l'état (suppression / purge) des objets.
      6. Option Montrer les différences de table - Compare les caractéristiques des cellules de table.
  7. Bouton Ajouter une colonne
    Ajoute une colonne à la vue actuelle du module source, la colonne affiche les résultats de la comparaison au module cible.
  8. Bouton Montrer les différences d'attributs
    Présente les résultats de la comparaison des attributs de module dans du texte.
  9. Bouton Fermer
    Ferme la fenêtre.
    Si aucune colonne de comparaison n'a encore été créé, un avertissement s'affiche.

Puisque cette leçon compare la version actuelle du module à une version de référence, sélectionnez l'option Comparaison avec une version de référence.
Appuyez sur Sélectionner la cible.

Sélectionnez la dernière version de référence et appuyez sur OK.

Lorsque la version de référence de la cible est choisie, les paramètres de comparaison sont activés.
L'option Options de correspondance par attribut reste inactive puisque la comparaison avec une version de référence utilise automatiquement l'attribut Absolute Number pour les correspondances entre objets.
Par défault les seuls attributs comparés sont les "attributs communs".
Sélectionnez l'option Attributs communs.

Nous voyons que rien n'arrive à la liste des attributs à comparer.
L'option Attributs communs n'active que la comparaison pour les "attributs communs", elle fonctionne en sens inverse.
Appuyez sur (Dé-)sélectionner pour sélectionner tous les attributs.

Nous voyons maitenant tous les attributs cochés.
Appuyez sur (Dé-)sélectionner de nouveau pour désélectionner tous les attributs.

Nous voyons maintenant tous les attributs décochés.
Appuyez sur Attributs communs de nouveau pour sélectionner les "attributs communs".

Les "attributs communs" sont de nouveau sélectionnés.
Descendez jusqu'à la fin de la liste d'attributs pour vérifier également l'attribut "Test Status".

Avec la version de référence et les attributs choisis, appuyez sur Ajouter une colonne.

En apparence, rien ne se passe.
Appuyez maintenant sur Fermer pour voir la colonne de comparison dans le module source.

Nous constatons qu'une nouvelle colonne a été ajoutée à la vue actuelle contenant les résultats de la comparaison.
Afin que nous puissions mieux voir les résultats, retirez l'explorateur de module et redimensionnez les colonnes et les fenêtres si nécessaire.

Avant de commencer l'analyse, il est important de comprendre le sens de la comparaison.
Les résultats dans la colonne de comparaison supposent que les objets dans la vue source sont plus récents.
Les résultats montrent comment les objets de l'ancienne version de référence ont été changés pour la version courante, que l'on voit du côté droit.
Regardons le premier résultat de comparaison, sur "ORG_13", dans la première section, appelée "Attribute Differences".
Ce résultat nous indique que l'"Object Heading" a changé.
Le texte en rouge barré nous indique qu'il a été supprimé à partir de l'ancien objet, et que le texte souligné en bleu a été ajouté.
Ainsi, l'ancien entête était "This heading will change". Les mots "will change" ont été retirés du nouvel entête, et le mot "changed" a été ajouté.
Une évolution similaire a été faite à l'objet suivant, "ORG_11", cette fois-ci pour le texte de l'objet.
Le mot "text" a été effacé, et le mot "indeed" ajouté pour créer l'objet texte dans le module courant.
L'objet suivant, "ORG_12", a des changements dans la mise en forme.
L'algorithme qui calcule les changements de texte ci-dessus ne peut détecter qu'un seul changement de mise en forme.
Il ne peut pas montrer comment le texte a changé.
Ainsi, le texte de l'ancien objet est affiché.
Le dernier objet dans cette section, "ORG_54", montre une modification de l'attribut "Test Status".

Dans la section suivante, à propos des différences de liens, nous avons trois objets dont les liens ont été modifiés.
Le premier changement concerne "ORG_17".
La colonne de comparaison nous indique que le lien a été supprimé.
Le deuxième changement sur "ORG_18" montre qu'un nouveau lien a été créé.
Le dernier changement sur "ORG_19" montre qu'un lien a été déplacé de "MOD_5" vers "MOD_6".
Cependant, puisque les résultats de comparaison de liens sont calculés en termes de créations / suppressions, le résultat montre des suppressions / créations.

La section suivante concerne les objets nouveaux, supprimés ou purgés.
Le premier changement sur "ORG_21", montre que l'objet a été supprimé.
Vous remarquerez cependant que le résultat de la comparaison est dans "ORG_20".
C'est parce qu'il n'est pas possible de montrer des objets supprimés dans la vue courante, de sorte que le résultat est présenté dans l'objet non supprimé précédent.
C'est la même chose pour les objets purgés.
Les objets "ORG_23" et "ORG_25" ont été purgés.
Le résultat est présenté dans l'objet non supprimé précédent.
Dans le dernier résultat de comparaison, il faut comprendre que "ORG_22"a été restauré.

La section suivante concerne les différences sur les tables.
Il est important de noter que les différences détectées sur les tables sont montrées sur l'objet précédent non supprimé.

La section suivante concerne les différences sur les images.
Le premier objet sous l'entête "ORG_49", a vu son OLE changer.
L'objet suivant, "ORG_50", qui a une icône au lieu d'une image, a également été modifié.
Le dernier objet, "ORG_52", a vu son image changer, mais BranchManager for DOORS® ne prend pas en compte la détection des changements d'image.