Importation d'un fichier de vidage Subversion

Un fichier de vidage Subversion (SVN) contient l'intégralité du contenu d'un référentiel Subversion. Vous pouvez importer la totalité ou une partie d'un tel fichier vers un composant nouveau ou existant.
Avant de commencer
Pour mapper des noms d'utilisateur, vous devez être administrateur de référentiel Jazz. Si vous ne mappez pas les noms d'utilisateur, le propriétaire de tous les fichiers et dossiers importés est l'utilisateur qui a exécuté l'importation.
A propos de cette tâche

Pour créer un fichier de vidage Subversion, utilisez la commande Subversion svnadmin dump. Les fichiers de vidage peuvent être filtrés : vous pouvez ainsi supprimer les éléments que vous ne voulez pas importer dans contrôle des sources Rational Team Concert. Pour plus d'informations sur la création et le filtrage des fichiers de vidage Subversion, voir http://svnbook.red-bean.com/en/1.1/re31.html ou la documentation relative à Subversion à l'adresse http://subversion.tigris.org/.

L'importation d'un fichier de vidage Subversion se compose de deux phases. Dans la première, vous indiquez la source d'importation (un fichier de vidage Subversion) et la destination (un composant d'un espace de travail de référentiel). Dans la seconde, l'importateur ouvre le fichier de vidage et affiche une liste de dossiers pouvant être sélectionnés en vue de leur importation et une liste des noms d'utilisateur Subversion que vous pouvez mapper vers des utilisateurs Jazz.

