تكوين إجراءات مخصصة من سير عمل أو مربع حوار

يمكنك تمكين إجراء مخصص من سير عمل أو مربع حوار، دون كتابة تعليمات برمجية. مزيد من المعلومات: استدعاء إجراء مخصص من سير عمل أو مربع حوار.

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

  • ما الذي يجب أن يفعله الإجراء؟

  • تحت أي ظروف يجب تنفيذ الإجراء؟

بخلاف عمليات سير العمل، لا تحتاج لتعيين الخيارات التالية:

  • البدء عند: تبدأ الإجراءات عند استدعاء التعليمات البرمجية للرسالة التي تم إنشاؤها لها.

  • نطاق: تعمل الإجراءات دائمًا في سياق المستخدم المستدعي.

  • التشغيل في الخلفية: تكون الإجراءات دائمًا هي عمليات سير العمل في الوقت الفعلي .

تتميز الإجراءات أيضًا بأمر غير متوفر في إجراءات سير العمل – وسيطات الإدخال والإخراج. مزيد من المعلومات: تحديد وسائط العملية

إنشاء إجراء

هام

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

مثل عمليات سير العمل، تضم الإجراءات الخصائص التالية في مربع حوار إنشاء عملية.

اسم الإجراء.
وبعد إدخال اسم للعملية، سيتم إنشاء اسم فريد لها عن طريق إزالة أية مسافات أو أحرف خاصة من اسم العملية.

الفئة
تنص هذه الخاصية على أن هذه عملية إجراء. لا يمكنك تغيير هذا بعد حفظ العملية.

الكيان
مع عمليات الإجراءات، يمكنك تحديد كيان لتوفير سياق لسير العمل مثل أنواع العمليات الأخرى، ولكن لديك أيضًا الخيار لاختيار بلا (عام). استخدم هذا إذا كان الإجراء الخاص بك لا يتطلب سياق كيان معين. لا يمكنك تغيير هذا بعد حفظ العملية.

كتابة
استخدم هذه الخاصية لاختيار ما إذا كنت تريد إنشاء إجراء جديد من البداية أو البدء من قالب موجود.

تحرير إجراء

يجب إلغاء تنشيط العمليات قبل أن تتمكن من تحريرها.

يمكنك تحرير إجراء تم إنشاؤه كجزء من حل غير مدار أو تم تضمينها في أحد الحلول المثبتة في مؤسستك. إذا كان الحل حلا مدارا، فقد لا تتمكن من تحريره. يكون لناشر الحلول الخيار لتحرير الخصائص المدارة بحيث لا يمكن تحرير إجراء تم تثبيته مع حل مدار.

عند حفظ إجراء، يتم إنشاء اسم فريد بناءً على اسم العملية. يحتوي هذا الاسم الفريد على بادئة التخصيص المضافة من ناشر الحلول. هذا هو اسم الرسالة التي سيستخدمها مطور في تعليماته البرمجية.

عند تحرير إجراء تظهر لك الخيارات التالية:

اسم العملية
بعد إنشاء العملية وإنشاء الاسم الفريد من اسم العملية، يمكنك تحرير اسم العملية. وقد ترغب في تطبيق إصلاح تسمية لتسهيل تحديد موقع عمليات معينة.

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

هام

بعد تنشيط الإجراء وكتابة التعليمات البرمجية لاستخدام اسم فريد، يحظر تغيير الاسم الفريد بدون تغيير أيضًا التعليمات البرمجية التي يشير إليها .

تمكين العودة للحالة السابقة
بصفة عامة، ستقوم العمليات التي تدعم المعاملات "بالتراجع" عن العملية (أو العودة إلى الحالة السابقة للعملية) بأكملها في حالة فشل أي جزء منها. وهناك بعض الاستثناءات لذلك. بعض الإجراءات التي قد يقوم بها المطورون في التعليمات البرمجية التي بدأها الإجراء، قد لا تدعم المعاملات. على سبيل المثال، إذا قامت التعليمات البرمجية بتنفيذ الإجراءات في أنظمة أخرى خارج نطاق المعاملة. لا يمكن العودة إلى الحالة السابقة لذلك بواسطة الإجراء الذي يعمل في Microsoft Dynamics 365. لا تدعم بعض الرسائل في النظام الأساسي Dynamics 365 المعاملات. ولكن سيدعم المعاملات كل ما يمكنك القيام به فقط مع واجهة مستخدم الإجراء. تعتبر جميع الإجراءات، التي تعد جزءً من سير العمل في الوقت الفعلي، في المعاملة، ولكن مع الإجراءات لديك الخيار أن ترفض هذا قطعًا.

