Как создать внешний макет 1С: Полное руководство

Разработка отчетов и печатных форм в системе 1С:Предприятие часто требует гибкости, которую стандартные средства не всегда могут обеспечить. Именно здесь на сцену выходят внешние макеты. Это мощный инструмент, позволяющий программисту управлять структурой документа, форматированием и логикой отображения данных без жесткой привязки к конфигурации метаданных.

Создание внешнего макета — это процесс, который объединяет в себе навыки работы с Компоновкой Данных (СКД) и знание объектной модели ТабличныйДокумент. Вам предстоит не просто нарисовать красивую таблицу, а запрограммировать взаимодействие между выборкой из базы и ячейками отчета.

Использование внешних макетов дает полную свободу действий. Вы можете динамически менять шрифты, объединять ячейки, вставлять графики и даже формировать многостраничные документы сложной структуры. Однако, эта свобода налагает ответственность: весь дизайн и логика ложатся на плечи разработчика.

Подготовка данных и структура запроса

Прежде чем приступать к визуализации, необходимо четко понимать, какие именно данные будут выводиться. Основой любого отчета в 1С является запрос. Ошибки на этом этапе приводят к тому, что макет приходится переделывать с нуля, так как структура полей не соответствует ожидаемой.

Для начала определите набор полей, которые потребуются пользователю. Это могут быть справочные данные, суммы, количества или вычисляемые показатели. Рекомендуется использовать временные таблицы для предварительной обработки данных, чтобы разгрузить основной запрос вывода.

Оптимизация запросов

Если ваш отчет работает медленно, проверьте использование индексов в запросе. Часто проблема кроется не в макете, а в отсутствии оптимальных путей выборки данных из таблиц ИБ.

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

• 📊 Определите итоговые поля для группировок.
• 🔍 Проверьте типы данных (Число, Строка, Дата).
• ⚙️ Настройте параметры отчета для фильтрации.

После формирования текстов запроса, протестируйте его в консоли запросов. Убедитесь, что он возвращает корректный результат при различных входных параметрах. Только после этого можно переходить к следующему этапу.

Создание схемы компоновки данных (СКД)

Схема компоновки данных служит прослойкой между "сырыми" данными запроса и тем, что видит пользователь. В контексте внешнего макета СКД часто используется как источник данных для заполнения областей макета.

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

⚠️ Внимание: При использовании СКД во внешнем макете помните, что лишние вычисления в схеме могут замедлить формирование отчета. Отключайте ненужные вычисления итогов, если они не требуются для конкретной печатной формы.

Далее необходимо настроить наборы данных. Именно наборы данных определяют, какие поля будут доступны для размещения в макете. Вы можете создать несколько наборов для разных частей отчета, например, один для "шапки" документа, а другой для табличной части.

Не забудьте настроить поля вывода. Для каждого поля укажите заголовок, который будет отображаться в отчете, и тип данных. Это упростит дальнейшую работу с объектом КомпоновщикНастроекКомпоновкиДанных.

Разработка макета в табличном документе

Теперь переходим к самой интересной части — дизайну. Внешний макет в 1С чаще всего реализуется на базе объекта ТабличныйДокумент. Это универсальный инструмент, позволяющий верстать отчеты с пиксельной точностью.

Создайте новый внешний макет в дереве метаданных или загрузите его из файла. Откройте редактор макета. Здесь вы работаете с ячейками, стилями и областями. Каждая значимая часть отчета должна быть оформлена как отдельная Область.

Для заголовков, шапки документа, табличной части и подвалов создавайте именованные области. Имя области критически важно, так как именно по этому имени вы будете обращаться к ней в коде программы. Используйте префиксы для удобства, например, Область_Шапка или Область_СтрокаТовара.

Тип области	Назначение	Пример имени
Заголовок	Название отчета, логотип	Header_Main
Шапка	Реквизиты документа, контрагент	Doc_Header
Детальные записи	Строки табличной части	Row_Item
Итоги	Подсчет сумм и количеств	Footer_Total

