Как программно добавить отбор в СКД 1С

Система компоновки данных (СКД) позволяет формировать отчёты без написания сложных запросов вручную, а отборы в ней можно управлять программно — из формы отчёта, обработчика команды или внешней обработки. Программная установка отбора нужна, когда отчёт открывается с уже заданными ограничениями, например по конкретному контрагенту, периоду или складу, либо когда отбор зависит от прав пользователя.

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

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

Где в структуре СКД находится отбор

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

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

Добавление отбора через компоновщик настроек

Базовый сценарий — добавить элемент отбора в коллекцию Настройки.Отбор.Элементы. Элемент создаётся с типом ЭлементОтбораКомпоновкиДанных, после чего заполняются его свойства.

Настройки = Отчет.КомпоновщикНастроек.Настройки;

ЭлементОтбора = Настройки.Отбор.Элементы.Добавить(
Тип("ЭлементОтбораКомпоновкиДанных"));
ЭлементОтбора.ЛевоеЗначение = Новый ПолеКомпоновкиДанных("Организация");
ЭлементОтбора.ВидСравнения = ВидСравненияКомпоновкиДанных.Равно;
ЭлементОтбора.ПравоеЗначение = ВыбраннаяОрганизация;
ЭлементОтбора.Использование = Истина;

Ключевые свойства элемента: ЛевоеЗначение — поле данных, по которому фильтруем (имя должно точно совпадать с именем поля в наборе данных схемы); ВидСравнения — операция (Равно, ВСписке, Содержит, БольшеИлиРавно и др.); ПравоеЗначение — значение отбора; Использование — включён ли элемент. Если Использование не установить в Истина, отбор появится в списке, но применяться не будет.

Для отбора по списку значений используйте вид сравнения ВСписке и передавайте в ПравоеЗначение объект СписокЗначений. Для периодов удобнее вид сравнения БольшеИлиРавно / Меньше по полю даты либо стандартный параметр периода.

ЭлементОтбора = Настройки.Отбор.Элементы.Добавить(Тип("ЭлементОтбораКомпоновкиДанных"));
ЭлементОтбора.ЛевоеЗначение = Новый ПолеКомпоновкиДанных("Контрагент");
ЭлементОтбора.ВидСравнения = ВидСравненияКомпоновкиДанных.ВСписке;
ЭлементОтбора.ПравоеЗначение = СписокКонтрагентов;
ЭлементОтбора.Использование = Истина;

Поиск и изменение существующего отбора

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

ИскомоеПоле = Новый ПолеКомпоновкиДанных("Организация");
Для Каждого Элемент Из Настройки.Отбор.Элементы Цикл
Если ТипЗнч(Элемент) = Тип("ЭлементОтбораКомпоновкиДанных")
И Элемент.ЛевоеЗначение = ИскомоеПоле Тогда
Элемент.ПравоеЗначение = НовоеЗначение;
Элемент.Использование = Истина;
КонецЕсли;
КонецЦикла;

Обратите внимание: в коллекции могут встречаться группы отборов (ГруппаЭлементовОтбораКомпоновкиДанных), поэтому при сложной структуре поиск делают рекурсивным. Попытка обратиться к свойству ЛевоеЗначение у группы вызовет ошибку — всегда проверяйте тип элемента.

Отбор через пользовательские настройки

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

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

Такой подход корректен при открытии отчёта с параметрами: пользователь видит установленное значение и может его изменить. Если же вы хотите «зашить» отбор так, чтобы пользователь не мог его снять, добавляйте элемент только в основные настройки и не выводите его в пользовательские — либо ограничивайте доступность поля в настройках варианта.

Установка параметров вместо отбора

Не всегда ограничение данных стоит делать отбором. Если в схеме компоновки предусмотрен параметр (например, «Период», «Организация»), корректнее задать его значение через коллекцию Настройки.ПараметрыДанных. Параметры влияют на запрос на уровне источника данных и обычно эффективнее отбора, применяемого после выборки.

Параметр = Настройки.ПараметрыДанных.Элементы.Найти("НачалоПериода");
Если Параметр <> Неопределено Тогда
Параметр.Значение = НачалоМесяца(ТекущаяДатаСеанса());
Параметр.Использование = Истина;
КонецЕсли;

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

Группы отборов и сложные условия

Когда нужно условие вида «(А И Б) ИЛИ В», отдельных элементов недостаточно — создают группу. Группа добавляется с типом ГруппаЭлементовОтбораКомпоновкиДанных, у неё задаётся ТипГруппы (ГруппаИ, ГруппаИли, ГруппаНе), а элементы добавляются уже в коллекцию Элементы этой группы.

ГруппаИли = Настройки.Отбор.Элементы.Добавить(
Тип("ГруппаЭлементовОтбораКомпоновкиДанных"));
ГруппаИли.ТипГруппы = ТипГруппыЭлементовОтбораКомпоновкиДанных.ГруппаИли;
ГруппаИли.Использование = Истина;

Элемент1 = ГруппаИли.Элементы.Добавить(
Тип("ЭлементОтбораКомпоновкиДанных"));
Элемент1.ЛевоеЗначение = Новый ПолеКомпоновкиДанных("Статус");
Элемент1.ВидСравнения = ВидСравненияКомпоновкиДанных.Равно;
Элемент1.ПравоеЗначение = Перечисления.Статусы.Закрыт;
Элемент1.Использование = Истина;

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

Проверка результата и отладка

После установки отбора сформируйте отчёт и проверьте, что данные действительно ограничены. Быстрый способ убедиться, что отбор попал в итоговые настройки, — открыть окно настроек отчёта (кнопка «Настройки») и посмотреть вкладку «Отбор»: добавленные элементы должны быть там с установленными флажками.

Если отбор не сработал, проверьте по порядку: совпадает ли имя поля с именем в наборе данных; установлено ли Использование; не перезаписал ли ваш элемент более поздний код (например, загрузка сохранённых пользовательских настроек); формировался ли отчёт после изменения настроек. Для программного формирования вне формы используют связку КомпоновщикМакетаКомпоновкиДанных и ПроцессорКомпоновкиДанных — там настройки передаются в макет компоновки явно.

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