Outils Portal - Notes sur l'édition


1.0 Restrictions
   1.1 Les portlets JSR 168 doivent contenir un attribut ID
   1.2 Les fonctions d'édition des portlets WSRP sont désactivées
   1.3 Enregistrements relationnels et Portal V5.1
   1.4 Des messages d'avertissement signalant des liens rompus sont affichés dans la vue Incidents
   1.5 Support de marquage dans Portal Designer
2.0 Incidents connus
   2.1 Lors de l'exécution d'un projet de portlet dans l'environnement de test, un projet précédent est exécuté à la place du projet en cours
   2.2 La modification du thème par défaut dans un projet de portail 5.1 n'est pas prise en compte sur le serveur ou dans l'environnement de test
   2.3 (Personnalisation des portails) Impossible d'ouvrir les fichiers license.html et privacy.html dans un projet de portail importé ou créé dans l'environnement de test (PQ93681)
   2.4 Des légendes de menu incorrectes s'affichent dans les portlets Click-to-Action
   2.5 (Descripteur de déploiement de portlet) Edition à l'aide de l'éditeur de déploiement de portlet JSR 168
   3.12 (Migration de portlets) La migration de portlets Portal 4.2 vers 5.0 échoue
   2.7 (Importation/création d'un portail) Les erreurs liées à WSRP s'affichent dans la vue Incidents d'un projet de portail importé ou créé dans l'environnement de test (PQ95638)
   2.8 Le portlet Struts JSR168 créé avec le mode de configuration n'active pas ce mode pour le portlet lors de l'exécution

1.0 Restrictions

1.1 Les portlets JSR 168 doivent contenir un attribut ID

Lorsque vous créez des portlets d'API JSR 168 à l'aide de l'assistant Nouveau Portlet, Rational Software Development Platform affecte automatiquement un attribut ID. Cet attribut doit être inclus dans l'élément <portlet-app/> du fichier portlet.xml pour identifier de manière unique le portlet sur le serveur. (Cet attribut correspond à l'attribut UID utilisé par les portlets de l'API des portlets IBM.)

Si certains de vos portlets d'API JSR 168 ne disposent pas d'attribut ID dans l'élément <portlet-app/> du fichier portlet.xml, ajoutez l'attribut ID et sa valeur unique immédiatement après avoir importé le portlet dans l'espace de travail des outils Rational. Pour ajouter l'attribut ID, ouvrez le descripteur de déploiement de portlet et éditez-le à l'aide de la vue Source. Ne modifiez pas la valeur de l'ID après avoir déployé votre portlet d'API JSR 168 sur un serveur de portail ou après avoir utilisé votre projet de portlet JSR 168 dans un projet de portail.

Il existe des limitations pour un portlet d'API JSR 168 sans attribut ID :

1.2 Les fonctions d'édition des portlets WSRP sont désactivées

Portal Designer ne prenant pas en charge les portlets WSRP, les fonctions d'éditions connexes, telles que la copie et le déplacement, sont désactivées. Toutefois, les portlets WSRP peuvent toujours être importés à partir de WebSphere Portal et déployés sur ce dernier.

1.3 Enregistrements relationnels et Portal V5.1

Lors de l'exécution d'un portlet contenant une liste d'enregistrements relationnels ou un enregistrement relationnel (SDO), l'erreur suivante peut être consignée dans le journal du serveur :

[date et heure] 4942fbd0 SystemOut O java.lang.LinkageError: Class org/eclipse/emf/ecore/EClass violates loader constraints: definition mismatch between parent and child loaders

Vous pouvez ignorer cette erreur.

1.4 Des messages d'avertissement signalant des liens rompus sont affichés dans la vue Incidents

Lors de la création d'un projet de portail à l'aide de l'assistant Nouveau projet de portail ou lors de l'importation d'un exemple de projet de portail de la galerie d'exemples, des messages d'avertissement signalant des liens rompus apparaissent dans la vue Incidents.

1.5 Support de marquage dans Portal Designer

Portal Designer n'affiche que HTML, cHTML, et WML comme marquages pris en charge. Si vous avez spécifié d'autres marquages pris en charge pour la page ou le libellé d'un projet que vous importez, ces marquages sont gérés. Toutefois, vous ne pouvez pas les modifier et ils n'apparaissent pas dans la vue Propriétés.

2.0 Incidents connus

Lors de l'exécution d'un projet de portlet dans l'environnement de test, un projet précédent est exécuté à la place du projet en cours.

Lorsqu'ils sont exécutés dans l'environnement de test de Websphere Portal, les projets de portail sont prioritaires par rapport aux projets de portlet. Si vous exécutez un projet de portail dans l'environnement de test, une association est établie entre le projet de portail et la configuration du serveur. Avant d'exécuter des projets de portlet à l'aide de la même configuration du serveur, vous devez supprimer cette association.

Pour corriger cette erreur d'association, procédez comme suit :

  1. Dans la vue Serveurs, sélectionnez Ajouter et supprimer des projets à partir du menu contextuel du serveur.
  2. Supprimez le projet wps, les projets EAR de portail et les projets EAR de portlet associés aux projets de portail (si ces derniers sont associés à la configuration du serveur).

2.2 2.2 La modification du thème par défaut dans un projet de portail 5.1 n'est pas prise en compte sur le serveur ou l'environnement de test

Dans WebSphere Portal 5.1, lorsqu'un portail a été précédemment affiché dans un navigateur Web et que ce produit est ensuite utilisé pour modifier le thème de portail par défaut, vous devez redémarrer le serveur afin d'appliquer intégralement le nouveau thème par défaut.

Dans l'environnement de test de WebSphere Portal, vous ne pouvez pas modifier le thème par défaut en republiant la configuration du portail. Vous devez redémarrer l'environnement de test.

Dans WebSphere Portal 5.1, cet incident peut être résolu en appliquant le correctif PK00826. Ce correctif sera intégré aux futures versions de WebSphere Portal.

2.3 2.3 (Personnalisation des portails) Impossible d'ouvrir les fichiers license.html et privacy.html dans un projet de portail importé ou créé dans l'environnement de test (PQ93681)

Incident : En raison d'un codage incorrect, il est impossible d'ouvrir les fichiers license.html ou privacy.html dans un projet de portail importé ou un projet de portail créé dans l'environnement de test à l'aide de Page Designer.

Solution : Appliquez le correctif APAR PQ93681 auserveur Portal, puis réimportez le projet à partir de ce serveur ou recréez le projet à partir de l'environnement de test.

Remarque : Cette erreur a été corrigée pour WebSphere Portal 5.1 et WebSphere Portal 5.0.2.3 mais pas pour WebSphere Portal 5.0.2.2.

2.4 Des légendes de menu incorrectes s'affichent dans les portlets Click-to-Action

Lorsque vous exécutez ou déployez des projets de portlet configurés pour prendre en charge Click-to-Action, les légendes des menus ne s'affichent pas dans les menus Click-to-Action. Des noms d'action s'affichent à leur place. Si les légendes de menu doivent s'afficher correctement, vous pouvez utiliser ce produit pour exporter le projet de portlet en tant que fichier WAR et l'installer sur WebSphere Portal à l'aide du portlet de gestion des modules Web.


Cette erreur se produit uniquement dans WebSphere Portal 5.1.0.0 et peut être corrigée en passant à la version 5.1.0.1 de WebSphere Portal.

2.5 2.5 (Descripteur de déploiement de portlet) Edition à l'aide de l'éditeur de déploiement de portlet JSR 168

Incident : Dans le descripteur de déploiement de portlet JSR 168, vous ne pouvez pas éditer un nom de portlet dans la zone Collections de portlets.

Solution : Editez le nom de portlet dans la page Source.

2.6 2.6 (Migration de portlets) La migration de portlets Portal 4.2 vers 5.0 échoue

Incident : La modification du niveau de l'API des portlets échoue si le chemin d'accès aux classes est long.

Solution: Vous devez corriger le chemin de génération Java des projets de portlet migrés. Pour connaître le chemin de génération requis, vous pouvez vous reporter à un projet de portlet de base généré par l'assistant Nouveau projet de portlet. Ajoutez les fichiers JAR requis manquants au chemin de génération Java de votre projet de portlet migré.

2.7 (Importation/création d'un portail) Les erreurs liées à WSRP s'affichent dans la vue Incidents d'un projet de portail importé ou d'un projet créé dans l'environnement de test (PQ95638)

Incident : Lors de l'importation du site d'un site de portail existant de WebSphere Portal ou lors de la création d'un projet de portail dans l'environnement de test, des erreurs de validation liées à WSRP s'affichent dans la vue Incidents du projet de portail importé ou créé.

Solution : Appliquez le correctif APAR PQ95638 dans WebSphere Portal avant l'importation d'un site de portail ou la création d'un projet de portail.

Remarque : Cette erreur a été corrigée pour WebSphere Portal 5.1 et WebSphere Portal 5.0.2.3 mais pas pour WebSphere Portal 5.0.2.2.

2.8 2.8 Le portlet Struts JSR168 créé avec le mode de configuration n'active pas ce mode pour le portlet lors de l'exécution.

Lorsque vous créez un portlet Struts JSR168 avec le mode de configuration sélectionné et que vous exécutez ce portlet sur un serveur de portail ou dans un environnement de test, l'interface du portlet n'affiche pas l'option de sélection du mode de configuration, représentée par une clé à molette dans l'interface du portlet.

Cette erreur est due à une définition incorrecte du mode de configuration du portlet. Pour corriger cette erreur, procédez comme suit :
  1. Ouvrez le fichier portlet.xml dans le répertoire \WebContent\WEB-INF\ du projet de portlet.
  2. Recherchez le portlet Struts. Il doit correspondre au portlet associé à la classe de portlet = com.ibm.portal.struts.portlet.StrutsPortlet
  3. Mettez à jour la section support dans le portlet Struts   en remplaçant : <supports>
    <supports>
    <mime-type>text/html</mime-type>
    <portlet-mode>view</portlet-mode>
    <portlet-mode>edit</portlet-mode>
    <portlet-mode>help</portlet-mode>
    <portlet-mode>configure</portlet-mode>
    </supports>
    par :
    <supports>
    <mime-type>text/html</mime-type>
    <portlet-mode>view</portlet-mode>
    <portlet-mode>edit</portlet-mode>
    <portlet-mode>help</portlet-mode>
    <portlet-mode>config</portlet-mode>
    </supports>
    Notez que le mode du portlet est "config" au lieu de "configure".
  4. En outre, le mode du portlet personnalisé doit être mis à jour en remplaçant :
    <custom-portlet-mode>
    <portlet-mode>configure</portlet-mode>
    </custom-portlet-mode> par :
    <custom-portlet-mode>
    <portlet-mode>config</portlet-mode>
    </custom-portlet-mode>

Retour au fichier Readme principal