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