對於 IBM® Enterprise
Records 部署,您可以利用「檔案計劃匯入匯出工具」來匯入外部檔案計劃,或將檔案計劃匯出到外部環境。該工具使用 XML 檔案來完成匯入匯出程序。
概覽
如需修改匯出 XML 檔案以包含排程繼承、替代保留、處置觸發和動態保留的詳細資料,請參閱「檔案計劃匯入和匯出工具疑難排解」主題。
限制
使用「檔案計劃匯入匯出工具」來移轉檔案計劃。
但是,該工具不支援以下情況:
- 跨資料模型匯出/匯入。比方說,如果您從 PRO 資料模型物件儲存庫中匯出,則無法匯入到 DoD 資料模型物件儲存庫。
- 匯出或匯入記錄物件、磁區、文件物件、安全資訊和安全標記。
- 復原機制。
- 匯出含有空值的內容。例如,匯出沒有保留期的處置排程階段。此外,將該處置排程匯入其他物件儲存庫,不將保留期更新為空值。
但是,您可以手動更新 XML 檔案以更新保留期。如需相關資訊,請參閱「檔案計劃匯入和匯出工具疑難排解」主題。
在匯入檔案計劃的其餘部分前,請先匯出自訂內容(例如選擇清單)和類別,然後匯入單獨的 XML 檔案。
同時,在您匯入檔案計劃後,實體狀態(例如
已關閉或
備妥進行處置)即不再有效。
執行工具
您可以從指令行 Java 可執行程式執行「檔案計劃匯入匯出」工具。
或者,您可以使用
FilePlanTool.bat 或
FilePlanTool.sh 指令檔來啟動工具。
您可以採用下列五種模式的其中一種來執行工具:
- 配置:開啟對話框,在其中指定必要資訊。
必要資訊如下:Content Platform Engine 伺服器名稱、物件儲存庫名稱、管理者的使用者名稱和密碼以及其他項目(匯入或匯出)。
- 匯出:建立一個完全相容和相符的 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 輸出檔名的相關資訊,請參閱配置工具。
參數可以是以下任何一項:
- 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
- includecategories 檔案 01:使用該參數僅匯出輸入文字檔案 檔案 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 資料快取在記憶體中,請先最少等候 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 檔案。另外,使用「更新」模式可以更輕鬆地將後續更新與最初完全匯入區分。請參閱
匯入/更新檔案計劃。