IBM Enterprise Records V5.1.2    

对“归档计划导入和导出”工具进行故障诊断

您需要了解使用 IBM® Enterprise Records 的“归档计划导入导出”工具时可能遇到的错误的常见原因的相关信息。还需要了解如何减小遇到错误的可能性。

错误的常见原因

在导入归档计划时,您可能会遇到错误。在大多数情况下,遇到错误后,导入过程将停止,而您看不到任何消息。错误原因可能是下列任何一个问题: “归档计划导入导出”工具提供了可用于更正潜在错误的选项。请在以下各节中了解有关这些选项的更多信息。

手动创建 XML 文件

手动创建 XML 文件表示创建 XML 文件而不使用“归档计划导入导出”工具。例如,使用宏或其他程序化方法来创建 XML 文件。在可以导入归档计划之前,先创建与 XML 标准和 XML 模式都一致的 XML 文件。

如果手动创建用于导入归档计划的 XML 文件,那么必须使该文件基于 IBM 提供的 XML 模式。

要点: 导入归档计划时发生的大多数错误都是由于 XML 文件不兼容或不一致所致。因此,如果手动创建 XML 文件,请谨慎操作。

手动创建 XML 文件之后,请在验证方式下运行“归档计划导入导出”工具。在验证方式下,此工具将读取 XML 文件并验证该文件是否未包含任何错误或不一致问题。有关验证方式的详细信息,请参阅“使用归档计划工具”主题。

本帮助主题的子类别调度继承ConditionXML 属性节对手动创建 XML 文件时的一些可用选项作了阐述。

观察“归档计划导入导出”工具的功能

要手动创建 XML 文件以导入包含定制类和对象的大型归档计划,请先创建小型归档计划以及相关元数据。 然后,以导出方式运行该工具。在为包含条件挂起、内部事件触发器和备用保留对象的归档计划手动创建 XML 文件之前,此类练习非常有用。 所有这些操作都包含复杂的 ConditionXML 属性。 即使创建了具有正确 XML 格式的文件,该 XML 文件也可能包含不正确的属性值或语法。此类不正确的信息可能会在导入期间导致错误。在导出小型归档计划时,您可以审阅该工具创建的 XML 文件。 请审阅 XML 文件以查看该 XML 文件中的语法和属性值。

使用作用域元数据选项

如果归档计划包含定制类或属性,那么必须在导出过程中使用作用域元数据选项。作用域元数据选项将为定制类和属性创建一个独立的 XML 文件。因此,如果归档计划包含定制类或属性,那么导出和导入过程都由两个步骤组成:一个步骤用于定制类和属性,另一个步骤用于归档计划的其余内容。有关使用作用域元数据选项的过程的信息,请参阅“使用归档计划工具”主题。

使用重新导入选项

重新导入选项用来指定 XML 文件中的添加操作的行为。重新导入选项有三个参数: 在大型归档计划的初始导入期间,您可能要使用跳过选项。在第二次尝试导入同一归档计划期间,请使用跳过选项以避免重新导入已成功导入的实体。但是,如果第二次导入尝试要求对第一次尝试期间成功导入的实体进行小幅修改,那么可以使用替换选项。

以后导入对少量实体的小幅修改期间,请在 XML 文件中对实体指定 Action="Modify",而不是更改原始 XML 文件。并且,使用更新方式可以更方便地将后续更新与初始完全导入加以区分。

子类别调度继承

在创建子类别时,可以使用 IBM Enterprise Records 用户界面来指定子类别继承父处理调度。如果手动创建 XML 文件以导入包含子类别的归档计划,请指定子类别不继承父代的调度。指定子类别提供不同的调度。

在创建的 XML 文件中,请使用 DisposalScheduleInheritedFrom 属性来指示记录类别是否继承父代的处理调度。例如:

