نظرة عامة حول متغيرات البيئة

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

ملاحظة

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

فوائد استخدام متغيرات البيئة:

• توفير قيم معلمات جديدة أثناء استيراد الحلول إلى بيئات أخرى.
• قم تخزين التكوين لـ مصادر البيانات المستخدمة في تطبيقات اللوحة والتدفقات. على سبيل المثال، يمكن تخزين موقع SharePoint Online ومعلمات القوائم كمتغيرات البيئة ؛ لذلك يسمح لك بالاتصال بمواقع وقوائم مختلفة في بيئات مختلفة دون الحاجة إلى تعديل التطبيقات والتدفقات.
• قم بحزمة التخصيص والتكوين ونقلهما معا وإدارتها في موقع واحد.
• أسرار الحزم والنقل، مثل بيانات الاعتماد التي تستخدمها المكونات المختلفة، بشكل منفصل عن المكونات التي تستخدمها.
• يمكن استخدام متغير بيئة واحد عبر العديد من مكونات الحلول المختلفة - سواء كانت من نفس نوع المكون أو مختلفة. على سبيل المثال، قد يستخدم تطبيق اللوحة والتدفق متغير البيئة نفسه. عندما تحتاج قيمة متغير البيئة إلى تغيير، ستحتاج فقط إلى تغيير قيمة واحدة.
• بالإضافة إلى ذلك، إذا كنت تحتاج إلى مصدر البيانات بيئة عمل في بيئات الإنتاج، يمكنك ببساطة تحديث قيم متغير البيئة بمعلومات لبيئة الإنتاج مصدر البيانات. لا تتطلب التطبيقات والتدفقات تعديلا وستبدأ استخدام التطبيقات مصدر البيانات.
• أدوات مدعمة بواسطة SolutionPackager وDevOps لتمكين التكامل المستمر والتسليم المستمر (CI/CD).
• يمكن فك حزم متغيرات البيئة وتخزينها في عنصر التحكم المصدر. يمكنك أيضا تخزين ملفات قيم متغيرات البيئة المختلفة لتكوين منفصل مطلوب في بيئات مختلفة. ويمكن لمحزم الحلول بعد ذلك قبول الملف المقابل للبيئة التي سيتم استيراد الحل إلىها.

كيف تعمل؟

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

إنشاء متغير بيئة في حل

1. قم بتسجيل الدخول إلى Power Apps ‏(make.powerapps.com)، ثم على الجزء الأيسر، حدد الحلول.
2. افتح الحل الذي تريده أو قم بإنشاء حل جديد.
3. على شريط الأوامر، حدد جديد > المزيد، ثم حدد متغير البيئة.
4. في الجزء الأيسر، أكمل الأعمدة التالية، ثم حدد حفظ:

   • الاسم المعروض. أدخل اسمًا لمتغير البيئة.

   • الاسم. يتم إنشاء الاسم الفريد تلقائيًا من الاسم المعروض، ولكن يمكنك تغييره.

   • نوع البيانات. حدد من الرقم العشري, Text, JSON, Two options, Data source, or Secret.

     ملاحظة

     • إذا كان مصدر البيانات هو النوع المحدد، فستحتاج أيضًا إلى تحديد موصل، اتصال صالح للموصل المحدد، و نوع المعلمة. بالنسبة لمعلمات معينة مثل قوائم SharePoint، ستحتاج أيضًا إلى تحديد متغير بيئة مصدر بيانات أصل مثل موقع SharePoint. وبمجرد حفظها، سيتم حفظها في قاعدة البيانات.

     • إذا كان السر هو النوع المحدد، يلزم توفير معلومات إضافية لإعداد مخزن Azure الرئيسي وتكوينه للسماح لـ Power Platform بالوصول إلى السر.

   • Current Value. و تعرف أيضا باسم القيمة. هذه الخاصية اختيارية وهي جزء من جدول قيمة متغير البيئة. وعندما تكون هناك قيمة موجودة، سيتم استخدامها، حتى وإن كانت هناك قيمة افتراضية موجودة أيضا. قم بإزالة القيمة من الحل في حالة عدم الرغبة في استخدامه في البيئة التالية. كما يتم فصل القيم إلى ملفات JSON منفصلة داخل الملف zip. الذي تم تصديره، ويمكن تحريرها دون اتصال. مزيد من المعلومات: كيف يمكنني إزالة قيمة من متغير البيئة؟

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

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

     

     ملاحظة

     لا يمكن وجود قيمة دون تحديد. تسمح الواجهة بإنشاء قيمة واحدة فقط لكل تحديد.

