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

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

كمطور تكامل، غالبا ما تحتاج إلى أتمتة العمليات التجارية عبر تطبيقات SaaS، وأنظمة المؤسسات، ومصادر البيانات دون إدارة البنية التحتية. تحتاج أيضا إلى طريقة تعتمد على البرمجة أولا لبناء سير العمل بحيث يمكنك تعديل تعريفات الإصدارات، وإجراء التحديثات، ومراجعة التغييرات بكفاءة.

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

في كود Visual Studio، يمكنك تعديل تعريفات سير العمل في JavaScript Object Notation (JSON) باستخدام محرر الكود، واستخدام المصمم البصري عند الحاجة، وإدارة سير العمل المنشور في Azure. يمكنك أيضا العمل على سير العمل وحسابات التكامل من أي منصة تطوير يعمل فيها Visual Studio Code، مثل لينكس، ويندوز، وmacOS.

تظهر لقطة الشاشة التالية كيف قد يبدو تعريف سير عمل الاستهلاك المثالي:

لمزيد من المعلومات، راجع:

• ما المقصود بـ Azure Logic Apps؟
• Single-tenant versus multitenant in Azure Logic Apps.

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

• حساب واشتراك Azure. احصل على حساب Azure مجاني.

• معرفة أساسية بتعريفات سير عمل التطبيقات المنطقية وبنيتها بصيغة JSON.

  المثال في هذا المقال ينشئ نفس سير عمل تطبيق المنطق كما في هذه البداية السريعة التي تركز أكثر على المفاهيم الأساسية. يمكنك أيضا تعلم إنشاء وإدارة سير العمل من خلال Azure CLI.

• الوصول إلى الويب لتسجيل الدخول إلى Azure واشتراكك في Azure.

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

  • إصدار Visual Studio Code 1.25.1 أو أحدث، وهو مجاني.

  • إضافة Visual Studio Code for Azure Logic Apps (Consumption).

    1. قم بتثبيت هذه الإضافة من سوق Visual Studio أو مباشرة من داخل Visual Studio Code.

       

    2. أعد تحميل كود فيجوال ستوديو بعد التثبيت.

    لمزيد من المعلومات، راجع Extension Marketplace. للمساهمة في إصدار المصدر المفتوح لهذا الملحق، قم بزيارة Azure Logic Apps extension for Visual Studio Code on GitHub.

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

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

إمكانية الوصول إلى Azure من Visual Studio Code

1. في Visual Studio Code، قم بتسجيل الدخول إلى حساب Azure الخاص بك.

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

   1. اختر استخدام كود الجهاز، ثم اختر نسخ وفتح.

   2. اختر فتح الرابط لفتح نافذة متصفح جديدة وتابع إلى موقع المصادقة.

   3. في صفحة Sign in to your account أدخل رمز المصادقة، وحدد Next.

2. في شريط النشاط، اختر أيقونة Azure.

   

   في لوحة Azure، تعرض أقسام تطبيقات المنطق (الاستهلاك)وحسابات التكامل الآن اشتراكات Azure المرتبطة بحسابك. إذا لم تر الاشتراكات التي تتوقعها، أو إذا كانت الأقسام تظهر عددا كبيرا من الاشتراكات، اتبع هذه الخطوات:

   1. في قسم تطبيقات المنطق (الاستهلاك)، اختر اختيار الاشتراكات.

      

   2. من قائمة الاشتراكات، اختر الاشتراكات التي ترغب في استخدامها.

3. في قسم تطبيقات المنطق (الاستهلاك)، وسع اشتراكك لعرض أي تطبيقات منطقية منشورة في ذلك الاشتراك.

   

إنشاء تطبيق منطقي

1. في كود Visual Studio، في قسم تطبيقات المنطق (الاستهلاك)، من قائمة اختصارات الاشتراك، اختر إنشاء تطبيق منطقي.

   

   تظهر قائمة وتعرض أي مجموعات موارد Azure في اشتراكك.