<RecordCategory Name="myCat2" Level="2" ParentPath="/myCat1">
    <Properties>
        <Property Name="AGGREGATION" Value="RecordCategory" />
        <Property Name="IsPermanentRecord" Value="false" />
        <Property Name="IsVitalRecord" Value="false" />
        <Property Name="CurrentPhaseExportFormat"></Property>
        <Property Name="IsDeleted" Value="false" />
        <Property Name="HomeLocation"></Property>
        <Property Name="VitalRecordReviewAction"></Property>
        <Property Name="IncrementedBy" Value="1" />
        <Property Name="RecordCategoryName" Value="myCat2" />
        <Property Name="DisposalScheduleInheritedFrom" Value="/myCat1" />
        <Property Name="Reviewer" Value="ylin" />
        <Property Name="RecordCategoryIdentifier" Value="myCat2" />
        <Property Name="VitalRecordDisposalTrigger"></Property>
        <Property Name="Inactive" Value="false" />
        <Property Name="Location"></Property>
        <Property Name="DateOpened" Value="2006-03-07T14:16:00-08:00" />
        <Property Name="DisposalSchedule">
                <ObjectRef ClassId="DisposalSchedule" ObjectId="myDispSchedule" />
        </Property>
    </Properties> </RecordCategory>
在下列四种方案中,可以使用 DisposalScheduleInheritedFrom 属性:
<Property Name="DisposalScheduleInheritedFrom" Value="/myCat1" />

ConditionXML 属性

