IBM Enterprise Records, 版本 5.1.+            

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

对于 IBM® Enterprise Records 部署,可以使用“归档计划导入导出工具”来导入外部归档计划,或者将归档计划导出到外部环境。该工具使用 XML 文件来完成导入导出过程。

概述

有关修改已导出的 XML 文件以便将调度继承、备用保留、处理触发器和动态挂起(条件挂起)包括在内的详细信息,请参阅 http://www-01.ibm.com/support/docview.wss?rs=3247&uid=swg27010422 中的“File Plan Import and Export Tool”一节。

限制

“归档计划导入导出”工具可加快归档计划的迁移。但是,该工具不支持以下情况: 此外,在导入归档计划的其余部分之前,您必须首先在单独的 XML 文件中导出和导入定制属性(例如选项列表)和类。同时,在您导入归档计划后,实体状态(例如,已关闭处理准备就绪)不再有效。

运行工具

您可以从命令行 Java 可执行文件运行“归档计划导入导出工具”,或者您可以使用命令文件 FilePlanTool.batFilePlanTool.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 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

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 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 文件进行更改。另外,使用更新方式可以更轻松地将后续更新与初始完全导入相区分。请参阅导入/更新归档计划


反馈

最近一次更新时间: 2011 年 8 月


© Copyright IBM Corporation 2011.
本信息中心基于 Eclipse 技术。(http://www.eclipse.org)