Изменение макета документа в 1С: от теории к практике

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

В этой статье мы разберём все этапы работы с макетами — от базовых правок через встроенный конструктор до сложных модификаций с использованием языка 1С и внешних обработок. Особое внимание уделим типичным ошибкам, которые приводят к сбоям при печати или сохранении документов, а также нюансам работы с разными версиями платформы (1С:Предприятие 8.3 и новее). Материал будет полезен как начинающим специалистам, так и опытным программистам, которые хотят систематизировать свои знания.

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

1. Что такое макет документа в 1С и где его искать

Макет документа — это шаблон, который определяет, как будет выглядеть печатная форма, экранная форма или файл экспорта (например, в PDF или Excel). В 1С:Предприятие макеты хранятся внутри конфигурации и привязаны к конкретным объектам: документам, справочникам, отчётам. Их можно редактировать как в режиме 1С:Предприятие, так и в режиме Конфигуратор.

Где искать макеты:

• 📄 Внутри документа: откройте нужный документ (например, Реализация товаров и услуг), перейдите в меню Ещё → Печать или Файл → Печать. Здесь обычно доступны стандартные печатные формы, каждая из которых имеет свой макет.
• 🔧 В конфигураторе: запустите 1С в режиме конфигуратора, найдите в дереве объектов раздел Документы, выберите нужный документ и раскройте ветку Макеты. Здесь хранятся все шаблоны, привязанные к этому объекту.
• 📂 Во внешних обработках: если печатная форма подключена как внешняя обработка, её макет может храниться в отдельном файле с расширением .epf или .erf.

Важно понимать, что макеты бывают разных типов:

• 📑 Табличный документ — самый распространённый тип, используется для печатных форм (например, счёта или накладной). Редактируется через встроенный табличный редактор.
• 🖼️ Текстовый документ — применяется для простых текстовых шаблонов (например, писем или уведомлений).
• 📊 Двоичные данные — используются для хранения графики (логотипов) или сложных шаблонов (например, для Excel).
• 💻 Активный документ — позволяет создавать интерактивные формы с элементами управления (кнопками, полями ввода).

⚠️ Внимание: Если вы работаете с типовой конфигурацией (например, 1С:Бухгалтерия 3.0 или 1С:Управление торговлей 11), будьте осторожны при редактировании стандартных макетов. После обновления конфигурации ваши изменения могут быть утеряны. В таких случаях лучше создавать копии макетов или использовать механизм Расширений.

2. Способы редактирования макетов: от простого к сложному

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

2.1. Редактирование через пользовательский интерфейс (без программирования)

Если нужно внести минимальные изменения — например, добавить логотип, изменить шрифт или перенести колонку в таблице — можно обойтись без программирования:

1. Откройте документ в режиме 1С:Предприятие.
2. Перейдите в меню Печать → Настроить форму (или аналогичный пункт, в зависимости от конфигурации).
3. В открывшемся окне выберите вкладку Макет и нажмите Редактировать.
4. Используйте встроенный редактор для внесения изменений (добавление текста, изображений, изменение выравнивания и т.д.).
5. Сохраните макет и проверьте результат.

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

2.2. Использование конструктора печатных форм

Более гибкий инструмент — Конструктор печатных форм, который доступен в большинстве типовых конфигураций. Он позволяет:

• 🔄 Перетаскивать поля из документа в макет.
• 📊 Настраивать табличные части (добавлять/удалять колонки, менять порядок).
• 🖼️ Вставлять графические элементы (логотипы, подписи).
• 📝 Добавлять статический текст (шапки, подвалы, примечания).

Чтобы открыть конструктор:

1. В режиме Конфигуратор найдите нужный документ.
2. Откройте ветку Макеты и выберите макет печатной формы.
3. Нажмите правой кнопкой мыши и выберите Открыть конструктор печатной формы.

Конструктор автоматически сгенерирует макет на основе структуры документа, после чего вы сможете его доработать.

2.3. Ручное редактирование макета в конфигураторе

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

• 🔧 Менять свойства ячеек (цвет, шрифт, границы).
• 📌 Добавлять формулы и вычисляемые поля.
• 🔄 Настраивать условия отображения отдельных элементов.
• 📊 Работать с группировками и итогами в табличных частях.

Чтобы открыть макет для редактирования:

