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

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

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

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

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

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

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

• إذا لم يكن لديك أحد اشتراكات 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 Logic أو وقت التشغيل في منطقة Azure حيث يوجد تطبيق المنطق الخاص بك. إذا كان تطبيق المنطق يستخدم أيضًا موصلات مدارة، مثل موصل Office 365 Outlook أو موصل 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": 1
            },
            "splitOn": "@triggerBody()?['value']",
            "type": "ApiConnection",
            "inputs": {
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['rss']['connectionId']"
                  }
               },
               "method": "get",
               "path": "/OnNewFeed",
               "queries": {
                  "feedUrl": "http://feeds.reuters.com/reuters/topNews"
               }
            }
         }
      },
      "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، حدد Upload.

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

   

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

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

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

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

فتح في مدخل Microsoft Azure

لمراجعة تطبيق المنطق في مدخل Microsoft Azure اتبع الخطوات التالية:

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

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

   

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

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

هام

قبل تحرير تطبيق منطق يعمل بنشاط في الإنتاج، تجنب المخاطر في كسر هذا التطبيق المنطقي وتقليل التعطيل عن طريق disabling your logic app first.

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

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

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

   

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

   

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

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

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

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

   

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

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

هام

قبل تغيير تطبيق منطق يعمل بنشاط في الإنتاج، تجنب المخاطر في كسر هذا التطبيق المنطقي وتقليل التعطيل عن طريق disabling your logic app first.

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 Code، إذا قمت بتحرير تطبيق منطق منشور وحفظت التغييرات، يمكنك الكتابة فوق التطبيق الذي تم نشره بالفعل. لتجنب كسر تطبيق المنطق في الإنتاج وتقليل التعطيل، قم بتعطيل تطبيق المنطق أولاً. يمكنك بعد ذلك إعادة تنشيط تطبيق المنطق بعد التأكد من أن تطبيق المنطق لا يزال يعمل.

• تستمر 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