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