Portal Projects support WebSphere Portal v5.0.2.2.
When you create JSR 168 portlets using the new portlet wizard, Rational Developer automatically assigns an ID attribute. The ID attribute should be included in the <portlet-app/> element of the portlet.xml file to uniquely identify the portlet to the server. (This attribute corresponds to the UID attribute used by IBM portlet API portlets.)
If you have JSR 168 portlets that do not have an ID attribute on the <portlet-app/> element in the portlet.xml, add the ID attribute with its unique value immediately after importing portlet into workspace. To add the ID attribute, open the portlet deployment descriptor and edit it using the Source view. Do not change the ID value after you have deployed your JSR 168 portlet to a portal server, or after you have used your JSR 168 portlet project in a portal project.
There are limitations on a JSR 168 portlet without an ID attribute:
- If you use a JSR 168 portlet without an ID attribute in a portal project, that portal project cannot be run in Test Environment.
- If you associate two or more JSR168 portlets without an ID attribute to WebSphere Portal 5.1 Test Environment, the Test Environment will fail to start.
- You should not change the project name after you have deployed your JSR 168 portlet to a portal server, or after you have used your JSR 168 portlet project in a portal project.
When running a portlet that contains either a Relational Record List or a Relational Record (SDO), you may see the following error in your server log:
[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 loadersYou can ignore this error.
When you create a cooperative source portlet, you need to add the actionNameParameter and name attributes to the WSDL file manually. For example:
<portlet:action type="standard" name="myActionName" actionNameParameter="ACTION_NAME"/>In this release, portal tool does not generate the caption attribute in the WSDL file. When you use the wire with WebSphere Portal v5.1, you need to specify caption attribute in the WSDL file and caption value in the resource file manually.For example:
<portlet:param name="orderId" partname="order_id" caption="order.id" />For more information, refer to "Developing portlets for cooperation" topic in the WebSphere Portal information center.Note: This has been fixed in V6.0.0.1.
When you use the person tag in an IBM API basic portlet on WebSphere Portal v5.1, you should specify it using the following syntax:
<pa:person value="CN=John Smith,OU=SALES,O=ACME" valueType="LDAPDN" displayName="John Smith" />When you use the person tag in an IBM API Faces portlet on WebSphere Portal v5.1, you should specify it using the following syntax:
Note: This has been fixed in V6.0.0.1. Use the same syntax decribed above for the basic portlet.<pa:person value="CN=John Smith,OU=SALES,O=ACME" />John Smith<pa:person>
The person tag is not supported for JSR 168 portlets.
SAP BAPI and RFM SDO wizard limitation: If you advance past the main and pre/post functions page, and try to return to it after picking a different main function, the Pre/Post mappings page will not work correctly.
Solution: If you need to set new pre- and post-function mappings, you must restart the wizard.
Note: This has been fixed in V6.0.0.1.
Before you test portlets that contain SAP SDO on a Portal server, you must configure the SAP JCo adapter on the WebSphere Portal 5.1 server:
- Download SAP's JCo adapter directory from SAP at SAP Service Marketplace.
- Click Download Software > Download > SAP Connectors > SAP Java Connector. Based on your operating system, select the appropriate file to download. Extract the contents of the ZIP file into a local directory.
- Complete the following steps according to your operating system. Note: <wps_51> refers to the installation directory of WebSphere Portal 5.1 server; for example, C:\WebSphere\PortalServer51TE.
For Windows:
- Copy sapjco.jar and sapjcorfc.dll to <wps_51>\shared\app.
- Copy librfc32.dll to c:\windows\system32\.
- You must restart the WebSphere Portal 5.1 server.
For Linux:
- Copy sapjco.jar and libsapjcorfc.so to <wps_51>\shared\app.
- Add the folder that contains the file librfccm.so to environment variable LD_LIBRARY_PATH.
- You must restart the WebSphere Portal 5.1 server.
Cooperative portlets are not supported by the Rational Developer internal browser for RedHat Enterprise Linux 3.0. If you need to use cooperative portlets in RedHat Enterprise Linux 3.0, use Netscape Communicator.
To use Netscape Communicator as the default browser, configure Rational Developer to use an external browser. To do this, select Window > Preferences from the menu bar. Expand the Internet node on the left, and select Web Browser. In the main section, select any browser but Internal Web Browser.
For more information, refer to the "Known issues and restrictions with cooperative portlets" topic in the WebSphere Portal information center.
When creating a portal project using the New Portal Project wizard, or importing a sample Portal project from the Samples Gallery, broken link warning messages appear in the Problems view.
In this version of Rational Developer, Portal Designer only displays HTML, cHTML, and WML as supported markups. If you have specified other supported markups for a page or label in a project that you import, they are maintained in Rational Developer; however, you cannot change those markups, and they will not be displayed in the Properties view.
In this version of Rational Developer, you can set external URLs only in Portal Designer. If you have internal URLs on the portal server, they will be maintained in an imported project, but you cannot change them. You can only deploy the internal URLs back to the original portal server.
Note: This has been fixed in V6.0.0.1.
In this release of Portal Designer, the Admin and AdminLeftNavigation themes will be displayed in the Outline view. However, these themes are for Portal Administration purposes only, and should not be selected as the default theme for a portal project.
Note: This has been fixed in V6.0.0.1.
Problem: When you create a new portlet in an existing IBM API portlet project, the following error messages will be displayed if you select the Add Click-to-Action sender portlet sample or Add message sender portlet sample options on the Event Handling page:
- IWAL0008E Incorrect servlet reference for the portlet. (portlet.xml)
- CHKJ4014W: Empty Entry of Type Servlet Name. (web.xml)
Solution: You must re-open the portlet project using the following method:
- Right-click the portlet project and select Close Project from the pop-up menu.
- Right-click the portlet project and select Open Project from the pop-up menu.
- Right-click the portlet project and select Run Validation from the pop-up menu.
Note: This has been fixed in V6.0.0.1.
Problem: The WebSphere Portal Test Environment fails to start.
Solution:
- Verify successful installation: This problem may have occurred because of a failure during installation. Check for problems during the WebSphere Portal Test Environment installation and remedy as required.
- Eliminate excessively long filenames: The server may not start because the portlet project has files with excessively long filenames. To solve this problem, either shorten the project name, the package prefix, and/or the class prefix, so that the generated filename length will be acceptable. Alternately, the individual filenames themselves may be shortened to an acceptable length. Furthermore, if the default directory is used as the workspace, it would also be effective to use a different workspace with a shorter directory name length. You can specify the workspace directory by launching Rational Developer, and change the name in the dialog box provided. If the dialog box to specify the workspace does not appear, go to the command prompt and type -data [workspace_name] after typing the Rational Developer execution command.
Problem: In the JSR 168 Portlet Deployment Descriptor, you cannot edit a portlet name in the Portlet Collections area.
Solution: Edit the portlet name in the Source page.
Problem: If you delete the <f:view> tag from a wizard-generated Faces JSP file and insert Faces components in the file, a <f:subview> tag is inserted instead of a <f:view> tag. With this type of JSP file, the Faces portlet will not run correctly. Inputs on the browser are lost in the server-side processing.
Problem: To fix this problem, replace the <f:subview> tag with the <f:view> tag in the JSP file.
If you maximize a Faces portlet that contains Click-to-Action tags, the contents of the portlet does not show.
Note: This has been fixed in V6.0.0.1.
Problem: If the Portal UTE is not installed, you cannot create a Portal Import, Export & Deploy server that targets "localhost" or "127.0.0.1".
Solution: If you need to create such a server, then use the fully qualified name of the machine instead of "localhost" (example: myhost.mydomain).
Note: This has been fixed in V6.0.0.1.
Problem: If you cancel the import of a new portal project before it is complete, the incomplete portal project is not removed and becomes unavailable.
Solution: You need to import the portal configuration and files again using the Delete on overwrite option in the Import Portal wizard.
Note: This has been fixed in V6.0.0.1.
Problem: When importing an existing portal site from WebSphere Portal to Rational Developer, validation errors related to WSRP show up in the Problems view against the imported portal project.
Solution: Apply the APAR PQ95638 to WebSphere Portal before importing to Rational Developer.
Note: This has been fixed for WP5.1, but not fixed for WP5.0.
Problem: Can not open license.html or privacy.html files in an imported portal project using Page Designer due to incorrect encoding.
Solution: Apply APAR PQ93681 to your Portal server, then re-import the project from the Portal server.
Note: This has been fixed for WP5.1, but not fixed for WP5.0.
The "Add SDO runtime" references Rational Application Developer newsgroups. The forum for Rational Application Developer is available from the IBM developerWorks site (www.ibm.com/developerworks/forums/dw_forum.jsp?forum=430&cat=24&hideBody=true).
Return to the main readme file