Настройка ввода на основании в 1С Предприятие

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

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

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

Концепция механизма и настройка метаданных

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

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

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

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

Создание обработчика события в модуле объекта

Логика переноса данных реализуется в модуле объекта документа-источника. Необходимо найти процедуру с именем ОбработкаВводаНаОсновании. Эта процедура вызывается платформой автоматически. Она принимает на вход параметры, описывающие контекст создания нового документа.

Сигнатура процедуры строго определена стандартами 1С. Ключевым параметром является ДокументПриемник. В начале выполнения процедуры он содержит ссылку на новый, еще не записанный объект. Задача разработчика — заполнить этот объект данными из текущего документа (Ссылка).

Процедура ОбработкаВводаНаОсновании(ДокументПриемник, ТипДокументаПриемника, КлючВвода)

// Получаем текущий документ-источник
Источник = Ссылка;

// Базовое заполнение шапки документа
ДокументПриемник.Дата = Источник.Дата;
ДокументПриемник.Организация = Источник.Организация;
ДокументПриемник.Контрагент = Источник.Контрагент;

// Вызов детальной обработки табличных частей
ЗаполнитьТабличнуюЧасть(ДокументПриемник, Источник);

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

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

Работа с табличными частями и отбором данных

Самая сложная часть реализации — корректный перенос товаров или услуг. Простое копирование всей табличной части источника в приемник часто недопустимо. Например, при вводе"Счета на оплату" из"Заказа клиента" нужно перенести только те позиции, которые еще не были отгружены или оплачены.

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

Этап обработки	Действие разработчика	Риск ошибки
Инициализация	Очистка табличной части приемника	Дублирование строк при повторном вызове
Чтение источника	Выборка строк с учетом остатков	Неверный срез регистра (момент времени)
Запись в приемник	Добавление новой строки с пересчетом	Потеря уникальности номенклатуры

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

Почему нельзя просто скопировать таблицу?

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

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

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

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

Код проверки может выглядеть следующим образом:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| ОстаткиНоменклатуры.КоличествоОстаток КАК Доступно
|ИЗ
| РегистрНакопления.ТоварыНаСкладах.Остатки(
| &Дата,
| (Склад = &Склад) И (Номенклатура = &Номенклатура)
| ) КАК ОстаткиНоменклатуры";

Запрос.УстановитьПараметр("Дата", Источник.Дата);
//... установка остальных параметров

Результат = Запрос.Выполнить;
// Анализ результата и блокировка добавления строки при недостатке

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

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

Обработка исключительных ситуаций и валидация

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

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

• 🔍 Всегда проверяйте заполнение обязательных полей, таких как"Контрагент" или"Договор", перед записью.
• 🛑 Используйте Сообщить для информирования пользователя о причинах отказа в создании документа.
• 💾 Не забывайте вызывать ДокументПриемник.Записать только после успешного заполнения всех данных.

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

Тестирование и отладка сценариев ввода

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

Особое внимание уделите граничным условиям. Что произойдет, если в документе-источнике пустая табличная часть? А если сумма документа равна нулю? Как поведет себя система при вводе на основании уже проведенного и помеченного на удаление документа?

Для отладки удобно использовать режим предприятия с включенным отладчиком. Точки останова ставятся непосредственно в процедуру ОбработкаВводаНаОсновании. Это позволяет пошагово проанализировать, как меняются значения переменных и заполняется объект приемника.

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

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

Можно ли сделать ввод на основании из отчета или обработки?

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

Почему кнопка"Создать на основании" неактивна?

Чаще всего это связано с правами доступа. Проверьте, есть ли у роли пользователя право на создание (Запись) того вида документа, который указан в списке ввода на основании. Также кнопка может быть неактивна, если документ-источник еще не записан в базу.

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

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

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

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