Как создать GUID в 1С

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

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

Ниже разобраны все практические способы: генерация нового GUID, получение идентификатора существующего объекта, создание идентификатора из строки, работа с GUID в запросах и типовые ошибки, которые допускают даже опытные разработчики.

Что такое GUID в 1С и где он используется

Уникальный идентификатор в 1С — это значение специального типа, которое записывается в виде строки из 36 символов: 32 шестнадцатеричные цифры, сгруппированные через дефисы, например 6f9619ff-8b86-d011-b42d-00cf4fc964ff. Каждая ссылка на объект базы данных имеет такой идентификатор, и именно он, а не код или номер, является настоящим первичным ключом записи в таблице SQL.

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

Способ 1: генерация нового GUID в коде

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

НовыйГУИД = Новый УникальныйИдентификатор;
Сообщить(Строка(НовыйГУИД));
// Пример вывода: a3f2c1d4-8e5b-4a9c-b7d2-1e6f8a0c3d5e

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

ГУИДИзСтроки = Новый УникальныйИдентификатор("6f9619ff-8b86-d011-b42d-00cf4fc964ff");

Если передать строку в неверном формате, платформа выдаст ошибку преобразования. Поэтому при приёме идентификаторов из внешних источников стоит оборачивать вызов в попытку/исключение или предварительно проверять длину и состав строки.

НовыйГУИД = Новый УникальныйИдентификатор; // случайный GUID
ГУИДИзСтроки = Новый УникальныйИдентификатор("6f9619ff-8b86-d011-b42d-00cf4fc964ff");

Способ 2: получить GUID существующего объекта

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

ГУИДТовара = Справочники.Номенклатура.НайтиПоКоду("00000123").УникальныйИдентификатор();
СтрокаГУИД = Строка(ГУИДТовара); // для передачи во внешнюю систему

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

ГУИД = Новый УникальныйИдентификатор(СтрокаИзВнешнейСистемы);
Ссылка = Справочники.Номенклатура.ПолучитьСсылку(ГУИД);
Если Ссылка.ПолучитьОбъект() = Неопределено Тогда
// Объект с таким GUID в базе отсутствует
КонецЕсли;

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

Способ 3: GUID в запросе

В языке запросов 1С получить идентификатор ссылки можно функцией УНИКАЛЬНЫЙИДЕНТИФИКАТОР(). Это удобно при выгрузке данных для обмена, когда нужно выбрать GUID сразу для тысяч записей без обхода в цикле.

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

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

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

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

Практический пример: сопоставление объектов между базами

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

Упрощённый фрагмент кода выглядит так:

// Сохранение соответствия
МенеджерЗаписи = РегистрыСведений.СоответствияОбъектов.СоздатьМенеджерЗаписи();
МенеджерЗаписи.Объект = СсылкаНаТовар;
МенеджерЗаписи.ИдентификаторВнешний = Строка(СсылкаНаТовар.УникальныйИдентификатор());
МенеджерЗаписи.Записать();

// Поиск по внешнему идентификатору
ГУИД = Новый УникальныйИдентификатор(СтрокаИзФайла);
НайденнаяСсылка = Справочники.Номенклатура.ПолучитьСсылку(ГУИД);

1. 1
   Получите GUID объекта: Ссылка.УникальныйИдентификатор()
2. 2
   Преобразуйте в строку для передачи: Строка(ГУИД)
3. 3
   Передайте строку во внешнюю систему или сохраните в регистр сведений
4. 4
   При обратном приёме создайте GUID из строки: Новый УникальныйИдентификатор(Строка)
5. 5
   Найдите объект: Менеджер.ПолучитьСсылку(ГУИД) и проверьте его существование

Проверка результата и типичные ошибки

После генерации или преобразования GUID полезно убедиться, что значение корректно. Признаки правильного результата: строковое представление имеет длину 36 символов, содержит четыре дефиса в фиксированных позициях, а сравнение двух одинаковых идентификаторов оператором «=» даёт Истина. Пустой идентификатор имеет вид 00000000-0000-0000-0000-000000000000 — его появление обычно сигнализирует об ошибке в логике.

Наиболее частые ошибки при работе с GUID в 1С:

• попытка вызвать УникальныйИдентификатор() у объекта, а не у ссылки — возникает ошибка «Метод объекта не обнаружен»;
• сравнение GUID со строкой напрямую: типы разные, сравнение даст Ложь даже при совпадающем тексте — сначала преобразуйте строку через конструктор;
• использование ПолучитьСсылку() без проверки существования объекта — ведёт к «битым ссылкам» в данных;
• самостоятельная сборка GUID из случайных символов вместо конструктора — теряется гарантия уникальности и корректность формата;
• разный регистр букв в строковом представлении при сравнении строк с внешней системой — приводите обе стороны к одному регистру через НРег().

Ограничения и нюансы

Тип «УникальныйИдентификатор» нельзя использовать как тип измерения регистра или реквизита напрямую в некоторых контекстах — чаще всего GUID хранят в строковом реквизите длиной 36 или 50 символов (с запасом на фигурные скобки, если внешняя система их добавляет). Также помните, что при обмене через COM-соединение GUID передаётся как строка и требует преобразования на принимающей стороне.

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

FAQ