Расширение формы клиентского приложения для отчета.ПередЗагрузкойВариантаНаСервере

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

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

Подготовка

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

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

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

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

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

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

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

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

9. Переключите встроенные собственные варианты Подробно и Кратко. Перед загрузкой передаётся именно полный объект настроек выбранного варианта.

&НаСервере
Процедура ПередЗагрузкойВариантаНаСервере(Настройки)
    Настройки.ДополнительныеСвойства.Вставить("ИсточникУчебныхНастроек", "Свой вариант книг");
    Статус = "Перед загрузкой: выбрано полей " + Строка(Настройки.Выбор.Элементы.Количество());
    Сообщить(Статус);
КонецПроцедуры

ВЫБРАТЬ
    "Учебная книга" КАК Наименование,
    3 КАК Количество,
    750 КАК Сумма
ОБЪЕДИНИТЬ ВСЕ
ВЫБРАТЬ "Учебная тетрадь", 5, 200

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

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

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

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

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

1. До загрузки у Подробно выбраны три собственных поля, у Кратко — два; обработчик читает фактический состав.

2. Не подменяется readonly КомпоновщикНастроек и не создаётся пустой объект вместо переданного Настройки.

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

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

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

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

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

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

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