Les outils associés à la technologie JavaServer Faces, tels que les composants Faces de la vue Palette, sont considérés comme des fonctions de niveau bêta. La documentation de ces fonctionnalités est également prise en charge au niveau bêta.
Etant donné que les fonctions JavaServer Faces sont à l'état bêta, il est conseillé de ne pas les utiliser pour les applications de production. IBM ne garantit pas la migration et la compatibilité avec des versions ultérieures, ni le support des fichiers JavaServer Page qui utilisent ces fonctions JavaServer Faces.
Lorsque l'utilisateur crée un modèle de page (en fonction d'une page Faces) qui contient plusieurs zones de contenu, il doit s'assurer qu'une balise de formulaire Faces entoure les zones de contenu. Il existe deux façons de procéder. La première façon, qui est la plus directe, consiste à faire glisser et à déposer un bouton de commande à partir de la palette sur chaque zone de contenu de la page et de les supprimer une fois tous les boutons déposés. Cette opération entraîne une nouvelle parenté de la balise de formulaire jusqu'à ce qu'elle encapsule toutes les zones de contenu. La deuxième façon consiste à faire apparaître le composant de formulaire dans le tiroir de la palette des composants Faces et à le faire glisser puis à le déposer sur le modèle, et à faire glisser puis à déposer les zones de contenu sur le composant de formulaire.
Les utilisateurs remarqueront peut-être des problèmes lors du glissement et du dépôt du composant de téléchargement en amont à partir de la palette sur une page générée à partir d'un modèle de page contenant déjà la balise de formulaire Faces. L'action de dépôt doit pouvoir modifier les attributs du formulaire pour aboutir. Deux solutions sont possibles :
a) Modifiez la balise de formulaire dans le modèle de page de sorte qu'elle comporte un attribut enctype. Attribuez la valeur"multipart/form-data" à l'attribut. Exemple : <h:form formName="form1" id="form1" enctype="multipart/form-data"></h:form>
b) Placez la balise de formulaire dans une zone du modèle qui peut être éditée. Vous pouvez, par exemple, déposer une zone de contenu sur la page puis faire apparaître l'élément de formulaire dans la palette et le déposer dans la zone de contenu.
Actuellement, les fonctions couper, copier et coller de Page Designer permettent uniquement de générer une copie exacte d'une balise JSP et de l'insérer à l'emplacement du curseur. Ce n'est pas toujours utile si vous utilisez des composants Faces, car souvent, la nouvelle balise sera collée dans un contrôle existant même si l'emplacement n'est pas valide. Certaines contraintes relatives aux imbrications de balises et aux ID uniques ne sont pas encore traitées correctement par les fonctions couper et coller (Ctrl-x/Ctrl-c/Ctrl-v ou les actions de menu). Pour éviter des erreurs lors de la manipulation de contrôles dans le panneau de conception, utilisez plutôt la souris pour sélectionner et faire glisser un contrôle afin de le déplacer. Vous pouvez également maintenir la touche Ctrl enfoncée lors du glissement pour copier un contrôle Faces et générer une nouvelle balise associée à un ID unique à l'emplacement du dépôt.
Lorsque vous faites glisser des composants Faces à partir de la palette sur une page JSP standard dans un projet Web, il se peut qu'un message vous demande d'ajouter de nouvelles ressources de projet. Ne répondez pas "Oui", mais annulez le dépôt et ajoutez manuellement la caractéristique de projet pour les composants Faces (disponible dans la configuration des propriétés du projet). Une fois la caractéristique de projet ajoutée, essayez de déposer le composant de la palette à nouveau.
Lorsque la vue Edition rapide est ouverte et qu'un composant Faces est sélectionné dans Page Designer, et que vous utilisez la vue Attributs pour renommer l'ID d'un composant, toutes les références à cet ID ne seront pas mises à jour dans le fichier source Java correspondant. Les occurrences de cet ID figurant dans le fichier source Java seront renommées partout sauf dans la méthode en cours d'édition dans la vue Edition rapide. Pour éviter ce problème, fermez la vue Edition rapide avant de renommer un composant Faces dans la vue Attributs. Vous pouvez également renommer manuellement l'ID du composant référencé dans cette méthode.
Lors de l'ajout de ressources Faces à un projet Web sous Linux (en les sélectionnant dans l'assistant de projet ou en créant le premier composant JSP Faces dans ce projet), un message d'erreur NullPointerException peut apparaître dans la fenêtre utilisée pour démarrer le produit. Cette erreur n'a pas de conséquence est peut être ignorée.
Si vous utilisez des modèles de page, il se peut que certaines balises Faces ne soient pas placées correctement après leur dépôt ou leur déplacement. Pour que la page fonctionne au moment de l'exécution, la balise "use_faces" doit entourer les autres balises Faces de la page. Si tel n'est pas le cas, coupez et collez la balise "use_faces" de sorte qu'elle entoure toutes les autres balises Faces.
Retour au fichier readme principal
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.