استخدام الإعدادات لتقديم تجارب تطبيق مخصصة

الإعدادات هي مكونات حل تمكّن المصنّعين والمسؤولين من تكوين التطبيقات بسرعة لتوفير تجربة مخصصة. يمكن استخدام الإعدادات لتمكين الميزات أو تعطيلها أو تكوين سلوك الميزة لتطبيق واحد أو جميع التطبيقات داخل بيئة ما.

تتكون الإعدادات من ثلاثة مكونات فرعية: تحديد التعريف وتعيين قيمة البيئة وتعيين قيمة التطبيق.

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

ملاحظة

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

تعريف الإعداد

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

الخاصية	الوصف
‏‫اسم العرض‬	الاسم المعروض للمستهلكين للإعداد في جميع واجهات المستخدم حيث يتم عرض الإعدادات.
الاسم	الاسم الفريد للإعداد في البيئة. يتم إنشاء الاسم تلقائيًا بناءً على اسم العرض المقدم ولكن يمكن تغييره قبل إنشاء الإعداد. بمجرد إنشاء الإعداد، لا يمكن تغيير الاسم لأنه قد تتم الإشارة إليه في التطبيقات أو التعليمات البرمجية. الاسم يحتوي على بائدة تتوافق مع ناشر الحل. تهدف هذه البادئة إلى إعطاء الإعداد اسمًا فريدًا إذا كنت تريد استيرادها إلى حل أو بيئة أخرى في المستقبل (والتي سيكون لها بادئة مختلفة).
‏‏الوصف	يساعد الوصف الآخرين في فهم الغرض من الإعداد المستخدم في جميع واجهات المستخدم حيث يتم عرض الإعدادات.
نوع البيانات	يتحكم نوع بيانات الإعداد في كيفية تخزين قيمة الإعداد. يمكن ضبط نوع البيانات على الرقم أو السلسلة أو نعم/لا. لا يمكن تغيير نوع البيانات بعد إنشاء الإعداد.
القيمة الافتراضية	تصبح القيمة الافتراضية متاحة بعد تحديد نوع نوع بيانات. إنها تحدد قيمة الإعداد التي سيتم استخدامها ما لم يتم تجاوزها بواسطة قيمة بيئة الإعداد أو قيمة تطبيق الإعداد.
يمكن تغيير القيمة من أجل	يمكن تجاوز الإعداد عند أحد المستويات التالية: البيئة والتطبيق، يسمحان لكل من قيمة بيئة الإعداد وتعيين قيم التطبيق لتجاوز القيمة الافتراضية. البيئة فقط، تسمح فقط لقيمة بيئة الإعداد لتجاوز القيمة الافتراضية. التطبيق فقط، يسمح فقط بتعيين قيم التطبيق لتجاوز القيمة الافتراضية. بلا، لا يمكن تجاوز الإعداد.
مستوى الإصدار	يتم استخدام مستوى الإصدار لإعلام إطار العمل والمستهلكين الآخرين بالإعداد حول حالة الميزة التي يتم استخدام الإعداد معها. يمكن تعيين مستوى الإصدار على متوفر بشكل عام أو الإصدار الأولي.
عنوان URL للمعلومات	رابط للوثائق لمساعدة مستهلكي الإعداد على فهم الغرض من الإعداد. سيتم استخدامه كارتباط معرفة المزيد في جميع واجهات المستخدم حيث يتم عرض الإعدادات.

إضافة تعريف إعداد جديد

1. قم بتسجيل الدخول إلى Power Apps.
2. في جزء التنقل، حدد الحلول. If the item isn’t in the side panel pane, select …More and then select the item you want.
3. من قائمة الحلول، افتح الحل الذي تريد إضافة الإعداد إليه.
4. في شريط الأوامر، حدد جديد > المزيد > الإعداد > تعريف الإعداد.
5. في مربع الحوار إعداد جديد، قدم قيمًا لكل خاصية بناءً على متطلباتك. للحصول على معلومات حول تعيين خصائص التعريف، انتقل إلى: تعريف الإعداد
6. عند الانتهاء من توفير القيم للخصائص، حدد حفظ.

إضافة تعريف الإعداد الحالي

