الدالة Choices

ينطبق على: تطبيقات اللوحة التطبيقات المستندة إلى النموذج

ترجع Choices جدول بالقيم المحتملة لعمود بحث.

الوصف

ترجع الدالة Choices جدول بالقيم المحتملة لعمود بحث.

استخدم دالة Choices لتوفير قائمة من الخيارات الخاصة بالمستخدم للاختيار من بينها. تستخدم هذه الدالة بشكل شائع مع عنصر تحكم Combo box في نماذج التحرير.

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

نظرا لأن Choices ترجع جدولا، يمكنك استخدام Filter وSort وAddColumns، وكافة دالات معالجة الجداول الأخرى لتصفية الجدول، وفرزه، وتشكيله.

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

لا تتطلب Choices أسماء الأعمدة التي ستكون سلاسل ومحاطة بعلامات اقتباس مزدوجة، بخلاف ShowColumns، وSearch ودالات الجدول الأخرى. قم بتقديم الصيغة كما لو كنت تشير إلى العمود مباشرة.

يجب أن تشير مراجع العمود مباشرة إلى مصدر البيانات. علي سبيل المثال ، إذا كان المصدر البيانات هو الحساباتوكان البحث هو SLA، فان مرجع العمود سيكون " Accounts.SLA. لا يمكن ان يمر المرجع من خلال دالة أو متغير أو عنصر تحكم. بالإضافة إلى هذا المثال، إذا كانت Accounts تمت تغذيها إلى عنصر تحكم Gallery، استخدم الصيغة Gallery.Selected.SLAللرجوع إلى اتفاقية مستوى الخدمة للحساب المحدد. ومع ذلك ، يمر هذا المرجع من خلال عنصر تحكم، لذلك لا يمكن تمريره إلى دالة Columns - يجب أن تكون قادرًا على استخدام Accounts.SLA.

وفي هذا الوقت، يمكنك استخدام أعمدة البحث فقط مع SharePoint وMicrosoft Dataverse.

بناء الجملة

Choices( column-reference [, text-filter ] )

• column-reference - مطلوب. عمود بحث لمصدر البيانات. لا تقم بإحاطة اسم العمود بعلامات اقتباس مزدوجة. يجب أن يكون المرجع مباشرة إلى عمود مصدر البيانات ولا يمر خلال دالة أو عنصر تحكم.
• text-filter - اختياري. تصفية قائمة الاختيارات من خلال إرجاع فقط الاختيارات التي تبدأ بالنص المحدد في text-filter. إذا تم تحديد سلسلة فارغة، فسيتم إرجاع كافة الخيارات.

الأمثلة

خيارات للبحث

1. قم بإنشاء قاعده بيانات في Dataverse ، وحدد المربع تضمين نماذج التطبيقات والبيانات.

   يتم إنشاء العديد من الجداول، مثل الحسابات.

   ملاحظة: تكون أسماء الجدول مفردة في make.powerapps.com وجمع في Power Apps Studio.

   

   يحتوي جدول الحسابات على عمود جهة الاتصال الرئيسية وهو بحث في جدول جهات الاتصال.

   

   بالنسبة لكل عميل، يتم تعيين جهة الاتصال على أنها جهة الاتصال الرئيسية، أو تكون جهة الاتصال blank.

2. أنشئ تطبيقًا من جدول الحسابات.

3. في قائمة الشاشات وعناصر التحكم بالقرب من الحافة اليسرى، قم بالتمرير لأسفل حتى يظهر EditScreen1، ثم حدد EditForm1 أسفله تمامًا.

   

4. في جزء الخصائص على اليمين، قم بتحديد تحرير الحقول.

   

5. في جزء الحقول، حدد إضافة حقل.

6. ابحث عن الحقل جهة الاتصال الرئيسية، وحدد خانة الاختيار الخاصة به، ثم حدد إضافة.

   

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

7. (اختياري) اسحب الحقل جهة الاتصال الرئيسية من الأسفل إلى أعلى قائمة الحقول.

8. في بطاقة جهة الاتصال الرئيسية، حدد عنصر التحكم Combo box.

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

   • Choices( Accounts.'Primary Contact' )

   • Choices( Accounts.primarycontactid )

     

9. لأغراض توضيحية، يمكننا عرض الجدول بالكامل الذي تم إرجاعه بواسطة دالة Choicesفي عنصر تحكم Data table. في علامة التبويب الصفحة الرئيسية، حدد شاشة جديدة، ثم حددفارغة.

10. في علامة التبويب إدراج، حددData table.

11. قم بتعيين خاصية Items عنصر التحكم Data table لهذه الصيغة:

    Choices( Accounts.'Primary Contact' )

12. في وسط عنصر تحكم Data table، حدد الارتباط الذي يبدأ اختيار الحقول...، ثم حدد خانات الاختيار الخاصة بالحقل أو الحقول التي ترغب في عرضها (علي سبيل المثال، الاسم الأول والاسم الأخير).