Pour importer un fichier de vidage Subversion, procédez comme suit :

  1. Dans le menu principal de Jazz Source Control, cliquez sur Fichier > Importer.
  2. Dans la page Sélectionner, développez Jazz Source Control, puis sélectionnez Fichier de vidage SVN. Cliquez sur Suivant.
  3. Dans la page Importation d'un fichier de vidage SVN, cliquez sur Parcourir. Accédez au fichier de vidage que vous voulez importer, puis cliquez sur Ouvrir.
  4. Facultatif : Pour sauvegarder un fichier de vidage compressé, sélectionnez Sauvegarder une version compressée du fichier de vidage pour des importations supplémentaires.
  5. Cliquez sur Suivant.
  6. Dans la page Importation dans l'espace de travail et le composant, spécifiez un espace de travail de destination et un composant pour l'importation :
    Conseil : En cas d'importation du tronc, créez un nouveau composant. En cas d'importation d'une branche, sélectionnez une version de référence du composant créée lors de la précédente importation du tronc.
    • Pour importer un espace de travail et un composant de référentiel, sélectionnez Sélectionner un composant dans un espace de travail de référentiel existant et sélectionnez l'espace de travail et le composant.
    • Pour effectuer l'importation dans un nouveau composant d'un espace de travail de référentiel existant, sélectionnez Sélectionner un composant dans un espace de travail de référentiel existant et cliquez sur Nouveau composant. Entrez un nom pour le nouveau composant.
    • Pour créer un espace de travail et un composant de référentiel destiné à recevoir l'importation, sélectionnez Créer un espace de travail de référentiel appelé et entrez un nom pour l'espace de travail. L'importation crée un nouvel espace de travail et un composant. Le composant a le même nom que l'espace de travail.
  7. Cliquez sur Suivant.
  8. Facultatif : Dans la page Configurer l'importation à partir de SVN vers Jazz, effectuez l'une des étapes suivantes :
    • Pour spécifier un nom de version de référence, entrez un nouveau nom de version de référence dans la zone Nom de la version de référence post importation.
    • Pour générer des versions de référence pour la branche et les pointeurs de balise, sélectionnez Créer les versions de référence pour la branche et les pointeurs de balise.
    • Pour spécifier un codage de fichier texte, dans la sous-fenêtre Codage du fichier texte, sélectionnez Autre ; dans la liste déroulante, sélectionnez un type de codage.
    • Pour réconcilier des fichiers existants et importés, sélectionnez Réconcilier tout chevauchement existant entre les fichiers importés et les dossiers.
    • Pour spécifier une plage de révisions à importer, dans la sous-fenêtre Révisions à importer, sélectionnez Importer toutes les révisions au sein de la page spécifiée ; dans les zones Démarrer la révision et Arrêter la révision, spécifiez la plage de révisions.
  9. Cliquez sur Suivant.
  10. Facultatif : Dans la page Mappage utilisateur, effectuez l'une des étapes suivantes :
    • Pour différer le mappage utilisateur jusqu'à la lecture du fichier de vidage SVN et l'affichage des utilisateurs qu'il contient, sélectionnez Demander les utilisateurs Jazz une fois que les ID utilisateur SVN ont été reconnus.
    • Pour ne pas mapper les utilisateurs, sélectionnez Ne pas mapper les utilisateurs SVN vers des utilisateurs Jazz.
    • Pour mapper automatiquement les noms d'utilisateur aux mêmes ID et créer les utilisateurs manquants, sélectionnez Mapper automatiquement les utilisateurs SVN vers les utilisateurs Jazz ayant le même ID et créer les utilisateurs manquants.
  11. Facultatif : Dans la page Mappages utilisateur, pour mapper manuellement les utilisateurs SVN aux utilisateurs Jazz, sélectionnez Utiliser le mappage indiqué ci-dessous et effectuez l'une des étapes suivantes :
    • Pour ajouter un utilisateur SVN, cliquez sur Ajouter utilisateur SVN. Dans la boîte de dialogue Ajouter un ID utilisateur SVN, entrez un nom d'utilisateur dans la zone, puis cliquez sur OK.
    • Pour créer un utilisateur Jazz du même ID utilisateur qu'un utilisateur Subversion, sélectionnez un nom dans la colonne ID utilisateur SVN, puis cliquez sur Créer des utilisateurs Jazz.
    • Pour mapper un ID utilisateur SVN à un utilisateur Jazz existant, sélectionnez un nom dans la colonne ID utilisateur SVN, puis cliquez sur Modifier l'utilisateur Jazz. Dans la boîte de dialogue Sélectionner des utilisateurs, entrez un nom d'utilisateur Jazz dans la zone, puis cliquez sur OK.
    • Pour supprimer un utilisateur Subversion, cliquez sur le nom d'utilisateur, puis cliquez sur Supprimer.
    • Pour sauvegarder les mappages en cours vers un fichier réutilisable pour d'autres importations, cliquez sur Sauvegarder.
    • Pour réutiliser un fichier de mappage créé lors d'une précédente importation, cliquez sur Charger.
  12. Cliquez sur Suivant.
  13. Dans la page Chemins de projet, pour spécifier les chemins d'accès des projets à importer, effectuez l'une des étapes suivantes :
    • Si vous n'êtes pas sur de la structure du référentiel Subversion, sélectionnez Demander à déterminer quels dossiers à importer lorsque la structure de dossier du référentiel SVN est connue.
    • Pour importer un chemin d'accès comme dossier de niveau supérieur dans le composant cible, sélectionnez Importer les chemins indiqués ci-dessous comme dossiers de niveau supérieur dans le composant cible. Pour ajouter un chemin d'accès, cliquez sur Ajouter un chemin et, dans la boîte de dialogue Ajouter un chemin, entrez le nom du chemin d'accès dans la zone correspondante et cliquez sur OK. Pour charger un ensemble de chemins d'accès sauvegardés dans un fichier, cliquez sur Charger et accédez au fichier. Pour sauvegarder le fichier dans un emplacement spécifié, cliquez sur Sauvegarder.
    • Pour importer un chemin d'accès spécifié ci-après comme racine du composant, sélectionnez Importer le chemin indiqué ci-dessous comme racine du composant. Pour éditer un chemin d'accès, sélectionnez-le, puis cliquez sur Editer. Dans la boîte de dialogue Editer un chemin, dans la zone Chemin, modifiez le chemin d'accès et cliquez sur OK.
  14. Cliquez sur Terminer pour afficher le contenu (dossiers et utilisateurs) du fichier de vidage Subversion sélectionné.
  15. Au cours de cette phase du processus d'importation, vous sélectionnez les dossiers à importer et, si vous êtes administrateur de référentiels, vous indiquez comment les noms d'utilisateur SVN sont mappés aux noms d'utilisateur Jazz. Dans la page Choisissez les dossiers SVN à importer, dans la zone Dossiers trouvés dans le référentiel SVN, sélectionnez les dossiers à importer et effectuez l'une des étapes suivantes :
    • Pour rechercher le fichier pour les projets Eclipse, cliquez sur Ajouter des projets ou utilisez les boutons Ajouter et Supprimer pour créer une liste des dossiers à importer.
    • Pour sauvegarder la liste actuelle des dossiers dans un fichier réutilisable pour d'autres importations, cliquez sur Sauvegarder.
    • Pour réutiliser une liste de dossiers créée lors d'une précédente importation, cliquez sur Charger.
  16. Pour mapper les noms d'utilisateur, cliquez sur Suivant.
  17. Dans la page Mappage utilisateur, indiquez les mappages de noms d'utilisateur que l'importateur devra effectuer ou cliquez sur Ne pas mapper les utilisateurs SVN vers des utilisateurs Jazz si vous souhaitez que l'utilisateur Jazz qui exécute l'importation soit le propriétaire de tous les fichiers et dossiers importés.
    • Cliquez sur un de ces noms et sur Modifier l'utilisateur Jazz pour afficher la liste des noms d'utilisateur Jazz vers lesquels l'utilisateur Subversion peut être mappé.
    • Pour créer un utilisateur Jazz à mapper à un utilisateur Subversion, cliquez sur Créer des utilisateurs Jazz.
    • Pour annuler un mappage, cliquez sur Réinitialiser.
    • Pour sauvegarder les mappages d'utilisateurs en cours vers un fichier réutilisable pour d'autres importations, cliquez sur Sauvegarder.
    • Pour réutiliser un fichier de mappage d'utilisateurs créé lors d'une précédente importation, cliquez sur Charger.
  18. Pour commencer l'importation, cliquez sur Terminer.
Résultats
Une fois l'importation terminée, vous pouvez ajouter le nouveau composant à un flux ou, si vous avez effectué l'importation vers un composant existant, distribuer les ensembles d'artefacts importés, afin que les autres membres de l'équipe puissent les utiliser.

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