1. قم بتسجيل الدخول إلى Power Apps.
2. في جزء التنقل، حدد الحلول. If the item isn’t in the side panel pane, select …More and then select the item you want.
3. من قائمة الحلول، افتح الحل الذي تريد إضافة الإعداد إليه.
4. في شريط الأوامر، حدد إضافة الموجود > المزيد > الإعداد.
5. في مربع الحوار إضافة تعريف الإعداد الحالي، حدد إعدادًا واحدًا أو أكثر تريد إضافته.
6. عند القيام بتحديد الإعدادات، حدد التالي
7. في مربع الحوار تعريف الإعداد المحدد، لكل إعداد قمت بتحديده، سيكون لديك خيار تضمين تعريف الإعداد. يمكنك أيضًا تضمين قيمة بيئة الإعداد لكل إعداد، إن وجد.
8. حدد إضافة لإضافة تعريف الإعداد و/أو تعيين قيم البيئة.

تحديث تعريف الإعداد

1. قم بتسجيل الدخول إلى Power Apps.
2. في جزء التنقل، حدد الحلول. If the item isn’t in the side panel pane, select …More and then select the item you want.
3. من قائمة الحلول، افتح الحل الذي أنشأت الإعداد فيه.
4. في طريقة عرض الشجرة، حدد الإعدادات > تعريفات الإعدادات.
5. حدد تعريف الإعداد الذي تريد تحديثه.
6. في مربع الحوار تحرير الإعداد، قم بتحديث القيم لأي من الخصائص التي تريد تغييرها.
   لاحظ أنه لا يمكن تحديث بعض الخصائص بعد إنشاء الإعداد. بالإضافة إلى ذلك، في معظم الحالات، لن تتمكن من تحديث تعريفات الإعدادات التي لا تملكها.
7. عند الانتهاء من تحديث قيم الخصائص، حدد حفظ.

إزالة تعريف الإعداد

1. قم بتسجيل الدخول إلى Power Apps.
2. في جزء التنقل، حدد الحلول. If the item isn’t in the side panel pane, select …More and then select the item you want.
3. من قائمة الحلول، افتح الحل الذي قمت بإنشائه أو أضف الإعداد إليه.
4. في طريقة عرض الشجرة، حدد الإعدادات > تعريفات الإعدادات.
5. حدد تعريف الإعداد الذي تريد إزالته.
6. في شريط الأوامر، حدد إزالة > إزالة من هذا الحل.
   إزالة من هذا الحليزيل تعريف الإعداد من الحل الحالي، لكنه سيظل جزءًا من الإعداد الافتراضي حل أو أي حل آخر تمت إضافته إليه.

حذف تعريف الإعداد

1. قم بتسجيل الدخول إلى Power Apps.
2. في جزء التنقل، حدد الحلول. If the item isn’t in the side panel pane, select …More and then select the item you want.
3. من قائمة الحلول، افتح الحل الذي قمت بإنشائه أو أضف الإعداد إليه.
4. في طريقة عرض الشجرة، حدد الإعدادات > تعريفات الإعدادات.
5. حدد تعريف الإعداد الذي تريد حذفه.
6. في شريط الأوامر، حدد إزالة > حذف من هذه البيئة.
   حذف من هذه البيئة يحذف تعريف الإعداد من البيئة الحالية ولن يعد جزءًا من أي حلول في تلك البيئة. يمكنك فقط حذف تعريفات الإعداد التي تمتلكها.

تعيين قيمة البيئة

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

إضافة قيمة بيئة الإعداد الجديدة

1. قم بتسجيل الدخول إلى Power Apps.

2. في جزء التنقل، حدد الحلول. If the item isn’t in the side panel pane, select …More and then select the item you want.

3. من قائمة الحلول، افتح الحل الذي تريد إضافة قيمة بيئة الإعداد إليه.

4. إذا كان تعريف الإعداد متوفرًا في الحل:

   1. حدد تعريف الإعداد.
   2. في مربع الحوار تحرير قيمة الإعداد، في قسم تعيين قيمة البيئة، حدد قيمة جديدة.
   3. أدخل القيمة، ثم حدد حفظ.

   إذا كان تعريف الإعداد غير متوفر في الحل:

   1. في شريط الأوامر، حدد جديد > المزيد > الإعداد > تعيين قيمة البيئة.
   2. حدد الإعداد الذي تريد إضافة قيمة بيئة الإعداد له، ثم حدد إضافة.
   3. في مربع الحوار تعيين قيمة بيئة جديدة، في قسم تعيين قيمة البيئة، حدد قيمة جديدة.
   4. أدخل القيمة، ثم حدد حفظ.

إضافة قيمة تعيين البيئة الجديدة

1. قم بتسجيل الدخول إلى Power Apps.

