اشترك وانتظر الأحداث لتشغيل مهام سير العمل باستخدام خطافات الويب HTTP في Azure Logic Apps
ينطبق على: Azure Logic Apps (الاستهلاك + قياسي)
بدلا من استخدام مشغل يتحقق بانتظام من نقطة نهاية خدمة أو إجراء يستدعي نقطة النهاية هذه أو يستطلعها ، يمكنك استخدام مشغل أو إجراء HTTP Webhook يشترك في نقطة نهاية خدمة، وينتظر أحداثا معينة، ويشغل إجراءات محددة في سير العمل.
فيما يلي بعض أمثلة مهام سير العمل المستندة إلى خطاف الويب:
- انتظر حتى يصل حدث من Azure Event Hubs قبل تشغيل سير العمل.
- انتظر الموافقة قبل متابعة سير العمل.
يوضح هذا الدليل كيفية استخدام مشغل HTTP Webhook وإجراء Webhook بحيث يمكن لسير العمل تلقي الأحداث والاستجابة لها في نقطة نهاية الخدمة.
كيف تعمل خطافات الويب؟
يستند مشغل خطاف الويب إلى الحدث، والذي لا يعتمد على التحقق من البيانات أو الأحداث الجديدة أو التحقق منها بانتظام. بعد إضافة مشغل webhook إلى سير عمل فارغ ثم حفظ سير العمل، أو بعد إعادة تمكين مورد تطبيق منطقي معطل، يشترك مشغل webhook في نقطة نهاية الخدمة المحددة عن طريق تسجيل عنوان URL لرد الاتصال بنقطة النهاية هذه. ثم ينتظر المشغل نقطة نهاية الخدمة هذه لاستدعاء عنوان URL، الذي يقوم بتشغيل المشغل وبدء سير العمل. على غرار مشغل الطلب، يتم تشغيل مشغل إخطار على الويب على الفور. يظل مشغل خطاف الويب مشتركا أيضا في نقطة نهاية الخدمة ما لم تتخذ الإجراءات التالية يدويا:
- تغيير قيم معلمات المشغل.
- احذف المشغل ثم احفظ سير العمل.
- تعطيل مورد تطبيق المنطق الخاص بك.
على غرار مشغل خطاف الويب، يعمل إجراء إخطار على الويب أيضا على أساس الحدث. بعد إضافة إجراء webhook إلى سير عمل موجود ثم حفظ سير العمل، أو بعد إعادة تمكين مورد تطبيق منطقي معطل، يشترك إجراء webhook في نقطة نهاية الخدمة المحددة عن طريق تسجيل عنوان URL لرد الاتصال بنقطة النهاية هذه. عند تشغيل سير العمل، يوقف إجراء خطاف الويب سير العمل مؤقتا وينتظر حتى تستدعي نقطة نهاية الخدمة عنوان URL قبل استئناف تشغيل سير العمل. الإجراء webhook إلغاء الاشتراك من نقطة نهاية الخدمة عند حدوث الشروط التالية:
- ينتهي إجراء الإخطار على الويب بنجاح.
- يتم إلغاء تشغيل سير العمل أثناء انتظار استجابة.
- قبل أن ينفد وقت تشغيل سير العمل.
- يمكنك تغيير أي قيم معلمات إجراء webhook التي يتم استخدامها كمدخلات بواسطة مشغل إخطار على الويب.
على سبيل المثال، يعد إجراء إرسال بريد إلكتروني للموافقة على موصل Office 365 Outlook مثالا على إجراء خطاف الويب الذي يتبع هذا النمط. يمكنك توسيع هذا النمط إلى أي خدمة باستخدام إجراء webhook.
لمزيد من المعلومات، راجع الوثائق التالية:
للحصول على معلومات حول التشفير والأمان والتخويل للمكالمات الواردة إلى تطبيق المنطق الخاص بك، مثل أمان طبقة النقل (TLS)، المعروف سابقا باسم طبقة مآخذ التوصيل الآمنة (SSL)، أو مصادقة Microsoft Entra ID Open Authentication (Microsoft Entra ID OAuth)، راجع الوصول الآمن والبيانات - الوصول إلى المكالمات الواردة إلى المشغلات المستندة إلى الطلب.
مرجع تقني الاتصال أو
لمزيد من المعلومات حول معلمات المشغل والإجراءات، راجع معلمات HTTP Webhook.
المتطلبات الأساسية
حساب واشتراك Azure. إذا لم يكن لديك اشتراك، فقم بالتسجيل للحصول على حساب Azure مجاني.
عنوان URL لنقطة نهاية منشورة بالفعل أو واجهة برمجة تطبيقات تدعم نمط الاشتراك في خطاف الويب وإلغاء الاشتراك لمشغلات خطاف الويب في مهام سير العمل أو إجراءات خطاف الويب في مهام سير العمل حسب الاقتضاء
سير عمل تطبيق منطق قياسي أو استهلاكي حيث تريد انتظار أحداث معينة في نقطة النهاية الهدف. للبدء بمشغل HTTP Webhook، أنشئ تطبيقا منطقيا بسير عمل فارغ. لاستخدام إجراء HTTP Webhook، ابدأ سير العمل بأي مشغل تريده. يستخدم هذا المثال مشغل HTTP كخطوة أولى.
إضافة مشغل HTTP Webhook
يستدعي هذا المشغل المضمن نقطة نهاية الاشتراك على الخدمة الهدف ويسجل عنوان URL لرد الاتصال مع الخدمة الهدف. ثم ينتظر سير العمل الخاص بك حتى ترسل HTTP POST الخدمة الهدف طلبا إلى عنوان URL لرد الاتصال. عند حدوث هذا الحدث، يتم تشغيل المشغل ويمرر أي بيانات في الطلب إلى سير العمل.
في مدخل Microsoft Azure، افتح تطبيق المنطق القياسي وسير العمل الفارغ في المصمم.
اتبع هذه الخطوات العامة لإضافة المشغل المسمى HTTP Webhook إلى سير العمل الخاص بك.
يعيد هذا المثال تسمية المشغل إلى مشغل HTTP Webhook بحيث يكون للخطوة اسم وصفي أكثر. أيضا، يضيف المثال لاحقا إجراء WEBhook HTTP، ويجب أن يكون كلا الاسمين فريدين.
قم بتوفير قيم معلمات مشغل HTTP Webhook التي تريد استخدامها لمكالمات الاشتراك وإلغاء الاشتراك.
الخاصية المطلوب الوصف الاشتراك - الأسلوب نعم الأسلوب الذي يجب استخدامه عند الاشتراك في نقطة النهاية الهدف الاشتراك - URI نعم عنوان URL المراد استخدامه للاشتراك في نقطة النهاية الهدف الاشتراك - النص الأساسي لا أي نص رسالة لتضمينه في طلب الاشتراك. يتضمن هذا المثال عنوان URL لرد الاتصال الذي يعرف المشترك بشكل فريد، وهو تطبيق المنطق الخاص بك، باستخدام @listCallbackUrl()التعبير لاسترداد عنوان URL الخاص برد الاتصال لتطبيق المنطق الخاص بك.إلغاء الاشتراك - الأسلوب لا الأسلوب الذي يجب استخدامه عند إلغاء الاشتراك من نقطة النهاية الهدف إلغاء الاشتراك - URI لا عنوان URL المراد استخدامه لإلغاء الاشتراك من نقطة النهاية الهدف إلغاء الاشتراك - النص الأساسي لا نص رسالة اختياري لتضمينه في طلب إلغاء الاشتراك
ملاحظة: لا تدعم هذه الخاصية استخدام الدالةlistCallbackUrl(). ومع ذلك، يتضمن المشغل العناوين ويرسلها تلقائيا، وx-ms-workflow-operation-name،x-ms-client-tracking-idوالتي يمكن للخدمة الهدف استخدامها لتعريف المشترك بشكل فريد.إشعار
بالنسبة لخصائص إلغاء الاشتراك - الأسلوب وإلغاء الاشتراك - URI، أضفها إلى الإجراء الخاص بك عن طريق فتح قائمة المعلمات المتقدمة.
على سبيل المثال، يتضمن المشغل التالي الأساليب وعناوين URL وهيئات الرسائل لاستخدامها عند تنفيذ عمليات الاشتراك وإلغاء الاشتراك.
إذا كنت بحاجة إلى استخدام المصادقة، يمكنك إضافة خصائص الاشتراك - المصادقة وإلغاء الاشتراك - المصادقة . لمزيد من المعلومات حول أنواع المصادقة المتوفرة ل HTTP Webhook، راجع إضافة مصادقة إلى المكالمات الصادرة.
تابع إنشاء سير العمل الخاص بك باستخدام الإجراءات التي يتم تشغيلها عند تشغيل المشغل.
عند الانتهاء، احفظ سير العمل الخاص بك. في شريط أدوات المصمم، حدد "Save".
يؤدي حفظ سير العمل إلى استدعاء نقطة نهاية الاشتراك على الخدمة الهدف وتسجيل عنوان URL لرد الاتصال. ثم ينتظر سير العمل الخاص بك حتى ترسل HTTP POST الخدمة الهدف طلبا إلى عنوان URL لرد الاتصال. عند حدوث هذا الحدث، يتم تشغيل المشغل ويمرر أي بيانات في الطلب إلى سير العمل. إذا اكتملت هذه العملية بنجاح، يتم إلغاء اشتراك المشغل من نقطة النهاية، ويستمر سير العمل إلى الإجراء التالي.
إضافة إجراء HTTP Webhook
يستدعي هذا الإجراء المضمن نقطة نهاية الاشتراك على الخدمة الهدف ويسجل عنوان URL لرد الاتصال مع الخدمة الهدف. ثم يتوقف سير العمل مؤقتا وينتظر حتى ترسل HTTP POST الخدمة الهدف طلبا إلى عنوان URL لرد الاتصال. عند حدوث هذا الحدث، يمرر الإجراء أي بيانات في الطلب إلى سير العمل. إذا اكتملت العملية بنجاح، يتم إلغاء الاشتراك في الإجراء من نقطة النهاية، ويستمر سير العمل إلى الإجراء التالي.
يستخدم هذا المثال مشغل HTTP Webhook كخطوة أولى.
في مدخل Microsoft Azure، افتح تطبيق المنطق القياسي وسير العمل في المصمم.
اتبع هذه الخطوات العامة لإضافة الإجراء المسمى HTTP Webhook إلى سير العمل الخاص بك.
يعيد هذا المثال تسمية الإجراء إلى إجراء HTTP Webhook بحيث يكون للخطوة اسم وصفي أكثر.
قم بتوفير قيم معلمات إجراء HTTP Webhook، والتي تشبه معلمات مشغل HTTP Webhook، التي تريد استخدامها لمكالمات الاشتراك وإلغاء الاشتراك.
الخاصية المطلوب الوصف الاشتراك - الأسلوب نعم الأسلوب الذي يجب استخدامه عند الاشتراك في نقطة النهاية الهدف الاشتراك - URI نعم عنوان URL المراد استخدامه للاشتراك في نقطة النهاية الهدف الاشتراك - النص الأساسي لا أي نص رسالة لتضمينه في طلب الاشتراك. يتضمن هذا المثال عنوان URL لرد الاتصال الذي يعرف المشترك بشكل فريد، وهو تطبيق المنطق الخاص بك، باستخدام @listCallbackUrl()التعبير لاسترداد عنوان URL الخاص برد الاتصال لتطبيق المنطق الخاص بك.إلغاء الاشتراك - الأسلوب لا الأسلوب الذي يجب استخدامه عند إلغاء الاشتراك من نقطة النهاية الهدف إلغاء الاشتراك - URI لا عنوان URL المراد استخدامه لإلغاء الاشتراك من نقطة النهاية الهدف إلغاء الاشتراك - النص الأساسي لا نص رسالة اختياري لتضمينه في طلب إلغاء الاشتراك
ملاحظة: لا تدعم هذه الخاصية استخدام الدالةlistCallbackUrl(). ومع ذلك، يتضمن الإجراء العناوين ويرسلها تلقائيا، وx-ms-workflow-operation-name،x-ms-client-tracking-idوالتي يمكن للخدمة الهدف استخدامها لتعريف المشترك بشكل فريد.إشعار
بالنسبة لخصائص إلغاء الاشتراك - الأسلوب وإلغاء الاشتراك - URI، أضفها إلى الإجراء الخاص بك عن طريق فتح قائمة المعلمات المتقدمة.
على سبيل المثال، يتضمن الإجراء التالي الطرق وعناوين URL وهيئات الرسائل لاستخدامها عند تنفيذ عمليات الاشتراك وإلغاء الاشتراك.
لإضافة خصائص إجراء أخرى، افتح قائمة المعلمات المتقدمة.
على سبيل المثال، إذا كنت بحاجة إلى استخدام المصادقة، يمكنك إضافة خصائص الاشتراك - المصادقة وإلغاء الاشتراك - المصادقة . لمزيد من المعلومات حول أنواع المصادقة المتوفرة ل HTTP Webhook، راجع إضافة مصادقة إلى المكالمات الصادرة.
عند الانتهاء، احفظ سير العمل الخاص بك. في شريط أدوات المصمم، حدد "Save".
عند تشغيل هذا الإجراء، يستدعي سير العمل نقطة نهاية الاشتراك على الخدمة الهدف ويسجل عنوان URL لرد الاتصال. ثم يتوقف سير العمل مؤقتا وينتظر حتى ترسل HTTP POST الخدمة الهدف طلبا إلى عنوان URL لرد الاتصال. عند حدوث هذا الحدث، يمرر الإجراء أي بيانات في الطلب إلى سير العمل. إذا اكتملت العملية بنجاح، يتم إلغاء الاشتراك في الإجراء من نقطة النهاية، ويستمر سير العمل إلى الإجراء التالي.
مخرجات المشغلات والإجراءات
فيما يلي مزيد من المعلومات حول المخرجات من مشغل أو إجراء HTTP Webhook، الذي يقوم بإرجاع هذه المعلومات:
| اسم الخاصية | كتابة | الوصف |
|---|---|---|
| رؤوس | كائن | الرؤوس من الطلب |
| النص الأساسي | كائن | الكائن الذي يحتوي على محتوى النص الأساسي من الطلب |
| تعليمة برمجية الحالة | العدد الصحيح | رمز الحالة من الطلب |
| كود الحالة | الوصف |
|---|---|
| 200 | موافق |
| 202 | مقبولة |
| 400 | طلب غير صالح |
| 401 | غير مصرح به |
| 403 | محظور |
| 404 | غير موجود |
| 500 | خطأ خادم داخلي. حدث خطأ غير معروف. |