К статье
Практический материал

Другое · 6 мин

Программная пометка документа на удаление в 1С

Как пометить документ на удаление в 1С программно: условия, код, проверка результата и риски для самостоятельной работы в конфигурации 1С:Предприятие.

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

Программно пометку ставят через свойство объекта документа, а не через удаление ссылки. Обычно достаточно получить объект по ссылке, установить ПометкаУдаления = Истина и записать объект с режимом пометки. Действие требует прав на изменение документа и может быть ограничено проведенностью или использованием документа в других движениях.

Что означает пометка на удаление в 1С

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

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

Где и как ставить пометку программно

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

1c
&НаСервере
Процедура ПометитьДокументНаУдаление(СсылкаНаДокумент)
    Объект = СсылкаНаДокумент.ПолучитьОбъект();
    Объект.ПометкаУдаления = Истина;
    Объект.Записать(РежимЗаписиДокумента.ПометкаУдаления);
КонецПроцедуры

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

Массовая пометка из отчета или обработки

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

Порядок действий
  1. 1
    Открыть конфигурацию в режиме правки и найти модуль документа
  2. 2
    Написать серверную процедуру, получающую объект по ссылке
  3. 3
    Установить ПометкаУдаления = Истина и вызвать Записать с режимом пометки
  4. 4
    Проверить флаг в списке документов и журнале регистрации

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

Условия и ограничения

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

Контрольные точки

Как проверить результат

Значение ПометкаУдаления в форме списка
Норма

галочка установлена

Тревожный признак

поле пустое или документ недоступен для изменения

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

Как проверить результат

После выполнения кода нужно открыть документ или список документов и убедиться, что флаг «Пометка удаления» установлен. Также полезно проверить журнал регистрации, если он ведется для этого объекта, чтобы подтвердить факт записи изменения.

Типичные ошибки
01
Пытаться удалить проведенный документ без отмены проведения
02
Считать пометку мгновенным удалением данных
03
Запускать массовую пометку без резервной копии и проверки на копии

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

Частые ошибки и риски

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

Альтернативы полному удалению

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

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

Итог

Что важно запомнить

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

Можно ли удалить помеченный документ сразу?

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

Нужно ли отменять проведение перед пометкой?

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

Что делать, если запись с пометкой не проходит?

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

Безопасно ли делать массовую пометку?

Только после резервного копирования и тестирования на копии базы или небольшой выборке. Массовая операция может заблокировать много записей и затруднить откат изменений.

Какая разница между пометкой и удалением?

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