IBM Enterprise Records, 버전 5.1.2    

파일 계획 가져오기 및 내보내기 도구 문제점 해결

IBM® Enterprise Records 파일 계획 가져오기 내보내기 도구를 사용할 때 발생할 수 있는 오류의 공통 원인에 대한 정보를 알아야 합니다. 또한 오류 발생 가능성을 줄이는 방법에 대해서도 알아야 합니다.

일반적인 오류 원인

파일 계획을 가져오는 경우 오류가 발생할 수 있습니다. 대부분의 경우, 가져오기 프로세스는 오류가 발생한 후 중지되고 메시지를 표시하지 않습니다. 오류의 원인은 다음 문제 중 하나일 수 있습니다. 파일 계획 가져오기 내보내기 도구에는 잠재적 오류를 해결하는 데 사용할 수 있는 옵션이 있습니다. 다음 섹션에서 이들 옵션에 대해 좀 더 학습할 수 있습니다.

수동으로 XML 파일 작성

XML 파일을 수동으로 작성한다는 것은 파일 계획 가져오기 내보내기 도구를 사용하지 않고 XML 파일을 작성한다는 의미입니다. 예를 들어, 매크로 또는 기타 프로그램 방식을 사용하여 XML 파일을 작성합니다. 파일 계획을 가져오기 전에, XML 표준에 부합되고 XML 스키마와 호환되는 XML 파일을 작성하십시오.

파일 계획을 가져올 때 사용할 XML 파일을 수동으로 작성하는 경우 IBM에서 제공하는 XML 스키마를 파일의 기반으로 사용해야 합니다.

중요사항: 파일 계획을 가져올 때 발생하는 대부분의 오류는 호환되지 않는 XML 파일 또는 비규격 XML 파일에 의해 발생합니다. 따라서 XML 파일을 수동으로 작성하는 경우에는 주의하십시오.

XML 파일을 수동으로 작성한 후, 유효성 검증 모드로 파일 계획 가져오기 내보내기 도구를 실행하십시오. 이 도구은 유효성 검증 모드에서 XML 파일을 읽고 파일에 오류 또는 비규격 문제가 없는지 확인합니다. 유효성 검증 모드에 대한 자세한 내용은 파일 계획 도구 사용 주제를 참조하십시오.

XML 파일을 수동으로 작성할 때 사용할 수 있는 일부 옵션은 이 도움말 항목의 하위 카테고리 스케줄 상속ConditionXML 특성 절에 포함되어 있습니다.

파일 계획 가져오기 내보내기 도구 기능 관찰

사용자 정의 클래스 및 오브젝트를 포함한 대형 파일 계획을 가져오기 위해 XML 파일을 수동으로 작성하려면, 먼저 소형 파일 계획 및 관련 메타데이터를 작성하십시오. 그런 다음, 내보내기 모드로 도구를 실행하십시오. 이러한 연습은 조건부 보류, 내부 이벤트 트리거 및 대체 보유 오브젝트를 사용하여 파일 계획을 위한 XML 파일을 수동으로 작성하기 전에 유용합니다. 이러한 모든 수행은 복합 ConditionXML 특성에 포함되어 있습니다. 올바른 XML 형식으로 파일을 작성하더라도, XML 파일에는 올바르지 않은 특성 값 또는 구문이 있을 수 있습니다. 이 올바르지 않은 정보는 가져오기 중에 오류를 유발할 수 있습니다. 소형 파일 계획을 내보내면 도구에서 작성하는 XML 파일을 검토할 수 있습니다. XML 파일을 검토하여 XML 파일에서 구문 및 특성 값을 확인하십시오.

범위 메타데이터 옵션 사용

파일 계획이 사용자 정의 클래스 또는 특성을 포함할 경우 가져오기 프로세스 중에 범위 메타데이터 옵션을 사용해야 합니다. 범위 메타데이터 옵션은 사용자 정의 클래스 및 특성에 대한 개별 XML 파일을 작성합니다. 따라서, 파일 계획에 사용자 정의 클래스 또는 특성이 포함된 경우 내보내기 및 가져오기 프로세스는 사용자 정의 클래스 및 특성 단계와 나머지 파일 계획 단계의 두 단계로 구성됩니다. 범위 메타데이터 옵션 사용 절차에 대한 정보는 파일 계획 도구 사용 주제를 참조하십시오.

다시 가져오기 옵션 사용

다시 가져오기 옵션은 XML 파일의 추가 조치의 동작을 지정하는 데 사용됩니다. 다시 가져오기 옵션에는 다음과 같은 세 개의 매개변수가 있습니다. 대형 파일 계획을 초기에 가져오는 중에 건너 뛰기 옵션을 사용할 수 있습니다. 두 번째 동일한 파일 계획 가져오기 시도 도중, 건너 뛰기 옵션을 사용하여 가져온 엔티티를 다시 가져오는 경우를 피하십시오. 그러나 두 번째 가져오기 시도에서 처음에 가져온 엔티티를 부분적으로 수정해야 할 경우에는 바꾸기 옵션을 사용할 수 있습니다.

이후에 소수의 엔티티에 대한 부분적 수정을 가져오는 중에는 원래 XML 파일을 변경하는 대신 XML 파일에 엔티티에 대한 Action="Modify"를 지정하십시오. 또한 업데이트 모드를 사용하여 처음 전체 가져오기와 후속 업데이트를 더욱 쉽게 식별합니다.

하위 카테고리 스케줄 상속

하위 카테고리를 작성하는 경우 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의 특성 태그는 IBM Enterprise Records 사용자 인터페이스에 대한 특성 이름/값/연산자를 저장합니다. ConditionXMLsql 태그는 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>

보유 기간 업데이트

기존 단계의 보유 기간을 널(NULL)로 업데이트하려면, 보유 기간 특성(RetentionPeriodYears, RetentionPeriodMonths 및 RetentionPeriodDays)을 값 없이 XML 파일에 포함시켜야 합니다. 다음 예제에서 파일 계획 가져오기 내보내기 도구를 위한 단계 엔티티의 샘플 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 Corp. 2013