Добавление дополнительного реквизита в печатную форму 1С: полное руководство с примерами

Добавление дополнительных реквизитов в печатные формы 1С:Предприятие — одна из самых востребованных задач среди разработчиков и пользователей системы. Без этого умения невозможно адаптировать документы под специфические бизнес-процессы компании, добавить логотип, подписи ответственных лиц или уникальные поля, которых нет в стандартной конфигурации. Однако процесс требует не только знания синтаксиса встроенного языка 1С, но и понимания структуры печатных форм, механизмов СКД (системы компоновки данных) и особенностей конкретной версии платформы.

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

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

1. Подготовка: какие инструменты понадобятся

Для добавления реквизитов в печатную форму вам потребуется:

• 🖥️ Конфигуратор 1С с правами администратора (режим "1С:Предприятие" не подходит).
• 📄 Текстовый редактор для работы с макетами (например, Notepad++ или встроенный в конфигуратор).
• 🔍 Понимание структуры документа, в который добавляется реквизит (например, Документ.РеализацияТоваровУслуг).
• 📊 Знание языка запросов 1С (если реквизит требует данных из других таблиц).

Если вы работаете с управляемыми формами (версия 8.3 и выше), проверьте, не блокирует ли ваша конфигурация редактирование печатных форм. Некоторые типовые решения (например, 1С:ERP или 1С:УТ 11) используют защищённые модули, и для изменений потребуется отключить "режим совместимости" или использовать расширения.

⚠️ Внимание: В конфигурациях на базе БСП 3.0 (библиотека стандартных подсистем) печатные формы могут храниться в отдельных объектах метаданных. Перед редактированием проверьте раздел Общие → ПечатныеФормы в дереве конфигурации.

Также подготовьте тестовые данные. Например, если вы добавляете реквизит ДополнительныйКомментарий в документ ЗаказПокупателя, создайте несколько тестовых заказов с заполненным этим полем. Это поможет сразу проверить корректность вывода.

2. Способы добавления реквизитов: какой выбрать

В 1С:Предприятие есть три основных способа добавить реквизит в печатную форму. Выбор зависит от задачи и версии платформы:

Для большинства задач по добавлению одного-двух реквизитов достаточно редактирования макета или модуля. СКД целесообразно использовать, если вам нужно:

• 📈 Выводить данные из связанных таблиц (например, остатки товаров на дату документа).
• 🔄 Динамически изменять структуру формы в зависимости от условий.
• 📊 Группировать данные (например, по контрагентам или номенклатуре).

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

3. Пошаговая инструкция: добавляем реквизит через макет

Рассмотрим самый распространённый сценарий: добавление дополнительного реквизита в печатную форму документа РеализацияТоваровУслуг. Предположим, нам нужно вывести поле ДополнительныеУсловия, которое пользователи заполняют в форме документа.

Открыть конфигуратор в режиме "1С:Предприятие"|Найти документ в дереве метаданных|Перейти в раздел "Печатные формы"|Создать копию макета (на случай ошибок)-->

Шаг 1. Откройте макет печатной формы

В дереве конфигурации найдите ветку Документы → РеализацияТоваровУслуг → ПечатныеФормы. Кликните правой кнопкой по нужной форме (например, Торг12) и выберите Открыть макет. Если форма основана на СКД, вам потребуется редактировать схему компоновки данных (об этом — в следующем разделе).

Шаг 2. Добавьте поле в макет

В открывшемся дизайнере макетов:

1. Найдите область, куда нужно вставить реквизит (например, после таблицы с товарами).
2. Добавьте текстовый блок с названием поля (например, "Дополнительные условия:").
3. Рядом добавьте поле вывода данных. В его свойствах укажите источник данных — ДокументОбъект.ДополнительныеУсловия.

Шаг 3. Настройте параметры отображения

Убедитесь, что:

• 📏 Поле имеет достаточную ширину (иначе длинный текст обрежется).
• 🔗 Привязка к данным корректна (проверьте в свойствах поля ИсточникДанных).
• 🖼️ Если реквизит может быть пустым, настройте условие видимости (например, Видимость = Не ДокументОбъект.ДополнительныеУсловия = "").

Шаг 4. Сохраните и протестируйте

Сохраните макет (Файл → Сохранить) и обновите конфигурацию базы данных (Конфигурация → Обновить конфигурацию базы данных). Затем откройте тестовый документ в режиме 1С:Предприятие и проверьте печатную форму. Если поле не отображается, вернитесь в макет и проверьте:

