Как получить уникальный идентификатор объекта в 1С

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

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

Что такое уникальный идентификатор и где он используется

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

Идентификатор участвует в механизмах обмена данными: именно по нему планы обмена и типовые синхронизации сопоставляют объекты разных баз. Он же используется в HTTP-сервисах, REST-интеграциях, при выгрузке в форматы XML и JSON, а также в механизме «Получить ссылку» для быстрой навигации по базе.

Важно понимать ограничение: GUID есть только у ссылочных типов данных. У записей регистров сведений, накопления, бухгалтерии и расчета собственного идентификатора нет — там записи идентифицируются ключом записи (измерениями, периодом, регистратором).

Как получить GUID объекта в коде

Основной способ — метод УникальныйИдентификатор(), вызываемый у ссылки на объект. Метод возвращает значение типа УникальныйИдентификатор, которое при необходимости преобразуется в строку.

// Получение GUID у существующей ссылки
СсылкаНаТовар = Справочники.Номенклатура.НайтиПоКоду("000000123");
Если Не СсылкаНаТовар.Пустая() Тогда
Идентификатор = СсылкаНаТовар.УникальныйИдентификатор();
СтрокаGUID = Строка(Идентификатор);
Сообщить("GUID объекта: " + СтрокаGUID);
КонецЕсли;

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

НовыйЭлемент = Справочники.Номенклатура.СоздатьЭлемент();
НоваяСсылка = Справочники.Номенклатура.ПолучитьСсылку(
Новый УникальныйИдентификатор("8a3f2c1d-5e6b-4a7c-9d8e-1f2a3b4c5d6e"));
НовыйЭлемент.УстановитьСсылкуНового(НоваяСсылка);
НовыйЭлемент.Наименование = "Товар из внешней системы";
НовыйЭлемент.Записать();

Как узнать GUID без программирования

Не всегда есть возможность писать код. В типовых конфигурациях и в режиме тонкого клиента идентификатор можно увидеть штатными средствами.

Через функцию «Получить ссылку»

В форме любого объекта в режиме предприятия доступна кнопка «Еще → Получить ссылку» (в ряде конфигураций — команда «Получить ссылку» в меню формы). Платформа покажет строку вида e1cib/data/Справочник.Номенклатура?ref=8a3f2c1d5e6b4a7c9d8e1f2a3b4c5d6e. Фрагмент после ref= — это и есть идентификатор объекта, только без дефисов и с переставленными байтами в начале (внутреннее представление), поэтому для передачи во внешнюю систему его нужно привести к стандартному виду через код.

Через консоль запросов или внешнюю обработку

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

1. 1
   Откройте нужный объект в режиме 1С:Предприятие
2. 2
   Нажмите «Еще» и выберите команду «Получить ссылку»
3. 3
   Скопируйте фрагмент после ref= из показанной строки
4. 4
   Если нужен стандартный формат GUID с дефисами — получите его через код или консоль
5. 5
   Проверьте результат поиском объекта обратным методом

Как найти объект по известному идентификатору

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

СтрокаИзВнешнейСистемы = "8a3f2c1d-5e6b-4a7c-9d8e-1f2a3b4c5d6e";
GUID = Новый УникальныйИдентификатор(СтрокаИзВнешнейСистемы);
СсылкаНаТовар = Справочники.Номенклатура.ПолучитьСсылку(GUID);

// Проверка, существует ли объект с такой ссылкой
Запрос = Новый Запрос("ВЫБРАТЬ 1 ИЗ Справочник.Номенклатура ГДЕ Ссылка = &Ссылка");
Запрос.УстановитьПараметр("Ссылка", СсылкаНаТовар);
Если Запрос.Выполнить().Пустой() Тогда
Сообщить("Объект с таким GUID в базе отсутствует");
КонецЕсли;

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

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

GUID = Новый УникальныйИдентификатор(СтрокаGUID); Ссылка = Справочники.Номенклатура.ПолучитьСсылку(GUID);

Особенности для разных типов объектов

Поведение идентификаторов немного различается в зависимости от вида объекта метаданных. Сводка ниже помогает быстро сориентироваться.

Для регистров сведений в интеграциях обычно передают набор значений измерений или GUID регистратора. Для перечислений в обменах используют имя значения из конфигурации — метод XMLСтрока() или обращение по индексу.

Идентификаторы в запросах и динамических списках

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

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

Если нужно сравнить ссылки в запросе по идентификатору, передавайте в параметр не строку GUID, а саму ссылку, полученную через ПолучитьСсылку(). Сравнение строковых представлений в запросе не предусмотрено.

Риски и ограничения при работе с GUID

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

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

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

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