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

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

تظهر هذه البداية السريعة كيفية إنشاء سير عمل تطبيقات منطقية في تطبيقات Azure متعددة المستأجرين التي تقوم بأتمتة المهام وتدمج العمليات عبر الخدمات والأنظمة والتطبيقات والبيانات في المؤسسات والمؤسسات باستخدام كود Visual Studio. يمكنك إنشاء وتحرير تعريفات سير العمل الأساسية، والتي تستخدم JavaScript Object Notation (JSON)، لسير العمل من خلال تجربة تعتمد على الكود. يمكنك أيضا العمل على سير عمل تطبيقات المنطق الموجودة بالفعل على Azure. لمزيد من المعلومات حول نموذج المستأجر المتعدد مقابل المستأجر الواحد، انظر مستأجر واحد مقابل متعدد مستأجر في Azure Logic Apps.

على الرغم من أنه يمكنك تنفيذ هذه المهام نفسها في مدخل Microsoft Azure، يمكنك البدء بشكل أسرع في Visual Studio Code عندما تكون على دراية بالفعل بتعريفات تطبيق المنطق وتريد العمل مباشرة في التعليمات البرمجية. على سبيل المثال، يمكنك تعطيل وتفعيل وحذف وتحديث سير عمل تطبيقات المنطق التي تم إنشاؤها مسبقا. أيضًا، يمكنك العمل على تطبيقات المنطق وحسابات التكامل من أي نظام أساسي للتطوير حيث يتم تشغيل Visual Studio Code، مثل Linux وWindows وMac.

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

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

قبل البدء، تأكد من أن لديك هذه العناصر:

• إذا لم يكن لديك أحد اشتراكات Azure، فسجّل للحصول على حساب Azure مجاني.

• المعرفة الأساسية حول تعريفات سير عمل تطبيق المنطق وهيكلها كما هو موضح مع JSON

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

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

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

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

  • ملحق Visual Studio Code لـAzure Logic Apps

    يمكنك تنزيل هذا الامتداد وتثبيته من Visual Studio Marketplace أو مباشرة من داخل Visual Studio Code. تأكد من إعادة تحميل Visual Studio Code بعد التثبيت.

    

    للتحقق من تثبيت الملحق بشكل صحيح، حدد رمز Azure الذي يظهر في شريط أدوات Visual Studio Code.

    

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

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

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

1. فتح Visual Studio Code. حدد رمز Azure في شريط أدوات Visual Studio Code.

   

2. في نافذة Azure، ضمن Logic Apps، حدد Sign in to Azure. عند مطالبة صفحة تسجيل الدخول من Microsoft، قم بتسجيل الدخول باستخدام حساب Azure.

   

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

      

   2. لنسخ التعليمات البرمجية، حدد Copy & Open.

      

   3. لفتح نافذة مستعرض جديدة والمتابعة إلى موقع المصادقة، حدد Open Link.

      

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

      

3. اختر حساب Azure بعد تسجيل الدخول، يمكنك إغلاق المستعرض والعودة إلى Visual Studio Code.

   في قسم Azure، تظهر مقاطع Logic AppsوIntegration Accounts اشتراكات Azure المقترنة بحسابك. ومع ذلك، إذا لم تشاهد الاشتراكات التي تتوقعها، أو إذا كانت المقاطع تظهر اشتراكات كثيرة جدًا، فاتبع الخطوات التالية:

   1. حرك المؤشر فوق تسمية Logic Apps. عند ظهور شريط الأدوات، حدد Select Subscriptions (رمز التصفية).

      

   2. من القائمة التي تظهر، حدد الاشتراكات التي تريد ظهورها.

4. ضمن Logic Apps، حدد الاشتراك الذي تريده. تتوسع عقدة الاشتراك وتعرض أي تطبيقات منطقية موجودة في ذلك الاشتراك.

   

   تلميح

   ضمن Integration Accounts، يعرض تحديد اشتراكك أي حسابات تكامل موجودة في هذا الاشتراك.

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

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

