简介： LQCI（Lotus Quickr Content Integrator）是由 IBM Lotus Quickr 提供的一款中间件产品，它可以帮助用户把数据从现有的存储平台轻松迁移到 Lotus Quickr 的团队场所中，进而体验协作带来的便利。本文将会简要介绍这个工具，并介绍它所提供的主要功能和支持的存储平台等，然后以一个实例来详细介绍如何将数据从 Domino Team Room 导入到 Lotus Quickr 的团队场所中，这将帮助用户了解整个数据迁移的过程，以及一些使用技巧等。

简介

Lotus Quickr Content Integrator（以下简称 LQCI）是由 IBM Lotus Quickr 提供的一款中间件产品，它可以帮助用户把数据从现有的存储平台轻松迁移到 Lotus Quickr 的团队场所中，进而体验协作带来的便利。

本文将会简要介绍一下这个工具，以及它所提供的主要功能和支持的存储平台等，然后以一个实例来详细介绍如何将数据从 Domino Team Room 导入到 Lotus Quickr 的团队场所中，这将帮助用户了解整个数据迁移的过程，以及一些使用技巧等。

产品介绍

LQCI 是专门为 IBM Lotus Quickr services for Lotus Domino（以下简称 Quickr）设计开发的一款用于数据集成与迁移的工具。它采用了向导式的管理方式，并提供了一系列开箱即用的配置模版，可以让管理员快速方便的完成数据迁移，从而得到单一的、易于使用的协作式环境。目前 LQCI 支持下面四种数据源平台：

• Microsoft SharePoint
• Microsoft Exchange
• Lotus Domino Team Rooms
• Lotus Domino Document Manager

也可以通过下面的示意图了解 LQCI 支持的各种数据源平台：

组件及功能介绍

在 LQCI 安装完成后，我们可以看到下面几个组件：

• Composer – 是一个基于向导的图形化应用开发环境，它是 LQCI 的一个极为重要的组件。管理员可以使用它来配置和管理各种数据源的连接信息、数据映射关系以及数据转换的规则等。
• Server Manager – 是一个图形化的服务器管理工具，管理员可以使用它来查看和管理 LQCI 服务器的日志、行为以及行为的历史信息等。

在使用 LQCI 进行数据迁移时，最关键的一步是创建作业，这个过程是采用向导方式完成的。LQCI 提供的作业类型主要有下面两种：

• Replication – 用来定期执行两个数据源之间的数据同步，这种复制操作即可以是单向的也可以是双向的，它可以完成对数据的插入、更新或者是删除等操作。
• Import/Export – 与 Replication 操作类似，用于实现数据的导入与导出，但它不能同步数据源。

LQCI 要求在创建作业前首先要创建好作业组件，这些作业组件把诸如数据源连接信息、数据转换规则等提取出来，单独管理，每个作业可以选择使用这些作业组件，这样就简化了创建作业的过程，这也使得部分配置信息得到重用。常用的 LQCI 作业组件包括：

• Connection – Connection 组件用来保存数据源的连接信息，它是每个 LQCI 应用的核心，是必选组件，所以一般情况下应该最先创建。
• Data Transformation – 它提供了一种可以当数据移入或移出数据源时改变数据的途径。例如在一个 Lotus Notes/Domino 应用的数据库中，订单状态的值可能是“Open”，“Closed”，“Cancelled”，但导入到 Quickr 中需要变换成“1”，“2”，“3”。这个时候 Data transformations 就可以完成这种数据转换的工作。

实例场景

下面我们将通过一个实例来讲述如何使用 LQCI 将数据从 Lotus Domino Team Room 迁移到 Lotus Quickr 的全过程，通过这个实例读者可以掌握：

• 如何创建一个 Connection。
• 如何创建一个 Data Transformation。
• 如何创建一个 Replication 作业。
• 如何在两个数据源间建立字段的映射关系。

假定我们有两台服务器分别是：Server1 和 Server2，下面是它们的用途描述：

• Server1 上装有 Domino 8.5，上面运行着一个名为“Quickr Team”的 Team Room，里面存放了团队成员创建的文档。
• Server2 上装有 Domino/Notes 8.5 和 Quickr 8.2，上面创建了一个名为“Quickr Place”的团队场所，它将用于保存从 Server1 上的“Quickr Team”导出的文档。

下面我们将一步一步的完成数据从 Server1 到 Server2 的迁移工作。

实例详解

