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