Как исправить ошибку «Значение поля Код не уникально» при обновлении 1С:Комплексная автоматизация 2.4

← На главную

При переходе между релизами 1С:Комплексная автоматизация 2.4 (например, с версии 2.4.7.141 на 2.4.7.147) пользователи часто сталкиваются с критической ошибкой на этапе первого запуска программы после обновления метаданных. Ошибка сопровождается сообщением: «Ошибка при вызове метода контекста (Записать). Значение поля "Код" не уникально». Чаще всего проблема локализуется в общем модуле ОбновлениеИнформационнойБазы.

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

Причина возникновения ошибки

Проанализируем ситуацию: в процессе обновления конфигурации срабатывают обработчики обновления, которые заполняют или обновляют служебные справочники. В конфигурациях ERP 2.4 и КА 2.4 одним из самых «проблемных» является справочник РегламентированныеОтчеты. При обновлении система пытается создать новый элемент (например, новую форму налоговой отчетности) с предопределенным кодом (в нашем примере — 002087). Если в базе уже существует элемент с таким кодом (например, созданный пользователем вручную или загруженный как внешняя форма), возникает конфликт уникальности.

Ситуация осложняется тем, что ошибка происходит внутри транзакции обновления. Как только 1С фиксирует нарушение уникальности, транзакция помечается как «битая», и дальнейшие попытки записи любых объектов будут вызывать ошибку «В данной транзакции уже происходили ошибки!».

Шаг 1. Локализация проблемного объекта

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

Разберем пример модификации кода в общем модуле ОбновлениеИнформационнойБазы. Нам нужно найти процедуру ЗаписатьОбъект и временно добавить вывод информации о типе объекта.


Процедура ЗаписатьОбъект(Знач Объект, Знач РегистрироватьНаУзлахПлановОбмена = Неопределено, Знач ВключитьБизнесЛогику = Ложь, ДокументРежимЗаписи = Неопределено) Экспорт
    // ... существующий код подготовки свойств ...
    
    Попытка
        Если ДокументРежимЗаписи <> Неопределено Тогда
            Объект.Записать(ДокументРежимЗаписи);
        Иначе
            Объект.Записать();
        КонецЕсли;
    Исключение
        // Выводим информацию о проблемном объекте в журнал регистрации или окно сообщений
        ТекстОшибки = "Ошибка записи объекта типа: " + ТипЗнч(Объект) + " с кодом: " + Объект.Код;
        ЗаписьЖурналаРегистрации("ОбновлениеИБ", УровеньЖурналаРегистрации.Ошибка,,, ТекстОшибки);
        ВызватьИсключение ТекстОшибки;
    КонецПопытки;
    
    ОтметитьВыполнениеОбработки(Объект);
КонецПроцедуры

Важный нюанс: В клиент-серверном варианте или при работе через тонкий клиент методы Предупреждение() или Сообщить() могут не сработать в серверном модуле. Поэтому лучше использовать ЗаписьЖурналаРегистрации или генерировать исключение с понятным текстом.

Шаг 2. Программный обход ошибки («Костыль»)

Если мы выяснили, что ошибка связана с кодом 002087, мы можем временно модифицировать код обновления, чтобы система изменила код конфликтующего объекта «на лету». Это позволит обновлению завершиться успешно.

Разберем по шагам, как вставить проверку в процедуру записи:


// Внутри процедуры ЗаписатьОбъект перед вызовом Объект.Записать()
Если СокрЛП(Объект.Код) = "002087" Тогда
    Объект.Код = "УД" + Объект.Код; // Добавляем префикс, чтобы сделать код уникальным
КонецЕсли;

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

Шаг 3. Решение через поиск и исправление данных в пользовательском режиме

Самый правильный и безопасный способ — исправить данные в самой базе до того, как обработчик обновления до них доберется. Но как это сделать, если программа не запускается?

Попробуйте запустить 1С в режиме «Толстый клиент (обычное приложение)». Иногда это позволяет обойти некоторые проверки начального заполнения (зависит от версии БСП).
Если база файловая, можно воспользоваться внешними утилитами для просмотра таблиц, но это крайний метод.
Используйте Параметры запуска. В некоторых случаях запуск с параметром /C ЗапуститьОбновлениеИнформационнойБазы позволяет инициировать процесс заново после правки кода.

Если вам удалось зайти в базу (например, через функции для технического специалиста), найдите справочник РегламентированныеОтчеты (или тот, который вы определили на шаге 1), найдите элемент с кодом 002087 и просто переименуйте его код вручную, добавив любой символ. После этого перезапустите обновление.

Шаг 4. Работа с «битой» транзакцией

Рассмотрим ситуацию, когда возникает ошибка «В данной транзакции уже происходили ошибки!». Это означает, что процедура Справочники.РегламентированныеОтчеты.ЗаполнитьСписокРегламентированныхОтчетов (или аналогичная) уже упала. Чтобы это вылечить, необходимо:

Полностью закрыть все сеансы 1С.
Очистить серверный кэш (для серверной базы) или папку %AppData% (для файловой).
Вернуть код общего модуля в исходное состояние (или оставить только правку с изменением кода, если вы уверены в ней).
Запустить базу снова.

Рекомендации для предотвращения проблемы

Проанализируем, как избежать подобных ситуаций в будущем, особенно если вы — «продвинутый пользователь», выполняющий функции администратора:

Всегда делайте бэкап. Даже если обновление кажется минорным (изменение последней цифры релиза), 1С может выполнять реструктуризацию тяжелых таблиц.
Тестирование и исправление (ТиИ). Перед обновлением обязательно запускайте ТиИ с проверкой логической и ссылочной целостности. Это может выявить дубли кодов до того, как они станут критичными.
Проверка внешних форм. Если вы часто загружаете внешние регламентированные отчеты, помните, что они могут конфликтовать с новыми системными формами, которые 1С добавляет при обновлении.

Использование консоли запросов. Если база открывается в конфигураторе, вы можете написать простую обработку, которая найдет дубль:


Запрос = Новый Запрос("ВЫБРАТЬ Ссылка ИЗ Справочник.РегламентированныеОтчеты ГДЕ Код = '002087'");
Выборка = Запрос.Выполнить().Выбрать();
Пока Выборка.Следующий() Цикл
    Объект = Выборка.Ссылка.ПолучитьОбъект();
    Объект.Код = "ОШ" + Объект.Код;
    Объект.Записать();
КонецЦикла;

Резюме: Ошибка неуникальности кода при обновлении — это следствие пересечения пользовательских данных и новых системных алгоритмов заполнения справочников. Решается она либо ручным переименованием кода существующего элемента, либо временной вставкой «исправляющего» кода в общий модуль ОбновлениеИнформационнойБазы в месте вызова метода Записать().