Функция Choices
Применимо к:
приложениям на основе холста приложениям на основе модели
Возвращает таблицу из возможных значений для столбца подстановки.
Description
Функция Choices возвращает таблицу из возможных значений для столбца подстановки.
Используйте функцию Choices для получения списка вариантов для пользователей. Эта функция обычно используется с элементом управления Combo box в формах редактирования.
В рамках подстановки таблица, которую возвращает функция Choices, соответствует внешней таблице, связанной с подстановкой. Если вы используете функцию Choices, вам не нужно добавлять внешнюю таблицу в качестве дополнительного источника данных. Choices возвращает все столбцы внешней таблицы.
Так как функция Choices возвращает таблицу, вы можете использовать Filter, Sort, AddColumns и остальные функции обработки таблицы для фильтрации, сортировки и формирования таблицы.
В настоящее время вы не можете делегировать функцию Choices. Если это ограничение создает в вашем приложении проблему, добавьте внешнюю таблицу в качестве источника данных и используйте ее напрямую.
Choices не требует, чтобы имена столбцов были строками, заключенными в двойные кавычки, в отличие от ShowColumns, Search и других табличных функций. Укажите формулу, как если бы вы ссылались на столбец напрямую.
Ссылки на столбцы должны напрямую указывать на источник данных. Например, если источником данных является Accounts (Организации), а подстановкой — 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. Если указана пустая строка, будут возвращены все варианты.
Примеры
Choices для подстановки
Создайте базу данных в Dataverse и выберите пункт Включить примеры приложений и данные.
Создается множество таблиц, таких как Accounts.
Примечание. Названия таблиц имеют единственное число на make.powerapps.com и множественное число в Power Apps Studio.
У таблицы Accounts есть столбец Основное контактное лицо, который является уточняющим запросом к таблице Contacts.
Для каждой организации одно контактное лицо используется в качестве основного или основное контактное лицо является пустым.
Создайте приложение из таблицы Accounts.
В списке экранов и элементов управления у левого края прокрутите вниз до пункта EditScreen1 и выберите EditForm1 под ним.
На вкладке Свойства на правой панели выберите Изменить поля.
На панели Поля выберите + Добавить поле.
Найдите поле Основной контакт, выберите флажок, затем выберите Добавить.
Поле Основной контакт появляется внизу формы. Если в поле отображается ошибка, выберите Источники данных на вкладке Вид, выберите многоточие (...) для источника данных Организации, затем выберите Обновить.
(Необязательно) Перетащите поле Основное контактное лицо снизу вверх в списке полей.
В карточке Основное контактное лицо выберите элемент управления Combo box.
Свойство Items этого элемента управления устанавливается в формулу, которая идентифицирует столбец либо по его отображаемому имени, как в первом примере, либо по его логическому имени, как во втором примере:
Choices( Accounts.'Primary Contact' )
Choices( Accounts.primarycontactid )
В целях иллюстрации мы можем просмотреть полную таблицу, возвращенную функцией Choices в элементе управления Data table. На вкладке Главная выберите Создать экран, а затем — Пустой.
На вкладке Вставка выберите Data table.
Задайте для свойства Items элемента управления Data table следующую формулу:
Choices( Accounts.'Primary Contact' )
В середине элемента управления Data table выберите ссылку, которая начинается со слов Выберите поля..., затем установите флажки для поля или полей, которые вы хотите показать (например, firstname и lastname).