استخدام مصدر البيانات البيئة في تطبيقات اللوحة

استخدام متغيرات بيئة مصدر البيانات الموجودة مسبقًا

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

1. اتبع الخطوات أعلاه لإنشاء متغير بيئة في حل.
2. تحرير تطبيق لوحة أو إنشائه من حلك.
3. أضف مصدر بيانات جديد لـ SharePoint online.
4. حدد علامة التبويب خيارات متقدمة. سوف تشاهد قائمة مصفاة من متغيرات البيئة التي يمكنك الوصول إليها والمطابقة للمعلمة التي تم تعيينها. على سبيل المثال، عند تحديد موقع SharePoint، ستشاهد قائمة بجميع متغيرات بيئة مصدر البيانات باستخدام الموصل = SharePoint و نوع المعلمة = الموقع. وهذا صحيح أيضا عند تحديد قوائم SharePoint لموقع محدد.
5. حدد متغيرات البيئة المطلوبة، ثم قم بتحديد اتصال.

هام

في حالة تحديد متغير بيئة من حل مختلف، ستكون هناك تبعية موجودة على الحل الذي يحتوي على متغير البيئة. لذا، تأكد من أي منهما:

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

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

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

1. تحرير تطبيق لوحة أو إنشائه من حلك.
2. حدد الإعدادات > عام ومكّن الإعداد إلى إنشاء متغيرات البيئة بشكل تلقائي عند إضافة مصادر البيانات.
3. أضف مصدر بيانات جديد لـ SharePoint online.
4. حدد SharePoint موقع، و قائمة واحدة أو أكثر ثم اتصال.

   ملاحظة

   لمنع إنشاء متغيرات بيئة مكررة، سيطلب منك استخدام متغير البيئة الموجود عند تحديد التكرارات. يمكنك مسح خيار استخدام متغير البيئة الموجود عند الرغبة في إنشاء تكرار.

5. حدد حفظ.

ملاحظة

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

استخدام متغيرات البيئة في تدفقات سحابة حل Power Automate

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

1. تحرير أو إنشاء تدفق سحابي في حل.

2. في إجراء أو مشغل، حدد المعلمة التي ترغب في استخدامها لمتغير البيئة:

   أ. إذا كانت المعلمة تأخذ قيمة بسيطة، مثل سلسلة أو رقم، أدخل المعلمة.

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

3. حدد متغير البيئة المطلوب.

أدخل قيمًا جديدة أثناء استيراد الحلول

تتضمن واجهة استيراد الحلول الحديثة القدرة على إدخال قيم متغيرات البيئة. يؤدي هذا إلى تعيين خاصية القيمة على جدول environmentvariablevalue.

ملاحظة

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

الإعلامات

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

الأمان

الجدول environmentvariabledefinition هو مستخدم أو فريق مملوك. عند إنشاء تطبيق يستخدم متغيرات البيئة، تأكد من تعيين مستوى امتياز مناسب للمستخدمين لهذا الجدول. تم أخذ إذن جدول environmentvariablevalue من جدول environmentvariabledefinition الأصلي وبالتالي لا يتطلب امتيازات منفصلة. تم تضمين امتيازات جداول environmentvariabledefinition في "منشئ البيئة" وأدوار أمان المستخدم الأساسي بشكل افتراضي. لمزيد من المعلومات: الأمان في Dataverse

التسمية

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

استخدام أسرار Azure Key Vault (إصدار أولي)

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

لا تتوفر متغيرات البيئة التي تشير إلى الأسرار حالياً من محدد المحتوى الديناميكي لاستخدامها في عمليات سير العمل.

تكوين مخزن Azure الرئيسي

