IBM Enterprise Records, Verze 5.1.+            

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, jakož i se způsobem 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. Těmito volbami se zabývají následující části.

Ruční vytvoření souboru XML

Pro účely diskuse se za ruční vytvoření souboru XML označuje vytvoření souboru XML jiným způsobem než pomocí Nástroje pro import a export plánu souborů (například s použitím maker nebo jiných programovacích prostředků k vytvoření souboru XML). Předtím, než můžete importovat plán souborů, musíte vytvořit soubor XML, který vyhovuje standardu XML a je kompatibilní se schématem XML softwaru FileNet.

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.

Důrazně se doporučuje, abyste po ručním vytvoření souboru XML spustili 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 (podrobnosti o režimu ověřování naleznete v části Použití Nástroje pro import a export 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.

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

Pokud zamýšlíte ručně vytvořit soubor XML pro import velkého plánu souborů s vlastními třídami a objekty, doporučuje se, abyste nejprve vytvořili malý plán souborů a související metadata, a spustili nástroj v režimu exportu. Takové procvičení je důležité zejména 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í, z nichž všechny 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, což může způsobit chybu během importu. Export malého plánu souborů umožní zkontrolovat soubor XML, který nástroj vytvořil, a dodržet syntaxi a hodnoty vlastností v souboru XML.

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ů. Téma nápovědy Použití Nástroje pro import a export plánu souborů obsahuje postupy pro použití volby metadat rozsahu.

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. V případě selhání a během druhého pokusu o importování téhož plánu souborů použijte volbu Přeskočit, která zabrání opětovnému importování entit, které již byly úspěšně importovány. 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 pravděpodobně vhodné použít volbu Nahradit.

Při následných importech menších úprav malého počtu entit se namísto provádění změn v původním souboru XML doporučuje v souboru XML pro entity určit 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, máte možnost určit, že tato podkategorie nebude dědit nadřízený plán, a poskytnout odlišný 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 podle následujícího postupu:
<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, kterou Nástroj pro import plánu souborů využívá 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 vyhledává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 (&lt; &gt; &amp; &quot; &apos;). Níže 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://filenet.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://filenet.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://filenet.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>

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

<Holds>
    <RMEntity Type="RecordHold" Name="dynamické zadržení">
       <Properties>
           <Property Name="Active" Value="true" />
           <Property Name="HoldName" Value="dynamické zadržení" />
           <Property Name="HoldReason" Value="dynamické zadržení" />
           <Property Name="ConditionXML" Value="&lt;response
xmlns=&quot;http://filenet.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 nutno začlenit do souboru XML vlastnosti období uchování (RetentionPeriodYears, RetentionPeriodMonths a RetentionPeriodDays) s nulovou hodnotou. Níže následuje ukázka 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="mujPlan" />
                         </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://filenet.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>


Zpětná vazba

Poslední aktualizace: Srpen 2011


© Copyright IBM Corp. 2011.
Toto Informační centrum využívá technologii Eclipse. (http://www.eclipse.org)