БиблиотекаМакетовОформленияКомпоновкиДанных.Яркий

Сравнить девять встроенных оформлений одного отчёта СКД

Каждое встроенное свойство библиотеки даёт готовый макет, который реально участвует в компоновке. Девять независимых отчётов используют одинаковые данные; сравниваем оформление, не подменяя данные.

Подготовка

1. Создайте НОВУЮ отдельную файловую учебную базу платформы 8.5.1.1343, имя конфигурации УчебноеОформлениеСКД85, совместимость НеИспользовать, обычное приложение и толстый клиент. Не запускайте в рабочей базе. Здесь код и UI не выполнялись: runtimeVerifiedScenarios=0.

2. Создайте неглобальный общий модуль УчебноеОформление85: Клиент (обычное приложение)=Да, Сервер=Нет, остальные клиентские флаги=Нет, Привилегированный=Нет. Полный модуль выбранного урока вставляется целиком, не внутрь обработчика. Директивы управляемой формы сюда не добавляйте.

3. Создайте собственную обработку УчебноеОформление85 с обычной основной формой Пульт. Кнопка Выполнить, действие ВыполнитьНажатие. Полный отдельный модуль формы приведён ниже. Проверьте назначение действия и F7 перед будущим запуском.

4. Данные строятся запросом Local из двух константных строк: Книга — 3 штуки по 250, сумма 750; Ручка — 1 штука по 50, сумма 50. Всего 4 единицы и 800. Справочники, документы, регистры, SQL-соединения и внешний сервер не нужны.

5. Не создавайте собственные общие макеты оформления для первого опыта. Библиотека содержит системные варианты и может содержать конфигурационные; число/порядок/представления не жёстко зашиты. Современный и Такси требуют 8.3.22 или новее, здесь целевая 8.5.1.1343.

6. Каждый итог создаётся в новом ТабличномДокументе и показывается без имени файла. Не выбирайте команды печати/сохранения. Показать открывает собственное окно и допускает редактирование: это не readonly и не доказательство запрета записи правами.

7. Первый урок показывает один выбранный вариант, второй — девять отдельных учебных окон. Закрывайте только эти свои окна вручную. Повторяйте урок отдельно; реальные окна, 1С, принтер, файл и сеть здесь не запускались.

Процедура ВыполнитьПример() Экспорт
    ПроверитьСвойКонтекст();
    Библиотека = БиблиотекаМакетовОформленияКомпоновкиДанных;
    Варианты = Новый Массив;
    Варианты.Добавить(Новый Структура("Подпись,Макет", "Античный", Библиотека.Античный));
    Варианты.Добавить(Новый Структура("Подпись,Макет", "Арктика", Библиотека.Арктика));
    Варианты.Добавить(Новый Структура("Подпись,Макет", "Без оформления", Библиотека.БезОформления));
    Варианты.Добавить(Новый Структура("Подпись,Макет", "Зеленый", Библиотека.Зеленый));
    Варианты.Добавить(Новый Структура("Подпись,Макет", "Море", Библиотека.Море));
    Варианты.Добавить(Новый Структура("Подпись,Макет", "Основной", Библиотека.Основной));
    Варианты.Добавить(Новый Структура("Подпись,Макет", "Современный", Библиотека.Современный));
    Варианты.Добавить(Новый Структура("Подпись,Макет", "Такси", Библиотека.Такси));
    Варианты.Добавить(Новый Структура("Подпись,Макет", "Яркий", Библиотека.Яркий));
    Если Варианты.Количество() <> 9 Тогда
        ВызватьИсключение "В собственном сравнении должны быть девять явных вариантов";
    КонецЕсли;
    Для Каждого Вариант Из Варианты Цикл
        Если ТипЗнч(Вариант.Макет) <> Тип("МакетОформленияКомпоновкиДанных") Тогда
            ВызватьИсключение "Свойство встроенного оформления возвращает макет, не элемент библиотеки";
        КонецЕсли;
        Отчет = СформироватьСвойОтчет(Вариант.Макет);
        Отчет.Показать("Свой отчет: " + Вариант.Подпись, "", Ложь);
    КонецЦикла;
    Сообщить("Сформированы девять отдельных учебных отчетов из одинаковых двух строк");
КонецПроцедуры

Процедура ПроверитьСвойКонтекст()
    Если Метаданные.РежимСовместимости <> Метаданные.СвойстваОбъектов.РежимСовместимости.НеИспользовать Тогда
        ВызватьИсключение "Нужен собственный стенд УчебноеОформлениеСКД85 платформы 8.5.1.1343";
    КонецЕсли;
    Если ТранзакцияАктивна() Тогда
        ВызватьИсключение "Учебный вывод не должен выполняться внутри чужой транзакции";
    КонецЕсли;
КонецПроцедуры

