Как передать отбор в форму выбора в 1С

Передача отбора в форму выбора — одна из самых частых задач при разработке на платформе 1С:Предприятие. Пользователь нажимает кнопку выбора в поле ввода, и ему должна открыться форма списка, в которой уже отображаются только подходящие элементы: контрагенты конкретной группы, номенклатура определённого вида, договоры выбранной организации. Реализуется это через структуру параметров формы, где ключ Отбор содержит структуру с условиями.

В управляемых формах механизм стандартизирован: форма выбора динамического списка сама подхватывает переданный отбор и применяет его к списку. Разработчику остаётся правильно сформировать структуру и вызвать ОткрытьФорму или переопределить обработчик ОбработкаПолученияДанныхВыбора. В обычных формах подход похож, но используются свои свойства объекта Отбор списка.

Ниже разобраны основные способы передачи отбора: через параметры формы, через переопределение стандартной обработки выбора, для обычных и управляемых приложений, а также проверка результата и разбор типичных ошибок, из-за которых отбор «не срабатывает».

Как работает передача отбора в управляемых формах

В управляемом приложении формы выбора справочников и документов построены на динамическом списке. Когда форма открывается, платформа проверяет её параметры: если среди них есть структура с ключом Отбор, значения из неё автоматически добавляются в отбор динамического списка. Разработчику не нужно писать код в обработчике ПриСозданииНаСервере формы выбора — стандартная форма всё делает сама.

Ключи вложенной структуры должны совпадать с именами полей объекта: Владелец, Организация, Родитель, ПометкаУдаления и так далее. Значение — конкретная ссылка, примитивное значение или массив (список значений) для отбора «в списке». Если поля с таким именем в объекте нет, отбор молча не применится, и это одна из самых коварных ошибок.

Передача отбора при программном открытии формы выбора

Самый прямой сценарий — открыть форму выбора из своего кода, например по команде «Подобрать договор». Создаётся структура параметров, в неё вкладывается отбор, и вызывается ОткрытьФорму с указанием владельца формы, чтобы результат выбора вернулся в нужный обработчик.

&НаКлиенте
Процедура ПодобратьДоговор(Команда)

Отбор = Новый Структура;
Отбор.Вставить("Владелец", Объект.Контрагент);
Отбор.Вставить("Организация", Объект.Организация);
Отбор.Вставить("ПометкаУдаления", Ложь);

ПараметрыФормы = Новый Структура;
ПараметрыФормы.Вставить("Отбор", Отбор);
ПараметрыФормы.Вставить("РежимВыбора", Истина);

ОткрытьФорму("Справочник.ДоговорыКонтрагентов.ФормаВыбора",
ПараметрыФормы, ЭтотОбъект, УникальныйИдентификатор);

КонецПроцедуры

&НаКлиенте
Процедура ОбработкаВыбора(ВыбранноеЗначение, ИсточникВыбора)

Если ТипЗнч(ВыбранноеЗначение) = Тип("СправочникСсылка.ДоговорыКонтрагентов") Тогда
Объект.Договор = ВыбранноеЗначение;
КонецЕсли;

КонецПроцедуры

Владелец формы (четвёртый параметр — уникальный идентификатор) нужен, чтобы при повторном открытии не плодились копии одной и той же формы. Если результат выбора нужно обработать нестандартно, вместо владельца и ОбработкаВыбора используют ОткрытьФорму с описанием оповещения — тогда результат придёт в указанную процедуру через ОповеститьОВыборе или закрытие формы.

ПараметрыФормы = Новый Структура("Отбор", Новый Структура("Владелец", Контрагент));
ОткрытьФорму("Справочник.Договоры.ФормаВыбора", ПараметрыФормы, Элементы.Договор);

Отбор для поля ввода без программного открытия формы

Свойство «Параметры выбора» элемента формы

Когда отбор нужен при стандартном выборе из поля ввода (кнопка «Показать всё», подбор из выпадающего списка), открывать форму вручную не требуется. У поля ввода есть свойство ПараметрыВыбора — массив параметров вида «Отбор.ИмяПоля». Платформа сама передаст их в форму выбора и в механизм ввода по строке.

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)

ПараметрВыбора = Новый ПараметрВыбора("Отбор.Владелец", Объект.Контрагент);
МассивПараметров = Новый Массив;
МассивПараметров.Добавить(ПараметрВыбора);

Элементы.Договор.ПараметрыВыбора = Новый ФиксированныйМассив(МассивПараметров);

КонецПроцедуры

Если отбор зависит от другого поля и должен меняться динамически (выбрали контрагента — обновился список договоров), параметры выбора переназначают в обработчике ПриИзменении поля контрагента. Дополнительно полезно при смене контрагента очищать договор, если он больше не подходит под отбор, иначе в документе останется «чужое» значение.

Связи параметров выбора

Для типовой связи «владелец — подчинённый справочник» есть более простой механизм — свойство СвязиПараметровВыбора. Связь вида «Отбор.Владелец» → «Объект.Контрагент» заставит платформу автоматически подставлять текущего контрагента в отбор формы выбора без единой строки кода. В типовых конфигурациях именно так связаны, например, банковские счета с контрагентами.

Сложные условия: отбор по списку значений и произвольные запросы

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

Первый — создать собственную форму выбора, в которой в ПриСозданииНаСервере программно настраивается отбор динамического списка через Список.КомпоновщикНастроек или свойство ПроизвольныйЗапрос с нужным текстом запроса. Второй — переопределить в модуле менеджера объекта обработчик ОбработкаПолученияДанныхВыбора, где формируется собственный список значений для быстрого выбора при вводе по строке.

Проверка результата и типичные ошибки

После настройки отбора проверьте три сценария: открытие формы выбора кнопкой, ввод по строке в поле и быстрый выбор из выпадающего списка. Во всех трёх случаях список должен быть одинаково ограничен. Часто отбор работает в форме списка, но не работает при вводе по строке — это признак того, что использовано программное открытие формы вместо ПараметрыВыбора.

Ещё одна частая проблема — тип значения отбора. Если в отбор по ссылочному полю передать строку с наименованием вместо ссылки, условие не сработает. Перед передачей убедитесь, что значение имеет нужный тип: ссылка, полученная из реквизита объекта, а не из строкового представления.

Ограничения и меры предосторожности

Отбор формы выбора — это удобство интерфейса, а не механизм защиты данных. Пользователь с достаточными правами может открыть полный список объекта другим способом и ввести ссылку в обход отбора. Если требуется реально запретить выбор «чужих» данных, ограничение нужно дублировать на уровне проверки при записи объекта (подписка на событие ОбработкаПроверкиЗаполнения) или через RLS.

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

Частые вопросы