Rational® Application
Developer V6.0
does not support developing WebSphere® Portal V4.2 portlets. You need to
migrate WebSphere Portal
V4.2 portlet projects to V5.x.
Most portlets written for WebSphere Portal V4.2 will run unchanged in WebSphere Portal
V5.x. Some of the Portlet 4.2.x APIs are now marked as deprecated, but still
available on WebSphere Portal V5.x.
Note: Migrated portlet application
projects are not backward compatible.
To migrate portlet applications
for WebSphere Portal
V4.2 to V5.x, do the following steps:
- Migrate the Portal V4.2 portlet projects to Portal V5.x portlet
projects:
- Right-click the portlet application project that you want to
migrate.
- Select to open the Portlet API page.
- Select WebSphere Portal Version 5.x from the
Portlet API level drop-down list.
- Click OK, and the following changes are
automatically made:
- The tag library descriptor (TLD) file for the portlet API is removed if
it exists.
- The Web level is changed from 2.2 to 2.3.
- The portlet specific class path entries are removed, as the WebSphere Portal
JRE container and WebSphere Portal runtime target container will dynamically
add them.
- If your portlet project is associated to an enterprise application
project, it is recommended that you migrate the J2EE level of the EAR project
to J2EE 1.3. Portlet applications designed for WebSphere Portal
V5.x should be compliant with the J2EE level 1.3 specifications.
Note: Before
migrating your enterprise application project to J2EE 1.3, read
Migrating J2EE projects.
For information on using the J2EE Migration Wizard, refer to the online help.
- If the migrated portlet project is only associated to the enterprise
application project, do as follows:
- Close all editors in the workbench.
- Right-click the enterprise application project with which the migrated
portlet project is associated.
- Select and click Next.
- Select J2EE version 1.3 and WebSphere Portal as the target server.
- Click Finish.
- If other portlet projects are associated with the enterprise
application project, you must remove the migrated portlet project and add
it to another enterprise application project.
- Remove the module of the migrated portlet project from the enterprise
application project.
- Expand the enterprise application project and select the deployment descriptor.
- Select .
- Select the Module tab. On the Module page of the
editor, select the WAR file of the migrated portlet project.
- Click Remove.
- Select to save the changes.
- Create a new enterprise application project and add the portlet project
to it.
- Select .
- Select Show All Wizards check box.
- Expand the J2EE and select Enterprise Application Project.
- Fill in the project Name field, select J2EE
version 1.3 and WebSphere Portal as the target server
and click Next.
- On the EAR Module Projects page, select the migrated
portlet project and click Finish.
The portlet project is now migrated to WebSphere Portal V5.x.