وينبغي استشارة المطور الذي سيستخدم هذه الرسالة لتحديد ما إذا كان يجب أن تكون في المعاملة أم لا. بصفة عامة، يجب أن يكون الإجراء في المعاملة إذا كانت الإجراءات التي تم تنفيذها بواسطة عمليات العمل لا معنى لها، ما لم يتم إكمالها جميعًا بنجاح. يعد المثال النموذجي هو نقل الأموال بين اثنين من حسابات البنك. إذا تم سحب الأموال من حساب يجب إيداعها في الآخر. إذا فشلت واحدة من هاتين العمليتين، فستفشل كلتاهما.

ملاحظة

لا يمكنك تمكين العودة إلى الحالة السابقة إذا تم استدعاء إجراء مخصص مباشرة من داخل سير عمل أو مربع حوار. يمكنك تمكين العودة إلى الحالة السابقة إذا تم تشغيل إحراء بواسطة رسالة خدمات ويب في Dynamics 365.

التنشيط كـ
مثل جميع العمليات، يمكنك تنشيط العملية كقالب واستخدامه كنقطة بداية متقدمة للعمليات التي تتبع نمطاً مماثلاً.

تحديد وسائط العملية
في هذه المنطقة، ستحدد أي البيانات التي يتوقع أن يبدأها الإجراء وأي البيانات سيتم انتقالها من الإجراء. مزيد من المعلومات: تحديد وسائط العملية

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

تحديد وسائط العملية

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

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

يجب أن يكون لكل وسائط الإدخال والإخراج اسم ونوع وبعض المعلومات حول ما إذا كانت الوسيطة مطلوبة دائمًا. يمكنك أيضًا توفير وصف.

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

يمكنك تغيير ترتيب الوسائط بفرزها أو تحريكها لأعلى أو لأسفل إذ يتم تحديد الوسائط حسب الاسم، وليس حسب الترتيب. علاوةً على ذلك، لا يؤدي تغيير الوصف إلى توقف التعليمات البرمجية التي تستخدم الرسالة.

أنواع وسيطة عملية الإجراء

يصف الجدول التالي أنواع وسيطة عملية الإجراء.

كتابة الوصف
منطقي قيمة true أو قيمة false .
التاريخ والوقت قيمة تُخزن معلومات التاريخ والوقت.
عشري قيمة رقمية بدقة عشرية. يتم استخدامها عندما تكون الدقة بالغة الأهمية.
الكيان سجل تطبيق Dynamics 365 للكيان المحدد. عندما تحدد "الكيان"، يتم تمكين القائمة المنسدلة وتسمح لك بتحديد نوع الكيان.
EntityCollection مجموعة من سجلات الكيان.
EntityReference كائن يحتوي على اسم ومعرّف ونوع سجل كيان يحدده بشكل منفرد. عندما تحدد "EntityReference"، يتم تمكين القائمة المنسدلة وتسمح لك بتحديد نوع الكيان.
عائم قيمة رقمية بدقة عشرية. يتم استخدامه عندما تأتي البيانات من قياس غير دقيق على الإطلاق.
‏‏عدد صحيح عدد صحيح
نقود قيمة تُخزن البيانات حول مبلغ من المال.
Picklist قيمة تمثل خيارًا لسمة OptionSet.
سلسلة قيمة نصية

ملاحظة

لا يمكن تعيين قيم وسيطة EntityCollection في واجهة المستخدم للشروط أو الإجراءات. يتاح ذلك لاستخدام المطورين في التعليمات البرمجية المخصصة. مزيد من المعلومات: قم بإنشاء الإجراء الخاص بك

إضافة المراحل والخطوات

تعد الإجراءات نوع من العملية مشابهة جدًا لسير العمل في الوقت الفعلي. يمكن استخدام جميع الخطوات، التي يمكن استخدامها في سير العمل في الوقت الفعلي، في الإجراءات. لمزيد من المعلومات حول الخطوات التي يمكن استخدامها لكل من مهام سير العمل والإجراءات في الوقت الفعلي، راجع خطوات ومراحل سير العمل‬.

بالإضافة إلى الخطوات التي يمكن استخدامها لسير العمل في الوقت الفعلي، يكون للإجراءات أيضًا خطوة تعيين قيمة وهي مشابهة لتلك المستخدمة لتعيين متغيرات أو وسائط الإدخال في مربعات الحوار. في الإجراءات،يمكن استخدام هذه فقط لتعيين وسائط إخراج. يمكنك استخدام مساعد النموذج لتعيين وسائط الإخراج لقيم معينة أو من الأرجح لقيم من السجل الذي يقوم الإجراء بالعمل مقابله أو السجلات المتصلة بالسجل ذو العلاقات متعدد إلى واحد أو السجلات التي تم إنشاؤها في خطوة سابقة أو القيم التي تشكل جزءً من العملية نفسها.

(راجع أيضاً )

إجراءات
استدعاء إجراءات مخصصة من سير عمل أو مربع حوار
مراقبة مهام سير العمل والإجراءات في الوقت الفعلي عمليات سير العمل
مربعات حوار
عمليات سير إجراءات العمل
مراقبة العمليات وإدارتها
إنشاء إجراءات خاصة بك أنواع العمليات