1.0 Introduction
2.0 Modifications par rapport à la version précédente
3.0 Restrictions
3.1 Cas où un modèle de page n'est pas appliqué à une page Web
4.0 Problèmes connus
4.1 Le valideur JSP n'effectue pas de compilation automatique pour des modifications Java dépendantes
4.2 Conseils pour de meilleures performances : Fermeture de projets inactifs
4.3 Conseils pour de meilleures performances : Désactivation de la compilation automatique
4.4 Activation et désactivation de Page Designer Classic
4.5 Restrictions sur les ID système contenant des caractères sur 2 octets
4.6 Restriction concernant la personnalisation des menus de la barre d'outils de Page Designer
4.7 Avertissement signalant un lien rompu sur des applets
4.8 Insertion d'applets dans les fichiers HTML et JSP à l'aide de Page Designer
4.9 La prévisualisation d'un fichier HTML comprenant Shockwave peut entraîner l'arrêt brutal de WebSphere Studio
4.10 Problème d'affichage de certains caractères GB18030 sous Windows 2000/XP
4.11 Remarques concernant les langues bidirectionnelles dans WebArt Designer, Animated GIF Designer et PageDesigner classic
4.12 Questions relatives au transtypage pour le code créé à l'aide de l'assistant Pages Web de base de données
4.13 Les JSP doivent utiliser des instructions d'importation explicites
4.14 Prise en charge des langues bidirectionnelles pour Page Designer Classic
4.15 Migration des données relationnelles dans des projets Web de la version 4.0.3
4.16 Un fragment de code supplémentaire est nécessaire pour les pages JSP et les servlets
Java conçus dans un environnement DBCS pour un niveau J2EE 1.3 sur le
serveur WebSphere 5
4.17 Déplacement d'éléments dans la vue Edition rapide à l'aide de la souris
4.18 Utilisation des éléments de la vue Fragments avec des actions simples dans la vue Edition rapide
4.19 Prise en charge des langages des dispositifs mobiles pour Page Designer
4.20 Prise en charge du modèle de page dans Page Designer
4.21 Remarques relatives à l'utilisation d'éléments de site avec Web Site Designer
4.22 Modification des paramètres système pour les couleurs et les polices
4.23 Annotations de recherche concernant des fichiers non sauvegardés dans des éditeurs
4.24 Restrictions ClearCase lors de l'utilisation de Web Site Designer ou de modèles de page
4.25 Problème de soumission de formulaire Java dans les pages JSP générées dans l'assistant Pages Web de base de données
Dans WebSphere Studio, l'environnement de développement Web apporte les outils nécessaires au développement des applications Web. Les applications Web comportent des pages Web statiques, des fichiers JSP (JavaServer Pages), des servlets Java, un descripteur de déploiement XML (web.xml) et d'autres ressources Web. Ce fichier Readme décrit les problèmes et restrictions connus, ainsi que les solutions associées aux outils utilisés dans l'environnement de développement Web.
Vous pouvez désormais renommer les dossiers Web Content et Java Source. Les noms par défaut correspondent à WebContent et JavaSource ; toutefois, vous pouvez les redéfinir en utilisant la page Préférences Outils Web ->Nouveau projet. Les dossiers des projets existants peuvent être renommés à l'aide du navigateur.
REMARQUE : Seuls les noms de dossiers par défaut sont compatibles avec WebSphere Studio Version 5.0.0. Ne modifiez pas les noms par défaut si vous devez maintenir la compatibilité de l'espace de travail avec la version 5.0.0.Deux nouvelles vues ont été ajoutées à la perspective Web afin de faciliter l'édition de pages HTML/JSP. La vue Palette contient un ensemble d'éléments qui peuvent être déplacés dans une page Web dans Page Designer. La vue Edition rapide permet aux utilisateurs d'ajouter et de modifier des scripts et de créer des balises dans des scripts d'événements au sein de Page Designer. Pour plus d'informations, reportez-vous à l'aide.
Dans certaines situations, un modèle de page n'est pas appliqué à une page Web lorsque vous utilisez l'un des assistants de modèle de page :
- Le modèle de page n'est pas appliqué à une page Web possédant un codage différent de celui du modèle sélectionné.
- Le modèle de page n'est pas appliqué lorsque le modèle de page sélectionné ou la page Web sont décrits par une page JSP de style XML.
- Le modèle de page n'est pas appliqué à une page Web déjà associée à un modèle de page.
Le valideur JSP ne revalide pas automatiquement un fichier JSP lorsqu'une classe Java JSP à laquelle il fait référence est modifiée. Pour relancer le valideur JSP sur le fichier, sélectionnez le valideur JSP dans le navigateur de projets, puis cliquez sur Exécuter la validation à partir du menu contextuel.
Pour améliorer les performances, il est conseillé de fermer les projets que vous n'utilisez pas de manière active. Seuls les projets ouverts sont régénérés lorsqu'une action Régénérer tout est effectuée.
Par défaut, les valideurs sont lancés automatiquement lorsque vous sauvegardez des ressources dans un projet Web. Pour éviter cela, ouvrez la boîte de dialogue Propriétés du projet Web dans le menu contextuel de la vue Navigateur J2EE. Activez ensuite l'option Ecraser les préférences de validation et désactivez l'option Exécuter la validation automatiquement lors de la sauvegarde des modifications d'une ressource dans la page Validation. Vous pouvez également désactiver la validation automatique (et les générations) pour tous les projets en sélectionnant Fenêtre > Préférences puis en désactivant Génération automatique sur la modification des ressources dans la page Plan de travail. Si vous désactivez les générations automatiques, vous pouvez lancer manuellement une génération (et des validations) en sélectionnant Projet > Régénérer le projet.
La version WebSphere Studio V4 de Page Designer (désormais connue sous le nom Page Designer Classic) a fait l'objet de modifications pour la version 5. Le nouveau Page Designer (appelé Page Designer dans l'interface graphique et la documentation du produit) est la version recommandée. Il s'agit également de la version par défaut. Page Designer Classic n'est pas disponible comme fonctionnalité installable, mais peut être activé en suivant les instructions ci-après.
La convivialité et les fonctionnalités de Page Designer ont été améliorées (édition des attributs basée sur les vues, support simplifié des bibliothèques de balises).
Certaines fonctionnalités de Page Designer Classic ont été abandonnées :
- Support bidirectionnel (BiDi)
- Eléments dynamiques (y compris les tables dynamiques)
- Fonction de vérification de l'accessibilité
Utilisez la version par défaut de Page Designer, sauf si vous avez besoin du support spécifique des fonctionnalités inclus dans Page Designer Classic. Pour activer Page Designer Classic, procédez comme suit :
Installation de Page Designer Classic :
- Quittez WebSphere Studio avant de commencer l'installation.
- Dans Windows Explorer, accédez au répertoire WSAD INSTALL DIR/bin, puis cliquez deux fois sur pdclassic.exe.
- Lorsque vous redémarrez WebSphere Studio, la boîte de dialogue Mises à jour est affichée. Cliquez sur le bouton Oui.
Remarque : Si c'est la première fois que vous utilisez le plan de travail, cette étape et celles qui suivent n'existent pas.- Dans la boîte de dialogue Modifications de la configuration, cochez la case de la zone Modifications détectées. Cliquez sur le bouton d'option Fin.
- Dans la boîte de dialogue Installation/Mise à jour, cliquez sur le bouton d'option Oui. Le plan de travail est redémarré pour que les modifications soient appliquées.
Mappage de Page Designer Classic comme éditeur Web par défaut :
Par défaut, une fois que Page Designer Classic a été installé, les associations de fichier entre cet éditeur et plusieurs types de fichier HTML et JSP (y compris *.htm, *.html, *.jsp, *.jhtml, *.shtml, *.shtm et *.html-ss) sont mappées afin que vous puissiez utiliser l'option de menu contextuel Ouvrir avec > Page Designer Classic de la vue Navigateur J2EE pour ouvrir un fichier sélectionné dans Page Designer Classic. Toutefois, si vous voulez utiliser Page Designer Classic comme éditeur par défaut pour les types de fichier HTML et JSP, procédez comme suit :
- Sélectionnez Fenêtre > Préférences.
- Développez les paramètres Plan de travail et ouvrez la page Associations de fichier.
- Sélectionnez les types de fichier applicables (un par un) dans la zone déroulante Types de fichier.
- Sélectionnez Page Designer Classic dans la boîte de dialogue Sélection d'un éditeur et cliquez sur le bouton d'option Par défaut.
- Répétez les étapes 3 et 4 pour chaque type de fichier applicable.
Remarque : Si par la suite vous désactivez Page Designer Classic, puis que vous le réactivez, les associations de fichier sont également réintégrées. Toutefois, l'éditeur par défaut du type de fichier mappé reviendra au nouveau Page Designer.
Vous pouvez éventuellement modifier les préférences d'édition de Page Designer Classic. Sélectionnez Fenêtre > Préférences, puis développez les paramètres Outils Web. Développez Page Design (Classic) pour effectuer les mises à jour de votre choix.
Désactivation de Page Designer Classic
Pour désactiver cette fonctionnalité (y compris l'aide) et utiliser à nouveau la version Page Designer par défaut, procédez comme suit :
- Sélectionnez Aide > Mises à jour logicielles > Gestionnaire de mises à jour.
- Dans la vue Installation de la configuration, développez Configuration actuelle pour localiser Page Designer Classic 5.1.0, puis sélectionnez-le.
- Cliquez sur le bouton d'option Désactiver en bas à droite de la sous-fenêtre Prévisualisation.
- Dans la boîte de dialogue Installation d'une fonctionnalité, cliquez sur le bouton d'option Fin.
- Dans la boîte de dialogue Installation/Mise à jour, cliquez sur le bouton d'option Oui. Le plan de travail est redémarré pour que les modifications soient appliquées.
Activation de Page Designer Classic (après qu'il ait été désactivé)
Pour réactiver Page Designer Classic, n'exécutez pas pdclassic.exe à nouveau. Procédez comme suit :
- Sélectionnez Aide > Mises à jour logicielles > Gestionnaire de mises à jour.
- Dans la vue Configuration de l'installation, cliquez sur le bouton de la barre d'outils appelé Afficher les dispositifs désactivés.
- Développez Configuration actuelle afin de situer Page Designer Classic 5.1.0 et sélectionnez-le.
- Cliquez sur le bouton d'option Activer dans le coin inférieur droit de la sous-fenêtre Aperçu.
- Dans la boîte de dialogue Installation d'une fonctionnalité, cliquez sur le bouton d'option Fin.
- Dans la boîte de dialogue Installation/Mise à jour, cliquez sur le bouton d'option Oui. Le plan de travail est redémarré pour que les modifications soient appliquées.
Si votre ID contient des caractères sur 2 octets, vous ne devez pas utiliser le répertoire par défaut de l'espace de travail comme emplacement de projet Web
Une fois la barre d'outils personnalisée à l'aide de la boîte de dialogue Personnalisation de la perspective (Fenêtre > Personnaliser la perspective), le menu Barre d'outils de Page Designer ne peut plus être utilisé pour des personnalisations ultérieures de la barre d'outils. Vous devrez utiliser la boîte de dialogue Personnalisation de la perspective pour sélectionner les éléments de la barre d'outils à afficher.
LinksBuilder peut signaler à tort que la valeur d'attribut de code d'une applet n'est pas un lien valide si un nom de classe Java complet est utilisé :
<applet code="aaa.bbb.AnApplet" codebase="MyApplets">Cet avertissement peut être ignoré et n'affecte pas le comportement de l'applet lorsqu'elle est exécutée sur le serveur.Cet avertissement peut être évité en utilisant un séparateur de chemin ('/') au lieu du séparateur ('.') et en vérifiant que l'extension .class est indiquée de manière explicite. Par exemple :
<applet code="aaa/bbb/AnApplet.class" codebase="MyApplets">
Le dossier source Java d'un projet Web est réservé aux classes côté serveur ; le code source des applets ne peut donc pas y être placé. Par conséquent, il est recommandé de procéder de la manière suivante lors du développement des applets :
- Créez un projet Java pour les applets, puis créez les classes d'applet dans ce projet.
- Copiez les fichiers des classes d'applet dans le dossier Contenu Web (par défaut, WebContent) d'un projet Web. Ne les copiez pas dans le dossier WEB-INF, car ce dossier n'est réservé qu'aux classes côté serveur. (Pour afficher les fichiers de classes, vous devez modifier les filtres de la vue Navigateur de projets en sélectionnant Filtres dans la liste déroulante des boutons de menu de la vue).
- Insérez une applet dans une page Web en sélectionnant Insérer > Autres > Applet Java dans Page Designer. Vous devez ensuite définir les attributs appropriés pour le code et la base du code.
Par exemple, si la classe de votre applet est aaa.bbb.AnApplet et que la structure des fichiers est la suivante :
WebContent/index.htmlle code est "aaa.bbb.AnApplet"
WebContent/MyApplets/aaa/bbb/AnApplet.classla balise d'applet de index.html doit contenir :
codebase is "MyApplets"
Il n'existe pas de solution connue pour résoudre cet incident.
GB18030 est une norme de jeu de caractères de la République de Chine, qui spécifie une page de codes étendue et une table de mappage à Unicode. WebArt Designer et Animated GIF Designer ne peuvent pas afficher correctement les caractères GB18030 de la gamme 0xA840 - 0xA9A0 si l'environnement local du système est en Chinois simplifié et si le module de support GB18030 de Microsoft est installé.
Dans WebArt Designer, ce problème survient dans les zones de texte de la vue WebArt Gallery, celles de la boîte de dialogue Logo Wizard (Specify Text 1/4), de la boîte de dialogue Edit Bookmarks et des options du menu Bookmark.
Dans Animated GIF Designer, le problème se présente dans la zone de commentaires de la boîte de dialogue Frame Properties (Comment Frame), de la vue Frame Thumbnail et dans les zones de texte de la boîte de dialogue Create Animated Banner.
Par exemple, si vous entrez le caractère GB18030 '0xA877' (en Unicode, U+2573 Box Drawings Light Diagonal Cross), il s'affiche comme GB18030 '0xA876' (en Unicode, U+2572 Box Drawings Light Diagonal Upper Left To Lower Right).
Parfois, WebArt Designer et Page Designer Classic ne parviennent pas à créer l'image du logo d'une langue bidirectionnelle sous Windows XP. Si vous spécifiez un espacement de caractères lorsque vous créez une image de logo dont les caractères se lisent de la droite vers la gauche, les caractères contenus dans le logo ne sont pas réorganisés. Vous devez spécifier la valeur zéro comme espacement de caractères pour obtenir une image de logo correcte des caractères bidirectionnels sous Windows XP.
Les mêmes restrictions s'appliquent à la bannière animée d'Animated Gif Designer.
Dans l'assistant Pages Web de base de données, lorsque le modèle Beans d'accès aux données IBM - Modèle maître de détail est utilisé, certaines base de données connaissent des difficultés à sélectionner les chaînes en interne, en fonction du type de données approprié. Par exemple, Oracle 8.17i ne convertira pas des chaînes en nombres.
Pour corriger cela dans le fichier $Prefix$ViewBean.java généré pour chaque demande DataAccess, vous devez modifier la méthode prepareStatement().
Soit le code suivant :
//Ajout de descriptions de paramètre aux métadonnées.
DBParameterMetaData metaData = getDBSelect().getParameterMetaData();
metaData.setParameter(1, PARAM1_NAME, DatabaseMetaData.procedureColumnIn,
java.sql.Types.DECIMAL,
java.lang.String.class);
// Définition des paramètres.
getDBSelect().setParameter(PARAM1_NAME, inSAL);
Vous devez le remplacer par :
//Ajout de descriptions de paramètre aux métadonnées.
Vous devez indiquer aux métadonnées des paramètres le type d'objet Java attendu par votre base de données. Vous devez ensuite utiliser la méthode setParmeterFromString au lieu de la méthode setParameter sur l'instance DBSelect. Cela indique à l'objet DBSelect d'effectuer la conversion du type à la place de votre base de données.
DBParameterMetaData metaData = getDBSelect().getParameterMetaData();
metaData.setParameter(1, PARAM1_NAME, DatabaseMetaData.procedureColumnIn,
java.sql.Types.DECIMAL,
java.math.BigDecimal.class);
// Définition des paramètres.
getDBSelect().setParameterFromString(PARAM1_NAME, inSAL);
Les fichiers JSP doivent utiliser l'attribut 'import' de la directive des pages pour décrire les types disponibles pour l'environnement des scripts de cette page. Certains types peuvent avoir été importés de manière implicite dans les fichiers JSP contenus dans les projets J2EE1.2, mais généreront des erreurs s'ils sont utilisés dans un projet J2EE1.3. Pour éviter cela, les types doivent toujours être importés de manière explicite dans la page JSP (sauf si le type est inclus dans la liste d'importation par défaut : java.lang.*, javax.servlet.*, javax.servlet.jsp.* et javax.servlet.http.*).
Vous pouvez activer la prise en charge des langues bidirectionnelles pour Page Designer Classic en associant la variable locale système par défaut ou la variable locale par défaut de l'utilisateur à la valeur Arabe ou Hébreu sous Windows.
Pour migrer les données relationnelles de projets WebSphere Studio 4.0.3, procédez comme suit :
- A partir de l'espace de travail de la version 4.0.3, générez les fichiers DDL de chaque base de données disponible.
- Supprimez la base de données du dossier source/databases dans le projet Web (via la vue Définition de données).
- Ouvrez l'espace de travail 4.0.3 avec WebSphere Studio version 5.
- Migrez les projets Web pour lesquels vous souhaitez restaurer les données relationnelles.
- Cliquez sur Fichier > Importer > Système de fichiers et indiquez le(s) fichier(s) DDL de l'espace de travail 4.0.3.
- Dans la vue Définition de données de la perspective Données, sélectionnez Exécuter sur le serveur local et indiquez le projet Web cible.
Les artefacts de données relationnelles sont restaurés.
Cette entrée concerne les pages JSP et les servlets Java conçus dans un environnement DBCS pour un niveau J2EE 1.3 sur le serveur WebSphere 5. Le fragment de code suivant doit être inclus dans la source avant d'accéder à tout paramètre ou attribut de demande :
if(request.getCharacterEncoding() == null){
request.setCharacterEncoding(<encoding>); // il s'agit généralement du codage de la page JSP ou du servlet
}
//...code jsp/servlet normal qui accède aux objets de demande du type
// <%=request.getParameter("message")%>
Si le code précédent n'est pas inclus et que la demande ne comporte pas d'informations de codage, tous les paramètres de demande seront analysés en ISO-8859-1. Par conséquent, tous les paramètres d'entrée incluant des caractères DBCS s'afficheront incorrectement.
Avant de déplacer des éléments ou du texte de la vue Fragments ou Palette vers la vue Edition rapide, vérifiez que l'instruction "Insérez un fragment de code ou d'action n'apparaît pas dans la vue Edition rapide.
A chaque élément de la vue Fragments JavaScript correspond une action simple disponible dans la vue Edition rapide. Si vous utilisez la vue Edition rapide, il est déconseillé d'associer des actions simples à des éléments de la vue Fragments dans le même script d'événements. Si vous devez associer ces éléments, vérifiez avec précaution la position de l'élément Fragment. Si vous déplacez à l'aide de la souris des éléments de la vue Fragments vers la vue Edition rapide lorsque l'éditeur contient des actions simples, l'élément Fragment risque d'être inséré au mauvais endroit. Dans ce cas, supprimez, puis réinsérez l'action simple.
Les attributs qui ne sont pas pris en charge dans les langages des dispositifs mobiles (tels que cHTML ou WML) peuvent être insérés à partir de la boîte de dialogue Insertion ou de la vue Attributs.
Toutefois, vous pouvez vérifier la validité du code en utilisant les options Outils > Valider la syntaxe HTML pour un document cHTML ou les options Outils > Valider la syntaxe WML pour un document WML.
Les modèles de page sont pris en charge uniquement par Page Designer, pas par Page Designer Classic. Vous pouvez utiliser Page Designer pour modifier une page HTML/JSP à l'aide de la fonction Modèle de page.
- Certaines parties d'un site ne peuvent pas être insérées dans des pages comportant certains types de document. Lorsque vous cliquez sur OK dans la boîte de dialogue Insertion, un message d'erreur s'affiche pour indiquer que vous ne pouvez pas utiliser cette partie du site. Cela signifie que le programme générera du code source incorrect si le fichier de spécification de la partie du site sélectionné est utilisé dans le type de document de la page cible. Par exemple, si le type de document d'une page correspond à cHTML ou WML, pratiquement toutes les parties du site contiennent des balises qui ne sont pas autorisées dans ces langages de marquage.
- La barre de navigation risque de contenir du code source non autorisé en raison du fichier de spécification associé. Si la vue Tâches contient de nombreux messages d'erreur et avertissements, il est probable que le fichier de spécification de la barre de navigation en soit la cause. Modifiez le fichier de spécification pour corriger ces erreurs.
- La barre de navigation d'une page peut comporter des caractères incohérents. Cette erreur se produit si un libellé de navigation contient des caractères qui ne peuvent pas être codés conformément à la règle de codage indiquée dans la page. Pour éviter cela, limitez le type de caractères utilisé dans les libellés de navigation au codage utilisé dans la page ou utilisez une règle de codage plus expressive dans la page.
- Tous les exemples de fichiers de spécification répertoriés dans la boîte de dialogue Insertion du plan du site peuvent prendre en charge des pages comprises entre le niveau 1 et le niveau 5 de la structure du site. Même si vous définissez un niveau final supérieur à 5 dans la vue des attributs pour la balise siteedit:sitemap, les liens créés pour accéder aux pages de ce niveau ne seront pas inclus dans la carte du site.
Lorsque vous redéfinissez les paramètres système gérant les couleurs et les polices, vous devez relancer WebSphere Studio pour appliquer ces nouveaux paramètres à la page Conception de Page Designer et à la vue Palette.
Dans l'éditeur de source et la page Source des éditeurs multi-pages (éditeur XML, par exemple), la fonction de recherche est utilisable à partir d'une ressource sauvegardée sur le système de fichiers plutôt qu'à partir du contenu de l'éditeur. Les annotations de recherche contenues dans un éditeur dont les données n'ont pas été sauvegardées risquent de ne pas être fiables. Pour éviter ce problème, sauvegardez le fichier avant de lancer une recherche.
Si vous utilisez Web Site Designer pour travailler sur un projet Web, vous devez tout d'abord vous assurer que les fichiers de projet, tels que les fichiers html ou jsp et fichiers associés, sont réservés hors du référentiel ClearCase.
De plus, si vous utilisez des modèles de page dans votre projet Web, vous devez tout d'abord réserver les fichiers appropriés hors de ClearCase.
Dans certains fichiers JSP générés par l'assistant Pages Web de base de données, particulièrement dans le fichier nommé '***MasterView.jsp'
les liens 'Précédent', 'Régénérer' ainsi que d'autres liens peuvent ne pas fonctionner dans tous les navigateurs. Des problèmes ont été détectés dans certains navigateurs, par exemple dans Mozilla & Konqueror.
Pour résoudre le problème pour la plupart des navigateurs, changez le code Javascript pour la fonction nommée 'submitForm' dans la page JSP.
Changez la variable 'document.<formName>.elements.action' de la méthode en 'document.<formName>.action'.
Par exemple function submitForm(nav){ if(nav == 'SCHEMA_TABLEInputForm'){ document.myForm.elements.action = "/Web3/SCHEMA_TABLEInputForm.html"; } else if(nav == 'SCHEMA_TABLEMasterView'){ document.myForm.elements.action = "/Web3/SCHEMA_TABLEMasterView"; } else{ document.myForm.elements.action = "/Web3/SCHEMA_TABLEDetailsView"; }
devient
function submitForm(nav){ if(nav == 'SCHEMA_TABLEInputForm'){ document.myForm.action = "/Web3/SCHEMA_TABLEInputForm.html"; } else if(nav == 'SCHEMA_TABLEMasterView'){ document.myForm.action = "/Web3/SCHEMA_TABLEMasterView"; } else{ document.myForm.action = "/Web3/SCHEMA_TABLEDetailsView"; }
Retour au fichier Readme principal
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.