ПеречислениеМенеджер.<Имя перечисления>.ПолучитьДанныеВыбора

Методы · GetChoiceData

Формирует список значений данных выбора при вводе по строке, автоподборе текста и быстром выборе. Если требуется выполнить поиск более 32 слов или 1000 символов, то свойство ОграничиватьСтрокуПоиска требуется установить в значение Ложь.

Синтаксис

ПолучитьДанныеВыбора(<Параметры>)
Полное описание, параметры и ограничения

ПеречислениеМенеджер.<Имя перечисления>.ПолучитьДанныеВыбора (EnumManager.<Enumeration name>.GetChoiceData)

ПеречислениеМенеджер.<Имя перечисления> (EnumManager.<Enumeration name>)

ПолучитьДанныеВыбора (GetChoiceData)

Доступен, начиная с версии 8.2.

Синтаксис:
ПолучитьДанныеВыбора(<Параметры>)
Параметры:

<Параметры> (обязательный)
Тип: Структура.
Содержит параметры для формирования списка значений:
Структура, в которой обязательно должны содержаться следующие ключи:
Отбор (Filter) - отбор, используемый для поиска данных, тип Структура; значения элементов отбора могут иметь тип Массив, СписокЗначений, ФиксированныйМассив или иной тип, не являющийся коллекцией; для типов Массив, СписокЗначений, ФиксированныйМассив сравнение выполняется с видом сравнения ВСписке, иначе вид сравнения Равно;

СтрокаПоиска (SearchString) - содержит строку, используемую при поиске данных; для быстрого выбора содержит значение Неопределено.

Возвращаемое значение:
Тип: СписокЗначений.

Описание:

Формирует список значений данных выбора при вводе по строке, автоподборе текста и быстром выборе.
Если требуется выполнить поиск более 32 слов или 1000 символов, то свойство ОграничиватьСтрокуПоиска требуется установить в значение Ложь.

Доступность:

Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Вызов метода выполняет обращение к серверу.

Примечание:
Если в модуле менеджера в методе указано два параметра, то будет вызван метод ПолучитьДанныеВыбора глобального контекста.
Выполнение метода приводит к вызову события ОбработкаПолученияДанныхВыбора.

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

Доступен, начиная с версии 8.2.

Описание изменено в версии 8.3.18.

Методическая информация

Практические примеры

Выбрать типизированный статус в полностью созданном поле формы

Список для выбора получаем от менеджера перечисления с обязательными параметрами. В реквизите формы хранится значение перечисления, не подпись.

Где и как запускать

Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.

Подготовка

  1. Создайте НОВУЮ пустую файловую учебную базу с именем корня конфигурации Учебная85. Не меняйте рабочие конфигурации ради этого примера.

  2. Перечисления → Добавить: УчебныйСтатус, синоним Учебный статус. Значения в порядке Черновик, Готов, Отменен; синонимы соответственно Черновик, Готов к проверке, Отменён.

  3. Модуль менеджера оставьте пустым, формы/макеты не добавляйте. Обновите конфигурацию базы данных.

  4. Код без директив вставляется в тело ВыполнитьПример() Экспорт серверного общего модуля УчебныеЗадачи. Полный модуль формы вставляется отдельно по подготовке формы.

  5. Создайте отдельную учебную внешнюю обработку с пустой управляемой основной формой. Каждую задачу запускайте в своей копии формы.

  6. Не добавляйте вручную реквизит ЗначениеПримера, поле ПолеПримера и команду УчебноеДействие: их создаст код.

  7. В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Вставьте весь модуль, включая клиентские и серверные процедуры.

  8. Сохраните учебную EPF и откройте через Файл → Открыть в тонком или толстом клиенте Windows. Рабочие данные не читаются и не записываются.

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    Если Метаданные.Перечисления.Найти("УчебныйСтатус") = Неопределено Тогда
        ВызватьИсключение "Подготовьте собственное перечисление УчебныйСтатус";
    КонецЕсли;
    Новые = Новый Массив;
    ТипРеквизита = Новый ОписаниеТипов("ПеречислениеСсылка.УчебныйСтатус");
    Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита));
    ЭтаФорма.ИзменитьРеквизиты(Новые);
    ЭтаФорма.ЗначениеПримера = Перечисления.УчебныйСтатус.Черновик;
    Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
    Поле.Вид = ВидПоляФормы.ПолеВвода;
    Поле.ПутьКДанным = "ЗначениеПримера";
    Поле.Заголовок = "Учебный статус";
    Поле.КнопкаОчистки = Истина;
    Поле.РежимВыбораИзСписка = Истина;
    ПараметрыВыбора = Новый Структура("Отбор,СтрокаПоиска", Новый Структура, Неопределено);
    Список = Перечисления.УчебныйСтатус.ПолучитьДанныеВыбора(ПараметрыВыбора);
    Для Каждого Элемент Из Список Цикл
        Поле.СписокВыбора.Добавить(Элемент.Значение, Элемент.Представление);
    КонецЦикла;

    КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
    КомандаДействия.Действие = "УчебноеДействие";
    КомандаДействия.Заголовок = "Проверить статус";
    КомандаДействия.Подсказка = "Действие только над данными учебной формы";
    КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
    Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
    Кнопка.ИмяКоманды = КомандаДействия.Имя;
    Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры

&НаКлиенте
Процедура УчебноеДействие(Команда)
    Если ЗначениеПримера.Пустая() Тогда
        Сообщить("Учебный статус не выбран; ничего не записано.");
        Возврат;
    КонецЕсли;
    Сообщить(ТипЗнч(ЗначениеПримера) = Тип("ПеречислениеСсылка.УчебныйСтатус"));
    Сообщить(ЗначениеПримера = Перечисления.УчебныйСтатус.Готов);
    Сообщить("Представление: " + Строка(ЗначениеПримера));
КонецПроцедуры

Разбор по шагам

  1. До создания реквизита проверяем собственную учебную конфигурацию и наличие перечисления.

  2. ПолучитьДанныеВыбора получает структуру с Отбор и СтрокаПоиска, даже когда поиск и отбор пустые.

  3. СписокВыбора наполняем типизированными значениями и их представлениями. Начальное значение Черновик задано явно.

  4. КнопкаОчистки возвращает пустое значение перечисления, которое обрабатывается отдельной веткой.

  5. Проверяем тип и сравниваем с конкретным значением Готов, не с текстом подписи.

Как проверить результат

  1. Выберите Готов к проверке: оба сравнения Истина, представление Готов к проверке.

  2. Выберите Черновик: проверка типа Истина, сравнение с Готов Ложь — это ожидаемо.

  3. Очистите поле: сообщение о невыбранном статусе, обращений к базе записи нет.

Ожидаемый результат

Рабочее поле выбора с реальным типом перечисления и корректной обработкой пустого состояния.

На что обратить внимание

  1. Это не универсальная строковая выпадающая коллекция: реквизит имеет конкретный тип учебной конфигурации.

  2. Представления списка могут зависеть от языка интерфейса.

  3. Изменение поля относится только к памяти формы, не к статусам рабочих заказов.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.