Функция Choices в Power Apps

Возвращает таблицу из возможных значений для столбца подстановки.

Описание

Функция Choices возвращает таблицу из возможных значений для столбца подстановки.

Используйте функцию Choices для получения списка вариантов для пользователей. Эта функция обычно используется с элементом управления поле со списком в формах редактирования.

В рамках подстановки таблица, которую возвращает функция 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 )

  • column-reference — обязательный аргумент. Столбец подстановки источника данных. Не заключайте имя столбца в двойные кавычки. Ссылайтесь напрямую на столбец источника данных, не используя функцию или элемент управления.

Примеры

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

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

    Создается множество таблиц, таких как Accounts.

    Примечание. Названия таблиц имеют единственное число на make.powerapps.com и множественное число в Power Apps Studio.

    Неполный список полей из таблицы Account в Dataverse для приложений, где выделен элемент "Основное контактное лицо" в качестве поля подстановки

    У таблицы Accounts есть столбец Основное контактное лицо, который является уточняющим запросом к таблице Contacts.

    Частичный список полей из таблицы Contact в Dataverse

    Для каждой организации одно контактное лицо используется в качестве основного или основное контактное лицо является пустым.

  2. Создайте приложение из таблицы Accounts.

  3. В списке экранов и элементов управления у левого края прокрутите вниз до пункта EditScreen1 и выберите EditForm1 под ним.

    На панели навигации слева выберите EditForm1 в EditScreen1

  4. На вкладке Свойства на правой панели выберите Изменить поля.

    Открытие области данных

  5. На панели Поля выберите + Добавить поле.

  6. Найдите поле Основной контакт, выберите флажок, затем выберите Добавить.

    Выберите "Организации", чтобы открыть область "Данные"

    Поле Основной контакт появляется внизу формы. Если в поле отображается ошибка, выберите Источники данных на вкладке Вид, выберите многоточие (...) для источника данных Организации, затем выберите Обновить.

  7. (Необязательно) Перетащите поле Основное контактное лицо снизу вверх в списке полей.

  8. В карточке Основное контактное лицо выберите элемент управления Combo box.

    Свойство Items этого элемента управления устанавливается в формулу, которая идентифицирует столбец либо по его отображаемому имени, как в первом примере, либо по его логическому имени, как во втором примере:

    • Choices( Accounts.'Primary Contact' )

    • Choices( Accounts.primarycontactid )

      Экран холста с элементом управления формы. Выбирается элемент управления Combo box с карточкой "Основное контактное лицо" и появляется свойство "Items" с формулой Choices( Accounts.'Primary Contact' )

  9. В целях иллюстрации мы можем просмотреть полную таблицу, возвращенную функцией Choices в элементе управления Data table. На вкладке Главная выберите Создать экран, а затем — Пустой.

  10. На вкладке Вставка выберите Data table.

  11. Задайте для свойства Items элемента управления Data table следующую формулу:

    Choices( Accounts.'Primary Contact' )

  12. В середине элемента управления Data table выберите ссылку, которая начинается со слов Выберите поля..., затем установите флажки для поля или полей, которые вы хотите показать (например, firstname и lastname).

    Экран холста с элементом управления таблицы данных. Для свойства Items задана формула Choices( Accounts.'Primary Contact' ), а таблица отображает столбцы firstname и lastname в качестве первого набора записей из таблицы Contacts