2. من قائمة مجموعات الموارد، اختر إنشاء مجموعة موارد جديدة أو مجموعة موارد موجودة.

   في هذا المثال، اختر إنشاء مجموعة موارد جديدة، على سبيل المثال:

   

3. أدخل اسما لمجموعة موارد Azure الخاصة بك.

   

4. اختر منطقة Azure التي تحفظ فيها بيانات تطبيق المنطق.

   

5. أدخل اسما لتطبيق المنطق الخاص بك.

   

   في نافذة Azure، تحت اشتراكك في Azure، يظهر تطبيق المنطق الجديد وسير العمل الفارغ. يفتح كود Visual Studio أيضا ملف JSON (.logicapp.json) يتضمن تعريف سير عمل هيكلي، على سبيل المثال:

   

   يمكنك الآن البدء في تأليف تعريف سير العمل يدويا في ملف JSON هذا. للحصول على مرجع تقني حول بنية وصياغة تعريف سير العمل، راجع مخطط لغة تعريف سير العمل لتطبيقات المنطق في Azure.

   يبدأ تعريف سير عمل تطبيق منطقي نموذجي بمحفز RSS وإجراء Outlook في Office 365. عادة، تظهر عناصر JSON أبجديًا في كل مقطع. ومع ذلك، تظهر هذه العينة هذه العناصر تقريبا حسب ترتيب ظهور عمليات سير العمل في المصمم.

   {
      "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
      "contentVersion": "1.0.0.0",
      "parameters": {
         "$connections": {
            "defaultValue": {},
            "type": "Object"
         }
      },
      "triggers": {
         "When_a_feed_item_is_published": {
            "recurrence": {
               "frequency": "Minute",
               "interval": 30
            },
            "splitOn": "@triggerBody()?['value']",
            "type": "ApiConnection",
            "inputs": {
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['rss']['connectionId']"
                  }
               },
               "method": "get",
               "path": "/OnNewFeed",
               "queries": {
                  "feedUrl": "@{encodeURIComponent('https://feeds.content.dowjones.io/public/rss/RSSMarketsMain')}",
                  "sinceProperty": "PublishDate"
               }
            }
         }
      },
      "actions": {
         "Send_an_email_(V2)": {
            "runAfter": {},
            "type": "ApiConnection",
            "inputs": {
               "body": {
                  "Body": "<p>Title: @{triggerBody()?['title']}<br>\n<br>\nDate published: @{triggerBody()?['updatedOn']}<br>\n<br>\nLink: @{triggerBody()?['primaryLink']}</p>",
                  "Subject": "RSS item: @{triggerBody()?['title']}",
                  "To": "sophia-owen@fabrikam.com"
               },
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['office365']['connectionId']"
                  }
               },
               "method": "post",
               "path": "/v2/Mail"
            }
         }
      },
      "outputs": {}
   }
   

   هام

   لإعادة استخدام هذا التعريف النموذجي لسير العمل، تحتاج إلى حساب عمل تنظيمي أو مدرسي، على سبيل المثال، @fabrikam.com. تأكد من استبدال عنوان البريد الإلكتروني الوهمي بعنوان البريد الإلكتروني الخاص بك.

   لاستخدام موصل بريد إلكتروني مختلف، مثل Outlook.com أو Gmail، استبدل الإجراء Send_an_email_action بإجراء مشابه متاح من موصل بريد إلكتروني يدعمه Azure Logic Apps.

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

6. عندما تنتهي، احفظ تعريف سير العمل. (ملف>احفظ أو اضغط Ctrl+S).

7. عندما يطلب منك رفع تعريف سير عمل تطبيق المنطق إلى اشتراكك في Azure، اختر رفع.

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

   

عرض سير العمل في المصمم

في كود Visual Studio، يمكنك فتح سير عمل تطبيق المنطق الخاص بك في عرض التصميم للقراءة فقط. على الرغم من أنك لا تستطيع تعديل تعريف سير العمل في المصمم، يمكنك التحقق بصريا من سير العمل باستخدام عرض المصمم.