2. في جزء التنقل، حدد الحلول. If the item isn’t in the side panel pane, select …More and then select the item you want.

3. من قائمة الحلول، افتح الحل الذي تريد إضافة قيمة بيئة الإعداد إليه.

4. إذا كان تعريف الإعداد متوفرًا في الحل:

   1. حدد تعريف الإعداد.
   2. في مربع الحوار تحرير قيمة الإعداد، في قسم تعيين قيمة البيئة، حدد إضافة قيمة جديدة.
   3. قم بتحديث القيمة إذا لزم الأمر، ثم حدد حفظ.

   إذا كان تعريف الإعداد غير متوفر في الحل:

   1. في شريط الأوامر، حدد إضافة الموجود > المزيد > الإعداد.
   2. في مربع الحوار إضافة تعريف الإعداد الحالي، حدد إعدادًا واحدًا أو أكثر لإضافة قيم تعيين البيئة له.
   3. عند القيام بتحديد الإعدادات، حدد التالي
   4. في مربع الحوار تعريف الإعداد المحدد، لكل إعداد قمت بتحديده، سيكون لديك خيار تضمين قيمة تعيين البيئة، إن وُجدت قيمة. يمكنك أيضًا تضمين تعريف الإعداد لكل إعداد إذا أردت.
   5. حدد إضافة لإضافة قيم تعيين البيئة و/أو تعريفات الإعدادات.

تحديث قيمة تعيين البيئة

1. قم بتسجيل الدخول إلى Power Apps.
2. في جزء التنقل، حدد الحلول. If the item isn’t in the side panel pane, select …More and then select the item you want.
3. من قائمة الحلول، افتح الحل الذي أضفت إليه قيمة بيئة الإعدادات.
4. في طريقة عرض الشجرة، حدد الإعدادات > قيم تعيين البيئة.
5. حدد قيمة بيئة الإعداد التي تريد تحديثها.
6. في مربع الحوار تحرير الإعداد، في قسم تعيين قيمة البيئة، قم بتحديث القيمة، ثم حدد حفظ.

إزالة قيمة تعيين البيئة

1. قم بتسجيل الدخول إلى Power Apps.
2. في جزء التنقل، حدد الحلول. If the item isn’t in the side panel pane, select …More and then select the item you want.
3. من قائمة الحلول، افتح الحل الذي قمت بإنشائه أو أضف الإعداد إليه.
4. في طريقة عرض الشجرة، حدد الإعدادات > قيم تعيين البيئة.
5. حدد قيمة بيئة الإعداد التي تريد إزالتها.
6. في شريط الأوامر، حدد إزالة > إزالة من هذا الحل.
   إزالة من هذا الحليزيل قيمة تعيين البيئة من الحل الحالي، لكنه سيظل جزءًا من الإعداد الافتراضي حل أو أي حل آخر تمت إضافته إليه.

حذف قيمة تعيين البيئة

1. قم بتسجيل الدخول إلى Power Apps.
2. في جزء التنقل، حدد الحلول. If the item isn’t in the side panel pane, select …More and then select the item you want.
3. من قائمة الحلول، افتح الحل الذي قمت بإنشائه أو أضف الإعداد إليه.
4. في طريقة عرض الشجرة، حدد الإعدادات > قيم تعيين البيئة.
5. حدد قيمة بيئة الإعداد التي تريد حذفها.
6. في شريط الأوامر، حدد إزالة > حذف من هذه البيئة.
   حذف من هذه البيئة يحذف قيمة تعيين البيئة من البيئة الحالية ولن يعد جزءًا من أي حلول في تلك البيئة.

تعيين قيمة التطبيق

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

ملاحظة

لاتباع الخطوات المسرودة أدناه، ستحتاج إلى استخدام مصمم التطبيق الجديد. يعرض مصمم التطبيق حاليًا إعدادات النظام الأساسي لـ Power Apps فقط. بالنسبة للإعدادات غير المتعلقة بالنظام الأساسي، يرجى استخدام مستكشف الحلول كما هو موضح أدناه.

إضافة أو تحديث قيمة تطبيق الإعداد باستخدام مصمم التطبيق

1. افتح التطبيق الذي تريد إضافة قيمة تطبيق الإعداد له في مصمم التطبيق.
2. في شريط الأوامر، حدد الإعدادات.
3. في مربع الحوار الإعدادات، حدد علامة التبويب الميزات أو القادمة.
   تعرض علامة التبويب الميزات جميع الإعدادات التي تم تعيين مستوى الإصدار بها إلى متوفر بشكل عام. تعرض علامة التبويب القادمة جميع الإعدادات التي تم تعيين مستوى الإصدار بها إلى الإصدار الأولي.
