使用归档计划导入和导出工具

概述

对于 IBM InfoSphere Enterprise Records 部署,您可以使用“归档计划导入导出”工具来导入外部归档计划,或者将归档计划导出到外部环境。该工具使用 XML 文件来完成导入导出过程。有关 XML 模式及其元素的详细信息,请参阅归档计划 XML 模式

有关修改已导出的 XML 文件以便将调度继承、备用保留、处理触发器和动态挂起(条件挂起)包括在内的详细信息,请参阅 Product Documentation for FileNet P8 Platform 中的 File Plan Import and Export Tool 一节。

限制

“归档计划导入导出”工具可加快归档计划的转移。但是,该工具不支持以下情况:

此外,在导入归档计划的其余部分之前,您必须首先在单独的 XML 文件中导出和导入定制属性(例如选项列表)和类。同时,在您导入归档计划后,实体状态(例如“已关闭”或“处理准备就绪”)不再有效。

运行工具

您可以从命令行 Java™ 可执行文件运行“归档计划导入导出”工具,或者您可以使用命令文件 FilePlanTool.bat 或 FilePlanTool.sh 启动该工具。

您可以采用下列五种方式的其中一种来执行此工具:

配置工具

以导入或导出方式运行此工具之前,必须配置此工具。

如何配置工具

  1. 浏览至安装“归档计划导入导出”工具的文件夹。
  2. 在命令行执行以下命令之一:

    在 Windows 中:
    FilePlanTool -mode configure

    在 UNIX 中:
    ./FilePlanTool.sh -mode configure

    在“归档计划工具”对话框中输入以下信息:

导出归档计划

如果要导出的归档计划包含以下项之一:

请参阅使用范围选项导出归档计划

配置工具之后,您可以使用工具来导出归档计划。要导出归档计划,请输入以下命令:

FilePlanTool -mode export -fileplan <归档计划名称> -o <XML 文件名.xml>

其中归档计划名称为要导出的归档计划的名称,并且是必需的。如果归档计划名称包含空格或特殊字符,请用引号将归档计划名称引起来。

XML 文件名是要创建的文件的名称和路径。如果您未在命令行中给出文件名,那么工具将使用由工具的配置对话框中“输出文件名”字段指定的缺省文件名。有关指定缺省 XML 输出文件名的详细信息,请参阅配置工具

使用范围选项导出归档计划

导出归档计划时,对于较大的归档计划或包含定制类或属性的归档计划,请使用范围选项。

要使用范围选项导出归档计划,请输入以下命令:

FilePlanTool -mode export -fileplan <归档计划名称> -o <XML 文件名.xml> -scope <参数>

其中归档计划名称为要导出的归档计划的名称,并且是必需的。如果归档计划名称包含空格或特殊字符,请用引号将归档计划名称引起来。

XML 文件名是您要创建的文件的名称和路径。如果您未在命令行中给出文件名,那么工具将使用由工具的配置对话框中“输出文件名”字段指定的缺省文件名。当您使用带有范围选项的工具时,工具将为归档计划的每个部分创建一个 XML 文件。因此,每次以导出方式使用此工具时,必须指定不同的 XML 文件名。有关指定缺省 XML 输出文件名的信息,请参阅配置工具

参数可以是以下任何一种:

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 文件。

如果归档计划包含定制类或属性,那么导入过程分为两个步骤。一个步骤是导入归档计划中的定制类和属性,第二个步骤是导入归档计划中的其余部分。由于定制类和属性元数据在内存中缓存,因此请先导入定制类和属性,然后等待至少五分钟再导入归档计划。缓存生存时间(TTL)为五分钟,五分钟后将清除缓存。

要导入/更新归档计划,请输入以下命令:

FilePlanTool -mode import -f <XML 文件名.xml> -reimportoption <选项>

FilePlanTool -mode update -f <XML 文件名.xml> -reimportoption <选项>

XML 文件名是您要导入的文件的名称和路径。如果您未在命令行中给出文件名,那么工具将使用由工具的配置对话框中“输出文件名”字段指定的缺省文件名。有关指定缺省 XML 输出文件名的信息,请参阅配置工具

重新导入选项确定导入归档计划中已存在的实体时工具的缺省行为。有关重新导入选项的详细信息,请参阅使用重新导入选项

在导入方式下,工具不使用范围选项,但是根据 XML 标记来确定导入对象。您必须为元数据(定制类和属性)和归档计划提供不同的 XML 文件名。

注意:XML 文件中的 ClassificationScheme 标记指定归档计划的名称。

归档计划的初始导入之后,您可以在更新方式下运行工具以做出少量修改,且您可以将后续更新与初始导入的 XML 文件相区分。将更新指定为 XML 文件中 FilePlan 标记的 InputMode 属性。您无法使用更新方式修改定制属性(例如选项列表)。

如果您收到错误消息,或导入过程停止,那么请参阅 P8 Troubleshooting Guide。在大多数情况下,遇到错误后,导入过程将停止,而不会显示任何消息。

如有必要,导入后请在实体上运行挂起扫描以应用条件挂起,因为工具不导入条件挂起。请参阅限制

验证归档计划

手动创建 XML 文件后,请通过“归档计划导入导出”工具来验证 XML 文件不包含任何错误或不符合的问题。

要在验证方式下运行导入导出工具,请输入以下命令:

FilePlanTool -mode validate -f <XML 文件名.xml>

XML 文件名是您要验证的文件的名称和路径。如果您未在命令行中给出文件名,那么工具将使用由工具的配置对话框中“输出文件名”字段指定的缺省文件名。有关指定缺省 XML 输出文件名的信息,请参阅配置工具

使用重新导入选项

使用重新导入选项来确定导入归档计划中已存在的实体时工具的缺省行为。重新导入选项有三个参数:

大型归档计划导入失败后,请使用“跳过”选项。第二次尝试导入同一归档计划期间,“跳过”选项可避免重新导入已成功导入的实体。但是,如果第二次导入尝试要求对第一次成功导入的实体进行少量修改,那么请使用“替换”选项。

在以后导入对少量实体进行的小幅修改期间,请在 XML 文件的 RMEntityObjectType 节中对实体指定 Action="Modify",而不要对原始 XML 文件进行更改。另外,使用更新方式可以更轻松地将后续更新与初始完全导入相区分。请参阅导入/更新归档计划