步骤一 : 安装 LQCI

为了简便，我们不再为 LQCI 提供一台独立的服务器，而是将它安装在 Server2（也就是 Quickr Server）上，双击 LQCI 的安装包开始安装：

注意：在“System Catalog Configuration”页面中，可以选择是否安装 LQCI 提供的模版，对于第一次使用的用户，我们建议安装模版，所以选择“Configure SAMPLES System catalog”。

步骤二 : 创建 Connection

1. 首先创建对数据源的 Connection：

   在 Server2 上选择 开始 -> 所有程序 -> Lotus Quickr Content Integrator -> Composer，打开 LQCI Composer 组件，其界面如下图所示：

   
   
   图 4. LQCI Composer 组件
    
   
   

   现在开始创建对“Quickr Team” Team Room 的 Connection，从菜单栏选择 Create -> Component -> Connection，在弹出窗口中输入如下信息：

   
   
   

   Items	Value
   Connection Name	Quickr Team Room
   Category	Lotus Quickr Content Integrator for Domino Team Room
   Connection	Lotus Notes/Domino
   Server	Team Room 所在服务器的主机名（如：Server1.ibm.com）
   Database	Team Room 数据库名（如：QuickrTeam.nsf）
   ID File	当前机器上 Notes 客户端所使用的 ID 文件的密码（该 ID 对应的用户应该有权限打开 Quickr Team Room）

   
   
   
   

   填写完毕的 Connection 对话框如下，点击“OK”按钮保存这些信息：

   
   
   图 5. 对“Quickr Team” Team Room 的 Connection
    
   
   
2. 创建对目标场所的 Connection：

   然后我们创建对“Quickr Place”团队场所的 Connection，同样从菜单栏选择 Create > Component > Connection，在弹出窗口中输入如下信息：

   
   
   

   Items	Value
   Connection Name	Quickr Team Place
   Category	Lotus Quickr Content Integrator for Domino Team Room
   Connection	Quickr services for Domino
   Quickr Server	Quickr 所在服务器的主机名（如：Server2.ibm.com）
   Quickr Place\Room	要导入数据的场所名称（点击“…”按钮进行选择，如：QuickrPlace）
   ID File	当前机器上 Notes 客户端所使用的 ID 文件的密码（该 ID 对应的用户应该有权限访问 Quickr Team Place，这可以通过配置 Quickr 来实现）

   
   
   
   

   点击“Quickr Place\Room”旁边的“…”按钮，这时会弹出一个新的窗口要求选择要导入数据的场所名称，我们在“Relative path”一栏中输入“LotusQuickr”，然后点击“Refresh”按钮，所有的可用场所都会列出来，选择目标场所，然后点击“OK”按钮，示意图如下：

   
   
   图 6. 选择目标场所
    
   
   

   填写完毕的 Connection 对话框如下，点击“OK”按钮保存这些信息：

   
   
   图 7. 对“Quickr Place”团队场所的 Connection
    
   
   

步骤三 : 创建 Replication 作业

从菜单栏选择 Ceate -> Replication，这时会弹出一个向导窗口来引导我们完成创建 Replication 作业。

1. 向导第一步是设置数据源信息，我们首先在 Connection 部分选择刚才创建的“Quickr Team Room”Connection，这时“Form/View”部分的内容会自动更新，列出所有当前数据库中可用的表单和视图。我们选择“MainTopic”表单，因为我们的目标是把 Team Room 中所有根据“MainTopic”表单创建出来的文档都导入到 Quickr 中。示意图如下： 
   
   图 8. 设置数据源信息
    
   
   
2. 第二步是设置目标场所信息，我们首先在 Connection 部分选择刚才创建的“Quickr Team Place”Connection，这时“Quickr Form/Page Type”部分的内容会自动更新，列出所有目标场所中的文件夹及文档类型，它们以“文件夹 . 文档类型”格式表示。这里我们选择“Library.Page”，原因是我们想把所有导入的文档都存放到 Quickr 的 Library 文件夹中，并转换成 Quickr 中的 Page 这种文档类型。示意图如下： 
   
   图 9. 设置目标场所信息
    
   
   
