أنشئ معلمات عبر البيئة لإدخالات سير العمل في Azure Logic Apps

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

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

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

لمزيد من المعلومات حول Azure Logic Apps متعددة المستأجرين والمستأجر الفردي، راجع بيئة خدمة المستأجر الفردي مقابل متعددة المستأجرين وبيئة خدمة التكامل لـ Azure Logic Apps.

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

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

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

  إذا لم يكن لديك سير عمل تطبيق منطقي حتى الآن، فشاهد إنشاء مثال سير عمل تطبيق منطق الاستهلاك باستخدام مدخل Microsoft Azure أو إنشاء مثال لسير عمل تطبيق المنطق القياسي باستخدام مدخل Microsoft Azure.

  ملاحظة

  حاليًا، يمكن إنشاء معلمات لمهام سير عمل تطبيق منطق الاستهلاك فقط باستخدام مدخل Microsoft Azure. يمكنك إنشاء معلمات لعمليات سير العمل لتطبيق المنطق القياسي فقط باستخدام مدخل Microsoft Azure أو Visual Studio Code.

معلمات الاستهلاك مقابل مهام سير عمل تطبيق المنطق القياسي

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

في مهام سير عمل تطبيق منطق الاستهلاك متعدد المستأجرين، بعد إنشاء المعلمات واستخدامها في المصمم، يمكنك تحديد وتعيين متغيرات البيئة في قالب Azure Resource Manager (قالب ARM) وملفات معلمات القالب. في هذا السيناريو، يجب عليك أن تحدد المعلمات وتعيينهاعند التوزيع، ما يعني أنه حتى إذا كان عليك تغيير متغير واحد فقط، يجب عليك إعادة توزيع قالب ARM لتطبيق المنطق الخاص بك.

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

ملاحظة

في مهام سير عمل لتطبيق المنطق القياسي، أنواع البيانات الآمنة، مثلsecurestringوsecureobject، غير مدعومة. مع ذلك، كخيار بديل، يمكنك استخدام الإعدادات المتعلقة بالتطبيق باستخدام Azure Key Vault. يمكنك بعد ذلكالعودة مباشرة إلى سلاسل آمنة، مثل سلاسل الاتصال والمفاتيح. على غِرار قوالب ARM، إذ يمكنك تحديد متغيرات البيئة في وقت التوزيع، يمكنك تعريف إعدادات التطبيق ضمن تعريف سير عمل التطبيق المنطقي. يمكنك بعد ذلك التقاط قيم البنية التحتية التي تم إنشاؤها ديناميكيًا، مثل نقاط نهاية الاتصال وسلاسل التخزين والمزيد.

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

على سبيل المثال، في حال كنت تستخدم Visual Studio Code كأداة تطوير محلية لتشغيل مهام سير العمل محلياً، في مشروع تطبيق المنطق الخاص بك، يمكنك تعريف المعلمات باستخدام ملفparameters.json. بعد ذلك يمكنك الرجوع إلى أي معلمة في ملف المعلمات هذا من أي سير عمل في ملفworkflow.jsonالخاص بمشروعك أو من أي كائن اتصال في ملفconnections.jsonالخاص بمشروعك. تصف القائمة التالية بعض حالات الاستخدام المنتشرة:

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

• قم بتحديد معلمات لأجزاء مختلفة من ملف connections.json. بعد ذلك يمكنك التحقق من ملف connections.json الخاص بك في التحكم بالمصادر، ثم إدارة أي اتصالات من خلال ملف parameters.json الخاص بك.

• وضع المعلمات للعناصر المعقدة authentication، مثل عنصر JSON. على سبيل المثال، يمكنك استبدال authenticationقيمة العنصر بسلسلة تحتوي على تعبير معلمات واحد، مثل@parameters('api-auth').

• مراجعة إعدادات التطبيق وتحريرها في ملفlocal.settings.jsonالخاص بمشروعك. يمكنك بعد ذلك الرجوع إلى إعدادات التطبيق هذه في معلماتك.

ملاحظة

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

تحديد واستخدام وتحرير المعلمات

Consumption

مدخل Azure

1. في مدخل Microsoft Azure، قم بفتح سير عمل التطبيق المنطقي. ضمنمهام سير العمل، قم بتحديد سير العمل وافتحه في المصمم.