لاستخدام أسرار مخزن Azure الرئيسي مع Power Platform، يجب أن يحتوي اشتراك Azure الذي يحتوي على المخزن على موفر موارد PowerPlatform المسجل ويجب أن يكون لدى المستخدم الذي أنشأ متغير البيئة الأذونات المناسبة لمورد مخزن Azure الرئيسي.

المتطلبات

1. قم بتسجيل موفر الموارد في Microsoft.PowerPlatform في اشتراك Azure الخاص بك. اتبع هذه الخطوات للتحقق من وتكوين: موفري الموارد وأنواع الموارد

   

2. أنشئ مخزن Azure الرئيسي. فكر في استخدام مخزن منفصل لكل بيئة Power Platform لتقليل التهديدات في حالة حدوث خرق. انتقل إلى أفضل الممارسات لاستخدام مخزن Azure الرئيسي لمزيد من المعلومات. لمزيد من المعلومات حول كيفية إنشاء مخزن رئيسي، انتقل إلى التشغيل السريع - إنشاء مخزن Azure الرئيسي مع مدخل Azure

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

   

4. يجب أن يشتمل مخزن Azure الرئيسي على سياسة الوصول إلى أسرار الحصول معيَّنة إلى خدمة Dataverse الأساسية. إذا لم تكن موجودة في هذا المخزن، فأضف سياسة وصول جديدة. حدد إضافة سياسة وصول، ثم حدد الحصول كسياسة وصول. بجوار تحديد أساسي، حدد تم تحديد بلا، ثم ابحث عن Dataverse. حدد خدمة Dataverse الأساسية باستخدام هوية 00000007-0000-0000-c000-000000000000، ثم حدد إضافة. بمجرد إضافة سياسة الوصول، يجب أن تكون مثل هذه.

   

5. إذا لم تكن قد قمت بذلك بالفعل، فأضف سرًا إلى المخزن الجديد. مزيد من المعلومات التشغيل السريع في Azure - تعيين واسترداد سر من المخزن الأساسي باستخدام مدخل Azure

إنشاء متغير بيئة جديد لسر المخزن الرئيسي

بمجرد تكوين مخزن Azure الرئيسي وتسجيل سر في المخزن، يمكنك الآن الرجوع إليه داخل Power Appsباستخدام متغير البيئة.

1. قم تسجيل الدخول إلى Power Apps، وفي منطقة الحلول، افتح الحل غير المُدار الذي تستخدمه للتطوير.

2. حدد جديد > المزيد > متغير البيئة.

3. قم بإدخال اسم عرض واختيارًا وصف لمتغير البيئة.

4. حدد نوع البيانات كـ سرt و مخزن أسرار باعتباره مخزن Azure الرئيسي.

5. حدد من الخيارات التالية:

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

6. أدخل المعلومات التالية:

   • معروف اشتراك Azure: معرف اشتراك Azure المقترن بالمخزن الرئيسي.
   • اسم مجموعة الموارد: مجموعة موارد Azure حيث يوجد المخزن الأساسي الذي يحتوي على السر.
   • اسم مخزن Azure الرئيسي: اسم المخزن الرئيسي الذي يحتوي على السر.
   • اسم السر: اسم السر الموجود في مخزن Azure الرئيسي.

   تلميح

   يمكن العثور على معرف الاشتراك واسم مجموعة الموارد واسم المخزن الرئيسي على صفحة النظرة العامة في مدخل Azure بالمخزن الأساسي. يمكن العثور على اسم السر على صفحة المخزن الرئيسي في مدخل Azure من خلال تحديد الأسرار ضمن الإعدادات.

7. حدد حفظ..

ملاحظة

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

• في الوقت الحالي، مخزن Azure الرئيسي هو مخزن الأسرار الوحيد الذي يتم دعمه مع متغيرات البيئة.

إنشاء تدفق Power Automate لاختبار سر متغير البيئة

هناك سيناريو بسيط يوضح كيفية استخدام سر تم الحصول عليها من مخزن Azure الرئيسي، وهو إنشاء تدفق Power Automate لاستخدام السر للمصادقة مقابل خدمة ويب.

ملاحظة

عنوان URI لخدمة الويب في هذا المثال ليس خدمة ويب عاملة.

