تخزين القيم وإدارتها باستخدام المتغيرات في تطبيقات Azure المنطقية

هل هذه الصفحة مفيدة؟

هل لديك ملاحظات إضافية؟

سيتم إرسال الملاحظات إلى Microsoft: بالضغط على الزر «إرسال»، سيتم استخدام ملاحظاتك لتحسين منتجات Microsoft وخدماتها. نهج الخصوصية.

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

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

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

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

هام

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

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

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

• تطبيق المنطق حيث تريد إنشاء المتغير

  إذا كنت جديدا على التطبيقات المنطقية، فراجع ما المقصود بتطبيقات Azure المنطقية؟والتشغيل السريع: أنشئ تطبيقك المنطقي الأول.

• مشغل كخطوة أولى في تطبيقك المنطقي

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

تهيئة المتغير

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

1. في مدخل Azure أو Visual Studio، افتح تطبيقك المنطقي في مصمم التطبيقات المنطقية.

   يستخدم هذا المثال مدخل Azure وتطبيقا منطقيا مع مشغل موجود.

2. في تطبيق المنطق، ضمن الخطوة التي تريد إضافة متغير إليها، اتبع إحدى الخطوات التالية:

   • لإضافة إجراء ضمن الخطوة الأخيرة، حدد خطوة جديدة.

     

   • لإضافة إجراء بين الخطوات، حرك الماوس فوق سهم الاتصال بحيث تظهر علامة الجمع (+) . حدد علامة الجمع، ثم حدد إضافة إجراء.

3. ضمن Choose an action، في مربع البحث، أدخل variables بصفته عامل تصفيتك. من قائمة الإجراءات، حدد تهيئة المتغير.

   

4. قدم هذه المعلومات حول المتغير الخاص بك كما هو موضح أدناه:

   الخاصية	مطلوب	القيمة	الوصف
   الاسم	نعم	<اسم المتغير>	اسم المتغير المراد زيادته
   النوع	نعم	<نوع متغير>	نوع البيانات للمتغير
   القيمة	لا	<قيمة البدء>	القيمة الأولية للمتغير الخاص بك نصيحة: على الرغم من أنها اختيارية، قم بتعيين هذه القيمة كأفضل ممارسة حتى تعرف دائما قيمة البدء للمتغير الخاص بك.

   على سبيل المثال:

   

5. الآن استمر في إضافة الإجراءات التي تريدها. عند الانتهاء، على شريط أدوات المصمم، حدد Save.

إذا قمت بالتبديل من المصمم إلى محرر عرض التعليمات البرمجية، فإليك الطريقة التي يظهر بها إجراء تهيئة المتغير في تعريف التطبيق المنطقي، وهو بتنسيق تدوين كائن جافا سكريبت (JSON):

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [ {
               "name": "Count",
               "type": "Integer",
               "value": 0
          } ]
      },
      "runAfter": {}
   }
},

ملاحظة

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

فيما يلي أمثلة لبعض أنواع المتغيرات الأخرى:

متغير السلسلة

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [ {
               "name": "myStringVariable",
               "type": "String",
               "value": "lorem ipsum"
          } ]
      },
      "runAfter": {}
   }
},

متغير منطقي

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [ {
               "name": "myBooleanVariable",
               "type": "Boolean",
               "value": false
          } ]
      },
      "runAfter": {}
   }
},

صفيف مع أعداد صحيحة

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [ {
               "name": "myArrayVariable",
               "type": "Array",
               "value": [1, 2, 3]
          } ]
      },
      "runAfter": {}
   }
},

صفيف مع سلاسل

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [ {
               "name": "myArrayVariable",
               "type": "Array",
               "value": ["red", "orange", "yellow"]
          } ]
      },
      "runAfter": {}
   }
},

الحصول على قيمة المتغير

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

على سبيل المثال، يحصل هذا التعبير على العناصر من متغير الصفيف الذي تم إنشاؤه مسبقا في هذه المقالة باستخدام الدالة variables() . ترجع string() الدالة محتويات المتغير بتنسيق سلسلة: "1, 2, 3, red"

@{string(variables('myArrayVariable'))}

متغير الزيادة

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

1. في مصمم تطبيقات المنطق، ضمن الخطوة التي تريد زيادة متغير موجود فيها، حدد خطوة جديدة.

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

   

   لإضافة إجراء بين الخطوات الموجودة، حرك الماوس فوق سهم الاتصال بحيث تظهر علامة الجمع (+). حدد علامة الجمع، ثم حدد إضافة إجراء.

2. في مربع البحث، أدخل "متغير الزيادة" كعامل تصفية خاص بك. في قائمة الإجراءات، حدد متغير زيادة.

   

3. قدم هذه المعلومات لزيادة المتغير:

   الخاصية	مطلوب	القيمة	الوصف
   الاسم	نعم	<اسم المتغير>	اسم المتغير المراد زيادته
   القيمة	لا	<زيادة القيمة>	القيمة المستخدمة لزيادة المتغير. القيمة الافتراضية هي واحدة. نصيحة: على الرغم من أنها اختيارية، يمكنك تعيين هذه القيمة كأفضل ممارسة حتى تعرف دائما القيمة المحددة لزيادة المتغير.

   على سبيل المثال:

   

4. عند الانتهاء، على شريط أدوات المصمم، حدد Save.

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

"actions": {
   "Increment_variable": {
      "type": "IncrementVariable",
      "inputs": {
         "name": "Count",
         "value": 1
      },
      "runAfter": {}
   }
},

مثال: إنشاء عداد حلقة

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

1. في مدخل Azure، قم بإنشاء تطبيق منطق فارغ. أضف مشغل يتحقق من وجود بريد إلكتروني جديد وأي مرفقات.

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

