تصدير/استيراد XML

تم دمج واجهة XML في SKOOR Engine لإتاحة تصدير واستيراد أي بنية كائنات باستخدام ملف XML واحد من نظام SKOOR Engine إلى نظام آخر. يتيح لك ذلك إنشاء بنية محددة في بيئة اختبار SKOOR Engine، وتصديرها، ثم استيرادها إلى بيئة إنتاج SKOOR Engine بمجرد إعداد البنية بنجاح. كما تتيح لك واجهة XML مزامنة SKOOR Engine مع أي أدوات خارجية (مثل CMDB، أو أدوات المراقبة الحالية الأخرى).

معلومات عامة

  • عند التعامل مع استيراد/تصدير XML، يمتلك كل كائن معرّفًا فريدًا يُسمى TID (معرّف الطرف الثالث)

  • يعرّف TID كائن SKOOR Engine بشكل عام (عبر أي مثيلات لـ SKOOR Engine)

  • إذا تعيّن تخزين TID نتيجةً لقفل الهوية، فسيتم تخزين TID كخاصية تُسمى tid (يُرجى الرجوع إلى أوضاع الاستيراد في القسم التالي XML - import)

الكائنات المدعومة لعمليات استيراد/تصدير XML

  • قوائم التحكم في الوصول ACLs (استيراد فقط)

  • أجهزة الإنذار

  • مجموعات الإنذار

  • قوالب الإنذار

  • الأجهزة

  • المجلدات (في Templates)

  • المجموعات

  • المهام (Jobs)

  • خرائط التصفية (Filter maps)

  • OPM

  • كائنات العمليات (Process objects)

  • الخصائص (Properties)

  • التقارير (PDF فقط)

  • Scheduler التقارير

  • الجداول الزمنية (Schedules)

  • SLCs

  • SLOs

  • القوالب (يُرجى الرجوع إلى قسم Templates فيما يتعلق بوظيفة تصدير/استيراد XML للقوالب)

  • المستخدمون (استيراد فقط)

  • مجموعات المستخدمين (استيراد فقط)

لا يمكن معالجة الرسوم البيانية مثل state history أو value history أو value history plus بواسطة وظيفة استيراد/تصدير XML، وقد تؤدي إلى ظهور تحذيرات في عملية التصدير/الاستيراد

تعريف الواجهة:

  • يتوافق استيراد/تصدير XML مع معيار XML 1.0

  • يدعم جميع معايير المعالجة اللاحقة لـ XML من w3c 

XML - التصدير

تتوفر طريقتان لتصدير الكائنات بتنسيق XML.

التصدير لمرة واحدة

الطريقة الأولى والأسرع هي فتح قائمة الوظائف الخاصة بمجموعة والنقر فوق XML Export:

سيؤدي هذا الإجراء إلى تصدير الكائنات الموجودة أسفل هذه المجموعة فورًا:

تكوين التصدير

الطريقة الثانية هي إنشاء كائن من النوع XML export أسفل /root/Configurations:

تكوين XML Export:

الخاصية

الوصف

Name

اسم تكوين التصدير

Export

المسار الذي يجب تصدير الكائنات الموجودة أسفله

Postprocessor

هذه الميزة غير مستخدمة حاليًا

سيتم إنشاء الكائن أسفل عقدة /root/Configurations/Import / Export . لبدء التصدير فعليًا وإنشاء ملف XML، انتقل إلى /root/Configurations/Import / Export وانقر فوق Generate على الكائن الذي تم إنشاؤه مسبقًا:

اضغط على الزر Generate :

 سيظهر ملف تصدير XML ويمكن تنزيله عبر المتصفح:

قد تنجم الرسائل التي تتضمن ارتباطات غير محلولة كما هو موضح في قسم Result Info التالي عن كائنات مثل الرسوم البيانية غير المدعومة بواسطة ميزة XML Export. ولا ينبغي أن تتأثر الكائنات الأخرى بذلك:

يتم تجاهل مراجع الخصائص في الكائنات مثل <$PID18$> التي قد تُستخدم داخل الحقول النصية

XML - الاستيراد

تتوفر عدة أوضاع للاستيراد:

وضع الاستيراد

الوصف

Add

  • تُضاف الكائنات المعرّفة في ملف XML أسفل المجموعة المحددة

  • تُفقد الهوية لجميع الكائنات المضافة (يمكن إضافة نفس الكائن أكثر من مرة)

  • لن يتم تخزين أي TID

Update

يتم تحديث الكائنات الموجودة أسفل مجموعة الاستيراد بالكائنات المعرّفة في ملف XML

  • سيتم الاحتفاظ بالهوية وأخذها في الاعتبار لجميع الكائنات المعرّفة في ملف XML

  • تحصل الكائنات المضافة حديثًا على TID المعرّف في ملف XML

  • يمكن إجراء أي عدد من التحديثات على كل كائن

  • سيتم حذف الكائنات الموجودة أسفل مجموعة الاستيراد غير الموجودة في ملف XML

Add/update XML top objects

  • يعمل مثل Update ولكن لا يتم أخذ سوى الكائنات العليا المعرّفة في ملف XML في الاعتبار

  • لا تتم إزالة الكائنات الموجودة في مجموعة الاستيراد كما يحدث في الاستيراد العادي

Scope free

  • يتم تحديد النطاق بواسطة ملف XML (لا يلزم وجود كائن جذر)

  • قد تكون الكائنات موزعة في جميع أنحاء قاعدة بيانات SKOOR Engine. ويتم تحديث تبعياتها كما هو معرّف في ملف XML

    • سيتم الاحتفاظ بالهوية وأخذها في الاعتبار

    • يمكن إجراء أي عدد من التحديثات على نفس الكائن

 

إذا تم استيراد الكائنات على نفس النظام الذي تم تصديرها منه مسبقًا، فقد يؤدي الوضع Add إلى تكرار الكائنات مثل أجهزة الإنذار المرتبطة بالكائنات المصدرة

يتم إدراج أوضاع الاستيراد هذه في القائمة المنسدلة المعنية تحت العنوان Instance لفصلها عن أوضاع الاستيراد المخصصة للقوالب فقط والتي يتم إدراجها تحت العنوان Template

الاستيراد لمرة واحدة

كما هو الحال مع تصدير XML، يمكن إجراء عمليات الاستيراد مباشرةً على أي كائن مجموعة. انقر فوق XML Import في قائمة الوظائف الخاصة بالمجموعة التي ينبغي أن تحتوي على الكائنات بعد الاستيراد:

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

انقر فوق Check للتحقق من ملف الاستيراد وتصحيح أي أخطاء إذا لزم الأمر. يُرجى مراجعة ملف السجل المقدّم لتحليل الأخطاء. عند نجاح التحقق، انقر فوق Import:

تكوين الاستيراد

إذا كانت هناك حاجة إلى تكوين استيراد دائم، فيمكن إنشاؤه أسفل /root/Configurations/Import / Export:

تكوين XML Import:

 

الخاصية

الوصف

Name

اسم تكوين XML Import

Import mode

وضع الاستيراد (انظر الوصف أعلاه)

Below

نقطة الإدخال في شجرة الكائنات لإضافة الكائنات أسفلها

File

ملف XML المراد استيراده (يجب رفعه أولاً)

Preprocessor

غير مستخدم حاليًا

Upload File

اسحب ملف XML وأفلته لرفعه إلى SKOOR Engine وحدده من القائمة المنسدلة File


إجراء الاستيراد هو نفسه الموصوف أعلاه. سيعرض الاستيراد الناجح Import successful باعتبارها Result code. سيتم عرض ملخص وكتابته في ملف السجل. عند النقر فوق ملف السجل، تظهر نافذة جديدة تتضمن معلومات مفصلة حول الاستيراد.

قد يستغرق التحقق من ملف XML ثم استيراده ساعة أو حتى أكثر، اعتمادًا على عدد الكائنات المعنية ووضع الاستيراد المختار. سيؤدي الضغط على زر Import إلى بدء الاستيراد فعليًا. لا تقم بذلك إلا إذا كان التحقق ناجحًا، كما هو موضح بجانب Result Code

يتحقق الاستيراد أولاً مما إذا كان سيتم انتهاك أي حد من حدود الترخيص. في هذه الحالة، يتلقى المستخدم رسالة خطأ وسيفشل الاستيراد

إذا حدث خطأ أثناء الاستيراد، فستتم إزالة جميع الكائنات المنشأة حديثًا بالكامل - ولن تبقى أي كائنات معلقة في النظام

تحرير ملف XML قبل الاستيراد

عادةً، لا توجد حاجة لتغيير الملف المُصدّر قبل استيراده مرة أخرى. ومع ذلك، في بعض الأحيان قد تكون تغييرات التكوين أسرع إذا أُجريت في ملف XML قبل الاستيراد.

مثال: تغيير المجمّع (collector) للمهام المستوردة

إذا تم تكوين عدة مجمّعات بيانات، فقد يكون من الضروري تغييرها أثناء استيراد المهام من نظام SKOOR مختلف.

أولاً، ابحث عن الوسم Agents في ملف XML (يمكن أن توجد عدة وسوم Agent بداخله):

<Agents>
  <Agent id="xxxx">
    <Name>collector-local</Name>
  </Agent>
</Agents>

بعد ذلك، أضف وسم Agent جديدًا باتباع القواعد التالية:

  • أدخل قيمة Agent id تبدأ بحرف أبجدي. لا يرتبط هذا المعرّف بأي كائن في SKOOR Engine، وإنما يُستخدم فقط داخل ملف XML نفسه

  • في الوسم Name ، أضف اسم مجمّع موجود في النظام الهدف

<Agents>
  <Agent id="xxxx">
    <Name>collector-local</Name>
  </Agent>
  <Agent id="myNewCollectorId">
    <Name>external-collector-1</Name>
  </Agent>
</Agents>

الآن، يمكن استخدام Agent id لتكوين المجمّع الجديد لجميع المهام في الوسم Jobs . اضبط الوسم Agent الخاص بالمهام وفقًا لذلك:

<Jobs>
  ...
    <Name>My Job</Name>
    <Agent>myNewCollectorId</Agent>
  ...
</Jobs>