Как заменить GUID у объекта в 1С

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

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

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

Когда замена GUID действительно нужна

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

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

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

Подготовка: копия, монопольный режим, исходные данные

Обязательный первый шаг — резервная копия базы. Для файлового режима достаточно скопировать файл 1Cv8.1CD при закрытых сеансах, для клиент-серверного — сделать выгрузку в dt или штатный бэкап СУБД. Замена GUID затрагивает ссылочную структуру, и откат без копии будет невозможен.

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

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

Замена GUID с помощью обработки

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

Общий порядок работы с типовой обработкой выглядит так:

1. 1
   Сделайте резервную копию и включите монопольный режим
2. 2
   Откройте обработку через Файл → Открыть в режиме предприятия
3. 3
   Выберите объект, которому нужно заменить GUID
4. 4
   Укажите целевой GUID в поле нового идентификатора
5. 5
   Запустите выполнение и дождитесь сообщения о результате
6. 6
   Проверьте объект и связанные документы, затем проведите тестирование и исправление

Обратите внимание на формат ввода GUID: он должен строго соответствовать виду xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Если идентификатор скопирован из ссылки «Объект не найден», где GUID записан в перевёрнутом (обратном) порядке байтов, его нужно сначала преобразовать — многие обработки делают это автоматически, но проверьте результат.

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

Замена GUID программным кодом

Если под рукой нет обработки или нужен контроль над каждым шагом, задачу решают кодом в конфигураторе (через обработку с кнопкой или консоль кода). Ключевой метод — УстановитьСсылкуНового(), который позволяет задать ссылку с нужным GUID до записи объекта.

// Старый объект, которому меняем GUID
СтараяСсылка = Справочники.Номенклатура.ПолучитьСсылку(
    Новый УникальныйИдентификатор("старый-guid"));

// Создаём копию с новым GUID
НовыйОбъект = СтараяСсылка.Скопировать();
НоваяСсылка = Справочники.Номенклатура.ПолучитьСсылку(
    Новый УникальныйИдентификатор("новый-guid"));
НовыйОбъект.УстановитьСсылкуНового(НоваяСсылка);
НовыйОбъект.Записать();

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

// Удаляем старый объект
СтарыйОбъект = СтараяСсылка.ПолучитьОбъект();
СтарыйОбъект.Удалить();

Несколько важных деталей. Во-первых, УстановитьСсылкуНового() нужно вызывать до записи объекта — после записи изменить ссылку нельзя. Во-вторых, копирование через Скопировать() переносит реквизиты и табличные части, но для документов стоит снимать проведение и переносить движения осознанно: часто проще записать новый документ непроведённым и провести его после замены ссылок.

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

Особые случаи: битые ссылки, дубли и планы обмена

Восстановление объекта по GUID из «битой» ссылки

Если в базе есть ссылки вида «Объект не найден», а вы знаете, какому элементу другой базы они соответствуют, задача обратная: создать объект с этим GUID. Метод тот же — ПолучитьСсылку(Новый УникальныйИдентификатор(guid)) плюс УстановитьСсылкуНового() на новом объекте. После записи все «битые» ссылки автоматически станут ссылаться на созданный элемент, потому что платформа идентифицирует объект именно по GUID.

Слияние дублей под одним GUID

Когда один и тот же контрагент существует в двух экземплярах с разными GUID, а внешняя система привязана к одному из них, сначала замените ссылки с «неправильного» дубля на «правильный» объект, удалите дубль, и только после этого, если нужно, меняйте GUID у оставшегося объекта. Менять GUID у обоих одновременно нельзя — идентификатор должен быть уникален в базе, попытка записать объект с уже существующим GUID завершится ошибкой.

Планы обмена и регистрация изменений

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

Проверка результата

После замены убедитесь, что всё прошло корректно. Откройте объект и сверьте его GUID с целевым — например, через ссылку на объект или код Сообщить(Ссылка.УникальныйИдентификатор()). Затем откройте несколько документов и записей регистров, где раньше использовался старый объект: ссылки должны открывать новый элемент без сообщений «Объект не найден».

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

Типичные ошибки и ограничения

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

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