Другое · 7 мин
Задание параметров СКД программно в 1С
Программное задание параметров системы компоновки данных в 1C: где менять значения, как проверить результат и какие ошибки избегать при настройке отчёта.
Параметры системы компоновки данных определяют значения, которыми отчёт или обработка руководствуются при формировании набора данных. В СКД они хранятся внутри коллекции настроек и имеют имя, текущее значение, признак обязательности и способы использования. Программное управление параметрами нужно, когда значения должны зависеть от состояния формы, выбранного периода, пользователя или результата предварительного расчёта.
Основной способ задать параметр — получить текущие настройки компоновки, найти элемент по имени и присвоить ему нужное значение. Это делается до вызова построения макета и инициализации процессора компоновки. Если изменить параметр уже после получения данных, отчёт чаще всего продолжит работу со старыми значениями или просто проигнорирует новую установку.
Что представляет собой параметр СКД и где он хранится
В объектной модели СКД параметры входят в состав настроек компоновки данных. Каждый параметр характеризуется именем, значением, типом, признаком обязательности и условиями использования. Имя параметра должно совпадать с тем, которое указано в макете компоновки данных, иначе программа не найдёт нужный элемент.
Параметры могут быть простыми, например дата начала периода или контрагент, и сложными, например таблица значений или перечисление. Тип значения имеет значение: попытка записать строку туда, где ожидается дата, может привести к ошибке при выполнении отчёта или к некорректному фильтру данных.
Как получить настройки и найти нужный параметр
Обычно настройки получают через компоновщик настроек компоновки данных, инициализированный макетом компоновки. После этого в коллекции настроек доступен раздел параметров, по которому можно выполнить поиск по имени. Если параметр с таким именем отсутствует, присвоение значения не имеет смысла, поэтому сначала проверяют наличие элемента.
Примерный порядок действий выглядит так: получить настройки, пройти циклом по параметрам или найти нужный по имени, проверить, что ссылка не равна неопределённому значению, и только потом записать в свойство значение. После изменения настроек их передают в компоновщик макета для построения результата.
Присваивание значения и проверка типа
Когда параметр найден, значение записывают в его свойство значение. Перед записью полезно убедиться, что тип присваиваемых данных соответствует ожидаемому в СКД. Для дат используют дату, для справочников — ссылку на объект, для перечислений — значение перечисления, а не строковое представление.
Если параметр помечен как обязательный, а значение не задано, построение отчёта может завершиться ошибкой или вернуть пустой результат. Также бывают параметры, доступные только для чтения в определённом контексте; попытка программно изменить такие параметры может быть проигнорирована платформой.
Передача параметров при построении отчёта
Обновлённые настройки с заданными параметрами передают в компоновщик макета компоновки данных вместе с макетом. Затем процессор компоновки данных инициализируется полученным макетом и настройками, после чего выполняется формирование результата. Параметры влияют на отбор, группировку и вычисляемые поля ещё на этапе получения набора данных.
В управляемых формах параметры также могут передаваться через параметры данных отчёта или набора данных, в зависимости от способа вызова печатной формы. Суть не меняется: значения должны быть установлены до момента, когда платформа приступает к выборке данных из базы.
Когда программное задание не срабатывает
Частая причина неудачи — поиск параметра по имени, которого нет в текущих настройках, или изменение настроек уже после того, как данные были получены. Другая причина — несоответствие типов: например, передача строки вместо ссылки на документ или даты вместо числа.
Если отчёт использует несколько макетов или вариантов настроек, важно менять именно ту коллекцию, которая будет передана в процессор. Изменение настроек в одной копии не распространяется автоматически на другие варианты компоновки.
Проверка результата и безопасные границы
После выполнения отчёта проверьте, что фильтры и отборы соответствуют заданным параметрам. Можно сравнить количество строк, дату начала периода в заголовке или значения вычисляемых полей с ожидаемыми. Если результат не изменился после программной установки параметра, вероятнее всего, значение не попало в активные настройки.
- 1Получить настройки компоновки данных из макета СКД
- 2Найти параметр по имени в коллекции настроек
- 3Проверить, что параметр существует и тип значения подходит
- 4Присвоить значение свойству Значение
- 5Передать настройки в компоновщик макета и выполнить отчёт
- 6Проверить, что фильтры отразили заданные параметры
Безопасная самостоятельная работа возможна при изменении значений пользовательских параметров отчёта в рамках тестовой базы. Не стоит программно перезаписывать системные настройки компоновки в рабочей базе без понимания их влияния на другие отчёты и пользователей.
Если параметр отсутствует, можно добавить его в макет компоновки данных в конструкторе, а затем программно заполнять значение. Это удобнее, чем пытаться установить несуществующий параметр в процессе выполнения.
Для массовых отчётов удобно выносить параметры в отдельную форму набора, где пользователь выбирает значения, а программа переносит их в настройки СКД перед построением. Так разделен ввод данных и логика компоновки.
Ещё одна ошибка — опора на значения по умолчанию без явной проверки. Если в макете задано значение по умолчанию, программа может использовать его, даже если вы ожидали другое. Явное присваивание и проверка после выполнения помогают избежать неочевидных расхождений.
Как проверить результат
Установлено ожидаемое значение нужного типа
Неопределённое значение или несовместимый тип
Фильтры и отборы соответствуют заданным параметрам
Данные не изменились после программной установки параметра
Альтернативы и выбор подхода
Если параметры меняются редко и одинаково для всех пользователей, проще задать их в настройках макета в конструкторе. Программное задание оправдано, когда значения зависят от контекста сессии, прав пользователя или результатов других вычислений.
В некоторых конфигурациях удобнее использовать отдельные регистры настройки или справочники параметров, из которых программа считывает значения перед передачей в СКД. Это упрощает поддержку, так как менять значения можно без правки кода.
Что важно запомнить
Параметры СКД задаются в настройках до построения отчёта, по точному имени и с подходящим типом; изменения после получения данных не действуют.
Найдёт ли СКД параметр, если в коде есть опечатка в имени?
Нет, поиск по имени вернёт неопределённое значение, и присвоение не применится. Ошибка выполнения может не появиться, поэтому полезно проверять наличие параметра перед записью.
Можно ли изменить параметр после того, как отчёт уже сформирован?
Обычно нет. Параметры влияют на формирование набора данных, поэтому повторное изменение настроек после выполнения процессора не перестроит уже готовый результат.
Что делать, если тип значения не подходит параметру СКД?
Привести значение к ожидаемому типу перед присваиванием: ссылка для справочника, дата для периода, значение перечисления вместо строки. Тип уточняется в свойствах параметра в макете.
Нужно ли программировать каждый параметр отдельно?
Не обязательно. Можно организовать цикл по коллекции параметров и устанавливать значения по совпадению имён, что удобно при большом количестве одинаково обрабатываемых параметров.