整合Lotus Quickr 8.5 for Domino 与 IBM ECM：配置与最佳实践

Albert Wang, 软件架构师, IBM

Albert Wang 是位于北京的 IBM 中国开发实验室的一位软件架构师，他是实验室的 Lotus Quickr Domino 架构师和技术主管。他撰写了五本计算机编程方面的中文图书，并且已经在国际性会议和学术期刊上发表了 30 多篇论文。

Zheng Fei Guo, 软件工程师, IBM

Zheng Fei Guo 是位于北京的 IBM 中国开发实验室的一位软件工程师，他过去几年一直从事 Lotus Quickr for Domino 的开发工作。他有非常丰富的 Web 2.0 应用和协同软件的开发经验。

Jie Ma, 资深软件工程师, IBM

Jie Ma 是位于北京的 IBM 中国开发实验室的一位软件支持工程师、功能验证测试主管和 Lotus Quickr Enterprise Content Management Integration 团队的 PM/Scrummaster。他也有丰富的敏捷软件开发经验。

Zheng Wei Wang, 软件工程师, IBM

Zheng Wei Wang 是位于北京的 IBM 中国开发实验室的一位软件工程师，他从事 Lotus Quickr for Domino 8.5 开发工作。

简介： IBM Lotus® Quickr® 8.5 for Domino® 增加了整合 IBM® Enterprise Content Management 的功能。在本文中，我们将讨论如何使用这个功能，以及如何配置和使用它的相关功能。本文假定您已经熟悉 Lotus Quickr，并且已经安装了 Lotus Quickr 8.5 for Domino。

简介

IBM Enterprise Content Management Services for Lotus Quickr 使用 Lotus Quickr 技术来整合您的桌面应用与 Enterprise Content Management 知识库。IBM Enterprise Content Management Services 包含 IBM Content Manager Services for Lotus Quickr 和 IBM FileNet Services for Lotus Quickr。

在本文中，我们将 Lotus Quickr 8.5 for Domino 和 Enterprise Content Management 的整合定义为四个特性：

• Enterprise Content Management 文档链接
• 客户库
• Enterprise Content Management 文档发布
• Enterprise Content Management 文档搜索

预配置

Lotus Quickr for Domino 使用一个 XML 文件 qpconfig.xml 进行服务器配置。服务器的 data 目录有一个示例文件（qpconfig_sample.xml），您可以将它作为一个模板使用。

要在 qpconfig.xml 中激活 Enterprise Content Management 整合特性，可以使用如下代码：

在使用 Enterprise Content Management 特性之前，您还必须在 Lotus Domino 服务器上启用多服务器单点登录（推荐使用的是 SSO）或单点服务器会话验证。此外，您还需要配置一个 IBM iNotes® 代理，因为 Lotus Quickr 8.5 for Domino 会用它作为一个 Ajax 代理来访问 Enterprise Content Management 服务器。

配置 SSO

请遵循以下步骤对 IBM WebSphere® Application Server（Enterprise Content Management 服务器）配置 SSO：

1. 从 WebSphere Application Server 上导出 Lightweight Third Party Authentication (LTPA) 密钥，您将使用它来设置 SSO。
2. 可选：在每一个激活 SSO 的 Lotus Quickr 服务器的 Notes.ini 文件中添加下面的设置：
   
   NoWebFileSystemACLs=1

   这一步设置将防止匿名访问 Lotus Domino html 目录下的文件。

3. 为域创建或编辑 Web SSO 配置文档，在服务器文档中为每一个您希望激活 SSO 的 Lotus Quickr 服务器启用服务器中会话认证：
   
   
   1. 使用 IBM Lotus Notes 或 IBM Lotus Domino Administration 客户端打开 Lotus Domino 目录（Names.nsf）。
   2. 选择 Configuration – Servers – All Server Documents。
   3. 选择该服务器的服务器文档，然后单击 Edit Server。
   4. 选择 Ports – Internet Ports – Web，然后启用 name-and-password authentication for the web (HTTP or HTTPS) port。
   5. 选择 Internet Protocols，然后单击 Domino Web Engine 选项卡。
   6. 在 Session authentication 字段中，选择 Multiple Servers (SSO)。
