转自http://www.ibm.com/developerworks/cn/lotus/portal-quickrdoc/

概述

IBM Lotus Quickr 是一款基于团队协作和内容管理的软件，它提供了多个开箱即用的功能组件模板，供企业团队成员紧密有效地协同工作。这些组件包括文档库、维基、博客、论坛、团队日历、任务、新闻公告、Feed 阅读器等，而在文档管理是其中功能最为强大的组件。IBM WebSphere Portal 是 IBM 公司推出的一个基于 WebSphere 技术的企业门户解决方案，WebSphere Portal 是一个前端应用集成平台，企业可以将已有应用程序、流程和内容组合到统一的界面中，所有用户都以该平台为统一入口并可以从多种设备访问该门户。目前在 WebSphere Portal 中整合 Lotus Quickr 大概有如下方法：

• 使用 My Places Portlet，My Places Portal 是 IBM 开发的专门用来进行 WebSphere Portal 和 Lotus Quickr 整合的工具，通过配置 SSO，但用户在 Portal 中访问该 Portlet，可以查看到所有具有权限的 Lotus Quickr 场所，而且这些场所会以不同的视图展示给最终用户。
• 使用 Web Application Integrator for IBM WebSphere Portal( 以下缩写为 WAI)，WAI 是 IBM 开发的用来帮助 WebSphere Portal 客户来整合企业 Web 应用的工具。客户可以免费地从 Lotus Solution Catalog 下载。
• 使用 Feed Reader Portlet，订阅 Lotus Quickr 中的内容聚合。
• 根据应用需求，开发 Portlet 来整合 Lotus Quickr 功能。
• 使用 IBM WebSphere Portal Factory builder 调用 Quickr REST 服务，开发 WebSphere Portal 应用。
• 通过配置搜索服务，在 WebSphere Portal 中搜索 Lotus Quickr 内容。

回页首

前提条件

为了您能更好的理解这篇文章中所阐述的内容，您需要具备以下的技能：

• 对 Lotus Quickr Portal 主要功能有基本的了解，如果需要了解 Lotus Quickr Portal 基本功能，请参考文章 IBM Lotus Quickr：利用社会计算提高团队生产力 以及 IBM Lotus Quickr 产品主页。
• 对 IBM WebSphere Portal 开发有一定的了解，如果了解 WebSphere Portlet Factory 对掌握本文中使用 Portlet Factory 整合 Lotus Quickr 部分内容有很好的帮助。

注：为了提供给客户更加灵活的选择，IBM Lotus Quickr 拥有两个基于不同后台的产品，分别是基于 IBM WebSphere Portal 的 Lotus Quickr Portal 和基于 Lotus Domino 的 Lotus Quickr Domino，本文介绍的内容，除了特别说明，都是同时适合两个不同后台 Lotus Quickr。

回页首

使用 My Place Portlet

My Place Portlet 是 IBM 提供的专门用来进行 WepSphere Portal 和 Quickr 整合的一个工具，客户可以在 Lotus Solution Catalog 下载。在进行 My Place Portlet 的安装配置之前，需要提前完成 WebSphere Portal 和 Lotus Quickr 服务器的 SSO 的配置，具体的配置步骤，对于 Quickr Service for Portal 用户请参考 使用 WebSphere Portal 的 RCSS 搜索 Lotus Quickr 中的内容 中 SSO 配置部分，对于 Quickr Service for Domino 用户，请参考 Configuring single sign-on (SSO) between IBM WebSphere Portal and IBM Lotus Domino。

在完成 SSO 的配置之后，按照如下步骤安装配置 My Place Portlet：

1. 以管理员身份登录到 WebSphere Portal 服务器；
2. 点击 管理 > Portlet 管理 >Web 模块；
3. 选择安装，浏览到下载的 My Places Portlet WAR 所在目录，安装 My Places Portlet；
4. 完成安装以后，浏览到 Portlet 管理 >Portlet，输入 My Places Portlet 查找到该 Portlet 进行配置；
5. 点击配置 Portlet 按钮，添加 Portlet 参数： serverList, 该参数对应的值为目标 Quickr 服务器连接，如：http://quickrurl.cn.ibm.com:10038；

回页首

使用 Web Application Integrator for IBM WebSphere Portal，在 Portal 导航中整合 Quickr 界面

WAI 是 IBM 开发的用来帮助 WebSphere Portal 客户来整合企业 Web 应用的工具。客户可以免费地从 Lotus Solution Catalog下载。

