IBM Enterprise Records, 版本 5.1.+            

使用檔案計劃匯入和匯出工具

對於 IBM® Enterprise Records 部署,您可以利用「檔案計劃匯入匯出工具」來匯入外部檔案計劃,或將檔案計劃匯出到外部環境。該工具使用 XML 檔案來完成匯入匯出程序。

概覽

如需修改已匯出的 XML 檔來併入排程繼承、替代保留期、處置觸發程式及動態暫存區(條件式暫存區)的詳細資料,請參閱位於下列網址的「檔案計劃匯入和匯出工具」一節:http://www-01.ibm.com/support/docview.wss?rs=3247&uid=swg27010422

限制

檔案計劃匯入匯出工具有助於檔案計劃的移轉。但是,該工具不支援以下情況: 此外,在匯入檔案計劃的其餘部分之前,您必須首先在單獨的 XML 檔案中匯出和匯入自訂屬性(例如選項清單)和類別。 同時,在您匯入檔案計劃後,實體狀態(例如「已關閉」或「備妥進行處置」)即不再有效。

執行工具

您可以從指令行 Java 執行檔執行「檔案計劃匯入匯出工具」,也可以使用指令檔 FilePlanTool.batFilePlanTool.sh 來啟動此工具。 您可以在以下五種模式之一執行工具:

配置工具

在匯入或匯出模式下執行工具之前,您必須配置工具。 如果要配置工具,請執行下列動作:
  1. 導覽至安裝檔案計劃匯入匯出工具的資料夾。
  2. 在指令行執行以下指令之一:
    作業系統 指令
    Windows FilePlanTool -mode configure
    UNIX FilePlanTool.sh -mode configure
    在「檔案計劃工具」對話框中輸入以下資訊:

匯出檔案計劃

如果您要匯出的檔案計劃包含以下項目中的任何一個: 請參閱使用範圍選項匯出檔案計劃

配置工具之後,您可以使用工具來匯出檔案計劃。如果要匯出檔案計劃,請輸入以下指令:

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

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 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 檔案進行變更。另外,使用「更新」模式可以更輕鬆地將後續更新與最初完全匯入區分。請參閱匯入/更新檔案計劃


意見

前次更新: 2011 年 8 月


© Copyright IBM Corp. 2011.
此資訊中心採用 Eclipse 技術。(http://www.eclipse.org)