關於 IBM InfoSphere Enterprise Records 部署,您可以利用「檔案計劃匯入匯出工具」來匯入外部檔案計劃,或將檔案計劃匯出到外部環境。 該工具使用 XML 檔案來完成匯入匯出程序。如需 XML 架構及其元素的詳細資料,請參閱檔案計劃 XML 架構。
如需修改已匯出的 XML 檔來併入排程繼承、替代保留、處置觸發程式及動態暫存區(條件暫存區)的詳細資料,請參閱 FileNet P8 Platform 的產品文件的「檔案計劃匯入及匯出工具」一節。
檔案計劃匯入匯出工具有助於檔案計劃的移轉。但是,該工具不支援以下情況:
此外,在匯入檔案計劃的其餘部分之前,您必須首先在單獨的 XML 檔案中匯出和匯入自訂屬性(例如選項清單)和類別。同時,在您匯入檔案計劃後,實體狀態(例如「已關閉」或「準備處理」)不再有效。
您可以從指令行 Java™ 可執行檔執行檔案計劃匯入匯出工具,也可以使用指令檔 FilePlanTool.bat 或 FilePlanTool.sh 啟動工具。
您可以在以下五種模式之一執行工具:
在匯入或匯出模式下執行工具之前,您必須配置工具。
配置工具
在 Windows:
FilePlanTool -mode configure
在 UNIX:
./FilePlanTool.sh -mode configure
附註 如果您使用 iiop 連接,則必須停用 Secure Sockets Layer (SSL)。如果要停用 SSL,請參閱停用 Secure Sockets Layer。
如果您要匯出的檔案計劃包含以下項目中的任何一個:
請參閱使用範圍選項匯出檔案計劃。
配置工具之後,您可以使用工具來匯出檔案計劃。如果要匯出檔案計劃,請輸入以下指令:
FilePlanTool -mode export -fileplan <檔案計劃名稱> -o <XML 檔名.xml>
其中檔案計劃名稱為要匯出的檔案計劃的名稱,並且是必需的。如果檔案計劃名稱包含空格或特殊字元,請將檔案計劃名稱置於引號中。
XML 檔名是要建立的檔案的名稱和路徑。如果您未在指令行上提供檔名,則工具將使用由工具的配置對話框中「輸出檔名」欄位指定的預設檔名。如需指定預設 XML 輸出檔名的詳細資料,請參閱配置工具。
匯出檔案計劃時,對於較大的檔案計劃或包含自訂類別或屬性的檔案計劃,請使用範圍選項。
如果要使用範圍選項匯出檔案計劃,請輸入以下指令:
FilePlanTool -mode export -fileplan <檔案計劃名稱> -o <XML 檔名.xml> -scope <參數>
其中檔案計劃名稱為要匯出的檔案計劃的名稱,並且是必需的。如果檔案計劃名稱包含空格或特殊字元,請將檔案計劃名稱置於引號中。
XML 檔名是您要建立的檔案的名稱和路徑。如果您未在指令行上提供檔名,則工具將使用由工具的配置對話框中「輸出檔名」欄位指定的預設檔名。當您使用帶有範圍選項的工具時,工具將為檔案計劃的每個部分建立一個 XML 檔案。因此,每次在匯出模式下使用工具時您必須指定不同的 XML 檔名。如需有關指定預設 XML 輸出檔名的資訊,請參閱配置工具。
參數可以是以下任何一種:
FilePlanTool.bat -mode export -scope includecategory "/Cat01/Cat02/Cat03" -o expfile.xml
FilePlanTool.bat -mode export -scope includecategories file01.txt -o export01.xml
File01.txt 包含:
/categoryB
/CategoryC/SubcategoryC2
/CatogoryA/SubcategoryA1種類名稱的每行由完整路徑名稱和一個記錄種類表示。
如果要匯入檔案計劃或其段,請在匯入模式下執行工具,並指定工具在匯出模式下建立的 XML 檔案。
如果檔案計劃包含自訂類別或屬性,則匯入程序需要兩個步驟。一個步驟是匯入檔案計劃中的自訂類別和屬性,第二個步驟是匯入檔案計劃中的其餘部分。由於自訂類別和屬性 meta 資料在記憶體中快取,因此請先匯入自訂類別和屬性,然後等待至少五分鐘再匯入檔案計劃。快取生存時間 (TTL) 為五分鐘,五分鐘後將清除快取。
如果要匯入/更新檔案計劃,請輸入以下指令:
FilePlanTool -mode import -f <XML 檔名.xml> -reimportoption <option>
FilePlanTool -mode update -f <XML 檔名.xml> -reimportoption <option>
XML 檔名是您要匯入的檔案的名稱和路徑。如果您未在指令行上提供檔名,則工具將使用由工具的配置對話框中「輸出檔名」欄位指定的預設檔名。如需有關指定預設 XML 輸出檔名的資訊,請參閱配置工具。
當匯入檔案計劃中已存在的實體時,重新匯入的選項將決定工具的預設行為。如需重新匯入選項的詳細資料,請參閱使用重新匯入選項。
在匯入模式下,工具不使用範圍選項,但可以根據 XML 標籤來確定匯入物件。對於 meta 資料(自訂類別和屬性)和檔案計劃,您必須提供不同的 XML 檔名。
附註 XML 檔案中的 ClassificationScheme 標籤會指定檔案計劃的名稱。
檔案計劃最初匯入後,您可以在「更新」模式下執行工具以進行少量修改,且可以將後續更新與最初匯入的 XML 檔案區分。將更新指定為 XML 檔案中 FilePlan 標籤的 InputMode 屬性。您無法使用「更新」模式修改自訂屬性(例如選項清單)。
如果您收到錯誤訊息,或匯入的程序停止,請參閱《FileNet P8 Troubleshooting Guide》。在大多數情況下,發生錯誤後匯入的程序將停止,而不顯示任何訊息。
如有必要,匯入後請在實體上執行暫存區清理以套用條件暫存區,因為工具無法匯入條件暫存區。請參閱限制。
手動建立 XML 檔案後,請透過檔案計劃匯入匯出工具來驗證 XML 檔案是否不包含任何錯誤或不相符的問題。
如果要在「驗證」模式下執行匯入匯出工具,請輸入以下指令:
FilePlanTool -mode validate -f <XML 檔名.xml>
XML 檔名是您要驗證的檔案的名稱和路徑。如果您未在指令行上提供檔名,則工具將使用由工具的配置對話框中「輸出檔名」欄位指定的預設檔名。如需有關指定預設 XML 輸出檔名的資訊,請參閱配置工具。
當匯入檔案計劃中已存在的實體時,使用重新匯入選項來決定工具的預設行為。重新匯入選項有三個參數:
大型檔案計劃匯入失敗後,請使用「跳過」選項。第二次嘗試匯入相同檔案計劃期間,「跳過」選項可避免重新匯入已成功匯入的實體。但是,如果第二次嘗試匯入時,要求對第一次成功匯入的實體進行少量修改,則請使用「取代」選項。
後續在匯入對少量實體所做的少量修改期間,請對實體指定 Action="Modify"(在 XML 檔案的 RMEntityObjectType 部分),而不是對原始 XML 檔案進行變更。另外,使用「更新」模式可以更輕鬆地將後續更新與最初完全匯入區分。請參閱匯入/更新檔案計劃。