Choices функція

Застосовується до: Програми Canvas Model-driven apps Power Pages

Повертає таблицю можливих значень для стовпця підстановки.

Опис

Функція Choices повертає таблицю можливих значень для стовпця підстановки.

Скористайтеся функцією Choices , щоб надати список варіантів вибору користувача. Ця функція зазвичай використовується разом з елементом керування Поле зі списком у формах редагування.

Для підстановки таблиця, яка Choices повертається, відповідає зовнішній таблиці, пов'язаній із підстановкою. Використовуючи Choices, потрібно додати зовнішню таблицю як додаткове джерело даних. Choices повертає всі стовпці зовнішньої таблиці.

Оскільки Choices повертає таблицю, для фільтрування, сортування та формування таблиці можна використовувати фільтр, сортування, додаванняколюмів та всі інші функції керування таблицями.

Наразі не можна делегуватиChoices. Якщо це обмеження є проблемою у програмі, додайте таблицю як джерело даних і використовувати її безпосередньо.

Choices не вимагає, щоб імена стовпців були рядками та взяті в подвійні лапки, на відміну від функцій ShowColumns, Search та інших таблиць. Укажіть формулу, ніби ви напряму посилаєтеся на стовпець.

Посилання на стовпці мають відноситися безпосередньо до джерела даних. Наприклад, якщо джерелом даних є Бізнес-партнери, а підстановкою – SLA, посиланням на стовпець буде Accounts.SLA. Посилання не може проходити через функцію, змінну або елемент керування. Продовжуючи цей приклад, якщо Бізнес-партнери подаються до елемента керування Галерея, використайте формулу Gallery.Selected.SLA, щоб забезпечити посилання на SLA для вибраного бізнес-партнера. Однак це посилання пройшло через елемент керування, тому його неможливо передати до функції Columns – значить усе ще потрібно скористатися Accounts.SLA.

Наразі стовпці підстановки можна використовувати тільки з SharePoint і Microsoft Dataverse.

Синтаксис

Choices( посилання на стовпець [, текстовий фільтр ] )

• column-reference - Обов’язковий. Стовпець підстановки джерела даних. Не потрібно брати ім’я стовпця в подвійні лапки. Посилання має відноситися безпосередньо до стовпця джерела даних і не проходити через функцію або елемент керування.
• text-filter - Необов’язковий. Фільтрує список варіантів, повертаючи лише варіанти, які починаються з тексту, вказаного у text-filter. Якщо вказано порожній рядок, буде повернуто всі варіанти.

Приклади

Choices для підстановки

1. Створіть базу даних і Dataverse виберіть поле Включити зразки програм і даних .

   Створюються багато таблиць, наприклад Бізнес-партнери.

   Примітка: Назви таблиць вживаються в однині на make.powerapps.com та у множині в. Power Apps Studio

   

   Таблиця Бізнес-партнери має стовпець Основна контактна особа, з якої здійснюється підстановка до таблиці Контактні особи.

   

   Для кожного бізнес-партнера контактна особа визначається як основна контактна особа, або ж основна контактна особа залишається пустою.

2. Згенеруйте програму з таблиці Облікові записи .

3. У списку екранів і елементів керування біля лівого краю прокручуйте вниз, доки не з’явиться розділ EditScreen1, а потім виберіть розташований під ним елемент EditForm1.

   

4. На вкладці Властивості в області праворуч виберіть елемент Редагувати поля.

   

5. В області Поля виберіть елемент Додати поле.

6. Знайдіть поле Основна контактна особа, установіть його прапорець і натисніть кнопку Додати.

   

   У нижній частині форми з’явиться поле Основна контактна особа. Якщо поле показує помилку, виберіть Джерела даних на вкладці Подання, клацніть три крапки (...) поруч із джерелом даних Бізнес-партнери, а потім натисніть Оновити.

7. (Необов’язково) Перетягніть поле Основна контактна особа з нижньої частини списку полів до верхньої.

8. У картці для основної контактної особи виберіть елемент керування Поле зі списком.

   Властивість Items цього елемента керування настроюється відповідно до формули, що визначає стовпець за його коротким ім’ям (як у першому прикладі) або за його логічним ім’ям (як у другому прикладі):

   • Choices( Облікові записи.'Основний контакт' )

   • Choices( Accounts.primarycontactid )

     

9. Для ілюстрації ми можемо переглянути повну таблицю, повернуту функцією Choices , в елементі керування таблицями даних . На вкладці Головна виберіть Новий екран, а потім – елемент Пустий.

10. На вкладці Вставка виберіть елемент Таблиця даних.

11. Настройте властивість Items елемента керування Таблиця даних відповідно до нижчезазначеної формули.

    Choices( Облікові записи.'Основний контакт' )

12. У центрі елемента керування Таблиця даних виберіть посилання, що починається фразою Виберіть поля..., а потім установіть прапорці поруч із полем або полями, які потрібно відобразити (наприклад, firstname і lastname).