4. 现在要配置 Web SSO：
   
   
   1. 单击窗口顶部的 Create Web 按钮，然后选择 SSO Configuration。
   2. 单击窗口顶部的 Keys，然后选择 Import WebSphere LTPA keys。输入密钥路径和密码。

   图 1 显示了一个示例配置。

   注意：要确认在外部通用 LDAP 服务器的端口号之前加一个反斜杠（/）。

   
   
   图 1. 示例配置
   
   
   
5. 在 Web SSO Configuration 字段中，从关键词列表中选择 LtpaToken（如图 2 所示）；单击 Save 和 Close。
   
   
   
   图 2. 选择 Web SSO 配置
   
   
   
6. 如果 Lotus Domino Web Server Configuration 数据库（domcfg.nsf）不存在，则要先创建它：
   
   
   1. 在 Lotus Domino administration 客户端上，选择 File – Application – New。
   2. 在 New Application 窗口顶部（见图 3）的 Server 字段中，选择运行 Lotus Quickr 的服务器。
   3. 在 Title 字段中，输入一个描述性标题，例如 “Web Server Configuration”。
   4. 在 File 字段中，输入 domcfg.nsf。（这是必需的文件名）。
   5. 在 “Specify Template” 部分的 Server 字段中，选择任意服务器，然后选中（置入选中标记）Show advanced templates 选项。
   6. 对于 Template，选择 Domino Web Server Configuration (domcfg5.ntf)；单击 OK。
   
   
   图 3. 创建 Domino Web Server Configuration 数据库
   
   
   
7. 在 Lotus Domino Web Server Configuration 数据库中创建一个映射表单，从而激活 Lotus Quickr 的 SSO：
   
   
   1. 打开 Web Server Configuration 数据库（domcfg.nsf），然后单击 Add Mapping。
   2. 在 Applies To 字段中，选择 All Web Sites/Entire Server（默认值）或 Specific Web Site/Virtual Server。如果您选择了 Specific Web Site/Virtual Server，那么会有一个新字段显示，您要在该字段中输入网站文档或虚拟服务器的 IP 地址。
   3. 在 target database 中，输入 LotusQuickr/resources.nsf，替换其默认值。这个路径在 UNIX® 操作系统中是区分大小写的。如果您是从先前版本升级上来的，并且没有修改根目录名，那么输入 QuickPlace/resources.nsf。
   4. 在 target form. 中，输入 QuickPlaceLoginForm，然后单击 Save 和 Close。
   5. 将数据库复制到所有使用 SSO 的 Lotus Quickr 服务器上。
8. 要启用和更新 qpconfig.xml 的 LDAP 设置来同步 Lotus Domino SSO 配置文档中定义的外部 LDAP 服务器配置，您需要使用清单 1 所示的代码：
   
   
   
   清单 1. LDAP 设置代码
   

   <!-- ou=groups,o=ibm --&gt objectClasspersoncncngivennamesnmailtelephoneNumbermanagergroupOfuniqueNamescncnUniquemembersn, givennamedn50 last name, first name) ]]> sn

   
   
9. 在复制了 Lotus Domino Web Server Configuration 数据库之后，您需要在每一个服务器的服务器控制台上使用命令 restart server 重新启动这个服务器。如果您在控制台上看到 Successfully loaded Web SSO Configuration 这一消息，那么表示您已成功地在 Lotus Quickr for Lotus Domino 服务器上配置了 SSO。
10. 以管理员身份登录 Lotus Quickr for Domino，然后设置与 SSO 配置文档相同的 LDAP 服务器（见图 4）。这样，激活 SSO 的 WebSphere Application Server 就可以使用了。
    
    
    
    图 4. Lotus Quickr for Domino 服务器的 Change User Directory 窗口
    
    
    

单点服务器会话认证

要配置单点服务器会话认证，您需要导出或导入密钥（所以步骤 1 和步骤 6 是不需要的）。您只需要在步骤 3 的 Session authentication 字段中选择 Single Server。

现在，您再重新启动 Lotus Domino 服务器（和步骤 9 一样）时，将不会看到 Successfully loaded Web SSO Configuration 消息。同样，在修改用户目录（步骤 10）时，要在用户目录 Type 字段中选择 Domino Server。

同样，即使 Enterprise Content Management 特性支持 SSO 或单点服务器会话认证，SSO 仍然是更好的方法。

配置 iNotes 代理

根据以下步骤配置 iNotes 代理：

