第 17 章 管理 Google 小工具集成

本章介绍如何将 Google 小工具与用户桌面集成。

在桌面启用 Google 小工具

Portal Server 管理员可以授权最终用户将 Google 小工具系统信息库中的小工具添加到其桌面上。本节说明 Google 小工具的功能，并为管理员提供以下指导：

• 获取 Portal Server 的 Google 小工具 API 密钥

• 授权门户最终用户设置 Google 小工具

• 为 2column 社区启用“添加 Google 小工具”链接

Google 小工具系统信息库中的小工具借助 googlegadgetportlet.GoogleGadgetPortlet（一个 JSR 168 包装器 Portlet）运行。该 Portlet 使小工具可以在门户中运行，并使用页面容器服务，例如编辑首选项、仅显示标题栏、在整个页面中显示、在新窗口中显示和删除。

一些小工具可能与 Portal Server 不兼容（例如专门为个性化 Google 主页设计的小工具，或显示 RSS 源的小工具）。小工具由 Google、第三方厂商或用户开发，其性能、质量或内容都没有承诺和保证。

您可在门户页面中以全局级别、组织级别、角色级别或用户级别为基于 JSPTableContainerProvider 和 AJAXTableContainerProvider 的页面容器启用 Google 小工具。

如果 Portal Server 管理员启用在桌面上运行 Google 小工具系统信息库中的小工具，则授权的最终用户可以执行以下操作：

• 将 Google 小工具系统信息库中的数千种小工具添加到门户页面

  最终用户单击“添加小工具”时，会执行以下过程：

  • 向 Portal Server 发出异步请求，从而将所选小工具添加到门户页面。

  • 缩略图和“添加小工具”按钮变为灰色。

• 选择小工具的宽度。可以选择“窄”（默认）或“宽”

• 使用门户的频道编辑界面个性化 Google 小工具

• 从门户页面删除小工具

获取 Portal Server 的 Google 小工具 API 密钥

门户使用 Google 的 AJAX Feed API，其需要 Google API 密钥才能工作。一个 Google API 密钥仅对一个域（例如 foo.com）及其子域（例如 bar.foo.com）有效。

1. 转到 Google AJAX Feed API 的 Google 注册页面。

2. 单击“Sign-up for a Google AJAX API key”（注册取得 Google AJAX API 密钥）链接。

   显示注册页面。

3. 按照所提供的说明执行操作。

4. 单击“Generate API Key”（生成 API 密钥）。

授权门户最终用户设置 Google 小工具

要允许最终用户设置和显示 Google 小工具，您必须设置“API 密钥”属性，并激活“添加 Google 小工具”链接。

1. 登录到管理控制台。

2. 导航至您的门户的“管理容器和频道”这一节。

3. 设置“Google 小工具 API 密钥”定义。

   1. 选择“顶级[[全局]] DN”。

   2. 在左侧框架中单击“GoogleGadgetContainer”。

   3. 在右侧属性表的 apiKey 属性值中，输入您的 Google API 密钥。

   4. 保存更改。

4. 激活“添加 Google 小工具链接”属性。

   1. 导航至以下某项的页面容器编辑页面：

      • 用户 DN

      • 组织 DN

      • 角色 DN

      • 全局 DN

   2. 将 isGoogleGadgetsEnabled 属性值设置为 true。

      这一设置会自动在门户页面上为拥有适当权限的最终用户显示“添加 Google 小工具”链接。这些最终用户可单击“添加 Google 小工具”链接在其页面上添加小工具。

为 2column 社区启用“添加 Google 小工具”链接

1. 打开 /var/opt/SUNWportal/portals/portal1/communitytemplates/2column 下的 XML 模板文件（owner.xml 和 member.xml）。

2. 将布尔属性 isGoogleGadgetsEnabled 添加到容器 (jsptablecontainerprovider) 的 DP，并将值设置为 True。