الموصلات المُضمّنة في Azure Logic Apps
توفر الموصلات المضمنة طرقاً للتحكم في جدول سير العمل وبنيته، أو تشغيل تعليماتك البرمجية، أو إدارة البيانات ومعالجتها، وإكمال المهام الأخرى في سير العمل. تختلف عن الموصلات المدارة، لا ترتبط بعض الموصلات المضمنة بخدمة أو نظام أو بروتوكول معين. على سبيل المثال، يمكنك بدء تشغيل أي سير عمل تقريبًا على جدول باستخدام مشغل التكرار. أو يمكنك جعل سير العمل ينتظر حتى يتم استدعاؤه باستخدام مشغل الطلب. تعمل كل الموصلات المضمنة في الأصل في وقت تشغيل Azure Logic Apps. لا تتطلب بعضها إنشاء اتصال قبل استخدامها.
بالنسبة لعدد أقل من الخدمات والأنظمة والبروتوكولات، توفر Azure Logic Apps إصدارا مضمنا إلى جانب الإصدار المدار. يختلف عدد ونطاق الموصلات المضمنة استنادا إلى ما إذا كنت تقوم بإنشاء سير عمل تطبيق منطق الاستهلاك الذي يتم تشغيله في تطبيقات Azure Logic Apps متعددة المستأجرين أو سير عمل تطبيق المنطق القياسي الذي يتم تشغيله في Azure Logic Apps أحادي المستأجر. في معظم الحالات، يوفر الإصدار المُضمّن أداء وإمكانات وتسعيراً أفضل وما إلى ذلك. في بعض الحالات، تتوفر بعض الموصلات المضمنة فقط في نوع سير عمل تطبيق منطقي واحد وليس الآخر.
على سبيل المثال، يمكن لسير العمل القياسي استخدام كل من الموصلات المدارة والموصلات المضمنة ل Azure Blob Storage وAzure Cosmos DB وAzure Event Hubs ناقل خدمة Azure وFTP وIBM DB2 وIBM MQ وSFTP وSQL Server. لا يحتوي سير عمل Consumption على الإصدارات المضمنة. يمكن أن يستخدم سير عمل الاستهلاك موصلات مضمنة لإدارة واجهة برمجة تطبيقات Azure وخدمات تطبيقات Azure، بينما لا يحتوي سير العمل القياسي على هذه الموصلات المضمنة.
أيضا، في مهام سير العمل القياسية، تعرف بعض الموصلات المضمنة ذات سمات معينة بشكل غير رسمي باسم موفري الخدمة. تدعم بعض الموصلات المُضمّنة طريقة واحدة فقط لمصادقة الاتصال بالخدمة الأساسية. يمكن أن توفر الموصلات المضمنة الأخرى خيارا، مثل استخدام سلسلة الاتصال أو معرف Microsoft Entra أو هوية مدارة. تعمل جميع الموصلات المضمنة في نفس عملية وقت تشغيل Azure Logic Apps. لمزيد من المعلومات، راجع بيئة خدمة المستأجر الفردي مقابل بيئة خدمة متعددة المستأجرين والتكامل (ISE).
توفر هذه المقالة نظرة عامة حول الموصلات المضمنة في مهام سير عمل الاستهلاك مقابل مهام سير العمل القياسية.
موصلات مضمنة في الاستهلاك مقابل قياسي
يسرد الجدول التالي المعارض الحالية والموسعة للموصلات المضمنة المتوفرة لسير العمل Consumption مقابل Standard. بالنسبة إلى مهام سير العمل القياسية، تحدد العلامة النجمية (*) الموصلات المضمنة استنادا إلى نموذج موفر الخدمة، والذي يتم وصفه بمزيد من التفصيل لاحقا.
| الاستهلاك | قياسي |
|---|---|
| إدارة Azure API Azure App Services Azure Functions Azure Logic Apps الدفعه التحكم عمليات البيانات وقت التاريخ ملف مسطح HTTP التعليمات البرمجية المضمنة حساب التكامل السائل طلب جدولة المتغيرات XML |
AS2 (v2) Azure الذكاء الاصطناعي Search* Azure Automation* Azure Blob Storage* Azure Cosmos DB* Azure Event Grid Publisher* مراكز أحداث Azure* Azure File Storage* Azure Functions Azure Key Vault* Azure OpenAI* تخزين قائمة انتظار Azure* ناقل خدمة Azure* Azure Table Storage* عمليات الدفعة التحكم عمليات مخطط البيانات عمليات البيانات وقت التاريخ Edifact نظام الملفات* ملف مسطح Ftp* HTTP IBM 3270* IBM CICS* IBM DB2* ملف مضيف IBM* IBM IMS* IBM MQ* التعليمات البرمجية المضمنة حساب التكامل جدبك* العمليات السائلة طلب RosettaNet ساب* جدولة سفتب* Smtp* SQL Server* سويفت المتغيرات عمليات سير العمل X12 عمليات XML |
الموصلات المضمنة المُستندة إلى موفر الخدمة
في مهام سير العمل القياسية، يعرف الموصل المضمن الذي يحتوي على السمات التالية بشكل غير رسمي باسم موفر الخدمة:
يستند إلى نموذج قابلية توسعة Azure Functions.
يوفر الوصول من سير عمل قياسي إلى خدمة، مثل Azure Blob Storage، ناقل خدمة Azure، ومراكز أحداث Azure، وSFTP، وSQL Server.
تدعم بعض الموصلات المُضمّنة طريقة واحدة فقط لمصادقة الاتصال بالخدمة الأساسية. يمكن أن توفر الموصلات المضمنة الأخرى خيارا، مثل استخدام سلسلة الاتصال أو معرف Microsoft Entra أو هوية مدارة.
يعمل في نفس العملية مثل وقت تشغيل Azure Logic Apps المُعاد تصميمه.
تتوفر الموصلات المضمنة المستندة إلى موفر الخدمة إلى جانب إصدارات الموصل المدارة.
في المقابل، يحتوي الموصل المضمن الذي ليس موفر خدمة على السمات التالية:
لا يستند إلى نموذج قابلية توسعة Azure Functions.
يتم تنفيذه مباشرة كوظيفة ضمن وقت تشغيل Azure Logic Apps، مثل عمليات Schedule، وHTTP، وRequest، وXML.
موصلات مضمنة مخصصة
بالنسبة إلى مهام سير العمل القياسية، يمكنك إنشاء موصل مضمن بنفس نموذج قابلية توسعة الموصل المضمن الذي تستخدمه الموصلات المضمنة المستندة إلى موفر الخدمة، مثل Azure Blob Storage وAzure Event Hubs ناقل خدمة Azure وSQL Server والمزيد. يعتمد تنفيذ الواجهة هذا على نموذج قابلية توسعة Azure Functions ويوفر لك القدرة على إنشاء موصلات مضمنة مخصصة يمكن لأي شخص استخدامها في مهام سير العمل القياسية.
بالنسبة إلى مهام سير عمل الاستهلاك، لا يمكنك إنشاء الموصلات المضمنة الخاصة بك، ولكن يمكنك إنشاء الموصلات المدارة الخاصة بك.
لمعرفة مزيد من المعلومات، راجع الوثائق التالية:
موصلات مضمنة عامة
يمكنك استخدام الموصلات المضمنة التالية لتنفيذ المهام العامة، على سبيل المثال:
تشغيل مهام سير العمل باستخدام جداول مخصصة ومتقدمة. لمزيد من المعلومات حول الجدولة ، راجع سلوك التكرار للموصلات في Azure Logic Apps.
تنظيم بنية سير العمل والتحكم فيها، على سبيل المثال، باستخدام الحلقات والشروط.
العمل مع المتغيرات والتواريخ وعمليات البيانات وتحويلات المحتوى وعمليات الدفعات.
التواصل مع نقاط النهاية الأخرى باستخدام مشغلات وإجراءات HTTP.
تلقي الطلبات والاستجابة لها.
استدعاء الوظائف الخاصة بك (Azure Functions) أو مهام سير عمل Azure Logic Apps الأخرى التي يمكن أن تتلقى الطلبات، وما إلى ذلك.
الجدول
التكرار: تشغيل سير عمل استنادا إلى التكرار المحدد.
نافذة منزلقة
(سير عمل الاستهلاك فقط):
تشغيل سير عمل يحتاج إلى معالجة البيانات في مجموعات مستمرة.
التأخير: إيقاف سير العمل مؤقتا للمدة المحددة.
تأخير حتى: إيقاف سير العمل مؤقتا حتى التاريخ والوقت المحددين.
HTTP
استدعاء نقطة نهاية HTTP أو HTTPS باستخدام مشغل HTTP أو الإجراء.
يمكنك أيضًا استخدام مشغلات وإجراءات HTTP المضمنة الأخرى هذه:
Request
عند تلقي طلب HTTP: انتظر طلبا من سير عمل أو تطبيق أو خدمة أخرى. يجعل هذا المشغل سير العمل قابلًا للاستدعاء دون الحاجة إلى التحقق أو الاستقصاء حسب جدول زمني.
الاستجابة: الاستجابة لطلب تم تلقيه بواسطة مشغل عند تلقي طلب HTTP في نفس سير العمل.
الدفعه
الرسائل الدفعية: تشغيل سير عمل يعالج الرسائل على دفعات.
إرسال رسائل إلى دفعة: استدعاء سير عمل موجود يبدأ حاليا بمشغل رسائل Batch.
نظام الملفات
(سير العمل القياسي فقط)
الاتصال إلى نظام ملفات على جهاز الشبكة لإنشاء الملفات وإدارتها.
Ftp
(سير العمل القياسي فقط)
الاتصال إلى خادم FTP أو FTPS في شبكة Azure الظاهرية بحيث يمكنك العمل مع ملفاتك ومجلداتك.
SFTP
(سير العمل القياسي فقط)
الاتصال إلى خادم SFTP في شبكة Azure الظاهرية بحيث يمكنك العمل مع ملفاتك ومجلداتك.
Smtp
(سير العمل القياسي فقط)
الاتصال إلى خادم SMTP بحيث يمكنك إرسال بريد إلكتروني.
موصلات مضمنة لخدمات وأنظمة محددة
يمكنك استخدام الموصلات المضمنة التالية للوصول إلى خدمات وأنظمة معينة. في مهام سير العمل القياسية، تعرف بعض هذه الموصلات المضمنة أيضا بشكل غير رسمي بموفري الخدمات، والتي يمكن أن تختلف عن نظيرات الموصل المدارة الخاصة بهم في بعض الطرق.
Azure الذكاء الاصطناعي Search
(سير العمل القياسي فقط)
الاتصال إلى الذكاء الاصطناعي Search بحيث يمكنك إجراء عمليات فهرسة المستندات والبحث فيها في سير العمل.
إدارة واجهة برمجة تطبيقات Azure
(سير عمل الاستهلاك فقط)
استدعاء المشغلات والإجراءات الخاصة بك في واجهات برمجة التطبيقات التي تقوم بتعريفها وإدارتها ونشرها باستخدام إدارة واجهة برمجة تطبيقات Azure.
ملاحظة: غير مدعوم عند استخدام طبقة الاستهلاك لإدارة واجهة برمجة التطبيقات.
Azure App Services
(سير عمل الاستهلاك فقط)
استدعاء التطبيقات التي تقوم بإنشائها واستضافتها على Azure App Service، على سبيل المثال، تطبيقات واجهة برمجة التطبيقات وتطبيقات الويب.
عند تضمين Swagger، تظهر المشغلات والإجراءات المحددة بواسطة هذه التطبيقات مثل أي مشغلات وإجراءات أخرى من الدرجة الأولى في Azure Logic Apps.
Azure Automation
(سير العمل القياسي فقط)
الاتصال إلى حسابات Azure Automation حتى تتمكن من إنشاء مهام Azure Automation وإدارتها.
مخزن البيانات الثنائية كبيرة الحجم لـ Azure
(سير العمل القياسي فقط)
الاتصال إلى حساب Azure Blob Storage الخاص بك بحيث يمكنك إنشاء محتوى blob وإدارته.
Azure Cosmos DB
(سير العمل القياسي فقط)
الاتصال إلى Azure Cosmos DB بحيث يمكنك الوصول إلى مستندات Azure Cosmos DB وإدارتها.
ناشر شبكة أحداث Azure
(سير العمل القياسي فقط)
الاتصال إلى Azure Event Grid للبرمجة المستندة إلى الحدث باستخدام دلالات pub-sub.
مراكز أحداث Azure
(سير العمل القياسي فقط)
استهلاك ونشر الأحداث من خلال Event Hub. على سبيل المثال، احصل على الإخراج من سير العمل الخاص بك باستخدام مراكز الأحداث، ثم أرسل هذا الإخراج إلى موفر تحليلات في الوقت الفعلي.
Azure File Storage
(سير العمل القياسي فقط)
الاتصال إلى حساب Azure Storage بحيث يمكنك إنشاء الملفات وتحديثها وإدارتها.
دالات Azure
اتصل بالوظائف المستضافة في Azure لتشغيل قصاصات التعليمات البرمجية الخاصة بك (C# أو Node.js) داخل سير العمل الخاص بك.
Azure Key Vault
(سير العمل القياسي فقط)
الاتصال إلى Azure Key Vault لتخزين الأسرار والوصول إليها وإدارتها.
Azure Logic Apps
(سير عمل الاستهلاك)
-أو-
عمليات سير العمل
(سير عمل قياسي)
استدعاء مهام سير العمل الأخرى التي تبدأ بمشغل الطلب المسمى عند تلقي طلب HTTP.
Azure OpenAI
(سير العمل القياسي فقط)
الاتصال إلى Azure OpenAI لتنفيذ عمليات على نماذج اللغات الكبيرة.
ناقل خدمة Azure
(سير العمل القياسي فقط)
إدارة الرسائل غير المتزامنة وقوائم الانتظار والجلسات والموضوعات واشتراكات الموضوع.
مساحة تخزين Azure Table
(سير العمل القياسي فقط)
الاتصال إلى حساب Azure Storage بحيث يمكنك إنشاء الجداول وتحديثها والاستعلام عنها وإدارتها.
تخزين قائمة انتظار Azure
(سير العمل القياسي فقط)
الاتصال إلى حساب Azure Storage بحيث يمكنك إنشاء قوائم الانتظار وتحديثها وإدارتها.
IBM 3270
(سير العمل القياسي فقط)
اتصل بتطبيقات 3270 المستندة إلى الشاشة على أجهزة IBM الرئيسية من سير العمل الخاص بك.
IBM CICS
(سير العمل القياسي فقط)
اتصل ببرامج CICS على أجهزة IBM الرئيسية من سير العمل الخاص بك.
IBM DB2
(سير العمل القياسي فقط)
الاتصال إلى IBM DB2 في السحابة أو في الموقع. قم بتحديث صف والحصول على جدول والمزيد.
ملف مضيف IBM
(سير العمل القياسي فقط)
الاتصال إلى IBM Host File وإنشاء المحتويات أو تحليلها.
IBM IMS
(سير العمل القياسي فقط)
اتصل ببرامج IMS على أجهزة IBM الرئيسية من سير العمل الخاص بك.
IBM MQ
(سير العمل القياسي فقط)
الاتصال إلى IBM MQ محليًا أو في Azure لإرسال الرسائل وتلقيها.
جدبك
(سير العمل القياسي فقط)
الاتصال إلى قاعدة بيانات ارتباطية باستخدام برامج تشغيل JDBC.
ساب
(سير العمل القياسي فقط)
الاتصال إلى SAP حتى تتمكن من إرسال الرسائل أو تلقيها واستدعاء الإجراءات.
SQL Server
(سير العمل القياسي فقط)
الاتصال إلى SQL Server محليًا أو قاعدة بيانات Azure SQL في مجموعة النظراء بحيث يمكنك إدارة السجلات أو تشغيل الإجراءات المخزنة أو إجراء الاستعلامات.
تشغيل التعليمات البرمجية من مهام سير العمل
توفر Azure Logic Apps الإجراءات المضمنة التالية لتشغيل التعليمات البرمجية الخاصة بك في سير العمل الخاص بك:
دالات Azure
اتصل بالوظائف المستضافة في Azure لتشغيل قصاصات التعليمات البرمجية الخاصة بك (C# أو Node.js) داخل سير العمل الخاص بك.
التعليمات البرمجية المضمنة
إضافة أجزاء التعليمات البرمجية ل JavaScript المضمنة وتشغيلها من سير العمل الخاص بك.
عمليات الدالة المحلية
(سير العمل القياسي فقط)
إنشاء التعليمات البرمجية ل .NET Framework وتشغيلها من سير العمل الخاص بك.
التحكم في تدفق سير العمل
توفر Azure Logic Apps الإجراءات المضمنة التالية لهيكلة الإجراءات في سير العمل والتحكم فيها:
الشرط
تقييم الشرط وتشغيل إجراءات مختلفة بناءً على ما إذا كان الشرط صواباً أم خطأ.
لكل
نفذ نفس الإجراءات على كل عنصر في الصفيف.
النطاق
قم بتجميع الإجراءات في نطاقات والتي ستحصل على حالتها الخاصة بعد انتهاء تشغيل الإجراءات في النطاق.
Switch
قم بتجميع الإجراءات في حالات، والتي سيتم تعيين قيم فريدة لها باستثناء الحالة الافتراضية. قم بتشغيل هذه الحالة فقط التي تطابق قيمتها المخصصة النتيجة من تعبير أو عنصر أو رمز مميز. في حالة عدم وجود تطابقات، قم بتشغيل الحالة الافتراضية.
انهاء
إيقاف سير عمل قيد التشغيل بشكل نشط.
حتي
كرر الإجراءات حتى تتحقق الحالة المحددة أو تتغير بعض الحالات.
إدارة البيانات أو معالجتها
يوفر Azure Logic Apps إجراءات مضمنة للعمل مع مخرجات البيانات وتنسيقاتها:
عمليات البيانات
تنفيذ العمليات باستخدام البيانات.
تكوين: إنشاء إخراج واحد من إدخالات متعددة بأنواع مختلفة.
إنشاء جدول CSV: إنشاء جدول قيم مفصولة بفواصل (CSV) من صفيف يحتوي على عناصر JSON.
إنشاء جدول HTML: إنشاء جدول HTML من صفيف يحتوي على عناصر JSON.
تصفية الصفيف: إنشاء صفيف من عناصر في صفيف آخر يتوافق مع المعايير.
الانضمام: إنشاء سلسلة من جميع العناصر في صفيف وفصل هذه العناصر باستخدام محدد المحدد.
تحليل JSON: إنشاء رموز مميزة سهلة الاستخدام من الخصائص وقيمها في محتوى JSON حتى تتمكن من استخدام هذه الخصائص في تدفق سير عملك.
التحديد: تكوين صفيف مع عناصر JSON عن طريق تحويل العناصر أو القيم في صفيف آخر وتعيين تلك العناصر إلى خصائص محددة.
التاريخ والوقت
إجراء العمليات باستخدام الطوابع الزمنية.
إضافة إلى الوقت: إضافة عدد الوحدات المحدد إلى طابع زمني.
تحويل المنطقة الزمنية: تحويل الطابع الزمني من المنطقة الزمنية المصدر إلى المنطقة الزمنية المستهدفة.
الوقت الحالي: إرجاع الطابع الزمني الحالي كسلسلة.
الحصول على الوقت المستقبلي: إرجاع الطابع الزمني الحالي بالإضافة إلى الوحدات الزمنية المحددة.
معرفة الوقت الماضي: إرجاع الطابع الزمني الحالي مطروحاً منه الوحدات الزمنية المحددة.
طرح من الوقت: طرح عدد من وحدات الوقت من الطابع الزمني.
متغيرات
تنفيذ العمليات باستخدام المتغيرات.
إلحاق بمتغير صفيف: إدخال قيمة على أنها العنصر الأخير في صفيف مخزن بواسطة متغير.
متغير الإلحاق بالسلسلة: إدخال قيمة على أنها الحرف الأخير في سلسلة مخزنة بواسطة متغير.
متغير الإنقاص: إنقاص متغير بقيمة ثابتة.
متغير الزيادة: زيادة متغير بقيمة ثابتة.
متغير التهيئة: إنشاء متغير وتحديد نوع بياناته وقيمته الأولية.
متغير التعيين: تعيين قيمة مختلفة لمتغير موجود.
العمليات المضمنة بين الشركات (B2B)
تدعم Azure Logic Apps سيناريوهات الاتصال بين الشركات (B2B) من خلال عمليات B2B المضمنة المختلفة. استنادا إلى ما إذا كان لديك سير عمل Consumption أو Standard وعمليات B2B التي تريد استخدامها، قد تضطر إلى إنشاء حساب تكامل وربطه بمورد تطبيق المنطق الخاص بك. ثم يمكنك استخدام حساب التكامل هذا لتحديد البيانات الاصطناعية B2B الخاصة بك، مثل الشركاء التجاريين والاتفاقيات والخرائط والمخططات والشهادات وما إلى ذلك.
مهام سير عمل الاستهلاك
قبل أن تتمكن من استخدام أي عمليات B2B في سير العمل، يجب إنشاء حساب تكامل وربطه بمورد تطبيق المنطق الخاص بك. بعد إنشاء حساب التكامل الخاص بك، يجب عليك بعد ذلك تحديد البيانات الاصطناعية B2B الخاصة بك، مثل الشركاء التجاريين والاتفاقيات والخرائط والمخططات والشهادات وما إلى ذلك. يمكنك بعد ذلك استخدام عمليات B2B لترميز الرسائل وفك ترميزها وتحويل المحتوى والمزيد.
مهام سير العمل القياسية
تتطلب بعض عمليات B2B إنشاء حساب تكامل وربطه بمورد تطبيق المنطق الخاص بك. يتيح لك الارتباط مشاركة البيانات الاصطناعية عبر مهام سير عمل قياسية متعددة ومهام سير العمل التابعة لها. استنادا إلى عملية B2B التي تريد استخدامها، أكمل إحدى الخطوات التالية قبل استخدام العملية:
بالنسبة للعمليات التي تتطلب خرائط أو مخططات، يمكنك إما:
قم بتحميل هذه البيانات الاصطناعية إلى مورد تطبيق المنطق الخاص بك باستخدام مدخل Microsoft Azure أو Visual Studio Code. يمكنك بعد ذلك استخدام هذه البيانات الاصطناعية عبر جميع مهام سير العمل التابعة في نفس مورد تطبيق المنطق. لمزيد من المعلومات، راجع إضافة مخططات لاستخدامها مع مهام سير العمل في Azure Logic Apps وإضافة مخططات لاستخدامها مع مهام سير العمل في Azure Logic Apps.
ربط مورد تطبيق المنطق بحساب التكامل الخاص بك.
بالنسبة للعمليات التي تتطلب اتصالا بحساب التكامل الخاص بك، قم بإنشاء الاتصال عند إضافة العملية إلى سير العمل الخاص بك.
لمعرفة مزيد من المعلومات، راجع الوثائق التالية:
AS2 (v2)
(سير العمل القياسي فقط)
ترميز الرسائل التي تستخدم بروتوكول AS2 وفك ترميزها.
Edifact
ترميز الرسائل التي تستخدم بروتوكول EDIFACT وفك ترميزها.
ملف ثابت
ترميز وفك تشفير رسائل XML بين الشركاء التجاريين.
البحث عن البيانات الاصطناعية لحساب التكامل
احصل على بيانات تعريف مخصصة للبيانات الاصطناعية، مثل الشركاء التجاريين والاتفاقيات والمخططات وما إلى ذلك، في حساب التكامل الخاص بك.
العمليات السائلة
تحويل التنسيقات التالية باستخدام قوالب Liquid:
- JSON إلى JSON
- JSON إلى TEXT
- XML إلى JSON
- XML إلى TEXT
RosettaNet
ترميز وفك تشفير الرسائل التي تستخدم بروتوكول RosettaNet.
سويفت
(سير العمل القياسي فقط)
ترميز وفك ترميز معاملات جمعية الاتصالات المالية بين البنوك العالمية (SIWFT) بتنسيق رسالة XML ذات الملف المسطح.
تحويل XML
تحويل تنسيق XML المصدر إلى تنسيق XML آخر.
X12
ترميز الرسائل التي تستخدم بروتوكول X12 وفك ترميزها.
التحقق من صحة XML
التحقق من صحة مستندات XML مقابل المخطط المحدد.