• Правильно ли указан ИсточникДанных?
• Есть ли данные в реквизите документа?
• Не скрыто ли поле условием видимости?

4. Добавление реквизита через код модуля

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

Шаг 1. Найдите процедуру печати

В дереве конфигурации откройте модуль документа (например, Документ.РеализацияТоваровУслуг) и найдите процедуру, отвечающую за печать. Обычно она называется Печать() или СформироватьПечатнуюФорму(). Если её нет, проверьте общие модули или модуль менеджера документа.

Шаг 2. Добавьте обработку реквизита

Вставьте в процедуру код для формирования значения. Например, для вывода суммы прописью:

Процедура Печать(МассивОбъектов, КоллекцияПечатныхФорм, ОбъектыПечати, ПараметрыПечати) Экспорт
// ... существующий код ...

// Добавляем сумму прописью
СуммаПрописью = ЧислоПрописью(ДокументОбъект.СуммаДокумента, Ложь, "", "", "руб.", "коп.");
ПараметрыПечати.Вставить("СуммаПрописью", СуммаПрописью);

// ... остальной код ...
КонецПроцедуры

Шаг 3. Измените макет для вывода нового поля

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

Параметры.СуммаПрописью

Шаг 4. Проверьте результат

Обновите конфигурацию и протестируйте печать. Убедитесь, что:

• 💰 Сумма прописью отображается корректно (например, "Десять тысяч рублей 00 копеек").
• 🔢 Форматирование сохраняется при разных суммах (например, для 1 000 000 руб.).
• 📄 Поле не наезжает на другие элементы формы.

⚠️ Внимание: Если вы используете управляемые формы, код может находиться в модуле команды печати (например, в обработчике события ПередЗаписью или ПриСозданииНаСервере). В этом случае поищите процедуру с именем вроде СформироватьПечатнуюФормуСервер().

5. Работа с системой компоновки данных (СКД)

Если печатная форма основана на СКД, алгоритм добавления реквизита будет другим. Рассмотрим процесс на примере отчёта АктВыполненныхРабот.

Шаг 1. Откройте схему компоновки данных

В дереве конфигурации найдите печатную форму и откройте её схему компоновки (Открыть схему компоновки данных). Перейдите на вкладку Наборы данных.

Шаг 2. Добавьте реквизит в запрос

Найдите основной запрос (обычно ОсновнойНаборДанных) и добавьте в него нужное поле. Например, чтобы вывести ДатаОплаты:

ВЫБРАТЬ
РеализацияТоваровУслуг.Ссылка КАК Ссылка,
// ... другие поля ...
РеализацияТоваровУслуг.ДатаОплаты КАК ДатаОплаты
ИЗ
Документ.РеализацияТоваровУслуг КАК РеализацияТоваровУслуг
ГДЕ
РеализацияТоваровУслуг.Ссылка В(&СписокОбъектов)

Шаг 3. Настройте вывод в макете

Перейдите на вкладку Макет и добавьте новое поле в нужную область. В свойствах поля укажите путь к данным, например:

Данные.ОсновнойНаборДанных.ДатаОплаты

Шаг 4. Обновите настройки отчёта

На вкладке Настройки проверьте, что новое поле добавлено в пользовательские настройки (раздел Поля). Если поле должно отображаться всегда, установите флаг Видимость = Истина.

Шаг 5. Тестирование

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

• 🔍 Проверьте синтаксис запроса (возможно, ошибка в имени поля).
• 📌 Убедитесь, что поле добавлено в Наборы данных и в Макет.
• 🔄 Обновите кэш метаданных (Конфигурация → Поддержка → Обновить кэш метаданных).

6. Типичные ошибки и как их избежать

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

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

1. Откройте список расширений (Конфигурация → Расширения).
2. Найдите расширение, которое может влиять на печатную форму.
3. Отключите его временно и проверьте, применяются ли ваши изменения.

Если после обновления платформы 1С печатные формы перестали работать, проверьте режим совместимости. В новых версиях 8.3.20+ некоторые методы работы с макетами устарели. Используйте актуальные методы, например:

// Старый метод (может не работать в новых версиях)
Макет.ПолучитьОбласть("Заголовок").Параметры.Дата = ТекущаяДата();

// Новый метод
Область = Макет.ПолучитьОбласть("Заголовок");
Область.Параметры.УстановитьЗначениеПараметра("Дата", ТекущаяДата());

