IBM Enterprise Records, verzia 5.1.2    

Riešenie problémov s nástrojom File Plan Import Export Tool

Je potrebné, aby ste poznali bežné príčiny chýb, ktoré môžete zaznamenať počas používania nástroja File Plan Import Export Tool IBM® Enterprise Records. Musíte tiež vedieť ako znížiť pravdepodobnosť zaznamenania chýb.

Bežné príčiny chýb

Pri importovaní plánu súborov môžete zaznamenať chybu. Vo väčšine prípadov sa po zaznamenaní chyby proces importu zastaví a nie je vidno žiadnu správu. Príčinou chyby môže byť ktorýkoľvek z nasledujúcich problémov: Nástroj na importovanie a exportovanie plánu súborov zahŕňa voľby, ktoré môžete použiť na adresovanie potenciálnych chýb. Viac informácií o týchto voľbách nájdete v nasledujúcich častiach.

Manuálne vytvorenie súboru XML

Manuálne vytvorenie súboru XML znamená vytvorenie súboru XML bez použitia nástroja na importovanie a exportovanie plánu súborov. Súbor XML vytvoríte napríklad pomocou makier alebo iných programovacích prostriedkov. Skôr ako budete môcť importovať plán súborov vytvorte súbor XML, ktorý vyhovuje štandardu XML a je kompatibilný so schémou XML.

Ak manuálne vytvoríte súbor XML, ktorý sa použije pri importovaní plánu súborov, súbor musíte založiť na schéme XML, ktorú poskytuje spoločnosť IBM.

Dôležité: Väčšina chýb, ktoré nastanú počas importovania plánu súborov, je spôsobených nekompatibilnými alebo nevyhovujúcimi súbormi XML. Pri manuálnom vytvorení súboru XML preto postupujte opatrne.

Po manuálnom vytvorení súboru XML spustite nástroj na importovanie a exportovanie plánu súborov v režime overenia. Nástroj v režime overenia prečíta súbor XML a skontroluje, či neobsahuje chyby alebo problémy súvisiace s nesúladom s nariadeniami. Podrobnosti o režime overenia nájdete v téme o používaní nástroja plánu súborov.

Niektoré z volieb dostupných pri manuálnom vytvorení súboru XML sú zahrnuté v častiach Dedenie plánu podkategórie a Vlastnosť ConditionXML tejto témy pomoci.

Pozorovanie funkcií nástroja importovanie a exportovanie plánu súborov

Ak chcete manuálne vytvoriť súbor XML na importovanie veľkého plánu súborov s vlastnými triedami a objektmi, vytvorte najprv malý plán súborov a súvisiace metaúdaje. Nástroj následne spustite v režime exportovania. Takéto cvičenie je užitočné pred manuálnym vytvorením súboru XML pre plány súborov s podmienenými pozastaveniami, spúšťačmi interných udalostí a objektmi alternatívnych uchovávaní. Všetky tieto akcie obsahujú komplexný Vlastnosť ConditionXML. Napriek tomu, že vytvárate súbor so správnym formátom XML, súbor XML môže mať nesprávne hodnoty vlastností alebo syntax. Tieto nesprávne informácie môžu počas importovania spôsobovať chybu. Súbor XML, ktorý vytvorí nástroj, môžete skontrolovať pri exporte malého plánu súborov. Súbor XML skontrolujte, aby ste videli syntax a hodnoty vlastností v súbore XML.

Používanie voľby metaúdajov rozsahu

Ak váš plán súborov obsahuje vlastné triedy alebo vlastnosti, počas procesu exportovania musíte použiť voľbu metaúdajov rozsahu. Voľba metaúdajov rozsahu vytvorí osobitný súbor XML pre vlastné triedy a vlastnosti. Preto keď plán súborov obsahuje vlastné triedy alebo vlastnosti, proces exportovania aj proces importovania sa skladá z dvoch krokov: jeden krok pre vlastné triedy a vlastnosti a druhý krok pre zvyšok plánu súborov. Informácie o postupoch na používanie voľby metaúdajov rozsahu nájdete v téme o používaní nástroja plánu súborov.

Používanie voľby opakovaného importovania

Voľba opakovaného importovania sa používa na určenie správania akcie pridania v súbore XML. Voľba reimport má tri parametre: Počas úvodného importovania veľkého plánu súborov môžete použiť voľbu Skip. Pri druhom pokuse importovať rovnaký plán súborov použite voľbu Skip, aby ste sa vyhli opakovanému importu entít, ktoré boli úspešne importované. Ak však druhý pokus importovať vyžaduje menšie modifikácie na entitách, ktoré boli úspešne importované prvý raz, použite voľbu Replace.

