مشاركة عبر

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

When you build a workflow using Azure Logic Apps, you can use a connector to work with data, events, and resources in other apps, services, systems, and platforms - without writing code. يوفر الموصل عملية واحدة أو أكثر من العمليات التي تم إنشاؤها مسبقا، والتي تستخدمها كخطوات في سير العمل الخاص بك.

In a connector, each operation is either a trigger condition that starts a workflow or a subsequent action that performs a specific task, along with properties that you can configure. في حين أن العديد من الموصلات لها مشغلات وإجراءات على حد سواء، تقدم بعض الموصلات مشغلات فقط، بينما توفر الموصلات الأخرى إجراءات فقط.

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

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

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

In Azure Logic Apps, connectors are either built in or managed. تحتوي بعض الموصلات على كلا الإصدارين. The available versions depend on whether you create a Consumption logic app workflow that runs in multitenant Azure Logic Apps or a Standard logic app workflow that runs in single-tenant Azure Logic Apps. لمزيد من المعلومات حول أنواع موارد تطبيق المنطق، راجع أنواع الموارد واختلافات بيئة المضيف.

  • Built-in connectors are designed to run directly and natively inside Azure Logic Apps.

    In the designer, all built-in connectors appear in the connector gallery within the In app group.

  • Managed connectors are deployed, hosted, and managed in Azure by Microsoft. توفر الموصلات المدارة في الغالب وكيلا أو برنامج تضمين حول واجهة برمجة تطبيقات تستخدمها الخدمة أو النظام الأساسي للتواصل مع Azure Logic Apps.

    In the designer, all managed connectors appear in the connector gallery within the Shared group. They are billed at either the Standard or Enterprise level.

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

Triggers

يحدد المشغل الشرط الذي يجب تلبيته قبل بدء سير العمل وهو دائما الخطوة الأولى في أي سير عمل. يتبع كل مشغل أيضا نمط إطلاق محدد يتحكم في كيفية مراقبة الأنماط للأحداث والاستجابة لها. Usually, a trigger follows either a polling pattern or a push pattern. في بعض الأحيان، يتوفر كلا إصداري المشغل.

  • Polling triggers regularly check a specific service or system on a specified schedule to check for new data or a specific event. إذا كانت البيانات الجديدة متوفرة، أو حدث معين حدث بالفعل، فإن هذه المشغلات تنشئ مثيلا جديدا لسير العمل وتقوم بتشغيله. يمكن لهذا المثيل الجديد بعد ذلك استخدام البيانات التي تم تمريرها كإدخال.

    Note

    For connectors that are Microsoft-managed, hosted, and run in Azure, polling triggers use only the Interval and Frequency values to calculate the next recurrence. لا يستخدمون خيارات الجدولة المتقدمة، مثل في هذه الساعات وفي هذه الأيام. These options work only with built-in polling triggers that directly run with the Azure Logic Apps runtime, such as the Recurrence, Sliding Window, and HTTP triggers.

  • Push or webhook triggers listen for new data or for an event to happen, without polling. عند توفر بيانات جديدة، أو عند حدوث الحدث، تقوم هذه المشغلات بإنشاء وتشغيل مثيل جديد لسير العمل الخاص بك. يمكن لهذا المثيل الجديد بعد ذلك استخدام البيانات التي تم تمريرها كإدخال.

على سبيل المثال، افترض أنك تريد إنشاء سير عمل يتم تشغيله عند تحميل ملف إلى خادم FTP. As the first step in your workflow, you can add the FTP trigger named When a file is added or modified, which follows a polling pattern. ثم حدد الجدول الزمني للتحقق بانتظام من أحداث التحميل.

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

Actions

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

Connection permissions

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

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

Before you can use a connector's operations in your workflow, many connectors require that you first create a connection to the target service or system. لإنشاء اتصال من داخل مصمم سير العمل، يجب عليك مصادقة هويتك باستخدام بيانات اعتماد الحساب وأحيانا معلومات الاتصال الأخرى.

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

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

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

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

Note

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

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

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

If you use a firewall that limits traffic, and your logic app workflows need to communicate through that firewall, you have to set up your firewall to allow access for both the inbound and outbound IP addresses used by the Azure Logic Apps platform or runtime in the Azure region where your logic app workflows exist.

If your workflows also use managed connectors, such as the Office 365 Outlook connector or SQL connector, or use custom connectors, your firewall also needs to allow access for all the managed connector outbound IP addresses in your logic app resource's Azure region. For more information, see Firewall configuration.

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

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

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

Known issues

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

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

Next steps

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

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

  • Last updated on