Migration des projets Web iSeries
Vous pouvez utiliser la méthode de votre choix pour migrer les projets Web iSeries :
- Migration de projets Web iSeries avec un espace de travail WebSphere Development Studio Client version 5.1.x existant
Pour réaliser cette opération, vous devez utiliser votre espace de travail existant dans le plan de travail version 6.0.1 et exécuter la routine de migration Outils Web iSeries.
- Migration de projets Web iSeries avec un espace de travail WebSphere Development Studio Client version 5.0 existant
Pour réaliser cette opération, vous devez importer le contenu du projet depuis le système de fichiers et exécuter la routine de migration Outils Web iSeries.
- Migration de projets Web iSeries avec un espace de travail WebSphere Development Studio Client version 4.0 existant
Pour réaliser cette opération, vous devez importer le contenu du projet depuis le système de fichiers et exécuter la routine de migration Outils Web iSeries.
Important :
Avant de migrer votre environnement, vérifiez que toutes les instances de serveur ont bien été arrêtées.
Migration des projets Web iSeries version 5.1.x vers la version 6.0.1
Les sections suivantes expliquent comment migrer les projets Web iSeries depuis Development Studio Client pour iSeries version 5.1.x vers WebSphere Development Studio Client pour iSeries version 6.0.1.
Le processus de migration comprend les étapes suivantes :
- Migration des projets avec un espace de travail 5.1.x existant
- Migration du contenu des projets Web iSeries
- Résolution des erreurs et avertissements générés par la migration
Etape 1 : Migration des projets avec un espace de travail 5.1.x existant
Dans la version 6.0.1, les noms par défaut des dossiers du source Java et du contenu Web peuvent être configurés, pour les nouveaux projets Web, via une page de préférences. Par défaut, les noms sont WebContent et JavaSource. Ces noms par défaut ne seront utilisés que pour les nouveaux projets Web.
Quant aux projets Web créés avec les versions antérieures à la version 6.0.1, ils continueront à fonctionner avec les anciens noms.
- Si vous lancez la version 6.0.1 (en cliquant sur Démarrer > Programmes > IBM Rational > WebSphere Development Studio Client pour iSeries), le programme affiche la fenêtre Rational Software Developer Platform dans laquelle vous pouvez définir le répertoire à utiliser pour la session. Précisez le répertoire de l'espace de travail version 5.1 dans la fenêtre.
- Si un message vous demande de confirmer la conversion dans le format de la nouvelle interface utilisateur, cliquez sur OK.
- Facultatif : dans le menu principal, cliquez sur Fenêtre > Préférences. Dans la sous-fenêtre de gauche, développez Outils Web et sélectionnez Nouveau projet J2EE. Dans la sous-fenêtre de droite, définissez les préférences pour les noms de dossier par défaut.
Dans la version 6.0.1, vous pouvez modifier manuellement le nom des dossiers du source des projets 5.1.x. Il suffit de cliquer avec le bouton droit de la souris sur le nom du dossier dans la vue Explorateur de projets, de sélectionner l'option Propager les modifications et de cliquer sur Renommer. En fait, la fonction Renommer modifie les noms de dossier et rétablit le chemin de construction Java des projets Web 5.1.x. Si vous décidez de renommer les noms de dossier JavaSource et WebContent dans la version 6.0.1, vous devez mettre à jour manuellement les nouveaux noms de dossier dans tous les scripts de construction automatisés.
Conversion des projets Web au format Struts 1.1 (facultatif)
Si vous avez créé des projets Web Struts 1.1 Beta 2 dans IBM WebSphere Studio Application Developer version 5, vous pouvez les convertir au format Struts 1.1. Toutefois, cette mesure n'est pas obligatoire, car la version Struts 1.1 Beta 2 est toujours prise en charge.
Si vous disposez de projets Web Struts 1.1 Beta 2 que vous souhaitez convertir au format Struts 1.1 :
- Créez un nouveau projet Web Struts 1.1, sous le nom de Struts11. Vous pourrez ainsi accéder facilement aux artefacts Struts 1.1 dont nous aurons besoin pour convertir les vrais projets. Vous pourrez supprimer ce projet dès que vous aurez terminé.
- Pour chaque projet Struts 1.1 Beta 2 que vous souhaitez convertir au format Struts 1.1, procédez comme suit :
- Supprimez les fichiers .jar suivants du répertoire Web Content/WEB-INF/lib du projet : commons-*.jar et struts.jar.
- Copiez les fichiers .jar suivants du répertoire Struts11/WebContent/WEB-INF/lib dans le répertoire Web Content/WEB-INF/lib du projet : commons-*.jar et struts.jar.
- Supprimez le fichier .tld suivant du répertoire Web Content/WEB-INF du projet : struts-*.tld.
- Copiez le fichier .tld suivant du répertoire Struts11/WebContent/WEB-INF dans le répertoire Web Content/WEB-INF du projet : struts-*.tld.
Etape 2 : Migration du contenu des projets Web iSeries
Pour migrer le contenu des projets Outils Web iSeries, procédez comme suit :
- Cliquez avec le bouton droit de la souris sur le nom du projet dans la vue Navigateur de projet de la perspective Web et sélectionnez Propriétés. Sélectionnez Fonctions de projet Web dans le cadre de gauche. Dans la liste Fonctions de projet Web disponibles, sélectionnez Struts si l'option n'est pas déjà sélectionnée. Cliquez sur OK. Cliquez sur Terminer dans la fenêtre Fonctions de projet Web pour accepter la version Struts par défaut (1.1).
Remarque :
Si vous omettez cette étape, une fenêtre apparaît, vous demandant d'ajouter le support Struts.
- Important : A ce stade, vous devez fermer et rouvrir le projet pour ne pas recevoir une exception consécutive à la suppression de ressources et vérifier que le projet n'est ouvert sur aucun serveur.
- Dans la perspective Web, cliquez avec le bouton droit de la souris sur le nom du projet et sélectionnez Migration > Projet d'outils Web iSeries. Une fenêtre indique que la structure et le contenu du projet vont être migrés.
- Pour continuer, cliquez sur OK. La fenêtre Informations sur l'opération en cours indique le niveau de progression de la migration.
- Lorsque la migration est terminée, un message indique le résultat.
- Si le processus de migration aboutit, aucune action supplémentaire n'est nécessaire. En cas d'erreurs ou d'avertissements, voir Etape 3 : Résolution des erreurs et avertissements générés par la migration.
- Le processus de migration exécute les actions suivantes :
- Mise à jour des composants Web iSeries, des bibliothèques de marques et des fichiers JavaScript (et mise à jour en conséquence de tous les fichiers JSP)
- Régénération des fichiers liés à l'interaction Web, basée sur la structure Struts des fichiers .wit et mise à jour des fichiers d'exécution de l'interaction Web
- Prise en charge de la nouvelle fonction d'outils Web iSeries disponible dans la version 6.0.1
Etape 3 : Résolution des erreurs et avertissements générés par la migration
Si le processus de migration rencontre des incidents, une fenêtre indique la présence d'erreurs ou d'avertissements. Sous le nom du projet, dans la perspective Web, le programme ouvre également le journal de migration nom_projet_MigrationDetails.txt, qui consigne l'ensemble des incidents.
Au début du journal de migration, la section Migration Result indique l'état général de la migration et désigne une version en ligne de la table d'avertissements et d'erreurs suivante, comprenant leurs descriptions et les actions correctives à adopter. Pour plus d'informations, voir Messages d'erreur et d'avertissement de la migration des projets Web.
Migration des projets Web iSeries version 5.0 vers la version 6.0.1
Les sections suivantes expliquent comment migrer les projets Web iSeries depuis Development Studio Client pour iSeries version 5.0 vers WebSphere Development Studio Client pour iSeries version 6.0.1.
Le processus de migration comprend les étapes suivantes :
- Migration de projets avec un projet Web version 5.0 existant résidant sur le système de fichiers
- Migration du contenu des projets Web iSeries
- Résolution des erreurs et avertissements générés par la migration
Etape 1 : Migration vers la version 6.0.1 d'un projet 5.0 résidant sur le système de fichiers
Dans la version 6.0.1, les noms par défaut des dossiers du source Java et du contenu Web peuvent être configurés, pour les nouveaux projets Web, via une page de préférences. Par défaut, les noms sont WebContent et JavaSource. Ces noms par défaut ne seront utilisés que pour les nouveaux projets Web.
Quant aux projets Web créés avec les versions antérieures à la version 6.0.1, ils continueront à fonctionner avec les anciens noms.
Pour migrer le contenu du dossier du contenu Web :
- Si vous lancez la version 6.0.1 (en cliquant sur Démarrer > Programmes > IBM Rational > WebSphere Development Studio Client pour iSeries), le programme affiche une fenêtre de lancement dans laquelle vous pouvez définir le répertoire à utiliser pour la session. Utilisez l'emplacement par défaut comme espace de travail.
- Placez-vous dans la perspective Ressource.
- Créez un nouveau projet Web dynamique portant le même nom et utilisant la même version de servlet que le projet Web version 5.0 existant. Pour déterminer la version du servlet, recherchez la balise jsp-level dans le fichier .websettings du projet 5.0. Si le niveau JSP est 1.2, définissez la version du servlet sur 2.3. Sinon, définissez la version sur 2.2. Puis, cliquez sur Terminer. A l'invite, ne vous placez pas dans la perspective Web.
- Choisissez le dossier du contenu Web du nouveau projet créé, cliquez avec le bouton droit de la souris et sélectionnez Importer dans le menu contextuel.
- Sélectionnez Système de fichiers comme source d'importation, puis cliquez sur Suivant. Cliquez sur le bouton Parcourir, puis choisissez le dossier du contenu Web (appelé Web Content, par défaut) du projet Web version 5.0 existant. Cliquez sur OK.
- Choisissez le dossier du contenu Web sans cocher la case. Cliquez sur Sélectionner tout. Dans le panneau de droite, désélectionnez et resélectionnez un fichier. En fait, le programme importe l'intégralité du contenu du dossier du contenu Web, sans importer le dossier proprement dit.
- Dans le panneau de droite, désélectionnez les fichiers suivants s'ils apparaissent dans la liste :
- \WebContent\WEB-INF\struts-*.tld
- \WebContent\WEB-INF\lib\struts.jar
- \WebContent\WEB-INF\lib\commons-*.jar
- \WebContent\WEB-INF\lib\jdbc2_0-stdext.jar
- Sélectionnez les options Créer seulement les dossiers sélectionnés et Ecraser les ressources existantes sans avertissement, puis cliquez sur Terminer. Normalement, le dossier du contenu Web du nouveau projet créé contient les mêmes ressources et la même structure que le dossier du contenu Web 5.0.
Pour migrer le contenu du dossier du source Java :
- Choisissez le dossier du source Java du nouveau projet créé, cliquez avec le bouton droit de la souris et sélectionnez Importer dans le menu contextuel.
- Sélectionnez Système de fichiers comme source d'importation, puis cliquez sur Suivant. Cliquez sur le bouton Parcourir, puis choisissez le dossier du source
Java (appelé Java Source, par défaut) du projet Web version 5.0 existant. Cliquez sur OK.
- Choisissez le dossier du source Java sans cocher la case. Cliquez sur Sélectionner tout. Dans le panneau de droite, désélectionnez et resélectionnez un fichier. En fait, le programme importe l'intégralité du contenu du dossier du source Java, sans importer le dossier proprement dit.
- Sélectionnez les options Créer seulement les dossiers sélectionnés et Ecraser les ressources existantes sans avertissement, puis cliquez sur Terminer. Normalement, le dossier du source Java du nouveau projet créé contient les mêmes ressources et la même structure que le dossier du source Java 5.0.
Pour migrer le contenu du dossier du projet Web :
- Choisissez le nouveau projet créé, cliquez avec le bouton droit de la souris et sélectionnez Importer dans le menu contextuel.
- Sélectionnez Système de fichiers comme source d'importation, puis cliquez sur Suivant. Cliquez sur le bouton Parcourir, puis choisissez le projet Web 5.0 existant.
- Dans le panneau de gauche, choisissez le dossier du projet et cliquez sur Sélectionner tout. Dans le panneau de droite, désélectionnez et resélectionnez un fichier. Dans le panneau de gauche, désélectionnez les dossiers du contenu Web et du source Java. En fait, le programme importe l'intégralité du contenu du dossier du projet Web à l'exception des dossiers du contenu Web et du source Java et du dossier du projet Web proprement dit.
- Dans le panneau de droite, désélectionnez les fichiers suivants s'ils apparaissent dans la liste :
- \WebContent\.classpath
- \WebContent\.project
- \WebContent\.websettings
- \WebContent\.serverPreference
Ces fichiers contiennent les informations de projet requises au stade de la conception. Comme les informations ne peuvent pas être migrées vers la version 6.0.1, le programme recrée les fichiers dès que nécessaire.
- Sélectionnez les options Créer seulement les dossiers sélectionnés et Ecraser les ressources existantes sans avertissement, puis cliquez sur Terminer. Normalement, le nouveau dossier du projet Web créé contient les mêmes ressources et la même structure que le dossier du projet Web 5.0.
Suppression des artefacts de l'ancien niveau Struts
- Cliquez avec le bouton droit de la souris sur le fichier WebContent/WEB-INF/web.xml. Sélectionnez Ouvrir avec > Editeur de descripteur de déploiement.
- Cliquez sur l'onglet Servlets.
- Supprimez l'entrée de servlet, qui mappe la classe de servlet org.apache.struts.action ActionServlet (appelée action, par défaut).
Etape 2 : Migration du contenu des projets Web iSeries
Pour migrer le contenu des projets Outils Web iSeries, procédez comme suit :
- Cliquez avec le bouton droit de la souris sur le nom du projet dans la vue Navigateur de projet de la perspective Web et sélectionnez Propriétés. Sélectionnez Fonctions de projet Web dans le cadre de gauche. Dans la liste Fonctions de projet Web disponibles, sélectionnez Struts si l'option n'est pas déjà sélectionnée. Cliquez sur OK. Cliquez sur Terminer dans la fenêtre Fonctions de projet Web pour accepter la version Struts par défaut (1.1).
Remarque :
Si vous omettez cette étape, une fenêtre apparaît, vous demandant d'ajouter le support Struts.
- Important : A ce stade, vous devez fermer et rouvrir le projet pour ne pas recevoir une exception consécutive à la suppression de ressources et vérifier que le projet n'est ouvert sur aucun serveur.
- Dans la perspective Web, cliquez avec le bouton droit de la souris sur le nom du projet et sélectionnez Migration > Projet d'outils Web iSeries. Une fenêtre indique que la structure et le contenu du projet vont être migrés.
- Pour continuer, cliquez sur OK. La fenêtre Informations sur l'opération en cours indique le niveau de progression de la migration.
- Lorsque la migration est terminée, un message indique le résultat.
- Si le processus de migration aboutit, aucune action supplémentaire n'est nécessaire. En cas d'erreurs ou d'avertissements, voir Etape 3 : Résolution des erreurs et avertissements générés par la migration.
- Le processus de migration exécute les actions suivantes :
- Mise à jour des composants Web iSeries, des bibliothèques de marques et des fichiers JavaScript (et mise à jour en conséquence de tous les fichiers JSP)
- Régénération des fichiers liés à l'interaction Web, basée sur la structure Struts des fichiers .wit et mise à jour des fichiers d'exécution de l'interaction Web
- Prise en charge de la nouvelle fonction d'outils Web iSeries disponible dans la version 6.0
Etape 3 : Résolution des erreurs et avertissements générés par la migration
Si le processus de migration rencontre des incidents, une fenêtre indique la présence d'erreurs ou d'avertissements. Sous le nom du projet, dans la perspective Web, le programme ouvre également le journal de migration nom_projet_MigrationDetails.txt, qui consigne l'ensemble des incidents.
Au début du journal de migration, la section Migration Result indique l'état général de la migration et désigne une version en ligne de la table d'avertissements et d'erreurs suivante, comprenant leurs descriptions et les actions correctives à adopter. Pour plus d'informations, voir Messages d'erreur et d'avertissement de la migration des projets Web.
Pour la migration de la version 5.0.x, en plus des avertissements de migration répertoriés dans le fichier journal, vous devez tenir compte du fait que l'attribut Longueur maximum (maxLength) n'est plus pris en charge pour le composant Web Zone de saisie. Ce changement peut affecter l'aspect de vos pages Web.
Migration des projets Web iSeries version 4.0 vers la version 6.0.1
Les sections suivantes expliquent comment migrer les projets Web iSeries depuis Development Studio Client pour iSeries version 4.0 vers WebSphere Development Studio Client pour iSeries version 6.0.1.
Le processus de migration comprend les étapes suivantes :
- Migration de projets avec un projet Web version 4.0 existant résidant sur le système de fichiers
- Migration du contenu des projets Web iSeries
- Résolution des erreurs et avertissements générés par la migration
Etape 1 : Migration vers la version 6.0.1 d'un projet 4.0 résidant sur le système de fichiers
Dans la version 6.0.1, les noms par défaut des dossiers du source Java et du contenu Web peuvent être configurés, pour les nouveaux projets Web, via une page de préférences. Par défaut, les noms sont WebContent et JavaSource. Ces noms par défaut ne seront utilisés que pour les nouveaux projets Web.
Quant aux projets Web créés avec les versions antérieures à la version 6.0.1, ils continueront à fonctionner avec les anciens noms.
Pour migrer le contenu du dossier du contenu Web :
- Si vous lancez la version 6.0.1 (en cliquant sur Démarrer > Programmes > IBM Rational > WebSphere Development Studio Client pour iSeries), le programme affiche une fenêtre de lancement dans laquelle vous pouvez définir le répertoire à utiliser pour la session. Utilisez l'emplacement par défaut comme espace de travail.
- Placez-vous dans la perspective Ressource.
- Créez un nouveau projet Web dynamique portant le même nom et utilisant la même version de servlet que le projet Web version 4.0 existant. Pour déterminer la version du servlet, recherchez la balise jsp-level dans le fichier .websettings du projet 4.0. Si le niveau JSP est 1.2, définissez la version du servlet sur 2.3. Sinon, définissez la version sur 2.2. Puis, cliquez sur Terminer. A l'invite, ne vous placez pas dans la perspective Web.
- Choisissez le dossier du contenu Web du nouveau projet créé, cliquez avec le bouton droit de la souris et sélectionnez Importer dans le menu contextuel.
- Sélectionnez Système de fichiers comme source d'importation, puis cliquez sur Suivant. Cliquez sur le bouton Parcourir, puis choisissez le dossier du contenu Web (appelé webApplication, par défaut) du projet Web 4.0 existant. Cliquez sur OK.
- Choisissez le dossier du contenu Web sans cocher la case. Cliquez sur Sélectionner tout. Dans le panneau de droite, désélectionnez et resélectionnez un fichier. En fait, le programme importe l'intégralité du contenu du dossier du contenu Web, sans importer le dossier proprement dit.
- Sélectionnez les options Créer seulement les dossiers sélectionnés et Ecraser les ressources existantes sans avertissement, puis cliquez sur Terminer. Normalement, le dossier du contenu Web du nouveau projet créé contient les mêmes ressources et la même structure que le dossier du contenu Web 4.0.
Pour migrer le contenu du dossier du source Java :
- Choisissez le dossier du source Java du nouveau projet créé, cliquez avec le bouton droit de la souris et sélectionnez Importer dans le menu contextuel.
- Sélectionnez Système de fichiers comme source d'importation, puis cliquez sur Suivant. Cliquez sur le bouton Parcourir, puis choisissez le dossier du source Java (appelé source, par défaut) du projet Web 4.0 existant. Cliquez sur OK.
- Choisissez le dossier du source Java sans cocher la case. Cliquez sur Sélectionner tout. Dans le panneau de droite, désélectionnez et resélectionnez un fichier. En fait, le programme importe l'intégralité du contenu du dossier du source Java, sans importer le dossier proprement dit.
- Sélectionnez les options Créer seulement les dossiers sélectionnés et Ecraser les ressources existantes sans avertissement, puis cliquez sur Terminer. Normalement, le dossier du source Java du nouveau projet créé contient les mêmes ressources et la même structure que le dossier du source Java 4.0.
Pour migrer le contenu du dossier du projet Web :
- Choisissez le nouveau projet créé, cliquez avec le bouton droit de la souris et sélectionnez Importer dans le menu contextuel.
- Sélectionnez Système de fichiers comme source d'importation, puis cliquez sur Suivant. Cliquez sur le bouton Parcourir, puis choisissez le projet Web 4.0 existant.
- Dans le panneau de gauche, choisissez le dossier du projet et cliquez sur Sélectionner tout. Dans le panneau de droite, désélectionnez et resélectionnez un fichier. Dans le panneau de gauche, désélectionnez les dossiers du contenu Web et du source Java. En fait, le programme importe l'intégralité du contenu du dossier du projet Web à l'exception des dossiers du contenu Web et du source Java et du dossier du projet Web proprement dit.
- Dans le panneau de droite, désélectionnez les fichiers suivants s'ils apparaissent dans la liste :
- \WebContent\.classpath
- \WebContent\.project
- \WebContent\.websettings
- \WebContent\.serverPreference
Ces fichiers contiennent les informations de projet requises au stade de la conception. Comme les informations ne peuvent pas être migrées vers la version 6.0.1, le programme recrée les fichiers dès que nécessaire.
- Sélectionnez les options Créer seulement les dossiers sélectionnés et Ecraser les ressources existantes sans avertissement, puis cliquez sur Terminer. Normalement, le nouveau dossier du projet Web créé contient les mêmes ressources et la même structure que le dossier du projet Web 4.0.
Etape 2 : Migration du contenu des projets Web iSeries
Pour migrer le contenu des projets Outils Web iSeries, procédez comme suit :
- Cliquez avec le bouton droit de la souris sur le nom du projet dans la vue Navigateur de projet de la perspective Web et sélectionnez Propriétés. Sélectionnez Fonctions de projet Web dans le cadre de gauche. Dans la liste Fonctions de projet Web disponibles, sélectionnez Struts si l'option n'est pas déjà sélectionnée. Cliquez sur OK. Cliquez sur Terminer dans la fenêtre Fonctions de projet Web pour accepter la version Struts par défaut (1.1).
Remarque :
Si vous omettez cette étape, une fenêtre apparaît, vous demandant d'ajouter le support Struts.
- Important : A ce stade, vous devez fermer et rouvrir le projet pour ne pas recevoir une exception consécutive à la suppression de ressources et vérifier que le projet n'est ouvert sur aucun serveur.
- Dans la perspective Web, cliquez avec le bouton droit de la souris sur le nom du projet et sélectionnez Migration > Projet d'outils Web iSeries. Une fenêtre indique que la structure et le contenu du projet vont être migrés.
- Pour continuer, cliquez sur OK. La fenêtre Informations sur l'opération en cours indique le niveau de progression de la migration.
- Lorsque la migration est terminée, un message indique le résultat.
- Si le processus de migration aboutit, aucune action supplémentaire n'est nécessaire. En cas d'erreurs ou d'avertissements, voir Etape 3 : Résolution des erreurs et avertissements générés par la migration.
- Le processus de migration exécute les actions suivantes :
- Mise à jour des composants Web iSeries, des bibliothèques de marques et des fichiers JavaScript (et mise à jour en conséquence de tous les fichiers JSP)
- Régénération des fichiers liés à l'interaction Web, basée sur la structure Struts des fichiers .wit et mise à jour des fichiers d'exécution de l'interaction Web
- Prise en charge de la nouvelle fonction d'outils Web iSeries disponible dans la version 6.0
Etape 3 : Résolution des erreurs et avertissements générés par la migration
Si le processus de migration rencontre des incidents, une fenêtre indique la présence d'erreurs ou d'avertissements. Sous le nom du projet, dans la perspective Web, le programme ouvre également le journal de migration nom_projet_MigrationDetails.txt, qui consigne l'ensemble des incidents.
Au début du journal de migration, la section Migration Result indique l'état général de la migration et désigne une version en ligne de la table d'avertissements et d'erreurs suivante, comprenant leurs descriptions et les actions correctives à adopter. Pour plus d'informations, voir Messages d'erreur et d'avertissement de la migration des projets Web.
Autres remarques sur la migration
Outre les erreurs de migration consignées dans le fichier journal décrit ci-dessus, vous devez également résoudre les points suivants, dans la mesure du possible :
- Vérifiez que vous avez restauré une nouvelle version du programme de service de sous-fichier QDTSSFL sur votre hôte iSeries. Ce programme de service est requis pour la manipulation de l'espace utilisateur de sous-fichier avec les API de sous-fichier. Pour savoir comment restaurer le programme de service, consultez la rubrique d'aide "Programme de service de sous-fichier QDTSSFL". Cliquez sur Aide > Table des matières de l'aide, sur Référence > Référence interface utilisateur > Applications Web iSeries > Composants Web iSeries > API de sous-fichier.
- Le tableau de format de données renvoyé par un programme hôte pour un composant Web Zone de liste peut à présent se présenter sous deux formats. Par conséquent, vous devrez peut-être modifier votre programme pour obtenir le format de données désiré dans la zone de liste. Pour plus d'informations sur les formats de données, voir "Onglet Données" dans l'aide en ligne sous Référence > Référence interface utilisateur > Applications Web iSeries > Composants Web iSeries > Composant Web Zone de liste.
En plus des avertissements de migration répertoriés dans le fichier journal décrit à
l'étape 4 ci-dessus, vous devez prendre en compte les changements suivants,
susceptibles de modifier l'aspect de vos pages Web :
- Les propriétés DTC de table suivantes ne sont plus prises en charge dans le composant Web Tableau équivalent:
- Remplissage des cellules
- Espacement des cellules
- Taille de bordure
- Alignement
- Largeur du tableau
- Hauteur du tableau
- Les propriétés Premier plan de la cellule et Arrière-plan de la cellule d'une commande DTC de table ne s'appliquent pas aux couleurs de colonne d'un composant Web Tableau. Les colonnes sont toutes de la couleur définie pour la première colonne du tableau.
- Les propriétés Largeur visible, Verrouillage majuscules et Lecture seule associées à une colonne Zone d'Entrée d'une DTC de table ne sont pas prises en charge dans la colonne Entrée équivalente d'un composant Web Tableau.
- Les boutons Page précédente, Page suivante et Colonne de sélection de la
DTC de sous-fichier ne sont pas pris en charge dans le composant Web Tableau équivalent.
- Les valeurs 'Nom de zone' spécifiées dans les DTC sont migrées en tant que valeurs 'Nom' des composants Web équivalents. Dans la valeur 'Nom', tous les points (caractère .) sont remplacés par des traits de soulignement (caractère _ ). De plus, le premier caractère de
'Nom de zone' d'une DTC peut être converti en minuscule dans la valeur 'Nom' du composant Web équivalent.
- Vous ne pouvez plus modifier un attribut de composant Web lors de l'exécution, lorsqu'une condition spécifiée se produit. Si vous avez utilisé l'onglet Attributs d'exécution
DTC pour définir une condition qui, une fois remplie, modifie un attribut DTC en cours
d'exécution (par exemple, modifie la taille de la police), l'attribut de composant Web
correspondant n'est plus modifié lorsque cette condition se produit.
Messages d'erreur et d'avertissement de la migration des projets Web
Code d'erreur |
Description |
Action |
E100 |
Une erreur indéterminée s'est produite pendant la migration
du fichier JSP. |
Corrigez ou adressez toutes les autres erreurs ou avertissements du fichier journal de migration et réexécutez l'outil de migration. |
E101 |
Un composant Web iSeries du fichier JSP contient une erreur. |
Corrigez l'erreur de composant Web iSeries. |
E200 |
Le traitement du fichier .wit a entraîné une erreur indéterminée. |
Cliquez deux fois sur le fichier .wit contenant l'erreur pour appeler l'assistant d'interaction Web. Exécutez l'assistant en entier et effectuez les modifications nécessaires. Cliquez sur Terminer. |
E201 |
Un ou plusieurs noms de composants Web définis dans les pages utilisées dans cette interaction sont incorrects. |
Cliquez deux fois sur le fichier .wit contenant l'erreur pour appeler l'assistant d'interaction Web. Un message vous indique que les noms de composant Web sont incorrects et vous demande si vous souhaitez les modifier. Cliquez sur Oui. Apportez les modifications nécessaires. Dans le cas des composants Web dont les paramètres d'entrée ou de sortie ont été modifiés, complétez les zones Nom dans la session, Sauvegarder dans la session et Options de liaison. Exécutez l'assistant en entier et effectuez les modifications nécessaires. Cliquez sur Terminer. |
E202 |
La valeur "Indicateur de message" est définie sur "true" dans cette interaction. La messagerie avancée a considérablement changé dans cette édition. Vous devez redéfinir les options de messagerie. |
Cliquez deux fois sur le fichier .wit contenant l'erreur pour appeler l'assistant d'interaction Web. Sur la page "Mappage et liaison des paramètres de sortie aux champs de sortie", définissez la valeur Contrôleur de messages sur "true". Le bouton apparaît ; cliquez dessus pour définir les spécifications de contrôle des messages. |
E300 |
Une erreur indéterminée s'est produite pendant le traitement de la DTC et/ou du composant Web iSeries généré. |
Corrigez ou adressez toutes les autres erreurs ou avertissements du fichier journal de migration. Renommez le fichier journal de migration et réexécutez l'outil de migration. |
E301–E302 |
La propriété de commande de conception des boutons Suivant/Précédent n'est plus prise en charge. L'attribut Type de bouton du composant Web Bouton sera défini comme du type Soumettre. |
Utilisez l'assistant d'interaction Web pour créer une interaction
afin d'indiquer la page qui contenait le bouton Suivant/Précédent comme page JSP d'entrée et la page cible du bouton Suivant comme page JSP de sortie. Dans la version 4.0, le bouton Suivant/Précédent a été utilisé avec plusieurs pages d'entrée. Cliquez sur Aide > Table des matières de l'aide pour ouvrir l'aide, cliquez sur Référence > Référence interface utilisateur > Applications Web iSeries > Pages d'entrée et de sortie multiples. |
E400 |
Une erreur indéterminée s'est produite pendant la migration du fichier modèle de génération de code. |
Vérifiez que les modèles de génération de code ne sont pas en lecture seule. Adressez les autres erreurs/avertissements du journal de migration et relancez l'outil de migration. |
E401 |
Le fichier modèle de génération de code a été personnalisé.
Utilisez la dernière version du modèle. |
Vérifiez que les personnalisations que vous avez apportées à l'ancienne version du modèle ont été appliquées à la dernière version du modèle.
Par exemple, le contenu personnalisé du fichier <répertoire_espace_travail>\metadata\ plugins\com.ibm.etools.iseries. webtools\iseriesPgmCallAction.
template.bak doit être correctement inséré dans le fichier <répertoire_espace_travail>\metadata\ plugins\com.ibm.etools.iseries. webtools\iseriesPgmCallAction.
template. |
Code d'avertissement |
Description |
Action |
W100 |
Un composant Web iSeries de la page JSP contient un avertissement. |
Tenez compte de l'avertissement du composant Web iSeries. |
W300 |
La propriété Délimiteur de boîte à liste ou zone de liste contenait plus d'un caractère. Le premier caractère trouvé dans la propriété Délimiteur est utilisé pour l'attribut du délimiteur du composant Web iSeries correspondant. |
Vérifiez que les attributs Nom et Valeur de toutes les options du composant Web Zone de liste ou Zone de sélection sont définis correctement. |
W301–W302 |
L'attribut [entrée] ou [valeur] de la propriété Données d'une boîte à liste ou zone de liste contient le caractère *. |
Vérifiez que les attributs Nom et Valeur de toutes les options du composant Web Zone de liste ou Zone de sélection sont définis correctement. |
W303 |
Tous les contrôles de conception d'un bouton d'option figurant dans un fichier JSP partageant la même propriété Nom de groupe apparaissent désormais comme des options d'un composant Web Groupe de boutons d'option. Les propriétés définies dans les onglets Police et Couleur du premier bouton d'option trouvé sur la page JSP sont utilisées comme attributs Couleur et Police pour le groupe de boutons d'option. En d'autres termes, les propriétés des onglets Couleur et Police sont perdues pour les boutons d'option suivants du même groupe. |
Vérifiez que le groupe de boutons d'option apparaît comme attendu dans la page JSP en sélectionnant le fichier JSP associé et en l'exécutant sur le serveur. Vérifiez également que les attributs Police et Couleur apparaissent comme attendus en exécutant la même procédure. |
W304 |
La propriété Libellé du bouton de fonction n'est plus prise en charge.
La propriété Valeur du bouton de fonction a été mappée sur l'attribut Libellé du composant Web Bouton correspondant. Le texte apparaissant sur le composant Web Bouton est différent de celui de la commande de conception du bouton de fonction. |
Modifiez la valeur de l'attribut Libellé si le texte affiché sur le bouton n'est pas approprié. |
W305 |
La commande de conception de sous-fichier ou de table apparaît désormais hors de la balise HTML FORM. Un composant Web Tableau ne peut pas apparaître dans une balise HTML FORM. Si la commande de conception était de type Sous-fichier, le composant Web iSeries correspondant est un tableau. |
Vérifiez que le composant Web Tableau apparaît comme attendu sur la page JSP. |
W306–W320 |
Une propriété d'événement de la commande de conception n'est plus prise en charge.
- W306 - OnDblClick
- W307 - OnMouseDown
- W308 - OnMouseOut
- W309 - OnMouseOver
- W310 - OnSelect
- W312 - OnChange (boutons d'option)
- W313 - OnChange (cases à cocher)
- W314 - OnMouseUp
- W315 - OnKeyDown (boutons d'option)
- W316 - OnKeyPress (boutons d'option)
- W317 - OnKeyUp (boutons d'option)
- W318 - OnKeyDown (boutons de fonction)
- W319 - OnKeyPress (boutons de fonction)
- W320 - OnKeyUp (boutons de fonction)
|
Si nécessaire, définissez l'action associée à un événement différent. |
W321 |
Le composant Web comportait un attribut défini qui n'est plus pris en charge car 1) l'attribut CSS associé n'est pas pris en charge par la plupart des navigateurs 2) l'attribut HTML associé est déjà déconseillé sous
HTML 4.0 et n'est pas pris en charge par la plupart des navigateurs. |
Aucune. |
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.