Как программно пометить объект на удаление в 1С: 5 методов

В 1С:Предприятие 8.3

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

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

1. Стандартный метод: ПометкаУдаления()

Самый очевидный и рекомендуемый способ — использование встроенного метода ПометкаУдаления(). Он работает для большинства прикладных объектов: справочников, документов, планов видов характеристик и других. Синтаксис прост:

Объект.ПометкаУдаления(Истина);

Где Объект — это ссылка на экземпляр объекта метаданных. Например, для пометки элемента справочника "Номенклатура" код будет выглядеть так:

Номенклатура = Справочники.Номенклатура.НайтиПоНаименованию("Устаревший товар");
Если Номенклатура.Пустая() Тогда
Сообщить("Элемент не найден!");
Иначе
Номенклатура.ПометкаУдаления(Истина);
Номенклатура.Записать();
КонецЕсли;

Важно понимать, что метод ПометкаУдаления() только устанавливает флаг удаления, но не сохраняет изменения в базе. Для фиксации пометки обязательно вызовите Записать(). Без этого объекты останутся не помеченными!

✅ Работает для всех стандартных объектов (справочники, документы, ПВХ)
✅ Поддерживает отмену пометки (ПометкаУдаления(Ложь))
⚠️ Требует явного вызова Записать() для сохранения изменений
❌ Не работает для регистров накопления и бухгалтерии (требуются другие методы)

НачатьТранзакцию();
Для Каждого Элемент Из СписокОбъектов Цикл
Элемент.ПометкаУдаления(Истина);
Элемент.Записать();
КонецЦикла;
ЗафиксироватьТранзакцию();

-->

2. Пометка документов: особенности и ограничения

Документы в 1С имеют ряд специфических правил при пометке на удаление. Во-первых, нельзя пометить документ, который уже проведён — сначала его необходимо отменить проведение. Во-вторых, если документ участвует в последовательности (например, "Реализация товаров" ссылается на "Заказ клиента"), платформа может заблокировать операцию.

Пример корректной пометки проведённого документа:

Документ = Документы.РеализацияТоваровУслуг.НайтиПоНомеру("РТ-000123");
Если Не Документ.Пустая() Тогда
Если Документ.Проведен Тогда
Документ.ОтменаПроведения();
КонецЕсли;
Документ.ПометкаУдаления(Истина);
Документ.Записать();
КонецЕсли;

⚠️ Внимание: Если документ имеет движения по регистрам, его пометка на удаление может привести к расхождению итогов. Перед массовой пометкой рекомендуется проверить целостность данных с помощью отчёта "Анализ состояния регистров".

Для документов с подчинёнными объектами (например, "Заказ клиента" с табличной частью "Товары") пометка родительского документа автоматически помечает и дочерние записи. Однако если дочерние объекты ссылаются на другие документы, может возникнуть конфликт ссылочной целостности.

3. Работа с регистрами: почему ПометкаУдаления() не работает

Регистры накопления, бухгалтерии и расчёта не поддерживают метод ПометкаУдаления() напрямую. Для них требуется использовать специальные методы очистки или обходные пути. Например, для регистра накопления "ОстаткиТоваров" можно воспользоваться методом Очистить(), но это приведёт к физическому удалению записей, а не к пометке.

Альтернативный подход — создание документа-корректировки, который сформирует обратные движения. Например:

// Создаём документ "Корректировка записей регистров"
Док = Документы.КорректировкаЗаписейРегистров.СоздатьДокумент();
Док.Дата = ТекущаяДата();
Док.Регистр = Справочники.РегистрыНакопления.ОстаткиТоваров;

// Добавляем запись для удаления
Строка = Док.Движения.Добавить();
Строка.Номенклатура = Справочники.Номенклатура.НайтиПоНаименованию("Устаревший товар");
Строка.Количество = -10; // Отрицательное значение для списания

Док.Провести();
Док.ПометкаУдаления(Истина); // Помечаем сам документ корректировки
Док.Записать();

Для регистров сведений ситуация проще — их записи можно пометить на удаление через менеджер записей:

Записи = РегистрыСведений.ЦеныНоменклатуры.Выбрать();
Пока Записи.Следующий() Цикл
Если Записи.Номенклатура.Наименование = "Устаревший товар" Тогда
Записи.ПометкаУдаления(Истина);
Записи.Записать();
КонецЕсли;
КонецЦикла;

