السابق

التالي

تمرين - تنفيذ مشغل استطلاع

مكتمل

في هذا التمرين، ستضيف مشغل استطلاع إلى الموصل المخصص لواجهة API Contoso Invoicing الحالية.

هام

استخدم بيئة اختبار مع توفير Microsoft Dataverse. إذا لم يكن لديك واحد، فيمكنك الاشتراك في خطة المجتمع.

الهامة 1: استيراد حل باستخدام الموصل المخصص

ملاحظة

يمكنك المتابعة باستخدام الموصل الذي أنشأته وعدلته في الوحدة 4: تنفيذ مشغل خطاف الويب. إذا أكملت هذا التمرين، يمكنك التخطي إلى الهامة 2.

ملاحظة

قم بتنزيل الملف التالي إلى الكمبيوتر المحلي لديك لإكمال مشغّلات Contoso Invoicing. حدّد الزر "تنزيل" في منتصف الشاشة على اليمين.

في هذه الهامة، ستستورد حلاً غير مُدار يحتوي على موصل مخصص تم إنشاؤه مسبقاً لواجهة API Contoso Invoicing.

1. انتقل إلى Power Apps maker portal وتأكد من وجودك في البيئة الصحيحة.

2. حدّد الحلول > استيراد.

3. حدّد استعراض.

4. حدّد الحل ContosoInvoicingTriggers_1_0_0_0.zip ثم حدّد فتح.

5. حدّد التالي.

6. حدّد استيراد ثم انتظر حتى يكتمل الاستيراد. من المفترض أن تتلقى رسالة نجاح بعد اكتمال الاستيراد.

7. حدّد نشر جميع التخصيصات وانتظر حتى اكتمال النشر.

8. افتح حل مشغلات استيراد Contoso الذي قمت باستيراده.

   يجب أن تشاهد مشغلات Contoso invoicing مكون الموصل المخصص.

   

9. انتقل إلى Contoso Invoicing.

10. حدّد ارتباط مفتاح API.

    

11. انسخ مفتاح API ثم الصقه في مفكرة لاستخدامها في وقت لاحق.

12. عُد إلى Power Apps maker portal وتأكد من وجودك في البيئة الصحيحة.

13. حدّد الحلول ثم افتح حل مشغلات Contoso invoicing.

14. افتح الموصل المخصص مشغلات Contoso invoicing.

15. حدّد تحرير.

    

16. أدخل contosoinvoicing.azurewebsites.net في المضيف.

17. حدّد تحديث الموصل.

18. حدّد اختبار > + موصل جديد.

    

19. الصق مفتاح API وحدّد إنشاء اتصال.

    

20. حدّد تحديث. يجب تحديد الاتصال الذي قمت بإنشائه تلقائياً.

21. قم بالتمرير لأسفل إلى قسم العمليات وحدّد ListInvoice، ثم حدّد اختبار التشغيل.

    

    يجب أن تشاهد قائمة بالفواتير في قسم النص الأساسي.

    

22. لا تخرج من هذه الصفحة.

الهامة 2: إضافة مشغل استطلاع

إذا تخطيت الهامة السابقة، فانتقل إلى موصل مشغلات Contoso Invoicing الخاصة بك وحدّد تحرير.

1. حدّد التعريف

   

2. قم بالتمرير لأسفل إلى قسم المشغلات وحدّد + مشغل جديد.

3. قم بتوفير القيم التالية:

   • ملخص - عند إنشاء الفاتورة (استطلاع)

   • وصف -عند إنشاء الفاتورة (استطلاع)

   • معرف العملية - InvoiceCreatedPoll

   • نوع المشغل - استطلاع

   

4. انتقل إلى قسم الطلب وحدّد + استيراد من العينة.

   

5. أدخل القيم التالية ثم حدّد استيراد.

   • فعل - GET

   • عنوان URL - https://contosoinvoicing.azurewebsites.net/ListInvoices?fromDate=

6. حدّد زر علامة الحذف chevron بجوار fromDate ثم حدّد تحرير.

   

7. حدّد داخلي لـ الرؤية ثم حدّد الزر رجوع.

   

8. قم بالتمرير لأسفل إلى قسم الاستجابة ثم حدّد + إضافة استجابة افتراضية.

9. الصق كود JSON التالي في حقل النص ثم حدّد استيراد.

   {
     "invoices": [
       {
         "invoiceId": "1933",
         "date": "2021-01-26T04:02:52.1490835Z",
         "createDate": "2021-01-25T04:02:52.1490835Z",
         "amount": 5000,
         "accountId": "1001",
         "accountName": "Wing Tips",
         "status": "Invoiced",
         "typeId": 1,
         "purchaseOrderId": "3002",
         "tags": "New Account;Special Pricing"
       }
     ]
   }
   

   