手动创建 XML 文件以导入归档计划时,您可以选择指定 ConditionXML 属性的值。归档计划导入工具将使用此属性来导入以下各项: 对于“备用保留”、“内部事件触发器”和“动态(条件)挂起”实体,ConditionXML 属性以 XML 格式存储搜索条件。ConditionXML 中的 properties 标记存储 IBM Enterprise Records 用户界面中的属性名称/值/运算符。ConditionXML 中的 sql 标记存储 SQL 语句。在输入用于导入归档计划的 ConditionXML 的属性值时,必须将特殊字符 (< > & " ') 转换为标准表示法。 标准表示法为 &lt;、&gt;、&amp;、&quot; 和 &apos;。请参阅以下各节中包含用于“归档计划导入导出”的 ConditionXML 属性的实体的样本 XML。

备用保留的 ConditionXML 样本

<Phases>
  <RMEntity Type="Phase" Name="myPhase1">
    <Properties>
        <Property Name="PhaseAction"></Property>
        <Property Name="RetentionPeriodDays" Value="0" />
        <Property Name="RetentionPeriodYears" Value="10" />
        <Property Name="RMEntityDescription"> Value="my phase 1" />
        <Property Name="RetentionPeriodMonths" Value="0" />
        <Property Name="PhaseNumber" Value="1" />
        <Property Name="ExportFormat"></Property>
        <Property Name="IsScreeningRequired" Value="true" />
        <Property Name="DisposalSchedulePtr">
          <ObjectRef ClassId="DisposalSchedule" ObjectId="myDispSchedule" />
        </Property>
        <Property Name="PhaseName" Value="myPhase1" />
          <ObjectValue Type="AlternateRetention">
            <Properties>
              <Property Name="RetentionBase" Value="CutoffDate" />
              <Property Name="ConditionXML" Value="&lt;response xmlns=&quot;http://www.ibm.com/namespaces
              /wcm/apps/1.0&quot;&gt;&ltobjectset&gt;&ltcount&gt;1&lt
              /count&gt;&ltcustomobject&gt;&ltproperties&gt;&ltproperty&gt;&ltsymname&gt;ClosedBy&lt
              /symname&gt;&ltoperator&gt;IEQUAL&lt;/perator&gt;&ltvalue&gt;Administrator&lt/value>
              </property></properties><aggregation></aggregation><sql> AND ([ClosedBy] = 'Administrator')
              </sql> </customobject></objectset></response>" />
              <Property Name="RetentionPeriodMonths" Value="0" />
              <Property Name="RetentionPeriodYears" Value="5" />
              <Property Name="RetentionPeriodDays" Value="0" />
            </Property>
          </ObjectValue>
          <ObjectValue Type="AlternateRetention">
            <Properties>
              <Property Name="RetentionBase" Value="DateClosed" />
              <Property Name="ConditionXML" Value="&lt;response xmlns=&quot;http://www.ibm.com/namespaces
              /wcm/apps/1.0&quot;&gt;&ltobjectset&gt;&ltcount&gt;1&lt
              /count&gt;&ltcustomobject&gt;&ltproperties&gt;&ltproperty&gt;&ltsymname&gt;
              RMEntityDescription&lt/symname&gt;&ltoperator&gt;LKE&lt;/perator&gt;&ltvalue&gt;something&lt
              /value></property></properties><aggregation></aggregation><sql> AND ([RMEntityDescription] 
              LIKE '%something%')</sql> </customobject></objectset></response>" />
              <Property Name="RetentionPeriodMonths" Value="0" />
              <Property Name="RetentionPeriodYears" Value="5" />
              <Property Name="RetentionPeriodDays" Value="0" />
            </Properties>           </ObjectValue>
        </Property
      </Properties>      <RMEntity>
</Phases>

包含 ConditionXML 的处理触发器样本:

<DisposalTriggers>
  <RMEntity Type="DisposalTrigger" Name="Date Created">
   <Properties>
     <Property Name="DisposalTriggerName" Value="Date Created" />
     <Property Name="EventType" Value="3" />
     <Property Name="CycleYears" Value="0" />
     <Property Name="CycleDays" Value="0" />
     <Property Name="AGGREGATION" Value="RecordInfo" />
     <Property Name="ConditionXML" Value="&lt;response
      xmlns=&quot;http://www.ibm.com/namespaces/wcm/apps/1.0&quot;&gt;&lt;objectset&gt;&lt;count&gt;1&lt;
      /count&gt;&lt;customobject&gt;&lt;properties&gt;&lt;property&gt;&lt;symname&gt;DateCreated&lt;
      /symname&gt;&lt;displayname&gt;Date Created&lt;/displayname&gt;&lt;propertytype&gt;3&lt;
      /propertytype&gt;&lt;value/&gt;&lt;operator&gt;IS NOT NULL&lt;/operator&gt;&lt;jointype&gt;AND&lt;
      /jointype&gt;&lt;/property&gt;&lt;/properties&gt;&lt;aggregation&gt;RecordInfo&lt;
      /aggregation&gt;&lt;sql&gt; SELECT OIID , ID , RMENTITYTYPE FROM RecordInfo WHERE ( DateCreated IS 
      NOT NULL )&lt;/sql&gt;&lt;/customobject&gt;&lt;/objectset&gt;&lt;/response&gt;"/>
     <Property Name="CycleMonths" Value="0" />
   </Properties>   </RMEntity>
</DisposalTriggers>

包含 ConditionXML 的动态挂起样本:

<Holds>
  <RMEntity Type="RecordHold" Name="dynamic Hold">
   <Properties>
     <Property Name="Active" Value="true" />
     <Property Name="HoldName" Value="dynamic Hold" />
     <Property Name="HoldReason" Value="dynamic Hold" />
     <Property Name="ConditionXML" Value="&lt;response
      xmlns=&quot;http://www.ibm.com/namespaces/wcm/apps/1.0&quot;&gt;&lt;objectset&gt;&lt;count&gt;
      2&lt;/count&gt;&lt;customobject&gt;&lt;properties&gt;&lt;property&gt;&lt;symname&gt;
      RecordCategoryName&lt;/symname&gt;&lt;displayname&gt;Record Category Name&lt;
      /displayname&gt;&lt;propertytype&gt;8&lt;/propertytype&gt;&lt;selectable&gt;true&lt;
      /selectable&gt;&lt;value&gt;dynamic&lt;/value&gt;&lt;operator&gt;like&lt;
      /operator&gt;&lt;jointype&gt;AND&lt;/jointype&gt;&lt;/property&gt;&lt;
      /properties&gt;&lt;aggregation&gt;RecordCategory&lt;/aggregation&gt;&lt;sql&gt; 
      SELECT ro.[RecordCategoryName] , ro.[RecordCategoryName] FROM RecordCategory ro 
      Where ro.[RecordCategoryName] like &apos;%dynamic%&apos; &lt;/sql&gt;&lt;
      /customobject&gt;&lt;customobject&gt;&lt;properties&gt;&lt;property&gt;&lt;symname&gt;
      RecordFolderName&lt;/symname&gt;&lt;displayname&gt;Record Folder Name&lt;
      /displayname&gt;&lt;propertytype&gt;8&lt;/propertytype&gt;&lt;selectable&gt;true&lt;
      /selectable&gt;&lt;value&gt;dynamic&lt;/value&gt;&lt;operator&gt;like&lt;
      /operator&gt;&lt;jointype&gt;AND&lt;/jointype&gt;&lt;/property&gt;&lt;
      /properties&gt;&lt;aggregation&gt;RecordFolder&lt;/aggregation&gt;&lt;sql&gt; 
      SELECT ro.[RecordFolderName] , ro.[RecordFolderName] FROM RecordFolder ro 
      Where ro.[RecordFolderName] like &apos;%dynamic%&apos; &lt;/sql&gt;&lt;/customobject&gt;&lt;
      /objectset&gt;&lt;/response&gt;" />
     <Property Name="HoldType" Value="Audit" />
   </Properties>   </RMEntity>
</Holds>

更新保留期

要将现有阶段的保留期更新为空值,必须在 XML 文件中指定不具有任何值的保留期属性(RetentionPeriodYears、RetentionPeriodMonths 和 RetentionPeriodDays)。请参阅以下示例中用于“归档计划导入导出”工具的阶段实体的样本 XML:
<RMEntity Type="Phase" Name="phase 1">
          <Properties>
             <Property Name="PhaseAction"></Property>
             <Property Name="PhaseNumber" Value="1" />
             <Property Name="ExportFormat"></Property>
             <Property Name="IsScreeningRequired" Value="false" />
             <Property Name="DisposalSchedulePtr">
                <ObjectRef ClassId="DisposalSchedule" ObjectId="mySchedule" />
             </Property>
             <Property Name="PhaseName" Value="phase 1" />
             <Property Name="RMEntityDescription" />
             <Property Name="RetentionPeriodMonths" />
             <Property Name="RetentionPeriodYears" />
             <Property Name="RetentionPeriodDays" />
             <Property Name="AlternateRetentions">
                <ObjectValue Type="AlternateRetention">
                   <Properties>
                      <Property Name="RetentionBase" Value="CutoffDate" />
                      <Property Name="ConditionXML" Value="&lt;response xmlns=&quot;
                          http://www.ibm.com/namespaces/wcm/apps/1.0&quot;&gt;&lt;objectset&gt;
                          &lt;count&gt;1&lt;/count&gt;&lt;customobject&gt;&lt;properties&gt;&lt;
                          property&gt;&lt;symname&gt;CurrentActionType&lt;
                          /symname&gt;&lt;operator&gt;IS EQUAL&lt;/operator&gt;&lt;value&gt;6&lt;
                          /value&gt;&lt;/property&gt;&lt;/properties&gt;&lt;aggregation&gt;&lt;
                          /aggregation&gt;&lt;sql&gt; AND ([CurrentActionType] = 6)&lt;/sql&gt; &lt;
                          /customobject&gt;&lt;/objectset&gt;&lt;/response&gt;" />
                      <Property Name="RetentionPeriodMonths" Value="0" />
                      <Property Name="RetentionPeriodYears" Value="2" />
                      <Property Name="RetentionPeriodDays" Value="0" />
                   </Properties>                 </ObjectValue>
             </Property>
          </Properties>        </RMEntity>


反馈

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

© Copyright IBM Corporation 2013