Тип регистра	Метод пометки	Последствия
Регистр сведений	`ПометкаУдаления(Истина)` для записи	Запись исчезает из выборок, но сохраняется в базе
Регистр накопления	Документ-корректировка с обратными движениями	Физическое изменение итогов, требует перепроведения
Регистр бухгалтерии	Документ сторно или корректировка	Влияет на бухгалтерские итоги, требует согласования

4. Массовая пометка: оптимизация и риски

При пометке большого количества объектов (например, 10 000 элементов справочника) стандартный подход с циклом и Записать() для каждого объекта приведёт к зависанию интерфейса и перегрузке сервера. В таких случаях используйте:

Пакетную запись с транзакциями (как в примере выше).
Прямые SQL-запросы (только для опытных разработчиков!).
Фоновые задания для длительных операций.

Пример оптимизированной массовой пометки:

НачатьТранзакцию();
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Номенклатура.Ссылка КАК Ссылка
|ИЗ
|   Справочник.Номенклатура КАК Номенклатура
|ГДЕ
|   НЕ Номенклатура.ПометкаУдаления
|   И Номенклатура.Архивный = Истина";

Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();

Пока Выборка.Следующий() Цикл
Объект = Выборка.Ссылка.ПолучитьОбъект();
Объект.ПометкаУдаления(Истина);
Объект.Записать();
КонецЦикла;

ЗафиксироватьТранзакцию();

⚠️ Внимание: Массовая пометка может заблокировать базу для других пользователей. Выполняйте такие операции в нерабочее время или на тестовой копии. Для баз с более чем 50 000 объектов рассмотрите вариант выгрузки данных в DT/XML, обработки во внешней системе и обратной загрузки.

Сделать резервную копию базы|Проверить права доступа (полные права)|Уведомить пользователей о простое|Подготовить откат (скрипт для снятия пометки)|Протестировать на копии базы-->

5. Альтернативные методы: когда ПометкаУдаления() недоступна

В некоторых случаях стандартные методы не работают. Например:

🔄 Объект заблокирован другим пользователем.
🛑 Нет прав на изменение (роль "Только чтение").
🔧 Объект является системным (например, предопределённые элементы).

Для таких ситуаций используйте обходные пути:

Как пометить предопределённый элемент?

Предопределённые элементы (например, "Рубль" в справочнике "Валюты") нельзя пометить стандартным способом. Однако можно создать обработку, которая:

Снимет флаг Предопределённый через конфигуратор.
Пометит элемент на удаление.
Вернёт флаг Предопределённый обратно.

Предупреждение: Это нарушает поддержку типовой конфигурации и может привести к ошибкам при обновлении!

Для объектов с ограниченными правами поможет выполнение кода от имени администратора:

Параметры = Новый Структура("ИмяПользователя, Пароль", "Администратор", "");
УстановитьПривилегированныйРежим(Истина);

Попытка
Объект = Справочники.Номенклатура.НайтиПоНаименованию("Заблокированный товар");
Объект.ПометкаУдаления(Истина);
Объект.Записать();
Исключение
Сообщить(ОписаниеОшибки());
КонецПопытки;

УстановитьПривилегированныйРежим(Ложь);

Если объект заблокирован, попробуйте принудительное снятие блокировки (осторожно!):

Запрос = Новый Запрос;
Запрос.Текст = "УНИЧТОЖИТЬ БЛОКИРОВКИ ДАННЫХ";
Запрос.Выполнить();

6. Проверка и восстановление помеченных объектов

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

// Проверка ссылок на помеченный объект
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ РАЗЛИЧНЫЕ
|   Документ.Ссылка КАК Документ
|ИЗ
|   Документ.РеализацияТоваровУслуг КАК Документ
|ГДЕ
|   Документ.Номенклатура = &Ссылка";

Запрос.УстановитьПараметр("Ссылка", ПомеченныйОбъект.Ссылка());
Результат = Запрос.Выполнить();

Если Результат.Количество() > 0 Тогда
Сообщить("На объект ссылаются документы! Список: " + Результат.ВыгрузитьКолонку("Документ"));
КонецЕсли;

Для восстановления помеченного объекта используйте:

Объект.ПометкаУдаления(Ложь);
Объект.Записать();

