Программное создание документов на основании других в 1С

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

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

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

Архитектура механизма «Создать на основании»

Фундаментом взаимодействия документов в 1С является механизм подсистемы Интерактивного взаимодействия. Когда пользователь выбирает команду создания нового документа из текущего, система инициирует цепочку событий, позволяющую разработчику перехватить управление и наполнить новый объект данными. Ключевую роль здесь играет событие ПриСозданииНаОсновании.

Это событие срабатывает в модуле формы документа-источника. Оно предоставляет разработчику доступ к двум основным объектам: самому документу-источнику и новому, еще не записанному документу-получателю. Именно в этом месте происходит первичная инициализация данных.

Важно понимать разницу между клиентским и серверным контекстом выполнения. Хотя событие вызывается при взаимодействии с формой, логика заполнения часто требует обращения к данным, хранящимся только на сервере. Поэтому критически важно правильно организовать вызовы серверных процедур для получения актуальной информации.

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

Реализация через событие формы

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

Параметр Заполнить представляет собой структуру, содержащую настройки заполнения. Однако, чаще всего разработчики работают напрямую с объектом нового документа, который передается в процедуру. Для доступа к нему используется метод получения объекта метаданных или обращение к форме нового документа, если она уже открыта.

Рассмотрим пример кода, где мы инициируем процесс заполнения. Здесь мы не просто копируем поля, а задаем вектор развития логики. Мы можем проверить тип документа-источника и в зависимости от него выбрать разные алгоритмы заполнения табличной части.

&НаКлиенте
Процедура ФормаПриСозданииНаОсновании(Источник, Заполнить, СтандартнаяОбработка)

// Отключаем стандартную обработку, если хотим полностью контролировать процесс
СтандартнаяОбработка = Ложь;

// Вызываем серверную процедуру для заполнения
ЗаполнитьДокументНаСервере(Источник, Заполнить);

КонецПроцедуры

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

Серверная логика и обработчик заполнения

Основная бизнес-логика должна находиться на сервере. Для этого создается отдельная процедура, помеченная директивой &НаСервере. В этой процедуре происходит непосредственное чтение данных из источника и запись их в новый документ. Здесь мы работаем с объектами данных в их чистом виде.

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

Особое внимание следует уделить обработке ошибок. Если в процессе заполнения возникнет исключение (например, отсутствие нужного элемента справочника), процесс создания документа прервется, и пользователь увидит сообщение об ошибке. Необходимо использовать конструкцию Попытка...Исключение для корректной обработки таких ситуаций.

Этап обработки	Действие разработчика	Риск ошибки
Инициализация	Получение объекта нового документа	Неверный тип документа
Копирование шапки	Перенос контрагента, договора, валюты	Актуальность договора
Табличная часть	Цикл по строкам источника	Изменение единиц измерения
Расчеты	Пересчет сумм по текущим ценам	Отсутствие цен на дату

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

Работа с табличными частями и циклами

Наиболее трудоемкая часть программирования — это перенос списков товаров или услуг. Простой цикл Для Каждый по строкам документа-источника позволяет извлечь необходимые данные. Однако, вставка этих данных в новый документ требует соблюдения правил типизации и заполнения обязательных полей.

Часто возникает ситуация, когда состав товаров в новом документе должен отличаться от исходного. Например, при создании документа «Реализация» на основании «Заказа клиента» нужно проверить фактические остатки на складе. Если товара нет в нужном количестве, строку либо не нужно добавлять, либо нужно добавить с комментарием о частичной отгрузке.

Для оптимизации производительности при работе с большими объемами данных (сотни строк) не рекомендуется делать обращения к базе данных внутри цикла. Лучше собрать все необходимые идентификаторы номенклатуры и сделать одну общую выборку перед циклом, поместив результаты во временный массив или таблицу значений.

&НаСервере
Процедура ЗаполнитьТабличнуюЧасть(Источник, Приемник)

Для Каждого СтрокаИсточника Из Источник.Товары Цикл

