Почему при программном добавлении номенклатуры в Счет на оплату поле очищается и как это исправить?

← На главную

При разработке расширений для типовых конфигураций 1С (таких как «Бухгалтерия предприятия 3.0», «Управление торговлей 11» или «ERP») программисты часто сталкиваются с ситуацией: код по заполнению табличной части документа отрабатывает без ошибок, данные видны в отладчике, но на самой форме поле Номенклатура остается пустым или очищается сразу после выполнения процедуры. Рассмотрим подробнее, почему это происходит и как правильно реализовать программное заполнение, чтобы данные корректно отображались и сохранялись.

Разбор основной причины: Объект базы vs Данные формы

Проанализируем типичную ошибку начинающих разработчиков. Когда мы работаем с формой документа, мы имеем дело не с самим объектом из базы данных, а с его программной оболочкой на форме — реквизитом Объект, который имеет тип ДанныеФормыСтруктура. Если вы пытаетесь найти документ в базе, получить от него ссылку и через неё записывать данные, форма «не узнает» об этих изменениях.

Однако, как видно из ситуации автора, заполнение происходит непосредственно в реквизит Объект. Почему же тогда поле Номенклатура очищается? В управляемом приложении 1С визуальное отображение данных в табличной части жестко связано с логикой серверных обработчиков. Если вы просто присвоили ссылку в поле Номенклатура, но не заполнили сопутствующие обязательные реквизиты (единицы измерения, ставку НДС, счета учета), система при проверке или при срабатывании внутренних событий формы может сбросить «недозаполненную» строку.

Проблема выбора группы вместо элемента

Выясним одну из самых коварных причин пустого поля. Метод НайтиПоНаименованию возвращает ссылку на объект. Если в справочнике Номенклатура существует папка (группа) с таким же именем, как у искомого товара, поиск может вернуть ссылку на эту группу. В табличную часть «Товары» документа «Счет на оплату» можно подставлять только элементы, но не группы. Визуально в отладчике вы увидите ссылку, но на форме поле будет выглядеть пустым, так как срабатывает автоматическая фильтрация по типу «ЭтоГруппа = Ложь».

Посмотрим на пример правильного поиска с проверкой:


НайденнаяСсылка = Справочники.Номенклатура.НайтиПоНаименованию("Пила");
Если Не НайденнаяСсылка.Пустая() И Не НайденнаяСсылка.ЭтоГруппа Тогда
    НоваяСтрока = Объект.Товары.Добавить();
    НоваяСтрока.Номенклатура = НайденнаяСсылка;
КонецЕсли;

Использование стандартных механизмов пересчета

В типовых конфигурациях 1С заполнение номенклатуры — это не просто присваивание ссылки. Это запуск цепочки событий: определение цены по прайс-листу, подстановка основной единицы измерения, расчет суммы НДС и установка счетов учета. Если эти поля не заполнены, строка считается невалидной.

Разберем по шагам, как правильно имитировать интерактивное заполнение в коде расширения. Вместо простого присваивания значений, нам необходимо вызвать экспортные процедуры из общих модулей, которые отвечают за логику документа. Обычно это модули с названиями типа ОбработкаТабличнойЧастиКлиентСервер или ОбработкаТабличнойЧасти.

Рассмотрим пример кода, который следует использовать в модуле формы документа при добавлении строки:


&НаСервере
Процедура ДобавитьНоменклатуруНаСервере(ВыбранныйТовар)
    
    НоваяСтрока = Объект.Товары.Добавить();
    НоваяСтрока.Номенклатура = ВыбранныйТовар;
    
    // Структура параметров для инициализации строки
    ПараметрыЗаполнения = Новый Структура;
    ПараметрыЗаполнения.Вставить("ТекстоваяСтрока", "Номенклатура");
    
    // Вызов типового механизма пересчета (имя процедуры может меняться в зависимости от конфигурации)
    // В БП 3.0 часто используется логика через ПриИзмененииНоменклатуры
    СведенияОНоменклатуре = БухгалтерскийУчетПересчет.ПолучитьСведенияОНоменклатуре(ВыбранныйТовар, Объект.Дата, Объект.Организация);
    
    НоваяСтрока.ЕдиницаИзмерения = СведенияОНоменклатуре.ЕдиницаИзмерения;
    НоваяСтрока.Коэффициент = 1;
    НоваяСтрока.СтавкаНДС = СведенияОНоменклатуре.СтавкаНДС;
    
    // Обязательно вызываем пересчет цены и сумм
    // Это гарантирует, что форма «примет» данные
КонецПроцедуры

Особенности работы в расширениях: &Перед и &После

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

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

Принудительное обновление отображения данных

Иногда данные в Объект.Товары на сервере присутствуют, но клиентская часть формы их «не видит». В управляемом приложении за синхронизацию отвечает платформа, но в сложных случаях (особенно при работе через расширения) можно подсказать системе, что данные изменились.

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


&НаКлиенте
Процедура ЗаполнитьСчетПосле(Команда)
    ЗаполнитьТабличнуюЧастьНаСервере();
    ЭтаФорма.ОбновитьОтображениеДанных();
КонецПроцедуры

Проверка функциональных опций и типов данных

Выясним, не препятствует ли заполнению сама настройка программы. В 1С существуют «Функциональные опции». Например, если в базе отключен «Весовой учет», а вы пытаетесь программно заполнить реквизиты, связанные с весом, или если реквизит Номенклатура имеет составной тип (например, включает в себя услуги), несоответствие типа передаваемого значения может привести к очистке поля.

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

Итоги и чек-лист для проверки

Чтобы поле Номенклатура перестало очищаться, выполните следующие действия:

Проверьте, что вы находите Элемент, а не Группу. Используйте НайденнаяСсылка.ЭтоГруппа = Ложь.
Заполняйте обязательные зависимые поля. Вместе с номенклатурой всегда устанавливайте ЕдиницаИзмерения, Коэффициент и СтавкаНДС.
Используйте правильный контекст. Работайте с Объект.Товары (реквизит формы), а не пытайтесь записывать документ через ДокументОбъект в базе данных без переоткрытия формы.
Вызывайте типовые обработчики. Найдите в модуле формы процедуру НоменклатураПриИзменении и посмотрите, какие серверные методы она вызывает. Повторите этот вызов в своем коде.
Соблюдайте очередность в расширении. Используйте &После, чтобы ваш код не затирался стандартными алгоритмами очистки при инициализации.

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