في نافذة Azure، في قسم تطبيقات المنطق (الاستهلاك)، من قائمة اختصارات تطبيق المنطق، اختر فتح في المصمم.

يفتح مصمم القراءة فقط في تبويب منفصل ويعرض سير عمل تطبيق المنطق، على سبيل المثال:

عرض سير العمل في بوابة Azure

لمراجعة تعريف سير عمل تطبيق المنطق الخاص بك في بوابة Azure، اتبع الخطوات التالية:

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

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

   

3. في الشريط الجانبي لتطبيق المنطق، تحت أدوات التطوير، افتح سير العمل في عرض المصمم أو الكود.

تحرير تطبيق المنطق المنشور

في كود Visual Studio، يمكنك فتح وتحرير تعريف سير العمل لمورد تطبيق منطقي تم نشره بالفعل في Azure.

هام

قبل أن تقوم بتحرير سير عمل تطبيق منطقي يعمل بنشاط في الإنتاج، قلل من الاضطراب وتجنب خطر تعطل سير العمل عن طريق تعطيل مورد تطبيق المنطق أولا.

1. في Visual Studio Code، في شريط النشاط، حدد أيقونة Azure.

2. في نافذة Azure، في قسم تطبيقات المنطق (الاستهلاك)، وسع اشتراكك في Azure واختر تطبيق المنطق الذي تريده.

3. من قائمة اختصار تطبيق المنطق، اختر فتح في المحرر. أو، بجانب اسم تطبيق المنطق، اختر أيقونة التعديل.

   

   يفتح كود Visual Studio ملف .logicapp.json في المجلد المؤقت المحلي لديك حتى تتمكن من عرض تعريف سير العمل.

   

4. قم بإجراء تغييراتك في ملف تعريف سير العمل.

5. عند الانتهاء، احفظ التغييرات (حفظالملف> أو اضغط Ctrl+S).

6. عندما يطلب منك رفع تغييراتك وكتابة سير عمل تطبيق المنطق الحالي في بوابة Azure، اختر رفع.

   هذه الخطوة تنشر تحديثاتك إلى مورد تطبيق المنطق الخاص بك في بوابة Azure.

   

عرض إصدارات أخرى أو الترويج لها

في كود Visual Studio، يمكنك فتح ومراجعة الإصدارات السابقة لسير عمل تطبيق المنطق الخاص بك. يمكنك أيضًا ترقية إصدار سابق إلى الإصدار الحالي.

هام

قبل أن تغير سير عمل تطبيق منطقي يعمل بنشاط في الإنتاج، قلل من الاضطراب وتجنب خطر تعطل تطبيق المنطق عن طريق تعطيل مورد تطبيق المنطق أولا.

1. في نافذة Azure، في قسم تطبيقات المنطق (الاستهلاك)، وسع اشتراكك في Azure لعرض تطبيقات المنطق المرتبطة.

2. ضمن اشتراكك، قم بتوسيع تطبيق المنطق الخاص بك، ووسع Versions.

   تظهر قائمة الإصدارات إصدارات تطبيق المنطق السابقة، إذا كانت موجودة.

   

3. لعرض نسخة سابقة، اختر واحدة من الخطوات التالية:

   • لعرض تعريف JSON، ضمن Versions، حدد رقم الإصدار لهذا التعريف. أو، من قائمة اختصارات الإصدارات، اختر فتح في المحرر.

     يتم فتح ملف جديد على الكمبيوتر المحلي الخاص بك ويعرض تعريف JSON الخاص بهذا الإصدار.

   • لعرض النسخة في المصمم للقراءة فقط، من قائمة الاختصارات الخاصة بالنسخة، اختر فتح في المصمم.