1. قم بتسجيل الدخول إلى PowerApps، وحدد الحلول، ثم افتح الحل غير المدار الذي تريده.

2. حدد جديد > تشغيل تلقائي > تدفق السحابة > فوري.

3. أدخل اسمًا للتدفق، وحدد تشغيل تدفق يدويًا، ثم حدد إنشاء.

4. حدد خطوة جديدة، وحدد موصل Microsoft Dataverse، ثم في علامة التبويب الإجراءات، حدد تنفيذ إجراء غير مرتبط.

5. حدد الإجراء المسمى RetrieveEnvironmentVariableSecretValue من القائمة المنسدلة.

6. قم بتوفير اسم متغير البيئة الفريد (وليس اسم العرض) المضاف في القسم السابق، لهذا المثال new_TestSecret المستخدم.

7. حدد ... > إعادة تسمية لإعادة تسمية الإجراء بحيث يمكن الرجوع إليه بسهولة أكبر في الإجراء التالي. في لقطة الشاشة أدناه، تمت إعادة تسميته بـ GetSecret.

   

8. حدد ... > الإعدادات لعرض إعدادات إجراء GetSecret.

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

   

10. حدد خطوة جديدة، ثم ابحث عن موصل HTTP وحدده.

11. حدد الطريقة كـ GET وأدخل URI لخدمة الويب. في هذا المثال، يتم استخدام خدمة الويب الوهمية httpbin.org.

12. حدد إظهار الخيارات المتقدمة، وحدد المصادقة كـ أساسية، ثم أدخل اسم المستخدم.

13. حدد حقل كلمة المرور، ثم في علامة التبويب المحتوى الديناميكي ضمن اسم خطوة التدفق السابق (GetSecret في هذا المثال) حدد RetrieveEnvironmentVariableSecretValueResponse EnvironmentVariableSecretValue، الذي تتم إضافته بعد ذلك كتعبير outputs('GetSecretTest')?['body/EnvironmentVariableSecretValue'] أو body('GetSecretTest')['EnvironmentVariableSecretValue'].

    

14. حدد حفظ لإنشاء التدفق.

15. قم بتشغيل التدفق يدويًا لاختباره.

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

القيود الحالية

• إن SharePoint Online هو الحل مصدر البيانات مدعم لمتغيرات البيئة من نوع "مصدر البيانات" داخل تطبيقات اللوحة. ومع ذلك، سيتم تحديث موصل Dataverse قريبًا عندما يكون الاتصال مطلوبًا لبيئات Dataverse غير البيئة الحالية. يمكن استخدام أنواع أخرى من متغيرات البيئة داخل تطبيقات اللوحة عن طريق استردادها كما تريد تسجيل البيانات عبر اتصال Dataverse.
• إذا كنت تستخدم متغيرات البيئة لتخزين معلمات مصدر بيانات SharePoint في تطبيقات اللوحة، فتأكد من استخدام اسم العرض (بدلاً من الاسم المنطقي أو المعرف) عند استخدام أنواع الأعمدة "البحث" أو "شخص أو مجموعة".
• عندما يتم تغيير قيم متغير البيئة مباشرة داخل بيئة بدلا من خلال عملية ALM مثل استيراد الحل، سيستمر سير العمل باستخدام القيمة السابقة حتى يتم حفظ التدفق أو إيقاف تشغيله وتشغيله مرة أخرى.
• يحدث التحقق من صحة قيم متغير البيئة داخل واجهات المستخدم وضمن المكونات التي تستخدمها، وليس داخل Dataverse. لذا تأكد من تعيين القيم الملائمة إذا كان يتم تعديلها عبر التعليمات البرمجية.
• Power Platformمهام أدوات الإنشاء غير متوفرة بعد لإدارة مصدر البيانات البيئة. ومع ذلك، فإن ذلك لا يمنع استخدامها داخل الأدوات المتوفرة من Microsoft وضمن أنظمة التحكم المصدر.
• التفاعل مع متغيرات البيئة عبر التعليمة البرمجية المخصصة يتطلب استدعاء API لإحضار القيم؛ لا يوجد ذاكرة تخزين مؤقت تم كشفها للحصول على تعليمات برمجية من طرف 3 للاستفادة.
• عند تحرير سير مجموعة النظراء، لا يتم تصفية متغيرات البيئة المعروضة في محدد المحتوى الديناميكي، ولكن سيتم تصفيتها حسب نوع البيانات في المستقبل.
• عند تحرير تدفق مجموعة النظراء، إذا تم إضافة متغير بيئة في علامة تبويب مستعرض أخرى، فيحتاج سير العمل إلى إعادة فتحه في مصمم سير العمل لتحديث محدد المحتوى الديناميكي.

