الاتصال بخادم ملفات SFTP من مهام سير العمل في Azure Logic Apps
ينطبق على: Azure Logic Apps (الاستهلاك + قياسي)
يوضح هذا الدليل الإرشادي كيفية الوصول إلى خادم بروتوكول نقل ملفات SSH (SFTP) من سير عمل في Azure Logic Apps. SFTP هو بروتوكول شبكة يوفر الوصول إلى الملفات ونقل الملفات وإدارة الملفات عبر أي دفق بيانات موثوق به ويستخدم بروتوكول Secure Shell (SSH ).
في مهام سير عمل Consumption logic app، يمكنك استخدام الموصل المدار SFTP-SSH، بينما في مهام سير عمل تطبيق المنطق القياسي، يمكنك استخدام موصل SFTP المضمن أو الموصل المدار SFTP-SSH. يمكنك استخدام عمليات الموصل هذه لإنشاء مهام سير عمل تلقائية يتم تشغيلها عند تشغيلها بواسطة الأحداث في خادم SFTP أو في أنظمة أخرى وتشغيل الإجراءات لإدارة الملفات على خادم SFTP. يستخدم كل من الموصلات المدارة والمضمنة بروتوكول SSH.
إشعار
تم إهمال الموصل المدار SFTP، لذلك لم تعد عمليات هذا الموصل تظهر في مصمم سير العمل.
على سبيل المثال، يمكن أن يبدأ سير العمل بمشغل SFTP الذي يراقب الأحداث ويستجيب لها على خادم SFTP. يجعل المشغل المخرجات متاحة للإجراءات اللاحقة في سير العمل الخاص بك. يمكن لسير العمل تشغيل إجراءات SFTP التي تحصل على الملفات وإنشاءها وإدارتها من خلال حساب خادم SFTP. تتضمن القائمة التالية المزيد من أمثلة المهام:
- مراقبة وقت إضافة الملفات أو تغييرها.
- الحصول على الملفات وإنشاءها ونسخها وإعادة تسميتها وتحديثها وإدراجها وحذفها.
- إنشاء مجلدات.
- احصل على محتوى الملف وبيانات التعريف.
- استخراج الأرشيفات إلى المجلدات.
تستخدم الخطوات التالية مدخل Microsoft Azure، ولكن مع ملحق Azure Logic Apps المناسب، يمكنك أيضا استخدام الأدوات التالية لإنشاء مهام سير عمل تطبيق المنطق:
- مهام سير عمل الاستهلاك: Visual Studio Code
- مهام سير العمل القياسية: Visual Studio Code
مرجع تقني للموصل
يحتوي موصل SFTP على إصدارات مختلفة، استنادا إلى نوع التطبيق المنطقي وبيئة المضيف.
| نوع تطبيق المنطق (خطة) | البيئة | إصدار الموصل |
|---|---|---|
| استهلاك | تطبيقات Azure Logic Apps متعددة المستأجرين | الموصل المدار، الذي يظهر في معرض الموصلات ضمن وقت>التشغيل المشترك. لمزيد من المعلومات، راجع الوثائق التالية: - مرجع موصل SFTP-SSH المدار - الموصلات المُدارة Azure Logic Apps |
| قياسي | تطبيقات Azure Logic للمستأجر الفردي وبيئة خدمة التطبيقات الإصدار 3 (خطط Windows فقط) | الموصل المدار، الذي يظهر في معرض الموصلات ضمن Runtime>Shared، والموصل المضمن، والذي يظهر في معرض الموصل ضمن Runtime>In-App وهو مستند إلى موفر الخدمة. يمكن للموصل المضمن الاتصال مباشرة بخادم SFTP والوصول إلى شبكات Azure الظاهرية باستخدام سلسلة الاتصال بدون بوابة بيانات محلية. لمزيد من المعلومات، راجع الوثائق التالية: - مرجع موصل SFTP-SSH المدار - مرجع موصل SFTP المضمن - الموصلات المُدارة Azure Logic Apps - الموصلات المُضمّنة في Azure Logic Apps |
قيود عامة
قبل استخدام الموصل المدار SFTP-SSH، راجع مرجع الموصل المدار SFTP-SSH - المشكلات والقيود المعروفة.
قبل استخدام موصل SFTP المضمن، راجع مرجع موصل SFTP المضمن - المشكلات والقيود المعروفة.
المشكلات المعروفة
بشكل افتراضي، تحتوي المشغلات التي ترجع صفيفا على إعداد Split On الذي تم تمكينه بالفعل. مع تمكين هذا الإعداد، يقوم المشغل تلقائيا بإلغاء تحديد الصفيف عن طريق إنشاء مثيل سير عمل منفصل داخليا لمعالجة كل عنصر صفيف. يتم تشغيل جميع مثيلات سير العمل بالتوازي بحيث تتم معالجة عناصر الصفيف في نفس الوقت.
ومع ذلك، عند تمكين إعداد Split On ، يقوم الموصل المدار بتشغيل إرجاع المخرجات لكافة عناصر الصفيف كقوائم. يجب أن تتعامل أي إجراءات لاحقة تشير إلى هذه المخرجات أولا مع هذه المخرجات كقوائم. لمعالجة كل عنصر صفيف على حدة، يمكنك إضافة إجراءات إضافية. على سبيل المثال، للتكرار من خلال عناصر الصفيف هذه، يمكنك استخدام لكل تكرار حلقي. بالنسبة للمشغلات التي ترجع بيانات التعريف أو الخصائص فقط، استخدم إجراء يحصل على بيانات تعريف عنصر الصفيف أولا، ثم استخدم إجراء للحصول على محتويات العناصر.
يجب عليك تطبيق هذا الأسلوب فقط على مشغلات الموصل المدارة ، وليس مشغلات الموصل المضمنة التي ترجع مخرجات لعنصر صفيف واحد في كل مرة يتم فيها تمكين إعداد Split On .
على سبيل المثال، افترض أنك قمت بإدارة مشغل الموصل المسمى عند إضافة ملف أو تعديله (خصائص فقط) يقوم بإرجاع بيانات التعريف أو الخصائص للملفات الجديدة أو المحدثة كصفائف. للحصول على بيانات التعريف بشكل منفصل لكل ملف، قد تستخدم لكل تكرار حلقي يتكرر عبر الصفيف. في هذه الحلقة، استخدم إجراءات الموصل المدارة التالية بالترتيب المحدد:
احصل على بيانات تعريف الملف للحصول على بيانات تعريف كل ملف.
إجراء الحصول على محتوى الملف للحصول على محتوى كل ملف.
التقسيم
لمزيد من المعلومات حول كيفية تعامل الموصل المدار SFTP-SSH مع الملفات الكبيرة التي تتجاوز حدود الحجم الافتراضية، راجع مرجع الموصل المدار SFTP-SSH - التقسيم.
المتطلبات الأساسية
حساب واشتراك Azure. إذا لم يكن لديك اشتراك، فقم بالتسجيل للحصول على حساب Azure مجاني.
معلومات الاتصال والمصادقة للوصول إلى خادم SFTP، مثل عنوان الخادم وبيانات اعتماد الحساب والوصول إلى مفتاح SSH الخاص وكلمة مرور المفتاح الخاص ل SSH. لمزيد من المعلومات، راجع مرجع الموصل المدار SFTP-SSH - المصادقة والأذونات.
هام
عند إنشاء الاتصال وإدخال مفتاح SSH الخاص بك في خاصية المفتاح الخاص SSH، تأكد من اتباع الخطوات لتوفير القيمة الكاملة والصحيحة لهذه الخاصية. وإلا، يؤدي المفتاح غير الصالح إلى فشل الاتصال.
سير عمل التطبيق المنطقي حيث تريد الوصول إلى حساب SFTP الخاص بك. للبدء بمشغل SFTP-SSH، يجب أن تبدأ بسير عمل فارغ. لاستخدام إجراء SFTP-SSH، ابدأ سير العمل بمشغل آخر، مثل مشغل التكرار .
إضافة مشغل SFTP
في مدخل Microsoft Azure، افتح تطبيق منطق الاستهلاك الخاص بك مع سير عمل فارغ في المصمم.
في المصمم، اتبع هذه الخطوات العامة لإضافة مشغل SFTP-SSH الذي تريده.
إذا طلب منك ذلك، فوفر معلومات الاتصال الضرورية. عند الانتهاء، حدد إنشاء.
بعد ظهور مربع معلومات المشغل، قم بتوفير التفاصيل اللازمة للمشغل المحدد. لمزيد من المعلومات، راجع مرجع مشغلات الموصل المدارة SFTP-SSH.
عند الانتهاء، احفظ سير العمل الخاص بك. في شريط أدوات المصمم، حدد "Save".
عند حفظ سير العمل الخاص بك، تنشر هذه الخطوة تلقائيا تحديثاتك إلى تطبيق المنطق المنشور، والذي يكون مباشرا في Azure. باستخدام مشغل فقط، يتحقق سير العمل فقط من خادم FTP استنادا إلى الجدول الزمني المحدد. يجب عليك إضافة إجراء يستجيب للمشغل ويفعل شيئا مع مخرجات المشغل.
على سبيل المثال، يبدأ المشغل المسمى عند إضافة ملف أو تعديله سير عمل عند إضافة ملف أو تغييره على خادم SFTP. كإجراء لاحق، يمكنك إضافة شرط يتحقق من استيفاء محتوى الملف للمعايير المحددة. إذا كان المحتوى يفي بالشرط، فاستخدم الإجراء المسمى الحصول على محتوى الملف للحصول على محتوى الملف، ثم استخدم إجراء آخر لوضع محتوى الملف هذا في مجلد مختلف على خادم SFTP.
إضافة إجراء SFTP
قبل أن تتمكن من استخدام إجراء SFTP، يجب أن يبدأ سير العمل بالفعل بمشغل، والذي يمكن أن يكون أي نوع تختاره. على سبيل المثال، يمكنك استخدام مشغل التكرار المضمن العام لبدء سير العمل الخاص بك على جدول زمني محدد.
في مدخل Microsoft Azure، افتح تطبيق منطق الاستهلاك الخاص بك مع سير العمل في المصمم.
في المصمم، اتبع هذه الخطوات العامة لإضافة إجراء SFTP-SSH الذي تريده.
إذا طلب منك ذلك، فوفر معلومات الاتصال الضرورية. عند الانتهاء، حدد إنشاء.
بعد ظهور مربع معلومات الإجراء، قم بتوفير التفاصيل اللازمة للإجراء المحدد. لمزيد من المعلومات، راجع مرجع إجراءات الموصل المدارة SFTP-SSH.
عند الانتهاء، احفظ سير العمل الخاص بك. في شريط أدوات المصمم، حدد "Save".
على سبيل المثال، الإجراء المسمى Get file content using path يحصل على المحتوى من ملف على خادم SFTP عن طريق تحديد مسار الملف. يمكنك استخدام المشغل من المثال السابق وشرط يجب أن يفي به محتوى الملف. إذا كان الشرط صحيحا، يمكن أن يحصل الإجراء اللاحق على المحتوى.
استكشاف الأخطاء وإصلاحها
لمزيد من المعلومات، راجع الوثائق التالية:
- مرجع الموصل المدار SFTP-SSH - استكشاف الأخطاء وإصلاحها
- مرجع موصل SFTP المضمن - استكشاف الأخطاء وإصلاحها