Outils Portal - Notes d'informations


1.0 Spécifications et logiciels pris en charge
2.0 Restrictions
   2.1 Les portlets JSR 168 doivent contenir un attribut ID
   2.2 Enregistrements relationnels et Portal V5.1
   2.3 Limitation des portlets coopératifs Cooperative
   2.4 Limitation de la balise person
   2.5 Limitations des outils EIS
   2.6 Configuration de SAP JCo sur un serveur WebSphere Portal
   2.7 Des messages d'avertissement de liens rompus sont affichés dans la vue Incidents
   2.8 Support de marquage dans Portal Designer
   2.9 Une URL interne ne peut pas être définie
   2.10 Ne sélectionnez pas les thèmes Admin comme thèmes par défaut
3.0 Incidents connus
   3.1 (Installation) Echec de l'installation de l'environnement de test de WebSphere Portal
   3.2 (Création de portlets) Erreurs de compilation dans la dernière version de WebSphere Portal
   3.3 (Création de portlets) Une icône de portlet inattendue est affichée lorsque vous activez la balise Click-to-Action
   3.4 (Création de portlets) Erreur de référence de servlet incorrecte lors de la création d'un portlet dans un projet de type portlet API IBM
   3.5 (Débogage et test des portlets) Impossible de démarrer l'environnement de test de WebSphere Portal
   3.6 (Débogage et test de portlets) Impossible d'installer des portlets dans l'environnement de test à l'aide du portlet d'administration
   3.7 (Débogage et test des portlets) Une erreur se produit si une application de portlet utilise une base de données autre que Cloudscape
   3.8 (Descripteur de déploiement de portlet) Edition à l'aide de l'éditeur de déploiement de portlet JSR 168
   3.9 (Exécution et débogage) Le navigateur interne n'affiche pas le projet de type portlet ou le portail mis à jour
   3.10 Si <f:subview> est utilisé au lieu de <f:view>, les portlets Faces ne fonctionnent pas correctement.
   3.11 La balise Click-to-Action ne fonctionne pas dans un portlet Faces maximisé.
   3.12 (Migration de portlets) Echec de la migration vers V5.0 de portlets Portal V4.2
   3.13 (Importation, exportation & Déploiement) Impossible de créer un serveur d'importation, d'exportation et de & déploiement ayant pour cible "localhost"
   3.14 (Importation de portail) L'annulation de l'opération d'importation provoque l'indisponibilité du nouveau projet de portail
   3.15 (Importation d'un portail) Des erreurs liées à WSRP sont affichées dans la vue Incidents d'un projet de portail importé
   3.16 (Personnalisation des portails) Impossible d'ouvrir dans un projet de portail importé les fichiers license.html et privacy.html
   3.17 (Exécution et débogage d'un projet de portail) Impossible de démarrer l'environnement de test de WebSphere Portal 5.0 avec un projet de portail
   3.18 Le forum de Rational Software Architect

1.0 Spécifications et logiciels pris en charge

Les projets Portal prennent en charge WebSphere Portal version 5.0.2.2.

2.0 Restrictions

2.1 Les portlets JSR 168 doivent contenir un attribut ID

Lorsque vous créez des portlets JSR 168 à l'aide de l'assistant Nouveau portlet, Rational Developer affecte automatiquement un attribut ID. L'attribut ID doit être inclus dans l'élément <portlet-app/> du fichier portlet.xml pour identifier 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 JSR 168 ne possèdent pas d'attribut ID sur 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. 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 JSR 168 sur un serveur de portail ou après avoir utilisé votre projet de type portlet JSR 168 dans un projet de portail.

Il existe des limitations sur un portlet JSR 168 sans attribut ID :

2.2 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 de votre serveur :

[04/10/07 17:57:27:172 JST] 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.

2.3 Limitation des portlets coopératifs Cooperative

Lorsque vous créez un portlet source coopératif, vous devez ajouter manuellement les attributs actionNameParameter et name dans le fichier WSDL. Par exemple :

<portlet:action type="standard" name="myActionName" actionNameParameter="ACTION_NAME"/>

Dans cette édition, l'outil de portail ne génère pas d'attribut de légende dans le fichier WSDL. Lorsque vous utilisez la communication avec WebSphere Portal, version 5.1, vous devez spécifier manuellement l'attribut de légende dans le fichier WSDL et la valeur de la légende dans le fichier de ressource. Par exemple :

<portlet:param name="orderId" partname="order_id" caption="order.id" />
Pour plus d'informations, dans le centre de documentation de WebSphere Portal, reportez-vous à la rubrique sur le développement de portlets pour la coopération.

2.4 Limitation de la balise person

Lorsque vous utilisez la balise person dans un portlet de base IBM sur WebSphere Portal version 5.1, vous devez la spécifier à l'aide de la syntaxe suivante :

<pa:person value="CN=John Smith,OU=SALES,O=ACME" valueType="LDAPDN" displayName="John Smith" />

Lorsque vous utilisez la balise person dans un portlet IBM Faces sur WebSphere Portal version 5.1, vous devez la spécifier à l'aide de la syntaxe suivante :

<pa:person value="CN=John Smith,OU=SALES,O=ACME" />John Smith<pa:person>

La balise person n'est pas prise en charge par les portlets JSR 168.

2.5 Limitations des outils EIS

Limitation des assistants SAP BAPI et RFM SDO : Si vous passez la page de la fonction principale et des fonctions à effectuer avant et après la fonction principale et que vous essayez d'y retourner après avoir sélectionné une autre fonction principale, la page des mappages à effectuer avant et après la fonction principale ne fonctionne pas correctement.

Solution : Pour définir de nouveaux mappages de fonctions à effectuer avant et après la fonction principale, vous devez redémarrer l'assistant.

2.6 Configuration de SAP JCo sur un serveur WebSphere Portal

Pour tester les portlets contenant SAP SDO sur un serveur Portal, vous devez configurer l'adaptateur SAP JCo sur le serveur WebSphere Portal 5.1 :

  1. Téléchargez le répertoire de l'adaptateur JCo de SAP à partir du site SAP Service Marketplace.
  2. Cliquez sur Download Software > Download > SAP Connectors > SAP Java Connector. Sélectionnez le fichier à télécharger en fonction de votre système d'exploitation. Extrayez le contenu du fichier ZIP dans un répertoire local.
  3. Effectuez la procédure ci-après en fonction de votre système d'exploitation. Remarque : <wps_51> fait référence au répertoire d'installation du serveur WebSphere Portal 5.1 (par exemple, C:\WebSphere\PortalServer51TE).
      Pour Windows :
    1. Copiez sapjco.jar et sapjcorfc.dll dans <wps_51>\shared\app.
    2. Copiez librfc32.dll dans c:\windows\system32\.
    3. Vous devez redémarrer le serveur WebSphere Portal 5.1.

      Pour Linux :
    1. Copiez sapjco.jar et libsapjcorfc.so dans <wps_51>\shared\app.
    2. Ajoutez le dossier qui contient le fichier librfccm.so à la variable d'environnement LD_LIBRARY_PATH.
    3. Vous devez redémarrer le serveur WebSphere Portal 5.1.

2.7 Des messages d'avertissement de 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 de l'importation d'un exemple de projet de portail de la galerie des exemples, des messages d'avertissement de liens rompus apparaissent dans la vue Incidents.

2.8 Support de marquage dans Portal Designer

Dans cette version de Rational Developer, 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 une page ou un libellé d'un projet que vous importez, ils sont gérés dans Rational Developer ; toutefois, vous ne pouvez pas les modifier et ils ne sont pas affichés dans la vue Propriétés.

2.9 Une URL interne ne peut pas être définie

Dans cette version de Rational Developer, vous ne pouvez définir des URL externes que dans Portal Designer. Si le serveur de portail contient des URL internes, elles sont conservées dans un projet importé, mais vous ne pouvez pas les modifier. Vous ne pouvez déployer ces URL internes que sur le serveur de portail d'origine.

2.10 Ne sélectionnez pas les thèmes Admin comme thèmes par défaut

Dans cette version de Portal Designer, les thèmes Admin et AdminLeftNavigation sont affichés dans la vue Structure. Toutefois, ces thèmes ne sont destinés qu'à l'administration de Portal et ne doivent pas être sélectionnés comme thèmes par défaut d'un projet de portail.

3.0 Incidents connus

3.1 (Installation) Echec de l'installation de l'environnement de test de WebSphere Portal

Incident : L'installation de Rational Developer ne parvient pas à installer l'environnement de test de WebSphere Portal.

Solution : Vérifiez le journal de l'installation et prenez les mesures adéquates pour résoudre l'incident.

Environnement de test de WebSphere Portal 5.0 rép_install_RD\runtimes\portal_v50\log\wpsinstalllog.txt, rép_install_RD correspondant au répertoire d'installation de Rational Developer.

Environnement de test de WebSphere Portal 5.1 rép_install_51TE\PortalServer\log\wpsinstalllog.txt, rép_install_51TE correspondant au répertoire d'installation de l'environnement de test de WebSphere Portal 5.1.

Si l'incident ne peut pas être identifié à partir des fichiers journaux, essayez de désinstaller manuellement l'environnement de test de WebSphere Portal. Ensuite, réinstallez-le. Pour plus d'informations sur la procédure manuelle de désinstallation, reportez-vous au guide d'installation de Rational Developer.

3.2 (Création de portlets) Erreurs de compilation dans la dernière version de WebSphere Portal

Incident : Vous pouvez créer des portlets pour WebSphere Portal version 5.0 à l'aide de Rational Developer. Si vous appliquez un service WebSphere Portal à votre serveur de portail, vous risquez de recevoir des erreurs de compilation lors de la création des portlets. Dans ce cas, vous devez mettre à jour manuellement les fichiers requis par la compilation.

Solution : Pour compiler correctement les portlets, procédez comme suit :

WebSphere Portal v5.0.2.x

Remarque : Vous devez restaurer l'état initial de ces fichiers pour pouvoir désinstaller l'environnement de test de WebSphere Portal. Si vous ne le faites pas, le dossier "portal_v50_stub" risque de ne pas être supprimé et vous devrez le supprimer manuellement.

WebSphere Portal v5.1

Remarque : Vous devez restaurer l'état initial de ces fichiers pour pouvoir désinstaller l'environnement de test de WebSphere Portal. Si vous ne le faites pas, le dossier "portal_v51_stub" risque de ne pas être supprimé et vous devrez le supprimer manuellement.

3.3 (Création de portlets) Une icône de portlet inattendue est affichée lorsque vous activez la balise Click-to-Action

L'éditeur du descripteur de déploiement de portlet et la vue Explorateur de projets affichent les icônes de portlet et leur nom. Ces icônes indiquent l'état des portlets. Les états des portlets sont "normal", "activé pour la source", "activé pour la cible" et "activé pour la source et la cible".

Incident : Lorsque vous convertissez un portlet en un portlet source Click-to-Action, seule l'icône du portlet converti doit être modifiée. Toutefois, dans certains cas, plusieurs icônes de portlet sont modifiées (par exemple, lorsque plusieurs portlets sont associés à un même servlet). Dans ces cas, les icônes des portlets autres que l'icône de portlet Click-to-Action concerné ne sont pas affichées correctement. Il en est de même lorsque vous convertissez un portlet en portlet cible Click-to-Action.

Solution : Plusieurs icônes de portlet sont modifiées alors qu'un seul portlet est modifié. La conversion aboutit et le projet de type portlet n'est pas altéré.

3.4 (Création de portlets) Erreur de référence de servlet incorrecte lors de la création d'un portlet dans un projet de type portlet API IBM

Incident : Lorsque vous créez un portlet dans un projet de type portlet API, les messages d'erreur suivants s'affichent si vous sélectionnez l'option Ajout d'un modèle de portlet émetteur Click-to-Action ou Ajout d'un modèle de portlet émetteur de messages dans la page Traitement des événements :

Solution : Vous devez rouvrir le projet de type portlet en procédant comme suit :

  1. Cliquez avec le bouton droit de la souris sur le projet de type portlet et sélectionnez Fermer le projet dans le menu déroulant.
  2. Cliquez avec le bouton droit de la souris sur le projet de type portlet et sélectionnez Ouvrir le projet dans le menu déroulant.
  3. Cliquez avec le bouton droit sur le projet de type portlet et sélectionnez Exécuter la validation dans le menu déroulant.

3.5 (Débogage et test des portlets) Impossible de démarrer l'environnement de test de WebSphere Portal

Incident : L'environnement de test de WebSphere Portal ne parvient pas à démarrer.

Solution :

3.6 (Débogage et test de portlets) Impossible d'installer des portlets dans l'environnement de test à l'aide du portlet d'administration

Incident : Sur le serveur de l'environnement de test de WebSphere Portal, l'installation de portlets à l'aide du portlet d'administration échoue.

Solution : Sur le serveur de l'environnement de test de WebSphere Portal, l'installation de portlets à l'aide du portlet d'administration n'est pas prise en charge. Pour déployer des portlets dans l'environnement de test de WebSphere Portal, vous devez utiliser la fonction "Publier" de Rational Developer. Pour utiliser la fonction "Publier", cliquez sur le projet d'application de portlet à l'aide du bouton droit de la souris et sélectionnez Exécuter > Exécuter sur le serveur ou cliquez sur le serveur à l'aide du bouton droit de la souris dans la vue Serveurs et sélectionnez Publier.

3.7 (Débogage et test des portlets) Une erreur se produit si une application de portlet utilise une base de données autre que Cloudscape

Incident : Une erreur risque de se produire si votre application de portlet utilise une base de données autre que Cloudscape.

Solution : Vous devez ajouter le pilote JDBC au chemin d'accès aux classes spécifique à WebSphere de l'environnement de test de WebSphere Portal. Procédez comme suit :

  1. Dans la vue Serveurs, cliquez deux fois sur le serveur de l'environnement de test de WebSphere Portal. L'éditeur du serveur s'ouvre.
  2. Dans la partie inférieure de l'éditeur, cliquez sur l'onglet Environnement.
  3. Dans la section ws.ext.dirs, ajoutez le pilote JDBC. Par exemple, ajoutez le fichier SQLLIB\java12\db2java.zip pour DB2®, où SQLLIB représente le répertoire d'installation de DB2.
  4. Appuyez sur Ctrl+S pour sauvegarder vos modifications.

3.8 (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.

3.9 (Exécution et débogage) Le navigateur interne n'affiche pas le projet de type portlet ou le portail mis à jour

Incident : Dans certaines configurations utilisant WebSphere Portal version 5.0, les modifications apportées à un portail ou un projet de type portlet ne sont pas affichées automatiquement dans le navigateur lors de l'exécution ou du débogage du projet à l'aide d'un serveur Server Attach éloigné.

Solutions : Il existe deux moyens de remédier à cela :

  1. Déconnectez-vous de WebSphere Portal à l'aide du navigateur, puis reconnectez-vous. Après la connexion, les modifications sont affichées. Notez que la solution consistant à fermer la fenêtre du navigateur ne fonctionne pas et qu'elle doit être effectuée à chaque publication d'un projet de portail mis à jour.
  2. Vous pouvez également configurer Rational Developer de sorte qu'il utilise un navigateur externe. Pour cela, sélectionnez Préférences dans le menu Fenêtre. Développez le noeud Internet à gauche et sélectionnez Navigateur Web. Dans la section principale, sélectionnez n'importe quel navigateur excepté un navigateur Web interne.
    Ensuite, avant chaque exécution ou débogage sur le serveur, vous devez fermer le navigateur externe avant d'effectuer l'opération.

3.10 Si <f:subview> est utilisé au lieu de <f:view>, les portlets Faces ne fonctionnent pas correctement.

Incident : Si vous supprimez la balise <f:view> d'un fichier JSP Faces généré par l'assistant et insérez des composants Faces dans ce fichier, une balise <f:subview> est insérée à la place de la balise <f:view>. Avec ce type de fichier JSP, le portlet Faces ne fonctionne pas correctement. Les entrées du navigateur sont perdues lors du traitement côté serveur.

Solution : Pour résoudre cet incident, remplacez la balise <f:subview> par la balise <f:view> dans le fichier JSP.

3.11 La balise Click-to-Action ne fonctionne pas dans un portlet Faces maximisé.

Si vous maximisez un portlet Faces qui contient des balises Click-to-Action, le contenu du portlet n'est pas affiché.

3.12 (Migration de portlets) Echec de la migration vers V5.0 de portlets Portal V4.2

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 compilation Java des projets de portlet migrés. Pour connaître le chemin de compilation requis, vous pouvez vous reporter à un projet de type portlet de base généré par l'assistant Nouveau projet de type portlet. Ajoutez les fichiers JAR requis manquants au chemin de compilation Java de votre projet de type portlet migré.

3.13 (Importation, exportation & et déploiement) Impossible de créer un serveur d'importation, d'exportation & et de déploiement ayant pour cible "localhost"

Incident : Si Portal UTE n'est pas installé, vous ne pouvez pas créer de serveur Portal d'importation &, d'exportation et de déploiement dont la cible est "localhost" ou "127.0.0.1".

Solution : Si vous avez besoin de ce type de serveur, utilisez le nom complet de la machine au lieu de "localhost" (exemple : monhôte.mondomaine).

3.14 (Importation de portail) L'annulation de l'opération d'importation provoque l'indisponibilité du nouveau projet de portail

Incident : Si vous annulez l'importation d'un nouveau projet de portail avant qu'elle soit terminée, le projet de portail incomplet n'est pas supprimé et n'est pas disponible.

Solution : Vous devez réimporter les fichiers et la configuration du portail à l'aide de l'option Supprimer le projet par écrasement de l'assistant d'importation de portail.

3.15 (Importation d'un portail) Des erreurs liées à WSRP sont affichées dans la vue Incidents d'un projet de portail importé

Incident : Lors de l'importation du site d'un portail existant de WebSphere Portal dans Rational Developer, des erreurs de validation liées à WSRP sont affichées dans la vue Incidents du projet de portail importé.

Solution : Appliquez le correctif APAR PQ95638 dans WebSphere Portal avant l'importation du site dans Rational Developer.

3.16 (Personnalisation des portails) Impossible d'ouvrir dans un projet de portail importé les fichiers license.html et privacy.html

Incident : Impossible d'ouvrir les fichiers license.html ou privacy.html dans un projet de portail importé à l'aide de Page Designer en raison d'un codage incorrect.

Solution : Appliquez le correctif APAR PQ93681 sur votre serveur Portal, puis réimportez le projet à partir de ce serveur.

3.17 (Exécution et débogage d'un projet de portail) Impossible de démarrer l'environnement de test de WebSphere Portal 5.0 avec un projet de portail

Incident : L'environnement de test de WebSphere Portal 5.0 ne démarre pas lorsque vous essayez la procédure suivante :

Solution : Vous devez reconfigurer l'environnement de test de WebSphere Portal 5.0.

  1. Dans la vue Serveurs, cliquez sur le serveur à l'aide du bouton droit de la souris et sélectionnez Ajouter et supprimer des projets.
  2. Supprimez le projet "wps" de la liste Projets configurés.
  3. Cliquez sur le projet de portail à l'aide du bouton droit de la souris et sélectionnez Exécuter > Exécuter sur le serveur.
Vous devez maintenant pouvoir exécuter dans l'environnement de test votre projet de portail et les projets de portlet que vous venez de lui associer.

3.18 Le forum de Rational Software Architect

Les forums Rational Software Architect de références "Ajouter l'environnement d'exécution SDO". Le site du support Software Architect (www.ibm.com/software/awdtools/developer/application/support) sera mis à jour pour inclure les liens d'accès aux forums.

Retour au fichier Readme principal