صيانة الخدمات الواردة XAI

الخدمة الواردة XAI هي آلية قديمة لعرض خدمات النظام على أنظمة خارجية باعتبارها خدمات ويب. إن الآلية المدعومة حاليًا لتحديد خدمات الويب هي خدمات الويب الواردة، ويجب استخدام هذه الآلية لأية خدمة من خدمات الويب الجديدة.

يمكن أن تحتوي بعض النسخ المعدلة الموجودة والمنتجات المستندة إلى إطار عمل على خدمات واردة XAI موجودة والتي قد يكون من الضروري عرضها. فيما يتعلق بهذه الخدمات، يدعم المنتج توزيعها باعتبارها خدمات ويب SOAP واردة من أجل التنفيذ. ارجع إلى توزيع الخدمة الواردة XAI من خلال خدمة الويب الواردة.

توضح الأقسام التالية معلومات أساسية حول صفحات الصيانة. لاحظ أن بعض هذه المعلومات متعلقة بالوظيفة القديمة التي لم تعد مدعومة.

خدمة واردة عبر XAI - رئيسي

لعرض خدمة واردة، افتح الإشراف > XAI > الخدمة الواردة عبر XAI.

وصف الصفحة

يتم استخدام اسم خدمة XAI الواردة في النظام لتحديد الخدمة. ويكون اسم الخدمة هو أيضًا عنصر XML الأول بعد العنصر <Body> في مستند استجابة/طلب XML. يكون معرف خدمة XAI بمثابة المفتاح الأساسي.

يحدد حقل المالك ما إذا كانت هذه الخدمة الواردة عبر XAI تابعة للحزمة الأساسية أم للنسخة المعدلة الخاصة بك ( التعديل من قِبل العميل). علمًا بأن هذه المعلومات للعرض فقط.

يحدد الموفق واجهة ملقم التطبيق الهدف.

في حالة استدعاء موفق هذه الخدمة لإحدى خدمات النظام، يتم عرض اسم الخدمة المناسب.

إذا كان الموفق هو موفق العمل، يشير كل من نوع المخطط واسم المخطط إلى الكائن المطلوب استدعاؤه.

تكون فئة خدمة الويب مرئية إذا كانت الخدمة الواردة عبر XAI مرتبطة بواحدة أو أكثر من فئات خدمات الويب.

استخدم الوصف والوصف المطول لوصف الخدمة.

تحقق من المفتاح نشط في حالة تمكين هذه الخدمة وإتاحتها للتنفيذ.

خطأ ما بعد المعالجة غير قابل للتطبيق.

التتبع غير قابل للتطبيق.

عملية تصحيح الأخطاء غير قابلة للتطبيق.

تعريفات المخطط

ملاحظة: لا ينطبق مخطط الطلب ومخطط الاستجابة على الخدمات التي تستدعي كائنات مستندة إلى مخطط. ولا يظهرا عند استخدام موفق العمل.

تحدد الخاصيتان التاليتان مخططات XML للطلب والاستجابة. المخططات متوافقة مع SOAP. ومن المتوقع تخزين ملفات XML للمخطط في دليل المخططات على ملقم ويب الذي يقوم بتشغيل ملقم XAI.

يكون مخطط الطلب هو مخطط XML الذي يحدد طلب الخدمة. ويجب التزام الطلب المرسل إلى الملقم بتعريف المخطط.

يكون مخطط الاستجابة هو مخطط XML الذي يحدد استجابة الخدمة. وتتوافق الاستجابة التي يكونها ملقم XAI مع تعريف مخطط الاستجابة.

قد تقوم نفس الخدمة بتنفيذ العديد من الإجراءات على كائن العمل. استخدم نوع المعاملة لتحديد الإجراء الافتراضي الذي تقوم به الخدمة. ويمكن إدخال نوع المعاملة عند استدعاء الخدمة وذلك بتحديد سمة نوع المعاملة على عنصر خدمة طلب XML بشكل ديناميكي. وقد يكون لهذا الحقل القيم التالية: قراءة وإضافة وتغيير وتحديث وحذف وإدراج في قائمة وبحث.

ملاحظة: يكمن الفرق بين القيمة تغيير وتحديث في أنه في حالة اختيار القيمة تغيير، يجب تمرير كافة قيم الحقول في الطلب. وسيتم تعيين قيم الحقول التي لم يتم تمريرها في الطلب على القيمة خالي. أما بالنسبة للقيمة تحديث، تحتاج فقط إلى تمرير قيم حقول المفتاح الأساسي وقيم الحقول المطلوب تحديثها. وستحتفظ كافة الحقول الأخرى بقيمها الموجودة.

قد تسمح الخدمات التي تقوم بالبحث بإمكانية البحث استنادًا إلى معايير مختلفة. وإذا كانت قيمة نوع المعاملة هي بحث، استخدم نوع البحث لتحديد معايير البحث الافتراضية. وتكون القيم الممكنة هي رئيسي والبديل1 والبديل2 والبديل3 والبديل4 والبديل5 والبديل6.

ملاحظة: هذا تعريف افتراضي فقط وقد يتم تجاوزه في وقت التشغيل عند استدعاء الخدمة. لتجاوز نوع البحث في وقت التشغيل، يجب تحديد سمة searchType في عنصر الخدمة لطلب XML.

تعريفات تحويل XSL

لا يتوافق مستند طلب XML في بعض الأحيان مع مخطط الطلب أو إذا كان مستند الاستجابة المتوقع بواسطة طالب الخدمة ليس ذلك الذي قام الموفق بتكوينه. في مثل هذه الحالات، يجب تحويل مستندات الطلب و/أو الاستجابة. ويدعم ملقم XAI التحويل من خلال سكريبتات تحويل XSL. وقد يتم تطبيق سكريبتات التحويل على الطلب قبل تمريرها إلى الموفق أو تطبيقها على مستند الاستجابة قبل إرسالها إلى طالب الخدمة.

طلب XSL هو اسم تحويل XSL المراد تطبيقه على مستند الطلب قبل المعالجة. ويكون التحويل عادةً مطلوبًا في حالة عدم توافق المستند الوارد مع مخطط طلب خدمة XAI وبالتالي يتعين تحويله قبل معالجته بواسطة الموفق.

استجابة XSL هي اسم تحويل XSL المراد تطبيقه على مستند الاستجابة حين يتوقع طالب الخدمة أن يكون للاستجابة بنية مستند XML مختلفة عن تلك المحددة بواسطة مخطط الاستجابة للخدمة.

انقر على ارتباط عنوان URL لـ WSDL لبدء تشغيل نافذة منفصلة تحتوي على تعريف WSDL للخدمة الواردة. الرجاء ملاحظة إنه يتم بناء اسم الخادم ورقم المنفذ لعنوان URL باستخدام إعداد في ملف الخصائص العامة باستخدام إعداد عنوان URL لاستدعاء HTTP عبر XAI.