التشغيل السريع: إنشاء مهام سير عمل تكامل تلقائية باستخدام Azure Logic Apps متعددة المستأجرين وVisual Studio

  • مقالة

التطبيق على:Azure Logic Apps (Consumption)

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

إذا كنت جديدا على Azure Logic Apps وتريد فقط المفاهيم الأساسية، فجرب التشغيل السريع لإنشاء مثال سير عمل تطبيق منطق الاستهلاك في مدخل Microsoft Azure. يعمل Logic App Designer بشكل مشابه في كل من مدخل Azure وVisual Studio.

في هذا التشغيل السريع، يمكن إنشاء نفس التطبيق المنطقي باستخدام Visual Studio مثل التشغيل السريع لمدخل Azure. يمكنك أيضا تعلم إنشاء مثال لسير عمل تطبيق المنطق في Visual Studio Code، وإنشاء وإدارة مهام سير عمل تطبيق المنطق باستخدام Azure CLI. يراقب سير عمل تطبيق المنطق هذا موجز ويب RSS ويرسل بريدا إلكترونيا لكل عنصر جديد في هذا الموجز. يبدو سير العمل في التطبيق المنطقي كسير العمل عالي المستوى الوارد أدناه:

Screenshot shows high-level view for example logic app workflow.

المتطلبات الأساسية

  • حساب واشتراك Azure. إذا لم يكن لديك اشتراك، فيجب التسجيل للحصول على حساب Azure مجاني. عند امتلاك اشتراك Azure Government، يجب اتباع هذه الخطوات الإضافية لإعداد Visual Studio لـ Azure Government Cloud .

  • تنزيل هذه الأدوات وتثبيتها، في حالة عدم امتلاكها بالفعل:

  • الوصول إلى الإنترنت أثناء استخدام مصمم سير العمل المضمن.

    يحتاج المصمم إلى اتصال بالإنترنت لإنشاء موارد في Azure وقراءة الخصائص والبيانات من الموصلات في سير عمل تطبيق المنطق.

  • حساب بريد إلكتروني مدعوم بواسطة Logic Apps، مثل Outlook for Microsoft 365 أو Outlook.com أو Gmail. بالنسبة للموفرين الآخرين، راجع قائمة الموصلات هنا. يستخدم هذا المثال Office 365 Outlook. عند استخدام مقدماً مختلفاً، فإن الخطوات الإجمالية هي نفسها، ولكن قد تختلف واجهة المستخدم بشكل طفيف.

    هام

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

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

إعداد Visual Studio لحكومة Azure

Visual Studio 2019

للعمل مع اشتراكات Azure Government في تطبيقات Azure Logic، يلزم وجود إضافة نقطة نهاية اكتشاف لـ Azure Government Cloud إلى Visual Studio . ومع ذلك، قبل تسجيل الدخول إلى Visual Studio باستخدام حساب Azure Government ، يلزم إعادة تسمية ملف JSON الذي أُنشئ بعد إضافة نقطة نهاية الاكتشاف باتباع الخطوات التالية:

  1. إغلاق Visual Studio.

  2. البحث عن ملف JSON الذي أُنشئ والمسمى Azure U.S. Government-A3EC617673C6C70CC6B9472656832A26.Configuration في هذا الموقع:

    %localappdata%\.IdentityService\AadConfigurations

  3. إعادة تسمية ملف JSON إلى AadProvider.Configuration.json.

  4. أعد تشغيل Visual Studio.

  5. متابعة الخطوات لتسجيل الدخول باستخدام حساب Azure Government.

للعودة إلى هذا الإعداد، حذف ملف JSON في الموقع التالي، وإعادة تشغيل Visual Studio:

%localappdata%\.IdentityService\AadConfigurations\AadProvider.Configuration.json

Visual Studio 2017

يمكن استخدام ملحق Azure Environment Selector Visual Studio ، والذي يمكن تنزيله وتثبيته من Visual Studio Marketplace .

إنشاء مشروع مجموعة موارد Azure

