formContext.data.process (مرجع واجهة برمجة تطبيقات العميل)

يوفر الأحداث والأساليب والكائنات للتفاعل مع بيانات تدفق عملية الأعمال في نموذج. راجع formContext.ui.process (مرجع واجهة برمجة تطبيقات العميل) للحصول على أساليب للتفاعل مع عنصر تحكم تدفق عملية الأعمال في النموذج.

معالجة الأحداث وأساليب معالج الأحداث

استخدم الأحداث التالية وأساليب معالج الأحداث لكتابة البرامج النصية لتدفقات عمليات الأعمال.

الحدث	أساليب معالج الأحداث
OnPreProcessStatusChange	addOnPreProcessStatusChange removeOnPreProcessStatusChange
OnProcessStatusChange	addOnProcessStatusChange removeOnProcessStatusChange
OnPreStageChange	addOnPreStageChange removeOnPreStageChange
OnStageChange	addOnStageChange removeOnStageChange
OnStageSelected	addOnStageSelected removeOnStageSelected

أساليب العملية النشطة

استخدم هذه الأساليب لاسترداد معلومات حول العملية النشطة وتعيين عملية مختلفة كعملية نشطة.

Name	‏‏الوصف
getActiveProcess	إرجاع كائن عملية يمثل العملية النشطة.
setActiveProcess	تعيين عملية كعملية نشطة.

أساليب العملية

تحتوي العملية على البيانات الخاصة بتدفق عملية الأعمال. استخدم الأساليب للوصول إلى خصائص العملية.

Name	‏‏الوصف
getId	إرجاع المعرف الفريد للعملية.
getName	إرجاع اسم العملية.
getStages	إرجاع مجموعة من المراحل في العملية.
تم إعادة التسجيل	إرجاع قيمة منطقية تشير إلى ما إذا كانت العملية معروضة أم لا.

أساليب ProcessInstance

استخدم هذه الأساليب لاسترداد معلومات حول كافة مثيلات العملية لسجل وتعيين مثيل عملية كمثيل نشط.

Name	‏‏الوصف
getProcessInstances	إرجاع كافة مثيلات العملية لسجل الجدول الذي يمكن للمستخدم المتصل الوصول إليه.
setActiveProcessInstance	تعيين مثيل عملية كمثيل نشط.

أساليب المثيل

يحتوي مثيل العملية على بيانات مثيل لتدفق عملية الأعمال. استخدم الأساليب للوصول إلى خصائص مثيل العملية.

Name	‏‏الوصف
getInstanceId	إرجاع المعرف الفريد لمثيل العملية.
getInstanceName	إرجاع اسم مثيل العملية.
getStatus	إرجاع الحالة الحالية لمثيل العملية.
setStatus	تعيين الحالة الحالية لمثيل العملية النشطة.

أساليب المرحلة النشطة

استخدم هذه الأساليب لاسترداد معلومات حول المرحلة النشطة وتعيين مرحلة مختلفة كمرحلة نشطة.

Name	‏‏الوصف
getActiveStage	إرجاع كائن المرحلة الذي يمثل المرحلة النشطة.
setActiveStage	تعيين مرحلة مكتملة كمرحلة نشطة.

أساليب المرحلة

تحتوي المرحلة على بيانات لمرحلة في تدفق عملية الأعمال. استخدم الأساليب للوصول إلى خصائص المرحلة.

Name	‏‏الوصف
getCategory	إرجاع كائن باستخدام أسلوب getValue الذي سيعيد قيمة العدد الصحيح لفئة تدفق عملية الأعمال.
getEntityName	إرجاع الاسم المنطقي للجدول المقترن بالمرحلة.
getId	إرجاع المعرف الفريد للمرحلة.
getName	إرجاع اسم المرحلة.
getNavigationBehavior	إرجاع كائن سلوك التنقل لمرحلة يمكن استخدامها لتحديد ما إذا كان الزر إنشاء متوفرا للمستخدمين لإنشاء سجل جدول آخر في سيناريو التنقل في تدفق عملية الأعمال عبر الجداول.
getStatus	إرجاع حالة المرحلة.
getSteps	إرجاع مجموعة من الخطوات في المرحلة.

أساليب الخطوة

تحتوي الخطوة على بيانات لخطوة في مرحلة في تدفق عملية الأعمال. استخدم الأساليب للوصول إلى خصائص الخطوة.

Name	‏‏الوصف
getAttribute	إرجاع الاسم المنطقي للعمود المقترن بالخطوة.
getName	إرجاع اسم الخطوة.
getProgress	إرجاع تقدم خطوة الإجراء.
مطلوب	إرجاع قيمة منطقية تشير إلى ما إذا كانت الخطوة مطلوبة في تدفق عملية الأعمال.
setProgress	تحديث تقدم خطوة الإجراء.

أساليب التنقل

استخدم هذه الأساليب للانتقال إلى المراحل التالية والسابقة. سيؤدي كلا الأسلوبين إلى حدوث الحدث OnStageChange.

Name	‏‏الوصف
moveNext	التقدم إلى المرحلة التالية.
movePrevious	الانتقال إلى المرحلة السابقة.

طرق مفيدة أخرى

استخدم هذه الأساليب للعثور على معلومات حول المراحل في المسار النشط والعمليات الممكنة والمرحلة المحددة.

Name	‏‏الوصف
getActivePath	يحصل على مجموعة من المراحل الموجودة حاليا في المسار النشط مع أساليب للتفاعل مع المراحل المعروضة في التحكم في تدفق عملية الأعمال.
getEnabledProcesses	يسترد بشكل غير متزامن تدفقات عملية العمل الممكنة لجدول يمكن للمستخدم الحالي التبديل إليه.
getSelectedStage	الحصول على المرحلة المحددة حاليا.

المقالات ذات الصلة

formContext.ui.process (مرجع واجهة برمجة تطبيقات العميل)
فهم نموذج كائن Xrm
عناصر التحكم (مرجع واجهة برمجة تطبيقات العميل)