Как в запросе 1С получить GUID ссылки

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

Из-за этого задача «получить GUID в запросе» решается обходными путями: через представление ссылки, через выгрузку результата запроса и обработку его средствами встроенного языка, либо через хранение GUID в отдельном реквизите. Выбор способа зависит от того, где будет использоваться результат — внутри 1С или за её пределами.

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

Почему GUID нельзя выбрать полем запроса

В языке запросов 1С поле ссылки возвращает объект типа «Ссылка», а не строку с идентификатором. Попытка написать что-то вроде ВЫБРАТЬ Ссылка.УникальныйИдентификатор приведёт к ошибке — конструктор запроса не знает такого поля. Метод УникальныйИдентификатор() существует только во встроенном языке и вызывается у конкретного объекта-ссылки.

Это осознанное ограничение платформы: запросы выполняются на уровне СУБД, где ссылка хранится как двоичное значение внутреннего формата. Преобразование в привычный строковый GUID вида «a1b2c3d4-...» выполняется уже на уровне платформы 1С, а не базы данных.

Способ 1: запрос выбирает ссылку, GUID получаем в коде

Самый распространённый и надёжный вариант: запросом выбираются ссылки, а GUID извлекается при обходе выборки средствами встроенного языка. Запрос остаётся простым, а вся логика преобразования — в модуле.

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|	Номенклатура.Ссылка КАК Ссылка,
|	Номенклатура.Наименование КАК Наименование
|ИЗ
|	Справочник.Номенклатура КАК Номенклатура
|ГДЕ
|	НЕ Номенклатура.ПометкаУдаления";

Выборка = Запрос.Выполнить().Выбрать();
Пока Выборка.Следующий() Цикл
ГУИД = Выборка.Ссылка.УникальныйИдентификатор();
СтрокаГУИД = Строка(ГУИД);
Сообщить(Выборка.Наименование + " — " + СтрокаГУИД);
КонецЦикла;

Метод УникальныйИдентификатор() возвращает значение типа «УникальныйИдентификатор». Чтобы передать его во внешнюю систему или записать в текстовый файл, приведите его к строке функцией Строка() или оператором конкатенации.

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

ГУИД = Выборка.Ссылка.УникальныйИдентификатор();
СтрокаГУИД = Строка(ГУИД);

Способ 2: представление ссылки в запросе

Если GUID нужен только для отображения пользователю или выгрузки «как есть», можно использовать виртуальное поле представления. В запросе доступна функция ПРЕДСТАВЛЕНИЕССЫЛКИ(), которая возвращает строковое представление ссылки.

ВЫБРАТЬ
ПРЕДСТАВЛЕНИЕССЫЛКИ(Номенклатура.Ссылка) КАК ПредставлениеСсылки
ИЗ
Справочник.Номенклатура КАК Номенклатура

Важно понимать ограничение: ПРЕДСТАВЛЕНИЕССЫЛКИ возвращает не GUID, а навигационное представление — обычно наименование или номер документа. Для получения именно идентификатора этот способ не подходит. Он полезен, когда задача — показать пользователю читаемую ссылку без соединений с другими таблицами.

Также в запросе можно вывести тип ссылки через ТИПЗНАЧЕНИЯ(Ссылка) — это помогает в запросах по составным типам, но к GUID отношения не имеет.

Способ 3: хранение GUID в отдельном реквизите

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

// В подписке на событие ПередЗаписью или ПриЗаписи
Если ПустаяСтрока(Объект.GUID) Тогда
Объект.GUID = Строка(Объект.Ссылка.УникальныйИдентификатор());
КонецЕсли;

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

Сравнение способов получения GUID

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

Поиск объекта по GUID: обратная задача

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

СтрокаГУИД = "a1b2c3d4-e5f6-7890-abcd-ef1234567890";
НовыйГУИД = Новый УникальныйИдентификатор(СтрокаГУИД);
Ссылка = Справочники.Номенклатура.ПолучитьСсылку(НовыйГУИД);

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

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

Проверка корректности полученного GUID

После получения идентификатора полезно убедиться, что он валиден и соответствует реальному объекту. Основные контрольные точки:

Дополнительная проверка — обратное преобразование: взять полученную строку GUID, создать из неё УникальныйИдентификатор, получить ссылку и сравнить её с исходной. Если ссылки равны, преобразование выполнено корректно и идентификатор можно передавать во внешнюю систему.

FAQ