Pri nasledujúcich importoch menších modifikácií na málo entitách zadajte v súbore XML pre entity Action="Modify", nemeňte pôvodný súbor XML. Použitie režimu Update vám tiež umožní ľahšie identifikovať následné aktualizácie z pôvodných úplných importov.

Dedenie plánu podkategórie

Pri vytvorení podkategórie môžete použiť užívateľské rozhranie IBM Enterprise Records, aby ste zadali, že podkategória zdedí rodičovský plán dostupnosti. Ak manuálne vytvoríte súbor XML na importovanie plánu súborov, v ktorom je obsiahnutá podkategória, zadajte, že podkategória nezdedí plán rodiča. Zadajte, že podkategória poskytuje iný plán.

Pomocou vlastnosti DisposalScheduleInheritedFrom indikujte v súbore XML, ktorý vytvoríte, či kategória záznamov zdedí plán dostupnosti od rodiča. Napríklad:

<KategóriaZáznamov Názov="myCat2" Úroveň="2" RodičovskáCesta="/myCat1">
    <Vlastnosti>
        <Názov vlastnosti="AGGREGATION" Hodnota="RecordCategory" />
        <Názov vlastnosti="IsPermanentRecord" Hodnota="false" />
        <Názov vlastnosti="IsVitalRecord" Hodnota="false" />
        <Názov vlastnosti="CurrentPhaseExportFormat"></Property>
        <Názov vlastnosti="IsDeleted" Hodnota="false" />
        <Názov vlastnosti="HomeLocation"></Property>
        <Názov vlastnosti="VitalRecordReviewAction"></Property>
        <Názov vlastnosti="IncrementedBy" Hodnota="1" />
        <Názov vlastnosti="RecordCategoryName" Hodnota="myCat2" />
        <Názov vlastnosti="DisposalScheduleInheritedFrom" Hodnota="/myCat1" />
        <Názov vlastnosti="Reviewer" Hodnota="ylin" />
        <Názov vlastnosti="RecordCategoryIdentifier" Hodnota="myCat2" />
        <Názov vlastnosti="VitalRecordDisposalTrigger"></Property>
        <Názov vlastnosti="Inactive" Hodnota="false" />
        <Názov vlastnosti="Location"></Property>
        <Názov vlastnosti="DateOpened" Hodnota="2006-03-07T14:16:00-08:00" />
        <Názov vlastnosti="DisposalSchedule">
                <ObjectRef ID triedy="DisposalSchedule" ID objektu="myDispSchedule" />
        </Vlastnosť>
    </Vlastnosti>
</KategóriaZáznamov>
Sú štyri scenáre, na základe ktorých môžete použiť vlastnosť DisposalScheduleInheritedFrom:
<Názov vlastnosti="DisposalScheduleInheritedFrom" Hodnota="/myCat1" />

Vlastnosť ConditionXML