1. В конфигураторе найдите нужный документ и раскройте ветку Макеты.
2. Дважды кликните на макете — откроется встроенный редактор.
3. Для табличных документов используйте панель инструментов для добавления строк, колонок, объединения ячеек и т.д.
4. Для текстовых макетов доступен редактор с поддержкой синтаксиса 1С (например, для вставки переменных в шаблоны писем).

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

2.4. Программное изменение макетов (для разработчиков)

Если требуется динамическое формирование макета (например, в зависимости от условий или данных документа), придётся писать код на языке 1С. Например, чтобы изменить макет прямо перед печатью:

Процедура ПечатьДокумента(Документ)
Макет = Документ.ПолучитьМакет("ПечатнаяФорма");
ТабДок = Новый ТабличныйДокумент;
ТабДок.Вывести(Макет);

// Меняем заголовок динамически
ТабДок.Область("Заголовок").Текст = "Накладная №" + Документ.Номер + " от " + Формат(Документ.Дата, "ДЛФ=Д");

// Добавляем логотип, если он есть
Если ЗначениеЗаполнено(ПутьКЛоготипу) Тогда
ТабДок.Картинка(ПутьКЛоготипу, 0, 0, 100, 50);
КонецЕсли;

ТабДок.Показать();
КонецПроцедуры

Такой подход позволяет:

• 🔄 Динамически менять содержимое макета в зависимости от данных.
• 📊 Добавлять вычисляемые поля (например, итоги по документу).
• 🖼️ Вставлять графику или штрихкоды "на лету".
• 📑 Формировать несколько вариантов печатной формы из одного макета.

Однако программное изменение требует знания языка 1С и понимания работы с объектами ТабличныйДокумент, ТекстовыйДокумент и другими.

3. Типичные задачи при изменении макетов и их решения

Разберём наиболее распространённые задачи, с которыми сталкиваются пользователи при работе с макетами в 1С, и способы их решения.

3.1. Добавление логотипа компании

Один из самых частых запросов — разместить логотип в шапке документа. Сделать это можно несколькими способами:

• 🖼️ Через конструктор печатных форм:
  1. Откройте макет в конструкторе.
  2. Нажмите Добавить → Картинка.
  3. Выберите файл с логотипом (рекомендуемый формат — .png или .jpg).
  4. Расположите картинку в нужном месте (обычно в верхнем левом углу).
• 🔧 Через программный код (если логотип хранится в справочнике):

  Логотип = Справочники.Организации.НайтиПоНаименованию("ООО Ромашка").Логотип;
  ТабДок.Картинка(Логотип, 10, 10, 100, 40);

Рекомендации:

• 📏 Оптимальный размер логотипа — 100×40 пикселей (можно масштабировать прямо в макете).
• 🎨 Используйте формат PNG с прозрачным фоном, если логотип наносится на цветной фон.
• 🔗 Храните логотип в справочнике Организации, чтобы легко менять его для разных юридических лиц.

3.2. Изменение структуры табличной части

Часто требуется добавить или убрать колонки в таблице документа (например, в накладной). Для этого:

1. Откройте макет в конструкторе печатной формы.
2. Найдите табличную часть (обычно она называется ТаблицаДокумента или Товары).
3. Щёлкните правой кнопкой по заголовку колонки и выберите Добавить колонку или Удалить колонку.
4. Настройте ширину колонок, выравнивание текста и формат данных (например, для цен укажите формат Число 15,2).

Если нужной колонки нет в исходных данных документа, её придётся добавлять программно:

// Добавляем колонку "Скидка %" в табличную часть
ТабДок.Область("Товары_Заголовок").Текст = ТабДок.Область("Товары_Заголовок").Текст + "|Скидка %";
Для Каждого Строка Из Документ.Товары Цикл
ТабДок.Область("Товары_Строка").Текст = ТабДок.Область("Товары_Строка").Текст + "|" + Формат(Строка.Скидка, "Число 5,2");
КонецЦикла;

3.3. Настройка условий отображения элементов

Иногда нужно, чтобы определённые части макета показывались только при выполнении условий. Например, блок "Условия оплаты" может выводиться только для документов с отсрочкой платежа.

Реализовать это можно двумя способами:

• 🔧 Через формулы в макете:
  1. Выделите область, которую нужно скрывать.
  2. В свойствах области укажите условие в поле Условие, например: Документ.УсловияОплаты = Перечисление.УсловияОплаты.Отсрочка

Если Документ.УсловияОплаты = Перечисление.УсловияОплаты.Отсрочка Тогда
ТабДок.Область("УсловияОплаты").Видимость = Истина;
Иначе
ТабДок.Область("УсловияОплаты").Видимость = Ложь;
КонецЕсли;

