Чем заменить Ввод на основании и функцию в запросе 1С

Введение в механизмы копирования данных

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

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

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

Программная реализация ввода на основании

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

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

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

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

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

Аналоги в языке запросов 1С

Частая ошибка начинающих разработчиков — попытка найти функцию, которая"скопирует" данные из одной таблицы в другую внутри текста запроса. Язык запросов 1С является декларативным и не поддерживает операции вставки (INSERT) или обновления (UPDATE) напрямую.

Если под фразой"в запросе" подразумевается формирование выборки данных из одного документа для отображения в отчете на основе другого, то здесь используется оператор ВЫБРАТЬ с соединением таблиц (ЛЕВОЕ СОЕДИНЕНИЕ или ВНУТРЕННЕЕ СОЕДИНЕНИЕ). Вы просто выбираете нужные поля из источника и присваиваете им псевдонимы.

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

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

Почему нет INSERT в запросах 1С?

Архитектура платформы 1С разделяет логику выборки данных (запросы) и логику изменения данных (объекты метаданных). Это сделано для обеспечения целостности транзакций и работы механизмов блокировок.

Сравнение методов переноса данных

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

Сценарий	Рекомендуемый метод	Сложность реализации	Производительность
Полное копирование ТЧ	КопироватьКолонки	Низкая	Высокая
Копирование с фильтрацией	Цикл Для Каждого	Средняя	Средняя
Формирование отчета	Запрос с СОЕДИНЕНИЕ	Средняя	Высокая
Массовое обновление	Обработка данных + Запись	Высокая	Зависит от объема

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

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

Работа с временными таблицами

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

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

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

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

Если структура временной таблицы и целевой табличной части различается, используйте явное сопоставление полей. Создайте новую строку в табличной части и присвойте значения из колонок временной таблицы по именам или индексам.

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

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

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

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

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

FAQ: Частые вопросы по замене механизмов

Можно ли вызвать форму"Ввод на основании" из кода?

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

Почему метод КопироватьКолонки выдает ошибку?

Наиболее частая причина — несовпадение имен колонок в исходной и целевой табличной части. Также ошибка возникнет, если типы данных в колонках с одинаковыми именами несовместимы для прямого присваивания.

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

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

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

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