حول الموصلات في تطبيقات Azure Logic
عند إنشاء مهام سير عمل باستخدام Azure Logic Apps، يمكنك استخدام الموصلات لمساعدتك في الوصول بسرعة وسهولة إلى البيانات والأحداث والموارد في التطبيقات والخدمات والأنظمة والبروتوكولات والأنظمة الأساسية الأخرى - غالبا بدون كتابة أي تعليمات برمجية. يوفر الموصل عمليات مسبقة الإنشاء يمكنك استخدامها كخطوات في مهام سير العمل. توفر تطبيقات Azure Logic مئات الموصلات التي يمكنك استخدامها. إذا لم يتوفر موصل للمورد الذي تريد الوصول إليه، فيمكنك استخدام عملية HTTP العامة للاتصال بالخدمة، أو يمكنك إنشاء موصل مخصص.
تقدم هذه النظرة العامة مقدمة عن الموصلات وكيفية عملها بشكل عام والموصلات الأكثر شيوعا واستخداما في تطبيقات Azure Logic Apps. لمعرفة مزيد من المعلومات، راجع الوثائق التالية:
- نظرة عامة على الموصلات لتطبيقات Azure Logic وMicrosoft Power Automate وMicrosoft Power Apps
- مرجع الموصلات لتطبيقات Azure Logic
- نماذج التسعير والفوترة في تطبيقات Azure Logic
- تفاصيل تسعير تطبيقات Azure المنطقية
ما هي الموصلات؟
من الناحية الفنية، الموصل هو وكيل أو غلاف حول واجهة برمجة التطبيقات التي تستخدمها الخدمة الأساسية للتواصل مع تطبيقات Azure Logic Apps. يوفر هذا الموصل العمليات التي تستخدمها في مهام سير العمل لتنفيذ المهام. تتوفر عملية إما كمشغل أو إجراء مع الخصائص التي يمكنك تكوينها. تتطلب بعض المشغلات والإجراءات أيضا إنشاء اتصال بالخدمة أو النظام الأساسي وتكوينه أولا، على سبيل المثال، حتى تتمكن من مصادقة الوصول إلى حساب مستخدم.
أزرار التشغيل
يحدد المشغل الحدث الذي يبدأ سير العمل وهو دائما الخطوة الأولى في أي سير عمل. يتبع كل مشغل أيضا نمط إطلاق محدد يتحكم في كيفية مراقبة الزناد للأحداث واستجابتها لها. عادة ما يتبع المشغل نمط الاقتراع أو نمط الدفع ، ولكن في بعض الأحيان ، يتوفر مشغل في كلا الإصدارين.
- تقوم مشغلات الاقتراع بالتحقق بانتظام من خدمة أو نظام معين وفقا لجدول زمني محدد للتحقق من وجود بيانات جديدة أو حدث معين. في حالة توفر بيانات جديدة، أو حدوث حدث معين، تقوم هذه المشغلات بإنشاء مثيل جديد لسير العمل وتشغيله. يمكن لهذا المثيل الجديد بعد ذلك استخدام البيانات التي تم تمريرها كمدخلات.
- تستمع مشغلات الدفع إلى بيانات جديدة أو لحدث ما ، دون إجراء استطلاع. عند توفر بيانات جديدة، أو عند وقوع الحدث، تقوم هذه المشغلات بإنشاء مثيل جديد لسير العمل وتشغيله. يمكن لهذا المثيل الجديد بعد ذلك استخدام البيانات التي تم تمريرها كمدخلات.
على سبيل المثال، قد ترغب في إنشاء سير عمل يقوم بشيء ما عند تحميل ملف إلى خادم FTP. كخطوة أولى في سير العمل، يمكنك استخدام مشغل FTP المسمى عند إضافة ملف أو تعديله، والذي يتبع نمط الاستقصاء. يمكنك بعد ذلك تحديد جدول زمني للتحقق بانتظام من أحداث التحميل.
يقوم المشغل أيضا بتمرير أي مدخلات وبيانات أخرى مطلوبة إلى سير العمل الخاص بك حيث يمكن للإجراءات اللاحقة الرجوع إلى تلك البيانات واستخدامها طوال سير العمل. على سبيل المثال، افترض أنك تريد استخدام مشغل Office 365 Outlook باسم عند وصول بريد إلكتروني جديد لبدء سير عمل عندما تتلقى بريدا إلكترونيا جديدا. يمكنك تكوين هذا المشغل لتمرير المحتوى من كل بريد إلكتروني جديد، مثل المرسل وسطر الموضوع والنص الأساسي والمرفقات وما إلى ذلك. يمكن لسير العمل الخاص بك بعد ذلك معالجة هذه المعلومات باستخدام إجراءات أخرى.
الإجراءات
الإجراء هو عملية تتبع المشغل وتنفذ نوعا من المهام في سير عملك. يمكنك استخدام إجراءات متعددة في سير العمل. على سبيل المثال، يمكنك بدء سير العمل باستخدام مشغل SQL يكتشف بيانات عميل جديدة في قاعدة بيانات SQL. بعد المشغل، يمكن أن يكون لسير العمل إجراء SQL يحصل على بيانات العميل. بعد الإجراء SQL، يمكن أن يكون لسير العمل إجراء آخر، ليس بالضرورة SQL، يعالج البيانات.
فئات الموصل
في Azure Logic Apps، تتوفر معظم المشغلات والإجراءات إما في إصدار مضمن أو إصدار موصل مدار . تتوفر بعض المشغلات والإجراءات في كلا الإصدارين. تعتمد الإصدارات المتوفرة على ما إذا كنت تقوم بإنشاء تطبيق منطقي متعدد المستأجرين أو تطبيق منطق أحادي المستأجر، والذي يتوفر حاليا فقط في تطبيقات Azure Logic ذات المستأجر الواحد.
يتم تشغيل المشغلات والإجراءات المضمنة بشكل أصلي على وقت تشغيل Logic Apps، ولا تتطلب إنشاء اتصالات، وتنفيذ هذه الأنواع من المهام:
- قم بتشغيل التعليمات البرمجية في مهام سير العمل الخاصة بك.
- تنظيم بياناتك والتحكم فيها.
- إدارة البيانات أو معالجتها.
يتم نشر الموصلات المدارة واستضافتها وإدارتها بواسطة Microsoft. توفر هذه الموصلات مشغلات وإجراءات للخدمات السحابية أو الأنظمة المحلية أو كليهما. تتوفر الموصلات المدارة في هذه الفئات:
- الموصلات المحلية التي تساعدك على الوصول إلى البيانات والموارد في الأنظمة المحلية.
- موصلات المؤسسة التي توفر الوصول إلى أنظمة المؤسسة.
- موصلات حساب التكامل التي تدعم سيناريوهات الاتصال بين الشركات (B2B).
- موصلات بيئة خدمة التكامل (ISE) التي هي مجموعة صغيرة من الموصلات المدارة المتوفرة فقط ل ISEs.
تكوين الاتصال
لإنشاء موارد التطبيق المنطقي والاتصالات أو إدارتها، تحتاج إلى أذونات معينة، والتي يتم توفيرها من خلال الأدوار باستخدام التحكم في الوصول المستند إلى دور Azure (Azure RBAC). يمكنك تعيين أدوار مضمنة أو مخصصة للأعضاء الذين لديهم حق الوصول إلى اشتراك Azure الخاص بك. تحتوي Azure Logic Apps على هذه الأدوار المحددة:
Logic App Contributor: يتيح لك إدارة التطبيقات المنطقية، ولكن لا يمكنك تغيير الوصول إليها.
مشغل التطبيقات المنطقية: يتيح لك قراءة التطبيقات المنطقية وتمكينها وتعطيلها، ولكن لا يمكنك تحريرها أو تحديثها.
المساهم: يمنح حق الوصول الكامل لإدارة جميع الموارد، ولكنه لا يسمح لك بتعيين أدوار في Azure RBAC أو إدارة المهام في مخططات Azure أو مشاركة معارض الصور.
على سبيل المثال، افترض أنه يجب عليك العمل مع تطبيق منطقي لم تقم بإنشائه ومصادقة الاتصالات المستخدمة في سير عمل هذا التطبيق المنطقي. يتطلب اشتراكك في Azure أذونات المساهم لمجموعة الموارد التي تحتوي على مورد التطبيق المنطقي هذا. إذا قمت بإنشاء مورد تطبيق منطقي، فسيكون لديك حق الوصول إلى المساهم تلقائيا.
قبل أن تتمكن من استخدام مشغلات الموصل أو إجراءاته في سير العمل، تتطلب معظم الموصلات إنشاء اتصال بالخدمة أو النظام المستهدف أولا. لإنشاء اتصال من داخل سير عمل تطبيق منطقي، يجب عليك مصادقة هويتك باستخدام بيانات اعتماد الحساب وأحيانا معلومات الاتصال الأخرى. على سبيل المثال، قبل أن يتمكن سير العمل من الوصول إلى حساب البريد الإلكتروني Office 365 Outlook والعمل معه، يجب عليك تفويض اتصال بهذا الحساب. بالنسبة لعدد صغير من العمليات المضمنة والموصلات المدارة، يمكنك إعداد هوية مدارة واستخدامها للمصادقة، بدلا من توفير بيانات الاعتماد الخاصة بك.
أمان الاتصال والتشفير
يتم تشفير تفاصيل تكوين الاتصال، مثل عنوان الخادم واسم المستخدم وكلمة المرور وبيانات الاعتماد والأسرار وتخزينها في بيئة Azure الآمنة. لا يمكن استخدام هذه المعلومات إلا في موارد التطبيق المنطقي ومن قبل العملاء الذين لديهم أذونات لمورد الاتصال، والذي يتم فرضه باستخدام عمليات التحقق من الوصول المرتبط. تتطلب الاتصالات التي تستخدم مصادقة Azure Active Directory المفتوحة (Azure AD OAuth)، مثل Office 365 وSalesforce GitHub، تسجيل الدخول، ولكن Azure Logic Apps تخزن الرموز المميزة للوصول والتحديث فقط كأسرار، وليس بيانات اعتماد تسجيل الدخول.
يمكن للاتصالات المنشأة الوصول إلى الخدمة أو النظام المستهدف طالما سمحت هذه الخدمة أو النظام بذلك. بالنسبة للخدمات التي تستخدم اتصالات Azure AD OAuth، مثل Office 365 وDynamics، تقوم خدمة Logic Apps بتحديث رموز الوصول المميزة إلى أجل غير مسمى. قد يكون للخدمات الأخرى قيود على المدة التي يمكن أن تستخدم فيها Logic Apps رمزا مميزا دون تحديث. تؤدي بعض الإجراءات، مثل تغيير كلمة المرور، إلى إبطال جميع رموز الوصول.
على الرغم من أنك تقوم بإنشاء اتصالات من داخل سير عمل، إلا أن الاتصالات عبارة عن موارد Azure منفصلة مع تعريفات الموارد الخاصة بها. لمراجعة تعريفات موارد الاتصال هذه، قم بتنزيل تطبيقك المنطقي من Azure إلى Visual Studio. هذه الطريقة هي أسهل طريقة لإنشاء قالب تطبيق منطقي صالح ومعلمات يكون جاهزا في الغالب للنشر.
تلميح
إذا كانت مؤسستك لا تسمح لك بالوصول إلى موارد معينة من خلال موصلات التطبيقات المنطقية، فيمكنك حظر القدرة على إنشاء مثل هذه الاتصالات باستخدام نهج Azure.
لمزيد من المعلومات حول تأمين التطبيقات والاتصالات المنطقية، راجع الوصول الآمن والبيانات في Azure Logic Apps.
الوصول إلى جدار الحماية للاتصالات
إذا كنت تستخدم جدار حماية يحد من حركة المرور، وتحتاج مهام سير عمل التطبيق المنطقي إلى الاتصال من خلال جدار الحماية هذا، فيجب عليك إعداد جدار الحماية للسماح بالوصول إلى كل من عناوين IP الواردةوالصادرة التي تستخدمها خدمة Logic Apps أو وقت التشغيل في منطقة Azure حيث توجد مهام سير عمل التطبيق المنطقي. إذا كانت مهام سير العمل تستخدم أيضا موصلات مدارة، مثل موصل Office 365 Outlook أو موصل SQL، أو تستخدم موصلات مخصصة، فيجب أن يسمح جدار الحماية أيضا بالوصول إلى جميععناوين IP الصادرة للموصل المدار في منطقة Azure الخاصة بتطبيقك المنطقي. لمزيد من المعلومات، راجع تكوين جدار الحماية.
سلوك التكرار
يتم تشغيل المشغلات المضمنة المتكررة، مثل مشغل التكرار، بشكل أصلي على وقت تشغيل Logic Apps وتختلف عن المشغلات المتكررة المستندة إلى الاتصال، مثل مشغل موصل Office 365 Outlook حيث تحتاج إلى إنشاء اتصال أولا.
بالنسبة لكلا النوعين من المشغلات، إذا لم يحدد التكرار تاريخ ووقت بدء محددين، تشغيل التكرار الأول على الفور عند حفظ تطبيق المنطق أو نشره، على الرغم من إعداد تكرار المشغل. لتجنب هذا السلوك، قم بتوفير تاريخ البدء والوقت للوقت الذي تريد فيه تشغيل التكرار الأول.
تكرار المشغلات المضمنة
تتبع المشغلات المضمنة المتكررة الجدول الزمني الذي قمت بتعيينه، بما في ذلك أي منطقة زمنية محددة. ومع ذلك، إذا لم يحدد التكرار خيارات جدولة متقدمة أخرى، مثل أوقات محددة لتشغيل التكرارات المستقبلية، فإن هذه التكرارات تستند إلى تنفيذ المشغل الأخير. ونتيجة لذلك، قد تنجرف أوقات بدء هذه التكرارات بسبب عوامل مثل زمن الوصول أثناء مكالمات التخزين.
لمعرفة مزيد من المعلومات، راجع الوثائق التالية:
- جدولة المهام والعمليات ومهام سير العمل التلقائية المتكررة وتشغيلها باستخدام تطبيقات Azure Logic
- إنشاء المهام ومهام سير العمل المتكررة وجدولتها وتشغيلها باستخدام مشغل التكرار
- استكشاف مشكلات التكرار وإصلاحها
تكرار المشغلات المستندة إلى الاتصال
في المشغلات المتكررة المستندة إلى الاتصال، مثل Office 365 Outlook، لا يكون الجدول الزمني هو برنامج التشغيل الوحيد الذي يتحكم في التنفيذ. تحدد المنطقة الزمنية وقت البدء الأولي فقط. تعتمد عمليات التشغيل اللاحقة على جدول التكرار وتنفيذ المشغل الأخير والعوامل الأخرى التي قد تتسبب في انحراف أوقات التشغيل أو إنتاج سلوك غير متوقع، على سبيل المثال:
- ما إذا كان المشغل يصل إلى خادم يحتوي على المزيد من البيانات ، والتي يحاول المشغل جلبها على الفور.
- أي إخفاقات أو عمليات إعادة محاولة يتكبدها المشغل.
- زمن الوصول أثناء مكالمات التخزين.
- عدم الحفاظ على الجدول الزمني المحدد عند بدء تشغيل التوقيت الصيفي (DST) وانتهائه.
- العوامل الأخرى التي يمكن أن تؤثر عند حدوث وقت التشغيل التالي.
لمعرفة مزيد من المعلومات، راجع الوثائق التالية:
- جدولة المهام والعمليات ومهام سير العمل التلقائية المتكررة وتشغيلها باستخدام تطبيقات Azure Logic
- استكشاف مشكلات التكرار وإصلاحها
استكشاف مشكلات التكرار وإصلاحها
للتأكد من أن سير العمل يعمل في وقت البدء المحدد ولا يفوتك أي تكرار، خاصة عندما يكون التكرار في غضون أيام أو أكثر، جرب الحلول التالية:
عندما يصبح التوقيت الصيفي ساري المفعول، اضبط التكرار يدويا بحيث يستمر سير العمل في العمل في الوقت المتوقع. وإلا، يتحول وقت البدء ساعة واحدة إلى الأمام عند بدء تشغيل التوقيت الصيفي وساعة واحدة إلى الوراء عند انتهاء التوقيت الصيفي. لمزيد من المعلومات والأمثلة، راجع التكرار للتوقيت الصيفي والتوقيت القياسي.
إذا كنت تستخدم مشغل تكرار ، فحدد منطقة زمنية وتاريخ بدء ووقت بدء. بالإضافة إلى ذلك، قم بتكوين أوقات محددة لتشغيل التكرارات اللاحقة في الخصائص في هذه الساعات وفي هذه الدقائق، والتي تتوفر فقط لتردداتاليوم والأسبوع. ومع ذلك، قد لا تزال بعض النوافذ الزمنية تسبب مشاكل عند تحول الوقت.
فكر في استخدام مشغل النافذة المنزلقة بدلا من مشغل التكرار لتجنب التكرار الفائت.
واجهات برمجة التطبيقات والموصلات المخصصة
للاتصال بواجهات برمجة التطبيقات التي تقوم بتشغيل تعليمات برمجية مخصصة أو غير متوفرة كموصلات، يمكنك توسيع النظام الأساسي ل Logic Apps عن طريق إنشاء تطبيقات API مخصصة. يمكنك أيضا إنشاء موصلات مخصصة لأي واجهات برمجة تطبيقات تستند إلى REST أو SOAP، مما يجعل واجهات برمجة التطبيقات هذه متاحة لأي تطبيق منطقي في اشتراكك في Azure. لجعل تطبيقات واجهة برمجة التطبيقات المخصصة أو الموصلات عامة لأي شخص لاستخدامها في Azure، يمكنك إرسال الموصلات للحصول على شهادة Microsoft.
بورصة اسطنبول والموصلات
بالنسبة لمهام سير العمل التي تحتاج إلى وصول مباشر إلى الموارد في شبكة Azure الظاهرية، يمكنك إنشاء بيئة خدمة تكامل مخصصة (ISE) حيث يمكنك إنشاء مهام سير العمل ونشرها وتشغيلها على موارد مخصصة. لمزيد من المعلومات حول إنشاء ISEs، راجع الاتصال إلى شبكات Azure الظاهرية من Azure Logic Apps.
لا تعمل الموصلات المخصصة التي تم إنشاؤها داخل بورصة اسطنبول مع بوابة البيانات المحلية. ومع ذلك، يمكن لهذه الموصلات الوصول مباشرة إلى مصادر البيانات المحلية المتصلة بشبكة Azure الظاهرية التي تستضيف ISE. لذلك ، من المرجح ألا تحتاج التطبيقات المنطقية في بورصة اسطنبول إلى بوابة البيانات عند التواصل مع هذه الموارد. إذا كان لديك موصلات مخصصة قمت بإنشائها خارج بورصة اسطنبول تتطلب بوابة البيانات المحلية، فيمكن للتطبيقات المنطقية في بورصة اسطنبول استخدام هذه الموصلات.
في مصمم التطبيقات المنطقية، عند استعراض المشغلات والإجراءات المضمنة أو الموصلات المدارة التي تريد استخدامها للتطبيقات المنطقية في ISE، تظهر تسمية CORE على المشغلات والإجراءات المضمنة، بينما تظهر تسمية ISE على الموصلات المدارة المصممة للعمل مع ISE .
لب
يتم تشغيل المشغلات والإجراءات المضمنة مع هذه التسمية في نفس بورصة اسطنبول مثل تطبيقاتك المنطقية.
بورصة اسطنبول
يتم تشغيل الموصلات المدارة التي تحمل هذه التسمية في نفس ISE مثل تطبيقاتك المنطقية.
إذا كان لديك نظام محلي متصل بشبكة Azure الظاهرية، فإن بورصة اسطنبول تتيح لمهام سير العمل الخاصة بك الوصول مباشرة إلى هذا النظام دون استخدام بوابة البيانات المحلية. بدلا من ذلك، يمكنك إما استخدام موصل ISE الخاص بهذا النظام إذا كان متوفرا، أو إجراء HTTP، أو موصل مخصص.
بالنسبة للأنظمة المحلية التي لا تحتوي على موصلات ISE ، استخدم بوابة البيانات المحلية. للعثور على موصلات ISE المتاحة، راجع موصلات ISE.
بدون تسمية
يتم تشغيل جميع الموصلات الأخرى بدون تسمية، والتي يمكنك الاستمرار في استخدامها، في خدمة Logic Apps العالمية متعددة المستأجرين.
مشكلات معروفة
يتضمن الجدول التالي المشكلات المعروفة لموصلات التطبيقات المنطقية.
| رسالة الخطأ | الوصف | الدقة |
|---|---|---|
Error: BadGateway. Client request id: '{GUID}' |
ينتج هذا الخطأ عن تحديث العلامات على تطبيق منطقي حيث لا يدعم اتصال واحد أو أكثر مصادقة OAuth ل Azure Active Directory (Azure AD)، مثل SQL إعلانات SFTP، مما يؤدي إلى قطع هذه الاتصالات. | لمنع هذا السلوك، تجنب تحديث هذه العلامات. |