إجراءات عامة
ويتم تحديد الإجراءات المستخدمة في Power Automate بواسطة الموصلات. كل موصل لديه مجموعة الإجراءات الخاصة به. توضح الأقسام التالية الإجراءات الشائعة بين Power Automate وDataverse.
يحتوي موصل Dataverse على الإجراءات التالية:
- إنشاء سجل جديد
- الحصول على سجل
- قائمة السجلات
- تحديث سجل
- حذف سجل
موصل Dataverse الشائع (البيئة الحالية) له نفس الإجراءات، بما في ذلك العديد من الإجراءات الأخرى:
- إنشاء صف جديد
- الحصول على صف بالمعرّف
- صفوف القائمة
- تحديث صف
- حذف صف
- ربط الصفوف
- إلغاء ربط الصفوف
- إجراء طلب مجموعة تغييرات
- تنزيل ملف أو صورة
- تحميل ملف أو صورة
- إجراء عملية دمج
- إجراء عملية إلغاء دمج
- التنبؤ باستخدام نماذج AI Builder
يسمح موصل Dataverse أيضاً بإنشاء واستخدام التدفقات الفرعية.
ملاحظة
يتميز موصل Dataverse بالعديد من المزايا مقارنة بالموصلات الأخرى ويجب أن يكون خيارك الأول مع Power Automate.
استرداد البيانات
عند استخدام إجراء الحصول على صف حسب المعرف أو صفوف القائمة لاسترداد البيانات، يجب عليك التأكد من تحديد حقول العمود المطلوبة فقط للتدفق.
توفر معظم مشغلات Dataverse جميع الحقول، ولا تحتاج إلى استرداد السجل صراحة فور تشغيل المشغل. ومع ذلك، تنطبق الاستثناءات التالية:
- لا يتضمن مشغل عند تحديد سجل حقول بحث متعددة إلى واحد، وسيكون الإجراء الحصول على صف حسب المعرّف مطلوبًا.
- يتضمن الخيار حذف معرّف الصف فقط، ولكن لا يتضمن أعمدة أخرى.
ملاحظة
عند الرجوع إلى بيانات تم استردادها مسبقاً في تدفق، لا يتم تحديث البيانات تلقائياً بعد تشغيل الخطوة الأصلية.
الحصول على قوائم البيانات
يمكن أن يساعدك إجراء صفوف قائمة في تصفية البيانات باستخدام استعلام OData أو استعلام FetchXML لاسترداد البيانات.
عند استخدام إجراء صفوف القائمة، عليك:
- تصفية البيانات في إجراء صفوف القائمة، وليس في خطوة لاحقة باستخدام إجراءات تشغيل البيانات.
- ضع في اعتبارك أن عوامل تصفية Fetch Xml Query يمكنها عمل معايير أكثر تقدمًا، بما في ذلك الكيانات ذات الصلة.
- استخدم عامل التصفية توسيع الاستعلام لتضمين الصفوف ذات الصلة في النتيجة.
- استخدم أداة FetchXMl Builder في XrmToolBox لإنشاء استعلامات OData وFetchXML.
- قم بتمكين ترقيم الصفحات إذا كنت تريد أكثر من صفحة بيانات واحدة. يتم تحديد حجم الصفحة بواسطة الموصل، وDataverse هو 1024. يتم تمكين ترقيم الصفحات من خلال إعدادات الإجراء. يبلغ الحد 100,000 صفاً.
ملاحظة
يمكن أن يساعد عامل التصفية توسيع الاستعلام في تقليل تعقيد تدفقاتك وتقليل عدد استدعاءات API التي يتم إجراؤها وتسريع تدفقاتك.
تحديث البيانات
عند استخدام إجراء تحديث صف، يجب عليك:
- تضمين الأعمدة التي تم تغييرها فقط. يتجنب هذا النهج بدء التشغيل الآلي وتسجيل التدقيق.
- استخدم التعبير الفارغ لمسح القيم.
- قم بتوفير GUID للمعرف الأساسي، إذا كنت تستخدم مفتاح بديل، والذي سينفذ عملية Upsert باستخدام أعمدة البيانات الأخرى التي توفرها.
استدعاء الإجراءات المخصصة
تستخدم Microsoft المصطلح الإجراء للعديد من السلوكيات المختلفة في العمليات، ولنوع من العمليات، وللخطوات داخل العمليات والتدفقات. الإجراءات المخصصة هي عمليات تشبه عمليات التدفق الكلاسيكية في قدراتها من حيث ما يمكن تنفيذه بالخطوات؛ بمعنى آخر ، يمكن أن تستخدم عمليات الإجراء الشروط ويمكنها إنشاء الصفوف وتحديثها.
الإجراءات المخصصة هي عمليات قابلة لإعادة الاستخدام ويمكن بدؤها من التعليمات البرمجية وPower Automate. تتضمن Microsoft أيضًا العديد من الإجراءات المضمنة مثل:
- تعيين قالب Word - إنشاء مستند Microsoft Word من قالب Word.
- إضافة إلى قائمة الانتظار - إضافة سجل إلى قائمة انتظار.
يمكن لتدفقات المجموعات Power Automate استدعاء إجراءات مخصصة باستخدام موصل Dataverse. يجب عليك استخدام تنفيذ إجراء مقيد لعمليات الإجراء المرتبطة بجدول واستخدام تنفيذ إجراء غير منضم لعمليات الإجراء التي تم تعيينها على أنها عمومية.