مقدمة
تصف هذه الوحدة النمطية كيفية توسيع وظائف الموصلات المخصصة مع تعريفات المشغّلات.
خلال هذه الوحدة النمطية، سوف تتمكن مما يلي:
التعرف على المشغّلات في الموصلات المخصصة.
اكتشاف السيناريوهات الشائعة حيث يمكن استخدام المشغّلات.
تحديد الأنواع المختلفة مِن المشغّلات.
التعرف على كيفية توسيع تعريف موصل مخصص إلى المشغّلات التي تم تعريفها بواسطة API الخاص بالخدمة.
تسمح لك المشغّلات بتوسيع وظيفة الموصل في Microsoft Power Automate وMicrosoft Azure Logic Apps"، حيث يحتاج النظام إلى الاستجابة للتغييرات في البيانات أو الخدمات الأساسية. يعتبر السيناريو الأكثر شيوعاً لاستخدام المشغّل هو إنشاء تدفق السحابة الذي يبدأ تشغيله عند تغيير البيانات الأساسية، مثل "عند إنشاء سجل،" أو عند حدوث حدث معين في الخدمة المعرفة بواسطة الموصل المخصص، مثل "عند تشغيل الإنذار."
المشغّلات في Power Automateو"التطبيقات المنطقية"
يقوم Power Automate و"التطبيقات المنطقية" بتعريف المشغّل كحدث يبدأ تدفق السحابة أو تدفق "التطبيقات المنطقية". يمكن أن يتم بدء هذه الأحداث بواسطة مستخدم أو تمت جدولته أو تم إنشاؤه بواسطة موصل، بما في ذلك مخصص. تقوم تعريفات المشغّلات بتوسيع الموصلات المخصصة والسماح باستخدام هذه الموصلات لبدء تدفقات السحابة ومهام تدفق "التطبيقات المنطقية".
يعرّف معظم الموصلات ملخص المشغّل بالقيمة "عندما يكون <الكائن> عبارة عن <فعل>," ويتضمن تطبيق موصل نموذجي مشغّلاً وحداً لإجراء واحد أو أكثر.
أنواع المشغّلات
خذ بعين الاعتبار نظام إدارة البريد الصوتي. ويمكن أن يكون المشغّل الموجود في هذا النظام حدث "رسالة بريد جديد يتم تلقيها". هناك طريقتان لتحديد أسلوب لتعريف ما إذا كان قد تم تلقي بريد صوتي جديد أم لا:
قم بالاتصال بعلبة البريد الصوتي بشكل دوري وتحقق مِن وجود رسائل جديدة. يصف هذا السلوك مشغّل الاستقصاء، وهو التطبيق حيث يتم استقصاء البيانات مِن الخدمة الأساسية. مشغّل الاستقصاء هو نشاط موقوت يقوم ببدء استدعاء واجهة API للخدمة على فاصل زمني عادي قابل للتكوين لتحديد ما إذا كانت البيانات الجديدة متاحة. لدعم مشغّلات الاستقصاء، يمكن لواجهة API تصفية النتائج بناء علة حالة ما. وعادة ما تستند الحالة إلى فترة زمنية، على سبيل المثال، "إرجاع كافة الرسائل الصوتية التي تم استلامها منذ البارحة."
اسمح لنظام البريد الصوتي بإرسال بريد إلكتروني إليك عند تلقي رسالة صوتية جديدة. يعرف هذا الأسلوب مشغّل أو تطبيق خطاف الويب حيث تدفع الخدمة البيانات. يجب أن تكون الخدمة التي تدعم مشغّلات خطاف الويب قادرة على الاحتفاظ بقائمة بالأطراف لإعادة الاتصال ومعرفة كيفية الاتصال مرة أخرى. في مثال البريد الصوتي، ستكون قائمة بعناوين البريد الإلكتروني وإمكانيه إرسال بريد الإلكتروني للإعلام.
بشكل أساسي، يختلف نوعان مِن المشغّلات فيما يتعلق بالجانب المسؤول عن إدارة العمليات.
| الاستقصاء | خطاف الويب |
|---|---|
| البدء بإعداد حالة | مسجل مع الخدمة |
| التحقق دورياً مِن وجود تحديثات | إصدار إشارة عند حدوث حدث |
| طلب كافة البيانات الجديدة منذ آخر تحديث للحالة | تم التقسيم تلقائياً إلى الأسفل |
| محافظة الخدمة على الحالة | Power Automate أو "التطبيقات المنطقية" التي تدير عملية تسجيل خطاف الويب وإلغاء تسجيله |
هام
لا يشير توفر واجهة API REST لخدمة إلى إمكانية تعريف مشغّلات موصل مخصصة. يجب أن تكون الخدمة الأساسية قادرة على إرجاع البيانات بشكل تزايدي أو تقوم بتوفير تطبيق خطاف الويب. إذا كانت المشغّلات مطلوبة ولكن واجهه API للخدمة ليس لها القدرة، سيحتاج المطور إلى توسيع الخدمة لتمكين المستخدمين مِن تعريف أحد المشغّلات.
تحديد مشغّل
بطريقة مماثلة لتعريف الموصل، نوعا المشغّلات معرّفان بواسطة مستند OpenAPI (Swagger) الذي يحدّد نقاط النهاية والمعلمات والشروط والاستجابات. لكن، إصدار مواصفات OpenAPI الذي يستخدمه Microsoft Power Platform لا يميّز بين الإجراءات والمشغّلات. يضيف Microsoft Power Platform ملحقات OpenAPI المخصصة لتوسيع المواصفات لتعريف المشغّلات ومحتوياتها.
يتوفر معالج خطوة بخطوة للمشغّلات، ويتبع نفس التخطيط العام مثل معالج الإجراء.
مثل إجراءات الموصل المخصصة، فإن تحديد ملخص مشغّل جيد هو المهم. يتم استخدام ملخص عندما يقوم صانع بالبحث عن الموصلات، وعند تحديد مشغّل، يصبح التلخيص الخاص به هو عنوان الخطوة الافتراضية في Power Automate و"التطبيقات المنطقية".
بعكس الإجراءات، يمكن إنشاء معظمها بالكامل في مصمم الموصل المخصص، ويمكن أن تكون المشغّلات أكثر تعقيداً وغالباً ما تتطلب إجراء تعديلات يدوية. تصف هذه الوحدة النمطية كيفية إنشاء تعريفات للمشغّلات في الاستقصاء وسيناريوهات خطاف الويب.