Les projets Portal prennent en charge WebSphere Portal version 5.0.2.2.
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 :
- Si vous utilisez un portlet JSR 168 sans attribut ID dans un projet de portail, ce projet de portail ne peut pas être exécuté dans un environnement de test.
- Si vous associez plusieurs portlets JSR168 sans attribut ID à l'environnement de test de WebSphere Portal 5.1, l'environnement de test ne démarre pas.
- Ne modifiez pas le nom du projet 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.
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 loadersVous pouvez ignorer cette erreur.
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.
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.
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.
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 :
- Téléchargez le répertoire de l'adaptateur JCo de SAP à partir du site SAP Service Marketplace.
- 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.
- 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 :
- Copiez sapjco.jar et sapjcorfc.dll dans <wps_51>\shared\app.
- Copiez librfc32.dll dans c:\windows\system32\.
- Vous devez redémarrer le serveur WebSphere Portal 5.1.
Pour Linux :
- Copiez sapjco.jar et libsapjcorfc.so dans <wps_51>\shared\app.
- Ajoutez le dossier qui contient le fichier librfccm.so à la variable d'environnement LD_LIBRARY_PATH.
- Vous devez redémarrer le serveur WebSphere Portal 5.1.
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.
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.
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.
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.
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.
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.
- Mettez à jour tous les fichiers du répertoire ci-après en copiant les dernières versions de ces fichiers du répertoire WebSphere Portal 5.0.2.x PortalServer\*.*.
- rép_install_WS\runtimes\portal_v50_stub\*.*, rép_install_WS correspondant au répertoire d'installation de Rational Developer.
- Pour déboguer les portlets, vérifiez que vous avez également appliqué le service à l'environnement de test de WebSphere Portal. Vous devez appliquer le service dans le répertoire rép_install_WS\runtimes\portal_v50 de WebSphere Portal V5.0.2.x.
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.
- Appliquez le service à l'environnement de test de WebSphere Portal v5.1 en suivant les instructions du service.
- Mettez à jour tous les fichiers du répertoire ci-après en copiant les dernières versions de ces fichiers du répertoire PortalServer\*.* de l'environnement de test de WebSphere Portal 5.1.
- rép_install_RD\runtimes\portal_v51_stub\*.*, rép_install_RD correspondant au répertoire d'installation de Rational Developer.
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é.
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 :
- IWAL0008E Référence de servlet incorrecte pour le portlet. (portlet.xml)
- CHKJ4014W : Entrée de type Nom de servlet vide. (web.xml)
Solution : Vous devez rouvrir le projet de type portlet en procédant comme suit :
- 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.
- 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.
- Cliquez avec le bouton droit sur le projet de type portlet et sélectionnez Exécuter la validation dans le menu déroulant.
Incident : L'environnement de test de WebSphere Portal ne parvient pas à démarrer.
Solution :
- Vérifiez que l'installation s'est déroulée correctement : Cet incident est peut-être dû à un échec survenu lors de l'installation. Vérifiez si des incidents se sont produits lors de l'installation de l'environnement de test de WebSphere Portal et résolvez-les si nécessaire.
- Eliminez les noms de fichier excessivement longs : Il se peut que le serveur ne démarre pas car le projet de type portlet contient des fichiers dont les noms sont excessivement longs. Pour résoudre cet incident, raccourcissez le nom du projet, le préfixe du package et/ou le préfixe de la classe pour que la longueur du nom de fichier généré soit admise. Vous pouvez également raccourcir les noms de fichier eux-mêmes pour obtenir une longueur acceptable. De plus, si le répertoire par défaut est utilisé comme espace de travail, il est recommandé d'utiliser un autre espace de travail dont le nom de répertoire est plus court. Vous pouvez spécifier le répertoire de l'espace de travail en lançant Rational Developer et en modifiant le nom dans la boîte de dialogue qui s'affiche. Si cette boîte de dialogue n'apparaît pas, accédez à l'invite de commande et entrez -data [nom_espace_de_travail] après avoir saisi la commande d'exécution de Rational Developer.
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.
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 :
- Dans la vue Serveurs, cliquez deux fois sur le serveur de l'environnement de test de WebSphere Portal. L'éditeur du serveur s'ouvre.
- Dans la partie inférieure de l'éditeur, cliquez sur l'onglet Environnement.
- 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.
- Appuyez sur Ctrl+S pour sauvegarder vos modifications.
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.
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 :
- 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.
- 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.
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.
Si vous maximisez un portlet Faces qui contient des balises Click-to-Action, le contenu du portlet n'est pas affiché.
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é.
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).
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.
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.
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.
Incident : L'environnement de test de WebSphere Portal 5.0 ne démarre pas lorsque vous essayez la procédure suivante :
- Démarrez l'environnement de test avec un projet de portail auquel aucun projet de type portlet n'est associé, puis
- Ajoutez des projets de portlet au projet de portail et essayez d'exécuter à nouveau ce dernier dans l'environnement de test.
Solution : Vous devez reconfigurer l'environnement de test de WebSphere Portal 5.0.
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.
- Dans la vue Serveurs, cliquez sur le serveur à l'aide du bouton droit de la souris et sélectionnez Ajouter et supprimer des projets.
- Supprimez le projet "wps" de la liste Projets configurés.
- Cliquez sur le projet de portail à l'aide du bouton droit de la souris et sélectionnez Exécuter > Exécuter sur le serveur.
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