4. لترقية إصدار سابق إلى الإصدار الحالي اتبع الخطوات التالية:

   1. تحت الإصدارات، من قائمة الاختصارات في النسخة السابقة، اختر الترويج.

      

   2. للمتابعة بعد أن يطالبك Visual Studio Code بالتأكيد، حدد Yes.

      يُرقي Visual Studio Code الإصدار المحدد إلى الإصدار الحالي ويُعيّن رقمًا جديدًا إلى الإصدار المُرقى. يظهر الإصدار الحالي سابقًا الآن ضمن الإصدار الذي تمت ترقيته.

تعطيل تطبيقات المنطق أو تمكينها

في كود Visual Studio، إذا قمت بتحرير سير عمل لتطبيق منطقي منشور وحفظ التغييرات، فإنك تقوم بالكتابة فوق تطبيق المنطق الذي تم نشره بالفعل. لتجنب تعطيل سير عمل تطبيق المنطق في الإنتاج وتقليل الاضطراب، قم بتعطيل مورد تطبيق المنطق أولا. بعد التأكد من أن سير العمل لا يزال يعمل كما هو متوقع، يمكنك إعادة تفعيل مورد تطبيق المنطق.

تعطيل أو تفعيل مورد تطبيق منطقي يؤثر على حالات سير العمل بالطرق التالية:

• يستمر Azure Logic Apps في العمل وتشغيل سير العمل المعلق حتى الانتهاء. استنادًا إلى وحدة التخزين أو تراكم، قد تستغرق هذه العملية وقتًا لتكتمل.

• لا تنشئ Azure Logic Apps مثيلات سير عمل جديدة أو تقوم بتشغيلها.

• الزناد لا يطلق في المرة التالية التي تتحقق فيها الشروط.

• حالة المشغلة تتذكر النقطة التي توقف فيها سير العمل. لذا، إذا أعدت تفعيل تطبيق المنطق، يتم تفعيل الزناد لأي عناصر لم تعالج بعد منذ آخر تشغيل.

  لمنع الزناد من إطلاق النار على هذه العناصر غير المعالجة، قبل إعادة تفعيل مورد تطبيق المنطق، قم بمسح حالة الزناد:

  1. في سير العمل، قم بتحرير أي جزء من المحفز.
  2. احفظ تغييراتك. تُعيد هذه الخطوة تعيين الحالة الحالية للمشغل الخاص بك.
  3. أعد تفعيل مورد تطبيق المنطق الخاص بك.

• عندما يتم تعطيل مورد تطبيق المنطق، لا يزال بإمكانك إعادة إرسال عمليات العمل.

لتعطيل أو تفعيل مورد تطبيق منطقي في كود Visual Studio، اتبع هذه الخطوات:

1. في Visual Studio Code، افتح نافذة Azure.

2. في قسم تطبيقات المنطق (الاستهلاك)، وسع اشتراكك في Azure لعرض تطبيقات المنطق المرتبطة.

3. لتعطيل مورد تطبيق منطقي، من قائمة اختصار تطبيق منطقي، اختر تعطيل.

   

4. عندما تكون مستعدا لإعادة تفعيل مورد تطبيق المنطق ، اختر من قائمة اختصار تطبيق المنطق.

   

حذف تطبيقات المنطق

يؤثر حذف التطبيق المنطقي على مثيلات سير العمل بالطرق التالية:

• يحاول Azure Logic Apps إلغاء أي عمليات عمل جارية أو معلقة.

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

• لا تنشئ Azure Logic Apps مثيلات سير عمل جديدة أو تقوم بتشغيلها.

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

لحذف مورد تطبيق منطقي من كود Visual Studio، اتبع هذه الخطوات:

1. في Visual Studio Code، افتح نافذة Azure.

2. في قسم تطبيقات المنطق (الاستهلاك)، قم بتوسيع اشتراكك في Azure لعرض موارد تطبيقات المنطق المرتبطة. ابحث عن المورد الذي تريد حذفه من تطبيق المنطق.

3. من قائمة اختصارات تطبيق المنطق، اختر حذف.

   

المحتوى ذو الصلة

• إنشاء سير عمل قياسي في Azure Logic Apps بمستأجر واحد باستخدام Visual Studio Code