Créer une branche
Description et Options
Menu: Menu de l'explorateur de projet / Gestion de configuration / Créer une branche
Fonctionnement:
- L'outil de création de branche est utilisé pour copier des modules d'une branche à l'autre, dans le but de créer une nouvelle branche, ou encore pour créer une branche incrémentalement.

L'outil de création de branche se présente de cette façon:
- Le bouton Sélectionner les modules ouvre la fenêtre d'édition de la liste de versions de modules qui permet de sélectionner les modules qui doivent être copiés.
Comme expliqué dans Concepts de création de branche, les modules doivent avoir des versions de référence.
- La liste Nom du module répertorie les versions des modules sélectionnés.
- Appuyez sur Parcourir pour choisir la branche cible (projet) pour laquelle les versions des modules sélectionnés seront copiés.
Il n'est pas possible de copier
un module ou une de ses copies plusieurs fois vers la même branche.
L'outil vérifie cette condition au cours de la création de branche et alerte l'utilisateur. Le champ Sélectionner le projet cible
indique le nom du projet cible après la sélection.
- Dès que le projet cible a été sélectionné et qu'au moins un module a été sélectionné, le bouton Créer la branche est actif.
- Si l'option Recréer les liens vers les projets distants est sélectionnée, l'outil de création de branche va copier tous les liens des modules sources.
Si une cible de lien ne peut être trouvée dans la branche cible et ne fait pas partie de l'opération de création de branche, le lien copié pointera vers le même objet que le lien d'origine.
- Si l'option Recréer les liens vers les projets distants est sélectionnée, alors les liens pour lesquels aucun module cible n'existe dans le projet cible ne seront pas
copiés et un avertissement sera émis après la création de branche.
- L'option Rediriger les liens des objets qui sont manquants dans la branche cible vers les objets de la branche source détermine la manière dont BranchManager for DOORS®
traite le cas où le module cible d'un lien copié existe, mais l'objet cible pour ce lien n'existe pas ou a été supprimé.
Si tous les liens doivent être conservés dans le module cible, cette option (et aussi l'option précédente) doit être activée.
Dans ce cas, BranchManager for DOORS® va créer un lien vers l'objet cible du lien source.
Si elle est désactivée, le lien ne sera pas copié et un avertissement sera émis.
- L'option Ne pas autoriser de nouveaux liens en dehors de la branche affecte la façon dont BranchManager for DOORS® gère les restrictions sur les liens
(appelées 'Options de liens').
Quand l'option est sélectionnée, BranchManager for DOORS® va copier les liens dont le module cible est dans la branche.
Quand l'option n'est pas sélectionnée, BranchManager for DOORS® copiera tous les liens sans restriction
(également ceux qui pointent vers des modules en dehors de la branche cible).
Cette option permet de contrôler si l'utilisateur a le droit de créer des liens en dehors de la branche cible.
Créer une branche avec le script de modules de branche
La création d'une branche nécessite les actions suivantes:
- Lancer le script
- Sélectionner une liste de modules sources et leurs versions de référence
- Sélectionner le projet cible
- Définir des options de création de branche
- Démarrer l'opération
Lancer le script
Sélectionnez le projet source à partir du navigateur de projet.
Utilisez le menu Gestion de configuration et la commande Créer une branche.
Sélectionner une liste de modules sources et leurs versions de référence.
Pour sélectionner des versions de référence, l'éditeur de liste de versions de modules est utilisé.
Vous pouvez sélectionner le contenu entier de la branche source ou un sous-ensemble.
BranchManager for DOORS® prend également en charge la création de branche pour des modules de différents projets source pour un même projet cible.
Il est obligatoire que tous les modules sources aient une version de référence sélectionnée.
Cette version représente le "socle commun" des deux modules et joue un rôle crucial pour la fusion.
Note: Pour ne pas perdre la trace des branches existantes dans votre base de données, il est recommandé que tous les modules sources proviennent du même projet DOORS (branche).

Sélectionner le projet cible
Le projet cible peut être n'importe quel projet DOORS, à l'exception du projet d'où les modules sources proviennent.
Il est recommandé d'utiliser des règles génériques en fonction du type de branche.
Par exemple, une branche devrait appartenir à un utilisateur identifié et individuel.
Toutefois, les branches partagées sont susceptibles d'être définies comme "parent" de la branche source.
La seule contrainte de l'outil est l'utilisation d'un projet comme source et destination d'une branche.
Les règles de l'organisation peuvent être appliquées au-delà de ce niveau.
Après avoir appuyé sur le bouton "Parcourir", le projet de destination pour les modules à copier doit être choisi.

Cela permettra d'identifier la racine à partir de laquelle la branche est créée.
A l'intérieur de ce projet, les modules cibles seront créés en fonction de leur position relative dans la branche source.
Cela signifie que si le projet source ressemble à ceci:
Alarm System
-
Customer Requirements
-
Customer Requirements
-
System Requirements
-
System Specification
-
Component Requirements
-
HW
-
Buzzer
Surveilance
Et le module "Buzzer" est copié vers un projet cible "Alarm Clock", le module sera créé sous:
Alarm Clock
-
Component Requirements
-
HW
-
Buzzer
Note:
- Après création d'une branche, les modules peuvent être renommés ou déplacés vers un autre dossier, ou même un autre projet. Des précautions doivent être prises. Il ne doit pas déjà avoir un module
parallèle dans cette branche.
Déplacer ou renommer le module n'a aucun impact sur une fusion plus tard.
Dans l'historique du module, le chemin d'origine et le nom du module seront visibles.
Cela peut être déroutant lorsque vous essayez de retracer l'historique d'un module.
Par conséquent le déplacement d'un module dans une autre branche n'est pas recommandée.
Définition des options de branche
Selon le cas d'utilisation, les options à sélectionner définissent comment BranchManager for DOORS® traite les liens.
Voir Description et options.
Démarrage de l'opération de céation de branche
Appuyez sur Créer la branche.