ما هي الموصلات في Azure Logic Apps

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

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

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

تعمل هذه النظرة العامة على توفير مقدمة عالية المستوى للموصلات وكيفية عملها بشكل عام. لمزيد من معلومات الموصل، راجع الوثائق التالية:

• نظرة عامة على الاتصال ors لخدمات مثل Power Automate وPower Apps
• نظرة عامة على الموصلات المدمجة لتطبيقات Azure Logic
• نظرة عامة على الموصلات المدارة ل Azure Logic Apps
• مرجع الموصلات المدارة ل Azure Logic Apps

الموصلات المضمنة مقابل الموصلات المدارة

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

• تم تصميم الموصلات المضمنة للتشغيل مباشرة وبشكل أصلي داخل Azure Logic Apps.

• يتم نشر الموصلات المدارة واستضافتها وإدارتها في Azure بواسطة Microsoft. توفر الموصلات المدارة في الغالب وكيلا أو برنامج تضمين حول واجهة برمجة تطبيقات تستخدمها الخدمة أو النظام الأساسي للتواصل مع Azure Logic Apps.

  • في سير عمل Consumption، تظهر الموصلات المدارة في المصمم ضمن تسميات Standard أو Enterprise ، استنادا إلى مستوى التسعير الخاص بها.

  • في سير عمل قياسي، تظهر جميع الموصلات المدارة في المصمم ضمن تسمية Azure .

لمزيد من المعلومات، راجع الوثائق التالية:

• نماذج التسعير وإصدار الفواتير في Azure Logic Apps
• تفاصيل التسعير لـ Azure Logic Apps

المشغلات

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

• تتحقق مشغلات التحقق بانتظام من خدمة أو نظام معين استناداً إلى جدول زمني محدد للتحقق من وجود بيانات جديدة أو حدث معين. إذا كانت البيانات الجديدة متوفرة، أو حدث معين حدث بالفعل، فإن هذه المشغلات تنشئ مثيلا جديدا لسير العمل وتقوم بتشغيله. يمكن لهذا المثيل الجديد بعد ذلك استخدام البيانات التي تم تمريرها كإدخال.

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

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

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

الإجراءات

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

أذونات الاتصال

في سير عمل تطبيق Consumption logic، قبل أن تتمكن من إنشاء موارد التطبيق المنطقي ومهام سير العمل واتصالاتها أو إدارتها، تحتاج إلى أذونات محددة. لمزيد من المعلومات حول هذه الأذونات، راجع العمليات الآمنة - الوصول الآمن والبيانات في Azure Logic Apps.

إنشاء الاتصال وتكوينها ومصادقة

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

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

على الرغم من القيام بإنشاء اتصالات داخل سير عمل، فإن هذه الاتصالات هي في الواقع موارد Azure منفصلة مع تعريفات الموارد الخاصة بها. لمراجعة تعريفات موارد الاتصال هذه، اتبع هذه الخطوات استنادا إلى ما إذا كان لديك سير عمل Consumption أو Standard:

• الاستهلاك‬

  • لعرض هذه الاتصالات وإدارتها في مدخل Microsoft Azure، راجع عرض الاتصالات لسير عمل الاستهلاك في مدخل Microsoft Azure.

  • لعرض هذه الاتصالات وإدارتها في Visual Studio، راجع إدارة مهام سير عمل الاستهلاك باستخدام Visual Studio، وتنزيل مورد تطبيق المنطق من Azure إلى Visual Studio.

  لمزيد من المعلومات حول تعريفات موارد الاتصال لسير عمل الاستهلاك، راجع تعريفات موارد الاتصال.

• قياسي

  • لعرض هذه الاتصالات وإدارتها في مدخل Microsoft Azure، راجع عرض الاتصالات لسير العمل القياسي في مدخل Microsoft Azure.

  • لعرض هذه الاتصالات وإدارتها في Visual Studio Code، راجع عرض سير عمل تطبيق المنطق في Visual Studio Code. يحتوي ملف connections.json على التكوين المطلوب للاتصالات التي أُنشئت بواسطة الموصلات.

أمان الاتصال والتشفير.

يتم تشفير تفاصيل تكوين الاتصال، مثل عنوان الخادم واسم المستخدم ورمز الوصول ومعلومات تسجيل الدخول والأسرار وتخزينها في بيئة Azure الآمنة. يمكن استخدام هذه المعلومات فقط في موارد تطبيق المنطق والعملاء الذين لديهم أذونات لمورد الاتصال، والذي يتم فرضه باستخدام الإجراء المتعلق بعمليات فحص من الوصول المرتبطة. تتطلب الاتصال التي تستخدم Microsoft Entra ID Open Authentication (Microsoft Entra ID OAuth)، مثل Office 365 وSalesforce وGitHub تسجيل الدخول، ولكن Azure Logic Apps تخزن فقط الوصول وتحديث الرموز المميزة كأسرار، وليس بيانات اعتماد تسجيل الدخول.

يمكن للاتصالات المقررة الوصول إلى الخدمة أو النظام المستهدف طالما تسمح هذه الخدمة أو النظام بذلك. بالنسبة للخدمات التي تستخدم اتصالات Microsoft Entra ID OAuth، مثل Office 365 وDynamics، تقوم Azure Logic Apps بتحديث رموز الوصول المميزة إلى أجل غير مسمى. قد يكون للخدمات الأخرى حدود على المدة التي يمكن أن تستخدم فيها Logic Apps رمز مميز دون الحاجة إلى التحديث. تؤدي بعض الإجراءات، مثل تغيير رمز الوصول الخاص بك، إلى إبطال كافة الرموز المميزة للوصول.

