IBM Enterprise Records, 5.1.2-es változat    

Fájlterv importálás exportálás eszköz hibaelhárítása

Ismernie kell azokat az általános hibaokokat, amelyekkel az IBM® Enterprise Records Fájlterv Importálás és Exportálás eszköz használata során találkozhat. Azt is tudnia kell, hogyan csökkentheti a hibák előfordulásának valószínűségét.

Hibák általános okai

Fájlterv importálásakor hiba történhet. A legtöbb esetben az importálási folyamat leáll hiba észlelésekor, és nem látható semmilyen üzenet. A hiba oka az alábbi problémák bármelyike lehet: A Fájlterv importálás exportálás eszköz olyan lehetőségeket tartalmaz, amelyek felhasználhatók lehetséges hibák azonosítására. Ezeket a lehetőségeket a következő szakaszokban ismerheti meg.

XML fájl saját kezű létrehozása

Az XML fájl saját kezű létrehozása egy XML fájl létrehozását jelenti a Fájlterv importálás exportálás eszköz nélkül. Például ez lehet makrók vagy egyéb programozható eszközök használata XML fájl létrehozásához. Fájlterv importálása előtt hozzon létre egy XML fájlt, amely XML szabványnak megfelelő, egyúttal kompatibilis az XML sémával.

Ha saját kezűleg hoz létre XML fájlt fájlterv importálásához, akkor a fájlt az IBM által biztosított XML sémára kell alapoznia.

Fontos: A fájlterv importálása során fellépő hibák többségét inkompatibilis vagy elvárásnak nem megfelelő XML fájlok okozzák. Legyen ezért körültekintő XML fájl saját kezű létrehozásakor.

XML fájl saját kezű létrehozása után futtassa a Fájlterv Importálás Exportálás eszközt érvényesítés módban. Az eszköz érvényesítés módban beolvassa az XML fájlt, majd ellenőrzi, hogy a fájl nem tartalmaz-e hibákat vagy nemmegfelelési problémákat. Az érvényesítés módról részletekért tanulmányozza a fájlterv eszköz használata témakört.

Az XML fájl saját kezű létrehozása során ennek a súgó témakörnek az Alkategória ütemezés öröklés és ConditionXML tulajdonság szakaszaiban érhető el néhány lehetőség.

A Fájlterv importálási exportálási eszköz funkcióinak vizsgálata

Egy nagy fájlterv egyéni osztályokkal és objektumokkal történő importálásához XML fájl saját kezű létrehozása érdekében először hozzon létre egy kisebb fájltervet és kapcsolódó metaadatokat. Ezután futtassa az eszközt exportálási módban. Egy ilyen gyakorlat hasznos, mielőtt saját kezűleg hoz létre XML fájlt fájltervekhez feltételes felfüggesztésekkel, belső eseményaktiválókkal és alternatív megtartás objektumokkal. Az összes ilyen műveletnek része a komplex ConditionXML tulajdonság. Még ha helyes XML formátumú fájlt hoz is létre, az XML fájl akkor is tartalmazhat helytelen tulajdonságértékeket vagy szintaxist. Ezek a nem megfelelő információk hibát okozhatnak importálás során. Kis fájlterv exportálásakor áttekintheti az eszköz által létrehozott XML fájlt. Vizsgálja meg az XML fájlban a szintaxist és a tulajdonságértékeket.

A scope metadata paraméter használata

Ha a fájlterv egyéni osztályokat vagy tulajdonságokat tartalmaz, akkor az exportálási folyamat során a scope metadata paramétert kell használnia. A scope metadata paraméter különálló XML fájlt hoz létre az egyéni osztályok és tulajdonságok számára. Ezért ha egy fájlterv egyéni osztályokat vagy tulajdonságokat tartalmaz, az exportálási és importálási folyamat két lépésből áll: az egyik az egyéni osztályok és tulajdonságok lépése, a másik pedig a fájlterv fennmaradó részéhez tartozik. A scope metadata paramétert használó eljárásokról információkért tanulmányozza a fájlterv eszköz használata témakört.

