IBM Enterprise Records verze 5.1.2    

Odstraňování problémů s Nástrojem pro import a export plánu souborů

Je zapotřebí se seznámit s informacemi o běžných příčinách chyb, se kterými se můžete setkat při použití Nástroje pro import a export plánu souborů produktu IBM® Enterprise Records. Je také nutné znát způsob snížení pravděpodobnosti výskytu chyb.

Běžné příčiny chyb

Při importu plánu souborů může dojít k chybám. Ve většině případů se proces importu po zjištění chyby zastaví a nezobrazuje žádnou zprávu. Příčinou chyby může být libovolná z těchto situací: Nástroj pro import a export plánu souborů obsahuje volby, které můžete využít k řešení potenciálních chyb. Další informace o těchto možnostech naleznete v následujících tématech.

Ruční vytvoření souboru XML

Ruční vytvoření souboru XML znamená vytvoření souboru XML bez použití nástroje pro import a export plánu souborů. Například tvorba souboru XML pomocí maker nebo dalších programových prostředků. Dříve než můžete importovat plán souborů, vytvořte soubor XML, který vyhovuje standardu XML a je kompatibilní se schématem XML.

Pokud ručně vytváříte soubor XML, který se má použít při importu plánu souborů, musíte při tvorbě vycházet ze schématu XML poskytnutého společností IBM.

Důležité: Většina chyb, se kterými se setkáte při importu plánu souborů, je způsobena soubory XML, které jsou nekompatibilní nebo nevyhovují standardu XML. Proto je třeba ručnímu vytváření souboru XML věnovat zvláštní péči.

Po ručním vytvoření souboru XML spusťte Nástroj pro import a export plánu souborů v režimu ověřování. Nástroj v režimu ověřování přečte soubor XML a ověří, zda tento soubor neobsahuje žádné chyby nebo prvky nevyhovující standardu XML. Další informace o režimu ověřování naleznete v tématu použití nástroje plánu souborů.

Některé volby, které jsou dostupné při ručním vytváření souboru XML, jsou obsaženy v částech Dědičnost podkategorie plánu a Vlastnost ConditionXML tohoto tématu nápovědy.

Prozkoumání funkcí Nástroje pro import a export plánu souborů

Chcete-li ručně vytvořit soubor XML pro import velkého plánu souborů s vlastními třídami a objekty, vytvořte nejdříve malý plán souborů a související metadata. Potom spusťte nástroj v režimu exportu. Takové procvičení je důležité před ručním vytvořením souboru XML u plánu souborů s podmíněným zadržením, spouštěči interních událostí a objekty alternativního uchování. Všechny tyto akce obsahují komplexní vlastnost Vlastnost ConditionXML. I když vytváříte soubor se správným formátem XML, soubor XML může obsahovat chybné hodnoty vlastností nebo syntaxi. Tyto nesprávné informace mohou způsobit chybu při importu. Soubor XML vytvořený nástrojem při exportu malého plánu souborů můžete zkontrolovat. V souboru XML zkontrolujte syntaxi a hodnoty vlastností.

Použití volby metadat rozsahu

Pokud váš plán souborů obsahuje vlastní třídy nebo vlastnosti, musíte během procesu exportu použít volbu metadat rozsahu. Volba metadat rozsahu vytvoří samostatný soubor XML pro vlastní třídy a vlastnosti. Proto platí, že pokud plán souborů obsahuje vlastní třídy nebo vlastnosti, procesy exportu a importu sestávají ze dvou kroků: jeden krok pro vlastní třídy a vlastnosti a druhý pro zbytek plánu souborů. Informace o postupech použití volby metadat rozsahu naleznete v tématu použití nástroje plánu souborů.

Použití volby opětovného importování

Volba opětovného importování se používá k určení chování akce přidání v souboru XML. Volba opětovného importování má tři parametry: Pokud chcete, můžete během prvotního importu velkého plánu souborů použít volbu Přeskočit. Během druhého pokusu o import téhož plánu souborů zabráníte opětovnému importování entit, které již byly úspěšně importovány, pomocí volby Přeskočit. Pokud však druhý pokus o importování vyžaduje menší úpravy entit, které byly při prvním pokusu úspěšně importovány, bude vhodné použít volbu Nahradit.

Při následujících importech menších úprav malého počtu entit v souboru XML entit zadejte místo změn v původním souboru XML Action="Modify". Použití režimu Aktualizace rovněž umožňuje snadnější odlišení následných aktualizací od počátečních plných importů.

