Часто бывает нужно задать значения параметров схемы компоновки данных по умолчанию перед формированием отчета. Для этого необходимо использовать обработчик события формы отчета ПередЗагрузкойВариантаНаСервере, чтобы в нем изменить параметры настроек перед их загрузкой в компоновщик (листинг 3.56).
Листинг 3.56. Обработчик события «ПередЗагрузкойВариантаНаСервере»
&НаСервере
Процедура ПередЗагрузкойВариантаНаСервере(Настройки)
Настройки.ПараметрыВывода.УстановитьЗначениеПараметра("Заголовок",
"Продажа системных блоков");
Настройки.ПараметрыДанных.УстановитьЗначениеПараметра("НачалоПериода",
'20111201');
Настройки.ПараметрыДанных.УстановитьЗначениеПараметра("КонецПериода",
'20111231');
КонецПроцедуры
В параметре Настройки в обработчик передаются настройки варианта отчета, имеющие тип НастройкиКомпоновкиДанных. В данном обработчике методом УстановитьЗначениеПараметра() изменен заголовок отчета, а также установлены значения параметров начала и конца отчетного периода.
Однако если настройки являются пользовательскими (например, это параметры отчетного периода) и пользователь хоть раз задавал их значения в форме отчета, то нужно использовать обработчик события ПередЗагрузкойПользовательскихНастроекНаСервере, который вызывается после загрузки настроек варианта отчета. При этом восстанавливаются пользовательские настройки, сделанные пользователем при последнем формировании отчета и автоматически сохраненные платформой. Пользовательские настройки накладываются на настройки варианта и загружаются в компоновщик настроек (листинг 3.57).
Листинг 3.57. Обработчик события «ПередЗагрузкойПользовательскихНастроекНаСервере»
&НаСервере
Процедура ПередЗагрузкойПользовательскихНастроекНаСервере(Настройки)
Настройки.Элементы[0].Значение = ‘20111201’;
Настройки.Элементы[0].Использование = Истина;
Настройки.Элементы[1].Значение = ‘20111231’;
Настройки.Элементы[1].Использование = Истина;
КонецПроцедуры
В параметре Настройки в обработчик передаются настройки варианта отчета, имеющие тип ПользовательскиеНастройкиКомпоновкиДанных. Так как параметра всего два, то можно обращаться к ним по индексу (0, 1) в коллекции элементов пользовательских настроек. Мы устанавливаем значения параметров начала и конца отчетного периода и задаем для них признак использования. Эти настройки загружаются в компоновщик настроек, и отчет формируется с заданными параметрами.
Пример программной инициализации параметров отчета рассмотрен во второй главе .
Заметим, что названия некоторых параметров вывода не совпадают с названиями в окне настроек схемы компоновки данных. Список имен параметров для программного использования можно увидеть в разделе Синтакс-Помощника: Общие объекты⇒Система компоновки данных⇒Настройки компоновки данных⇒ЗначенияПараметровВыводаКомпоновкиДанных.