Другое · 7 мин
Программное копирование документа в 1С: пошаговый разбор
Практические способы программного копирования документов в 1С: перенос реквизитов и табличных частей, запись копии и проверка результата без потери данных.
Программное копирование документа в 1С означает создание нового документа на основе уже существующего с переносом его реквизитов, строк табличных частей и связанных данных. Такой подход оправдан, когда нужно быстро оформить повторяющиеся операции, исправить ошибку в уже проведённом документе или подготовить заготовку для аналогичной записи.
Основная сложность заключается не в создании пустого объекта, а в полном переносе содержимого: значения полей, строк табличной части, комментариев, контрагентов, договоров и прочих зависимостей. Если скопировать только заголовок документа, а табличную часть оставить пустой, копия будет неполной и может привести к ошибкам при проведении или отчётах.
Точные имена методов и свойств зависят от используемой конфигурации и версии платформы 1С:Предприятие. Поэтому ниже приведён общий алгоритм, который нужно сверять с синтакс-помощником и конфигуратором вашей информационной базы перед внесением изменений.
- 1Получить ссылку на исходный документ и объект документа
- 2Создать новый документ того же вида
- 3Перенести реквизиты заголовка из исходного в копию
- 4Скопировать строки табличных частей построчно
- 5Записать новый документ и при необходимости провести его
- 6Проверить, что реквизиты и суммы совпадают с источником
Когда программное копирование оправдано
Сценарий подходит, если в базе регулярно создаются документы с одинаковым набором реквизитов, но разными датами или суммами. Программное копирование ускоряет рутинную работу и снижает вероятность опечаток при переносе контрагентов, договоров и аналитик.
Такой метод полезен при корректировке уже проведённых документов, когда нужно оставить исходную запись без изменений и создать исправляющую копию с новыми данными. Это позволяет сохранить историю и избежать прямого редактирования проведённого документа.
Источник = СсылкаНаДокумент.ПолучитьОбъект();
Копия = Документы.НазваниеДокумента.СоздатьДокумент();
Копия.Дата = Источник.Дата;
Копия.Контрагент = Источник.Контрагент;
Для Каждой СтрокаИз Источник.ТабличнаяЧасть Цикл
НоваяСтрока = Копия.ТабличнаяЧасть.Добавить();
НоваяСтрока.Номенклатура = СтрокаИз.Номенклатура;
НоваяСтрока.Количество = СтрокаИз.Количество;
КонецЦикла;
Копия.Записать();Не стоит использовать копирование, если документы имеют разную структуру реквизитов или относятся к разным видам операций. В таких случаях проще создать документ с нуля или использовать отдельные шаблоны, чем пытаться унифицировать непохожие объекты.
Что копируется: реквизиты и табличные части
При программном копировании сначала переносятся простые реквизиты документа: дата, номер, контрагент, договор, организация, склад, комментарий и другие поля заголовка. Каждое поле копируется по имени, если оно существует в приёмнике и имеет совместимый тип.
Как проверить результат
Значения в копии идентичны источнику
Пустые или отличающиеся поля
Равно количеству строк исходного документа
Меньше строк или отсутствуют данные
Документ проведён без ошибок
Ошибка проведения или не проведён
Табличные части копируются построчно: для каждой строки исходной таблицы создаётся новая строка в табличной части копии, после чего переносятся значения её колонок. Важно соблюдать порядок строк, если он имеет значение для проведения или печатных форм.
Если в документе есть ссылки на другие объекты, такие как номенклатура, контрагенты или счета, они копируются как ссылки, а не дублируются. Изменение исходного документа после копирования не влияет на уже созданную копию.
Порядок создания копии документа
Общий алгоритм включает получение объекта исходного документа по его ссылке, создание нового документа того же вида, заполнение реквизитов и табличных частей, а затем запись и, при необходимости, проведение. После записи копия становится доступной в списке документов.
Пример кода носит иллюстративный характер и показывает логику, а не готовую команду для копирования в любую конфигурацию. Перед использованием замените имена объектов и методов на актуальные для вашей базы.
Проверка результата и контрольные точки
После записи копии нужно открыть её в форме и сравнить с исходным документом: дата, номер, контрагент, сумма и количество строк табличной части должны совпадать. Если какие-то реквизиты пустые, копия была создана некорректно.
Если документ требует проведения, проверьте, не возникло ли ошибок регистрации или нарушений остатков после записи копии. Неуспешное проведение может означать, что копия создана в недопустимом периоде или с некорректными аналитиками.
Ограничения и риски
Программное копирование может нарушить учёт, если копия создаётся в закрытом периоде или с датой, отличающейся от исходной. В этом случае отчёты за период могут измениться некорректно.
Не копируйте документы напрямую в базе без резервной копии. Ошибка в алгоритме может привести к созданию множества некорректных записей, которые трудно отменить массово.
Сравнение вариантов
Подходит для повторяющихся операций и массового создания документов, требует тестирования и знаний встроенного языка
Подходит для разовых операций, не требует программирования, но медленнее при большом объёме
Удобно для единичных документов, но зависит от возможностей конкретной конфигурации
Частые ошибки при копировании
Ещё одна частая ошибка — копирование ссылок вместо значений без учёта прав доступа. Если пользователь не имеет прав на исходный объект, программа может создать копию с неполными данными или выдать ошибку при доступе к реквизитам.
Альтернативы и выбор способа
Выбор способа зависит от частоты операции, объёма документов и наличия программиста. Для разовых задач достаточно ручного копирования или встроенных команд формы, а для регулярных операций оправдано программное решение с проверкой.
Что важно запомнить
Копируйте реквизиты и табличные части полностью, проверяйте результат после записи, избегайте закрытых периодов и делайте резервную копию перед массовыми изменениями.
Нужно ли проводить скопированный документ сразу после записи?
Не обязательно. Решение зависит от бизнес-логики: если копия является черновиком, её можно оставить непроведённой, если же это готовый документ для учёта, проведение выполняется после проверки реквизитов и остатков.
Можно ли скопировать проведённый документ без изменений?
Технически возможно создать копию с такими же данными, но дублирование проведённого документа может привести к двойному отражению операции в отчётах. Перед копированием оцените, не нарушится ли учёт.
Что делать, если после копирования табличная часть пустая?
Проверьте, что строки табличной части исходного документа были перебраны циклом и добавлены в табличную часть копии. Также убедитесь, что имена табличных частей совпадают или правильно сопоставлены.
Безопасно ли копировать документы в закрытом периоде?
Как правило, нет: копирование в закрытый период может изменить остатки и отчёты за прошедший период. Безопаснее использовать открытый период и сверить результаты после проведения.