К статье
Практический материал

Другое · 6 мин

Как программно добавить отбор в схему компоновки данных 1С

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

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

Основной объект — коллекция отборов схемы компоновки данных. Каждый элемент содержит ссылку на поле, вид сравнения, значение и признак использования. Изменять коллекцию можно до вывода отчёта или в обработчике построения макета, в зависимости от точки вставки.

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

Когда программный отбор оправдан

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

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

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

Объект отбора и его свойства

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

Порядок действий
  1. 1
    Откройте схему компоновки данных в модуле отчёта
  2. 2
    Получите коллекцию Отбор и создайте новый элемент
  3. 3
    Задайте поле, вид сравнения, значение и признак использования
  4. 4
    Выполните проверку результата на тестовых данных

Отбор по полю набора данных

Самый частый сценарий — ограничение по реквизиту из набора данных, например контрагенту, договору или складу. В этом случае левое значение задаётся как поле компоновки данных, а правое — как параметр, значение которого передаётся перед построением отчёта.

Отбор по параметру и пользовательскому полю

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

Контрольные точки

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

Отбор появился в коллекции
Норма

Элемент отображается со свойствами и Использование Истина

Тревожный признак

Коллекция пуста или элемент неактивен

Результат отчёта
Норма

Выбраны только записи, подходящие под условие

Тревожный признак

Отбор игнорируется или отфильтровано лишнее

Поведение при открытии
Норма

Настройки сохраняются между сеансами

Тревожный признак

Отбор сбрасывается после переоткрытия отчёта

Порядок добавления элемента отбора

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

Не стоит добавлять одинаковые отборы повторно при каждом вызове обработчика. Это приводит к раздуванию коллекции и может изменить логику запроса непредсказуемым образом.

Типичные ошибки
01
Повторное добавление одного и того же отбора при каждом вызове
02
Ссылка на несуществующее поле или параметр
03
Блокировка отбора пользовательскими настройками

Проверка и отладка отбора

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

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

Ограничения и частые ошибки

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

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

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

Сравнение вариантов

Отбор в конструкторе СКД

Подходит для постоянных условий, доступных пользователю для редактирования

Программный отбор

Подходит для динамических условий, известных только во время выполнения

Условное оформление

Не заменяет отбор, меняет только внешний вид уже отобранных данных

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

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

Итог

Что важно запомнить

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

Можно ли добавить несколько отборов одним вызовом?

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

Сбросится ли отбор после закрытия отчёта?

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

Чем отбор отличается от условного оформления?

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

Нужны ли права администратора для программного отбора?

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