Как программно ограничить список выбора параметра в отчете СКД без создания собственной формы

← На главную

В практике разработки на платформе 1С:Предприятие 8.3 часто возникает задача ограничить пользователю возможность выбора определенных элементов в параметрах отчета. Например, в справочнике Организации могут существовать служебные или закрытые записи, которые не должны фигурировать в конкретном отчете. Если отчет имеет собственную форму, задача решается просто, но как быть, если используется стандартная форма из состава БСП (Библиотеки Стандартных Подсистем), а создавать свою форму нецелесообразно? Рассмотрим, как решить эту задачу изящно и профессионально.

Анализ проблемы и выбор стратегии

Когда мы работаем в типовых конфигурациях (таких как УТ 11, ERP 2 или КА 2), отчеты обычно открываются в общей форме. Попытка просто установить значение параметра в компоновщике настроек внутри модуля отчета зачастую приводит к тому, что значение устанавливается, но при нажатии кнопки выбора пользователь все равно видит весь справочник целиком. Это происходит потому, что форма выбора справочника открывается стандартными средствами платформы, не зная о наших программных манипуляциях в модуле.

Проанализируем ситуацию: нам нужно «перехватить» момент формирования формы и передать ей инструкции по фильтрации. БСП предоставляет для этого специальные программные интерфейсы (хуки), которые позволяют внедрить логику в модуль объекта отчета, что часто требуется и при создании сводных отчетов для БСП 3.х. Разберем по шагам, как это реализовать.

Шаг 1. Регистрация обработчиков в модуле отчета

Для начала нам нужно сообщить системе, что наш отчет хочет самостоятельно управлять параметрами выбора. Для этого в модуле объекта отчета необходимо создать экспортную процедуру ОпределитьНастройкиФормы. Эта процедура вызывается общей формой отчета при создании.


Процедура ОпределитьНастройкиФормы(Форма, КлючВарианта, Настройки) Экспорт
    // Указываем системе, что мы хотим обработать событие определения параметров выбора
    Настройки.События.ПриОпределенииПараметровВыбора = Истина;
КонецПроцедуры

Здесь мы устанавливаем флаг ПриОпределенииПараметровВыбора в значение Истина. Это дает сигнал механизму БСП, что при попытке пользователя выбрать значение параметра нужно вызвать нашу специальную процедуру-обработчик.

Шаг 2. Реализация фильтрации через список значений

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


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

В этом примере мы используем свойство ОграничиватьВыборУказаннымиЗначениями. При такой настройке пользователь вместо полноценного окна справочника увидит компактный выпадающий список, содержащий только те элементы, которые мы добавили в СписокДоступных. Это максимально жесткое и надежное ограничение.

Шаг 3. Динамическая фильтрация формы выбора через запрос

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


Процедура ПриОпределенииПараметровВыбора(Форма, СвойстваНастройки) Экспорт
    
    ИмяПоля = Строка(СвойстваНастройки.ПолеКД);
    Если ИмяПоля = "ПараметрыДанных.Организации" Тогда
        
        // Определяем текст запроса для подбора
        ТекстЗапроса = 
        "ВЫБРАТЬ
        |    Организации.Ссылка КАК Ссылка
        |ИЗ
        |    Справочник.Организации КАК Организации
        |ГДЕ
        |    НЕ Организации.ПометкаУдаления
        |    И НЕ Организации.Предопределенный"; // Условие для исключения технических элементов
        
        СвойстваНастройки.ЗапросЗначенийВыбора.Текст = ТекстЗапроса;
        
    КонецЕсли;
    
КонецПроцедуры

Этот метод хорош тем, что он сохраняет стандартный интерфейс выбора справочника, но «под капотом» ограничивает состав видимых данных. Через СвойстваНастройки.ЗапросЗначенийВыбора.Параметры вы также можете передавать любые параметры в этот запрос, расширяя стандартные возможности фильтрации, как это делают специализированные расширения для дополнительных отборов в БСП — для этого подойдёт расширение быстрых кнопок-фильтров для интерфейса 1С.

Дополнительные настройки для повышения надежности

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

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


Процедура ПриКомпоновкеРезультата(ДанныеРасшифровки, СтандартнаяОбработка)
    
    // Получаем текущее значение параметра из настроек компоновщика
    ПараметрОрганизации = КомпоновщикНастроек.Настройки.ПараметрыДанных.Элементы.Найти("Организации");
    
    Если ПараметрОрганизации <> Неопределено И ПараметрОрганизации.Использование Тогда
        // Проверяем выбранные значения на соответствие нашим правилам
        // Если найдено запрещенное значение - выбрасываем исключение или очищаем его
    КонецЕсли;
    
КонецПроцедуры

Нюанс с предопределенными параметрами СКД

Рассмотрим еще один важный момент, упомянутый в практике. Существует метод УстановитьДоступныеЗначения непосредственно в схеме компоновки. Его можно вызвать в процедуре ИнициализацияОтчета модуля объекта (если вы вызываете её сами) или прямо перед формированием.


ПараметрСхемы = СхемаКомпоновкиДанных.Parameters.Найти("Организация");
СписокОрганизаций = Новый СписокЗначений;
// Заполнение списка...
ПараметрСхемы.УстановитьДоступныеЗначения(СписокОрганизаций);

Этот метод воздействует непосредственно на метаданные схемы в памяти. Однако стоит помнить, что при использовании БСП и её механизмов кэширования форм, настройки, определенные через ОпределитьНастройкиФормы, являются более приоритетными и корректными с точки зрения архитектуры современных конфигураций.

Выводы и рекомендации

Мы проанализировали несколько способов ограничения списка выбора параметров в СКД. Подведем итоги нашей совместной работы:

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

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