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

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

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

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

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

Example logic app workflow definition

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

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

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

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

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

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

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

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

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

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

    Select Azure icon on Visual Studio Code toolbar

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

    Select

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

      Continue with device code instead

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

      Copy code for Azure sign in

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

      Confirm opening a browser and going to authentication website

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

      Enter authentication code for Azure sign in

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

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

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

      Find or filter Azure subscriptions

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

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

    Select your Azure subscription

    تلميح

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

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

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

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

    From subscription menu, select

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

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

    Create a new Azure resource group

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

    Provide name for your Azure resource group

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

    Select Azure location for saving logic app metadata

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

    Provide name for your logic app

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

    Empty logic app workflow definition JSON file

    على سبيل المثال، إليك تعريف سير عمل تطبيق المنطق النموذجي، والذي يبدأ بمشغل 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.

    Upload new logic app to your Azure subscription

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

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

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

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

View logic app in read-only designer

فتح في مدخل Microsoft Azure

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

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

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

    Your new logic app in Azure portal

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

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

هام

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

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

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

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

    Open editor for existing logic app

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

    View workflow definition for published logic app

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

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

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

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

    Upload edits to logic app definition in Azure

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

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

هام

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

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

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

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

    Your logic app's previous versions

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

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

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

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

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

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

      Promote earlier version

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

      Confirm promoting earlier version

      يُرقي 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.

      Disable your logic app

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

      Enable your logic app

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

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

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

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

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

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

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

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

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

    Delete your logic app

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