Формирует список значений данных выбора при вводе по строке, автоподборе текста и быстром выборе. Если требуется выполнить поиск более 32 слов или 1000 символов, то свойство ОграничиватьСтрокуПоиска требуется установить в значение Ложь.
Синтаксис
ПолучитьДанныеВыбора(<Параметры>)Полное описание, параметры и ограничения
ПеречислениеМенеджер.<Имя перечисления>.ПолучитьДанныеВыбора (EnumManager.<Enumeration name>.GetChoiceData)
ПеречислениеМенеджер.<Имя перечисления> (EnumManager.<Enumeration name>)
ПолучитьДанныеВыбора (GetChoiceData)
Доступен, начиная с версии 8.2.
Синтаксис:
ПолучитьДанныеВыбора(<Параметры>)
Параметры:
<Параметры> (обязательный)
Тип: Структура.
Содержит параметры для формирования списка значений:
Структура, в которой обязательно должны содержаться следующие ключи:
Отбор (Filter) - отбор, используемый для поиска данных, тип Структура; значения элементов отбора могут иметь тип Массив, СписокЗначений, ФиксированныйМассив или иной тип, не являющийся коллекцией; для типов Массив, СписокЗначений, ФиксированныйМассив сравнение выполняется с видом сравнения ВСписке, иначе вид сравнения Равно;
СтрокаПоиска (SearchString) - содержит строку, используемую при поиске данных; для быстрого выбора содержит значение Неопределено.
Возвращаемое значение:
Тип: СписокЗначений.
Описание:
Формирует список значений данных выбора при вводе по строке, автоподборе текста и быстром выборе.
Если требуется выполнить поиск более 32 слов или 1000 символов, то свойство ОграничиватьСтрокуПоиска требуется установить в значение Ложь.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Вызов метода выполняет обращение к серверу.
Примечание:
Если в модуле менеджера в методе указано два параметра, то будет вызван метод ПолучитьДанныеВыбора глобального контекста.
Выполнение метода приводит к вызову события ОбработкаПолученияДанныхВыбора.
В режиме совместимости конфигурации Версия8_3_17 и ниже рекомендуется устанавливать свойство ОграничиватьСтрокуПоиска в значение Истина, чтобы при выполнении сложных запросов генерировалась ошибка.
Использование в версии:
Доступен, начиная с версии 8.2.
Описание изменено в версии 8.3.18.
Методическая информация
Практические примеры
Выбрать типизированный статус в полностью созданном поле формы
Список для выбора получаем от менеджера перечисления с обязательными параметрами. В реквизите формы хранится значение перечисления, не подпись.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
Создайте НОВУЮ пустую файловую учебную базу с именем корня конфигурации Учебная85. Не меняйте рабочие конфигурации ради этого примера.
Перечисления → Добавить: УчебныйСтатус, синоним Учебный статус. Значения в порядке Черновик, Готов, Отменен; синонимы соответственно Черновик, Готов к проверке, Отменён.
Модуль менеджера оставьте пустым, формы/макеты не добавляйте. Обновите конфигурацию базы данных.
Код без директив вставляется в тело ВыполнитьПример() Экспорт серверного общего модуля УчебныеЗадачи. Полный модуль формы вставляется отдельно по подготовке формы.
Создайте отдельную учебную внешнюю обработку с пустой управляемой основной формой. Каждую задачу запускайте в своей копии формы.
Не добавляйте вручную реквизит ЗначениеПримера, поле ПолеПримера и команду УчебноеДействие: их создаст код.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Вставьте весь модуль, включая клиентские и серверные процедуры.
Сохраните учебную EPF и откройте через Файл → Открыть в тонком или толстом клиенте Windows. Рабочие данные не читаются и не записываются.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Если Метаданные.Перечисления.Найти("УчебныйСтатус") = Неопределено Тогда
ВызватьИсключение "Подготовьте собственное перечисление УчебныйСтатус";
КонецЕсли;
Новые = Новый Массив;
ТипРеквизита = Новый ОписаниеТипов("ПеречислениеСсылка.УчебныйСтатус");
Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита));
ЭтаФорма.ИзменитьРеквизиты(Новые);
ЭтаФорма.ЗначениеПримера = Перечисления.УчебныйСтатус.Черновик;
Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеВвода;
Поле.ПутьКДанным = "ЗначениеПримера";
Поле.Заголовок = "Учебный статус";
Поле.КнопкаОчистки = Истина;
Поле.РежимВыбораИзСписка = Истина;
ПараметрыВыбора = Новый Структура("Отбор,СтрокаПоиска", Новый Структура, Неопределено);
Список = Перечисления.УчебныйСтатус.ПолучитьДанныеВыбора(ПараметрыВыбора);
Для Каждого Элемент Из Список Цикл
Поле.СписокВыбора.Добавить(Элемент.Значение, Элемент.Представление);
КонецЦикла;
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Проверить статус";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Если ЗначениеПримера.Пустая() Тогда
Сообщить("Учебный статус не выбран; ничего не записано.");
Возврат;
КонецЕсли;
Сообщить(ТипЗнч(ЗначениеПримера) = Тип("ПеречислениеСсылка.УчебныйСтатус"));
Сообщить(ЗначениеПримера = Перечисления.УчебныйСтатус.Готов);
Сообщить("Представление: " + Строка(ЗначениеПримера));
КонецПроцедуры
Разбор по шагам
До создания реквизита проверяем собственную учебную конфигурацию и наличие перечисления.
ПолучитьДанныеВыбора получает структуру с Отбор и СтрокаПоиска, даже когда поиск и отбор пустые.
СписокВыбора наполняем типизированными значениями и их представлениями. Начальное значение Черновик задано явно.
КнопкаОчистки возвращает пустое значение перечисления, которое обрабатывается отдельной веткой.
Проверяем тип и сравниваем с конкретным значением Готов, не с текстом подписи.
Как проверить результат
Выберите Готов к проверке: оба сравнения Истина, представление Готов к проверке.
Выберите Черновик: проверка типа Истина, сравнение с Готов Ложь — это ожидаемо.
Очистите поле: сообщение о невыбранном статусе, обращений к базе записи нет.
Ожидаемый результат
Рабочее поле выбора с реальным типом перечисления и корректной обработкой пустого состояния.
На что обратить внимание
Это не универсальная строковая выпадающая коллекция: реквизит имеет конкретный тип учебной конфигурации.
Представления списка могут зависеть от языка интерфейса.
Изменение поля относится только к памяти формы, не к статусам рабочих заказов.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.