فيما يتعلق بالموصلات في Azure Logic Apps

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

تعمل هذه النظرة العامة على توفير مقدمة عالية المستوى للموصلات وكيفية عملها بشكل عام.

ما الموصلات؟

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

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

أزرار التشغيل

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

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

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

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

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

الإجراءات

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

الفئات الخاصة بالموصل

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

  • تعمل الموصلات المضمنة في الأصل في وقت تشغيل Azure Logic Apps.

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

    في تطبيق المنطق القياسي، يتم تنظيم كافة الموصلات المدارة كموصلات لـ Azure . ومع ذلك، في تطبيق منطق الاستهلاك، يتم تنظيم الموصلات المدارة على أنها قياسية أو مؤسسية، استنادا إلى مستوى التسعير.

لمزيد من المعلومات حول أنواع تطبيقات المنطق، قم بمراجعة أنواع الموارد واختلافات بيئة المضيف.

تكوين الاتصال

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

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

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

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

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

يمكن للاتصالات المقررة الوصول إلى الخدمة أو النظام المستهدف طالما تسمح هذه الخدمة أو النظام بذلك. وبالنسبة للخدمات التي تستخدم اتصالات Azure AD 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 والتي لا تتوفر كموصلات عالية الكفاءة والتجهيز. يمكنك أيضا بدء تشغيل عملية التعليمات البرمجية المخصصة عن طريق إنشاء تطبيقات واجهة برمجة التطبيقات المخصصة. لمعرفة مزيد من المعلومات، راجع الوثائق التالية:

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

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

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

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

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

مثال على موصل CORE

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

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

مثال على موصل ISE

ISE

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

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

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

مثال على موصل غير ISE

عدم وجود تسمية

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

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

يتضمن الجدول التالي المشكلات المعروفة للموصلات الخاصة بـ Logic Apps.

رسالة الخطأ الوصف الدقة
Error: BadGateway. Client request id: '{GUID}' ينتج هذا الخطأ عن تحديث العلامات الخاصة بـ Logic Apps حيث لا يدعم اتصال واحد أو أكثر مصادقة OAuth لـ Azure Active Directory (Azure AD)، مثل SQL الإعلان SFTP، مما يؤدي إلى قطع هذه الاتصالات. لمنع هذا السلوك، تجنب عملية تحديث هذه العلامات.

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