3. 第三步是选择 Replication 的行为，在这里我们有两种选择：“One way replication”和“Two way replication”（即“单向的”和“双向的”），也就是说数据可以实现从数据源到目标场所的单向迁移，也可以实现两边数据的同步复制更新。针对这个例子，我们选择“单向的”即可。
4. 第四步是创建字段对应关系，它是数据迁移过程中最关键的一步，因为只有当两个平台的数据字段进行了良好的匹配，导过来的数据才能在 Quickr 中正常显示。点击对话框中的“Column Mapping”按钮，开始设置字段对应关系。这时会有一个提示框弹出，问你是否需要让 Composer 按名称来自动完成字段的匹配？这里我们选择“是”按钮，后面我们会在自动匹配的基础上对字段对应关系做进一步的修改。 
   
   图 10. 创建字段对应关系
    
   
   

   在字段对应关系设置窗口中，一共有六个标签页，分别是“Basic”、“Rich Text”、“Attachment”、“Internal”、“Permissions”和“All”，它们对不同类型的字段进行了分类，我们需要分别对它们进行设置。

   • 打开“Basic”标签页，在这里我们可以对那些基本类型的字段进行映射，如文本类型、日期时间类型的字段。如下图所示，对话框中共有三个列表选择框，左侧的是来自数据源“MainTopic”表单中的字段，右侧的是目标场所中的 Page 所提供的字段。我们从左侧列表框中选中“Subject”（也就是文档在 Team Room 中的标题字段），在右侧列表框中选中“Title”（也就是迁移过来的文档在 Quickr 场所中对应的标题字段），然后点击“Add”按钮。这时两个字段的映射关系就建立起来了，并被添加到中间的列表框中。 
     
     图 11. 创建字段对应关系之“Basic”标签页
      
     
     
   • 打开“Rich Text”标签页，从左侧选择“Body”字段（也就是文档在 Team Room 中的内容字段），从右侧选择“Contents”字段（也就是 Quickr 中对应的内容字段），然后点击“Add”按钮。这里需要注意一下：由于 Quickr 是个 Web 应用，其内容是通过 HTML 的格式进行保存与展现，所以我们进行完映射之后，还需要作一个转换设置。如下图中红框所示，在“Convert RichText data from Source to data”一栏，选择“HTML”，这样在进行数据迁移的时候，富文本框中的文本会被自动转换成 HTML 格式。 
     
     图 12. 创建字段对应关系之“Rich Text”标签页
      
     
     
   • 接下来打开“Attachment”标签页，从左侧选择“$Body_FILE1”字段，从右侧选择“Attachments”字段，它们分别对应两边的附件字段，然后点击“Add”按钮。 
     
     图 13. 创建字段对应关系之“Attachment”标签页
      
     
     
   • 打开“Internal”标签页，这里我们看到 LQCI 已经帮我们自动完成了两个映射关系，分别是“NotesID”和“UNID”，我们需要除去“NotesID”这个映射，只保留“UNID”，因为我们需要用它来作关键映射（后面会介绍）。因此在中间的选择列表框中选中“NotesID”，然后点击“Remove”按钮。 
     
     图 14. 创建字段对应关系之“Internal”标签页
      
     
     
   • 在“Permissions”标签页，没有可匹配字段，所以跳过。
   • 打开“All”标签页，这里列出了所有来自数据源和目标场所中的可匹配字段，还包括在前面几个标签页中已建立的映射关系，我们还需要在这里添加一些新的映射关系：
     1. 首先需要选中“UNID”映射关系前面的选择框，目的是将这个字段作为关键映射（Key），关键映射可以让 LQCI 唯一识别两边的一组数据。
     2. 选中左侧的“$CREATION_DATE”和右侧的“$Created”，点击“Add”按钮，它们对应的是两边的创建时间字段。
     3. 选中左侧的“$Modified”和右侧的“h_ModifiedDate”，点击“Add”按钮，它们对应的是两边的修改时间字段。
     4. 选中左侧的“From”和右侧的“$Authors”，点击“Add”按钮，它们对应的是两边的文档作者字段。
     5. 选中左侧的“$UpdatedBy”和右侧的“$h_LastEditorDisplayName”，点击“Add with Data Transformation”按钮，它们对应的是两边的文档修改者字段，但由于两边的数据格式不一致，我们需要为这组映射关系添加一个数据转换设置。这时会弹出一个数据转换设置窗口，如下图： 
        
        图 15. 数据转换设置窗口
         
        
        
     1. 选择“Create New”按钮，创建一个新的 Data Transformation 作业组件，在创建 Data Transformation 的对话框的“General”标签页中输入如下信息： 
        
        

        Items	Value
        Data Transformation Name	Transform. Domino Team Room Last Editor
        Category	Lotus Quickr Content Integrator For Domino Team Room
        Data Transformation	Script

        
        
        
        
        
        图 16. 新建 Data Transformation 对话框之“General”标签页
         
        
        
     2. 打开“Script”标签页，选择“JavaScript”作为我们的脚本语言，在脚本输入框中输入下面的代码段。这段代码的主要作用就是在做数据迁移时，对 Team Room 中文档的“$UpdatedBy”字段进行数据转换。它的值在 TeamRoom 中的格式类似于“Name/Domain”，保存到 Quickr 的“$h_LastEditorDisplayName”字段后，只取“/”前面的“Name”。注意：代码中的“RA__UpdatedBy_alias”指的就是“$UpdatedBy”字段，它是通过点击“Add Column …”按钮找到的。

        var pos = RA__UpdatedBy_alias.indexOf("/"); pos = (pos == -1 ? RA__UpdatedBy_alias.length : pos); RA__UpdatedBy_alias = RA__UpdatedBy_alias.substring(0, pos);

        
        
        
        图 17. 新建 Data Transformation 对话框之“Script”标签页
         
        
        

     回到刚才数据转换设置窗口，在“When data is read from …”一栏选择我们刚才创建的“Transform. Domino Team Room Last Editor”，点击“OK”完成配置。

     
     
     图 18. 设置完毕的数据转换设置窗口
      
     
     

     “All”标签页最终设置完成的效果如下图所示：

     
     
     图 19. 创建字段对应关系之“All”标签页
      
     
     

     （查看图 19 的 清晰版本）

   • 第五步是参数设置，我们可以在这个页面对数据源和目标场所中的数据进行筛选，例如只复制新增的条目和更新过的条目等。由于在这个例子中，我们是想把 Team Room 中的文档一次性的导入到 Quickr 中，因此这里我们把“Inserts”、“Updates”和“Deletes”都选中。示意图如下： 
     
     图 20. 参数设置
      
     
     
