تكوين الإجراءات

 

تاريخ النشر: جمادى الأولى, 1438

ينطبق على: Dynamics 365 (online)، Dynamics 365 (on-premises)، Dynamics CRM 2016، Dynamics CRM Online

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

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

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

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

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

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

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

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

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

System_CAPS_importantهام

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

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

اسم الإجراء.

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

الفئة

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

الكيان

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

كتابة

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

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

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

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

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

اسم العملية

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

الاسم الفريد

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

System_CAPS_importantهام

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

تمكين العودة للحالة السابقة

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

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

System_CAPS_noteملاحظة

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

التنشيط كـ

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

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

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

أضف المراحل والشروط والإجراءات

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

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

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

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

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

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

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

كتابة

الوصف

Boolean

قيمة true أو قيمة false .

DateTime

قيمة تُخزن معلومات التاريخ والوقت.

Decimal

قيمة رقمية بدقة عشرية. يتم استخدامها عندما تكون الدقة بالغة الأهمية.

Entity

سجل تطبيق Dynamics 365 للكيان المحدد. عندما تحدد Entity، يتم تمكين القائمة المنسدلة وتسمح لك بتحديد نوع الكيان.

EntityCollection

مجموعة من سجلات الكيان.

EntityReference

كائن يحتوي على اسم ومعرّف ونوع سجل كيان يحدده بشكل منفرد. عندما تحدد EntityReference، يتم تمكين القائمة المنسدلة وتسمح لك بتحديد نوع الكيان.

Float

قيمة رقمية بدقة عشرية. يتم استخدامه عندما تأتي البيانات من قياس غير دقيق على الإطلاق.

Integer

عدد صحيح

Money

قيمة تُخزن البيانات حول مبلغ من المال.

Picklist

قيمة تمثل خيارًا لسمة OptionSet .

String

قيمة نصية

System_CAPS_noteملاحظة

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

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

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

© 2017 Microsoft. جميع الحقوق محفوظة. حقوق النشر

إظهار: