نموذج البرنامج النصي Azure CLI - إنشاء تطبيق منطقي

وينطبق ذلك على: Azure Logic Apps (الاستهلاك)

ينشئ هذا البرنامج النصي نموذج تطبيق منطق من خلال ملحق Azure CLI Logic Apps، (az logic). للحصول على دليل مفصل لإنشاء تطبيقات المنطق وإدارتها من خلال Azure CLI، راجع التشغيل السريع لـ Logic Apps لـ Azure CLI.

تحذير

يعد ملحق Azure CLI Logic Apps تجريبياً حالياً ولا يشمله دعم العملاء. يرجى استخدام ملحق CLI بحذر لاسيما إذا اخترت استخدام الملحق في البيئات الإنتاجية.

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

• حساب Azure باشتراك نشط. عند عدم وجود اشتراك في Azure، ⁦قم بإنشاء حساب مجاني⁦⁩.
• Azure CLI، مثبت على جهاز الكمبيوتر الشخصي.
• ملحق Logic Apps Azure CLI يتم تثبيته على جهاز الكمبيوتر. بتثبيت هذا الملحق استخدم هذا الأمر: az extension add --name logic
• تعريف سير عمل لتطبيق المنطق الخاص بك. يجب أن يتبع ملف JSON هذا مخطط لغة تعريف سير العمل.
• اتصال واجهة برمجة التطبيقات بحساب بريد إلكتروني من خلال موصل Azure Logic Apps مدعوم في نفس مجموعة الموارد مثل تطبيق المنطق الخاص بك. يستخدم هذا المثال موصل Outlook Office 365، ولكن يمكنك أيضًا استخدام موصلات أخرى مثل Outlook.com.

التحقق من المتطلبات الأساسية

التحقق من بيئتك قبل أن تبدأ:

• سجّل الدخول إلى مدخل Azure وتحقق من أن اشتراكك نشط عن طريق تشغيل az login.

• تحقق من إصدار Azure CLI في المحطة الطرفية أو نافذة الأوامر عن طريق تشغيل az --version. للحصول على أحدث إصدار، راجع ملاحظات الإصدار الأخيرة .

  • إذا لم يكن لديك أحدث إصدار، فحدِّث التثبيت باتباع دليل التثبيت لنظام التشغيل أو النظام الأساسي لديك .

نموذج شرح سير العمل

ينشئ ملف تعريف سير العمل هذا المثال نفس المثال الأساسي لسير عمل تطبيق منطق الاستهلاك كما هو الحال في التشغيل السريع لمدخل Microsoft Azure.

نموذج سير العمل هذا:

1. يحدد مخططًا، $schema، لتطبيق المنطق.

2. يعرف مشغل لتطبيق المنطق في قائمة المشغلات، triggers. يكرر المشغل (recurrence) كل 3 ساعات. يتم تشغيل الإجراءات عند نشر عنصر موجز جديد (When_a_feed_item_is_published) لموجز RSS المحدد (feedUrl).

3. يحدد إجراء لتطبيق المنطق في قائمة الإجراءات، actions. يرسل الإجراء رسالة بريد إلكتروني (Send_an_email_(V2)) من خلال Microsoft 365 مع تفاصيل من عناصر موجز RSS كما هو محدد في قسم النص الأساسي (body) من مدخلات الإجراء (inputs).

تعريف سير العمل العينة

قبل تشغيل نموذج البرنامج النصي، يجب أولًا إنشاء تعريف سير العمل العينة.

1. إنشاء ملف JSON، testDefinition.json على الكمبيوتر الخاص بك.

