门户网站项目支持 WebSphere Portal V5.0.2.2。
使用新建 portlet 向导创建 JSR 168 portlet 时,Rational Developer 将自动指定标识属性。portlet.xml 文件的 <portlet-app/> 元素中应包括标识属性以向服务器唯一标识该 portlet。(此属性对应 IBM portlet API portlet 使用的 UID 属性。)
如果 JSR 168 portlet 在 portlet.xml 中的 <portlet-app/> 元素中没有标识属性,则在将 portlet 导入到工作空间后立即添加标识属性及其唯一值。要添加标识属性,打开 portlet 部署描述符并使用“源代码”视图编辑它。在将 JSR 168 portlet 部署至门户网站服务器或在门户网站项目中使用 JSR 168 portlet 项目后不要更改标识值。
没有标识属性的 JSR 168 portlet 有一些局限性:
- 如果在门户网站项目中使用没有标识属性的 JSR 168 portlet,该门户网站项目将不能在测试环境中运行。
- 如果将两个或多个没有标识属性的 JSR168 portlet 与 WebSphere Portal 5.1 测试环境相关联,则测试环境将无法启动。
- 在将 JSR 168 portlet 部署至门户网站服务器或在门户网站项目中使用 JSR 168 portlet 项目后,不应更改项目名称。
在运行包含关系记录列表或关系记录(SDO)的 portlet 时,可能会在服务器日志中看到以下错误:
[04/10/07 17:57:27:172 JST] 4942fbd0 SystemOut O java.lang.LinkageError:org/eclipse/emf/ecore/EClass 类违反了载入器约束:父代与子代载入器之间的定义不匹配可忽略此错误。
在创建协作源 portlet 时,需要手工将 actionNameParameter 和 name 属性添加至 WSDL 文件。例如:
<portlet:action type="standard" name="myActionName" actionNameParameter="ACTION_NAME"/>在本发行版中,门户网站工具不会在 WSDL 文件中生成 caption 属性。当您使用 WebSphere Portal V5.1 的连线设备时,需要在 WSDL 文件中指定 caption 属性并在资源文件中手工指定 caption 值。例如:
<portlet:param name="orderId" partname="order_id" caption="order.id" />有关更多信息,请参阅 WebSphere Portal 信息中心中的“开发要协作的 portlet”主题。注意:这已经在 V6.0.0.1 中进行了修正。
在 WebSphere Portal V5.1 中的 IBM API 基本 portlet 中使用个人标记时,应使用以下语法来指定它:
<pa:person value="CN=John Smith,OU=SALES,O=ACME" valueType="LDAPDN" displayName="John Smith" />在 WebSphere Portal V5.1 中的 IBM API Faces portlet 中使用个人标记时,应使用以下语法来指定它:
注意:这已经在 V6.0.0.1 中进行了修正。将上面描述的语法用于基本 portlet。<pa:person value="CN=John Smith,OU=SALES,O=ACME" />John Smith<pa:person>
JSR 168 portlet 不支持个人标记。
SAP BAPI 和 RFM SDO 向导局限性:如果提前结束了主函数和前/后函数页面,并且尝试在选择另一主函数后返回该页面,“前/后映射”页面将无法正常工作。
解决方案:如果需要设置新的前后函数映射,必须重新启动该向导。
注意:这已经在 V6.0.0.1 中进行了修正。
在门户网站服务器上测试包含 SAP SDO 的 portlet 之前,必须在 WebSphere Portal 5.1 服务器上配置 SAP JCo 适配器:
- 从 SAP Service Marketplace 中的 SAP 下载 SAP 的 JCo 适配器目录。
- 单击下载软件 > 下载 > SAP 连接器 > SAP Java 连接器。根据您使用的操作系统选择要下载的相应文件。将 ZIP 文件的内容解压缩到本地目录中。
- 根据您所使用的操作系统完成下列步骤。注意:<wps_51> 指的是 WebSphere Portal 5.1 服务器的安装目录;例如,C:\WebSphere\PortalServer51TE。
对于 Windows:
- 将 sapjco.jar 和 sapjcorfc.dll 复制至 <wps_51>\shared\app。
- 将 librfc32.dll 复制至 c:\windows\system32\。
- 必须重新启动 WebSphere Portal 5.1 服务器。
对于 Linux:
- 将 sapjco.jar 和 libsapjcorfc.so 复制至 <wps_51>\shared\app。
- 将包含 librfccm.so 文件的文件夹添加至环境变量 LD_LIBRARY_PATH。
- 必须重新启动 WebSphere Portal 5.1 服务器。
RedHat Enterprise Linux 3.0 的 Rational Developer 内部浏览器不支持协作 portlet。如果需要在 RedHat Enterprise Linux 3.0 中使用协作 portlet,则使用 Netscape Communicator。
要将 Netscape Communicator 用作缺省浏览器,将 Rational Developer 配置为使用外部浏览器。为此,从菜单栏中选择窗口 > 首选项。展开左边的因特网节点并选择 Web 浏览器。在主要部分中,选择除内部 Web 浏览器之外的任意浏览器。
有关更多信息,请参阅 WebSphere Portal 信息中心中的“协作 portlet 的已知问题和限制”主题。
在使用“新建门户网站项目”向导创建门户网站项目或从样本库导入样本门户网站项目时,“问题”视图中出现了断开的链接警告消息。
在此版本的 Rational Developer 中,Portal Designer 仅将 HTML、cHTML 和 WML 作为受支持的标记。如果对导入的项目中的页面或标签指定了其它受支持的标记,它们将保留在 Rational Developer 中;但是,您不能更改这些标记,它们不会显示在“属性”视图中。
在此版本的 Rational Developer 中,只能在 Portal Designer 中设置外部 URL。如果门户网站服务器上有内部 URL,它们将保留在导入的项目中,但不能更改它们。只能将内部 URL 部署回原始门户网站服务器。
注意:这已经在 V6.0.0.1 中进行了修正。
在此版本的 Portal Designer 中,Admin 和 AdminLeftNavigation 主题将显示在“大纲”视图中。但是,这些主题只能用于门户网站管理,并且不应选择它们作为门户网站项目的缺省主题。
注意:这已经在 V6.0.0.1 中进行了修正。
问题:在现有 IBM API portlet 项目中创建新的 portlet 时,如果在“事件处理”页面上选择添加单击激活操作发送方 portlet 样本或添加消息发送方 portlet 样本选项,将显示下列错误消息:
- IWAL0008E portlet 的 servlet 引用不正确。 (portlet.xml)
- CHKJ4014W:类型 servlet 名称的条目是空的。(web.xml)
解决方案:必须使用以下方法重新打开 portlet 项目:
- 右键单击该 portlet 项目并从弹出菜单中选择关闭项目。
- 右键单击该 portlet 项目并从弹出菜单中选择打开项目。
- 右键单击该 portlet 项目并从弹出菜单中选择运行验证。
注意:这已经在 V6.0.0.1 中进行了修正。
问题:不能启动 WebSphere Portal 测试环境。
解决方案:
- 验证成功安装:可能会因为安装期间出现故障而导致此问题。检查 WebSphere Portal 测试环境安装期间出现的问题并在必要时做出修正。
- 消除过长的文件名:因为 portlet 项目文件的文件名过长,所以服务器不能启动。要解决此问题,缩短项目名称、包前缀和/或类前缀,以使生成的文件名长度可以接受。或者,可将各个文件名本身缩短为可以接受的长度。此外,如果使用的是缺省目录作为工作空间,则使用目录名长度较短的另一工作空间也将有效。您可以通过启动 Rational Developer 并在提供的对话框中更改名称来指定工作空间目录。如果用于指定工作空间的对话框未出现,则转至命令提示符并在输入 Rational Developer 执行命令之后输入 -data [workspace_name]。
问题:在 JSR 168 Portlet 部署描述符中,不能在 Portlet 集合区域中编辑 portlet 名称。
解决方案:在“源代码”页面中编辑 portlet 名称。
问题:如果从向导生成的 Faces JSP 文件中删除 <f:view> 标记并在该文件中插入 Faces 组件,则将插入 <f:subview> 标记而不是 <f:view> 标记。对于此类型的 JSP 文件,Faces portlet 将无法正常运行。浏览器上的输入将在服务器端处理时丢失。
问题:要修正此问题,将 JSP 文件中的 <f:subview> 标记替换为 <f:view> 标记。
如果将包含单击激活操作标记的 Faces portlet 最大化,将不显示 portlet 的内容。
注意:这已经在 V6.0.0.1 中进行了修正。
问题:如果未安装门户网站 UTE,则不能创建目标为“localhost”或“127.0.0.1”的门户网站导入、导出和部署服务器。
解决方案:如果需要创建这样的服务器,则使用机器的标准名称而不是“localhost”(示例:myhost.mydomain)。
注意:这已经在 V6.0.0.1 中进行了修正。
问题:如果导入新门户网站项目未完成就取消了导入操作,则不能除去不完整的门户网站项目并且该项目变得不可用。
解决方案:您需要使用“导入门户网站”向导中的删除覆盖内容选项以再次导入门户网站配置和文件。
注意:这已经在 V6.0.0.1 中进行了修正。
问题:将现有门户网站站点从 WebSphere Portal 导入到 Rational Developer 中时,与 WSRP 有关的验证错误将显示在已导入门户网站项目的“问题”视图中。
解决方案:在导入到 Rational Developer 中之前对 WebSphere Portal 应用 APAR PQ95638。
注意:这已经对 WP5.1 进行了修正,但未对 WP5.0 进行修正。
问题:因为编码不正确,所以不能使用 Page Designer 打开已导入门户网站项目中的 license.html 或 privacy.html 文件。
解决方案:对门户网站服务器应用 APAR PQ93681,然后从门户网站服务器重新导入该项目。
注意:这已经对 WP5.1 进行了修正,但未对 WP5.0 进行修正。
“添加 SDO 运行时”引用 Rational Application Developer 新闻组。IBM developerWorks 站点(www.ibm.com/developerworks/forums/dw_forum.jsp?forum=430&cat=24&hideBody=true)中提供了 Rational Application Developer 论坛。