Как удалить документ в 1С по ссылке

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

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

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

Что такое ссылка на документ и чем она отличается от объекта

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

ДокументОбъект — это полная копия данных документа, загруженная в память. Только у объекта есть методы Записать(), Удалить() и УстановитьПометкуУдаления(). Переход от ссылки к объекту выполняется вызовом ПолучитьОбъект(). Если документ уже удалён из базы, метод вернёт Неопределено — это нужно учитывать в коде.

Как пометить документ на удаление по ссылке программно

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

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

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

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

Как удалить документ по ссылке немедленно

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

ДокументОбъект = ДокументСсылка.ПолучитьОбъект();
Если ДокументОбъект <> Неопределено Тогда
    ДокументОбъект.Удалить();
КонецЕсли;

Главный риск прямого удаления — появление битых ссылок вида «Объект не найден». Если на удалённый документ ссылался другой документ, реквизит справочника или запись регистра сведений, при открытии этих объектов пользователь увидит служебную строку вместо представления документа, а отчёты могут выдавать неполные данные.

Как окончательно удалить помеченные документы

После установки пометки удаления документ физически удаляется штатным механизмом. В типовых конфигурациях на управляемых формах откройте раздел «Администрирование» → «Обслуживание» → «Удаление помеченных объектов». В обычном приложении обработка находится в меню «Операции» → «Удаление помеченных объектов».

1. 1
   Пометьте документ на удаление программно или кнопкой «Пометить на удаление» в списке документов
2. 2
   Откройте обработку «Удаление помеченных объектов» в разделе «Администрирование»
3. 3
   Выберите режим: автоматическое удаление всех помеченных или выборочное по типам объектов
4. 4
   Запустите удаление и дождитесь проверки ссылочной целостности
5. 5
   Если документ не удалён, посмотрите список мест использования и уберите ссылки на него
6. 6
   Повторите удаление после устранения препятствий

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

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

Как удалить документ через интерфейс без программирования

Если ссылка известна (например, есть навигационная ссылка вида e1cib/data/Документ.РеализацияТоваровУслуг?ref=...), откройте документ по ней через команду «Перейти по ссылке» (доступна в меню «Ещё» или по сочетанию клавиш в тонком клиенте) либо найдите документ в журнале. Затем нажмите кнопку пометки удаления в форме документа или в списке.

Для окончательного удаления понадобятся права. Роль «Полные права» или специальные права на удаление помеченных объектов есть не у всех пользователей: в типовых конфигурациях интерактивное непосредственное удаление обычно запрещено, доступна только пометка. Это осознанное ограничение, защищающее базу от случайной потери данных.

Проверка результата и типичные ошибки

После удаления убедитесь, что документ действительно отсутствует: попытка получить объект по той же ссылке должна вернуть Неопределено, а запрос к таблице документа с отбором по ссылке — пустой результат. Для помеченного, но ещё не удалённого документа реквизит ПометкаУдаления равен Истина.

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

Частые вопросы