متغيرَات البيئة

مكتمل

عند إنشَاء تدفقَات سَحَابة Power Automate، فإنه من الشَائع أن يكون لديك القيم التي تحَدِّدهَا عَلى خطوات السير عمل الخَاصة بالبيئة التي يتم تَطبِيق السير عمل فيهَا. على سَبِيل المِثَال، قد تشير إجرَاءَات السير عمل إلى اسم المستند، أو URL الخدمة الخَارجية، أو عنوان البريد الإلكتروني للإخطَارَات التي يمكن أن تختلف بين البيئات، مثل التطوير والاختبار والإنتَاج.

تسمح متغيرَات البيئة بالتعريف المنفصل وإعدَاد تلك القيم من تعريف سير عمل السَحَابة. ثم يمكن أن يكون لمتغير البيئة قيمة مختلفة فِي كل بيئة يتم فيهَا نشر سير عمل السَحَابة. كمَا يمكن لموارد Microsoft Power Platform الأخرى، مثل Power Apps أو المُوصِّلِات المخصصة، استخدَام متغيرَات البيئة. بَعد أن تم تعريف قيم متغيرَات البيئة، يمكن لتدفقَات السَحَابة استبدَال المحتوى المشفر بقيم متغيرَات البيئة، بشكل مشَابه لكيفية استخدَام المحتوى الحيوي الآخر.

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

يمكنك إنشَاء متغيرَات البيئة فِي أحد الحلول عَن طريق تحديد إضَافة جَدِيد‎ > مزيد > متغير البيئة. تظهر الصورة التَالِية مثَال لإنشَاء متغير Error Notification Email.

لَقطَة شَاشة لإنشَاء متغير بيئة جَدِيد‎.

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

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

لَقطَة شَاشة للقيمة الافترَاضية لمتغير البيئة.

يمكنك أيضًا توفير القيمة الحَالية للبيئة. على سَبِيل المِثَال، فِي التطوير، قد يتم استخدَام الاسم المستعار DevTeam.

لَقطَة شَاشة للقيمة الحَالية لمتغير البيئة.

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

لَقطَة شَاشة لإزَالة القيمة الحَالية من أحد الحلول.

متغيرَات بيئة مصدر البيَانَات

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

لَقطَة شَاشة لإعدَاد متغير بيئة مصدر بيَانَات.

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

يتم تصميم نَوع البيَانَات الخَاصة بـ السر للرجوع إلى الأسرَار المخزنة فِي مخزن Microsoft Azure الرئيسي. ويتطلب هذَا النَوع من المتغيرَات إعدَاد آخر. لمزيد من المعلومَات، رَاجع استخدَام أسرَار مخزن Azure الرئيسي. تسَاعد متغيرَات البيئة السرية فِي منع عرض المعلومَات الحسَاسة عَن طريق الخطأ للمستخدمين أو فِي تَاريخ تشغيل التدفق.

استخدَام متغيرَات البيئة

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

لَقطَة شَاشة لمتغير بيئة فِي خطوة إجرَاء لاستبدَال القيمة المشفرة.

يمكنك أيضًا استخدَام تعبير المعلمَات للحُصُول عَلى القيمة. على سَبِيل المِثَال، سَوفَ تتمكن ممَا يلي parameters('contoso_ErrorNotificationEmail') باستردَاد نفس القيمة.