إنشاء مهام سير عمل تلقائية مستندة إلى الأحداث وتشغيلها باستخدام خطافات ويب HTTP في تطبيقات Azure Logic

هل هذه الصفحة مفيدة؟

هل لديك ملاحظات إضافية؟

سيتم إرسال الملاحظات إلى Microsoft: بالضغط على الزر «إرسال»، سيتم استخدام ملاحظاتك لتحسين منتجات Microsoft وخدماتها. نهج الخصوصية.

باستخدام Azure Logic Apps وموصل HTTP Webhook المضمن، يمكنك إنشاء مهام ومهام سير عمل تلقائية تشترك في نقطة نهاية خدمة، وتنتظر أحداثا محددة، وتعمل استنادا إلى تلك الأحداث، بدلا من التحقق من نقطة النهاية هذه أو استقصائها بانتظام.

فيما يلي بعض الأمثلة على مهام سير العمل المستندة إلى webhook:

• انتظر وصول عنصر من مركز أحداث Azure قبل تشغيل تطبيق منطقي.
• انتظر الموافقة قبل متابعة سير العمل.

توضح هذه المقالة كيفية استخدام مشغل Webhook وإجراء Webhook بحيث يمكن لتطبيقك المنطقي تلقي الأحداث والاستجابة لها في نقطة نهاية الخدمة.

كيف تعمل خطافات الويب؟

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

يستند إجراء webhook أيضا إلى الحدث ويشترك في نقطة نهاية الخدمة المحددة عن طريق تسجيل عنوان URL لمعاودة الاتصال مع نقطة النهاية هذه. يقوم إجراء webhook بإيقاف سير عمل تطبيق المنطق مؤقتا والانتظار حتى تستدعي نقطة نهاية الخدمة عنوان URL قبل استئناف تشغيل التطبيق المنطقي. يؤدي إجراء webhook إلى إلغاء الاشتراك من نقطة نهاية الخدمة في هذه الحالات:

• عند انتهاء إجراء webhook بنجاح
• إذا تم إلغاء تشغيل تطبيق المنطق أثناء انتظار الرد
• قبل انتهاء مهلة تطبيق المنطق

على سبيل المثال، يعد إجراء إرسال بريد إلكتروني للموافقة على موصل Office 365 Outlook مثالا على إجراء webhook الذي يتبع هذا النمط. يمكنك توسيع هذا النمط إلى أي خدمة باستخدام إجراء webhook.

لمزيد من المعلومات، راجع هذه الموضوعات:

• خطافات الويب والاشتراكات
• إنشاء واجهات برمجة تطبيقات مخصصة تدعم خطاف ويب

للحصول على معلومات حول التشفير والأمان والتخويل للمكالمات الواردة إلى تطبيقك المنطقي، مثل أمان طبقة النقل (TLS)، المعروف سابقا باسم طبقة مآخذ التوصيل الآمنة (SSL)، أو مصادقة Azure Active Directory المفتوحة (Azure AD OAuth)، راجع الوصول الآمن والبيانات - الوصول للمكالمات الواردة إلى المشغلات المستندة إلى الطلب.

المتطلبات الأساسية

• حساب Azure والاشتراك إذا لم يكن لديك اشتراك، فقم بالتسجيل للحصول على حساب Azure مجاني.

• عنوان URL لنقطة نهاية أو واجهة برمجة تطبيقات تم نشرها بالفعل تدعم نمط اشتراك webhook وإلغاء الاشتراك لمشغلات webhook في التطبيقات المنطقية أو إجراءات webhook في التطبيقات المنطقية حسب الاقتضاء

• المعرفة الأساسية حول كيفية إنشاء تطبيقات منطقية. إذا كنت جديدا على التطبيقات المنطقية، فراجع ما المقصود بتطبيقات Azure المنطقية؟

• تطبيق المنطق حيث تريد انتظار أحداث محددة في نقطة النهاية المستهدفة. للبدء باستخدام مشغل HTTP Webhook، قم بإنشاء تطبيق منطقي فارغ. لاستخدام إجراء HTTP Webhook، ابدأ تشغيل تطبيقك المنطقي باستخدام أي مشغل تريده. يستخدم هذا المثال مشغل HTTP كخطوة أولى.

إضافة مشغل HTTP Webhook

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

1. تسجيل الدخول إلى ⁧مدخل Microsoft Azure⁧. افتح تطبيق المنطق الفارغ في Logic App Designer.