Функция СформироватьСвойОтчет(Оформление)
    Если ТипЗнч(Оформление) <> Тип("МакетОформленияКомпоновкиДанных") Тогда
        ВызватьИсключение "Компоновщику нужен макет оформления, не элемент библиотеки";
    КонецЕсли;
    Схема = Новый СхемаКомпоновкиДанных;
    Источник = Схема.ИсточникиДанных.Добавить();
    Источник.Имя = "УчебныйИсточник";
    Источник.ТипИсточникаДанных = "Local";
    Набор = Схема.НаборыДанных.Добавить(Тип("НаборДанныхЗапросСхемыКомпоновкиДанных"));
    Набор.Имя = "УчебныеТовары";
    Набор.ИсточникДанных = Источник.Имя;
    Набор.АвтоЗаполнениеДоступныхПолей = Истина;
    Набор.Запрос = "ВЫБРАТЬ
    |    ""Книга"" КАК Наименование,
    |    3 КАК Количество,
    |    250 КАК Цена,
    |    750 КАК Сумма
    |ОБЪЕДИНИТЬ ВСЕ
    |ВЫБРАТЬ ""Ручка"", 1, 50, 50";
    Настройки = Схема.НастройкиПоУмолчанию;
    Для Каждого ИмяПоля Из СтрРазделить("Наименование,Количество,Цена,Сумма", ",") Цикл
        Выбранное = Настройки.Выбор.Элементы.Добавить(Тип("ВыбранноеПолеКомпоновкиДанных"));
        Выбранное.Поле = Новый ПолеКомпоновкиДанных(ИмяПоля);
        Выбранное.Использование = Истина;
    КонецЦикла;
    Детали = Настройки.Структура.Добавить(Тип("ГруппировкаКомпоновкиДанных"));
    Детали.Использование = Истина;
    АвтоВыбор = Детали.Выбор.Элементы.Добавить(Тип("АвтоВыбранноеПолеКомпоновкиДанных"));
    АвтоВыбор.Использование = Истина;
    Компоновщик = Новый КомпоновщикМакетаКомпоновкиДанных;
    Макет = Компоновщик.Выполнить(Схема, Настройки, , Оформление,
        Тип("ГенераторМакетаКомпоновкиДанных"));
    Процессор = Новый ПроцессорКомпоновкиДанных;
    Процессор.Инициализировать(Макет);
    Документ = Новый ТабличныйДокумент;
    Вывод = Новый ПроцессорВыводаРезультатаКомпоновкиДанныхВТабличныйДокумент;
    Вывод.УстановитьДокумент(Документ);
    Итог = Вывод.Вывести(Процессор, Ложь);
    Если ТипЗнч(Итог) <> Тип("ТабличныйДокумент") Тогда
        ВызватьИсключение "Свой вывод СКД должен вернуть табличный документ";
    КонецЕсли;
    Возврат Итог;
КонецФункции

Процедура ВыполнитьНажатие(Кнопка)
    УчебноеОформление85.ВыполнитьПример();
КонецПроцедуры

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

1. Создаём явный список девяти пар Подпись/Макет. У каждой пары собственное системное свойство: Античный, Арктика, БезОформления, Зеленый, Море, Основной, Современный, Такси и Яркий.

2. Встроенные свойства readonly и возвращают сразу МакетОформленияКомпоновкиДанных. В отличие от Получить/Найти библиотеки, у результата не надо вызывать ПолучитьМакет.

3. СформироватьСвойОтчет проверяет тип и заново строит одну и ту же Local-схему из двух строк. Четвёртый параметр компоновщика меняется, запрос и выбранные поля — нет.

4. ГенераторМакетаКомпоновкиДанных и табличный приёмник соответствуют друг другу. Возвращённый Вывести результат проверяется как ТабличныйДокумент.

5. Каждый Показать получает подпись своего варианта, пустое имя файла и Ложь для активизации. Ни один общий макет не редактируется, предыдущий процессор не используется повторно.

6. После будущего запуска сравните цвета, шрифты и области, доступные этой простой структуре. Название стиля само по себе не гарантирует заметное отличие каждого элемента отчёта.

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

1. Будущий ручной тест: создаются девять собственных окон с разными подписями. Во всех Книга имеет 3/250/750, Ручка — 1/50/50; оформление не меняет арифметику.

2. Поставьте точку останова у Вариант.Макет: во всех девяти итерациях его тип МакетОформленияКомпоновкиДанных. ЭлементБиблиотекиМакетовОформленияКомпоновкиДанных здесь не ожидается.

3. В копии кода измените цену Книги в общем SCHEMA и согласуйте Сумма: изменение данных будет одинаковым для всех вариантов. Это отдельное изменение запроса, не действие оформления.

4. Закройте только собственные окна. Для повторного сравнения запускайте урок заново; макеты библиотеки и бизнес-данные остаются неизменными.

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

Подготовлено сравнение девяти реальных макетов на одинаковом отчёте, без заглушек, записи, печати или сети. runtimeVerifiedScenarios=0.

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

1. БезОформления — реальный макет оформления, не Неопределено: отсутствие необязательного четвёртого аргумента означает оформление по умолчанию, это другой опыт.

2. Современный и Такси появились с 8.3.22. Режим совместимости и версии надо проверять отдельно, не считать свойства универсальными для старых баз.

3. Не изменяйте возвращённый системный макет ради эксперимента и не обещайте его независимую глубокую копию. Здесь он только передаётся в компоновщик.

4. Показать создаёт редактируемое окно; никакой автоматической печати/сохранения нет. Здесь девять окон не открывались, визуальное сравнение относится к будущему ручному тесту.

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