НоваяСтрока = Приемник.Товары.Добавить();
НоваяСтрока.Номенклатура = СтрокаИсточника.Номенклатура;
НоваяСтрока.Количество = СтрокаИсточника.Количество;

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

КонецЦикла;

КонецПроцедуры

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

Использование метода ПриЗаписи для контроля

Помимо момента создания, критически важным этапом является момент записи документа. Модуль объекта документа предоставляет событие ПриЗаписи, которое срабатывает перед сохранением данных в базу. Это идеальное место для финальной валидации данных, полученных при создании на основании.

В этом событии можно проверить, не были ли пользователем изменены ключевые поля после автоматического заполнения. Также здесь удобно реализовать блокировку записи, если какие-то обязательные условия не выполнены. Например, запретить проведение документа реализации, если сумма не совпадает с суммой заказа-основания (с учетом допустимой погрешности).

Использование объекта МенеджерЗаписи в событии ПриЗаписи позволяет отменить операцию сохранения, выбросив исключение с понятным сообщением для пользователя. Это создает надежный барьер против некорректных данных, которые могли просочиться через этап заполнения.

Также в этом месте можно автоматически проставить ссылки на документы-основания в специальные регистры или реквизиты, если это не было сделано ранее. Это обеспечивает целостность цепочки документов и упрощает последующий анализ движений документов.

Как отменить запись документа?

Для отмены записи в событии ПриЗаписи используйте конструкцию: ВызватьИсключение "Описание причины отмены"; Это прервет транзакцию и покажет сообщение пользователю.

Особенности работы с движениями по регистрам

Документы в 1С часто являются регистраторами движений по регистрам накопления и бухгалтерии. При создании нового документа на основании старого, важно понимать, будут ли дублироваться движения или они должны компенсировать друг друга. Это зависит от бизнес-задачи.

Если вы создаете документ «Возврат» на основании «Реализации», логика должна быть направлена на сторнирование или создание обратных движений. В этом случае знаки сумм и количеств в движениях нового документа должны быть инвертированы относительно исходного. Программно это реализуется умножением соответствующих полей на -1.

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

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

Не забывайте про регистры сведений, которые могут использоваться для хранения состояния процесса. При создании нового документа статус старого документа-источника часто должен меняться (например, с «В работе» на «Частично отгружен»). Эту логику также лучше размещать в модуле объекта или в общем модуле, вызываемом при записи.

Частые ошибки и отладка

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

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

Для отладки сложных сценариев используйте журнал регистрации и режим отладки на сервере. Устанавливайте точки останова в событии ПриСозданииНаОсновании и в серверных процедурах заполнения. Анализируйте значения переменных в момент выполнения, чтобы убедиться в корректности переноса данных.

⚠️ Внимание: Интерфейсы и возможности платформы 1С могут обновляться. Всегда проверяйте документацию к конкретной версии платформы, особенно если вы используете новые типы данных или методы работы с JSON/XML внутри документов.

Почему документ не создается?

Чаще всего причина кроется в отсутствии прав доступа у пользователя на создание нового вида документов или в ошибке валидации данных в событии ПриЗаписи.

FAQ: Часто задаваемые вопросы

Можно ли создать документ на основании другого, если они находятся в разных информационных базах?

Прямой механизм «Создать на основании» работает только в рамках одной базы. Для переносса данных между разными базами необходимо использовать механизмы обмена данными (Корпоративный портал, Web-сервисы, планы обмена) или выгрузку/загрузку в файлы формата XML/JSON с последующим созданием документа через внешнюю обработку.

Как передать дополнительные параметры при создании документа?

Для передачи дополнительных параметров можно использовать структуру, передаваемую в параметре Заполнить события ПриСозданииНаОсновании. В серверной процедуре заполнения вы считываете значения из этой структуры и используете их для настройки логики создания нового документа.

Что делать, если при создании документа меняется номенклатура?

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

Можно ли запретить создание документа на основании программно?

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

Как скопировать вложения и файлы, прикрепленные к документу?

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