واجهة برمجة التطبيقات لسكريبت الخوارزمية المساعدة

تكون سكريبتات الخوارزميات المساعدة شبيهة بالخوارزميات المساعدة المعتمدة على برنامج في أنها:

  • يتم تشغيلها على ملقم التطبيق
  • تحتوي على واجهة برمجة التطبيقات الخاصة بها (واجهة المدخلات/المخرجات) المحددة بواسطة نقطة الخوارزمية المساعدة (بعبارة أخرى، لا تحدد سكريبتات الخوارزميات المساعدة عن واجهة برمجة التطبيقات الخاصة بها)
  • يمكن استدعاؤها بواسطة "مشغل نقطة الخوارزمية المساعدة"

بالنسبة للخوارزميات المساعدة المكَّونة لاستخدام إصدار محرك سكريبت، أفضل طريقة للتعرف على واجهة برمجة التطبيقات (API) للسكريبت هي استخدام الارتباط التشعبي عرض مخطط السكريبت لعرض مخطط منطقة بيانات المعلمات الخاصة بها.

منطقة بيانات الخوارزمية المساعدة

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

  • تمثل المعلمات البرمجية قيم المعلمات المحددة في الخوارزمية. لاحظ أنها بدون اسم - إذا كنت تريد الإشارة إليها في سكريبت الخوارزمية المساعدة الخاصة بك، يجب القيام بذلك حسب الموضع.
  • يتم التحكم في المعلمات المضمنة عن طريق نقطة الخوارزمية المساعدة (بعبارة أخرى، كيان الخوارزمية). لاحظ أن نقطة الخوارزمية المساعدة هذه تحتوي على معلمة إدخال واحدة تسمى "businessObject/id". لاحظ وجود السمة use= - والتي تشير إلى أن هذه المعلمة هي قيمة مدخلات فقط (بعبارة أخرى، لا يمكنك تغييرها في سكريبت الخوارزمية المساعدة).
ملاحظة: XPath. يمكنك النقر على اسم العنصر لعرض المسارX المستخدم للإشارة إلى العنصر في السكريبت الخاص بك.

لا تقوم الخوارزميات المساعدة المكَّونة لاستخدام إصدار محرك Groovy باستخدام واجهة XML لواجهة برمجة التطبيقات (API) وتتم معالجتها بنفس طريقة خوارزميات جافا بدلاً من ذلك. يوفر إطار العمل طبقة مستوى علوي تم إنشاؤها ديناميكيًا تقوم بتنفيذ نقطة الخوارزمية المساعدة لكائنات Groovy. لعرض طبقة المستوى العلوي هذه وطرق تعيين المعلمات المضمنة والحصول عليها، استخدم الارتباط التشعبي عرض طبقة المستوى العلوي للسكريبت.

ملاحظة: بالنسبة لسكريبتات الخوارزمية المساعدة التي تستخدم إصدار محرك Groovy، لا تظهر المعلمات البرمجية في واجهة برمجة التطبيقات (API) لنقطة الخوارزمية المساعدة كما هي محددة بطبقة المستوى العلوي. تقوم الخوارزميات الإضافية التي لا تستخدم إلا رمز Groovy فقط بتحديد المعلمات البرمجية الخاصة بها باستخدام التعليقات التوضيحية، بطريقة مشابهة لخوارزميات جافا، وإحضار تلك القيم باستخدام طرق محددة في رمز الخوارزمية.