Если объект был помечен ошибочно и уже удалён из выборок, найдите его через прямой запрос к таблице с пометкой ПометкаУдаления = Истина:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Номенклатура.Ссылка КАК Ссылка
|ИЗ
|   Справочник.Номенклатура КАК Номенклатура
|ГДЕ
|   Номенклатура.ПометкаУдаления = Истина
|   И Номенклатура.Наименование = ""Устаревший товар""";

Результат = Запрос.Выполнить();
Если Не Результат.Пустой() Тогда
Объект = Результат.Ссылка.ПолучитьОбъект();
Объект.ПометкаУдаления(Ложь);
Объект.Записать();
КонецЕсли;

💡

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

7. Типичные ошибки и как их избежать

Ошибка №1: Пометка без записи. Забывчивые разработчики часто вызывают ПометкаУдаления(Истина), но не сохраняют объект. В результате изменения не применяются.

Ошибка №2: Игнорирование прав доступа. Если у пользователя нет прав на изменение объекта, пометка завершится ошибкой. Всегда проверяйте права через:

Если Не РазрешеныИзменения(Объект.Метаданные().ПолноеИмя()) Тогда
Сообщить("Нет прав на изменение!");
КонецЕсли;

Ошибка №3: Пометка проведённых документов. Как упоминалось ранее, такие документы нужно сначала отменить.

Ошибка №4: Массовая пометка без транзакций. Это приводит к фрагментации базы и длительным блокировкам.

Ошибка №5: Пометка объектов, участвующих в обменах. Если объект синхронизируется с другой базой (например, через РИБ или EDI), его пометка может привести к конфликтам репликации.

⚠️ Внимание: В конфигурациях с включённым разделением данных (RLS) пометка объектов может работать некорректно. Например, пользователь увидит объект как помеченный, а администратор — нет. Перед операцией отключите RLS или выполняйте код в привилегированном режиме.

FAQ: Частые вопросы по пометке объектов на удаление

Можно ли пометить на удаление объект, который используется в отчёте?

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

Как пометить на удаление все элементы справочника, не используемые в документах?

Используйте запрос с левым соединением:

ВЫБРАТЬ РАЗЛИЧНЫЕ Номенклатура.Ссылка КАК Ссылка ИЗ Справочник.Номенклатура КАК Номенклатура ЛЕВОЕ СОЕДИНЕНИЕ Документ.РеализацияТоваровУслуг КАК Документ ПО Номенклатура.Ссылка = Документ.Номенклатура ГДЕ Документ.Ссылка ЕСТЬ NULL

И НЕ Номенклатура.ПометкаУдаления

Затем в цикле пометьте полученные ссылки.

Почему после пометки объект всё равно виден в форме списка?

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

Откройте форму списка.
Нажмите Ещё → Настройка списка.
Добавьте отбор ПометкаУдаления = Ложь.

Также убедитесь, что в запросе формы не используется конструкция РАЗРЕШИТЬ NULL для поля пометки.

Как узнать, кто и когда пометил объект на удаление?

В типовой конфигурации история пометки не ведётся автоматически. Однако можно:

Использовать журнал регистрации (если включён аудит изменений).
Создать подписку на событие ПередЗаписью и логировать действия.
Добавить регистр сведений для отслеживания изменений (например, "ИсторияПометокУдаления").

Пример кода для логирования:

Процедура ПередЗаписью(Отказ, ТекстСообщения)
Если ЭтотОбъект.ПометкаУдаления И ЭтотОбъект.ЭтоИзменение() Тогда
ЗаписьЛога = РегистрыСведений.ИсторияПометокУдаления.СоздатьМенеджерЗаписи();
ЗаписьЛога.Объект = ЭтотОбъект.Ссылка;
ЗаписьЛога.Пользователь = ПользователиИнформационнойБазы.ТекущийПользователь();
ЗаписьЛога.ДатаВремя = ТекущаяДата();
ЗаписьЛога.Записать();
КонецЕсли;
КонецПроцедуры

Что делать, если пометка на удаление приводит к ошибке "Нарушение ссылочной целостности"?

Ошибка возникает, когда на объект ссылаются другие данные (например, документы или регистры). Решения:

🔍 Найдите все ссылки через запрос (пример см. в разделе 6).
🗑️ Пометьте или удалите ссылающиеся объекты.
🔄 Используйте замену ссылок на другой объект (например, на элемент "Прочее").
🛠️ В крайнем случае примените принудительное удаление через конфигуратор (опция Удалить помеченные объекты в меню Администрирование).

⚠️ Принудительное удаление может нарушить целостность данных! Делайте резервную копию перед операцией.

Программная пометка объектов на удаление в 1С: способы, код и подводные камни