IBM Enterprise Records V5.1.2    

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

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

概述

有关修改已导出的 XML 文件以便将调度继承、备用保留、处理触发器和动态挂起包括在内的详细信息,请参阅“对‘归档计划导入和导出’工具进行故障诊断”主题。

限制

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

运行工具

您可以从命令行 Java 可执行程序来运行“归档计划导入导出”工具。或者,您可以使用以下命令文件来启动该工具:FilePlanTool.batFilePlanTool.sh。 您可以采用下列五种方式中的一种来运行此工具:

配置该工具

以导入或导出方式运行此工具之前,必须配置此工具。如何配置该工具:
  1. 转至安装“归档计划导入导出”工具的文件夹。
  2. 在命令行运行下列其中一个命令:
    操作系统 命令
    Windows FilePlanTool -mode configure
    AIX、HP-UX、Linux 和 Solaris 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 中的完整路径。例如,要导出名为 Cat03 的记录类别中的所有子代,请输入下列命令。Cat03 包含在 Cat02 中,而 Cat02 又包含在 Cat01 中。

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 文件。如果归档计划包含定制类或属性,那么导入过程分为两个步骤。第一步是导入归档计划中的定制类和属性。第二步是导入归档计划中的其余部分。首先导入定制类和属性。 然后,等待至少 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 文件。另外,使用更新方式可以更轻松地将后续更新与初始完全导入相区分。请参阅导入/更新归档计划


反馈

最近一次更新时间: 2013 年 11 月
fileplan_import_export.htm

© Copyright IBM Corporation 2013