Почему не удаляется регистрация изменений в 1С и как правильно использовать УдалитьРегистрациюИзменений

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

Анализ исходной проблемы

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

Процедура ОтменитьРегистрациюВыгрузки(Ссылка)
    УзелБП = ПланыОбмена.СинхронизацияДанныхЧерезУниверсальныйФормат.НайтиПоКоду("БП");
    ПланыОбмена.УдалитьРегистрациюИзменений(УзелБП, Ссылка);
КонецПроцедуры

С первого взгляда код выглядит абсолютно корректным. Объект узла находится успешно, метод УдалитьРегистрациюИзменений вызывается с передачей ссылки на объект. Однако на практике этот код может не приносить желаемого результата — регистрация изменений «возвращается». Разберем по шагам причины этого поведения.

Разбор заблуждения: обязательно ли использовать УдалениеОбъекта?

Существует распространенное мнение, что передавать напрямую ссылку (например, СправочникСсылка или ДокументСсылка) во второй параметр метода УдалитьРегистрациюИзменений нельзя, и её обязательно нужно оборачивать в объект УдалениеОбъекта. Это мнение ошибочно.

Выясним разницу в использовании этих типов данных:

1. Передача Ссылки напрямую: Платформа полноценно поддерживает передачу ссылки на существующий в базе элемент. При этом удаляется регистрация изменений именно для этого физического объекта.
2. Передача УдалениеОбъекта: Конструкция Новый УдалениеОбъекта(Ссылка) предназначена исключительно для тех случаев, когда сам объект уже был физически удален из базы данных, но в таблице регистрации изменений осталась запись о его удалении (чтобы другие базы узнали об этом событии). Если объект реально существует в базе, использовать УдалениеОбъекта для очистки регистрации изменений некорректно.

Поддерживаемые типы для второго параметра метода

Метод ПланыОбмена.УдалитьРегистрациюИзменений(<Узлы>, <Данные>) обладает высокой гибкостью. Проанализируем, какие типы данных мы можем передавать во второй параметр (Данные):

• Неопределено (или опущенный параметр): Полностью очищает всю таблицу зарегистрированных изменений для указанного узла (или массива узлов). Полезно при полной инициализации обмена.
• Число (Номер сообщения): Удаляет регистрацию всех изменений, которые были отправлены в сообщениях с номером, меньшим или равным указанному числу. Это базовый механизм подтверждения получения пакетов.
• Объект метаданных: Например, передав Метаданные.Справочники.Номенклатура, мы очистим регистрацию для всех элементов данного справочника на выбранном узле.
• Ссылка или Объект: Очищает регистрацию для одного конкретного элемента базы данных (справочника, документа, бизнес-процесса и т.д.).
• Набор записей регистра: Используется для удаления регистрации изменений в регистрах. Набор должен содержать установленные отборы.
• Массив: Позволяет передать коллекцию из вышеперечисленных элементов для массового удаления регистрации за один вызов.

Ошибка «Недопустимое значение параметра (параметр номер '2')»

Иногда при вызове метода платформа выбрасывает исключение с ошибкой второго параметра. Рассмотрим две основные причины этой проблемы:

1. Объект отсутствует в составе плана обмена. Если тип передаваемого объекта или ссылки не добавлен на вкладку «Состав» используемого плана обмена, платформа не сможет сопоставить данные и выдаст ошибку. Перед удалением регистрации убедитесь, что объект входит в состав плана обмена.
2. Некорректная передача данных регистра. Нельзя передавать запись регистра напрямую. Для подчиненных регистров необходимо передавать НаборЗаписей с установленным отбором по регистратору. Для независимых регистров сведений требуется передавать либо НаборЗаписей с заполненным отбором по абсолютно всем измерениям, либо использовать КлючЗаписиРегистра. Передача пустого набора или набора с неполным отбором вызовет ошибку.

Главная причина: почему регистрация изменений «возвращается»

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

Это классическая проблема жизненного цикла объекта базы данных. Если вызов метода УдалитьРегистрациюИзменений происходит внутри обработчиков событий ПередЗаписью() или ПриЗаписи() самого объекта, либо непосредственно перед вызовом метода Записать(), срабатывает механизм авторегистрации.

После того как ваш программный код удаления регистрации успешно отрабатывает, СУБД производит непосредственную запись данных в таблицы базы. В этот же момент транзакции (на самом позднем этапе) платформа проверяет настройки авторегистрации для данного объекта в плане обмена. Если авторегистрация включена (стоит значение «Разрешить»), платформа автоматически создает новую запись в таблице изменений. В итоге ваша ручная очистка перекрывается новой автоматической записью.

Как решить проблему и гарантированно отменить регистрацию

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

Способ 1. Использование свойства АвтоОтметкаИспользования

Перед вызовом метода Записать() у объекта необходимо обратиться к свойству ОбменДанными и отключить автоматическую отметку использования получателей. Посмотрим на пример кода:

НовыйОбъект = СсылкаНаОбъект.ПолучитьОбъект();
// Отключаем автоматическую регистрацию изменений при записи
НовыйОбъект.ОбменДанными.Получатели.АвтоОтметкаИспользования = Ложь;
НовыйОбъект.Записать();

// Теперь мы можем безопасно удалить старую регистрацию, новая не создастся
УзелБП = ПланыОбмена.СинхронизацияДанныхЧерезУниверсальныйФормат.НайтиПоКоду("БП");
ПланыОбмена.УдалитьРегистрациюИзменений(УзелБП, СсылкаНаОбъект);

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

Способ 2. Использование режима загрузки данных

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

НовыйОбъект = СсылкаНаОбъект.ПолучитьОбъект();
// Устанавливаем признак загрузки, что отключает все обработчики и авторегистрацию
НовыйОбъект.ОбменДанными.Загрузка = Истина;
НовыйОбъект.Записать();

Установка свойства Загрузка = Истина полностью блокирует стандартную авторегистрацию изменений на уровне платформы для этого объекта в момент выполнения текущей транзакции записи.

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