Az újraimportálás használata

Az újraimportálás az XML fájlban a hozzáadási művelet viselkedését határozza meg. Az újraimportálás három paraméterrel rendelkezik: Nagy fájlterv kezdeti importálása során érdemes a Kihagyás beállítást használnia. Ugyanazon fájlterv importálásának második kísérlete során használja a Kihagyás beállítást a sikeresen importált egyedek újraimportálásának elkerülése érdekében. Viszont ha az importálás második kísérlete kisebb módosításokat igényel az első alkalommal sikeresen importált egyedeken, akkor használja a Felülírás beállítást.

Az ezt követő importálások során, mikor néhány egyeden kisebb módosításokat kell végrehajtani, adja meg az Action="Modify" kódot az egyedek XML fájljában az eredeti XML fájl módosítása helyett. Ezen felül a Frissítés mód lehetővé teszi további frissítések egyszerűbb azonosítását a kezdeti teljes importálásból.

Alkategória ütemezés öröklés

Alkategória létrehozásakor az IBM Enterprise Records felhasználói felület segítségével megadhatja azt, hogy az alkategória örökli a szülő selejtezési ütemezését. Ha saját kezűleg hozza létre az XML fájlt annak a fájltervnek az importálásához, amelyikben az alkategória található, akkor állítsa be azt, hogy az alkategória nem örökli a szülő ütemezését. Adja meg azt, hogy az alkategória eltérő ütemezést biztosít.

A létrehozott XML fájlban a DisposalScheduleInheritedFrom tulajdonsággal jelezze, hogy a rekordkategória örökli a selejtezési ütemezést a szülőtől. Például:

<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>
Négyféle szituációban használhatja a DisposalScheduleInheritedFrom tulajdonságot:
<Property Name="DisposalScheduleInheritedFrom" Value="/myCat1" />

ConditionXML tulajdonság

Ha fájlterv importálásához saját kezűleg hoz létre XML fájlt, akkor lehetősége van értékek meghatározásához a ConditionXML tulajdonság számára. A Fájlterv importálás eszköz ezt a tulajdonságot az alábbi elemek importálásához használja: Alternatív megtartások, Belső eseményaktiválók és Dinamikus (feltételes) felfüggesztések egyedeire a ConditionXML tulajdonság a keresési feltételeket XML formátumban tárolja. A ConditionXML tulajdonságok címkéje az IBM Enterprise Records felhasználói felület név/érték/operátor tulajdonságát tárolja. Az sql címke tárolja a ConditionXML tulajdonságban az SQL utasítást. Amikor megadja a ConditionXML tulajdonságértékeit fájlterv importáláshoz, akkor a speciális karaktereket (< > & " ') át kell alakítani a szabványos megjelenésre. A szabványos megjelenés: &lt;, &gt;, &amp;, &quot; és &apos;. Tanulmányozza az alábbi szakaszokban a Fájlterv importálás exportálás ConditionXML tulajdonságát tartalmazó egyedek XML példáit.

Alternatív megtartás ConditionXML minta

<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>

Selejtezés aktiváló ConditionXML tulajdonsággal:

<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>

Dinamikus felfüggesztés ConditionXML tulajdonsággal:

<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>

Megtartás időtartam frissítése

Meglévő fázis megtartási időtartamának nullértékre történő frissítéséhez a megtartási időtartam tulajdonságoknak (RetentionPeriodYears, RetentionPeriodMonths és RetentionPeriodDays) az XML fájlban érték nélkül kell szerepelniük. Az alábbi példában minta XML fájl látható a Fájlterv importálás exportálás eszköz egyik fázis egyedéhez:
<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>


Visszajelzés

Legutóbbi frissítés: 2013 november
file_plan_import_export_tips.htm

© Copyright IBM 2013