IBM Enterprise Records, النسخة 5.1.+            

تصحيح الأخطاء في الأداة File Plan Import and Export Tool

يجب أن تتعرف على بعض المعلومات الخاصة بالأسباب العامة للأخطاء التي تحدث أثناء استخدام الأداة File Plan Import and Export Tool من IBM® Enterprise Records بالاضافة الى التعرف على كيفية تقليل مواجهة مثل هذه الأخطاء.

الأسباب الشائعة للأخطاء

عند استقبال مخطط الحفظ، قد تواجه خطأ. في أغلب الحالات، تتوقف عملية الاستقبال بعد اكتشاف خطأ، ولا تقوم بعرض أي رسالة. سبب الخطأ يمكن أن يكون أي مما يلي: تتضمن الأداة File Plan Import and Export Tool اختيارات يمكن استخدامها لتحديد الأخطاء المحتملة. يتم شرح هذه الأخطاء في الأقسام التالية.

تكوين ملف XML يدويا

ولاغراض المناقشة، فان تكوين ملف XML يدويا يشير الى تكوين ملف XML من خلال طرق تختلف عن الأداة File Plan Import and Export Tool (على سبيل المثال، استخدام الأوامر المركبة أو طرق البرمجة الأخرى في تكوين ملف XML). ولتتمكن من استقبال مخطط الحفظ، يجب أن تقوم بتكوين ملف XML يتوافق مع معايير XML ومتوافق مع الوصف المنطقي لملفات XML لبرنامج FileNet.

واذا تم يدويا تكوين ملف XML ليتم استخدامه في استقبال مخطط الحفظ، فيجب أن تقوم بتأسيس الملف على XML schema المتاح من خلال IBM.

هام: أغلب الأخطاء التي تحدث أثناء استقبال مخطط الحفظ تكون بسبب عدم التوافق لملفات XML. وعلى ذلك، فيجب توخي المزيد من الحذر عند تكوين ملف XML بطريقة يدوية.

بعد أن تقوم يدويا بتكوين ملف XML، فمن المفضل بشدة أن تقوم بتشعيل الأداة File Plan Import Export Tool في نمط التحقق. حيث تقوم الأداة في نمط التحقق بقراءة ملف XML والتحقق من الملفات التي لا تتضمن أي أخطاء أو مشاكل تتعلق بعدم التوافق. (أنظر استخدام الأداة File Plan Import and Export Tool للتعرف على تفاصيل عن نمط التحقق.)

يتم اتاحة بعض الاختيارات عند تكوين ملف XML بطريقة يدوية ويتم تضمينها في الأقسام توارث الجدول للتصنيفات الفرعية و الخاصية ConditionXML.

استنتاج وظائف الأداة File Plan Import Export Tool

اذا كنت تنوي تكوين ملف XML بطريقة يدوية لاستقبال مخطط حفظ كبير بفئات وعناصر مهيأة، فمن المفضل أن تقوم أولا بتكوين مخطط حفظ صغير وبيانات التعريف المتعلقة به، وتنفيذ الأداة في نمط التصدير. ومثل هذا التمرين يعتبر مفيدا قبل أن تقوم يدويا بتكوين ملف XML لمخطط الحفظ مع عمليات تعليق مشروطة، وبرامج اطلاق حدث داخلية، وفترات البقاء البديلة، والتي تتضمن جميعا الخاصية ConditionXML معقدة. وبارغم من أنه يمكنك تكوين ملف بنسق XML الصحيح، الملف XML قد يكون له قيم أو نسق خاصية غير صحيحة، والتي قد تؤدي الى حدوث خطأ أثناء الاستقبال. استقبال مخطط الحفظ الصغير يتيح لك مراجعة ملف XML الذي تقوم الأداة بتكوينه، واستنتاج قيم وصيغة الخاصية في ملف XML.

استخدام اختيار نطاق بيانات التعريف

