استدعاء إجراءات Power Automate من API للويب

مكتمل

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

Dataverse يحتوي على العديد من الإجراءات المعدة مسبقًا، ويمكن للمطورين إنشاء إجراءات مخصصة باستخدام ميزة Custom API الخاصة بـ Dataverse.

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

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

قم بتشغيل الإجراءات باستخدام Web API

عندما يتم إنشاء إجراء جديد فِي Dataverse بيئتك، يقوم الإطار أيضًا بإنشاء رسالة طلب Web API المقابلة. يمكنك تشغيل هذه الطلبات باستخدام عملية POST مشابهة للمثال التالي:

POST [Organization URI]/api/data/v9.2/WinOpportunity HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0

{
 "Status": 3,
 "OpportunityClose": {
  "subject": "Won Opportunity",
  "opportunityid@odata.bind": "[Organization URI]/api/data/v9.2/opportunities(b3828ac8-917a-e511-80d2-00155d2a68d2)"
 }
}

المثال أعلاه عبارة عن استدعاء طلب HTTP لإجراء WinOpportunity للحصول على opportunityid فرصة بقيمة b3828ac8-917a-e511-80d2-00155d2a68d2.

استدعاء الإجراءات المعدة Dataverse مسبقًا

Dataverse يأتي مع مجموعة من الإجراءات الموجودة التي يمكنك استخدامها لتنفيذ العمليات الشائعة. قد تُطبَّقُ بعض هذه الإجراءات فقط على تطبيقات تستند إلى النماذج أو تطبيقات Dynamics 365. على سبيل المثال، يحسب الإجراء CalculatePrice السعر فِي الفرصة/عرض الأسعار/الأمر/الفاتورة، لذلك سيتم تطبيقه فقط على تطبيق Dynamics 365 Sales حيث توجد هذه الوظيفة.

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

الإجراءات غير المقيدة مقابل الإجراءات المقيدة

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

تعتبر الإجراءات غير المنضمة مفيدة للمنطق العام الذي يتم تشغيله خارج سياق صف جدول محدد، مثل إجراء WinOpportunity الذي تمت الإشارة إليه مسبقًا. لتشغيل إجراء مرتبط بصف معين، يجب عليك تقديم معرف هذا الصف فِي معرف URI الخاص بطلبك:

POST [Organization URI]/api/data/v9.2/contacts(94d8c461-a27a-e511-80d2-00155d2a68d2)/Microsoft.Dynamics.CRM.contoso_AddNoteToContact HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0

{
 "NoteTitle": "New Note Title",
 "NoteText": "This is the text of the note"
}

يستدعي المثال السابق إجراءً مخصصًا تم إنشاؤه مسبقًا فِي الحل يسمى جهة اتصال contoso_AddNoteToContact بمعرف 94d8c461-a27a-e511-80d2-00155d2a68d2 ثم يقوم بتمرير المعلمات NoteTitle وNoteText إلى الإجراء. سيكون السلوك المتوقع لهذا الإجراء هو أنه ستتم إضافة ملاحظة جديدة إلى جهة الاتصال المقابلة بصحبة العنوان والنص المقدَّمان.

مزيد من التفاصيل

لمزيد من المعلومات حول كيفية استدعاء الإجراءات فِي التعليمات البرمجية، راجع استخدام إجراءات API للويب.