2. من شريط أدوات المصمم، قم بتحديدالمعلمات.

   

3. في جزءParameters، قم بتحديدAdd parameter.

4. قدم المعلومات التالية حول المعلمة المراد إنشاؤها:

   الخاصية	مطلوب	الوصف
   الاسم	نعم	الاسم المتعلق بالمعلمة المراد إنشاؤها.
   النوع	نعم	نوع البيانات للمعلمة، مثلArrayوBoolوFloatوIntوObjectوSecure ObjectوSecure StringوString.
   ⁧⁩القيمة الافتراضية⁧⁩	نعم	القيمة الافتراضية الخاصة بالمعلمة. يجب عليك أن تحدد قيمة المعلمة الافتراضية لأن منطق سير العمل ومعلومات الاتصال وقيم المعلمات غير موجودة في مكان واحد. يلزم أن يكون المصمم قادرًا على حل قيم المعلمات قبل التحميل. مهم: بالنسبة لأنواع بياناتالعنصر الآمنوالسلسلة الآمنة، تجنب تعيين قيمة افتراضية لأن القيمة مخزنة كنص عادي.
   قيمة فعلية	لا	القيمة الفعلية المتعلقة بالمعلمة.

   يوضح المثال التالي تعريفًا لمعلمة السلسلة:

   

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

6. للإشارة للمعلمة من مشغل أو إجراء موجود في نفس سير العمل، اتبع الخطوات الآتية:

   1. في المصمم، قم بفتح سير العمل الذي تريده، وقم بتوسيع المشغل أو الإجراء.

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

   3. من قائمة المحتوى الديناميكي التي تفتح، ضمنParameters، قم بتحديد المعلمةالتي تم إنشاؤها مسبقاً، على سبيل المثال:

      

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

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

      يتم فتح جزءParametersويعرض كافة المعلمات التي قمت بتعريفها لسير العمل هذا.

   2. قم بإجراء عمليات التحرير الخاصة بك وأغلق جزء المعلمات واحفظ سير عمل تطبيق المنطق.

قياسي

مدخل Azure

1. داخل مدخل Microsoft Azure، افتح مورد التطبيق المنطقي. ضمن مهام سير العمل، افتح سير العمل في المصمم.

2. من شريط أدوات المصمم، قم بتحديدالمعلمات.

   

3. في جزء Parameters، قم بتحديدAdd parameter.

4. قدم المعلومات التالية حول المعلمة المراد إنشاؤها:

   الخاصية	مطلوب	الوصف
   الاسم	نعم	الاسم المتعلق بالمعلمة المراد إنشاؤها.
   النوع	نعم	نوع البيانات للمعلمة، مثلArrayوBoolوFloatوIntوObjectوString. ملاحظة: في مهام سير عمل لتطبيق المنطق القياسي، أنواع البيانات الآمنة، مثل securestringوsecureobject، غير مدعومة.
   القيمة	نعم	القيمة للمعلمة. في مهام سير عمل تطبيق المنطق القياسي، يجب عليك تحديد قيمة المعلمة لأن منطق سير العمل ومعلومات الاتصال وقيم المعلمات غير موجودة في مكان واحد. يلزم أن يكون المصمم قادرًا على حل قيم المعلمات قبل التحميل.

   يوضح المثال التالي تعريفًا لمعلمة السلسلة:

   

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

6. للإشارة إلى المعلمة من مشغل أو إجراء موجود في أي سير عمل داخل نفس تطبيق المنطق، اتبع الخطوات الآتية:

   1. في المصمم، قم بفتح سير العمل الذي تريده، وقم بتوسيع المشغل أو الإجراء.

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

   3. من قائمة المحتوى الديناميكي التي تفتح، ضمن Parameters، قم بتحديد المعلمة التي تم إنشاؤها مسبقاً، على سبيل المثال:

      

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

   • افتح أي سير عمل في تطبيق المنطق ذلك. في قائمة سير العمل، قم بتحديد Designer. في شريط أدوات المصمم، قم بتحديد المعلمات.

     تفتح جزء Parameters ويعرض كافة المعلمات التي قمت بتعريفها من سير العمل في تطبيق المنطق ذلك.

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

     يفتح جزء JSONParameters ويعرض كافة المعلمات التي قمت بتعريفها من سير العمل في تطبيق المنطق ذلك.

