门户网站工具 - 发行说明


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 Software Architect 的新闻组(论坛)

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 以供合作”主题。

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 中使用个人标记时,应使用以下语法来指定它:

<pa:person value="CN=John Smith,OU=SALES,O=ACME" />John Smith<pa:person>

JSR 168 portlet 不支持个人标记。

2.5 EIS 工具局限性

SAP BAPI 和 RFM SDO 向导局限性:如果向前通过主函数和前后函数页面,并在选取其他主函数之后尝试返回此页面,则前后映射页面就无法正常工作。

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

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 部署回原始门户网站服务器。

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

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

3.0 已知问题

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

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

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

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

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 的内容。

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

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

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

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

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

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

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

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

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

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

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

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

3.10 Rational Software Architect 的新闻组(论坛)

“添加 SDO 运行期”引用 Rational Software Architect 新闻组。将对 Rational Software Architect 支持站点(www.ibm.com/software/awdtools/developer/application/support)进行更新,以包含到新闻组的链接。

返回到主自述文件