3.4. Форматирование чисел и дат

Некорректное отображение чисел (например, цен с большим количеством знаков после запятой) или дат (в неудобном формате) — частая проблема. Исправить её можно через настройки формата в макете:

• Выделите ячейку с числом или датой.
• В панели свойств найдите поле Формат.
• Для чисел используйте форматы:
  • Число 15,2 — два знака после запятой.
  • Число 10,0 — целое число без дробной части.
• Для дат подойдут форматы:
  • ДФ=д ММММ г — "01 января 2026".
  • ДФ=д.ММ.гггг — "01.01.2026".

  Пример программного форматирования:

  ТабДок.Область("ДатаДокумента").Текст = Формат(Документ.Дата, "ДЛФ=Д ММММ г");

  3.5. Экспорт макета в Excel или PDF

  Если нужно не только распечатать документ, но и сохранить его в другом формате, используйте следующие методы:

  • 📑 Экспорт в Excel:

    ТабДок.Записать("C:\Temp\Накладная.xlsx", ТипФайлаТабличногоДокумента.XLSX);

  • 📄 Экспорт в PDF:

    ТабДок.Записать("C:\Temp\Накладная.pdf", ТипФайлаТабличногоДокумента.PDF);

  Для PDF можно дополнительно настроить параметры экспорта (качество, ориентацию страницы и т.д.):

  ПараметрыPDF = Новый ПараметрыЭкспортаТабличногоДокументаВPDF;
  ПараметрыPDF.ОриентацияСтраницы = ОриентацияСтраницы.Альбомная;
  ТабДок.Записать("C:\Temp\Накладная.pdf", ТипФайлаТабличногоДокумента.PDF, ПараметрыPDF);

  💡

  Если при экспорте в Excel данные "съезжают" по колонкам, проверьте ширину столбцов в макете. Часто проблема решается явным указанием ширины для каждой колонки через свойство ШиринаКолонки.

  4. Работа с макетами во внешних обработках и расширениях

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

  4.1. Создание внешней печатной формы

  Алгоритм создания внешней обработки для печатной формы:

  1. В конфигураторе создайте новую внешнюю обработку (Файл → Новый → Внешняя обработка).
  2. Добавьте в обработку макет (например, ПечатнаяФорма) и настройте его.
  3. Напишите процедуру формирования документа:

     Процедура Печать(Документ) Экспорт
     Макет = ЭтотОбъект.ПолучитьМакет("ПечатнаяФорма");
     ТабДок = Новый ТабличныйДокумент;
     ТабДок.Вывести(Макет);
     
     // Заполняем данные из документа
     ТабДок.Область("Номер").Текст = Документ.Номер;
     ТабДок.Область("Дата").Текст = Формат(Документ.Дата, "ДЛФ=Д");
     
     ТабДок.Показать();
     КонецПроцедуры

  4. Сохраните обработку в файл (.epf).
  5. Подключите обработку к документу через меню Все функции → Печать (настройте права доступа, если нужно).

  Преимущества внешней обработки:

  • 🔄 Не зависит от обновлений конфигурации.
  • 🔧 Можно быстро править без изменения основной базы.
  • 📂 Легко переносится между базами.

  4.2. Использование расширений конфигурации

  Механизм расширений позволяет модифицировать типовые конфигурации без внесения изменений в их код. Чтобы изменить макет через расширение:

  1. В конфигураторе создайте новое расширение (Конфигурация → Расширения → Добавить).
  2. В дереве расширения найдите нужный документ и его макет.
  3. Скопируйте макет в расширение (Копировать в расширение).
  4. Отредактируйте скопированный макет.
  5. Установите флаг Использовать для расширения и обновите конфигурацию.

  Это самый безопасный способ для типовых конфигураций, так как:

  • 🔄 Изменения не затираются при обновлении.
  • 📋 Легко откатить или изменить.
  • 🔒 Не нарушает поддержку от 1С.

  ⚠️ Внимание: При работе с расширениями учитывайте, что некоторые макеты могут быть "залочены" разработчиками типовых конфигураций. В этом случае их нельзя модифицировать даже через расширение — придётся использовать внешние обработки.

  Как проверить, можно ли изменить макет через расширение?

  В конфигураторе откройте свойства макета и посмотрите на флаг "Запрет изменения". Если он установлен, макет можно править только через внешнюю обработку или программно.

  5. Ошибки при работе с макетами и способы их исправления

  Даже опытные разработчики сталкиваются с ошибками при изменении макетов. Разберём самые распространённые проблемы и их решения.

  Ошибка	Возможная причина	Способ исправления
  При печати вылетает ошибка "Недопустимый тип данных"	В макете используется поле, которого нет в документе, или неверный формат данных.	Проверьте соответствие имён полей в макете и в документе. Используйте отладчик для поиска проблемного участка.
  Документ печатается пустым или без данных	Неверно указан источник данных для макета или нарушена привязка областей.	Откройте макет в конструкторе и проверьте привязку полей. Убедитесь, что документ передан в процедуру печати.
  "Съезжают" колонки при экспорте в Excel	Ширина колонок в макете не соответствует ширине в Excel или используются объединённые ячейки.	Явно задайте ширину колонок в макете или используйте параметры экспорта с фиксированной шириной.
  Логотип не отображается в печатной форме	Неверный путь к файлу логотипа или неверный формат изображения.	Проверьте, что файл логотипа существует и доступен. Используйте относительные пути или храните логотип в справочнике.
  Изменения макета не применяются после сохранения	Макет заблокирован для изменений или кэшируется системой.	Проверьте права доступа в конфигураторе. Очистите кэш 1С или перезапустите сеанс.

  Некоторые ошибки можно диагностировать с помощью отладчика:

  1. В конфигураторе поставьте точку останова в процедуре формирования печатной формы.
  2. Запустите отладку (Отладка → Начать отладку).
  3. Просмотрите значения переменных и состояние макета на каждом этапе.

  Если макет "ломается" после обновления конфигурации, проверьте:

  • 🔄 Не были ли перезаписаны ваши изменения стандартными макетами.
  • 📋 Соответствуют ли имена полей в макете актуальной структуре документа.
  • 🔧 Не изменились ли форматы данных (например, вместо Число теперь используется Дробь).

  ⚠️ Внимание: Если после изменения макета документ перестал сохраняться или появились ошибки при проведении, скорее всего, вы нарушили целостность данных. В этом случае восстановите макет из резервной копии и вносите изменения поэтапно, проверяя результат после каждого шага.

  💡

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

  6. Оптимизация макетов для печати и экспорта

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

  6.1. Настройка полей и ориентации страницы

  Чтобы документ хорошо выглядел на бумаге:

  • 📏 Установите поля страницы:

    ТабДок.ПолеВерхнее = 10;  // 10 мм
    ТабДок.ПолеНижнее = 10;
    ТабДок.ПолеЛевое = 15;
    ТабДок.ПолеПравое = 10;

  • 🔄 Выберите ориентацию:

    ТабДок.ОриентацияСтраницы = ОриентацияСтраницы.Альбомная;

  • 📄 Настройте размер бумаги:

    ТабДок.УстановитьРазмерСтраницы(210, 297); // A4 в мм

  6.2. Разбиение длинных таблиц на страницы

  Если табличная часть документа не помещается на одну страницу, используйте:

  • 📋 Автоматическое разбиение:

    ТабДок.ТолькоПросмотр = Ложь;
    ТабДок.ПоказатьСетку = Ложь;
    ТабДок.АвтоВысотаСтрок = Истина;

  • 🔧 Ручное управление разрывами:

    ТабДок.НоваяСтраница(); // Принудительный разрыв страницы

  • 📊 Группировку данных:

    ТабДок.Область("ШапкаГруппы").ПовторятьНаКаждойСтранице = Истина;

  6.3. Оптимизация для экспорта в Excel

  Чтобы данные корректно экспортировались в Excel:

  • 📑 Используйте простые форматы данных (избегайте сложных формул в ячейках).
  • 🔢 Указывайте явную ширину колонок:

    ТабДок.Колонка(1).Ширина = 50; // Ширина первой колонки в символах

  • 📊 Отключите объединение ячеек, если оно не нужно:

    ТабДок.ОбъединениеЯчеек = Ложь;

  • 🔧 Экспортируйте с явным указанием типа файла:

    ТабДок.Записать("Отчёт.xlsx", ТипФайлаТабличногоДокумента.XLSX, ПараметрыЭкспорта);

  6.4. Ускорение формирования макетов

  Если печатная форма формируется слишком долго (например, при большом количестве строк в таблице), используйте следующие приёмы:

  • 🔄 Отключите ненужные вычисления:

    ТабДок.АвтоВысотаСтрок = Ложь; // Ускоря