Portalprojekte unterstützen WebSphere Portal V5.0.2.2.
Wenn Sie JSR 168-Portlets mit Hilfe des neuen Portletassistenten erstellen, weist Rational Developer diesen Komponenten automatisch ein Attribut ID zu. Das Attribut ID muss ins Element <portlet-app/ > der Datei portlet.xml aufgenommen werden, um dem Server die eindeutige Identifikation des Portlets zu ermöglichen. (Dieses Attribut entspricht dem Attribut UID, das von den Portlets der IBM Portlet-API verwendet wird.)
Wenn Sie über JSR 168-Portlets verfügen, in deren Element <portlet-app/ > in der Datei "portlet.xml" kein Attribut ID definiert ist, müssen Sie das Attribut ID sowie seinen eindeutigen Wert unmittelbar nach dem Importieren des Portlets in den Arbeitsbereich hinzufügen. Zum Hinzufügen des Attributs ID müssen Sie den Portletimplementierungsdeskriptor öffnen und diesen in der Quellensicht bearbeiten. Ändern Sie den ID-Wert nicht mehr, nachdem Sie Ihr JSR 168-Portlet auf einem Portalserver implementiert oder Ihr JSR 168-Portletprojekt in einem Portalprojekt verwendet haben.
Für JSR 168-Portlets ohne das Attribut ID gelten gewisse Einschränkungen:
- Wenn Sie ein JSR 168-Portlet ohne ein Attribut ID in einem Portalprojekt verwenden, kann dieses Portalprojekt nicht in Testumgebungen ausgeführt werden.
- Wenn Sie der Testumgebung von WebSphere Portal 5.1 zwei oder mehr JSR 168-Portlets ohne ein Attribut ID zuordnen, kann die Testumgebung nicht mehr gestartet werden.
- Ändern Sie den Projektnamen nicht mehr, nachdem Sie Ihr JSR 168-Portlet auf einem Portalserver implementiert oder Ihr JSR 168-Portletprojekt in einem Portalprojekt verwendet haben.
Wenn Sie ein Portlet ausführen, das entweder eine Liste mit relationalen Datensätzen oder einen relationalen Datensatz (SDO) enthält, wird möglicherweise im Serverprotokoll die folgende Fehlernachricht angezeigt:
[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 ([04/10/07 17:57:27:172 JST] 4942fbd0 SystemOut O java.lang.LinkageError: Klasse org/eclipse/emf/ecore/EClass verstößt gegen die Einschränkungen des Ladeprogramms: Nicht übereinstimmende Definitionen für über- und untergeordnetes Ladeprogramm)Sie können diesen Fehler ignorieren.
Wenn Sie ein Kooperationsquellenportlet erstellen, müssen Sie den Parameter für den Aktionsnamen (actionNameParameter) hinzufügen und die Attribute in der WSDL-Datei manuell benennen. Beispiel:
<portlet:action type="standard" name="myActionName" actionNameParameter="ACTION_NAME"/>Im aktuellen Release generiert das Portaltool das Attribut "caption" in der WSDL-Datei nicht. Wenn Sie eine Verbindung unter WebSphere Portal V5.1 aufbauen, müssen Sie das Attribut "caption" in der WSDL-Datei angeben und außerdem den caption-Wert in der Ressourcendatei manuell definieren. Beispiel:
<portlet:param name="orderId" partname="order_id" caption="order.id" />Weitere Informationen hierzu finden Sie im Thema zum Entwickeln von Portlets für die Kooperation im WebSphere Portal Information Center.Hinweis: Dies wurde in in V6.0.0.1 behoben.
Wenn Sie den person-Tag in einem IBM API-Basisportlet unter WebSphere Portal V5.1 verwenden, können Sie zur Angabe folgende Syntax verwenden:
<pa:person value="CN=John Smith,OU=SALES,O=ACME" valueType="LDAPDN" displayName="John Smith" />Wenn Sie den person-Tag in einem IBM API-Faces-Portlet unter WebSphere Portal V5.1 verwenden, können Sie zur Angabe folgende Syntax verwenden:
Hinweis: Dies wurde in in V6.0.0.1 behoben. Verwenden Sie die gleiche Syntax (wie oben beschrieben) für das Basisportlet.<pa:person value="CN=John Smith,OU=SALES,O=ACME" />John Smith<pa:person>
Der person-Tag wird für JSR 168-Portlets unter WebSphere Portal V5.1 nicht unterstützt.
Einschränkung des Assistenten für SAP BAPI und RFM SDO: Wenn Sie innerhalb der Anzeigenabfolge über die Seite der Haupt- sowie der Vor- bzw. Nach-Funktion hinaus gelangen, und diese anschließend wieder aufzurufen versuchen, nachdem Sie eine andere Hauptfunktion ausgewählt haben, kann es zu Fehlern auf der Seite für die Zuordnung der Vor- bzw. Nach-Funktion kommen.
Lösung: Wenn es erforderlich ist, neue Vor- und Nach-Funktionszuordnungen zu definieren, müssen Sie den Assistent erneut starten.
Hinweis: Dies wurde in in V6.0.0.1 behoben.
Bevor Sie Portlets, die SAP SDO-Komponenten enthalten, auf einem Portalserver testen können, müssen Sie den SAP JCo-Adapter auf dem WebSphere Portal 5.1-Server konfigurieren:
- Laden Sie das SAP JCo-Adapterverzeichnis vom SAP Service Marketplace herunter.
- Klicken Sie hierzu auf Download Software > Download > SAP Connectors > SAP Java Connector. Wählen Sie die Datei für das von Ihnen verwendete Betriebssystem aus, und laden Sie diese herunter. Extrahieren Sie den Inhalt der ZIP-Datei in einem lokalen Verzeichnis.
- Führen Sie abhängig vom verwendeten Betriebssystem die folgenden Schritte aus. Hinweis: <wps_51 > bezeichnet das Installationsverzeichnis des WebSphere Portal 5.1-Servers, z. B. C:WebSpherePortalServer51TE.
Für Windows:
- Kopieren Sie die Dateien "sapjco.jar" und "sapjcorfc.dll" in das Verzeichnis <wps_51 >\shared\app.
- Kopieren Sie die Datei "librfc32.dll" in das Verzeichnis c:\windows\system32\.
- Sie müssen den WebSphere Portal 5.1-Server erneut starten.
Für Linux:
- Kopieren Sie die Dateien "sapjco.jar" und "libsapjcorfc.so" in das Verzeichnis <wps_51 >\shared\app.
- Fügen Sie den Ordner, der die Datei "librfccm.so" enthält, zur Umgebungsvariable LD_LIBRARY_PATH hinzu.
- Sie müssen den WebSphere Portal 5.1-Server erneut starten.
Kooperationsportlets werden vom internen Rational Developer-Browser für RedHat Enterprise Linux 3.0 nicht unterstützt. Wenn Sie Kooperationsportlets in RedHat Enterprise Linux 3.0 verwenden müssen, dann sollten Sie mit Netscape Communicator arbeiten.
Um Netscape Communicator als Standardbrowser zu verwenden, müssen Sie Rational Developer zur Verwendung eines externen Browsers konfigurieren. Wählen Sie hierzu in der Menüleiste Fenster > Vorgaben aus. Erweitern Sie den Knoten Internet auf der linken Seite, und wählen Sie Web-Browser aus. Wählen Sie im Hauptabschnitt einen beliebigen Browser mit Ausnahme von Interner Webbrowser aus.
Weitere Informationen hierzu finden Sie im Thema zu den bekannten Problemen und Einschränkungen bei Kooperationsportlets im WebSphere Portal Information Center.
Beim Erstellen eines Portalprojekts mit dem Assistenten für neue Portalprojekte oder beim Importieren eines Beispielportalprojekts aus der Beispielgalerie werden in der Problemsicht Warnungen zu defekten Links anzeigt.
In der aktuellen Version von Rational Developer zeigt Portal Designer als unterstützte Markup-Typen nur HTML, cHTML und WML an. Wenn Sie in einem zu importierenden Projekt für eine Seite oder eine Bezeichnung andere unterstützte Markup-Typen angegeben haben, werden diese in Rational Developer zwar verwaltet, können jedoch nicht geändert werden. Darüber hinaus werden diese auch in der Eigenschaftssicht nicht angezeigt.
In der aktuellen Version von Rational Developer können externe URLs ausschließlich in Portal Designer definiert werden. Wenn auf dem Portalserver interne URLs verwendet werden, werden diese in einem importierten Projekt verwaltet, können jedoch nicht geändert werden. Sie können die internen URLs nur so implementieren, dass diese zurück auf den ursprünglichen Portalserver verweisen.
Hinweis: Dies wurde in in V6.0.0.1 behoben.
Im aktuellen Release von Portal Designer werden die Admin- und AdminLeftNavigation-Themen in der Entwurfssicht angezeigt. Diese Themen können jedoch nur für die Portalverwaltung verwendet werden und sollten nicht als Standardthema für ein Portalprojekt ausgewählt werden.
Hinweis: Dies wurde in in V6.0.0.1 behoben.
Problem: Wenn Sie ein neues Portlet in einem vorhandenen IBM API-Portletprojekt erstellen, werden die folgenden Fehlernachrichten angezeigt, wenn Sie die Option Portletbeispiel für Click-to-Action-Absender hinzufügen oder Portletbeispiel für Nachrichtenabsender hinzufügen auswählen.
- IWAL0008E Falscher Servletverweis für das Portlet. (portlet.xml)
- CHKJ4014W: Der Eintrag vom Typ "Servletname" ist leer. (web.xml)
Lösung: Sie müssen das Portletprojekt wie folgt erneut öffnen:
- Klicken Sie mit der rechten Maustaste auf das Portletprojekt, und wählen Sie dann im Kontextmenü die Option Projekt schließen aus.
- Klicken Sie mit der rechten Maustaste auf das Portletprojekt, und wählen Sie dann im Kontextmenü die Option Projekt öffnen aus.
- Klicken Sie mit der rechten Maustaste auf das Portletprojekt, und wählen Sie dann im Kontextmenü die Option Überprüfung ausführen aus.
Hinweis: Dies wurde in in V6.0.0.1 behoben.
Problem: Das Starten der WebSphere Portal-Testumgebung schlägt fehl.
Lösung:
- Überprüfen der durchgeführten Installation: Dieses Problem ist möglicherweise darauf zurückzuführen, dass es während der Installation zu Fehlern gekommen ist. Überprüfen Sie, ob während der Installation der WebSphere Portal-Testumgebung Fehler aufgetreten sind, und beheben Sie diese.
- Löschen übermäßig langer Dateinamen: Möglicherweise kann der Server nicht gestartet werden, weil das Portletprojekt Dateien mit zu langen Dateinamen enthält. Um diesen Fehler zu beheben, müssen Sie entweder den Projektnamen, das Paketpräfix und/oder das Klassenpräfix kürzen, so dass der generierte Dateinamen die zulässige Länge nicht überschreitet. Alternativ hierzu können auch die Dateinamen selbst auf die zulässige Länge gekürzt werden. Wenn als Arbeitsbereich das Standardverzeichnis verwendet wird, kann es außerdem auch sinnvoll sein, einen anderen Arbeitsbereich mit kürzerem Verzeichnisnamen zu verwenden. Zur Angabe des Arbeitsbereichsverzeichnisses müssen Sie Rational Developer starten und dann den im Dialogfeld angegebenen Namen ändern. Wenn das Dialogfenster zur Angabe des Arbeitsbereichs nicht angezeigt wird, rufen Sie die Eingabeaufforderung auf, und geben Sie dort nach dem Befehl zur Ausführung von Rational Developer die Anweisung -data [workspace_name] ein.
Problem: Im JSR 168-Portletimplementierungsdeskriptor ist es nicht möglich, im Bereich Portletgruppen einen Portletnamen zu bearbeiten.
Lösung: Bearbeiten Sie den Portletnamen auf der Seite "Quelle".
Problem: Wenn Sie den Tag <f:view> aus einer JSP-Faces-Datei löschen, die mit dem Assistenten generiert wurde, und Faces-Komponenten in die Datei einfügen, wird an Stelle des Tags <f:view> der Tag <f:subview> eingefügt. Mit diesem JSP-Dateityp kann das Faces-Portlet nicht fehlerfrei ausgeführt werden. Dabei gehen Eingaben, die im Browser vorgenommen wurden, bei der Verarbeitung auf dem Server verloren.
Problem: Um diesen Fehler zu beheben, müssen Sie in der JSP-Datei den Tag <f:subview > durch den Tag <f:view > ersetzen.
Wenn Sie die Anzeige eines Faces-Portlets, das Tags für Click-to-Action-Operationen enthält, auf maximale Größe vergrößern, wird der Inhalt des Portlets nicht angezeigt.
Hinweis: Dies wurde in in V6.0.0.1 behoben.
Problem: Wenn die Portal-UTE-Komponente nicht installiert wurde, können Sie keinen Import-, Export- und Implementierungsportalserver erstellen, dessen Zieladresse "localhost" oder "127.0.0.1" lautet.
Lösung: Wenn Sie einen derartigen Server benötigen, müssen Sie an Stelle von "localhost" den vollständig qualifizierten Namen der Maschine (z. B. myhost.mydomain) verwenden.
Hinweis: Dies wurde in in V6.0.0.1 behoben.
Problem: Wenn Sie den Import eines neuen Portalprojektes abbrechen, bevor er vollständig abgeschlossen wurde, wird das unvollständige Portalprojekt nicht entfernt, kann jedoch auch nicht verwendet werden.
Lösung: Sie müssen die Portalkonfiguration und die zugehörigen Dateien erneut importieren. Verwenden Sie hierzu die Option Projekt beim Überschreiben löschen des Assistenten für den Portalimport.
Hinweis: Dies wurde in in V6.0.0.1 behoben.
Problem: Beim Importieren einer vorhandenen Portalsite von WebSphere Portal in Rational Developer werden in der Problemsicht für das importierte Portalprojekt WSRP-Gültigkeitsfehler angezeigt.
Lösung: Wenden Sie den APAR PQ95638 auf WebSphere Portal an, bevor Sie die Importoperation in Rational Developer durchführen.
Hinweis: Dies wurde in WP5.1, jedoch nicht in WP5.0 behoben.
Problem: Die Datei "license.html" oder "privacy.html" kann in einem importierten Portalprojekt mit Page Designer nicht geöffnet werden, da Codierungsfehler vorliegen.
Lösung: Wenden Sie auf Ihren Portalserver den APAR PQ93681 an, und wiederholen Sie anschließend den Import des Projekts vom Portalserver.
Hinweis: Dies wurde in WP5.1, jedoch nicht in WP5.0 behoben.
"SDO-Laufzeit hinzufügen" verweist auf Rational Application Developer-Newsgroups. Das Forum für Rational Application Developer steht unter der Site von IBM developerWorks zur Verfügung: (www.ibm.com/developerworks/forums/dw_forum.jsp?forum=430&cat=24&hideBody=true).