7. Оптимизация и дополнительные возможности

Добавление реквизитов — только первый шаг. Чтобы печатные формы были действительно удобными, воспользуйтесь этими советами:

• 🖼️ Добавьте логотип компании. Для этого в макет формы вставьте картинку (формат .jpg или .png) и привяжите её к параметру. Логотип можно хранить в справочнике Организации или в отдельном каталоге.
• 📌 Используйте условное оформление. Например, выделяйте красным цветом просроченные документы или зелёным — оплаченные. Это можно сделать через свойства поля в макете или в коде:

Если ДокументОбъект.Статус = Перечисление.СтатусыДокументов.Оплачен Тогда
ПараметрыПечати.Вставить("ЦветСтатуса", Новый Цвет(0, 255, 0)); // Зелёный
КонецЕсли;

• 📊 Группируйте данные. Если в форме выводится таблица с большим количеством строк (например, номенклатура), добавьте группировку по категориям или контрагентам. В СКД это делается на вкладке Группировки.
• 🔒 Защитите форму от изменений. Если печатная форма используется для официальных документов, запретите её редактирование пользователям. Для этого в модуле формы добавьте проверку прав:

Если НЕ Пользователь.ЭтоАдминистратор() Тогда
Сообщить("Редактирование печатной формы запрещено!");
Возврат;
КонецЕсли;

Для сложных форм (например, УПД или Торг-12) полезно создать несколько вариантов макетов и дать пользователю выбор. Например:

Процедура Печать(МассивОбъектов, КоллекцияПечатныхФорм, ОбъектыПечати, ПараметрыПечати) Экспорт
ВариантПечати = Вопрос("Использовать полную форму?", РежимДиалогаВопрос.ДаНет);
Если ВариантПечати Тогда
Макет = Документы.РеализацияТоваровУслуг.ПечатныеФормы.Торг12Полная;
Иначе
Макет = Документы.РеализацияТоваровУслуг.ПечатныеФормы.Торг12Краткая;
КонецЕсли;
// ... остальной код ...
КонецПроцедуры

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

8. Тестирование и внедрение изменений

Перед тем как передавать изменённую печатную форму пользователям, обязательно проведите тестирование. Вот чек-лист для проверки:

Проверить отображение нового реквизита в разных документах|Убедиться, что форма корректно экспортируется в PDF/Excel|Протестировать печать пакета документов|Проверьте работу формы на слабом ПК (если пользователи работают на старых машинах)|Сохраните тестовую версию формы на случай отката-->

Шаг 1. Тестирование на разных данных

Проверьте печатную форму с:

• 📄 Документами с пустыми реквизитами (чтобы убедиться, что форма не "ломается").
• 📄 Документами с максимально длинными значениями (например, комментарий на 1000 символов).
• 📄 Документами разных статусов (черновик, проведённый, отменённый).

Шаг 2. Проверка экспорта

Убедитесь, что форма корректно экспортируется в другие форматы:

• 📄 PDF — проверьте читаемость шрифтов и расположение элементов.
• 📄 Excel — убедитесь, что данные не разбиваются по столбцам неправильно.
• 📄 HTML — если форма используется для отправки по email.

Шаг 3. Оптимизация производительности

Если печатная форма формируется слишком долго (более 5 секунд), проверьте:

• 🔍 Запросы — возможно, они извлекают лишние данные. Используйте ИНДЕКСИРОВАТЬ ПО для крупных таблиц.
• 🖼️ Изображения — уменьшите их размер или используйте сжатие.
• 📊 Сложные вычисления — перенесите их в фоновые задачи, если возможно.

Шаг 4. Документирование изменений

Создайте краткую инструкцию для пользователей, особенно если:

• 📝 Добавлены новые поля, которые нужно заполнять вручную.
• 🔄 Изменилась логика формирования формы (например, теперь нужно выбирать вариант печати).
• ⚠️ Есть ограничения (например, "поле 'Комментарий' не должно превышать 500 символов").

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

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

FAQ: Частые вопросы по добавлению реквизитов

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

Видимость = Параметры.ПоказатьДополнительныеДанные

ВЫБРАТЬ
ЗаказПокупателя.Номер КАК НомерЗаказа,
ЗаказПокупателя.Дата КАК ДатаЗаказа
ИЗ
Документ.ЗаказПокупателя КАК ЗаказПокупателя
ГДЕ
ЗаказПокупателя.Ссылка = &СсылкаНаЗаказ