M365Con 2027 – مؤتمر مجاني عبر الإنترنت · 11–22 Jan 2027 · 120 sessions m365con.net

Dataverse plug-in

Concept

كود مخصص من جانب الخادم مسجَّل في مسار أحداث Dataverse، يُنفَّذ عند تنفيذ عمليات البيانات، ويُستخدم في Dynamics 365 للتحقق من المعاملات وإجراء الحسابات.

✦ CONCEPTDataverse plug-inM365.FM
Title graphic: Dataverse plug-in (Concept)

مواضيع تُناقش أيضًا

في الحلقات التي تتناول Dataverse plug-in تُناقش أيضًا: Saga pattern، Transactional outbox pattern، Database normalization، Dataverse business skills، Dataverse business units وPSDataverse.

Description

الـ Dataverse plug-in هو معالج أحداث مخصص يستجيب لحدث معيّن أثناء معالجة عملية بيانات في Microsoft Dataverse. يُكتب على شكل صنف (class) داخل مجموعة .NET Framework، ثم تُسجَّل هذه المجموعة في Dataverse. يمكن أن تحتوي المجموعة الواحدة على عدة أصناف، لكل منها خطوة مختلفة في إطار الأحداث. وفي Dynamics 365، تُستخدم الـ plug-ins لمنطق يعمل على الخادم، مثل التحقق من المعاملات والحسابات التي يجب تنفيذها عند إنشاء البيانات أو تحديثها أو معالجتها بأي شكل آخر.

كل صنف من أصناف الـ plug-in ينفّذ الواجهة IPlugin، التي تحدد دالة واحدة هي Execute. عند وقوع الحدث المسجَّل، تستدعي Dataverse هذه الدالة وتمرر إليها بيانات السياق المتعلقة بالعملية الجارية. ومن هناك، يمكن للكود إلغاء عملية خط المعالجة الجارية، أو تعديل بيانات الأعمال التي تُعالَج، أو استدعاء عمليات بيانات أخرى، أو التواصل مع أنظمة خارجية، أو تمرير المعلومات إلى الـ plug-ins اللاحقة في خط المعالجة نفسه. ويمكن أن تعمل الـ plug-ins بشكل متزامن، وفي هذه الحالة تنتظر العملية انتهاءها، أو بشكل غير متزامن بعد اكتمال العملية.

الاختيار بين هذين الوضعين مهم من الناحية العملية. فالمنطق الذي يجب أن يمنع حفظ بيانات غير صحيحة ينتمي إلى الجزء المتزامن من خط المعالجة، بينما يمكن تنفيذ الأعمال التي تحدث بعد الحفظ بشكل غير متزامن. وتشير وثائق Microsoft Learn إلى أن الـ plug-ins المتزامنة يجب أن تعمل بسرعة، وأن التنفيذ يخضع لحد زمني صارم. كما أن الكود المكتوب بشكل سيئ قد يضر بالأداء، وبناء الـ plug-ins يتطلب مهارات مطوّر، لذلك فهي تحمل تكلفة لا تحملها الخيارات التصريحية.

ونظرًا لهذه العيوب، تنصح وثائق Microsoft بالنظر أولًا في الخيارات التصريحية. ومن البدائل التي تذكرها: الإجراءات المخصصة (custom actions)، والأعمدة المحسوبة وأعمدة التجميع (calculated and rollup columns)، والـ webhooks، وPower Automate. وتصبح الـ plug-in الأداة المناسبة عندما لا تغطي هذه الخيارات المتطلب، مثل الحالات التي يجب فيها فرض المنطق داخل المعاملة نفسها.

تضع حلقة M365.FM بعنوان "Customize Dataverse for Complex Business Apps" الـ Dataverse plug-in ضمن مصفوفة قرار لقواعد الأعمال. وبحسب الحلقة، تسير الأسئلة تقريبًا على النحو التالي: إذا كان يجب أن تمنع القاعدة البيانات غير الصحيحة، فاستخدم منطق الخادم المتزامن؛ وإذا كان يمكن تنفيذها بعد الحفظ، فاستخدم منطق الخادم غير المتزامن؛ وللمراسلة بين التطبيقات أو الموافقات، استخدم Flow أو Teams؛ وللحسابات الثقيلة أو عمليات الربط المعقدة، استخدم Dataverse plug-in أو Dataflow. كما توصي الحلقة بالاحتفاظ بكتالوج للقواعد يسجّل الجدول والمحفّز والشرط والإجراء ومالك كل قاعدة، وتنصح باستخدام الحقول المحسوبة وحقول التجميع للحسابات الحتمية ولمجاميع السجلات المرتبطة، بدلًا من اللجوء إلى الكود.

تتناول حلقة "Why Power Platform Is Your Real Automation Layer — Not Custom Code" الموضوع نفسه من زاوية تاريخ التخصيص. وتصف النموذج التقليدي لـ Dynamics، حيث يصبح كل اختلاف بين التطبيق القياسي وعملية العمل تخصيصًا إضافيًا: Dataverse plug-in، أو JavaScript مرفق بالنموذج، أو نشاط سير عمل مخصص، أو مهمة مجدولة، أو خدمة تكامل أخرى. وتقول الحلقة إن كل ميزة قد تعمل بشكل صحيح بمفردها، لكن العملية الكاملة تتوزع تدريجيًا بين المجموعات والنصوص البرمجية وسيرات العمل وواجهات البرمجة والقيم الإعدادية والمعرفة المتخصصة. ونتيجة لذلك، يفهم مالك العملية السياسة لكنه لا يستطيع فحص طريقة تنفيذها. وهذا هو الحجة الرئيسية لمعاملة الـ plug-ins كخيار متعمّد، لا كاستجابة تلقائية لكل تغيير في العملية.

Overview compiled with AI from M365.FM episodes and the facts on this page. You can improve it with the edit button below.

TypeConcept

Frequently asked questions

Questions marked with AI were written with AI from the facts on this page.

ما هو الـ Dataverse plug-in؟ (AI)

الـ Dataverse plug-in هو معالج أحداث مخصص، يُكتب على شكل صنف داخل مجموعة .NET Framework ويُسجَّل في Dataverse، ويعمل استجابةً لحدث معيّن أثناء عملية بيانات. ينفّذ كل صنف الواجهة IPlugin بدالة واحدة هي Execute.

هل يمكن أن يعمل الـ Dataverse plug-in بشكل متزامن وغير متزامن؟ (AI)

نعم. يمكن أن تعمل الـ plug-ins بشكل متزامن، فتنتظر العملية انتهاءها، أو بشكل غير متزامن بعد اكتمال العملية. وتشير وثائق Microsoft Learn إلى أن الـ plug-ins المتزامنة يجب أن تعمل بسرعة، وأن هناك حدًا زمنيًا صارمًا للتنفيذ.

متى ينبغي استخدام الـ Dataverse plug-in بدلًا من الخيارات الأخرى؟ (AI)

تنصح وثائق Microsoft Learn بالنظر أولًا في الخيارات التصريحية، مثل الإجراءات المخصصة والأعمدة المحسوبة وأعمدة التجميع وwebhooks وPower Automate. وتقترح حلقة "Customize Dataverse for Complex Business Apps" استخدام plug-in أو Dataflow للحسابات الثقيلة أو عمليات الربط المعقدة.

Glossary

Community wiki

Short info above, community knowledge below: add practical tips, examples or corrections. New contributions are reviewed first; trusted members publish directly.

Experts and companies for this topic

Nobody has listed this topic yet. Add it to your profile.

Maintained by Mirko Peters (Microsoft MVP) · Last updated: