تصدير/استيراد 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 |
|
Update | يتم تحديث الكائنات الموجودة أسفل مجموعة الاستيراد بالكائنات المعرّفة في ملف XML
|
Add/update XML top objects |
|
Scope free |
|
إذا تم استيراد الكائنات على نفس النظام الذي تم تصديرها منه مسبقًا، فقد يؤدي الوضع 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>