2. في مربع بحث المصمم، أدخل http webhook كفلتر. من قائمة المشغلات ، حدد مشغل HTTP Webhook .

   

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

3. قم بتوفير قيم معلمات مشغل HTTP Webhook التي تريد استخدامها لمكالمات الاشتراك وإلغاء الاشتراك.

   في هذا المثال، يتضمن المشغل الأساليب وعناوين URI ونصوص الرسائل التي يجب استخدامها عند تنفيذ عمليات الاشتراك وإلغاء الاشتراك.

   

   الخاصية	مطلوب	الوصف
   الاشتراك - الطريقة	نعم	طريقة الاستخدام عند الاشتراك في نقطة النهاية المستهدفة
   الاشتراك - URI	نعم	عنوان URL المطلوب استخدامه للاشتراك في نقطة النهاية المستهدفة
   الاشتراك - الهيئة	لا	أي نص رسالة لتضمينه في طلب الاشتراك. يتضمن هذا المثال عنوان URL لمعاودة الاتصال الذي يحدد المشترك بشكل فريد، وهو تطبيقك المنطقي، باستخدام التعبير لاسترداد عنوان URL لرد الاتصال بتطبيقك المنطقي @listCallbackUrl() .
   إلغاء الاشتراك - الطريقة	لا	الطريقة التي يجب استخدامها عند إلغاء الاشتراك من نقطة النهاية المستهدفة
   إلغاء الاشتراك - URI	لا	عنوان URL المطلوب استخدامه لإلغاء الاشتراك من نقطة النهاية المستهدفة
   إلغاء الاشتراك - الجسم	لا	نص رسالة اختياري لتضمينه في طلب إلغاء الاشتراك ملاحظة: لا تدعم هذه الخاصية استخدام الوظيفة listCallbackUrl() . ومع ذلك ، يقوم المشغل تلقائيا بتضمين الرؤوس وإرسالها ، x-ms-client-tracking-id والتي x-ms-workflow-operation-nameيمكن للخدمة المستهدفة استخدامها لتحديد المشترك بشكل فريد.

4. لإضافة خصائص مشغل أخرى، افتح القائمة إضافة معلمات جديدة .

   

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

5. استمر في إنشاء سير عمل تطبيق المنطق باستخدام الإجراءات التي يتم تشغيلها عند تشغيل المشغل.

6. عند الانتهاء، انتهى، تذكر حفظ تطبيق المنطق الخاص بك. في شريط أدوات المصمم، حدد "Save" .

   يؤدي حفظ تطبيقك المنطقي إلى استدعاء نقطة نهاية الاشتراك في الخدمة المستهدفة وتسجيل عنوان URL لمعاودة الاتصال. ثم ينتظر تطبيقك المنطقي الخدمة المستهدفة لإرسال طلب HTTP POST إلى عنوان URL لمعاودة الاتصال. عند حدوث هذا الحدث، يتم تشغيل المشغل وتمرير أي بيانات في الطلب إلى سير العمل. إذا اكتملت هذه العملية بنجاح، إلغاء اشتراك المشغل من نقطة النهاية، ويستمر تطبيق المنطق في سير العمل المتبقي.

إضافة إجراء HTTP Webhook

يستدعي هذا الإجراء المضمن نقطة نهاية الاشتراك في الخدمة المستهدفة ويسجل عنوان URL لمعاودة الاتصال مع الخدمة المستهدفة. ثم يتوقف تطبيقك المنطقي مؤقتا وينتظر الخدمة المستهدفة لإرسال طلب HTTP POST إلى عنوان URL لمعاودة الاتصال. عند حدوث هذا الحدث، يقوم الإجراء بتمرير أي بيانات في الطلب إلى سير العمل. إذا اكتملت العملية بنجاح، إلغاء الاشتراك في الإجراء من نقطة النهاية، ويستمر تطبيقك المنطقي في تشغيل سير العمل المتبقي.

1. تسجيل الدخول إلى ⁧مدخل Microsoft Azure⁧. افتح تطبيقك المنطقي في Logic App Designer.

   يستخدم هذا المثال مشغل HTTP Webhook كخطوة أولى.

2. ضمن الخطوة التي تريد إضافة إجراء HTTP Webhook إليها، حدد خطوة جديدة.

   لإضافة إجراء بين الخطوات، حرك المؤشر فوق السهم بين الخطوات. حدد علامة الجمع (+) التي تظهر، ثم حدد إضافة إجراء.