Dědičnost podkategorie plánu

Při vytváření podkategorie můžete použít uživatelské rozhraní produktu IBM Enterprise Records a v něm určit, že podkategorie dědí nadřízený plán odebrání. Pokud ručně vytváříte soubor XML pro účel importu plánu souborů, v němž je obsažena podkategorie, určete, že tato podkategorie nebude dědit nadřízený plán. Zadejte, že podkategorie poskytuje jiný plán.

Ve vytvářeném souboru XML použijte vlastnost DisposalScheduleInheritedFrom k označení, zda kategorie záznamu dědí plán odebrání od nadřízené entity. Například:

<RecordCategory Name="mojeKat2" Level="2" ParentPath="/mojeKat1">
    <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="mojeKat2" />
        <Property Name="DisposalScheduleInheritedFrom" Value="/mojeKat1" />
        <Property Name="Reviewer" Value="Patrik" />
        <Property Name="RecordCategoryIdentifier" Value="mojeKat2" />
        <Property Name="VitalRecordDisposalTrigger"></Property>
        <Property Name="Inactive" Value="false" />
        <Property Name="Location"></Property>
        <Property Name="DateOpened" Value="2011-03-07T14:16:00-08:00" />
        <Property Name="DisposalSchedule">
                <ObjectRef ClassId="DisposalSchedule" ObjectId="mujPlanOdebr" />
        </Property>
    </Properties>
</RecordCategory>
Existují čtyři scénáře, ve kterých můžete použít vlastnost DisposalScheduleInheritedFrom:
<Property Name="DisposalScheduleInheritedFrom" Value="/mojeKat1" />

Vlastnost ConditionXML

Při ručním vytváření souboru XML za účelem importu plánu souborů máte možnost určit hodnoty pro vlastnost ConditionXML. Nástroj pro import plánu souborů využívá tuto vlastnost pro importování následujících položek: Pro entity alternativní uchování, spouštěče interní události a dynamická (podmíněná) zadržení uchovává vlastnost ConditionXML podmínky hledání ve formátu XML. Značka vlastností ve vlastnosti ConditionXML uchovává název vlastnosti/hodnotu/operátor pro uživatelské rozhraní produktu IBM Enterprise Records. Značka sql ve vlastnosti ConditionXML uchovává příkaz SQL. Když zadáte hodnotu vlastnosti ConditionXML pro import plánu souborů, je nutno převést speciální znaky (< > & " ') na standardní reprezentaci. Standardní reprezentace je &lt;, &gt;, &amp;, &quot; a &apos;. V následujících částech jsou uvedeny ukázkové výrazy XML entit obsahujících vlastnost ConditionXML pro import a export plánu souborů.

Ukázka vlastnosti ConditionXML pro alternativní uchování

<Phases>
  <RMEntity Type="Phase" Name="mojeFaze1">
    <Properties>
        <Property Name="PhaseAction"></Property>
        <Property Name="RetentionPeriodDays" Value="0" />
        <Property Name="RetentionPeriodYears" Value="10" />
        <Property Name="RMEntityDescription"> Value="moje faze 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="mujPlanOdebr" />
        </Property>
        <Property Name="PhaseName" Value="mojeFaze1" />
          <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>

Ukázka spouštěče odebrání s vlastností ConditionXML:

<DisposalTriggers>
  <RMEntity Type="DisposalTrigger" Name="Datum vytvoreni">
   <Properties>
     <Property Name="DisposalTriggerName" Value="Datum vytvoreni" />
     <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;Datum vytvoreni&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>

Ukázka dynamického zadržení s vlastností ConditionXML:

<Holds>
  <RMEntity Type="RecordHold" Name="dynamicke zadrzeni">
   <Properties>
     <Property Name="Active" Value="true" />
     <Property Name="HoldName" Value="dynamicke zadrzeni" />
     <Property Name="HoldReason" Value="dynamicke zadrzeni" />
     <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>

Aktualizace období uchování

Chcete-li aktualizovat období uchování existující fáze na hodnotu null, je nutné začlenit do souboru XML vlastnosti období uchování (RetentionPeriodYears, RetentionPeriodMonths a RetentionPeriodDays) bez hodnoty. V následujícím příkladu najdete ukázku souboru XML entity fáze pro Nástroj pro import a export plánu souborů:
<RMEntity Type="Phase" Name="faze 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="faze 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>


Váš názor

Poslední aktualizace: Listopad 2013
file_plan_import_export_tips.htm

© Copyright IBM Corp. 2013