2. في Visual Studio Code ضمن Logic Apps، افتح القائمة المختصرة للاشتراك، وحدد Create Logic App.

   

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

3. من قائمة مجموعة الموارد، حدد إما Create a new resource groupأو مجموعة موارد موجودة. على سبيل المثال، إنشاء مجموعة موارد جديدة.

   

4. توفير اسم لمجموعة موارد Azure، ثم اضغط على ENTER.

   

5. حدد منطقة Azure حيث تريد حفظ بيانات التعريف لتطبيق المنطق.

   

6. قم بتوفير اسم لتطبيق المنطق، واضغط على Enter.

   

   في نافذة Azure، تحت اشتراكك في Azure، يظهر سير عمل تطبيق منطقي جديد وفارغ لديك. يفتح Visual Studio Code أيضًا ملف JSON (.logicapp.json)، والذي يتضمن تعريف سير عمل هيكلي لتطبيق المنطق الخاص بك. الآن يمكنك البدء في تأليف تعريف سير العمل الخاص بالتطبيق المنطقي يدويًا في ملف JSON هذا. للحصول على مرجع فني حول البنية والتركيب لتعريف سير العمل، راجع Workflow Definition Language schema for Azure Logic Apps.

   

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

   هام

   إذا أردت إعادة استخدام هذا التعريف النموذجي لسير عمل تطبيق المنطق، فأنت بحاجة إلى حساب تنظيمي، على سبيل المثال، @fabrikam.com. تأكد من استبدال عنوان البريد الإلكتروني الوهمي بعنوان البريد الإلكتروني الخاص بك. لاستخدام موصل بريد إلكتروني مختلف، مثل Outlook.com أو Gmail، استبدل الإجراء Send_an_email_action بإجراء مماثل متوفر من موصل بريد إلكتروني مدعوم من Azure Logic Apps.

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

   {
      "$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": {}
   }
   

7. عند الانتهاء، احفظ تعريف سير عمل تطبيق المنطق. (القائمة "ملف" > حفظ، أو اضغط على Ctrl + S)

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

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

   

عرض تعريف سير عمل تطبيق المنطق في المصمم

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

في نافذة Azure، ضمن Logic Appsافتح القائمة المختصرة لتطبيق المنطق، وحدد Open in Designer.

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

فتح في مدخل Microsoft Azure

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

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

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

   

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

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

هام

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

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

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

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

   

   يفتح Visual Studio Code الملف .logicapp.json في المجلد المؤقت المحلي بحيث يمكنك عرض تعريف سير العمل تطبيق المنطق الخاص بك.

   

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

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

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

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

   

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

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

هام

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

1. في نافذة Azure، ضمن Logic Apps، قم بتوسيع اشتراك Azure بحيث يمكنك عرض جميع التطبيقات المنطقية في هذا الاشتراك.

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

   تعرض قائمة Versions الإصدارات السابقة لتطبيق المنطق، إن وجدت.

   

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

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

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

   • لعرض الإصدار في طريقة عرض مصمم القراءة فقط، افتح القائمة المختصرة لهذا الإصدار، وحدد Open in Designer.

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

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

      

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

      

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

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

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

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

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

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

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

  لإيقاف تشغيل المشغل على العناصر غير المعالجة منذ آخر تشغيل، قم بإلغاء تحديد حالة المشغل قبل إعادة تنشيط تطبيق المنطق:

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

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

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

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

   1. لتعطيل تطبيق المنطق الذي تريده، افتح قائمة تطبيق المنطق، وحدد Disable.

      

   2. عندما تكون مستعدًا لإعادة تنشيط تطبيق المنطق، افتح قائمة تطبيق المنطق، وحدد Enable.

      

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

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

• تبذل Azure Logic Apps قصارى جهدها لإلغاء عمليات تشغيل قيد التقدم ومعلقة.

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

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

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

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

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

3. لتعطيل تطبيق المنطق الذي تريده، افتح قائمة تطبيق المنطق، وحدد Delete.

   

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

أنشئ تطبيقًا منطقيًا بمستأجر واحد في سير عمل Visual Studio Code