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

استخدام الأداة File Plan Import and Export Tool

في عمليات نشر IBM® Enterprise Records، يمكنك استخدام الأداة File Plan Import Export Tool لاستقبال مخطط حفظ خارجي، أو لتصدير مخطط حفظ الى بيئة تشغيل خارجية. تقوم الأداة باستخدام ملف XML لاتمام عمليات الاستقبال والتصدير.

مقدمة

للتعرف على تفاصيل عن تعديل ملف XML تم تصديره ليتضمن موروثات الجدول الزمني وفترات البقاء البديلة وبرامج اطلاق حدث التخلص وعمليات التعليق الديناميكية (عمليات التعليق المشروطة)، يمكنك الرجوع الى القسم الخاص بالأداة File Plan Import and Export Tool على http://www-01.ibm.com/support/docview.wss?rs=3247&uid=swg27010422.

الحدود

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

تشغيل الأداة

يمكنك تشعيل الأداة File Plan Import Export Tool من سطر أمر Java، أو يمكنك بدء الأداة من خلال ملف الأمر FilePlanTool.bat أو FilePlanTool.sh. يمكنك تنفيذ الأداة بأحد الخمس طرق التالية:

توصيف الأداة

وقبل تشغيل الأداة في نمط التصدير أو الاستقبال، يجب أن تقوم بتوصيف الأداة. لتوصيف الأداة:
  1. قم بالانتقال الى الحافظة التي تم تركيب الأداة File Plan Import Export Tool عليها.
  2. قم بتنفيذ أحد الأوامر التالية في سطر الأمر:
    نظام التشغيل الأمر
    نظام Windows توصيف FilePlanTool -mode
    نظام UNIX توصيف FilePlanTool.sh -mode
    أدخل المعلومات التالية في مربع الحوار لأداة مخطط الحفظ:

تصدير مخطط الحفظ

اذا كان مخطط الحفظ الذي تريد تصديره يتضمن أي من البنود التالي: أنظر تصدير مخطط الحفظ مع اختيار النطاق.

بعد أن تقوم بتوصيف الأداة، يمكنك استخدام الأداة في تصدير مخطط الحفظ. لتصدير مخطط الحفظ، أدخل الأمر التالي:

FilePlanTool -mode export -fileplan file plan name -o XML filename.xml

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

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

تصدير مخطط الحفظ مع اختيار النطاق

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

FilePlanTool -mode export -fileplan file plan name -o XML filename.xml -scope parameter

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

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

يمكن أن يكون المعامل أي مما يلي:
  • بيانات التعريف - اذا كان مخطط الحفظ يتضمن فئات أو خصائص مهيأة، فان هذا المعامل يكون مطلوبا. ويقوم اختيار معامل بيانات التعريف بتكوين ملف XML منفصل للفئات والخصائص المهيأة. لذلك، اذا كان مخطط الحفظ يتضمن فئات أو خصائص مصنفة، ستتكون عمليات التصدير والاستقبال من خطوتين لكل منها:
    • خطوة واحدة للفئات والخصائص المهيأة
    • خطوة واحدة لباقي مخطط الحفظ. اذا لم تقم باستخدام معامل بيانات التعريف، ستقوم الأداة بتصدير مخطط الحفظ بدون الخصائص المهيأة.
  • includecategory "اسم تصنيف السجل" - يستخدم هذا المعامل لتصدير تصنيف سجل محدد. عندما تقوم باستخدام includecategory، ستقوم الأداة بتصدير كل الفئات الفرعية والحافظات الفرعية المتضمنة في تصنيف السجل المحدد. ويجب أن يتضمن اسم تصنيف السجل المسار الكامل في IBM Enterprise Records. على سبيل المثال، لتصدير كل التفرعات في تصنيف سجل بالاسم "Cat03"، والذي يكون متضمن في "Cat02" والذي بدوره يكون متضمن في "Cat01"، أدخل الأمر التالي:

FilePlanTool.bat -mode export -scope includecategory "/Cat01/Cat02/Cat03" -o expfile.xml

FilePlanTool.bat -mode export -scope includecategories file01.txt -o export01.xml

File01.txt يتضمن:

