开发协作 portlet

协作 portlet 是指页面上的各个 portlet 之间通过共享信息来进行交互的能力。门户网站页面上的一个或多个协作 portlet 可以对源 portlet 中发生的更改自动作出反应,而这些更改是由源 portlet 中的操作或事件触发的。作为事件目标的 Portlet 会自动作出反应,因此,用户就不需要在该页面上的其它 portlet 中进行重复更改或操作。这样,页面上的各个 portlet 之间就能够保持协调一致的行为,用户使用起来也会觉得很方便。

协作 portlet 提供了这样一种模型:通过使用 WebSphere® Portal 属性代理来声明、发布以及互相共享信息。Portlet 通过发布类型化数据项或属性(Portlet 可作为提供者或接收方来共享这些信息)来预订代理。

协作 portlet 可以是源 portlet 和/或目标 portlet。

用户从源 portlet 上的图标启动“单击激活操作”事件。请注意,虽然可以通过各种方法来实现协作 portlet,但是,“单击激活操作”是 Rational® Developer 工具界面支持的一项独特技术。该图标表示包含操作的目标列表的弹出菜单。在用户选择特定目标之后,属性代理就会通过相应的 portlet 操作将数据传递给目标。

使用“单击激活操作”传递方法,用户只需进行单击就可以将数据从源 portlet 传送至一个或多个目标 portlet,从而导致目标对该操作作出反应并显示带有结果的新视图。用户还可以将属性广播给页面上已声明与相匹配输入属性关联的操作的所有 portlet。

“单击激活操作”支持

“单击激活操作”支持可用于基本 portlet、Faces portlet 和 Struts portlet,如下所示:

表 1. “单击激活操作”标记支持(按 portlet 类型分类)
Portlet 类型 WebSphere Portal 5.0.2.2 和 5.1
JSR 168 API IBM® portlet API
基本 portlet 不受支持。
注: 基于 WebSphere 属性代理的一般 WebSphere Portal 协作 portlet 功能在 V5.1 中是受支持的。
受支持
Faces portlet 受支持
Struts portlet 受支持

当包括 <c2a:encodeProperty> 标记和 <hx:pagerDelux> 标记或 <hx:pagerWeb> 标记的 Faces JSP 页面中包括单击激活操作 portlet 时,该 portlet 不会与 WebSphere Portal 或 WebSphere Portal 测试环境的分页控件功能一起工作。要在 Faces JSP 页面中同时使用单击激活操作和数据表的分页控件功能,使用 <hx:pagerSimple> 标记或 <hx:pagerGoto> 标记(而不使用 <hx:pagerDelux> 标记或 <hx:pagerWeb> 标记)。

协作 portlet 图标

表 2. “项目资源管理器”视图、“选用板”视图和 Page Designer 中的协作 Portlet 图标
图标 描述 出现位置
“单击激活操作”源 Portlet 图标 协作源 portlet “项目资源管理器”视图和“Portlet 部署描述符”编辑器
“单击激活操作”目标 Portlet 图标 协作目标 Portlet “项目资源管理器”视图和“Portlet 部署描述符”编辑器
“单击激活操作”源 Portlet 和目标 Portlet 图标 协作源 Portlet 和目标 Portlet “项目资源管理器”视图和“Portlet 部署描述符”编辑器
“单击激活操作”输出属性(encodeProperty)图标 “单击激活操作”输出属性(encodeProperty) Page Designer 和“选用板”视图中的 JSP 页面
“单击激活操作”输出属性(encodeProperties)图标 “单击激活操作”输出属性(encodeProperties) Page Designer 和“选用板”视图中的 JSP 页面

永久连接支持

永久连接是这样一种技术:用于连接各协作 portlet,以便源 portlet 中发生的更改会自动更新目标 portlet,而不需要进行任何用户交互。永久连接用来自动将属性传送至目标 portlet,而不提示“单击激活操作”菜单。

门户网站工具提供的基本永久连接功能同时支持 WebSphere Portal V5.1 的 IBM API portlet 和 JSR 168 portlet。这些功能与 WebSphere Portal 5.1 中的“Portlet 永久连接工具”提供的那些功能相同。

此产品中的 portlet 永久连接存在下列一般局限性:
  • 仅支持对同一页面上的各个 portlet 进行永久连接(WebSphere Portal 5.1 不支持交叉页面永久连接)。
  • 仅支持进行同一 API 永久连接(WebSphere Portal 5.1 不支持 IBM API 至 JSR 168 API 的永久连接)。
  • 仅支持全局永久连接。不支持个人永久连接(个人永久连接使您能够配置特定于用户的永久连接)。
相关概念
永久连接协作 portlet
相关任务
启用现有 portlet 以进行协作
启用协作源
启用协作目标
插入单击激活操作 encodeProperty
插入单击激活操作 encodeProperties
编辑单击激活操作 encodeProperty
编辑单击激活操作 encodeProperties

(C) Copyright IBM Corporation 2002, 2005. All Rights Reserved.