Créer une branche simple

Dans cette première leçon, nous allons effectuer l'opération la plus simple possible, la création d'une branche pour un seul module sans lien.
Ensuite, nous analyserons les résultats de l'opération afin de comprendre ce qui a été créé et copié en termes de définitions de type/attribut, des valeurs d'attributs pour les modules/objets (y compris OLE et images), les vues et la hiérarchie de l'objet.
Les liens sont traités en détails dans les leçons suivantes.

Avant de créer la branche, vous avez besoin d'un nouveau projet.
Créez-le dans le dossier Branch Lessons comme indiqué: faites un clic droit sur un espace vide sur le côté droit de l'explorateur de base de données, choisissez Nouveau > Projet ..., entrez un nom pour ce nouveau projet, par exemple "2-1 Branch [username]", puis appuyez sur OK.

Le nouveau projet apparaît dans le dossier Branch Lessons.

Maintenant lancez le script "Créer une branche" en choisissant la commande Gestion de configuration > Créer une branche.

Description rapide de la fenêtre:

  1. Bouton Sélectionner les modules
    Ouvre la fenêtre éditeur de liste de versions de modules pour sélectionner les modules et les versions de référence.
  2. Liste Nom du module (version de référence)
    Affiche les modules et les versions de références sélectionnés dans la fenêtre de l'éditeur de liste de versions de modules.
  3. Bouton Parcourir
    Permet de sélectionner le projet cible.
  4. Champ Sélectionner le projet cible
    Nom complet du project, ne peut pas être modifié manuellement.
  5. Options sur les liens
    Trois options qui affectent la façon de gérer les liens lors de la création de branche.
    Ces options sont traitées dans les prochaines leçons.
  6. Bouton Démarrer la création de branche
    Lorsque toutes les données nécessaires ont été saisies, cette commande devient active.
    Le bouton va commencer le processus de création des branches (pour les versions de référence) du module source dans le projet cible.
  7. Bouton Fermer
    Quitte l'opération en cours.

    Tout d'abord, choisissez la version de référence pour laquelle la branche doit être créée en cliquant sur Sélectionner les modules.

    Dans cette vue, sélectionner le module X du projet "The Simplest Branch for...".
    Double-cliquer sur la version de référence "1.1" du module X.

    Une fois que vous avez choisi la version de référence "1.1" du module X, appuyer sur Utiliser les modules sélectionnés.

    Le module et sa version de référence apparaissent maintenant dans la liste des modules.
    Sélectionner le projet cible en appuyant sur Parcourir.

    Choisisser le nouveau projet dans le dossier Branch Lessons que vous avez créé et appuyer sur OK.

    Le projet apparaît dans le champ texte.
    Appuyer sur Démarrer la création de branche pour démarrer le processus.

    Une petite fenêtre indique les différentes étapes et sa progression globale.
    Lorsque la création de branche est terminée, une boîte d'information apparaît.
    Appuyer sur OK.

    Le focus revient dans la fenêtre principale où vous pouvez cliquer sur Fermer.

    Le module X a été copié dans le projet que vous avez créé.

    Nous allons analyser le module X créé et voir quelles sont les différences avec le module X original.

    Sélectionner le module X et exécuter la commande du menu Editer > Types....

    Une boîte de dialogue apparaît avec un onglet Types.
    Nous voyons ici que le type "Test Status Type", qui n'est pas un type système de DOORS, a été créé dans le module copié.
    Lors de la création d'une branche, BranchManager for DOORS® copie tous les types non-systèmes.

    Sélectionnez l'onglet Attributs.
    Noter que l'attribut "Test Status", qui n'est pas un type système de DOORS, a été créé dans le module copié.
    Lors de la création d'une branche, BranchManager for DOORS® copie tous les attributs de type non-système.
    Appuyez sur Fermer.

    Analysons les valeurs d'attributs.
    Sélectionner le module X copié, exécutez la commande du menu Fichier > Propriétés de module....

    Une nouvelle fenêtre s'ouvre avec un onglet Général.
    Nous voyons que la valeur de l'attribut du module "Test Status" a été copié.
    Lors de la création d'une branche, BranchManager for DOORS® copie toutes les valeurs d'attribut de type non-système.
    Noter également qu'il y a des attributs de module supplémentaires, des attributs qui n'existent pas dans le module X original.
    Ces attributs de modules contiennent des données utilisées pour la correspondance, la comparaison et la fusion de modules.
    Ces attributs ne doivent jamais être modifiés manuellement !
    Lors de la création d'une branche, BranchManager for DOORS® crée (ou met à jour) des attributs spéciaux de module pour garder une trace des opérations.
    Appuyez sur OK.

    Maintenant, cliquer sur la liste déroulante Vue.
    Nous voyons que la Test View du module source a été copiée dans le module cible.
    A la création d'une branche, BranchManager for DOORS® copie toutes les définitions d'attributs non-système.
    Sélectionnez Test View dans la liste déroulante.

    Il ya plusieurs choses à noter ici.
    Tout d'abord, les valeurs des attributs des objets ont été copiées.
    Lors de la création d'une branche, BranchManager for DOORS® copie toutes les valeurs d'attribut objet non-système, y compris les tableaux, du texte riche, des images et OLE.
    Deuxièmement, la structure des objets a été copiée.
    Lors de la création d'une branche, BranchManager for DOORS® copie la structure hiérarchique de l'objet.
    Troisièmement, l'état de la suppression d'objets a été copié (MOD_5, MOD_6, et MOD_7).
    Donc, si un objet a été supprimé dans le module source il sera supprimé dans le module copié.
    Lors de la création d'une branche, BranchManager for DOORS® copie l'état de l'objet.

    Il est important de noter que l'identifiant unique des objets est conservé lors de la copie, même pour les objets qui ont été purgés.
    Appuyez sur Ctrl-G pour ouvrir la fenêtre "Aller à", entrez "8" dans le champ de texte.
    Ensuite, appuyez sur Aller à.

    Vous voyez que l'objet d'Absolute Number "8" est absent, c'est à dire qu'il a été purgé, tout comme dans le module source.
    Lors de la création d'une branche, BranchManager for DOORS® copie l'état de purge de l'objet.
    Appuyer sur OK pour continuer.

    Nous avons vu que la branche créée des attributs spéciaux de module, maintenant, regardons les versions d'objets.
    Faire un clic droit sur un objet et sélectionnez l'option Propriétés ....

    Sélectionner l'onglet Attributs et vous pouvez voir les attributs particuliers des objets qui contiennent des données utilisées pour la correspondance, la comparaison et la fusion.
    Ces attributs ne doivent jamais être modifiés manuellement !
    Lors de la création d'une branche, BranchManager for DOORS® crée (ou met à jour) les attributs spéciaux des objets pour garder une trace.