1. 打开 Names.nsf 数据库，从左边导航面板中选择 Policies，然后单击顶部的 Add Policy 按钮创建一个 Policy 文档。
2. 在 Polity 名称字段中输入 */* 或 *，在 Policy type 字段中选择 Organizational，然后单击 Security 字段右边的 New 按钮（见图 5）。
   
   
   
   图 5. Policy 文档
   
   
   
3. 在新的 Security Settings 文档中单击 Proxies 选项卡（见图 6），然后单击 Edit list 按钮。
   
   图 6. 安全性设置文档
   
   
   
4. 将您的 Enterprise Content Management 服务器添加到 “White-list rule to add or modify” 窗口，然后单击 OK（见图 7）：
   
   policy0.url=http://ecmserver01.cn.ibm.com:9080/
   policy0.context=/xsp/proxy/BasicProxy/
   policy0.actions=GET,POST,HEAD,PUT,DELETE
   policy0.cookies=*
   policy0.headers=*
   policy0.mime-types=*
   
   
   policy1.url=http://ecmserver2.cn.ibm.com:9080/
   policy1.context=/xsp/proxy/BasicProxy/
   policy1.actions=GET,POST,HEAD,PUT,DELETE
   policy1.cookies=*
   policy1.headers=*
   policy1.mime-types=*
   
   
   图 7. Modify white-list rule 窗口
   
   
   
5. 将 Policy 文档的 Security 字段设置为 security（最新创建的 Security 文档）。
6. 保存所有修改并重新启动服务器。

Enterprise Content Management 整合特性

现在让我们来讨论整合特性。

创建 Enterprise Content Management 文档链接

您可以通过创建一个链接页面来创建一个指向 Enterprise Content Management 知识库中一个文档的链接（见图 8）。

图 8. Create New Link Page 窗口

您可以在图 8 中看到，当您单击 Insert Link 按钮时会显示两个选项：File Download 和 Summary Page。如果您选择 File Download，那么所创建的就是一个指向文档下载的链接；如果您选择 Summary Page，那么所插入的是一个指向文档的 Enterprise Content Management Web UI 的链接。

您也可以通过单击 URL 图标创建指向 Enterprise Content Management 知识库中一个文档的链接，然后在创建或编辑页面的富文本编辑器上选择 Insert Link to External Document。

在 Enterprise Content Management Web UI 中，您可以看到文档的基本信息，包括标题、作者和创建日期；然而，Enterprise Content Management 服务器端必须支持 Enterprise Content Management Web UI。

对于 FileNet，在它安装之后，它总是会运行一个支持 Enterprise Content Management Web UI 的默认应用程序。

对于 Content Manager Services，您应该要安装一个额外的应用程序，如 IBM WEB Interface (WEBi)；否则，当您选择 Summary Page 时，它也会插入一个指向文档下载的链接。

Enterprise Content 搜索

您可以使用 Enterprise 搜索来搜索存储在 Enterprise Content Management 知识库中的文档。为此，您可以采取以下步骤：

1. 在 qpconfig.xml 中设置目标 Enterprise Content Management 知识库，启用搜索功能，如下所示：
2. 从搜索输入框的下拉菜单中选择 Enterprise Content，输入您想要搜索的关键词；然后 Enterprise Content Search 窗口就会显示（见图 9）。
   
   
   
   图 9. Enterprise Content Search 窗口
   
   
   

其中，高级搜索中有四个搜索参数：

• 搜索范围
• 文档类型
• 日期
• 用户

如果您在搜索结果中单击用户名，那么它会根据这个用户名进行搜索，然后您可以组合这四个搜索参数进行高级搜索。

您还可以执行以下搜索：

• 搜索所有企业文档（All Enterprise Documents），我的企业文档（My Enterprise Documents）和我检出的文档（My Checked out Documents）
• 搜索某个特定文档类型的文档。
• 选择开始日期和结束日期来搜索在指定时间内最后修改过的文档。

文档发布

您在 Lotus Quickr 上将一个文档或页面发布到 Enterprise Content Management 服务器。默认的 Publish Web UI（也称为 Publish wizard）有两个 Publish to External Location 窗口。第一个是 Select Location，用于选择发布目标位置（见图 10）。

图 10. Select Location 窗口

第二个窗口是 Select Publish Option，您可以选择如何处理所发布的文档或页面（见图 11）。如果配置了元数据（属性）映射，您也会看到一个 Metadata Mapping 窗口，您可以在窗口中编辑元数据值。

图 11. Select Publish Option 窗口

使用 qpconfig.xml，您也可以定制 Publish Web UI，如表 1 所示。

表 1. qpconfig.xml 的文档发布配置元素

元素	描述
http://lwptsthink47.cn.ibm.com:9080 /targetHost>	默认 Enterprise Content Management 服务器的 URL。
/QuickrRoot/ QKSmokeApplication/QKSmokeLibrary	默认 Enterprise Content Management 服务器的默认库的路径。
/Test/	默认 Enterprise Content Management 服务器的默认文档发布目标文件夹。
link	默认发布操作（复制、移动和链接）。
	如果所启用属性的值是 false，那么用户就无法在 Publish wizard 中输入服务器 URL。只有 Server 字段被读取，它的值是默认的 Enterprise Content Management 服务器（targetHost）的 URL：
	如果所启用属性的值是 true，那么 Select Location 窗口就会被略过。这样文档就会被发布到默认 Enterprise Content Management 服务器（targetHost）的默认库（targetLibrary）的默认文件夹（targetFolder）。
	如果所启用的属性值是 true，那么 Select Publish Option 窗口就会被略过。这样，文档发布会使用默认发布操作（setDefaultOperation）作为它的参数。

forceDefaultPublishLocation 和 forceDefaultOperation 参数可以通过组合实现不同的 Publish Web UI，如表 2 所示。

表 2. 组合的元素及其输出

元素名：forceDefaultPublishLocation	元素名：forceDefaultOperation	输出
True	True	Publish wizard 不会显示。当您单击文档快捷菜单的 Publish To，发布操作会使用预配置的默认发布位置和默认操作。
True	False	Publish wizard 会显示，但是 Select Location 会被略过。向导首先显示的是 Required Properties 窗口，然后是 Publish Options 窗口，在这个窗口中发布操作会被设置为 setDefaultOperation 参数的值。
False	True	Publish wizard 会显示，但是 Publish Options 窗口会被略过。因此，向导是从 Select Location 窗口开始的，在用户指定目标服务器和目标文件夹后，在下一个窗口输入所有必要的属性，然后出现的是 Publish 按钮，而不是 Next 按钮，其中 setDefaultOperation 的值将用于确定所使用的发布选项。
False	False	Publish wizard 会显示默认的行为。虽然 setDefaultOperation 的值决定了默认发布操作使用哪个发布选项，但是用户可以输入任意位置，然后选择任意发布选项。

配置元数据映射

在 Lotus Quickr for Domino 中，您可以定制表单及其字段。这里有一个处理文档类型的表单，您可以用定制的表单创建一个文档。

图 12 所示的是 Lotus Quickr 和 Enterprise Content Management 之间的元数据映射，我们将一个表单映射到一个文档类型，其中 F 是字段，PST 是属性单类型，P 是属性。然后，当您发布一个根据这个表单创建的 Lotus Quickr 文档时，Lotus Quickr 会使用所映射的文档类型创建一个 Enterprise Content Management 文档，而属性的值是所映射字段的值。

图 12. 映射到 Enterprise Content Management 文档类型的 Lotus Quickr 表单

Lotus Quickr for Domino 中有两种类型的文档：Page 和 Document。在进行元数据映射之前，您应该要理解它们之间的区别：如果文档是 Single Attachment 字段，而不是 Rich Text 字段，那么它就是一个 Document；否则，它就是一个 Page。

在定制一个表单时（见图 13），如果您添加了一个 Single Attachment 而不是 Rich Text 字段，那么根据这个表单创建的文档就是一个 Document。我们可以将这种表单称为 “Document Form”，而其他的表单则称为 “Page Form”。

图 13. Customize form. 窗口

在 Lotus Quickr 8.5 for Domino web UI 中，如果您上传或导入一个文件，它就是一个 Document；而其他的则都是 Page，如页面、链接、论坛主题和回复、评论、清单项等等。

在 Enterprise Content Management 服务器端，您可以根据 Enterprise Content Management 知识库中的一些文档类型创建一个 Page。但不是所有文档类型都支持 Page，不过所有支持 Page 的文档类型都支持 Document。

将一个 Document Form. 映射到一个支持 Page 文档类型是可以实现的，但是如果您尝试将一个 Page Form. 映射到一个不支持 Page 的文档类型，那么就会出错。

表 3 列出了 Lotus Quickr for Domino 所支持的元数据映射类型。

表 3. 映射类型及其描述

映射类型	描述
显式映射	在 Enterprise Content Management 服务器端显式地配置表单与文档类型的映射、字段与属性的映射。
半显式映射	在 Enterprise Content Management 服务器端显式地配置表单与文档类型的映射，但是不显式配置字段与属性的映射。如果 Lotus Quickr 中字段的名称与属性名相匹配，那么它们就是显式映射的。
N 个字段对应 1 个属性的映射	多个字段映射到一个属性（这是显式映射的一个子类）。这个字段的名称必须由空格分开。

执行以下的步骤来使用元数据映射：

1. 在 Lotus Quickr 中定制一个 DemoForm，添加一个 Plain Text 字段、一个 Data Pop-up 字段和一个 Attachments 字段。
2. 配置 qpconfig.xml，应用这三种映射类型之一。您可以运行 qptool 来产生映射表：
   
   load qptool execute -i input.xml -o output.xml 其中 input.xml 的内容如清单 2 所示。
   
   
   
   清单 2. input.xml 的代码
   

   <?xml version="1.0"?> QDServer.cn.ibm.comdemomapping

   
   
3. 将 hostname 修改为您的实际 Lotus Quickr 服务器的主机名，并将名称修改为您的位置名。所生成的初步映射即 output.xml（见清单 3）。
   
   
   
   清单 3. 初步映射
   
   
4. 将初步映射复制并粘贴到 qpconfig.xml。然后您可以进行修改，以设置不同的映射类型，如清单 4-6 所示：
   
   
   
   清单 4. 显式映射
   
   
   
   清单 5. 半显式映射
   
   
   
   清单 6. N 个字段到 1 个属性的映射
   
   

   注意：当把多个字段映射到一个属性时，这个属性只能是 String 类型。

5. 从 DemoForm. 创建一个 Page，在它的快捷菜单或 Page 视图中选择 Publish。您现在可以在 Publish wizard 中看到 Edit Document Properties 视图。填写完成这些属性的值，然后将它发布到 Enterprise Content Management 知识库中。

定制库

您可以通过定制库直接与 Enterprise Content Management 服务器连接。您可以采取与您的 Lotus Quickr 库一样的方式访问和处理 Enterprise Content Management 知识库的内容。您也可以在 Lotus Quickr web UI 中查看、上传、检出、检入和更新 Enterprise Content Management 服务器的文档。

您可以根据下面的步骤来使用定制库：

1. 选择 Place Actions – New page – Custom Library 或 Library – New – Custom Library 创建一个定制库。定制库有与 Document 一样的属性，包括名称、描述、访问控制和位置（见图 14）。
   
   
   
   图 14. New Custom Library 窗口
   
   
   
2. 打开最新创建的定制库页面，单击 Configure 链接，或者选择 More Actions – Configure，进行定制库的配置。
3. 在 Connect to a Library or Folder 选项卡中，在 Server 字段中输入 Enterprise Content Management 服务器 URL，选择 Log in with my current credentials 字段，然后选择 Enterprise Content Management 服务器的一个文件夹或子文件夹作为您的定制库的根目录。
   
   

   如果您想要使用另一个帐户来登录 Enterprise Content Management 服务器，那么您只需要取消选中 Log in with my current credentials 复选框，然后输入帐户名和密码。

4. 单击定制库的 Configure Default View 选项卡，配置显示的列数。单击 OK 保存您的配置。

现在您可以看到 Enterprise Content Management 服务器的内容了，与您的 Lotus Quickr 库一样，您可以执行以下操作：

• 以详细或简明的模式查看定制库
• 使用默认或定制的文档类型上传文件
• 创建、重命名或删除文档
• 查看、替换、编辑属性，检出、检入、删除和下载文档
• 创建、重命名和删除文件夹
• 切换 Enterprise Content Management 服务器所提供的视图

结束语

您现在应该已经详细了解了 Lotus Quickr for Domino Enterprise Content Management 整合的特性了。我们向您介绍了它的所有主要组件，它们的功能以及功能的使用方法。我们希望您在阅读本文之后能够利用 Lotus Quickr for Domino Enterprise Content Management 整合的强大功能来简化您的工作。

原文链：http://www.ibm.com/developerworks/cn/lotus/quickr85-ecm/index.html

来自 “ ITPUB博客 ” ，链接：http://blog.itpub.net/14751907/viewspace-675775/，如需转载，请注明出处，否则将追究法律责任。

转载于:http://blog.itpub.net/14751907/viewspace-675775/