对于 IBM® Enterprise Records 部署,可以使用“归档计划导入导出工具”来导入外部归档计划,或者将归档计划导出到外部环境。该工具使用 XML 文件来完成导入导出过程。
限制
“归档计划导入导出”工具可加快归档计划的迁移。但是,该工具不支持以下情况:
此外,在导入归档计划的其余部分之前,您必须首先在单独的 XML 文件中导出和导入定制属性(例如选项列表)和类。同时,在您导入归档计划后,实体状态(例如,
已关闭或
处理准备就绪)不再有效。
运行工具
您可以从命令行 Java 可执行文件运行“归档计划导入导出工具”,或者您可以使用命令文件
FilePlanTool.bat 或
FilePlanTool.sh 启动该工具。
您可以采用下列五种方式的其中一种来执行此工具:
- 配置 - 打开一个对话框,您可在其中指定所需信息,例如 Content Engine (CE) 服务器名称、对象库名称、管理员用户名和密码以及方式(导入或导出)。
- 导出 - 创建一个完全兼容和符合的 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 中的完整路径。例如,要导出“Cat02”(包含在“Cat01”中)中包含的名为“Cat03”的记录类别中的所有子代,请输入以下命令:
FilePlanTool.bat -mode export -scope includecategory
"/Cat01/Cat02/Cat03" -o expfile.xml
- includecategories file 01 - 使用该参数仅导出输入文本文件 file 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 文件。如果归档计划包含定制类或属性,那么导入过程分为两个步骤。一个步骤是导入归档计划中的定制类和属性,第二个步骤是导入归档计划中的其余部分。由于定制类和属性元数据在内存中缓存,因此请先导入定制类和属性,然后等待至少五分钟再导入归档计划。缓存生存时间(TTL)为五分钟,五分钟后将清除缓存。要导入/更新归档计划,请输入以下命令:
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 属性。您无法使用更新方式修改定制属性(例如选项列表)。
如果您收到错误消息,或导入过程停止,那么请参阅 IBM FileNet® P8 Troubleshooting Guide。在大多数情况下,遇到错误后,导入过程将停止,而不会显示任何消息。
如有必要,导入后请在实体上运行挂起扫描以应用条件挂起,因为工具不导入条件挂起。请参阅限制。
验证归档计划
手动创建 XML 文件后,请通过“归档计划导入导出”工具来验证 XML 文件不包含任何错误或不符合的问题。要在验证方式下运行导入导出工具,请输入以下命令:
FilePlanTool -mode validate -f XML
文件名.xml
XML 文件名是您要验证的文件的名称和路径。如果您未在命令行中给出文件名,那么工具将使用由工具的配置对话框中“输出文件名”字段指定的缺省文件名。有关指定缺省 XML 输出文件名的信息,请参阅配置该工具。
使用重新导入选项
使用重新导入选项来确定导入归档计划中已存在的实体时工具的缺省行为。重新导入选项有三个参数:
- 无 - 添加实体时,如果实体已存在则工具将在异常日志中报告警告,请勿添加实体,然后继续。
- 跳过 - 添加实体时,工具跳过所有现有实体而继续,并在活动日志中报告跳过操作。
- 替换 - 添加实体时,工具替换所有现有实体而继续,并在活动日志中报告修改操作。
大型归档计划导入失败后,请使用“跳过”选项。第二次尝试导入同一归档计划期间,“跳过”选项可避免重新导入已成功导入的实体。但是,如果第二次导入尝试要求对第一次成功导入的实体进行少量修改,那么请使用“替换”选项。在以后导入对少量实体进行的小幅修改期间,请在 XML 文件的 RMEntityObjectType 节中对实体指定 Action="Modify",而不要对原始 XML 文件进行更改。另外,使用更新方式可以更轻松地将后续更新与初始完全导入相区分。请参阅
导入/更新归档计划。