Outils Portal - Notes sur l'édition


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
   2.4 *Limitations de la balise person
   2.5 *Limitations des outils EIS
   2.6 Configuration de SAP JCo sur un serveur WebSphere Portal
   2.7 Limitation des portlets coopératifs sous RedHat Enterprise Linux 3.0
   2.8 Des messages d'avertissement de liens rompus sont affichés dans la vue Incidents
   2.9 Support de marquage dans Portal Designer
   2.10 *Une URL interne ne peut pas être définie
   2.11 *Ne pas sélectionner les thèmes Admin comme thèmes par défaut
3.0 Incident connus
   3.1 *(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.2 (Débogage et test des portlets) Impossible de démarrer l'environnement de test de WebSphere Portal
   3.3 (Descripteur de déploiement de portlet) Edition à l'aide de l'éditeur de déploiement de portlet JSR 168
   3.4 Si <f:subview> est utilisé au lieu de <f:view>, les portlets Faces ne fonctionnent pas correctement.
   3.5 *La balise Click-to-Action ne fonctionne pas dans un portlet Faces maximisé.
   3.6 *(Importation, exportation et déploiement) Impossible de créer un serveur d'importation, d'exportation et de déploiement ayant pour cible "localhost"
   3.7 *(Importation de portail) L'annulation de l'opération d'importation rend non disponible le nouveau projet de portail
   3.8 (Importation d'un portail) Des erreurs liées à WSRP sont affichées dans la vue Incidents d'un projet de portail importé
   3.9 (Personnalisation des portails) Impossible d'ouvrir dans un projet de portail importé les fichiers license.html et privacy.html
   3.10 Le forum de Rational Application Developer

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 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

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 version, l'outil de portail ne génère pas l'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.

Remarque : Cet incident a été résolu dans la version 6.0.0.1.

2.4 *Limitation de la balise person

Lorsque vous utilisez la balise person dans un portlet de base d'API IBM sur WebSphere Portal version 5.1, vous pouvez 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 Faces d'API IBM sur WebSphere Portal version 5.1, vous pouvez la spécifier à l'aide de la syntaxe suivante :
Remarque : Cet incident a été résolu dans la version 6.0.0.1. Utilisez la syntaxe décrite ci-dessus pour le portlet de base.

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

Remarque : Cet incident a été résolu dans la version 6.0.0.1.

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 Limitation des portlets coopératifs sous RedHat Enterprise Linux 3.0

Les portlets coopératifs ne sont pas pris en charge par le navigateur interne de Rational Developer pour RedHat Enterprise Linux 3.0. Si vous devez utiliser des portlets coopératifs dans RedHat Enterprise Linux 3.0, utilisez Netscape Communicator.

Pour utiliser Netscape Communicator comme navigateur par défaut, configurez Rational Developer de sorte qu'il utilise un navigateur externe. Pour cela, sélectionnez Fenêtre > Préférences dans la barre de menus. 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.

Pour plus d'informations, reportez-vous à la rubrique sur les incidents connus et les restrictions liés aux portlets coopératifs, dans le centre de documentation de WebSphere Portal.

2.8 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.9 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.10 *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.

Remarque : Cet incident a été résolu dans la version 6.0.0.1.

2.11 *Ne pas sélectionner 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.

Remarque : Cet incident a été résolu dans la version 6.0.0.1.

3.0 Incidents connus

3.1 *(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 portlet d'API IBM existant, les messages d'erreur suivants sont affichés 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 portlet à l'aide de la méthode suivante :

  1. A l'aide du bouton droit de la souris, cliquez sur le projet de portlet et sélectionnez Fermer le projet dans le menu en incrustation.
  2. A l'aide du bouton droit de la souris, cliquez sur le projet de portlet et sélectionnez Ouvrir un projet dans le menu en incrustation.
  3. A l'aide du bouton droit de la souris, cliquez sur le projet de portlet et sélectionnez Exécuter la validation dans le menu en incrustation.

Remarque : Cet incident a été résolu dans la version 6.0.0.1.

3.2 (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.3 (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.4 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.5 *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é.

Remarque : Cet incident a été résolu dans la version 6.0.0.1.

3.6 *(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).

Remarque : Cet incident a été résolu dans la version 6.0.0.1.

3.7 *(Importation de portail) L'annulation de l'opération d'importation rend non disponible le 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.

Remarque : Cet incident a été résolu dans la version 6.0.0.1.

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

Remarque : Cet incident a été résolu dans WP5.1 mais non dans WP5.0.

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

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.

Remarque : Cet incident a été résolu dans WP5.1 mais non dans WP5.0.

3.10 Le forum de Rational Application Developer

L'opération "Ajouter l'environnement d'exécution SDO" fait référence à des forums Rational Application Developer. Le forum de Rational Application Developer est disponible sur le site IBM developerWorks (www.ibm.com/developerworks/forums/dw_forum.jsp?forum=430&cat=24&hideBody=true).

Retour au fichier Readme principal