Событие вызывается на клиенте при изменении настроек отчета, загрузке новых настроек, выборе варианта отчета. Стандартная обработка устанавливает состояние отчета (если включена настройка АвтоОтображениеСостояния) и вызывает стандартную команду формы отчета “Сформировать” (если включена настройка АвтоКомпоновкаРезультатаПриИзмененииНастроек).
Синтаксис
ПриИзмененииНастроек(<СтандартнаяОбработка>)Полное описание, параметры и ограничения
Расширение формы клиентского приложения для отчета.ПриИзмененииНастроек (Client application form extension for reports.OnSettingsChange)
Расширение формы клиентского приложения для отчета (Client application form extension for reports)
ПриИзмененииНастроек (OnSettingsChange)
Доступен, начиная с версии 8.5.1.
Синтаксис:
ПриИзмененииНастроек(<СтандартнаяОбработка>)
Параметры:
<СтандартнаяОбработка>
Тип: Булево.
В данный параметр передается признак выполнения стандартной (системной) обработки события - устанавливается состояние отчета (если включено АвтоОтображениеСостояния) и вызывается стандартная команда формы отчета "Сформировать" (если включена настройка АвтоКомпоновкаРезультатаПриИзмененииНастроек).
Если в теле процедуры-обработчика установить данному параметру значение Ложь, стандартная обработка события производиться не будет.
Описание:
Событие вызывается на клиенте при изменении настроек отчета, загрузке новых настроек, выборе варианта отчета. Стандартная обработка устанавливает состояние отчета (если включена настройка АвтоОтображениеСостояния) и вызывает стандартную команду формы отчета “Сформировать” (если включена настройка АвтоКомпоновкаРезультатаПриИзмененииНастроек).
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).
Использование в версии:
Доступен, начиная с версии 8.5.1.
Методическая информация
Практические примеры
ПриИзмененииНастроек: собственный отчёт двух книг
Настоящая отчётная форма подготовленного своего отчёта вызывает событие при формировании, изменении или штатной загрузке / сохранении настроек. Типы слоёв и фазы не смешиваются.
Где и как запускать
Модуль управляемой основной формы собственного отчёта УчебныеКнигиСКД; событие самой формы.
Подготовка
В своей учебной конфигурации создайте Отчеты → УчебныеКнигиСКД. У отчёта откройте ОсновнаяСхемаКомпоновкиДанных и сохраните её макетом ОсновнаяСхемаКомпоновкиДанных.
В конструкторе СКД создайте источник Local и набор-запрос Книги. Вставьте приведённый запрос двух константных строк; это не чтение рабочих справочников. Доступные поля Наименование, Количество, Сумма заполните автоматически.
В настройках схемы создайте вариант Подробно: выбраны Наименование, Количество, Сумма; структура — группировка Детальные записи. Второй вариант Кратко: Наименование и Сумма, также Детальные записи. Первым оставьте Подробно; у обоих задайте понятное представление.
Мастером создайте у своего отчёта управляемую форму ОтчетКниг, тип Основная, со стандартными командами Сформировать / Настройки. Основной реквизит Отчет типа ОтчетОбъект.УчебныеКнигиСКД должен остаться основным.
Проверьте штатный реквизит Результат типа ТабличныйДокумент и связанное поле ПолеРезультата с путём Результат. Если мастер дал другое имя, согласуйте именно этот свой реквизит и связь штатной команды, не добавляйте второй результат.
Добавьте свои реквизиты Статус Строка 200 и ЧислоФормирований Число 10.0, разместите на форме. События отчётной формы назначаются самой форме, не полю результата и не модулю объекта отчёта.
Для уроков сохранения у конфигурации оставьте незаданными ХранилищеВариантовОтчетов и ХранилищеПользовательскихНастроекОтчетов: используется стандартное внутреннее хранилище собственной учебной базы. Пользователю нужно право СохранениеДанныхПользователя. Сохраняйте и загружайте только свои именованные настройки этого отчёта.
Каждый пример самостоятельный. Формируйте только этот собственный отчёт; рабочие настройки, печать и сохранение в чужие хранилища не используются. BSL здесь не исполнялся.
Интерфейс «Версия 8.5». Измените свой отбор / выбор полей либо переключите Подробно и Кратко. Автоматическое формирование зависит от отдельной настройки АвтоКомпоновкаРезультатаПриИзмененииНастроек.
&НаКлиенте
Процедура ПриИзмененииНастроек(СтандартнаяОбработка)
СтандартнаяОбработка = Истина;
Статус = "Свои настройки изменены; стандартная реакция сохранена";
Сообщить(Статус);
КонецПроцедурыКонструктор СКД своего отчёта: запрос двух константных строк, не BSL
ВЫБРАТЬ
"Учебная книга" КАК Наименование,
3 КАК Количество,
750 КАК Сумма
ОБЪЕДИНИТЬ ВСЕ
ВЫБРАТЬ "Учебная тетрадь", 5, 200Разбор по шагам
Создайте свой отчёт и его сохранённую СКД с двумя константными строками.
Назначьте обработчик событию самой формы и выполните указанную штатную команду.
Сравните фактический параметр / статус и не считайте вызов события доказательством другой фазы.
Как проверить результат
Клиентское событие показывает изменение настроек и сохраняет стандартное изменение состояния отчёта.
Флаг Истина сам по себе не включает автоматическую компоновку, если она выключена в форме; это не серверное событие формирования.
Ожидаемый результат
Событие связано с настоящей собственной формой отчёта и воспроизводимым действием пользователя.
На что обратить внимание
Параметр Результат события и реквизит формы Результат читаются в разные моменты.
Полные настройки варианта и пользовательские настройки имеют разные типы; общим здесь является только документированное ДополнительныеСвойства.
При сборке справочника BSL и команды сохранения не исполнялись; runtime-проверка отсутствует.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.