10. انتقل إلى قسم تكوين المشغل وقم بتوفير القيم التالية:

    • تحديد معلمة استعلام لمراقبة تغيير الحالة - fromDate

    • قم بتحديد قيمة لتمريرها إلى معلمة الاستعلام المحددة. يمكنك اختيار تعبيرات - @{triggerBody().invoices[0].createDate}

    • تحديد مجموعة تحتوي على بيانات المشغّل - @triggerBody().invoices

    

11. حدّد الزر تحديث الموصل الموجود أعلى الشاشة، ثم انتظر حتى يتم تحديث الموصل.

الهامة 3: اختبار المشغل

إذا كنت قد قمت بالفعل بإكمال الوحدة 4: تنفيذ مشغل خطاف ويب وقمت بإنشاء تدفق السحابة إنشاء فاتورة، قم بالتخطي إلى الخطوة 14.

1. انتقل إلى Power Apps maker portal وتأكد من أنك في البيئة.

2. حدّد الحلول ثم افتح حل مشغلات Contoso invoicing.

3. حدّد + جديد > تدفق السحابة.

4. أدخل إنشاء فاتورة للاسم ثم حدّد تشغيل التدفق يدوياً للمشغل.

   

5. حدّد + إضافة إدخال.

6. حدّد رقم لنوع الإدخال.

   

7. أدخل المبلغ لاسم الإدخال ثم حدّد + خطوة جديدة.

   

8. حدّد علامة التبويب مخصص ثم حدّد الموصل المخصص Contoso invoicing.

   

9. حدّد إجراء إضافة الفاتورة.

10. أدخل اتصال Contoso في حقل اسم الاتصال، والصق مفتاح API الذي نسخته في الهامة 1:، ثم حدّد إنشاء.

    

11. حدّد الحقل المبلغ ثم حدّد المبلغ من جزء المحتوى الديناميكي.

    

12. حدّد حفظ.

13. حافظ على علامة تبويب المستعرض أو النافذة هذه مفتوحة.

14. ابدأ فتح مستعرض جديد وانتقل إلى https://make.powerapps.com/

15. تأكد مِن تحديد البيئة الصحيحة.

16. حدّد الحلول وافتح حلول Contoso Invoicing - Triggers.

17. حدّد + جديد> التشغيل التلقائي > تدفق السحابة > المؤتمت.

18. أدخل استطلاع إخطار الفاتورة للاسم وحدّد تخطي.

19. حدّد علامة التبويب مخصص ثم حدّد الموصل المخصص Contoso invoicing.

    

20. حدّد المشغل عند إنشاء الفاتورة (استطلاع).

    

21. حدّد زر ... القائمة للمشغل ثم تأكد من تحديد مراجع الاتصال.

    

22. حدّد + خطوة جديدة.

23. ابحث عن إعداد ثم حدّد الإجراء إعداد.

24. حدّد حقل المدخلات ثم حدّد النص الأساسي من جزء المحتوى الديناميكي.

    

25. حدّد حفظ، ثم انتظر حتى يتم حفظ التدفق.

26. حدّد اختبار.

27. حدّد يدويًا > اختبار. سيبدأ التدفق، وعليك انتظار الإخطارات.

28. قم بالتبديل إلى علامة تبويب أو نافذة الاستعراض إنشاء فاتورة.

29. حدّد اختبار.

30. حدّد يدويًا > اختبار.

31. أدخل 6500 لـ المبلغ ثم حدّد تشغيل التدفق.

32. حدّد تم.

33. يجب أن يعمل التدفق بنجاح. حدّد تحرير.

    

34. حدّد اختبار مرة أخرى.

35. حدّد يدويًا > اختبار.

36. أدخل 8800 لـ المبلغ ثم حدّد تشغيل التدفق.

37. حدّد تم. يجب أن يتم تشغيل التدفق بنجاح مرة أخرى.

38. قم بالتبديل إلى تدفق استطلاع إخطار الفاتورة. يجب أن يتم تشغيل التدفق بنجاح.

    ملاحظة

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

39. حدّد لتوسيع خطوة الإجراء إنشاء.

    

40. راجع الإخراجات ثم حدّد الزر.

    

    من المفترض أن ترى نتيجتين قيد التشغيل للفاتورتين اللتين أنشأتهما.

    

متابعة