Расширение формы клиентского приложения для отчета.ПриИзмененииНастроек

События · OnSettingsChange

Событие вызывается на клиенте при изменении настроек отчета, загрузке новых настроек, выборе варианта отчета. Стандартная обработка устанавливает состояние отчета (если включена настройка АвтоОтображениеСостояния) и вызывает стандартную команду формы отчета “Сформировать” (если включена настройка АвтоКомпоновкаРезультатаПриИзмененииНастроек).

Синтаксис

ПриИзмененииНастроек(<СтандартнаяОбработка>)
Полное описание, параметры и ограничения

Расширение формы клиентского приложения для отчета.ПриИзмененииНастроек (Client application form extension for reports.OnSettingsChange)

Расширение формы клиентского приложения для отчета (Client application form extension for reports)

ПриИзмененииНастроек (OnSettingsChange)

Доступен, начиная с версии 8.5.1.

Синтаксис:
ПриИзмененииНастроек(<СтандартнаяОбработка>)
Параметры:

<СтандартнаяОбработка>
Тип: Булево.
В данный параметр передается признак выполнения стандартной (системной) обработки события - устанавливается состояние отчета (если включено АвтоОтображениеСостояния) и вызывается стандартная команда формы отчета "Сформировать" (если включена настройка АвтоКомпоновкаРезультатаПриИзмененииНастроек).

Если в теле процедуры-обработчика установить данному параметру значение Ложь, стандартная обработка события производиться не будет.
Описание:

Событие вызывается на клиенте при изменении настроек отчета, загрузке новых настроек, выборе варианта отчета. Стандартная обработка устанавливает состояние отчета (если включена настройка АвтоОтображениеСостояния) и вызывает стандартную команду формы отчета “Сформировать” (если включена настройка АвтоКомпоновкаРезультатаПриИзмененииНастроек).

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).

Использование в версии:

Доступен, начиная с версии 8.5.1.

Методическая информация

Практические примеры

ПриИзмененииНастроек: собственный отчёт двух книг

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

Где и как запускать

Модуль управляемой основной формы собственного отчёта УчебныеКнигиСКД; событие самой формы.

Подготовка

  1. В своей учебной конфигурации создайте Отчеты → УчебныеКнигиСКД. У отчёта откройте ОсновнаяСхемаКомпоновкиДанных и сохраните её макетом ОсновнаяСхемаКомпоновкиДанных.

  2. В конструкторе СКД создайте источник Local и набор-запрос Книги. Вставьте приведённый запрос двух константных строк; это не чтение рабочих справочников. Доступные поля Наименование, Количество, Сумма заполните автоматически.

  3. В настройках схемы создайте вариант Подробно: выбраны Наименование, Количество, Сумма; структура — группировка Детальные записи. Второй вариант Кратко: Наименование и Сумма, также Детальные записи. Первым оставьте Подробно; у обоих задайте понятное представление.

  4. Мастером создайте у своего отчёта управляемую форму ОтчетКниг, тип Основная, со стандартными командами Сформировать / Настройки. Основной реквизит Отчет типа ОтчетОбъект.УчебныеКнигиСКД должен остаться основным.

  5. Проверьте штатный реквизит Результат типа ТабличныйДокумент и связанное поле ПолеРезультата с путём Результат. Если мастер дал другое имя, согласуйте именно этот свой реквизит и связь штатной команды, не добавляйте второй результат.

  6. Добавьте свои реквизиты Статус Строка 200 и ЧислоФормирований Число 10.0, разместите на форме. События отчётной формы назначаются самой форме, не полю результата и не модулю объекта отчёта.

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

  8. Каждый пример самостоятельный. Формируйте только этот собственный отчёт; рабочие настройки, печать и сохранение в чужие хранилища не используются. BSL здесь не исполнялся.

  9. Интерфейс «Версия 8.5». Измените свой отбор / выбор полей либо переключите Подробно и Кратко. Автоматическое формирование зависит от отдельной настройки АвтоКомпоновкаРезультатаПриИзмененииНастроек.

&НаКлиенте
Процедура ПриИзмененииНастроек(СтандартнаяОбработка)
    СтандартнаяОбработка = Истина;
    Статус = "Свои настройки изменены; стандартная реакция сохранена";
    Сообщить(Статус);
КонецПроцедуры
Конструктор СКД своего отчёта: запрос двух константных строк, не BSL
ВЫБРАТЬ
    "Учебная книга" КАК Наименование,
    3 КАК Количество,
    750 КАК Сумма
ОБЪЕДИНИТЬ ВСЕ
ВЫБРАТЬ "Учебная тетрадь", 5, 200

Разбор по шагам

  1. Создайте свой отчёт и его сохранённую СКД с двумя константными строками.

  2. Назначьте обработчик событию самой формы и выполните указанную штатную команду.

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

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

  1. Клиентское событие показывает изменение настроек и сохраняет стандартное изменение состояния отчёта.

  2. Флаг Истина сам по себе не включает автоматическую компоновку, если она выключена в форме; это не серверное событие формирования.

Ожидаемый результат

Событие связано с настоящей собственной формой отчёта и воспроизводимым действием пользователя.

На что обратить внимание

  1. Параметр Результат события и реквизит формы Результат читаются в разные моменты.

  2. Полные настройки варианта и пользовательские настройки имеют разные типы; общим здесь является только документированное ДополнительныеСвойства.

  3. При сборке справочника BSL и команды сохранения не исполнялись; runtime-проверка отсутствует.

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

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.