استدعاء إجراءات Power Automate من Web API

  • 10 دقائق

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

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

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

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

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

POST [Organization URI]/api/data/v9.0/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.0/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.0/contacts(94d8c461-a27a-e511-80d2-00155d2a68d2)/Microsoft.Dynamics.CRM.new_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"
}

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

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

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