|
| |
| Sun Java System Portal Server 6 2005Q4 管理指南 | |
第 9 章
管理 Web Services for Remote Portlets (WSRP) 服务本章介绍如何管理 Sun Java™ System Portal Server Web Services for Remote Portlets (WSRP) 服务。
本章包含以下部分：
WSRP 标准概述WSRP 1.0 是一种 OASIS 标准，它简化了远程应用程序和内容向门户的集成过程。WSRP 标准定义了面向显示的交互式 Web 服务，这些服务具有经过完整定义的通用接口和协议，可用于处理用户交互操作，还可提供适合于门户调解和聚合的演示片段以及公布、查找和绑定此类服务所用的各种约定。
由于 WSRP 接口是定义完善的通用接口，因此所有实现 WSRP 标准的 Web 服务都可插入一切符合 WSRP 标准的门户 – 位于门户端的单个独立于服务的适配器足以集成任何 WSRP 服务。因此，WSRP 对于内容和应用程序提供者而言，就成为他们向运行门户的组织提供其服务的方法，而不需要进行程序设计工作。
有关更多信息，参见 WSRP 1.0 标准：
http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=wsrp
WSRP 1.0 标准在 Portal Server 中的实现包括 WSRP 使用方和 WSRP 生成方。WSRP 生成方实现支持公布 JSR 168 portlet 以供远程 WSRP 使用方使用（有关 JSR 168 portlet 的更多信息，参见第 8 章, “管理 Portal 桌面服务”中的“管理 Portlet”部分）。JSR 168 portlet 在 Portal Server 上进行本地部署。这些 psortlet 可由 WSRP 生成方实例发布。
另一个 Portal Server 通过其 WSRP 使用方可以订阅这些远程 portlet。虽然本地 portlet 可按预期方式为门户提供大部分基本功能，但远程 portlet 让您无需在当前使用的门户服务器上进行本地安装或运行代码即可绑定到多种远程 portlet。
图 9-1 Web Services for Remote Portlets
管理 WSRP 生成方本部分介绍管理 WSRP 生成方所需要执行的任务：
添加 WSRP 生成方实例
- 以管理员身份登录到 Sun Java System Access Manager 管理控制台。
默认情况下，位置窗格中选中“身份管理”；“导航”窗格中选中“组织”。
- 导航到所需组织或子组织，从“查看”菜单中选择“服务”。
所有已创建的组织都会显示在导航窗格中。
- 单击“远程 Portlet (WSRP)”下“WSRP 生成方”旁边的属性箭头。
“WSRP 生成方”属性出现在数据窗格中。
注
根据您的要求和配置，您可以在同一个组织或子组织（甚至是不同的组织或子组织）下创建和启用多个 WSRP 生成方。限制条件是 WSRP 生成方的名称必须在整个 Portal Server 系统中是唯一的。
- 单击“生成方”下的“新建”添加生成方实例。
出现“指定基本参数”页面。
- 输入以下属性的值：
- 如果选择“必须注册”，将会出现“指定注册属性”。可指定下列情况：
- 单击“下一步”。
此时会出现“检索页面”页。
- 检验您提供的信息，然后单击“完成”。
编辑 WSRP 生成方实例
- 以管理员身份登录到 Sun Java System Access Manager 管理控制台。
默认情况下，位置窗格中选中“身份管理”；“导航”窗格中选中“组织”。
- 导航到所需组织或子组织，从“查看”菜单中选择“服务”。
所有已创建的组织都会显示在导航窗格中。
- 单击“远程 Portlet (WSRP)”下“WSRP 生成方”旁边的属性箭头。
“WSRP 生成方”属性出现在数据窗格中。
- 单击要修改的生成方实例旁的“编辑属性”链接。
- 选择“一般属性”选项卡，根据需要修改属性：
- 生成方实例的状态 — 对于活动 WSRP 生成方为“启用”，对于非活动生成方实例为“禁用”。
禁用的生成方实例不接受来自 WSRP 使用方的请求。 默认情况下会禁用 WSRP 生成方直到公布一个或多个 portlet。
- 必须注册 — 如果 WSRP 使用方需要注册，则为选中状态。
- 带内注册 — 如果 WSRP 使用方可以程序化方式向生成方实例注册，则为“支持”。 如果 WSRP 使用方只能通过手动方式（带外）向 WSRP 生成方注册，则为“不支持”。
带内注册允许以程序化方式联络 WSRP 生成方并向其传送注册数据，允许 WSRP 使用方从 WSRP 生成方接收注册句柄。 带外注册要求在 WSRP 使用方管理员和 WSRP 生成方管理员之间通过手动联络（如通过电子邮件或电话），以建立并交换对注册句柄的访问通路。
- 注册验证程序类 — 用于验证注册的 Java 类。 当使用方向生成方注册时，它会传送生成方已在其服务描述中定义的每个注册属性所对应的值。 注册验证程序类供生成方用来验证使用方所发送的值是否适合于该生成方实例。
- 单击“保存”。
- 选择 Portlet 选项卡，修改已部署并且将提供给 WSRP 使用方的 portlet 列表，然后单击“保存”。
- 如果支持注册，请选择“注册属性”选项卡以添加或删除所有 WSRP 使用方在向生成方实例注册时必须提供的属性，然后单击“保存”。
添加 WSRP 使用方注册
通过使用方注册，WSRP 使用方可以向 WSRP 生成方描述其能力。WSRP 使用方将以带外方式（如通过电子邮件或电话）添加。添加使用方注册时输入的信息必须与获取了注册句柄的 WSRP 使用方的功能匹配。使用方注册使 WSRP 生成方可以查看 WSRP 使用方在 WSRP 生成方上创建的辅件（例如 portlet 首选项）。
- 以管理员身份登录到 Sun Java System Access Manager 管理控制台。
默认情况下，位置窗格中选中“身份管理”；“导航”窗格中选中“组织”。
- 导航到所需组织或子组织，从“查看”菜单中选择“服务”。
所有已创建的组织都会显示在导航窗格中。
- 单击“远程 Portlet (WSRP)”下“WSRP 生成方”旁边的属性箭头。
“WSRP 生成方”属性出现在数据窗格中。
- 单击要修改的 WSRP 生成方旁的“编辑属性”链接。
- 选择“使用方注册”选项卡。
- 单击“使用方注册”下的“新建”。
此时会出现“新建使用方注册”页面。
- 根据需要指定基本属性：
- WSRP 使用方的名称。
- 使用方注册的状态 — 对于活动使用方注册为“启用”。 对于非活动使用方为“禁用”。 如果使用方注册无效，生成方将不会接受包括被禁用使用方注册的注册句柄的请求。
- 使用方代理 — 应用程序名称和版本的标识符。
标识符的格式为 productName.majorVersion.minorVersion，如 Sun Java(tm) System Portal Server.6.3
- Method= "get" — 如果 WSRP 使用方以支持 HTML 标记的方式实现了 portlet URL，并且 HTML 标记中含有 method=get 的表单，则为“支持”。否则为“不支持”。
- 单击“下一步”。
如果 WSRP 生成方被配置为要求注册，将出现“指定注册参数”页。
- 指定注册属性的值。
- 单击“下一步”。
此时会出现“检索页面”页。
- 检验您提供的信息，然后单击“完成”。
编辑 WSRP 使用方注册
- 以管理员身份登录到 Sun Java System Access Manager 管理控制台。
默认情况下，位置窗格中选中“身份管理”；“导航”窗格中选中“组织”。
- 导航到所需组织或子组织，从“查看”菜单中选择“服务”。
所有已创建的组织都会显示在导航窗格中。
- 单击“远程 Portlet (WSRP)”下“WSRP 生成方”旁边的属性箭头。
“WSRP 生成方”属性出现在数据窗格中。
- 单击要修改的 WSRP 生成方旁的“编辑属性”链接。
- 选择“使用方注册”选项卡。
- 单击要修改的使用方注册旁的“编辑属性”链接。
此时会出现“编辑使用方注册”页。
- 根据需要修改属性：
- WSRP 使用方的名称。
- 使用方注册的状态（对于活动使用方注册为“启用”，对于非活动使用方注册为“禁用”）。 如果使用方注册无效，生成方将不会接受包括被禁用使用方注册的注册句柄的请求。
- 使用方代理（应用程序名称和版本的标识符）。
标识符的格式为 productName.majorVersion.minorVersion，如 Sun Java(tm) System Portal Server.6.3
- Method= "get"（WSRP 使用方以支持 HTML 标记的方式实现了 portlet URL，并且 HTML 标记中含有 method=get 的表单，则为“支持”。否则为“不支持”）。
- 使用方模式（WSRP 使用方将要管理的模式数组。有关更多信息，参见 WSRP 1.0 规范）。
- 使用方窗口状态（WSRP 使用方将要管理的窗口状态数组。有关更多信息，参见 WSRP 1.0 规范）。
- 使用方用户范围（WSRP 使用方将针对用户环境而处理的值。有关更多信息，参见 WSRP 1.0 规范）。
- 自定义用户概要文件数据（命名用户概要文件扩展名的字符串数组。有关更多信息，参见 WSRP 1.0 规范）。
- 注册属性（注册属性列表。有关更多信息，参见 WSRP 1.0 规范）。
- 单击“保存”。
禁用所有 WSRP 生成方
管理 WSRP 使用方本部分介绍管理 WSRP 使用方所需要执行的任务：
创建远程 Portlet 频道
- 以管理员身份登录到 Sun Java System Access Manager 管理控制台。
默认情况下，位置窗格中选中“身份管理”；“导航”窗格中选中“组织”。
- 导航到所需组织或子组织，从“查看”菜单中选择“服务”。
所有已创建的组织都会显示在导航窗格中。
- 单击“Portal 桌面”服务旁的属性箭头。
此时数据窗格中会出现“Portal 桌面”属性。
- 单击“频道和容器管理”链接。
显示“频道”页面。容器路径位于顶部。已定义的频道出现在列表中。
- 单击“新建远程 (WSRP) 频道”以添加远程频道。
出现“新建频道”页面。
- 从“生成方”列表中选择 WSRP 生成方。
- 从 Portlet 列表中选择远程 portlet。
- 在“频道名称”中键入远程频道的名称。
- 单击“确定”。
编辑 WSRP 使用方的一般属性
添加配置的 WSRP 生成方
- 以管理员身份登录到 Sun Java System Access Manager 管理控制台。
默认情况下，位置窗格中选中“身份管理”；“导航”窗格中选中“组织”。
- 导航到所需组织或子组织，从“查看”菜单中选择“服务”。
所有已创建的组织都会显示在导航窗格中。
- 单击“远程 Portlet (WSRP)”下“WSRP 使用方”旁边的属性箭头。
“WSRP 使用方”属性出现在数据窗格中。
- 单击“配置的生成方”选项卡。
- 单击“生成方”下的“新建”添加配置的 WSRP 生成方。
出现“指定基本参数”页面。
- 指定新配置的 WSRP 生成方的名称，以及所需 WSRP 生成方的 WSDL 所对应的 URL。
- 单击“下一步”。
- 如果所需 WSRP 生成方要求注册并且支持带内注册，请指定 WSRP 使用方是否：
- 单击“下一步”。
- 在“注册属性”中提供请求的信息。
WSRP 生成方可能会要求正在注册的 WSRP 使用方返回密钥的值（或生成方在其服务描述中描述的注册属性，如公司名称或 postal 代码）。如果生成方定义了注册属性，它们将出现在此页中，并且会提供相应的值。
- 单击“下一步”。
此时会出现“检索页面”页。
- 检验您提供的信息，然后单击“完成”。
编辑配置的 WSRP 生成方
- 以管理员身份登录到 Sun Java System Access Manager 管理控制台。
默认情况下，位置窗格中选中“身份管理”；“导航”窗格中选中“组织”。
- 导航到所需组织或子组织，从“查看”菜单中选择“服务”。
所有已创建的组织都会显示在导航窗格中。
- 单击“远程 Portlet (WSRP)”下“WSRP 使用方”旁边的属性箭头。
“WSRP 生成方”属性出现在数据窗格中。
- 单击“配置的生成方”选项卡。
- 单击要修改的已配置 WSRP 生成方旁的“编辑属性”链接。
此时会出现“编辑基本属性”页面。
- 根据需要修改属性：
- 单击“保存”
- 如果有显示，请单击“用户类别与角色映射”链接。
此时会出现“用户类别与角色映射”页面。
- 如果有显示，请将 WSRP 用户类别分配给本地 Access Manager 角色。
- 单击“保存”。
- 如果有显示，请单击“注册属性”链接。
此时会出现“注册属性”页面。
- 根据需要修改注册属性的值。
- 单击“保存”。
禁用所有 WSRP 使用方
编辑标准的用户配置文件映射
Portal Server 将一组标准的最终用户属性作为一种个性化当前用户行为的方式。
指定使用方名称
WSRP 使用方在注册期间将向生成方发送使用方名称。为使用方名称指定的值将被用作默认值，除非在组织或子组织级别为使用方名称另指定一值。
