Адрес офиса: г. Минск, ул.Л. Карастояновой, 32
Меню сайта
Ограничить выбор значения в поле ввода управляемой формы 1С кажется простой задачей: поставил отбор — и готово. На практике именно здесь разработчики чаще всего допускают тонкие ошибки. Отбор срабатывает в одном сценарии, но не работает в другом, или, наоборот, запрет настроен везде, а пользователь при этом теряет привычные возможности — например, поиск договора по коду. Разберём типовую задачу, которую нередко дают на собеседовании программистам 1С, и посмотрим, как её решить аккуратно.
Возьмём простую модель данных. Есть справочник «Договоры» с реквизитом «Вид договора» (ссылка на справочник «Виды договоров»). У вида договора, в свою очередь, есть реквизит «Тип договора» — перечисление со значениями «С поставщиком» и «С покупателем». На форме обработки нужно поле типа «Справочник.Договоры», в котором пользователь может указать только договор с покупателем. Отдельно оговаривается удобство работы и то, что завтра может понадобиться такая же форма, но для договоров с поставщиком.
Ключевая сложность в том, что признак, по которому нужно фильтровать, хранится не в самом договоре, а «на шаг глубже» — у его вида: Договор.ВидДоговора.ТипДоговора.
Прежде чем писать код, полезно перечислить каналы, через которые договор может оказаться в реквизите:
Первые три канала управляются параметрами выбора поля и обработчиком ОбработкаПолученияДанныхВыбора в модуле менеджера справочника. Четвёртый эти механизмы не видят вообще.
НачалоВыбора открывает список с фильтром, но при вводе по строке выпадающий список показывает все договоры без ограничений.Отбор.ВидДоговора.ТипДоговора платформой не принимается: параметры выбора фильтруют только по реквизитам самого справочника.ПриИзменении. Пользователь узнаёт о запрете уже после выбора — об удобстве тут речи нет.Удачный подход — завести собственный параметр выбора ТипДоговора. В свойствах поля на форме задаётся значение «С покупателем», а рядом можно вывести тип выбранного договора, чтобы пользователь его видел. В форме выбора справочника объявляется одноимённый параметр, а в запрос динамического списка добавляется условие-«выключатель»:
ГДЕ
ВЫБОР
КОГДА &ОтборПоТипуДоговора
ТОГДА СправочникДоговоры.ВидДоговора.ТипДоговора = &ТипДоговора
ИНАЧЕ ИСТИНА
КОНЕЦ
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Список.Параметры.УстановитьЗначениеПараметра("ТипДоговора", Параметры.ТипДоговора);
Список.Параметры.УстановитьЗначениеПараметра("ОтборПоТипуДоговора",
ЗначениеЗаполнено(Параметры.ТипДоговора));
КонецПроцедуры
Приём стоит запомнить: текст запроса один, а фильтр включается и выключается флагом. Оба параметра нужно устанавливать всегда — динамический список с незаданным параметром работать не будет. Если параметр не передан, форма показывает все договоры, и остальная конфигурация не страдает. Минус — условие с параметром СУБД оптимизирует не всегда идеально; для справочника договоров это несущественно, а для таблиц на миллионы строк лучше рассмотреть отбор через Список.Отбор, который, в отличие от параметров выбора, поддерживает поля через точку.
Для ввода по строке и вставки из буфера пишется обработчик ОбработкаПолученияДанныхВыбора в модуле менеджера, который при наличии параметра ТипДоговора отключает стандартную обработку и выполняет собственный запрос. Расширяемость при этом достигается бесплатно: для формы «С поставщиком» достаточно поменять значение параметра выбора у поля.
Подвох в том, что, отключив стандартную обработку, разработчик берёт на себя всё, что раньше делала платформа по настройкам справочника. Если в свойствах «Договоров» ввод по строке настроен по наименованию и коду, а самописный запрос ищет только по наименованию, пользователь больше не сможет ни набрать код договора, ни вставить его из буфера. В конфигураторе при этом по-прежнему значится «Наименование, Код», и следующий разработчик будет уверен, что всё работает. На тестовых данных ошибку легко пропустить, если наименования сами похожи на числа.
Типичные дополнительные недочёты такого обработчика:
ПОДОБНО без экранирования, и символы %, _, [ работают как шаблон;ПЕРВЫЕ 10 без УПОРЯДОЧИТЬ ПО возвращает непредсказуемый набор строк;Вариантов два. Первый — продублировать «Тип договора» в самом справочнике «Договоры», заполнять его при записи из вида договора и использовать обычный параметр выбора Отбор.ТипДоговора. Тогда собственный обработчик не нужен, и платформа учтёт все настройки ввода по строке. Цена — данные хранятся в двух местах, и при смене типа у вида придётся перезаписать связанные договоры.
Второй — оставить свой обработчик, но не «зашивать» поля поиска в код, а читать их из Метаданные.Справочники.Договоры.ВводПоСтроке, собирая условие ПОДОБНО по каждому полю через ИЛИ. Дополнительно стоит искать с первого символа, экранировать ввод через СПЕЦСИМВОЛ, добавить сортировку, исключить помеченные на удаление и показывать в подсказке и наименование, и код. Строка пользователя всегда передаётся отдельным параметром запроса, а в текст подставляются только имена полей, собранные кодом.
Программное присвоение по-прежнему остаётся вне контроля: ПриИзменении при нём не вызывается. Поэтому в рабочей конфигурации корректность договора проверяют там, где он используется, — например, в ОбработкаПроверкиЗаполнения документа.
Ограничение выбора должно убирать лишние значения, а не возможности поля. После доработки проверьте не только то, что запрещённый договор выбрать нельзя, но и то, что всё прежнее по-прежнему работает: наберите код, вставьте его из буфера, введите пару символов, оставьте строку пустой. Если вам нужна помощь с доработкой форм и конфигураций 1С, обращайтесь к нашим специалистам.
Обновлен:
13.07.2022