للبدء، يجب إنشاء مشروع Azure Resource Group . تعرف على المزيد حول مجموعات موارد Azure والموارد .

  1. ابدأ تشغيل Visual Studio. تسجيل بحساب Azure الخاص بك.

  2. في قائمة ملف، تحديد الـ >مشروع جديد. (لوحة المفاتيح: Ctrl + التحول + N)

    Screenshot shows Visual Studio, File menu with selected options for New, Project.

  3. ضمن مُثبت، تحديد Visual C#‎ أو Visual Basic. تحديد سحابة > Azure Resource Group . تسمية مشروعك الخاص على سبيل المثال:

    Screenshot shows how to create Azure Resource Group project.

    إشعار

    يمكن أن تحتوي أسماء مجموعات الموارد على أحرف وأرقام ونقاط ( ) فقط .، وشرطات سفلية ( _ )، وواصلات ( )، - وأقواس ( ، ، ، ( ولكن لا يمكن أن )تنتهي بنقط ( . ).

    إذا لم تظهر مجموعة موارد السحابة أو Azure، فيجب التأكد من تثبيت Sdk Azure Visual Studio.

    إذا كنت تستخدم Visual Studio 2019، فيجب اتباع الخطوات التالية:

    1. في مربع إنشاء مشروع جديد تحديد مشروع مجموعة موارد Azure لـ Visual C# أو Visual Basic. حدد التالي.

    2. تحديد اسم لمجموعة موارد Azure التي تريد استخدامها ومعلومات المشروع الأخرى. حدد إنشاء.

  4. من قائمة القالب، حدد قالب Logic App. حدد موافق.

    Screenshot shows selected Logic App template.

    بعد أن يُنشئ Visual Studio مشروعك الخاص، يفتحه مستكشف الحلول الحل الخاص بك ويعرضه. في الحل الخاص بك، لا يخزن ملف LogicApp.json تعريف الـ logic app الخاص بك فحسب، بل أيضاً يُخزن قالب إدارة موارد Azure الذي يمكن استخدامه للنشر.

    Screenshot shows Solution Explorer with new logic app solution and deployment file.

إنشاء سير عمل تطبيق منطقي فارغ

عند امتلاك مشروع مجموعة موارد Azure، يجب إنشاء logic app الخاص بك باستخدام قالب Blank Logic App.

  1. في مستكشف الحلول، فتح القائمة المختصرة لملف LogicApp.json . تحديد فتح باستخدامLogic App Designer. (لوحة المفاتيح: Ctrl + L)

    Screenshot shows workflow designer with opened logic app .json file.

    تلميح

    في حالة عدم امتلاك هذا الأمر فيVisual Studio 2019، فيجب التحقق من وجود آخر تحديثات Visual Studio.

    يطالبك Visual Studio باشتراك Azure ومجموعة موارد Azure لإنشاء الموارد ونشرها لسير عمل التطبيق المنطقي والاتصالات.

  2. للاشتراك: تحديد اشتراك Azure الخاص بك. وفيما يخص مجموعة الموارد تحديد إنشاء جديد لإنشاء مجموعة موارد Azure أخرى.

    Select Azure subscription, resource group, and resource location

    الإعدادات قيمة المثال ‏‏الوصف
    حساب المستخدم Fabrikam
    sophia-owen@fabrikam.com    		 الحساب الذي استخدمته عند تسجيل الدخول إلى Visual Studio
    الاشتراك الدفع أولا بأول
    (sophia-owen@fabrikam.com)    		 اسم اشتراك Azure والحساب المقترن
    مجموعة الموارد MyLogicApp-RG
    غرب الولايات المتحدة    		 مجموعة موارد Azure وموقع تخزين موارد logic app ونشرها
    Location مثل مجموعة الموارد نوع الموقع والموقع المحدد لنشر مورد تطبيق المنطق الخاص بك. نوع الموقع هو إما منطقة Azure أو integration service environment (ISE) موجودة.

    لهذا التشغيل السريع، الاحتفاظ بنوع الموقع الذي عُين إلى المنطقة وتعيين الموقع إلى نفس مجموعة الموارد.

    ملاحظة:بعد إنشاء مشروع مجموعة الموارد الخاصة بك، يمكن يمكن تغيير نوع الموقع والموقع،ولكن يؤثر نوع الموقع المختلف على logic app بطرق مختلفة.

  3. يفتح Logic Apps Designer صفحة تعرض فيديو مقدمة ومحفزات شائعة الاستخدام. التمرير لأسفل بعد الفيديو والمشغلات وصولاً إلى القوالب، وتحديد Blank Logic App.

    Screenshot shows selected template named Blank Logic App.

إنشاء سير العمل

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

  1. على مصمم سير العمل، اتبع هذه الخطوات العامة لإضافة مشغل RSS المسمى عند نشر عنصر موجز.

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

    عند الانتهاء، يبدو سير العمل الخاص بك مثل هذا المثال:

    Screenshot shows finished logic app workflow.

  3. حفظ حل Visual Studio الخاص بك. (لوحة المفاتيح: Ctrl + S)

نشر تطبيق المنطق إلى Azure

قبل أن تتمكن من تشغيل سير العمل واختباره، انشر التطبيق إلى Azure من Visual Studio.

  1. في مستكشف الحلول، في القائمة المختصرة للمشروع، تحديد نشر>جديد. عند التوجيه، يجب الدخول باستخدام حساب Azure الخاص.

    Screenshot shows project menu with selected options for Deploy, New.

  2. لهذا النشر، الاحتفاظ باشتراك Azure الافتراضي ومجموعة الموارد والإعدادات الأخرى. حدد نشر.

    Screenshot shows project deployment box with selected option named Deploy.

  3. إذا ظهر مربع تحرير المعلمات، فيجب توفير اسم مورد لـ logic app. الخاص. احفظ إعداداتك.

    Screenshot shows Edit Parameters box with resource name for logic app.

    عند بدء النشر، تظهر حالة نشر التطبيق في نافذة إخراج Visual Studio. إذا لم تظهر الحالة، يجب فتح قائمة إظهار الإخراج من وتحديد مجموعة موارد Azure.

    Screenshot shows Output window with deployment status output.

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

    Screenshot shows PowerShell window with prompt to provide connection credentials.

    بعد انتهاء النشر، يكون تطبيق المنطق الخاص بك مباشراً في مدخل Azure ويعمل وفقاً للجدول الزمني المحدد (كل دقيقة). إذا عثر المشغل على عناصر موجز جديدة، يتم تشغيل المشغل وإنشاء مثيل سير عمل يقوم بتشغيل إجراءات سير العمل. يرسل سير عملك رسالة إلكترونية لكل عنصر جديد. وإلا، إذا لم يعثر المشغل على عناصر جديدة، فلن يعمل و"يتخطى" إنشاء مثيل لسير العمل. ينتظر logic app الخاص حتى الفاصل الزمني التالي قبل التحقق.

    فيما يلي عينة من رسائل البريد الإلكتروني التي يرسلها هذا الـ logic app. في حالة عدم الحصول على أي رسائل بريد إلكتروني، فيجب التحقق من مجلد البريد الإلكتروني غير الهام.

    Screenshot shows example Outlook email sent for each new RSS item

تهانينا، لقد نجح إنشاء logic app ونشره باستخدام Visual Studio. لإدارة سير عمل تطبيق المنطق ومراجعة محفوظات التشغيل، راجع إدارة تطبيقات المنطق باستخدام Visual Studio.

إضافة تطبيق منطق جديد

عندما امتلاك مشروع مجموعة موارد Azure بالفعل، يمكن إضافة تطبيق منطق فارغ جديد إلى هذا المشروع باستخدام نافذة JSON Outline.

  1. في مستكشف الحلول، فتح ملف <logic-app-name>.json.

  2. من قائمة عرض، تحديد Windows>JSON Outline.

  3. لإضافة مورد إلى ملف القالب، تحديد إضافة مورد أعلى نافذة JSON Outline. أو في نافذة JSON Outline، فتح القائمة المختصرة للموارد، وتحديد إضافة مورد جديد.

    Screenshot shows window named JSON Outline.

  4. في مربع الحوار Add Resource ، في مربع البحث، ابحث عن logic app، وحدد Logic App. حدد اسمًا لمورد التطبيق المنطقي الخاص بك، وحدد إضافة.

    Screenshot shows steps to add resource.

تنظيف الموارد

عند الانتهاء من logic app الخاص، حذف مجموعة الموارد التي تحتوي على تطبيق المنطق والموارد ذات الصلة.

  1. تسجيل الدخول إلى مدخل Azure باستخدام نفس الحساب المستخدم لإنشاء تطبيق المنطق.

  2. في قائمة مدخل Azure تحديد مجموعات الموارد، أو البحث عن مجموعات الموارد من أي صفحة. حدد مجموعة موارد الخاص بـ logic app.

  3. في صفحة نظرة عامة، تحديد حذف مجموعة الموارد. إدخال اسم مجموعة الموارد كتأكيد، وتحديد حذف .

    Screenshot shows selected options for Resource groups, Overview, Delete resource group.

  4. حذف حل Visual Studio من الكمبيوتر المحلي.

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

في هذه المقالة، أُنشئ logic app ونشر ونُفذ باستخدام Visual Studio. للتعرف على إدارة التوزيع المتقدم وتنفيذه لتطبيقات المنطق باستخدام Visual Studio، راجع المقالة التالية:

إدارة logic apps باستخدام Visual Studio