2. في المشغل، للتحقق من وجود مرفقات وتمرير هذه المرفقات إلى سير عمل تطبيق المنطق، حدد نعم لهذه الخصائص:

   • يحتوي على مرفق
   • تضمين المرفقات

   

3. أضف الإجراء تهيئة المتغير. إنشاء متغير عدد صحيح باسم يحتوي Count على قيمة بداية صفرية.

   

4. للتنقل بين كل مرفق، أضف علامة لكل حلقة.

   1. ضمن الإجراء تهيئة المتغير ، حدد خطوة جديدة.

   2. ضمن اختيار إجراء، حدد مضمن. في مربع البحث، أدخل for each كفلتر بحث، وحدد لكل منها.

      

5. في الحلقة، انقر داخل المربع تحديد إخراج من الخطوات السابقة . عند ظهور قائمة المحتوى الديناميكي، حدد المرفقات.

   

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

6. في لكل حلقة، حدد إضافة إجراء.

   

7. في مربع البحث، أدخل "متغير الزيادة" كعامل تصفية خاص بك. من قائمة الإجراءات، حدد متغير زيادة.

   ملاحظة

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

8. في الإجراء متغير زيادة ، من القائمة الاسم ، حدد متغير العدد .

   

9. ضمن الحلقة، أضف أي إجراء يرسل لك عدد المرفقات. في الإجراء الخاص بك، قم بتضمين القيمة من متغير العد ، على سبيل المثال:

   

10. حفظ تطبيق المنطق الخاص بك. في شريط أدوات المصمم، حدد "Save" .

اختبر تطبيق المنطق الخاص بك

1. إذا لم يتم تمكين تطبيقك المنطقي، فحدد نظرة عامة في قائمة التطبيق المنطقي. على شريط الأدوات، حدد تمكين.

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

3. أرسل بريدا إلكترونيا يحتوي على مرفق واحد أو أكثر إلى حساب البريد الإلكتروني الذي استخدمته في هذا المثال.

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

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

"actions": {
   "For_each": {
      "type": "Foreach",
      "actions": {
         "Increment_variable": {
           "type": "IncrementVariable",
            "inputs": {
               "name": "Count",
               "value": 1
            },
            "runAfter": {}
         }
      },
      "foreach": "@triggerBody()?['Attachments']",
      "runAfter": {
         "Initialize_variable": [ "Succeeded" ]
      }
   }
},

متغير التناقص

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

فيما يلي خصائص الإجراء المتغير التناقص :

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

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

"actions": {
   "Decrement_variable": {
      "type": "DecrementVariable",
      "inputs": {
         "name": "Count",
         "value": 1
      },
      "runAfter": {}
   }
},

تعيين متغير

لتعيين قيمة مختلفة لمتغير موجود، اتبع الخطوات الخاصة بزيادة متغير باستثناء أنك:

1. ابحث عن الإجراء تعيين المتغير وحدده بدلا من ذلك.

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

فيما يلي خصائص الإجراء تعيين المتغير :

الخاصية	مطلوب	القيمة	الوصف
الاسم	نعم	<اسم المتغير>	اسم المتغير المراد تغييره
القيمة	نعم	<قيمة جديدة>	القيمة التي تريد تعيين المتغير. يجب أن يكون لكل منهما نفس نوع البيانات.

ملاحظة

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

1. في الزاوية العلوية اليسرى من حلقاتك، حدد زر علامة الحذف (...)، ثم حدد الإعدادات.

2. ضمن التحكم في التزامن ، قم بتغيير الإعداد الافتراضي للتجاوز إلى تشغيل.

3. اسحب شريط تمرير درجة التوازي إلى 1.

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

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [ {
               "name": "Count",
               "type": "Integer",
               "value": 0
          } ]
      },
      "runAfter": {}
   },
   "Set_variable": {
      "type": "SetVariable",
      "inputs": {
         "name": "Count",
         "value": 100
      },
      "runAfter": {
         "Initialize_variable": [ "Succeeded" ]
      }
   }
},

إلحاق بالمتغير

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

1. ابحث عن أحد هذه الإجراءات وحدده استنادا إلى ما إذا كان المتغير عبارة عن سلسلة أو صفيف:

   • إلحاق متغير السلسلة
   • إلحاق متغير الصفيف

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

فيما يلي خصائص الإجراءات الملحقة ب ...

الخاصية	مطلوب	القيمة	الوصف
الاسم	نعم	<اسم المتغير>	اسم المتغير المراد تغييره
القيمة	نعم	<قيمة الإلحاق>	القيمة التي تريد إلحاقها، والتي يمكن أن تحتوي على أي نوع

إذا قمت بالتبديل من المصمم إلى محرر عرض التعليمات البرمجية، فإليك الطريقة التي يظهر بها إجراء متغير الإلحاق بالمصفوفة داخل تعريف التطبيق المنطقي، وهو بتنسيق JSON. ينشئ هذا المثال متغير صفيف، ويضيف قيمة أخرى كآخر عنصر في الصفيف. النتيجة هي متغير محدث يحتوي على هذه الصفيفة: [1,2,3,"red"]

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [ {
            "name": "myArrayVariable",
            "type": "Array",
            "value": [1, 2, 3]
         } ]
      },
      "runAfter": {}
   },
   "Append_to_array_variable": {
      "type": "AppendToArrayVariable",
      "inputs": {
         "name": "myArrayVariable",
         "value": "red"
      },
      "runAfter": {
        "Initialize_variable": [ "Succeeded" ]
      }
   }
},

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

• تعرف على موصلات التطبيقات المنطقية