حدث OnPreStageChange (مرجع واجهة برمجة تطبيقات العميل)

يحدث هذا الحدث قبل أن تتغير مرحلة التحكم في تدفق عملية الأعمال. يحدث هذا الحدث بعد أن يحدد المستخدم أزرار المرحلة التالية أو الانتقال إلى المرحلة السابقة أو تعيين مرحلة نشطة في واجهة المستخدم أو عندما يستخدم formContext.data.process.moveNextformContext.data.process.movePreviousالمطور الأساليب أو أو .formContext.data.process.setActiveStage

إشعار

يتم دعم الحدث OnPreStageChange فقط على الواجهة الموحدة.

من داخل برنامج نصي لمورد ويب مسجل في الحدث onPreStageChange، يمكن للمطور استدعاء ما يلي على كائن executionContext الذي تم تمريره إلى البرنامج النصي لمورد الويب:

executionContext.getEventArgs().preventDefault();

عند استدعاء preventDefault:

  • لن تتم معالجة التنقل في المرحلة. سيبقى مثيل العملية في المرحلة الأصلية.
  • في التنقل عبر الجداول، لن يتم فتح نموذج جدول مرحلة الوجهة.
  • لن تتم معالجة حفظ النموذج الرئيسي. إذا كان الشكل الرئيسي في حالة قذرة، فإنه سيبقى في حالة قذرة.
  • لن يتم استدعاء أي موارد ويب مسجلة علىStageChange.

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

  • getDirection: إرجاع سلسلة إما Next أو Previous لإظهار اتجاه تغيير المرحلة.
  • getStage: إرجاع كائن مرحلة. باستثناء عندما ينتقل التنقل إلى جدول جديد، تمثل المرحلة التي تم إرجاعها عنصر مرحلة الوجهة - أي المرحلة النشطة التالية. عندما ينتقل التنقل إلى جدول جديد، تكون المرحلة هي المرحلة التي يتم التنقل منها - أي عنصر المرحلة النشط السابق. مزيد من المعلومات: أساليب المرحلة.

الأساليب المعتمدة لهذا الحدث

الأحداث (مرجع واجهة برمجة تطبيقات العميل)
الأحداث في النماذج والشبكات في التطبيقات التي تستند إلى النموذج