使用 Lotus Quickr Content Integrator 向 Lotus Quickr 中進行資料遷移

殷 智勇, 軟體工程師, IBM 中國軟體開發中心

簡介： 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 支援的各種資料來源平臺：

圖 1. 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 的安裝包開始安裝：

圖 2. LQCI 安裝介面
 

注意：在“System Catalog Configuration”頁面中，可以選擇是否安裝 LQCI 提供的模版，對於第一次使用的使用者，我們建議安裝模版，所以選擇“Configure SAMPLES System catalog”。

圖 3. “System Catalog Configuration”頁面
 

步驟二 : 建立 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. 第十步也是最後一步，我們需要為當前的作業命名，在頁面中輸入如下資訊：

Items	Value
Name	Team Room Data Transfer
Category	Lotus Quickr Content Integrator for Domino Team Room

示意圖如下：

圖 22. 作業命名
 

步驟四 : 啟動 LQCI 伺服器

在 Server2 上選擇 開始 -> 所有程式 -> Lotus Quickr Content Integrator -> Server Manager，開啟 LQCI Server Manager 元件，其介面如下圖所示：

圖 23. 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”，示意圖如下：

圖 24. 提交作業
 

等待直到資料遷移的作業結束。我們首先開啟 Team Room 中的一篇文件，看一下它的原始效果，如下圖：

圖 25. Team Room 中的一篇文件
 

然後再開啟“Quickr Place”團隊場所中的 Library 資料夾，找到對應的那篇匯入文件，開啟它看一下匯入到 Quickr 後的效果，如下圖：

圖 26. 匯入到 Quickr Place 場所後的文件
 

總結

LQCI 是一款針對 Lotus Quickr 的功能強大的補充工具，通過它管理員可以把不同資料來源平臺上的內容輕鬆轉移到 Lotus Quickr 上來，從而減少待維護的應用程式和資料庫的數量，減輕管理員的負擔。

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

來自 “ ITPUB部落格 ” ，連結：http://blog.itpub.net/14751907/viewspace-668839/，如需轉載，請註明出處，否則將追究法律責任。