3. في مربع بحث المصمم، أدخل http webhook كفلتر. من قائمة الإجراءات ، حدد إجراء HTTP Webhook .

   

   يعيد هذا المثال تسمية الإجراء إلى "إجراء HTTP Webhook" بحيث يكون للخطوة اسم أكثر وصفا.

4. قم بتوفير قيم معلمات إجراء HTTP Webhook، والتي تشبه معلمات مشغل HTTP Webhook، التي تريد استخدامها لمكالمات الاشتراك وإلغاء الاشتراك.

   في هذا المثال، يتضمن الإجراء الأساليب وعناوين URI ونصوص الرسائل التي يجب استخدامها عند تنفيذ عمليتي الاشتراك وإلغاء الاشتراك.

   

   الخاصية	مطلوب	الوصف
   الاشتراك - الطريقة	نعم	طريقة الاستخدام عند الاشتراك في نقطة النهاية المستهدفة
   الاشتراك - URI	نعم	عنوان URL المطلوب استخدامه للاشتراك في نقطة النهاية المستهدفة
   الاشتراك - الهيئة	لا	أي نص رسالة لتضمينه في طلب الاشتراك. يتضمن هذا المثال عنوان URL لمعاودة الاتصال الذي يحدد المشترك بشكل فريد، وهو تطبيقك المنطقي، باستخدام التعبير لاسترداد عنوان URL لرد الاتصال بتطبيقك المنطقي @listCallbackUrl() .
   إلغاء الاشتراك - الطريقة	لا	الطريقة التي يجب استخدامها عند إلغاء الاشتراك من نقطة النهاية المستهدفة
   إلغاء الاشتراك - URI	لا	عنوان URL المطلوب استخدامه لإلغاء الاشتراك من نقطة النهاية المستهدفة
   إلغاء الاشتراك - الجسم	لا	نص رسالة اختياري لتضمينه في طلب إلغاء الاشتراك ملاحظة: لا تدعم هذه الخاصية استخدام الوظيفة listCallbackUrl() . ومع ذلك ، يتضمن الإجراء تلقائيا الرؤوس ويرسلها ، x-ms-client-tracking-id والتي x-ms-workflow-operation-nameيمكن للخدمة المستهدفة استخدامها لتحديد المشترك بشكل فريد.

5. لإضافة خصائص إجراء أخرى، افتح القائمة إضافة معلمات جديدة .

   

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

6. عند الانتهاء، تذكر حفظ تطبيق المنطق. في شريط أدوات المصمم، حدد "Save" .

   الآن ، عند تشغيل هذا الإجراء ، يستدعي تطبيقك المنطقي نقطة نهاية الاشتراك في الخدمة المستهدفة ويسجل عنوان URL لمعاودة الاتصال. ثم يقوم تطبيق المنطق بإيقاف سير العمل مؤقتا وينتظر الخدمة المستهدفة لإرسال طلب HTTP POST إلى عنوان URL لمعاودة الاتصال. عند حدوث هذا الحدث، يقوم الإجراء بتمرير أي بيانات في الطلب إلى سير العمل. إذا اكتملت العملية بنجاح، إلغاء الاشتراك في الإجراء من نقطة النهاية، ويستمر تطبيقك المنطقي في تشغيل سير العمل المتبقي.

مخرجات الزناد والإجراءات

فيما يلي مزيد من المعلومات حول المخرجات من مشغل أو إجراء HTTP Webhook ، والذي يعرض هذه المعلومات:

اسم الخاصية	النوع	الوصف
الرؤوس	كائن	الرؤوس من الطلب
هيئة	كائن	الكائن الذي يحتوي على محتوى النص الأساسي من الطلب
تعليمة برمجية الحالة	Int	رمز الحالة من الطلب

كود الحالة	الوصف
200	موافق
202	مقبول
400	طلب غير صالح
401	غير مصرح به
403	محظور
404	غير موجود
500	خطأ خادم داخلي. حدث خطأ غير معروف.

مرجع الموصل

لمزيد من المعلومات حول معلمات المشغل والإجراء، والتي تتشابه مع بعضها البعض، راجع معلمات HTTP Webhook.

الخطوات التالية

• الوصول الآمن والبيانات - الوصول للمكالمات الواردة إلى المشغلات المستندة إلى الطلب
• موصلات للتطبيقات المنطقية