Outils JavaServer Faces (bêta) - Notes sur l'édition


1.0 Spécifications et logiciels pris en charge
2.0 Restrictions
   2.1 La fonction glisser-déposer des composants Faces ne fonctionne pas correctement dans les modèles de page composés de plusieurs zones de contenu
   2.2 Le composant de téléchargement en amont des fichiers ne peut pas être déposé sur une page générée à partir d'un modèle de page contenant un formulaire
   2.3 Copie et collage des composants Faces dans Page Designer
   2.4 Remarque liée à l'ajout des ressources de projet Faces
   2.5 Problème de synchronisation de l'identificateur du composant JSF avec le fichier source Java lorsque la vue Edition rapide est ouverte
3.0 Problèmes connus
   3.1 Erreurs lors de l'utilisation de contrôles JSF dans des modèles de page

1.0 Spécifications et logiciels pris en charge

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.

2.0 Restrictions

2.1 La fonction glisser-déposer des composants Faces ne fonctionne pas correctement dans les modèles de page composés de plusieurs zones de contenu

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.

2.2 Le composant de téléchargement en amont des fichiers ne peut pas être déposé sur une page générée à partir d'un modèle de page contenant un 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.

2.3 Copie et collage des composants Faces dans Page Designer

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.

2.4 Remarque liée à l'ajout des ressources de projet Faces

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.

2.5 Problème de synchronisation de l'identificateur du composant JSF avec le fichier source Java lorsque la vue Edition rapide est ouverte

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.

3.0 Problèmes connus

3.1 Erreurs lors de l'utilisation de contrôles JSF dans des modèles de page

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