إشعار

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

لمزيد من المعلومات حول تأمين سير عمل التطبيق المنطقي والاتصالات، راجع الوصول الآمن والبيانات في Azure Logic Apps.

الوصول إلى جدار الحماية الخاص بالاتصالات

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

إذا كانت مهام سير العمل تستخدم أيضا موصلات مدارة، مثل موصل Office 365 Outlook أو موصل SQL، أو تستخدم موصلات مخصصة، فسيحتاج جدار الحماية أيضا إلى السماح بالوصول إلى جميععناوين IP الصادرة للموصل المدار في منطقة Azure لمورد تطبيق المنطق. لمزيد من المعلومات، راجع تكوين جدار الحماية.

فيما يتعلق بالموصلات المخصصة وواجهات برمجة التطبيقات

في مهام سير عمل الاستهلاك لتطبيقات Azure Logic Apps متعددة المستأجرين، يمكنك استدعاء واجهات برمجة التطبيقات المستندة إلى Swagger أو SOAP غير المتوفرة كموصلات خارج الصندوق. يمكنك أيضا بدء تشغيل عملية التعليمات البرمجية المخصصة عن طريق إنشاء تطبيقات واجهة برمجة التطبيقات المخصصة. لمزيد من المعلومات، راجع الوثائق التالية:

• موصلات مخصصة تستند إلى Swagger أو SOAP لسير عمل الاستهلاك

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

  لجعل الموصل المخصص في الوضع العام لأي شخص لاستخدامه في Azure، يجب تقديم الموصل للحصول على شهادة Microsoft.

• قم بإنشاء تطبيقات واجهة برمجة تطبيقات مخصصة

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

• موصلات مخصصة مضمنة تستند إلى موفر الخدمة لسير العمل القياسي

• إنشاء موصلات مخصصة مضمنة تستند إلى موفر الخدمة لسير العمل القياسي

ISE والمُوصلَات

بالنسبة إلى مهام سير العمل التي تحتاج إلى وصول مباشر إلى الموارد في الشبكة الظاهرية لـ Azure، يمكنك إنشاء بيئة خدمة تكامل مخصصة (ISE) حيث يمكنك إنشاء ونشر وتشغيل مهام سير العمل على موارد مخصصة. لمزيد من المعلومات حول إنشاء ISEs، راجع الاتصال إلى شبكات Azure الظاهرية من Azure Logic Apps.

لا تعمل الموصلات المخصصة التي نشئت داخل ISE مع بوابة البيانات المحلية. ومع ذلك، يمكن لهذه الموصلات الوصول مباشرة إلى مصادر البيانات المحلية المتصلة بالشبكة الظاهرية لـ Azure التي تستضيف ISE. لذلك، لا تحتاج مهام سير عمل التطبيق المنطقي في ISE على الأرجح إلى بوابة البيانات عند الاتصال بهذه الموارد. إذا كان لديك موصلات مخصصة قمت بإنشائها خارج ISE تتطلب بوابة البيانات المحلية، يمكن أن تستخدم مهام سير العمل في ISE هذه الموصلات.

في مصمم سير العمل، عند استعراض الموصلات المضمنة أو الموصلات المدارة التي تريد استخدامها لسير العمل في ISE، تظهر تسمية CORE على الموصلات المضمنة، بينما تظهر تسمية ISE على الموصلات المدارة المصممة للعمل مع ISE.

الذاكرة الأساسية

تعمل الموصلات المضمنة مع هذه التسمية في نفس ISE مثل مهام سير العمل الخاصة بك.

ISE

تعمل الموصلات المدارة مع هذه التسمية في نفس ISE مثل مهام سير العمل الخاصة بك.

إذا كان لديك نظام محلي متصل بالشبكة الظاهرية لـ Azure فإن ISE يتيح لسير العمل الوصول مباشرة إلى هذا النظام دون استخدام بوابة البيانات المحلية. بدلا من ذلك، يمكنك إما استخدام موصل ISE لهذا النظام إذا كان متاح، أو إجراء HTTP، أو موصل مخصص.

بالنسبة للأنظمة المحلية التي لا تحتوي على موصلات ISE، قم باستخدام بوابة البيانات المحلية.. للعثور على موصلات ISE المتوفرة، قم بمراجعةموصلات ISE.

بلا تسمية

كافة الموصلات الأخرى بدون تسمية، والتي يمكنك الاستمرار في استخدامها، حيث تعمل في خدمة Logic Apps العمومية متعددة المستأجرين.

المشكلات المعروفة

يتضمن الجدول التالي المشكلات المعروفة للموصلات في Azure Logic Apps:

رسالة الخطأ	‏‏الوصف	الحل
Error: BadGateway. Client request id: '{GUID}'	ينتج هذا الخطأ عن تحديث العلامات على مورد تطبيق منطقي حيث لا يدعم اتصال واحد أو أكثر مصادقة Microsoft Entra ID OAuth، مثل SFTP ad SQL، وكسر هذه الاتصالات.	لمنع هذا السلوك، تجنب عملية تحديث هذه العلامات.

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

إنشاء سير عمل تطبيق منطق الاستهلاك - مدخل Microsoft Azure

إنشاء سير عمل تطبيق منطقي قياسي - مدخل Microsoft Azure