使用 WAI 来整合 Quickr 页面，主要包括如下几个步骤：

1. 安装 WAI Portlet，在 Lotus Solution Catalog 下载 WAI 安装包后，解压下载文件，在 Portal Web 管理界面中，安装 WAI Portlet。
2. 创建 Portal URL 界面，创建步骤如下：
   • 以 Portal 管理员身份登录到 Portal；
   • 进入管理 > 门户网站用户解密啊 > 管理页面 > 浏览到需要创建该页面的父页面（比如主页）；
   • 点击新建 URL：
     1. 添加对应页面标题如 Quickr 页面；
     2. 选中指向具有以下 URL 的 Web 页面的链接；
     3. 输入 Quickr URL，如：http://quickrportal.cn.ibm.com:10038/lotus/myquickr；
     4. 保存该页面；
     5. 获得该页面的唯一名称，供下一步使用。
3. 使用 WAI Portlet 产生 HTML <!-- END PORTAL NAVIGATION INTEGRATION -->
   
4. 保存 Default.jsp。
5. 重启 Quickr 服务器。

回页首

使用 Feed Reader Portlet

Feed Reader Portlet 是 Portal 提供的开箱即用的一个功能组件，通过该 Portlet 用户可以订阅 Feed。该 Portlet 同时支持订阅 Feed 的两种格式：ATOM 和 RSS。而在 Lotus Quickr 中，几乎所有的内容都以 ATOM Feed 的方式发布出来，供阅读器订阅。

下面以订阅某个文档库中，我需要审批的文档为例，介绍如何使用 Feed Reader Portlet。

• 获得某文档库中，我的待审批文档 Feed URL
  • 进入该文档库
  • 进入草稿视图 > 待核准的草稿
  • 在界面右边，点击预订此视图，获得带审批文档 Feed URL
• 在 Portal 界面中添加 Feed Reader Portlet 并配置订阅待审批文档链接
  • 创建新页面并将 Feed Reader Portlet 添加到该页面
  • 输入该 Feed URL 并输入相关的认证信息

回页首

开发 Portlet 来整合 Lotus Quickr 功能

Lotus Quickr 提供了丰富的接口，来供客户或合作伙伴开发集成应用。具体关于 Quickr API，请

参阅 developerWorks Lotus 上的文章：IBM Lotus Quickr V8.0 Content Public API 介绍。如果需

了解更多的 Portlet 开发知识，推荐阅读 IBM Developer Works 课程：IBM WebSphere Portal V6.0 Application Development。

接下来，举一客户实际应用的例子供大家参考，在该实例中，使用 Quickr 文档 API 开发

Portlet，实现跨文档库文档审批功能。

由于篇幅有限，本文并不详细介绍该 Portlet 的全部实现细节（将会在后续文章中具体描述），而是指出实现该 Portlet 的关键技术要点，如果有一定的 Portlet 开发技术的开发人员，会很容易理解并开发相似应用。

要实现该功能，主要包括两个部分工作：

1. 获取需要审批的文档列表

   Quickr 提供了相应的 REST 接口，用来获取用户的文档库和该文档库的需要审批的文档。

   获取文档库接口：

   http://主机名/dm/atom/libraries/feed，调用该 URL，可以获得用户所有的文档库信息

   获取某文档库待审批文档接口：

   http://主机名/dm/atom/library/ 文档库 ID /view/ReviewDrafts/feed，调用该 URL，获取该文档库用户待审批文档信息。

2. 对文档进行审批

   在 Quickr 中，对文档的审批主要有两个动作：审批和拒绝，Quickr 提供了相关的 Web Service 接口供调用。关于如何使用该接口，在 developerWorks Lotus 上的文章有详细介绍：IBM Lotus Quickr V8.0 Content Public API 介绍。

除此之外，我们还可以使用一些 Portal 开发工具，调用 Quickr Content Service 接口，来开发相关 Portlet，参阅 developer works 文档 Integrating IBM Lotus Quickr with IBM WebSphere Portal using IBM WebSphere Portlet Factory，学习如何使用 Portlet Factory 开发 Portal 和 Quickr 整合应用。

当然，除了以上说到的集成途径外，比如使用 WebSphere Portal 的远程内容搜索技术，通过配置的方式在 Portal 中搜索 Quickr 的内容，参阅 developer works 文章 使用 WebSphere Portal 的 RCSS 搜索 Lotus Quickr 中的内容。