IBM WebSphere Portlet Factory Version 6.0.0.3
This edition applies to version 6.0.0.3 of IBM WebSphere Portlet Factory and to all subsequent releases and modifications until otherwise indicated in new editions.
(C) Copyright International Business Machines Corporation 2006. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
This document contains information about updates to WebSphere Portlet Factory provided by the fixpack for V6.0.0.3. This fixpack is cumulative to include the fixes and updates provided by previous fixpacks for WebSphere Portlet Factory Version 6.0. For details about previous updates and fixes, refer to the information provided at the download page for each fixpack. The download pages are available from the support site at the following URL:
http://www.ibm.com/support/search.wss?rs=3044&tc=SSRUWN%2BSS3LP9&q=fixpack
The following defects are addressed by this fixpack.
This problem occured when adding a portlet adapter builder to a model and setting the Portlet Keywords input. When the portlet WAR was deployed and rendered on the page, the text entered in the builder editor's Portlet Keywords field was shown as the portlet title instead of the text provided by the Portlet Title field. The portlet descriptor also contained the portlet keywords in place of the the portlet title element.
When communicating with some later versions of the PeopleSoft server, the PeopleSoft View & Form builder was not able to place a selected Component Interface into Correction Mode to allow editing and update of historical data items. With this fix the PeopleSoft View & Form builder will place a Component Interface into Correction Mode when the Edit History Items and Get History Items builder inputs are checked.
When a portal containing WebSphere Portlet Factory portlets was protected with WebSeal,
problems were encountered because WebSeal did not discover or modify relative URLs inside JavaScript.
WebSphere Portlet Factory uses URLs in JavaScript to implement form submissions (especially from links),
and WebSphere Portal generates server-relative URLs.
To correct this problem, you can set
the BSConfig property bowstreet.settings.forceAbsoluteURLs=true in override.properties.
Setting this parameter to true makes all URLs in the portlet absolute.
After changing this parameter, you must restart the application server for the change to take effect.
The SQL call builder did not support certain characters for column names, including double-byte characters, katakana characters, and symbols. The builder also could not handle tables with Japanese characters in the table name. Even with this fix installed, however, you should enclose column names that contain special characters or spaces with double quotes to avoid regeneration errors.
Prior to this fix, WebSphere Portlet Factory only processed Web service schemas and WSDL files that were referenced with an absolute URL. This fix supports schemas and WSDL files that reference each other using namespace URIs.
This fixes a problem in which the server would run out of memory or hang under the following conditions.
LO17047 -- Resolves fix Ref 28185 above (PMR 79075).
Refer to WebSphere Portlet Factory 6.0 Release Notes.
Refer to WebSphere Portlet Factory 6.0 Release Notes.
In addition, note that Portlet Factory now supports all versions of the zOS operating system that are supported by WebSphere Portal 6.0.
To apply this fixpack to an installed copy of WebSphere Portlet Factory 6.0:
Exit WebSphere Portlet Factory 6.0 Designer.
Extract the contents of the fixpack to a convenient location on the machine where Portlet Factory Designer is installed.
Locate and run the Fixpack.exe file.
Follow the instructions in the fixpack installation program to apply the fixpack to the installed version of WebSphere Portlet Factory 6.0.
Note: To successfully install this fixpack, you must know the path where Portlet Factory is installed.
To verify that the fixpack was correctly installed:
Start Portlet Factory Designer.
In the Eclipse Help menu, select About Eclipse SDK.
In the About Eclipse SDK window, click the IBM WebSphere Portlet Factory icon.
In the About Eclipse SDK Features screen, note that the Portlet Factory Designer version is 6.0.0.3.
Once you have applied this fixpack to Portlet Factory Designer, you must modify previously created projects to incorporate fixpack improvements. To incorporate fixpack changes into a project, follow these steps, each of which gives you the option of canceling the operation without making changes:
Start Portlet Factory Designer and load a project.
In the project's right-click menu, select WebSphere Portlet Factory Project > Modify.
When prompted, select OK to initiate the process of overwriting existing product files or adding new ones. Project Factory displays a confirmation box. Click OK to continue.
The New Project Wizard Add Feature Sets page is displayed. Note that Feature Sets previously installed in the project are selected. These Feature Sets must now be reinstalled to pick up fixpack changes.
Click Next to install or upgrade selected Feature Sets.
As Additional Project Wizard screens are displayed, click Next to accept existing project settings.
Click Finish to complete project modification and upgrade. When you click Finish, Portlet Factory begins the actual modification of the project files. When the first file that the process would overwrite is encountered, Portlet Factory displays a dialog box that prompts you to choose to overwrite the file (Yes), retain the file in its current form (No), overwrite all existing files (Yes to All), or leave all existing files in their current state (No to All).
Restart the WebSphere Application Server to insure project changes are picked up in the deployed project WAR file.
To remove this fixpack from an installed copy of WebSphere Portlet Factory 6.0:
Close Portlet Factory Designer.
Open the Windows Control Panel and select Add or Remove Programs.
In the Installed Programs list, select the WebSphere Portlet Factory Fixpack 6.0.0.3 program.
Click Change/Remove to start the fixpack uninstall program.
Click Next to uninstall the fixpack.
Follow these steps to remove fixpack enhancements and changes to the software. Note that you will have to modify your projects by hand if you have made any changes to them between installing and uninstalling the fixpack as you would between any version change.
Remove the fixpack from Portlet Factory Designer. (See section 3.0 above.)
Start Portlet Factory Designer and load the project.
In the project's right-click menu, select: WebSphere Portlet Factory Project > Modify.
When prompted, select OK to initiate the process of restoring 6.0.0.2 (or previous release level) product files. Project Factory displays a confirmation box. Click OK to continue.
The New Project Wizard Add Feature Sets page is displayed. Note that Feature Sets previously installed in the project are selected. These Feature Sets must now be reinstalled to override fixpack changes.
Click Next to restore the selected Feature Sets.
As Additional Project Wizard screens are displayed, click Next to accept 6.0.0.2 project settings (or previous release level).
Click Finish to complete project rollback. When you click Finish, Portlet Factory begins the actual modification of the project files. When the first file that the process would overwrite is encountered, Portlet Factory displays a dialog box that prompts you to choose to overwrite the file (Yes), retain the file in its current form (No), overwrite all existing files (Yes to All), or leave all existing files in their current state (No to All).
Restart the WebSphere Application Server to insure project changes are picked up in the deployed project WAR file.
As of May 15th 2006, all support for Bowstreet and new IBM derivative products is being provided through IBM Customer Support. All Bowstreet email and electronic incident submission systems have been replaced by the IBM Electronic Service Request (ESR) system.
In addition, new support forums have been created on IBM developerWorks. Included are 8 different forums for the IBM Portlet Factory and 4 forums for the IBM Workplace Dashboard. These forums are available to external customers and they will be monitored by IBM resources. Links to these forums are included in the support announcement.
Call 800-IBM-SERV (800-426-7378) in the US and Canada. When calling from outside the US or Canada, please call the appropriate number below:
Europe, Middle East and Africa: +44(0)1475-897169
Inside Australia: 131-426 or 1-800-257373
You can directly submit support tickets to IBM. For more information on the IBM ESR sytem, refer to: http://www.ibm.com/software/support/probsub.html
This information was developed for products and services offered in the U.S.A.
IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:
IBM Director of LicensingFor license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:
IBM World Trade Asia CorporationThe following paragraph does not apply to the United Kingdom or any
other country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS
IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING,
BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY
OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer
of express or implied warranties in certain transactions, therefore, this
statement may not apply to you.
This information could include technical inaccuracies or typographical
errors. Changes are periodically made to the information herein; these
changes will be incorporated in new editions of the publication. IBM may
make improvements and/or changes in the product(s) and/or the program(s)
described in this publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.
Copyrights and Acknowledgments
Licensed Materials - Property of IBM
Copyright IBM Corp. 2006 All Rights Reserved.
US Government Users Restricted Rights - Use, duplication or disclosure
restricted by SGA ADP Schedule Contract with IBM Corp.
Supplemental Copyrights and Acknowledgments
The following Copyrights and Acknowledgments apply to various software
components included in IBM WebSphere Portlet Factory, but neither created
nor owned by IBM.
This offering is based on technology from the Eclipse Project (http://www.eclipse.org/).
This product includes software developed by the Apache Software Foundation
(http://www.apache.org).
Portions of this software provided by JDOM. Copyright (C) 2001 Brett McLaughlin
& Jason Hunter. All rights reserved.
Portions of this software provided by the membership of the XML-DEV mailing
list. You can obtain a copy of the SAX copyright status at http:// www.megginson.com
/SAX/.
The following terms are trademarks of International Business Machines Corporation
in the United States, other countries, or both:
Cloudscape
IBM
Lotus
WebSphere
Workplace