Migration de projets WebFacing

Les anciens projets doivent être migrés pour pouvoir poursuivre le développement de vos applications WebFacing. Par exemple, vous ne pouvez pas convertir du code source DDS ou modifier les propriétés de votre projet. Cependant, vous pouvez exécuter des projets non migrés. Afin de différencier les projets non migrés des projets à jour, les projets non migrés sont identifiés par des icônes uniques dans la vue Projets WebFacing.

La migration d'un projet est divisée en deux étapes. La première étape est réalisée par le produit de base pour tout projet Web. La seconde est réalisée par l'assistant de migration WebFacing pour les mises à jour spécifiques aux projets WebFacing.
Important : WebFacing ne prend en charge que les projets de migration version 6.0.x et ultérieure.

Migration de base

Les projets WebFacing doivent être chargés dans un espace de travail courant avant de pouvoir être migrés par le biais de l'assistant de migration WebFacing. La migration est irréversible. Nous vous recommandons donc de sauvegarder votre espace de travail ou vos projets.

Les précédents projets WebFacing peuvent être introduits dans l'espace de travail de niveau courant en ouvrant l'ancien espace de travail ou en important les anciens projets. Les projets existants peuvent être directement importés à partir des dossiers ou des fichiers archive (Importer > Général > Projets existants dans l'espace de travail) ou en utilisant les fichiers d'échange du projet (Importer > Autre > Echange du projet).

Une fois que le projet est ouvert dans la version 7.5, l'assistant de migration Rational Desktop se lance. Il vous permet de sélectionner les projets à mettre à jour et vous indique quels seront les fichiers modifiés. Utilisez l'assistant pour réaliser les modifications nécessaires puis cliquez sur Terminer pour lancer la migration du projet. Lorsque la migration de l'espace de travail est terminée, les résultats s'affichent dans la vue Résultats de la migration. Pour plus de détails voir "Migration des espaces de travail et des projets".

Si les résultats signalent des erreurs ou que le projet en comporte consultez la section d'identification des incidents de migration. Après la migration de l'espace de travail, vous pouvez réinitialiser la perspective manuellement en cliquant sur Fenêtre > Réinitialiser la perspective.

Vos projets peuvent maintenant être utilisés dans le nouvel espace de travail. Cependant ils doivent encore être migrés avec l'assistant de migration WebFacing Migration.

Utilisation de l'assistant de Migration WebFacing

Préparation d'un projet pour la migration WebFacing

Vous serez sans doute amené à réaliser les tâches préparatoires suivantes avant de lancer l'assistant de migration WebFacing.

  1. Si les projets sont de niveau J2EE 1.2 ou 1.3, migrez-les vers le niveau J2EE 1.4 avec l'assistant de migration J2EE avant de effectuer la migration WebFacing. Consultez la section Migrating the specification level of J2EE projects dans l'aide en ligne (Aide > Table des matières de l'aide et naviguez versRational Developer product documentation > Installing, migration, configuring).
  2. Vérifiez qu'un serveur valide est sélectionné dans la page Environnements d'exécution cible, notamment lorsque le projet d'origine ne dispose pas d'un environnement d'exécution cible ou qu'il cible un niveau de serveur qui n'est plus pris en charge.
  3. Résolvez toutes les erreurs du chemin d'accès aux classes de votre projet. Dans la vue Navigateur, cliquez avec le bouton droit sur votre projet et sélectionnez Propriétés. Supprimez toutes les entrées .../WEB-INF/lib/* dans la sous-fenêtre de propriétés du Chemin de construction Java.
  4. Les projets d'origine peuvent contenir des références à WebSphere Application Server (WAS) version 5.x, qui n'est plus pris en charge, ce qui peut provoquer des erreurs de compilation. Modifiez l'environnement d'exécution cible de ces projets vers WebSphere Application Server version 6 ou ultérieure. Pour modifier l'environnement d'exécution cible, voir Considérations relatives à la migration WebFacing.

Exécution de l'assistant de Migration WebFacing

Utilisez l'assistant de migration WebFacing pour mettre à jour vos projets vers la version 7.5. Vous ne pouvez plus migrer les projets en reconvertissant les fichiers DDS. Pour migrer vos projets vers la version 7.5, procédez comme suit :

  1. Dans la vue Projets WebFacing cliquez avec le bouton droit de la souris sur un projet pour faire apparaître le menu contextuel.
  2. Cliquez sur Migration Projet WebFacing.
  3. Pour migrer le projet sélectionné vers la version 7.5, cliquez sur Terminer.
  4. Une fois la migration terminée, vous serez sans doute amené à faire évoluer manuellement la valeur Struts de la version 1.1 à la version 1.3. Dans la vue Navigateur, cliquez avec le bouton droit de la souris sur le projet et sélectionnez Propriétés. Ouvrez la page Valeurs de projet et modifiez, si nécessaire, la version de Struts en 1.3. Cliquez sur OK.
  5. Après la migration vers la version 7.5.0, nous vous recommandons fortement de convertir votre DDS.
Remarque : Si le projet migré est compatible HATS/WebFacing, le projet HATS correspondant doit également être migré.

Les projets personnalisés peuvent nécessiter une intervention manuelle. Pour plus de détails, voir Procédure manuelle de migration des projets avec des fichiers personnalisés et Prise en charge WebFacing de plusieurs navigateurs.

Une licence HATS est nécessaire pour que les projets WebFacing migrés soient déployés, comme pour les nouveaux projets WebFacing. Si une licence HATS est déjà appliquée, les projets migrés contiendront également ce paramètre de licence. Consultez Activation des licences pour plus d'informations.