تصدير/استيراد 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 - الاستيراد)
الكائنات المدعومة لاستيراد/تصدير XML
قوائم التحكم في الوصول (ACL) (الاستيراد فقط)
أجهزة الإنذار
مجموعات الإنذار
قوالب الإنذار
الأجهزة
المجلدات (في القوالب)
المجموعات
المهام
خرائط التصفية
OPM
كائنات العملية
خصائص
التقارير (PDF فقط)
مجدولو التقارير
الجداول
SLCs
SLOs
القوالب (يرجى الرجوع إلى قسم القوالب فيما يتعلق بوظيفة تصدير/استيراد XML للقوالب)
المستخدمون (الاستيراد فقط)
مجموعات المستخدمين (استيراد فقط)
لا يمكن معالجة الرسوم البيانية مثل سجل الحالة أو سجل القيمة أو سجل القيمة الإضافي بواسطة وظيفة استيراد/تصدير XML وقد يؤدي ذلك إلى ظهور تحذيرات في عملية التصدير/الاستيراد
تعريف الواجهة:
يتماشى استيراد/تصدير XML مع معيار XML 1.0
يدعم جميع معايير معالجة XML w3c
XML - تصدير
هناك طريقتان لتصدير الكائنات بتنسيق XML.
تصدير لمرة واحدة
الطريقة الأولى والأسرع هي فتح قائمة وظائف المجموعة والنقر على تصدير XML:
سيؤدي هذا الإجراء إلى تصدير الكائنات الموجودة أسفل هذه المجموعة على الفور:
تصدير التكوين
الطريقة الثانية هي إنشاء كائن من نوع تصدير XML ضمن /root/Configurations:
تكوين تصدير XML:
الخاصية | الوصف |
|---|---|
الاسم | اسم تكوين التصدير |
تصدير | المسار الذي يجب تصدير الكائنات إليه |
المعالج اللاحق | هذه الميزة غير مستخدمة حاليًا |
سيتم إنشاء الكائن تحت عقدة /root/Configurations/Import / Export. لبدء التصدير فعليًا وإنشاء ملف XML، انتقل إلى /root/Configurations/Import / Export وانقر فوق Generate (إنشاء) على الكائن الذي تم إنشاؤه مسبقًا:
اضغط على زر Generate (إنشاء):
سيظهر ملف تصدير XML ويمكن تنزيله عبر المتصفح:
قد تظهر رسائل تحتوي على روابط غير محلولة كما هو موضح في قسم معلومات النتيجة التالي بسبب كائنات مثل الرسوم البيانية التي لا تدعمها ميزة تصدير XML. لا ينبغي أن تتأثر الكائنات الأخرى بهذا:
يتم تجاهل مراجع الخصائص في الكائنات مثل <$PID18$> التي يمكن استخدامها داخل حقول النص
XML - استيراد
تتوفر عدة أوضاع للاستيراد:
وضع الاستيراد | الوصف |
|---|---|
إضافة |
|
تحديث | يتم تحديث الكائنات الموجودة أسفل مجموعة الاستيراد بالكائنات المحددة بواسطة ملف XML
|
إضافة/تحديث كائنات XML العليا |
|
نطاق حر |
|
إذا تم استيراد الكائنات على نفس النظام الذي تم تصديرها منه من قبل، فقد يؤدي وضع الإضافة إلى تكرار الكائنات مثل أجهزة الإنذار المرتبطة بالكائنات المصدرة
يتم سرد أوضاع الاستيراد هذه في القائمة المنسدلة ذات العنوان "مثيل" من أجل فصلها عن أوضاع الاستيراد التي سيتم استخدامها للقوالب فقط والتي يتم سردها تحت عنوان "قالب"
استيراد لمرة واحدة
كما هو الحال مع تصدير XML، يمكن إجراء عمليات الاستيراد مباشرة على أي كائن مجموعة. انقر فوق استيراد XML في قائمة وظائف المجموعة التي يجب أن تحتوي على الكائنات بعد الاستيراد:
قم بتحميل ملف للاستيراد واختر الوضع المطلوب من القائمة المنسدلة:
انقر فوق "تحقق" للتحقق من ملف الاستيراد وتصحيح أي أخطاء إذا لزم الأمر. يرجى الرجوع إلى ملف السجل المرفق لتحليل الأخطاء. عندما تنجح عملية التحقق، انقر فوق "استيراد":
تكوين الاستيراد
إذا كانت هناك حاجة إلى تكوين استيراد دائم، فيمكن إنشاؤه ضمن /root/Configurations/Import / Export:
تكوين استيراد XML:
خاصية | الوصف |
|---|---|
الاسم | اسم تكوين استيراد XML |
وضع الاستيراد | وضع الاستيراد (انظر الوصف أعلاه) |
أسفل | نقطة دخول شجرة الكائنات لإضافة كائنات أدناه |
ملف | ملف XML المراد استيراده (يجب تحميله أولاً) |
المعالج المسبق | غير مستخدم حاليًا |
تحميل ملف | اسحب ملف XML وأفلته لتحميل الملف إلى SKOOR Engine وحدده من القائمة المنسدلة "ملف" |
إجراء الاستيراد هو نفسه كما هو موضح أعلاه. سيظهر "الاستيراد ناجح" كرمز النتيجة عند نجاح الاستيراد. سيتم عرض ملخص وكتابته في ملف السجل. بالنقر فوق ملف السجل، تظهر نافذة جديدة تحتوي على معلومات مفصلة حول الاستيراد.
قد يستغرق فحص ملف XML واستيراده في النهاية ساعة أو أكثر، اعتمادًا على عدد الكائنات المعنية ووضع الاستيراد المختار. سيؤدي الضغط على زر الاستيراد إلى بدء عملية الاستيراد في النهاية. لا تقم بذلك إلا إذا نجح الفحص، كما هو مذكور بجوار رمز النتيجة
يتحقق الاستيراد أولاً من عدم وجود أي انتهاك لحدود الترخيص. في هذه الحالة، يتلقى المستخدم رسالة خطأ ويفشل الاستيراد
في حالة حدوث خطأ أثناء الاستيراد، تتم إزالة جميع الكائنات التي تم إنشاؤها حديثًا تمامًا - ولن تبقى أي كائنات معلقة في النظام
قم بتحرير ملف XML قبل الاستيراد
عادةً، لا توجد حاجة لتغيير الملف المصدّر قبل استيراده مرة أخرى. ومع ذلك، في بعض الأحيان يمكن أن تكون تغييرات التكوين أسرع إذا تم إجراؤها في XML قبل الاستيراد.
مثال: تغيير جامع المهام المستوردة
إذا تم تكوين عدة مجمعات بيانات، فقد يكون من الضروري تغييرها أثناء استيراد المهام من نظام SKOOR مختلف.
أولاً، ابحث عن علامة Agents في ملف XML (قد توجد عدة علامات Agent بداخله):
<Agents>
<Agent id="xxxx">
<Name>collector-local</Name>
</Agent>
</Agents>
ثم أضف علامة Agent جديدة وفقًا للقواعد التالية:
أدخل معرف وكيل يبدأ بحرف أبجدي. لا يرتبط هذا المعرف بأي كائن في محرك SKOOR، ويستخدم فقط داخل ملف XML نفسه
في علامة Name، أضف اسم جامع موجود في النظام الهدف
<Agents>
<Agent id="xxxx">
<Name>collector-local</Name>
</Agent>
<Agent id="myNewCollectorId">
<Name>external-collector-1</Name>
</Agent>
</Agents>
الآن، يمكن استخدام معرف الوكيل لتكوين المجمع الجديد لجميع المهام في علامة Jobs. اضبط علامة Agent للمهام وفقًا لذلك:
<Jobs>
...
<Name>My Job</Name>
<Agent>myNewCollectorId</Agent>
...
</Jobs>












