对于 IBM® Enterprise
Records 部署,请使用“归档计划导入导出”工具来导入外部归档计划,或者将归档计划导出到外部环境。该工具使用 XML 文件来完成导入导出过程。
概述
有关修改已导出的 XML 文件以便将调度继承、备用保留、处理触发器和动态挂起包括在内的详细信息,请参阅“对‘归档计划导入和导出’工具进行故障诊断”主题。
限制
使用“归档计划导入导出”工具来迁移归档计划。但是,该工具不支持以下场景:
- 跨数据模型导出/导入。例如,如果您从 PRO 数据模型对象库中导出,那么不能导入到 DoD 数据模型对象库。
- 导出或导入记录对象、卷、文档对象、安全性信息和安全性标记。
- 回滚机制。
- 导出值为 Null 的属性。例如,导出没有保留期的处理调度的阶段。此外,将处理调度导入另一个对象库中时不会将保留期更新为空值。但是,您可以手动更新 XML 文件以更新保留期。有关更多信息,请参阅“归档计划导入和导出工具故障诊断”主题。
在导入归档计划的其余部分之前,请先在单独的 XML 文件中导出和导入定制属性(例如选项列表)和类。同时,在您导入归档计划后,实体状态(例如,
已关闭或
处理准备就绪)不再有效。
运行工具
您可以从命令行 Java 可执行程序来运行“归档计划导入导出”工具。或者,您可以使用以下命令文件来启动该工具:
FilePlanTool.bat 或
FilePlanTool.sh。
您可以采用下列五种方式中的一种来运行此工具:
- 配置:打开一个对话框,您在该对话框中指定必需信息。此类必需信息为 Content Platform Engine 服务器名称、对象库名称、管理员用户名及密码和方式(导入或导出)。
- 导出:创建一个完全兼容和符合的 XML 文件,您可以随后将其导入到另一个环境中。
- 导入/更新:将指定的 XML 文件导入到环境中。
- 验证:读取 XML 文件以验证兼容性和合规性。
导出归档计划
如果要导出的归档计划包含以下项之一:
- 定制类或属性
- 300,000 个以上文件夹
- 一个包含 15,000 个以上文件夹的记录类别
请参阅
使用范围选项导出归档计划。
配置工具之后,您可以使用工具来导出归档计划。要导出归档计划,请输入以下命令:
FilePlanTool -mode export -fileplan 归档计划名称 -o XML 文件名.xml 其中归档计划名称是要导出的归档计划的名称,并且是必需的。如果归档计划名称包含空格或特殊字符,请用引号将归档计划名称引起来。
XML 文件名是要创建的文件的名称和路径。如果您未在命令行中给出文件名,那么工具将使用由输出文件名字段指定的缺省文件名。此字段位于配置对话框中。有关指定缺省 XML 输出文件名的详细信息,请参阅配置该工具。
使用范围选项导出归档计划
导出归档计划时,对于较大的归档计划或包含定制类或属性的归档计划,请使用范围选项。要使用范围选项导出归档计划,请输入以下命令:
FilePlanTool -mode export -fileplan 归档计划名称 -o XML 文件名.xml -scope parameter
其中归档计划名称是要导出的归档计划的名称,并且是必需的。如果归档计划名称包含空格或特殊字符,请用引号将归档计划名称引起来。
XML 文件名是您要创建的文件的名称和路径。如果您未在命令行中给出文件名,那么工具将使用由输出文件名字段指定的缺省文件名。此字段位于配置对话框中。当您使用带有范围选项的工具时,工具将为归档计划的每个部分创建一个 XML 文件。因此,每次以导出方式使用此工具时,必须指定不同的 XML 文件名。有关指定缺省 XML 输出文件名的信息,请参阅配置该工具。
参数可以是以下任何一项:
- 元数据:如果归档计划包含定制类或属性,那么此参数是必需参数。元数据参数选项会为定制类和属性创建一个单独的 XML 文件。因此,如果归档计划包含定制类或属性,那么导出和导入过程分别由两个步骤组成:
- 适用于定制类和属性的一个步骤
- 适用于其余归档计划的一个步骤。如果您不使用元数据参数,那么工具导出的文件没有定制属性。
- includecategory "记录类别名称":使用此参数来导出特定的记录类别。使用 includecategory 时,工具将导出指定的记录类别中包含的所有子类别和子文件夹。记录类别名称必须包括 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 "排除的记录类别名称":使用此参数来排除特定的记录类别及其子代。例如,如果排除的记录类别名称为“Cat01/Cat02/Catlarge”,那么工具将导出归档计划中的所有记录类别和记录文件夹,但是有一种异常除外。该异常是包含在节点 "Cat01/Cat02/CatLarge" 中的记录类别和记录文件夹。该参数的运行与 includecategory 相似。
- excludecategories 文件 02:使用该参数可以排除 文件 02 文本文件中指定的根名称的子树。该参数的运行与 includecategories 相似。
导入/更新归档计划
要导入归档计划或归档计划的分段,请以导入方式运行该工具。指定此工具在导出方式下创建的 XML 文件。如果归档计划包含定制类或属性,那么导入过程分为两个步骤。第一步是导入归档计划中的定制类和属性。第二步是导入归档计划中的其余部分。首先导入定制类和属性。
然后,等待至少 5 分钟再导入归档计划,因为定制类和属性元数据高速缓存在内存中。高速缓存生存时间 (TTL) 为 5 分钟,5 分钟后将清除高速缓存。要导入/更新归档计划,请输入以下命令:
FilePlanTool -mode import -f XML
文件名.xml -reimportoption option
FilePlanTool -mode update -f XML
文件名.xml -reimportoption option
XML 文件名是您要导入的文件的名称和路径。如果您未提供文件名,那么工具将使用由工具的配置对话框中输出文件名字段指定的缺省文件名。有关指定缺省 XML 输出文件名的信息,请参阅配置该工具。
重新导入选项确定导入归档计划中已存在的实体时工具的缺省行为。有关重新导入选项的详细信息,请参阅使用重新导入选项。
在导入方式下,工具不使用范围选项,但是根据 XML 标记来确定导入对象。您必须为元数据(定制类和属性)和归档计划提供不同的 XML 文件名。
注意: XML 文件中的 ClassificationScheme 标记指定归档计划的名称。
初始导入归档计划之后,请在更新方式下运行工具以做出少量修改。将后续更新与最初导入的 XML 文件区别开。将更新指定为 XML 文件中 FilePlan 标记的 InputMode 属性。您无法使用更新方式修改定制属性(例如选项列表)。
如果您收到错误消息,或导入过程停止,请参阅信息中心内的“故障诊断和支持”节点或“FileNet® P8
Platform 的产品文档”页面中的IBM FileNet P8 Troubleshooting Guide。在大多数情况下,遇到错误后,导入过程将停止,而不会显示任何消息。
如有必要,导入后请在实体上运行挂起扫描以应用条件挂起,因为工具不导入条件挂起。请参阅限制。
验证归档计划
手动创建 XML 文件后,请验证 XML 文件是否不包含任何错误或不一致问题。您可以通过“归档计划导入导出”工具来验证该文件。要在验证方式下运行导入导出工具,请输入以下命令:
FilePlanTool -mode validate -f XML
文件名.xml
XML 文件名是您要验证的文件的名称和路径。如果您未提供文件名,那么工具将使用由工具的配置对话框中输出文件名字段指定的缺省文件名。有关指定缺省 XML 输出文件名的信息,请参阅配置该工具。
使用重新导入选项
使用重新导入选项来确定工具在导入归档计划中已存在的实体时的缺省行为。重新导入选项有三个参数:
- 无:添加实体时,如果实体已存在则工具将在异常日志中报告警告,请勿添加实体,然后继续。
- 跳过:添加实体时,工具跳过所有现有实体而继续,并在活动日志中报告跳过操作。
- 替换:添加实体时,工具替换所有现有实体而继续,并在活动日志中报告修改操作。
大型归档计划导入失败后,请使用
跳过选项。第二次尝试导入同一归档计划期间,“跳过”选项可避免重新导入已成功导入的实体。但是,如果第二次导入尝试要求对第一次尝试期间成功导入的实体进行小幅修改,请使用
替换选项。以后导入对少量实体的小幅修改期间,请为实体指定
Action="Modify"(在 XML 文件的 RMEntityObjectType 部分中)。更改这些实体,而不是更改原始的 XML 文件。另外,使用更新方式可以更轻松地将后续更新与初始完全导入相区分。请参阅
导入/更新归档计划。