تعليمة Visual Studio برمجية

1. في ملف JSON على مستوى جذر المشروع المسمىparameters.json، قم بتحديدكافةالمعلمات وقيمها. يحتوي هذا الملف على كائن يشمل أزواج قيم المفاتيح. كل مفتاحهو اسم لكل معلمة، بينما كل قيمةهي بنية لكل معلمة. يجب أن تشمل كل بنية إعلان بالربط type وvalue.

   هام

   يجب أن يحدد ملف parameters.json كافة المعلمات وقيمها التي تشير إليها أو تستخدمها في مكان آخر في مشروعك، على سبيل المثال، في تعريفات سير العمل أو الاتصالات.

   يوضح المثال التالي ملف معلمات أساسي:

   {
       "responseString": { 
           "type": "string", 
           "value": "hello" 
       },
       "functionAuth": { 
           "type": "object", 
           "value": { 
               "type": "QueryString", 
               "name": "Code", 
               "value": "@appsetting('<AzureFunctionsOperation-FunctionAppKey>')" 
           }
       }
    }
   

   ملاحظة

   في الملفparameters.json،@appsetting هو نوع التعبير الصالح الوحيد.

2. من أجل الإشارة إلى المعلمات في مدخلات المشغل أو الإجراء، استخدم التعبير@parameters('<parameter-name>').

معلمة ملف الاتصالات

من أجل تحديدمعلمات ملف connections.json، استبدل قيم القيم الحرفية، مثلConnectionRuntimeUrl، بتعبير واحدparameters()، على سبيل المثال،@parameters('api-runtimeUrl'). في ملف connections.json، أنواع التعبير الصالحة الوحيدة هي @parameters@appsetting.

هام

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

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

{
   "serviceProviderConnections": {
      "serviceBus": {
         "parameterValues": {
            "connectionString": "@appsetting('serviceBus_connectionString')"
        },
        "serviceProvider": {
           "id": "/serviceProviders/serviceBus"
        },
        "displayName": "servicebus"
     }
   },
   "managedApiConnections": {
      "azureblob": {
         "api": {
            "id": "/subscriptions/@{appsetting('WORKFLOWS_SUBSCRIPTION_ID')}/providers/Microsoft.Web/locations/@{appsetting('WORKFLOWS_LOCATION_NAME')}/managedApis/azureblob"
         },
         "connection": {
            "id": "/subscriptions/@{appsetting('WORKFLOWS_SUBSCRIPTION_ID')}/resourceGroups/@{appsetting('WORKFLOWS_RESOURCE_GROUP_NAME')}/providers/Microsoft.Web/connections/azureblob"
         },
         "connectionRuntimeUrl": "@appsetting('BLOB_CONNECTION_RUNTIMEURL')",
         "authentication": "@parameters('blob_auth')"
      }
   }
}

ملاحظة

عندما يكون لديك تعبير تم شمله مع نص عادي، تأكد من استخدام التنسيق المستوفي القيم لهذا التعبير من خلال إحاطة هذا التعبير بأقواس متعرجة ({}). يساعد ذلك التنسيق في تجنب مشاكل التحليل.

على سبيل المثال، إذا كنت تمتلك "<text>/@<function-name>('<parameter-name>')/<text>"، فاستخدم الإصدار التالي بدلا من ذلك:"<text>/@{<function-name>('<parameter-name>')}/<text>".

لمزيد من المعلومات، راجع اعتبارات استخدام الوظائف.

إدارة الملفات المتعلقة بالمعلمات

في العادة تحتاج لإدارة إصدارات متعددة من ملفات المعلمات. قد تمتلك قيم مستهدفة لبيئات التوزيع المختلفة، مثل التطوير والاختبار والإنتاج. غالباً ما تعمل إدارة ملفات المعلمات هذه كإدارة ملفات معلمات قالب ARM. عند التوزيع لبيئة معينة، تقوم بترقية ملف المعلمات المطابق، بشكل عام من خلال مسار لـ DevOps.

لاستبدال ملفات المعلمات ديناميكيًا باستخدام Azure CLI، قم بتشغيل الأمر الأتي:

