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

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

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

Подготовка

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

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

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

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

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

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

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

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

9. Измените настройки только своего отчёта и сохраните пользовательские настройки штатной командой. Для чтения памятки после загрузки назначьте соответствующий парный обработчик из соседней страницы. Сохранение выполняется только при вашем ручном действии.

&НаСервере
Процедура ПриСохраненииПользовательскихНастроекНаСервере(Настройки)
    Настройки.ДополнительныеСвойства.Вставить("ПамяткаКниг", "Собственные книги: 3 и 5 шт.");
    Статус = "В сохраняемые настройки добавлена своя памятка";
    Сообщить(Статус);
КонецПроцедуры

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

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

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

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

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

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

1. ДополнительныеСвойства переданного объекта содержат свою памятку; штатный состав полей и отборов не очищен.

2. Вариант и пользовательские настройки сохраняют разные слои. Сам обработчик не вызывает вложенное Сохранить и не создаёт рекурсивное сохранение.

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

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

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

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

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

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

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