IBM Enterprise Records 5.1.2 版    

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

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

概覽

如需修改匯出 XML 檔案以包含排程繼承、替代保留、處置觸發和動態保留的詳細資料,請參閱「檔案計劃匯入和匯出工具疑難排解」主題。

限制

使用「檔案計劃匯入匯出工具」來移轉檔案計劃。 但是,該工具不支援以下情況: 在匯入檔案計劃的其餘部分前,請先匯出自訂內容(例如選擇清單)和類別,然後匯入單獨的 XML 檔案。 同時,在您匯入檔案計劃後,實體狀態(例如已關閉備妥進行處置)即不再有效。

執行工具

您可以從指令行 Java 可執行程式執行「檔案計劃匯入匯出」工具。 或者,您可以使用 FilePlanTool.batFilePlanTool.sh 指令檔來啟動工具。 您可以採用下列五種模式的其中一種來執行工具:

配置工具

在匯入或匯出模式下執行工具之前,您必須配置工具。 如果要配置工具,請執行下列動作:
  1. 移至安裝「檔案計劃匯入匯出」工具的資料夾。
  2. 在指令行中執行下列其中一項指令:
    作業系統 指令
    Windows FilePlanTool -mode configure
    AIX、HP-UX、Linux 及 Solaris 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 輸出檔名的相關資訊,請參閱配置工具

參數可以是以下任何一項:
  • metadata:如果您的檔案計劃包含自訂類別或內容,則需要此參數。 meta 資料參數選項會為自訂類別和內容建立一個單獨的 XML 檔案。因此,如果檔案計劃包含自訂類別或內容,則匯出和匯入程序分別由兩個步驟組成:
    • 自訂類別和內容的步驟
    • 檔案計劃其餘部分的步驟。如果您不使用 meta 資料參數,則工具匯出不具有自訂內容的檔案計劃。
  • includecategory "record category name":使用這個參數可以匯出特定的記錄種類。如果您使用 includecategory,則工具將匯出指定的記錄種類中包含的所有子種類和子資料夾。record category name 必須包括 IBM Enterprise Records 中的完整路徑。例如,要匯出記錄種類名稱為 Cat03 的所有子項時,輸入下列指令。 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 資料快取在記憶體中,請先最少等候 5 分鐘,然後再匯入檔案計劃。 快取生存時間 (TTL) 為 5 分鐘,5 分鐘後將清除快取。如果要匯入/更新檔案計劃,請輸入以下指令:

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 屬性。您無法使用「更新」模式修改自訂內容(例如選項清單)。

如果您收到錯誤訊息或匯入程序中止,請參閱資訊中心的「疑難排解與支援」節點,或 「FileNet® P8 Platform 產品文件」頁面中的 IBM FileNet P8 Troubleshooting Guide。 在大多數情況下,發生錯誤後匯入的程序將停止,而不顯示任何訊息。

如有必要,匯入後請在實體上執行保留清理以套用條件保留,因為工具無法匯入條件保留。請參閱限制

驗證檔案計劃

在您手動建立 XML 檔案後,請確認 XML 檔案沒有包含任何錯誤或不符標準的問題。 您可以透過「檔案計劃匯入匯出」工具來驗證檔案。 如果要在「驗證」模式下執行「匯入匯出」工具,請輸入以下指令:

FilePlanTool -mode validate -f XML filename.xml

XML 檔名是您要驗證的檔案的名稱和路徑。如果您未提供檔名,則工具會使用在配置對話框的輸出檔名欄位所指定的預設檔名。 如需指定預設 XML 輸出檔名的相關資訊,請參閱配置工具

使用重新匯入選項

當匯入檔案計劃中已存在的實體時,使用重新匯入選項來決定工具的預設行為。重新匯入選項有三個參數: 大型檔案計劃匯入失敗後,請使用跳過選項。 第二次嘗試匯入相同檔案計劃期間,「跳過」選項可避免重新匯入已成功匯入的實體。但是,如果第二次嘗試匯入時,需要對第一次成功匯入的實體進行少量修改,請使用取代選項。後續匯入對幾個實體的小修改時,給實體指定 Action="Modify"(在 XML 檔的 RMEntityObjectType 區段中)。變更這些實體,而非變更原始 XML 檔案。另外,使用「更新」模式可以更輕鬆地將後續更新與最初完全匯入區分。請參閱匯入/更新檔案計劃


意見

前次更新: 2013 年 11 月
fileplan_import_export.htm

© Copyright IBM Corp. 2013