في عمليات نشر IBM® Enterprise Records، يمكنك استخدام الأداة
File Plan Import Export Tool لاستقبال مخطط حفظ خارجي، أو لتصدير مخطط حفظ الى بيئة تشغيل خارجية. تقوم الأداة باستخدام ملف XML لاتمام عمليات الاستقبال والتصدير.
الحدود
تقوم الأداة File Plan
Import Export Tool بتسهيل الانتقال الى مخططات الحفظ. ولكن، الأداة لا تدعم ما يلي:
- اجتياز عمليات تصدير/استقبال نموذج البيانات. على سبيل المثال، اذا كان يتم التصدير من تخزين العنصر لنموذج البيانات PRO، فلن يمكنك الاستقبال الى تخزين العنصر لنموذج البيانات DoD.
- استقبال أو استقبال عناصر السجلات، ووحدات التخزين، وعناصر الوثيقة، ومعلومات السرية، وتعليمات السرية.
- آليات الاستئناف.
- تصدير الخصائص بقيم خالية. على سبيل المثال، تصدير أحد المراحل من الجدول الزمني للتخلص بدون فترة بقاء، واستقبال الجدول الزمني للتخلص في تخزين عنصر آخر، لا يؤدي لالى تحديث فترة البقاء الى قيمة خالية. ولكن، يمكنك تحديث ملف XML يدويا لتحديث فترة البقاء. للحصول على المزيد من المعلومات، أنظر ftp://ftp.software.ibm.com/software/data/cm/filenet/docs/p8doc/40x/P840_Troubleshooting.pdf.
بالاضافة الى ذلك، يجب أن تقوم أولا بتصدير واستقبال الخصائص المهيأة (مثل كشوف الاختيار) والفئات في ملف XML منفصل قبل أن تقوم باستبقال باقي مخطط الحفظ. وكذلك، بعد أن تقوم باستقبال مخطط الحفظ، ولن تكون العناصر التي توضح الحالة
مغلق أو
جاهز للتخلص متأثرة بعد ذلك.
تشغيل الأداة
يمكنك تشعيل الأداة File Plan Import Export Tool من سطر أمر Java، أو يمكنك بدء الأداة من خلال ملف الأمر
FilePlanTool.bat أو
FilePlanTool.sh.
يمكنك تنفيذ الأداة بأحد الخمس طرق التالية:
- التوصيف - لفتح مربع حوار يمكن من خلاله تحديد المعلومات المطلوبة مثل Content Engine اسم وحدة خدمة (CE)، اسم تخزين العنصر، كلمة سرية المستخدم موجه النظام، ونمط (الاستقبال أو التصدير).
- التصدير - لتكوين ملف 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"، والذي يكون متضمن في "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 الذي تقوم الأداة بتكوينه في نمط التصدير.
اذا كان مخطط الحفظ الخاصة بك يتضمن فئات أو خصائص مهيأة، فستتطلب عملية الاستقبال اثنين من الخطوات. واحدة لاستقبال الفئات والخصائص المهيأة في مخطط الحفظ، والثاينة لاستقبال باقي مخطط الحفظ. قم باستقبال الفئات والخصائص المهيأة أولا، ثم انتظر لمدة خمس دقائق على الأقل قبل استقبال مخطط الحفظ لأن بيانات التعريف للفئات والخصائص المهيأة تكون مسجلة في ذاكرة التخزين المؤقت للحاسب. والقيمة المحددة لفترة البقاء في ذاكرة التخزين المؤقت (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 الأصلي. وأيضا، قم باستخدام نمط التحديث لجعل التحديثات المتتابعة أسهل من عمليات الاستقبال المبدئية الكاملة. أنظر
استقبال/تحديث مخطط الحفظ.