门户网站工具 - 发行说明


1.0 受支持的软件和规范
2.0 局限性
   2.1 JSR 168 portlet 应具有标识属性
   2.2 关系记录和 Portal V5.1
   2.3 *协作 portlet 局限性
   2.4 *个人标记局限性
   2.5 *EIS 工具局限性
   2.6 在 Websphere Portal Server 上配置 SAP JCo
   2.7 RedHat Enterprise Linux 3.0 上的协作 portlet 局限性
   2.8“问题”视图中显示断开的链接警告消息
   2.9 Portal Designer 中的标记支持
   2.10 *不能设置内部 URL
   2.11 *不要选择 Admin 主题作为缺省值
3.0 已知问题
   3.1 *(创建 servlet)在现有 IBM API portlet 项目中创建 portlet 时发生了不正确的 servlet 引用错误
   3.2(调试和测试 portlet)不能启动 WebSphere Portal 测试环境
   3.3(portlet 部署描述符)使用 JSR 168 Portlet 部署描述符编辑器进行编辑
   3.4 当使用 <f:subview> 而不是 <f:view> 时,Faces portlet 未正常工作。
   3.5 *单击激活操作在最大化的 Faces portlet 中不起作用。
   3.6 *(导入、导出和部署)不能创建目标为“localhost”的导入、导出和部署服务器
   3.7 *(导入门户网站)取消导入操作导致新的门户网站项目不可用
   3.8(导入门户网站)WSRP 相关错误显示在已导入门户网站项目的“问题”视图中
   3.9(定制门户网站)不能打开已导入门户网站项目中的 license.html 和 privacy.html 文件
   3.10 Rational Application Developer 的新闻组(论坛)

1.0 受支持的软件和规范

门户网站项目支持 WebSphere Portal V5.0.2.2。

2.0 局限性

2.1 JSR 168 portlet 应具有标识属性

使用新建 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 有一些局限性:

2.2 关系记录和 Portal V5.1

在运行包含关系记录列表或关系记录(SDO)的 portlet 时,可能会在服务器日志中看到以下错误:

[04/10/07 17:57:27:172 JST] 4942fbd0 SystemOut O java.lang.LinkageError:org/eclipse/emf/ecore/EClass 类违反了载入器约束:父代与子代载入器之间的定义不匹配
可忽略此错误。

2.3 *协作 portlet 局限性

在创建协作源 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 中进行了修正。

2.4 *个人标记局限性

在 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 不支持个人标记。

2.5 *EIS 工具局限性

SAP BAPI 和 RFM SDO 向导局限性:如果提前结束了主函数和前/后函数页面,并且尝试在选择另一主函数后返回该页面,“前/后映射”页面将无法正常工作。

解决方案:如果需要设置新的前后函数映射,必须重新启动该向导。

注意:这已经在 V6.0.0.1 中进行了修正。

2.6 在 WebSphere Portal Server 上配置 SAP JCo

在门户网站服务器上测试包含 SAP SDO 的 portlet 之前,必须在 WebSphere Portal 5.1 服务器上配置 SAP JCo 适配器:

  1. 从 SAP Service Marketplace 中的 SAP 下载 SAP 的 JCo 适配器目录。
  2. 单击下载软件 > 下载 > SAP 连接器 > SAP Java 连接器。根据您使用的操作系统选择要下载的相应文件。将 ZIP 文件的内容解压缩到本地目录中。
  3. 根据您所使用的操作系统完成下列步骤。注意:<wps_51> 指的是 WebSphere Portal 5.1 服务器的安装目录;例如,C:\WebSphere\PortalServer51TE。
      对于 Windows:
    1. 将 sapjco.jar 和 sapjcorfc.dll 复制至 <wps_51>\shared\app。
    2. 将 librfc32.dll 复制至 c:\windows\system32\。
    3. 必须重新启动 WebSphere Portal 5.1 服务器。

      对于 Linux:
    1. 将 sapjco.jar 和 libsapjcorfc.so 复制至 <wps_51>\shared\app。
    2. 将包含 librfccm.so 文件的文件夹添加至环境变量 LD_LIBRARY_PATH。
    3. 必须重新启动 WebSphere Portal 5.1 服务器。

2.7 RedHat Enterprise Linux 3.0 上的协作 portlet 局限性

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 的已知问题和限制”主题。

2.8“问题”视图中显示断开的链接警告消息

在使用“新建门户网站项目”向导创建门户网站项目或从样本库导入样本门户网站项目时,“问题”视图中出现了断开的链接警告消息。

2.9 Portal Designer 中的标记支持

在此版本的 Rational Developer 中,Portal Designer 仅将 HTML、cHTML 和 WML 作为受支持的标记。如果对导入的项目中的页面或标签指定了其它受支持的标记,它们将保留在 Rational Developer 中;但是,您不能更改这些标记,它们不会显示在“属性”视图中。