/categoryB /CategoryC/SubcategoryC2 /CatogoryA/SubcategoryA1

يتم تقديم اسم التصنيف من خلال اسم المسار بالكامل وتصنيف سجل واحد بكل سطر.

استقبال/تحديث مخطط الحفظ

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

FilePlanTool -mode import -f XML filename.xml -reimportoption option

FilePlanTool -mode update -f XML filename.xml -reimportoption option

XML filename هو اسم ومسار الملف الذي تريد استقباله. اذا لم تقم بادخال اسم ملف في سطر الأمر، ستقوم الأداة باستخدام اسم الملف المفترض الذي يتم تحديده من خلال المجال اسم ملف المخرجات في مربع حوار توصيف الأداة. للحصول على المزيد من المعلومات عن تحديد اسم ملف مخرجات XML المفترض، أنظرتوصيف الأداة.

اختيار اعادة الاستقبال يحدد طريقة العمل المفترضة للأداة عند استقبال أحد العناصر التي كانت موجودة بالفعل في مخطط الحفظ. للحصول على المزيد من المعلومات عن اختيار اعادة الاستقبال، أنظر استخدام اختيار اعادة الاستقبال.

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

تنبيه: الشارة ClassificationScheme في ملف XML تحدد اسم مخطط الحفظ.

ويمكن أن تقوم بتشغيل الأداة في نمط التحديث لعمل تعديلات بسيطة بعد الاستقبال المبدئي لمخطط الحفظ، ويمكن أن تقوم بتمييز التحديثات المتلاحقة من ملفات XML التي تم استقبالها في البداية. حدد تحديث للخاصية المميزة InputMode من شارة FilePlan في الملف XML. لن يمكن تعديل خاصية مهيأة (مثل كشف الاختيار) من خلال استخدام نمط التحديث.

أنظر IBM FileNet P8 Troubleshooting Guide اذا تم استلام رسالة خطأ، أو توقفت عملية الاستقبال. في أغلب الحالات، تتوقف عملية الاستقبال بعد اكتشاف خطأ، ولا تقوم بعرض أي رسالة.

واذا لزم الأمر، قم بتشغيل Hold Sweep لتطبيق عمليات تعليق مشروطة على العناصر بعد الاستقبال حيث أن الأداة لا تقوم باستقبال عمليات تعليق مشروطة. أنظر الحدود.

التحقق من مخطط الحفظ

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

FilePlanTool -mode validate -f XML filename.xml

XML filename هو اسم ومسار الملف الذي يتم التحقق منه. اذا لم تقم بادخال اسم ملف في سطر الأمر، ستقوم الأداة باستخدام اسم الملف المفترض الذي يتم تحديده من خلال المجال اسم ملف المخرجات في مربع حوار توصيف الأداة. للحصول على المزيد من المعلومات عن تحديد اسم ملف مخرجات XML المفترض، أنظرتوصيف الأداة.

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

يستخدم اختيار اعادة الاستقبال لتحديد طريقة العمل المفترضة للأداة عند استقبال أحد العناصر التي كانت موجودة بالفعل في مخطط الحفظ. اختيار اعادة الاستقبال له ثلاثة معاملات: يمكنك استخدام الاختيار تخطي بعد استقبال مخططات الحفظ الكبيرة. أثناء المحاولة الثانية لاستقبال نفس مخطط الحفظ، الاختيار تخطي يتفادى اعادة استقبال العناصر التي تم استقبالها بنجاح بالفعل. ولكن، اذا كانت المحاولة الثانية للاستقبال تتطلب تعديلات بسيطة في العناصر التي تم استقبالها بنجاح في المرة الأولى، يمكنك استخدام الاختيار استبدال. وأثناء عمليات الاستقبال المتتابعة للتعديلات البسيطة في عدد صغير من العناصر، حدد ‏‎Action="Modify"‎‏ (في القسم RMEntityObjectType من ملف XML) للعناصر، بدلا من عمل التغييرات في ملف XML الأصلي. وأيضا، قم باستخدام نمط التحديث لجعل التحديثات المتتابعة أسهل من عمليات الاستقبال المبدئية الكاملة. أنظر استقبال/تحديث مخطط الحفظ.


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

آخر تحديث: August 2011


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