4. قم بإضافة أو تحديث قيمة التطبيق للإعداد الذي تريده.
5. احفظ التطبيق وانشره.

حذف قيمة تطبيق الإعداد باستخدام مصمم التطبيق

1. افتح التطبيق الذي تريد إزالة قيمة تطبيق الإعداد له في مصمم التطبيق.
2. في شريط الأوامر، حدد الإعدادات.
3. في مربع الحوار الإعدادات، حدد علامة التبويب الميزات أو القادمة.
4. حدد إعادة التعيين إلى قيمة البيئة بجوار إعداد قيمة التطبيق الذي تريد حذفه. هذا يجعل قيمة الإعداد تعود إلى قيمة بيئة الإعداد إن وجدت. في حالة عدم وجود قيمة بيئة الإعداد، فسوف تعود إلى القيمة الافتراضية للإعداد.
   لاحظ أن الخيار إعادة التعيين إلى قيمة البيئة لا يتم عرضه إلا إذا تمت إضافة قيمة تطبيق الإعداد مسبقًا لهذا الإعداد.
5. احفظ التطبيق وانشره.

إضافة أو تحديث قيمة تطبيق الإعداد باستخدام مستكشف الحلول

1. قم بتسجيل الدخول إلى Power Apps.
2. في جزء التنقل، حدد الحلول. If the item isn’t in the side panel pane, select …More and then select the item you want.
3. من قائمة الحلول، افتح الحل الذي تريد إضافة قيمة تطبيق الإعداد إليه.
4. إذا لم يكن تعريف الإعداد أو إعداد قيمة البيئة متاحًا في الحل، فقم بإضافة أحدهما. انتقل إلى إضافة تعريف إعداد حالي أو إضافة قيمة تعيين بيئة حالية.
5. حدد تعريف الإعداد أو قيمة تعيين البيئة.
6. في مربع الحوار تحرير قيمة التعيين، في قسم تعيين قيم التطبيقات، ابحث عن التطبيق الذي تريد إضافة قيمة تطبيق الإعداد له. لاحظ أنه باستخدام مستكشف الحلول، يمكنك فقط إضافة تعيين قيم التطبيق للتطبيقات الموجودة في الحل الحالي.
7. أدخل القيمة وحدد حفظ.
8. لتفعيل قيمة تطبيق الإعداد، سيتعين عليك نشر التطبيق باستخدام مصمم التطبيق أو مستكشف الحلول.

حذف قيمة تطبيق الإعداد باستخدام مستكشف الحلول

1. قم بتسجيل الدخول إلى Power Apps.
2. في جزء التنقل، حدد الحلول. If the item isn’t in the side panel pane, select …More and then select the item you want.
3. من قائمة الحلول، افتح الحل الذي تريد حذف قيمة تطبيق الإعداد منه.
4. إذا لم يكن تعريف الإعداد أو إعداد قيمة البيئة متاحًا في الحل، فقم بإضافة أحدهما. مزيد من المعلومات: إضافة تعريف إعداد حالي أو إضافة قيمة تعيين بيئة حالية.
5. حدد تعريف الإعداد أو قيمة تعيين البيئة.
6. في مربع الحوار تحرير قيمة التعيين، في قسم تعيين قيم التطبيقات، ابحث عن التطبيق الذي تريد حذف قيمة تطبيق الإعداد له. لاحظ أنه باستخدام مستكشف الحلول، يمكنك فقط إزالة تعيين قيم التطبيق للتطبيقات الموجودة في الحل الحالي.
7. حدد ... بجوار تعيين قيمة التطبيق، ثم حدد إعادة تعيين إلى البيئة.
8. حدد حفظ..
9. لتفعيل حذف قيمة تطبيق الإعداد، سيتعين عليك نشر التطبيق باستخدام مصمم التطبيق أو مستكشف الحلول.

الحصول على أو تحديث قيمة الإعداد عن طريق التعليمات البرمجية

بالنسبة إلى الأساليب المتاح، انتقل إلى الحصول على قيمة الإعداد أو تحديثها باستخدام API للعميل.

(راجع أيضاً)

للمطورين:

• الدالة RetrieveSetting
• الإجراء SaveSettingValue