اذا كان مخطط الحفظ الخاصة بك يتضمن فئات أو خصائص مهيأة، فيجب أن تقوم باستخدام اختيار نطاق بيانات التعريف أثناء عملية التصدير. ويقوم اختيار نطاق بيانات التعريف بتكوين ملف XML منفصل للفئات والخصائص المهيأة. لذلك، اذا كان مخطط الحفظ يتضمن فئات أو خصائص مهيأة، ستتكون عمليات التصدير والاستقبال من خطوتين لكل منها: واحدة لاستقبال الفئات والخصائص المهيأة في مخطط الحفظ، والثانية لاستقبال باقي مخطط الحفظ. موضوعات المساعدة عن استخدام الأداة File Plan Import and Export Tool تتضمن الاجراءات الخاصة باستخدام اختيار نطاق بيانات التعريف.

استخدام اختيار اعادة الاستقبال

يتم استخدام اختيار اعادة الاستقبال لتحديد طريقة عمل تصرف الاضافة في ملف XML. اختيار اعادة الاستقبال له ثلاثة معاملات: أثناء الاستقبال المبدئي لمخطط حفظ كبير، فيمكنك استخدام الاختيار تخطي. في حالة الفشل وأثناء المحاولة الثانية لاستقبال نفس مخطط الحفظ، الاختيار تخطي يتفادى اعادة استقبال العناصر التي تم استقبالها بنجاح بالفعل. ولكن، اذا كانت المحاولة الثانية للاستقبال تتطلب تعديلات بسيطة في العناصر التي تم استقبالها بنجاح في المرة الأولى، يمكنك استخدام الاختيار استبدال.

وأثناء عمليات الاستقبال المتتابعة للتعديلات البسيطة في عدد صغير من العناصر، فمن المفضل أن تقوم بتحديد Action="Modify" في الملف XML للعناصر، بدلا من عمل التغييرات في ملف XML الأصلي. وأيضا، قم باستخدام النمط تحديث لجعل التحديثات المتتابعة أسهل من عمليات الاستقبال المبدئية الكاملة.

توارث الجدول للتصنيفات الفرعية

عند تكوين تصنيف فرعي، يجب أن تقوم باستخدام واجهة تعامل المستخدم 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، والتي ستقوم الأداة File Plan Import Tool باستخدامها في استقبال مايلي: بالنسبة الى فترة البقاء البديلة وبرامج اطلاق الحدث الداخلية وعناصر التضمن الديناميكية (شرطية)، تقوم الخاصية ConditionXML بتخزين شروط البحث في نسق XML. شارات الخاصية في ConditionXML تقوم بتخزين اسم/وقيمة/ومعامل الخاصية لواجهة تعامل مستخدم IBM Enterprise Records. الشارة sql في ConditionXML تقوم بتخزين عبارة SQL. وعندما تقوم بادخال قيمة الخاصية ConditionXML لاستقبال مخطط الحفظ، فيجب أن يتم تحويل الحروف الخاصة (< > & " ') الى مقابلاتها القياسية (&lt; &gt; &amp; &quot; &apos;). فيما يلي مثال لملفات XML للعناصر التي تتضمن الخاصية ConditionXML الى File Plan Import Export.

مثال الى ConditionXML الى Alternate Retention

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

مثال لبرنامج اطلاق حدث التخلص باستخدام 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://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>

مثال لعملية التعليق الديناميكي باستخدام 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://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>

تحديث فترة البقاء

لتحديث فترة البقاء لأحد المراحل الموجودة الى قيمة خالية، فيجب أن يتم تضمين خصائص فترة البقاء (RetentionPeriodYears و RetentionPeriodMonths و RetentionPeriodDays) في ملف XML بدون قيمة. فيما يلي مثال لملف XML لعنصر المرحلة من الأداة File Plan Import Export:
<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://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>


التعليق التقييمي

آخر تحديث: August 2011


© .IBM حقوق النشر لشركة 2011.
يتم تشغيل مركز المعلومات هذا من خلال تقنيات Eclipse. ( http://www.eclipse.org )