az functionapp deploy --resource-group MyResourceGroup --name MyLogicApp --src-path C:\parameters.json --type static --target-path parameters.json

إذا كنت تمتلك مشروع تطبيق منطق يستند إلى NuGet، فيجب عليك تحديث ملف المشروع (<logic-app-name>.csproj) لتضمين ملف المعلمات في إخراج البنية، على سبيل المثال:

<ItemGroup>
  <None Update="parameters.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
</ItemGroup>

ملاحظة

لا تتوفر حالياً إمكانية استبدال ملفات المعلمات ديناميكيا في مدخل Microsoft Azure أو مصمم سير العمل.

لمزيد من المعلومات بشأن إعداد تطبيقات المنطق الخاصة بك لتوزيع DevOps، راجع الوثائق التالية:

• نظرة عامة على توزيع DevOps لتطبيقات المنطق المستندة إلى المستأجر الفردي
• قم بإعداد توزيع DevOps للتطبيقات المنطقية المستندة إلى المستأجر الفردي

إدارة إعدادات التطبيق

تحتوي إعدادات التطبيق على خيارات التكوينالعمومية لكافة المهام المتعلقة بسير العملفي نفس مورد تطبيق المنطق. عند تشغيل مهام سير العمل محلياً في Visual Studio Code، فيمكنك الوصول إلى إعدادات التطبيق هذه كمتغيرات بيئة محلية في الملفlocal.settings.json. يمكنك بعد ذلك الرجوع إلى إعدادات التطبيق هذه في معلماتك.

لإضافة إعدادات التطبيق أو تحديثها أو حذفها، حدد الأقسام الآتية وراجعها لقالب Visual Studio Code أو مدخل Microsoft Azure أو Azure CLI أو ARM (Bicep).

مدخل Azure

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

1. في مدخل Microsoft Azure، قم بفتح مورد التطبيق المنطقي.

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

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

4. لعرض جميع القيم، قم بتحديد إظهار القيم. أو، لعرض قيمة واحدة، قم بتحديد تلك القيمة.

لإضافة إعداد جديد، اتبع الخطوات الآتية:

1. في علامة التبويبApplication settings، ضمنApplication settings، قم بتحديدNew application setting.

2. بالنسبة لـالاسم، أدخلالمفتاحأو الاسم للإعداد الجديد.

3. بالنسبة بـالقيمة، أدخل قيمة الإعداد الجديد.

4. عندما تكون مستعدا لإنشاء زوج قيم المفاتيحالجديد، فقم بتحديدموافق.

   

5. عند الانتهاء، في شريط أدواتCORS، قم بتحديد حفظ.

Azure CLI

لمراجعة إعدادات التطبيق الجارية باستخدام Azure CLI، قم بتشغيل الأمر az logicapp config appsettings list. تأكد من أن الأمر يشمل--name -nالمعلمتين و--resource-group -g، على سبيل المثال:

az logicapp config appsettings list --name MyLogicApp --resource-group MyResourceGroup

لإضافة تحديث أو إعداد تطبيق باستخدام Azure CLI، قم بتشغيل الأمرaz logicapp config appsettings set. تأكد من أن الأمر يشمل المعلمتين --name nو--resource-group -g. على سبيل المثال، ينشئ الأمر التالي إعدادا بمفتاح يسمى CUSTOM_LOGIC_APP_SETTINGباستخدام قيمة12345:

az logicapp config appsettings set --name MyLogicApp --resource-group MyResourceGroup --settings CUSTOM_LOGIC_APP_SETTING=12345 

Azure Resource Manager أو قالب Bicep

لمراجعة إعدادات التطبيق وتحديدها في قالب ARM أو قالب Bicep، ابحث عن تعريف مورد تطبيق المنطق الخاص بك، وقم بتحديث العنصر appSettingsJSON. للحصول على تعريف المورد الكامل، انظرمرجع قالب ARM.

يقوم هذا المثال بتوضيح إعدادات الملفات إما لقوالب ARM أو قوالب Bicep:

"appSettings": [
    {
        "name": "string",
        "value": "string"
    },
    {
        "name": "string",
        "value": "string"
    },
    <...>
], 

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

• مُستأجر أحادي مقابل مستأجرين متعددين وبيئة خدمة التكامل لـ Azure Logic Apps