2. انسخ المحتوى التالي في ملف JSON:

   
   {
       "definition": {
           "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
           "actions": {
               "Send_an_email_(V2)": {
                   "inputs": {
                       "body": {
                           "Body": "<p>@{triggerBody()?['publishDate']}<br>\n@{triggerBody()?['title']}<br>\n@{triggerBody()?['primaryLink']}</p>",
                           "Subject": "@triggerBody()?['title']",
                           "To": "test@example.com"
                       },
                       "host": {
                           "connection": {
                               "name": "@parameters('$connections')['office365']['connectionId']"
                           }
                       },
                       "method": "post",
                       "path": "/v2/Mail"
                   },
                   "runAfter": {},
                   "type": "ApiConnection"
               }
           },
           "contentVersion": "1.0.0.0",
           "outputs": {},
           "parameters": {
               "$connections": {
                   "defaultValue": {},
                   "type": "Object"
               }
           },
           "triggers": {
               "When_a_feed_item_is_published": {
                   "inputs": {
                       "host": {
                           "connection": {
                               "name": "@parameters('$connections')['rss']['connectionId']"
                           }
                       },
                       "method": "get",
                       "path": "/OnNewFeed",
                       "queries": {
                           "feedUrl": "https://www.pbs.org/now/rss.xml"
                       }
                   },
                   "recurrence": {
                       "frequency": "Hour",
                       "interval": 3
                   },
                   "splitOn": "@triggerBody()?['value']",
                   "type": "ApiConnection"
               }
           }
       },
       "parameters": {
           "$connections": {
               "value": {
                   "office365": {
                       "connectionId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testResourceGroup/providers/Microsoft.Web/connections/office365",
                       "connectionName": "office365",
                       "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Web/locations/westus/managedApis/office365"
                   },
                   "rss": {
                       "connectionId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testResourceGroup/providers/Microsoft.Web/connections/rss",
                       "connectionName": "rss",
                       "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Web/locations/westus/managedApis/rss"
                   }
               }
           }
       }
   }
   
   

3. تحديث قيم العنصر النائب بمعلوماتك الخاصة:

   1. استبدل عنوان البريد الإلكتروني للعنوان النائب ("To": "test@example.com"). تحتاج إلى استخدام عنوان بريد إلكتروني متوافق باستخدام موصلات Logic Apps. لمزيد من المعلومات، راجع المتطلبات الأساسية.

   2. استبدل تفاصيل الموصل الإضافية إذا كنت تستخدم موصل بريد إلكتروني آخر غير موصل Outlook Office 365.

   3. استبدل قيم اشتراك العنصر النائب (00000000-0000-0000-0000-000000000000) لمعرفات الاتصال (connectionId وid) ضمن معلمة الاتصالات ($connections) بقيم الاشتراك الخاصة بك.

4. حفظ التغييرات.

نموذج البرنامج النصي

ملاحظة

تتم كتابة هذه العينة لـ shell bash. إذا كنت تريد تشغيل هذه العينة في shell أخرى، مثل Windows PowerShell أو موجه الأوامر، فقد تحتاج إلى إجراء تعديلات على البرنامج النصي الخاص بك.

قبل تشغيل نموذج البرنامج النصي هذا، قم بتشغيل هذا الأمر للاتصال بـ Azure:

az login

بعد ذلك، انتقل إلى الدليل الذي أنشأت فيه تعريف سير العمل الخاص بك. على سبيل المثال، إذا قمت بإنشاء ملف JSON لتعريف سير العمل على سطح المكتب الخاص بك:

cd ~/Desktop

ثم قم بتشغيل هذا البرنامج النصي لإنشاء تطبيق منطقي.

#!/bin/bash

# Create a resource group

az group create --name testResourceGroup --location westus

# Create your logic app

az logic workflow create --resource-group "testResourceGroup" --location "westus" --name "testLogicApp" --definition "testDefinition.json"

تنظيف النشر

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

az group delete --name testResourceGroup --yes

شرح البرنامج النصي

يستخدم هذا البرنامج النصي للعينة الأوامر التالية لإنشاء مجموعة موارد وتطبيق منطقي جديد.

الأمر	ملاحظات
az group create	يُنشئ مجموعة موارد يتم فيها تخزين موارد تطبيقك المنطقي.
az logic workflow create	إنشاء تطبيق منطقي استنادًا إلى سير العمل المحدد في المعلمة --definition.
az group delete	حذف مجموعة موارد وجميع مواردها المتداخلة.

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

لمزيد من المعلومات عن Azure CLI، يرجى الرجوع إلى وثائق Azure CLI.

يمكنك العثور على نماذج إضافية من البرنامج النصي Logic Apps CLI في متصفح نماذج التعليمات البرمجية لـ Microsoft.