بالنسبة لعمليات نشر IBM® Enterprise Records، استخدم أداة
استقبال/تصدير مخطط الحفظ لاستقبال مخطط الحفظ خارجي أو لتصدير
مخطط الحفظ لبيئة تشغيل خارجية. تقوم الأداة باستخدام ملف XML لاتمام عمليات الاستقبال والتصدير.
مقدمة
للحصول على تفاصيل عن تعديل ملف XML تم تصديره ليتضمن توارث الجدول الزمني، عمليات الاحتفاظ البديلة، برامج اطلاق حدث التخلص، عمليات التعليق الديناميكية، ارجع الى الموضوع Troubleshooting File Plan Import
and Export tool.
الحدود
استخدم أداة استقبال/تصدير مخطط الحفظ لتطوير نسخة مخططات الحفظ. لكن، لا تقوم الأداة بدعم السيناريوهات التالية:
- اجتياز عمليات تصدير/استقبال نموذج البيانات. على سبيل المثال، اذا كان يتم التصدير من تخزين العنصر لنموذج البيانات PRO، فلن يمكنك الاستقبال الى تخزين العنصر لنموذج البيانات DoD.
- استقبال أو استقبال عناصر السجلات، ووحدات التخزين، وعناصر الوثيقة، ومعلومات السرية، وتعليمات السرية.
- آليات الاستئناف.
- تصدير الخصائص بقيم خالية. على سبيل المثال، تصدير مرحلة من الجدول الزمني للتخلص بدون فترة احتفاظ. أيضا، استقبال الجدول الزمني للتخلص في ملف تخزين عناصر آخر لا يقوم بتعديل فترة الاحتفاظ الى لا شيء. ولكن، يمكنك تحديث ملف XML يدويا لتحديث فترة البقاء. للحصول على مزيد من المعلومات، ارجع الى الموضوع Troubleshooting File Plan Import and Export tool.
أولا، قم بتصدير واستقبال الخصائص المهيأة، مثل كشوف الاختيار والفئات في ملف XML منفصل قبل القيام باستقبال بقية مخطط الحفظ. وكذلك، بعد أن تقوم باستقبال مخطط الحفظ، ولن تكون العناصر التي توضح الحالة
مغلق أو
جاهز للتخلص متأثرة بعد ذلك.
تشغيل الأداة
يمكنك تشغيل أداة استقبال/تصدير مخطط الحفظ من سطر أمر برنامج Java الذي يتم تنفيذه. أو يمكنك بدء الأداة باستخدام الأمر:
FilePlanTool.bat أو
FilePlanTool.sh. يمكنك تشغيل الأداة بأي من الأنماط الخمس هذه:
- توصيف: يتم فتح مربع حوار يتم تحديد المعلومات المطلوبة به. المعلومات المطلوبة هي اسم وحدة خدمة Content Platform Engine واسم ملف تخزين العناصر واسم وكلمة سرية موجه النظام والنمط (استقبال أو تصدير).
- تصدير: يتم تكوين ملف XML متوافق بالكامل يمكنك استقباله فيما بعد في بيئة تشغيل أخرى.
- استقبال/تحديث: يتم استقبال ملف XML محدد في بيئة التشغيل.
- تحقق: يتم قراءة ملف XML للتحقق من التوافق.
تصدير مخطط الحفظ
اذا كان مخطط الحفظ الذي تريد تصديره يتضمن أي من البنود التالي:
- الخصائص أو الفئات المهيأة
- أكثر من 300,000 حافظة
- تصنيف سجل يتضمن أكثر من 15,000 حافظة
أنظر
تصدير مخطط الحفظ مع اختيار النطاق.
بعد أن تقوم بتوصيف الأداة، يمكنك استخدام الأداة في تصدير مخطط الحفظ. لتصدير مخطط الحفظ، أدخل الأمر التالي:
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، أدخل الأمر التالي. Cat03 يوجد في Cat02 الذي يوجد بدوره في Cat01.
FilePlanTool.bat -mode export -scope includecategory
"/Cat01/Cat02/Cat03" -o expfile.xml
- includecategories file 01:
استخدم هذا المعامل لتصدير تصنيفات السجلات فقط والتفرعات الخاصة بهم في ملف نص المدخلات file 01. استخدم المعامل includecategories لتصدير تصنيفات السجلات لنفس الملف بدون تحديد اسم تصنيف كل سجل في سطر الأمر. لاستخدام هذا المعامل، أدخل الأمر التالي:
FilePlanTool.bat -mode export -scope includecategories file01.txt -o export01.xml
File01.txt يتضمن:
/categoryB
/CategoryC/SubcategoryC2 /CatogoryA/SubcategoryA1
يتم تقديم اسم التصنيف من خلال اسم المسار بالكامل وتصنيف سجل واحد بكل سطر.
- excludecategory "اسم تصنيف السجل الذي تم استبعاده": استخدم هذا المعامل لاستبعاد تصنيف سجل خاص والمجموعة الفرعية الخاصة به. على سبيل المثال، اذا كان اسم تصنيف السجل المستبعد هو "Cat01/Cat02/Catlarge"، ستقوم الأداة بتصدير كل تصنيفات السجلات وحافظات السجلات التي توجد في مخطط الحفظ مع حدوث استثناء. الاستثناء هو تصنيفات السجل وحافظات السجل المتضمنة في العقدة "Cat01/Cat02/CatLarge". هذا المعامل يعمل مثل includecategory تماما.
- excludecategories file 02:
استخدم هذا المعامل لاستبعاد التسلسلات الفرعية لأسماء الدليل الرئيسي المحدد في ملف نص file 02. هذا المعامل يعمل مثل includecategories تماما.
استقبال/تحديث مخطط الحفظ
لاستقبال
مخطط الحفظ أو مقطع من مخطط الحفظ، قم بتشغيل الأداة في نمط استقبال. حدد ملف XML الذي قامت الأداة بتكوينه في نمط التصدير. اذا كان مخطط الحفظ الخاصة بك يتضمن فئات أو خصائص مهيأة، فستتطلب عملية الاستقبال اثنين من الخطوات. تقوم الخطوة الأولى باستقبال الخصائص والفئات المهيأة في مخطط الحفظ. تقوم الخطوة الثانية باستقبال المتبقي من مخطط الحفظ. قم باستقبال الخصائص والفئات المهيأة أولا. ثم انتظر 5 دقائق قبل استقبال مخطط الحفظ لأن بيانات تعريف الخصائص والفئات المهيأة تم تسجيلها في الذاكرة.
فترة البقاء (TTL) للذاكرة الوسيطة هو 5 دقائق، بعد ذلك يتم اخلاء الذاكرة. لاستقبال/تحديث مخطط الحفظ، أدخل الأمر التالي:
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 في الوثائق الفنية للمنتج لصفحة
FileNet P8
Platform اذا قمت باستلام رسالة خطأ أو تم ايقاف عملية الاستقبال.
في أغلب الحالات، تتوقف عملية الاستقبال بعد اكتشاف خطأ، ولا تقوم بعرض أي رسالة.
واذا لزم الأمر، قم بتشغيل عملية المسح للتعليق لتطبيق عمليات تعليق مشروطة على العناصر بعد الاستقبال حيث أن الأداة لا تقوم باستقبال عمليات تعليق مشروطة. أنظر الحدود.
التحقق من مخطط الحفظ
بعد تكوين ملف
XML يدويا، تأكد من أن ملفات XML لا تحتوي على أي أخطاء أو مشاكل عدم توافق. يمكنك التحقق من الملف من خلال الأداة استقبال/تصدير مخطط الحفظ. لتشغيل أداة الاستقبال/التصدير
في نمط التحقق، أدخل الأمر التالي:
FilePlanTool -mode validate -f XML
filename.xml
XML filename هو اسم ومسار الملف الذي يتم التحقق منه. تستخدم الأداة اسم الملف المفترض المحدد بواسطة مجال اسم ملف المخرجات في مربع حوار التوصيف اذا لم تقم بتحديد اسم ملف. للحصول على معلومات عن تحديد اسم ملف مخرجات XML المفترض، أنظر توصيف الأداة.
استخدام اختيار اعادة الاستقبال
استخدم الاختيار اعادة الاستقبال لتحديد التصرف المفترض للأداة عند استقبال عنصر يوجد في مخطط الحفظ. اختيار اعادة الاستقبال له ثلاثة معاملات:
- لا شيء: عند اضافة عنصر، تقوم الأداة بتسجيل تحذير في سجل الاستثناءات اذا كان العنصر موجود، ولن يتم اضافة العنصر مع استمرار التشغيل.
- تخطي: عند اضافة عنصر، تقوم الأداة بتخطي أي عناصر موجودة، ويستمر التشغيل ويتم تسجيل تصرف التخطي في سجل النشاط.
- استبدال: عند اضافة عنصر، تقوم الأداة باستبدال أي عناصر موجودة، ويستمر التشغيل ويتم تسجيل تصرف التعديل في سجل النشاط.
استخدم الاختيار
تخطي بعد فشل عملية استقبال مخطط حفظ كبير. أثناء المحاولة الثانية لاستقبال نفس مخطط الحفظ، يقوم الاختيار تخطي بتفادي اعادة استقبال العناصر التي تم استقبالها بنجاح. لكن، اذا كانت المحاولة الثانية للاستقبال تتطلب تعديلات ثانوية بالعناصر التي تم استقبالها بنجاح في أول مرة، استخدم الاختيار
استبدال. أثناء عمليات الاستقبال المتتابعة للتعديلات الثانوية لعدد قليل من العناصر، حدد
Action="Modify" (في قسم RMEntityObjectType من ملف
XML) الخاص بالعناصر. قم بتغيير هذه العناصر بدلا من تغيير ملف XML الأصلي. وأيضا، قم باستخدام نمط التحديث لجعل التحديثات المتتابعة أسهل من عمليات الاستقبال المبدئية الكاملة. أنظر
استقبال/تحديث مخطط الحفظ.