對於 IBM® Enterprise
Records 部署,您可以利用「檔案計劃匯入匯出工具」來匯入外部檔案計劃,或將檔案計劃匯出到外部環境。該工具使用 XML 檔案來完成匯入匯出程序。
限制
檔案計劃匯入匯出工具有助於檔案計劃的移轉。但是,該工具不支援以下情況:
此外,在匯入檔案計劃的其餘部分之前,您必須首先在單獨的 XML 檔案中匯出和匯入自訂屬性(例如選項清單)和類別。
同時,在您匯入檔案計劃後,實體狀態(例如「
已關閉」或「
備妥進行處置」)即不再有效。
執行工具
您可以從指令行 Java 執行檔執行「檔案計劃匯入匯出工具」,也可以使用指令檔
FilePlanTool.bat 或
FilePlanTool.sh 來啟動此工具。
您可以在以下五種模式之一執行工具:
- 配置 - 會開啟一個對話框,您可在其中指定所需資訊,例如 Content Engine (CE)
伺服器名稱、物件儲存庫名稱、管理者使用者名稱和密碼以及模式(匯入或匯出)。
- 匯出 - 建立一個完全相容和相符的 XML 檔案,您可以隨後將其匯入到另一個環境中。
- 匯入/更新 - 將指定的 XML 檔案匯入到一個環境。
- 驗證 - 讀取 XML 檔案以驗證相容性和相符性。
匯出檔案計劃
如果您要匯出的檔案計劃包含以下項目中的任何一個:
- 自訂類別或屬性
- 300,000 個以上資料夾
- 包括 15,000 個以上資料夾的記錄種類
請參閱
使用範圍選項匯出檔案計劃。
配置工具之後,您可以使用工具來匯出檔案計劃。如果要匯出檔案計劃,請輸入以下指令:
FilePlanTool -mode export -fileplan file
plan name -o XML filename.xml 其中檔案計劃名稱為要匯出的檔案計劃的名稱,並且是必需的。如果檔案計劃名稱包含空格或特殊字元,請將檔案計劃名稱置於引號中。
XML 檔名是要建立的檔案的名稱和路徑。如果您未在指令行上提供檔名,則工具將使用由工具的配置對話框中「輸出檔名」欄位指定的預設檔名。
如需指定預設 XML 輸出檔名的詳細資料,請參閱配置工具。
使用範圍選項匯出檔案計劃
匯出檔案計劃時,對於較大的檔案計劃或包含自訂類別或屬性的檔案計劃,請使用範圍選項。如果要使用範圍選項匯出檔案計劃,請輸入以下指令:
FilePlanTool -mode export -fileplan file
plan name -o XML filename.xml -scope parameter
其中檔案計劃名稱為要匯出的檔案計劃的名稱,並且是必需的。如果檔案計劃名稱包含空格或特殊字元,請將檔案計劃名稱置於引號中。
XML 檔名是您要建立的檔案的名稱和路徑。如果您未在指令行上提供檔名,則工具將使用由工具的配置對話框中「輸出檔名」欄位指定的預設檔名。當您使用帶有範圍選項的工具時,工具將為檔案計劃的每個部分建立一個 XML 檔案。因此,每次在匯出模式下使用工具時您必須指定不同的 XML 檔名。
如需指定預設 XML 輸出檔名的相關資訊,請參閱配置工具。
參數可以是以下任何一種:
- meta 資料 - 如果您的檔案計劃包含自訂類別或屬性,則該參數是必需的。meta 資料參數選項會為自訂類別和屬性建立一個單獨的 XML 檔案。因此,如果檔案計劃包含自訂類別或屬性,則匯出和匯入程序分別由兩個步驟組成:
- 一步用於自訂類別和屬性
- 一步用於檔案計劃的其餘部分。如果您不使用 meta 資料參數,則工具匯出不具有自訂屬性的檔案計劃。
- includecategory "record category
name" - 使用這個參數可以匯出特定的記錄種類。
如果您使用 includecategory,則工具將匯出指定的記錄種類中包含的所有子種類和子資料夾。record
category name 必須包括 IBM Enterprise
Records 中的完整路徑。
例如,如果要匯出 "Cat03"(其包含在 "Cat02" 中,"Cat02" 又包含在 "Cat01" 中)記錄種類中的所有子項,請輸入下列指令:
FilePlanTool.bat -mode export -scope includecategory
"/Cat01/Cat02/Cat03" -o expfile.xml
- includecategories file 01 -
使用這個參數以只匯出輸入文字檔 file 01 中指定的記錄種類及其子項。
使用 includecategories 參數可以將大量記錄種類匯出至同一個檔案,而無需在指令行中指定每一個記錄種類名稱。如果要使用該參數,請輸入以下指令:
FilePlanTool.bat -mode export -scope includecategories file01.txt -o export01.xml
File01.txt 包含:
/categoryB/CategoryC/SubcategoryC2/CatogoryA/SubcategoryA1
種類名稱的每行由完整路徑名稱和一個記錄種類表示。
- excludecategory "excluded record
category name" - 使用這個參數可以排除特定的記錄種類及其子項。
比方說,如果 excluded record category name 是 "Cat01/Cat02/Catlarge",工具會匯出檔案計劃中的所有記錄種類和記錄資料夾,但包含在 "Cat01/Cat02/CatLarge" 節點內的記錄種類和記錄資料夾除外。
此參數的運作方式與 includecategory 類似。
- excludecategories 檔案 02 - 使用該參數可以排除 檔案 02 文字檔案中指定的根名稱的子樹。
此參數的運作方式與 includecategories 類似。
匯入/更新檔案計劃
如果要匯入檔案計劃或其段,請在匯入模式下執行工具,並指定工具在匯出模式下建立的 XML 檔案。如果檔案計劃包含自訂類別或屬性,則匯入程序需要兩個步驟。一個步驟是匯入檔案計劃中的自訂類別和屬性,第二個步驟是匯入檔案計劃中的其餘部分。由於自訂類別和屬性 meta 資料在記憶體中快取,因此請先匯入自訂類別和屬性,然後等待至少五分鐘再匯入檔案計劃。快取生存時間 (TTL) 為五分鐘,五分鐘後將清除快取。如果要匯入/更新檔案計劃,請輸入以下指令:
FilePlanTool -mode import -f XML
filename.xml -reimportoption option
FilePlanTool -mode update -f XML
filename.xml -reimportoption option
XML 檔名是您要匯入的檔案的名稱和路徑。如果您未在指令行上提供檔名,則工具將使用由工具的配置對話框中「輸出檔名」欄位指定的預設檔名。
如需指定預設 XML 輸出檔名的相關資訊,請參閱配置工具。
當匯入檔案計劃中已存在的實體時,重新匯入的選項將決定工具的預設行為。
如需重新匯入選項的詳細資料,請參閱使用重新匯入選項。
在匯入模式下,工具不使用範圍選項,但可以根據 XML 標籤來確定匯入物件。對於 meta 資料(自訂類別和屬性)和檔案計劃,您必須提供不同的 XML 檔名。
小心: XML 檔案中的 ClassificationScheme 標籤會指定檔案計劃的名稱。
檔案計劃最初匯入後,您可以在「更新」模式下執行工具以進行少量修改,且可以將後續更新與最初匯入的 XML 檔案區分。將更新指定為 XML 檔案中 FilePlan 標籤的 InputMode 屬性。您無法使用「更新」模式修改自訂屬性(例如選項清單)。
如果您收到錯誤訊息,或匯入程序停止,請參閱IBM FileNet® P8 Troubleshooting Guide。在大多數情況下,發生錯誤後匯入的程序將停止,而不顯示任何訊息。
如有必要,匯入後請在實體上執行暫存區清理以套用條件暫存區,因為工具無法匯入條件暫存區。請參閱限制。
驗證檔案計劃
手動建立 XML 檔案後,請透過檔案計劃匯入匯出工具來驗證 XML 檔案是否不包含任何錯誤或不相符的問題。如果要在「驗證」模式下執行匯入匯出工具,請輸入以下指令:
FilePlanTool -mode validate -f XML
filename.xml
XML 檔名是您要驗證的檔案的名稱和路徑。如果您未在指令行上提供檔名,則工具將使用由工具的配置對話框中「輸出檔名」欄位指定的預設檔名。
如需指定預設 XML 輸出檔名的相關資訊,請參閱配置工具。
使用重新匯入選項
當匯入檔案計劃中已存在的實體時,使用重新匯入選項來決定工具的預設行為。重新匯入選項有三個參數:
- 無 - 新增實體時,如果實體已存在則工具將在異常狀況日誌中報告警告,請勿新增實體,然後繼續進行。
- 跳過 - 新增實體時,工具跳至所有現有實體而繼續進行,並在活動日誌中報告跳過動作。
- 取代 - 新增實體時,工具取代所有現有實體而繼續進行,並在活動日誌中報告修改動作。
大型檔案計劃匯入失敗後,請使用「跳過」選項。第二次嘗試匯入相同檔案計劃期間,「跳過」選項可避免重新匯入已成功匯入的實體。但是,如果第二次嘗試匯入時,要求對第一次成功匯入的實體進行少量修改,則請使用「取代」選項。
後續在匯入對少量實體所做的少量修改期間,請對實體指定 Action="Modify"(在 XML 檔案的 RMEntityObjectType 區段中),而不是對原始 XML 檔案進行變更。另外,使用「更新」模式可以更輕鬆地將後續更新與最初完全匯入區分。請參閱
匯入/更新檔案計劃。