开发协作 portlet

术语协作 portlet 指的是页面上的各个 portlet 通过共享信息相互交互的能力。门户网站页面上的一个或多个协作 portlet 可以自动对由源 portlet 中操作或事件所触发的源 portlet 中更改作出反应。作为事件目标的 Portlet 可以作出反应,这样将不需要用户在该页面上的其它 portlet 中进行重复更改或操作。这就在页面上的各个 portlet 之间提供了协调且一致的行为,并加强了用户的总体体验。

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

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

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

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

“单击激活操作”支持

“单击激活操作”支持可用于使用 IBM® portlet API 的基本 portlet、Faces portlet 和 Struts portlet。

表 1. “单击激活操作”标记支持(按 portlet 类型分类)
Portlet 类型 WebSphere Portal 5.0.2.x 和 5.1
JSR 168 API IBM portlet API
基本 portlet 不受支持
注: 一般 WebSphere Portal 协作 portlet 功能是受支持的。但是,Rational portlet 工具“单击激活操作”功能不可用。
受支持
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 部署描述符”编辑器
“单击激活操作”输出属性(encodeProperty)图标 “单击激活操作”输出属性(encodeProperty) Page Designer 和“选用板”视图中的 JSP 页面
“单击激活操作”输出属性(encodeProperties)图标 “单击激活操作”输出属性(encodeProperties) Page Designer 和“选用板”视图中的 JSP 页面

JSR 168 协作 portlet

尽管未对 JSR 168 portlet API 启用“单击激活操作”行为,但通过使用永久连接,JSR 168 portlet 项目可在 WebSphere Portal 测试环境中运行并显示协作行为。要启用此功能,遵循下列配置步骤:

  1. 配置本地服务器以测试 portlet 中所述创建 WebSphere Portal 测试环境服务器。
  2. 在“服务器”视图中双击 WebSphere Portal 测试环境以打开服务器配置文件。
  3. 在服务器编辑器中选择门户网站选项卡。
  4. 选择启用基本 portlet 以进行门户网站管理和定制复选框。
  5. 保存服务器配置文件。
  6. 选择项目,单击右键并选择运行 > 在服务器上运行
  7. 单击编辑页面
  8. 选择永久连接并添加最多五个永久连接。有关使用永久连接进行协作行为的详细信息,请参阅 WebSphere Portal 产品文档。单击完成
  9. 您将返回视图方式。将启用样本 portlet 以进行协作。但是,如果重新启动 WebSphere Portal V5.1 测试环境,则必须再次添加永久连接以启用协作。
相关任务
启用现有 portlet 以进行协作
启用协作源
启用协作目标
插入单击激活操作 encodeProperty
插入单击激活操作 encodeProperties
编辑单击激活操作 encodeProperty
编辑单击激活操作 encodeProperties
使用条款 | 反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.