整合Lotus Quickr 8.5 for Domino 與 IBM ECM：配置與最佳實踐

簡介： 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 伺服器。

請遵循以下步驟對 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 objectClass person cn cn givenname sn mail telephoneNumber manager groupOfuniqueNames cn cn Uniquemember sn, givenname dn 50 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 代理：

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 知識庫中一個文件的連結（見圖 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 的程式碼
   

   QDServer.cn.ibm.com demomapping

   
   
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/，如需轉載，請註明出處，否則將追究法律責任。