الأسئلة الشائعة

كيف يمكنني عرض مكان استخدام متغيرات البيئة؟

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

هل مصدر البيانات البيئة الحالية هي نفس متغيرات الاتصالات؟

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

هل مصدر البيانات استخدام متغيرات بيئة العمل مع الاتصالات المشتركة مثل SQL Server مع مصادقة SQL؟

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

تُستخدم متغيرات بيئة مصدر البيانات للموصلات التي تعتمد على المصادقة المستندة إلى المستخدم مثل Azure Active Directory لأنه لا يمكن اشتقاق المعلمات من الاتصال. لهذه الأسباب، لن تستخدم المصادقة مع SQL Server، وهو اتصال مشترك، مصدر البيانات متغيرات البيئة.

هل يمكن لتدفق ALM الآلي الخاص بي استخدام ملفات قيم مختلفة لبيئات مختلفة؟

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

ماذا لو قام شخص ما بحذف قيمة عن غير قصد؟

إذا لم يتم الاستخدام بالفعل من خلال نظام التبعيات، فإن وقت التشغيل سيستخدم آخر قيمة معروفة كقيمة إضافية.

إذا تم تغيير قيمة، متى يتم استخدام القيمة الجديدة في تطبيقات اللوحة والتدفق السحابي؟

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

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

هل التراخيص المتميزة مطلوبة؟

‏‏لا. بينما يتطلب ALM Dataverse (أو Dynamics 365 for Customer Engagement)، لا يتطلب الأمر استخدام الموصلات الممتازة. التحذير الوحيد هو إذا كنت تستخدم موصل Dataverse للتفاعل مع متغيرات البيئة كما تفعل مع سجلات البيانات الأخرى مثل الحسابات أو جهات الاتصال. في السابق، كانت هذه هي الطريقة الوحيدة لاستخدام متغيرات البيئة في تطبيقات اللوحة والتدفقات.

هل هناك حد لعدد متغيرات البيئة التي يمكنني الحصول عليها؟

لا. ومع ذلك، الحد الأقصى لحجم الحل هو 32 ميجابايت. راجع إنشاء حل

هل يمكن للأسماء والوصفات المتغيرة للبيئة أن تكون محلية؟

نعم.

هل يتعين علي استخدام متغيرات البيئة بدلا من تخزين بيانات التكوين في الجداول المخصصة؟

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

كيف يمكنني إزالة قيمة من متغير البيئة؟

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

لإزالة القيمة، اتبع الخطوات التالية:

1. في الحل حيث يوجد متغير البيئة، حدد متغير البيئة لعرض الخصائص.
2. ضمن القيمة الحالية، حدد ... > إزالة من هذا الحل.

هل يمكنني استخدام متغيرات البيئة في الموصلات المخصصة؟

نعم. دعم متغيرات البيئة في الموصلات المخصصة

(راجع أيضاً)

مدونة Power Apps: متغيرات البيئة المتوفرة في المعاينة!
جدول/مرجع كيان EnvironmentVariableDefinition
عينات واجهة API للويب
إنشاء تطبيق لوحة من البداية باستخدام Dataverse.
إنشاء تدفق باستخدام Dataverse
دعم متغيرات البيئة في الموصلات المخصصة

ملاحظة

هل يمكنك إخبارنا عن تفضيلات لغة التوثيق الخاصة بك؟ شارك في استطلاع قصير. (يرجى ملاحظة أن هذا الاستطلاع باللغة الإنجليزية)

سيستغرق الاستطلاع حوالي سبع دقائق. لا يتم جمع أي بيانات شخصية (بيان الخصوصية).