2.10 *不能设置内部 URL

在此版本的 Rational Developer 中,只能在 Portal Designer 中设置外部 URL。如果门户网站服务器上有内部 URL,它们将保留在导入的项目中,但不能更改它们。只能将内部 URL 部署回原始门户网站服务器。

注意:这已经在 V6.0.0.1 中进行了修正。

2.11 *不要选择 Admin 主题作为缺省值

在此版本的 Portal Designer 中,Admin 和 AdminLeftNavigation 主题将显示在“大纲”视图中。但是,这些主题只能用于门户网站管理,并且不应选择它们作为门户网站项目的缺省主题。

注意:这已经在 V6.0.0.1 中进行了修正。

3.0 已知问题

3.1 *(创建 servlet)在现有 IBM API portlet 项目中创建 portlet 时发生了不正确的 servlet 引用错误

问题:在现有 IBM API portlet 项目中创建新的 portlet 时,如果在“事件处理”页面上选择添加单击激活操作发送方 portlet 样本添加消息发送方 portlet 样本选项,将显示下列错误消息:

解决方案:必须使用以下方法重新打开 portlet 项目:

  1. 右键单击该 portlet 项目并从弹出菜单中选择关闭项目
  2. 右键单击该 portlet 项目并从弹出菜单中选择打开项目
  3. 右键单击该 portlet 项目并从弹出菜单中选择运行验证

注意:这已经在 V6.0.0.1 中进行了修正。

3.2(调试和测试 portlet)不能启动 WebSphere Portal 测试环境

问题:不能启动 WebSphere Portal 测试环境。

解决方案:

3.3(Portlet 部署描述符)使用 JSR 168 Portlet 部署描述符编辑器进行编辑

问题:在 JSR 168 Portlet 部署描述符中,不能在 Portlet 集合区域中编辑 portlet 名称。

解决方案:在“源代码”页面中编辑 portlet 名称。

3.4 当使用 <f:subview> 而不是 <f:view> 时,Faces portlet 未正常工作

问题:如果从向导生成的 Faces JSP 文件中删除 <f:view> 标记并在该文件中插入 Faces 组件,则将插入 <f:subview> 标记而不是 <f:view> 标记。对于此类型的 JSP 文件,Faces portlet 将无法正常运行。浏览器上的输入将在服务器端处理时丢失。

问题:要修正此问题,将 JSP 文件中的 <f:subview> 标记替换为 <f:view> 标记。

3.5 *单击激活操作在最大化的 Faces portlet 中不起作用。

如果将包含单击激活操作标记的 Faces portlet 最大化,将不显示 portlet 的内容。

注意:这已经在 V6.0.0.1 中进行了修正。

3.6 *(导入、导出和部署)不能创建目标为“localhost”的导入、导出和部署服务器

问题:如果未安装门户网站 UTE,则不能创建目标为“localhost”或“127.0.0.1”的门户网站导入、导出和部署服务器。

解决方案:如果需要创建这样的服务器,则使用机器的标准名称而不是“localhost”(示例:myhost.mydomain)。

注意:这已经在 V6.0.0.1 中进行了修正。

3.7 *(导入门户网站)取消导入操作导致新的门户网站项目不可用

问题:如果导入新门户网站项目未完成就取消了导入操作,则不能除去不完整的门户网站项目并且该项目变得不可用。

解决方案:您需要使用“导入门户网站”向导中的删除覆盖内容选项以再次导入门户网站配置和文件。

注意:这已经在 V6.0.0.1 中进行了修正。

3.8(导入门户网站)WSRP 相关错误显示在已导入门户网站项目的“问题”视图中

问题:将现有门户网站站点从 WebSphere Portal 导入到 Rational Developer 中时,与 WSRP 有关的验证错误将显示在已导入门户网站项目的“问题”视图中。

解决方案:在导入到 Rational Developer 中之前对 WebSphere Portal 应用 APAR PQ95638。

注意:这已经对 WP5.1 进行了修正,但未对 WP5.0 进行修正。

3.9(定制门户网站)不能打开已导入门户网站项目中的 license.html 和 privacy.html 文件

问题:因为编码不正确,所以不能使用 Page Designer 打开已导入门户网站项目中的 license.html 或 privacy.html 文件。

解决方案:对门户网站服务器应用 APAR PQ93681,然后从门户网站服务器重新导入该项目。

注意:这已经对 WP5.1 进行了修正,但未对 WP5.0 进行修正。

3.10 Rational Application Developer 的新闻组(论坛)

“添加 SDO 运行时”引用 Rational Application Developer 新闻组。IBM developerWorks 站点(www.ibm.com/developerworks/forums/dw_forum.jsp?forum=430&cat=24&hideBody=true)中提供了 Rational Application Developer 论坛。

返回到主自述文件