Настройте стили ячеек. Задайте шрифты, выравнивание, границы и форматирование чисел прямо в редакторе макета. Это избавит вас от необходимости прописывать эти настройки в коде, делая программу чище и быстрее.

Программное заполнение макета

Связывание данных и визуальной части происходит в модуле объекта или обработки. Вам необходимо получить объект макета, создать экземпляр табличного документа и начать последовательное заполнение областей.

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

Макет = ПолучениеМакета("ВнешнийМакетОтчета");
ТабДок = Новый ТабличныйДокумент;
ТабДок.ОтображатьСетку = Ложь;

// Вывод заголовка
Область = Макет.ПолучитьОбласть("Заголовок");
ТабДок.Вывести(Область);

Особое внимание уделите циклу вывода табличной части. Используйте метод Вывести с параметрами замещения значений. Это позволяет передать значения полей запроса прямо в область, если имена полей совпадают с именами параметров области.

Если автоматическое замещение не подходит, используйте точечную запись в ячейки: Область.Параметры.Заполнить(СтрокаДанных). Это дает полный контроль над тем, какое значение попадет в какую ячейку.

⚠️ Внимание: При большом количестве строк (более 10 000) создание отдельной области для каждой строки может потребовать значительных ресурсов памяти. В таких случаях рассмотрите возможность использования стандартных средств СКД для вывода основной массы данных.

Настройка печати и экспорта

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

Для вывода на экран вызывается метод Показать(). Он открывает стандартное окно просмотра, где пользователь может масштабировать документ, искать текст и инициировать печать. Для автоматической отправки на принтер используется метод Печатать().

Современные требования часто предполагают экспорт данных в другие форматы. 1С поддерживает экспорт в PDF, Excel, HTML и текстовые файлы. Метод Записать позволяет сохранить результат работы макета в файл с указанным расширением.

При экспорте в Excel важно сохранить форматирование. Убедитесь, что в макете не используются элементы, которые не поддерживаются табличными процессорами, например, сложные градиенты или специфические шрифты, отсутствующие на машине пользователя.

Типовые ошибки и оптимизация

Разработка внешних макетов сопряжена с рядом типичных проблем. Одна из самых частых — рассинхронизация структуры макета и кода. Если вы переименовали область в макете, но забыли изменить имя в коде, система выдаст ошибку при выполнении.

Другая распространенная проблема — неверное форматирование чисел и дат. Даты могут выводиться в американском формате (месяц/день/год), что недопустимо для российской бухгалтерии. Решается это установкой соответствующего формата в свойствах поля макета или в коде.

Оптимизация скорости работы достигается за счет минимизации операций с объектом ТабличныйДокумент. Не выводите документ построчно в цикле, если это возможно. Лучше сформируйте массив областей и выведите их пакетно, хотя в 1С механизм вывода обычно оптимизирован достаточно хорошо.

Также стоит упомянуть проблему с кодировкой при экспорте в текстовые файлы. Всегда явно указывайте кодировку UTF8 или Windows-1251 при записи файлов, чтобы избежать появления "кракозябр" вместо русских букв.

Можно ли использовать один макет для разных видов отчетов?

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

Как добавить логотип компании в макет?

Логотип можно вставить прямо в ячейку макета в режиме редактирования через меню "Вставка → Картинка". Либо программно загрузить изображение из базы данных или файла и присвоить его свойству Картинка у области.

Почему при печати обрезается правая часть отчета?

Скорее всего, ширина макета превышает ширину печатного поля страницы. Проверьте настройки страницы в макете (поля, ориентация) и убедитесь, что документ помещается в формат А4 или А3.

Допустимо ли менять структуру макета вruntime?

Технически возможно добавлять строки и колонки программно, но это считается плохим тоном и усложняет отладку. Структуру лучше закладывать статически в конфигураторе, а динамически менять только содержимое ячеек.