5. 第六步是选择时间戳列，如果我们在上面选择了“双向的”Replication，那么我们在这里需要为数据源和目标场所选择相应的列作为时间戳列，这样可以保证 LQCI 在进行数据同步时不会产生数据冲突，由于我们选择的是“单向的”Replication，所以这里我们不用选择时间戳列，保持默认值。
6. 第七步是设置执行控制选项，在这里我们需要指明运行的服务器。在“Assigned Server”一栏输入 LQCI 所在的服务器主机名（如 Server2.ibm.com） 
   
   图 21. 设置执行控制选项
    
   
   
7. 第八步选择作业执行周期，它可以是“Never”、“Daily”、“Weekly”和“Monthly”（即“从不”、“每天”、“每周”和“每月”）。由于在这个例子中，我们只是想把数据一次性导入到 Quickr 中，不需要重复执行，所以选择“Never”。
8. 第九步是通知设置，我们可以选择是否需要在数据迁移成功后进行邮件通知，这里我们选择默认设置，不作邮件通知。
9. 第十步也是最后一步，我们需要为当前的作业命名，在页面中输入如下信息：

示意图如下：

步骤四 : 启动 LQCI 服务器

在 Server2 上选择 开始 -> 所有程序 -> Lotus Quickr Content Integrator -> Server Manager，打开 LQCI Server Manager 组件，其界面如下图所示：

然后从菜单栏选择 Server – > Service -> Start，等待直到 LQCI 服务器成功启动（服务器的图标会从红色变成绿色）。

步骤五 : 提交作业完成数据迁移

打开 Composer 组件，依次展开 Integration Applications -> Replications -> Lotus Quickr Content Integrator For Domino Team Room，右键点击我们刚才创建的“Team Room Data Transfer”作业，然后选择 “Submit Job”，示意图如下：

等待直到数据迁移的作业结束。我们首先打开 Team Room 中的一篇文档，看一下它的原始效果，如下图：

然后再打开“Quickr Place”团队场所中的 Library 文件夹，找到对应的那篇导入文档，打开它看一下导入到 Quickr 后的效果，如下图：

总结

LQCI 是一款针对 Lotus Quickr 的功能强大的补充工具，通过它管理员可以把不同数据源平台上的内容轻松转移到 Lotus Quickr 上来，从而减少待维护的应用程序和资料库的数量，减轻管理员的负担。

原文链接：http://www.ibm.com/developerworks/cn/lotus/quickr-lqci/index.html