Pri manuálnom vytvorení súboru XML, ktorý sa použije pri importovaní plánu súborov, máte možnosť zadať hodnoty pre vlastnosť ConditionXML. Nástroj na importovanie plánu súborov používa túto vlastnosť na importovanie týchto položiek: Vlastnosť ConditionXML uchováva podmienky vyhľadávania vo formáte XML pre entity alternatívnych uchovávaní, spúšťačov interných udalostí a dynamických (podmienených) pozastavení. Značka vlastností vo vlastnosti ConditionXML uchováva názov/hodnotu/operátor vlastnosti pre užívateľské rozhranie IBM Enterprise Records. Značka sql v ConditionXML uchováva príkaz SQL. Pri zadaní hodnoty vlastnosti ConditionXML pre importovanie plánu súborov je potrebné konvertovať špeciálne znaky (< > & " ') na štandardné znázornenie. Štandardné znázornenie je &lt;, &gt;, &amp;, &quot;, a &apos;. Pozrite si vzorové XML entít, ktoré obsahujú vlastnosť ConditionXML pre importovanie a exportovanie plánu súborov v týchto častiach.

Vzorka ConditionXML pre alternatívne uchovávanie

<Fázy>
  <EntitaRM Typ="Phase" Názov="myPhase1">
    <Vlastnosti>
        <Názov vlastnosti="PhaseAction"></Vlastnosť>
        <Názov vlastnosti="RetentionPeriodDays" Hodnota="0" />
        <Názov vlastnosti="RetentionPeriodYears" Hodnota="10" />
        <Názov vlastnosti="RMEntityDescription"> Hodnota="my phase 1" />
        <Názov vlastnosti="RetentionPeriodMonths" Hodnota="0" />
        <Názov vlastnosti="PhaseNumber" Hodnota="1" />
        <Názov vlastnosti="ExportFormat"></Vlastnosť>
        <Názov vlastnosti="IsScreeningRequired" Hodnota="true" />
        <Názov vlastnosti="DisposalSchedulePtr">
          <ObjectRef ID triedy="DisposalSchedule" ID objektu="myDispSchedule" />
        </Vlastnosť>
        <Názov vlastnosti="PhaseName" Hodnota="myPhase1" />
          <HodnotaObjektu Typ="AlternateRetention">
            <Vlastnosti>
              <Názov vlastnosti="RetentionBase" Hodnota="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>" />
              <Názov vlastnosti="RetentionPeriodMonths" Hodnota="0" />
              <Názov vlastnosti="RetentionPeriodYears" Hodnota="5" />
              <Názov vlastnosti="RetentionPeriodDays" Hodnota="0" />
            </Vlastnosť>
          </HodnotaObjektu>
          <HodnotaObjektu Typ="AlternateRetention">
            <Vlastnosti>
              <Názov vlastnosti="RetentionBase" Hodnota="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>" />
              <Názov vlastnosti="RetentionPeriodMonths" Hodnota="0" />
              <Názov vlastnosti="RetentionPeriodYears" Hodnota="5" />
              <Názov vlastnosti="RetentionPeriodDays" Hodnota="0" />
            </Vlastnosti>
          </HodnotaObjektu>
        </Vlastnosť
      </Vlastnosti>
     <EntitaRM>
</Fázy>

Vzorka spúšťača dostupnosti s vlastnosťou ConditionXML:

<SpúšťačaDostupnosti>
  <EntitaRM Typ="DisposalTrigger" Názov="Date Created">
   <Vlastnosti>
     <Názov vlastnosti="DisposalTriggerName" Hodnota="Date Created" />
     <Názov vlastnosti="EventType" Hodnota="3" />
     <Názov vlastnosti="CycleYears" Hodnota="0" />
     <Názov vlastnosti="CycleDays" Hodnota="0" />
     <Názov vlastnosti="AGGREGATION" Hodnota="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;"/>
     <Názov vlastnosti="CycleMonths" Hodnota="0" />
   </Vlastnosti>
  </EntitaRM>
</SpúšťačeDostupnosti>

Vzorka dynamického pozastavenia s ConditionXML:

<Pozastavenia>
  <EntitaRM Typ="RecordHold" Názov="dynamic Hold">
   <Vlastnosti>
     <Názov vlastnosti="Active" Hodnota="true" />
     <názov vlastnosti="HoldName" Hodnota="dynamic Hold" />
     <názov vlastnosti="HoldReason" Hodnota="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;" />
     <Názov vlastnosti="HoldType" Hodnota="Audit" />
   </Vlastnosti>
  </EntitaRM>
</Pozastavenia>

Aktualizácie doby uchovávania

Ak chcete aktualizovať dobu uchovávania existujúcej fázy na null, vlastnosti doby uchovávania (RetentionPeriodYears, RetentionPeriodMonths a RetentionPeriodDays) musia byť zahrnuté do súboru XML bez hodnoty. Pozrite si vzorový XML entity fázy pre nástroj na importovanie a exportovanie plánu súborov v nasledujúcom príklade:
<EntitaRM Typ="Phase" Názov="phase 1">
          <Vlastnosti>
             <Názov vlastnosti="PhaseAction"></Vlastnosť>
             <Názov vlastnosti="PhaseNumber" Hodnota="1" />
             <Názov vlastnosti="ExportFormat"></Vlastnosť>
             <Názov vlastnosti="IsScreeningRequired" Hodnota="false" />
             <Názov vlastnosti="DisposalSchedulePtr">
                <ObjectRef ID triedy="DisposalSchedule" ID objektu="mySchedule" />
             </Vlastnosť>
             <Názov vlastnosti="PhaseName" Hodnota="phase 1" />
             <Názov vlastnosti="RMEntityDescription" />
             <Názov vlastnosti="RetentionPeriodMonths" />
             <Názov vlastnosti="RetentionPeriodYears" />
             <Názov vlastnosti="RetentionPeriodDays" />
             <Názov vlastnosti="AlternateRetentions">
                <HodnotaObjektu Typ="AlternateRetention">
                   <Vlastnosti>
                      <Názov vlastnosti="RetentionBase" Hodnota="CutoffDate" />
                      <Názov vlastnosti="ConditionXML" Hodnota="&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;" />
                      <Názov vlastnosti="RetentionPeriodMonths" Hodnota="0" />
                      <Názov vlastnosti="RetentionPeriodYears" Hodnota="2" />
                      <Názov vlastnosti="RetentionPeriodDays" Hodnota="0" />
                   </Vlastnosti>
                </HodnotaObjektu>
             </Vlastnosť>
          </Vlastnosti>
       </RMEntity>


Spätná väzba

Posledná aktualizácia: November 2013
file_plan_import_export_tips.htm

© Copyright IBM Corp. 2013