Разработка внешних печатных форм (ВПФ) в современных конфигурациях 1С, использующих Библиотеку стандартных подсистем (БСП), требует строгого соблюдения определенных стандартов. Даже небольшое отклонение в количестве параметров или логике обращения к данным приводит к отказу системы. В данной статье мы подробно разберем, почему возникают ошибки при печати «Расходной накладной» и как привести код в соответствие с требованиями платформы 1С:Предприятие 8.3.
Эта ошибка — одна из самых распространенных при создании ВПФ. Давайте выясним причину ее возникновения. В современных конфигурациях (УТ 11, ERP, Управление аптечной сетью) механизм печати реализован через БСП. Когда пользователь нажимает кнопку «Печать», система ищет в модуле объекта внешней обработки экспортную процедуру Печать.
Проанализируем ситуацию: платформа ожидает, что процедура Печать примет ровно 4 параметра. Если в вашем коде процедура объявлена без параметров или с другим их количеством, система выдает ошибку о несоответствии. Рассмотрим, как должна выглядеть правильная сигнатура процедуры:
Процедура Печать(МассивОбъектов, КоллекцияПечатныхФорм, ОбъектыПечати, ПараметрыВывода) Экспорт
// Здесь начинается логика формирования печатной формы
КонецПроцедуры
Где:
МассивОбъектов — содержит ссылки на документы, которые выбрал пользователь для печати.КоллекцияПечатныхФорм — таблица, в которую мы должны поместить результат формирования (табличный документ).ОбъектыПечати — служебный параметр для связи объектов и страниц.ПараметрыВывода — дополнительные настройки печати.Эта проблема возникает на следующем этапе. Вы исправили количество параметров, но система все равно сообщает, что документ не сформирован. Разберем по шагам, почему это происходит. Система БСП «ждет», что внутри процедуры Печать вы не просто создадите ТабличныйДокумент, а зарегистрируете его в КоллекцияПечатныхФорм с определенным идентификатором.
Этот идентификатор должен в точности совпадать с тем, который вы указали в функции СведенияОВнешнейОбработке. Если в регистрации вы написали РасходнаяНакладная, то и в коллекцию нужно выводить данные с этим же именем. Посмотрим на пример правильного заполнения коллекции:
// Проверяем, нужно ли формировать именно нашу печатную форму
ПечатнаяФорма = УправлениеПечатью.СведенияОПечатнойФорме(КоллекцияПечатныхФорм, "РасходнаяНакладная");
Если ПечатнаяФорма <> Неопределено Тогда
// Вызываем функцию формирования табличного документа
ТабДок = СформироватьПечатнуюФорму(МассивОбъектов);
// Помещаем результат в коллекцию
УправлениеПечатью.ВывестиТабличныйДокументВКоллекцию(КоллекцияПечатныхФорм,
"РасходнаяНакладная", "Расходная накладная с серией", ТабДок);
КонецЕсли;
Еще одна критическая ошибка в исходном коде — обращение к данным через конструкцию типа РеализацияТоваровУслуг.Номер. Важно понимать: во внешней обработке РеализацияТоваровУслуг — это тип метаданных, а не конкретный документ. Для получения данных мы обязаны использовать ссылки, переданные в МассивОбъектов.
Рассмотрим правильный подход: получение данных через запрос. Это не только исправляет ошибку обращения, но и значительно ускоряет работу, если пользователь решит распечатать сразу 10 или 50 накладных. Проанализируем пример запроса для внешней печатной формы:
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| РеализацияТоваровУслуг.Ссылка КАК Ссылка,
| РеализацияТоваровУслуг.Номер КАК Номер,
| РеализацияТоваровУслуг.Дата КАК Дата,
| РеализацияТоваровУслуг.Организация КАК Поставщик,
| РеализацияТоваровУслуг.Контрагент КАК Покупатель,
| РеализацияТоваровУслуг.Товары.(
| Номенклатура,
| Серия,
| Количество
| ) КАК Товары
|ИЗ
| Документ.РеализацияТоваровУслуг КАК РеализацияТоваровУслуг
|ГДЕ
| РеализацияТоваровУслуг.Ссылка В(&МассивОбъектов)";
Запрос.УстановитьПараметр("МассивОбъектов", МассивОбъектов);
ВыборкаДокументов = Запрос.Выполнить().Выбрать();
В сообщениях форума упоминалось, что программа «ругается» на параметры Поставщик или Покупатель. Выясним причину. Это происходит в двух случаях:
Параметры.Поставщик, а в макете ячейка названа Организация).Посмотрим, как правильно выводить данные в макет, используя цикл по документам:
Пока ВыборкаДокументов.Следующий() Цикл
// Получаем области из макета
ОбластьШапка = Макет.ПолучитьОбласть("Шапка");
// Заполняем параметры шапки
ОбластьШапка.Параметры.ТекстЗаголовка = "Расходная накладная № " + ВыборкаДокументов.Номер;
ОбластьШапка.Параметры.Поставщик = ВыборкаДокументов.Поставщик;
ОбластьШапка.Параметры.Покупатель = ВыборкаДокументов.Покупатель;
ТабДок.Вывести(ОбластьШапка);
// Обработка табличной части (товары)
ВыборкаТовары = ВыборкаДокументов.Товары.Выбрать();
Пока ВыборкаТовары.Следующий() Цикл
ОбластьСтрока = Макет.ПолучитьОбласть("Строка");
ЗаполнитьЗначенияСвойств(ОбластьСтрока.Параметры, ВыборкаТовары);
ТабДок.Вывести(ОбластьСтрока);
КонецЦикла;
КонецЦикла;
Подведем итог и составим чек-лист для проверки вашей внешней печатной формы:
Во-первых, проверьте функцию СведенияОВнешнейОбработке. Убедитесь, что Идентификатор команды уникален и понятен.
Во-вторых, реализуйте процедуру Печать строго с 4 параметрами.
В-третьих, используйте МассивОбъектов для получения данных. Никогда не обращайтесь к метаданным напрямую через точку, если это не предопределенные значения.
В-четвертых, не забывайте про метод УправлениеПечатью.ВывестиТабличныйДокументВКоллекцию. Без него система просто не узнает, что работа завершена успешно.
Соблюдение этих правил позволит вам избежать большинства ошибок и создавать качественные инструменты для автоматизации учета в любых конфигурациях на базе 1С:Предприятие.