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

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

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

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

Генерация нового UUID в коде модуля

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

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

Рассмотрим пример использования в модуле объекта:

НовыйИД = УникальныйИдентификатор();
Сообщить("Сгенерирован ID: " + НовыйИД);

УникальныйИдентификатор представляет собой 128-битное число, отображаемое в виде строки из 32 шестнадцатеричных цифр, разделенных дефисами. Формат строго регламентируется стандартом RFC 4122.

Часто возникает вопрос: можно ли задать идентификатор вручную? Технически конструктор типа позволяет это сделать, но ручное присваивание UUID недопустимо в производственной среде, так как это нарушает гарантию уникальности и может вызвать конфликты при слиянии баз данных.

Получение идентификатора существующего объекта

Когда объект уже создан и сохранен в базе данных, у него появляется постоянная ссылка. Каждый объект конфигурации, будь то Справочник, Документ или План счетов, обладает свойством УникальныйИдентификатор. Это свойство доступно для чтения и позволяет получить внутренний системный ID записи.

Получение этого значения необходимо для передачи ссылки на объект во внешние системы, где не используется прямая связь по наименованию или коду. Например, при выгрузке контрагента в CRM-систему лучше передавать именно UUID, чтобы избежать проблем с полными тезками.

• 🔍 Свойство доступно у всех объектов-ссылок.
• 🔒 Значение неизменно в течение всего жизненного цикла объекта.
• ⚡ Чтение свойства происходит мгновенно без дополнительных запросов к СУБД, если объект уже загружен в память.

Пример получения идентификатора из текущей формы:

ИДОбъекта = Объект.Ссылка.УникальныйИдентификатор;

Следует различать ссылку на объект и сам уникальный идентификатор. Ссылка содержит информацию о типе объекта и его уникальном ключе, тогда как УникальныйИдентификатор — это "чистый" хеш записи.

В чем разница между Ref и UUID?

Ссылка (Ref) зависит от типа метаданных и может меняться при конвертации конфигурации, тогда как UUID привязан к конкретной физической записи в таблице базы данных и остается неизменным даже при изменении структуры конфигурации (в большинстве случаев).

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

⚠️ Внимание: При работе с объектами в режиме Управляемое приложение убедитесь, что объект ссылки действительно получен из базы данных. Попытка прочитать UUID у не записанного макета может вернуть некорректные данные или вызвать исключение.

Извлечение ИИК в запросах и регистрах

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

Для получения ИИК в тексте запроса используется специальное системное поле. Это позволяет идентифицировать запись измерения даже если ссылочный объект был удален или помечен на удаление.

Синтаксис запроса выглядит следующим образом:

ВЫБРАТЬ
РегистрНакопления.ОстаткиТоваров.Товар.УникальныйИдентификатор КАК ИИКТовара
ИЗ
РегистрНакопления.ОстаткиТовар КАК РегистрНакопления.ОстаткиТовар

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

Контекст использования	Метод получения	Тип возвращаемого значения
Создание новой записи	Функция УникальныйИдентификатор()	УникальныйИдентификатор
Чтение из объекта	Свойство Ссылка.УникальныйИдентификатор	УникальныйИдентификатор
Запрос к регистру	Поле Измерение.УникальныйИдентификатор	Строка (UUID)
Регистратор документа	Свойство Регистратор.УникальныйИдентификатор	УникальныйИдентификатор

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

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

Работа с идентификаторами через COM и внешние соединения

При интеграции 1С с внешним миром через COM-соединение или веб-сервисы, передача уникальных идентификаторов требует особого внимания к типам данных. Внешняя система (например.NET приложение или Java сервис) может не знать о нативном типе 1С:УникальныйИдентификатор.

В таких случаях необходимо явно преобразовывать идентификатор в строковое представление. Стандартный метод ToString() возвращает строку в формате, принятом в 1С, который обычно совместим с GUID в других языках программирования.

Пример передачи через COM:

V8 = Новый COMОбъект("V83.COMConnector");
Соединение = V8.Connect("Srvr=""localhost"";Ref=""MyBase"";");
ИД = Соединение.УникальныйИдентификатор().ToString();

Сериализация данных в JSON или XML также требует приведения UUID к строке. Библиотеки работы с JSON в 1С (например, JSONWriter) автоматически обрабатывают этот тип, но при ручном формировании строк нужно быть осторожным с кавычками и экранированием.

⚠️ Внимание: При передаче UUID в веб-сервисы (SOAP/REST) убедитесь, что формат строки (с дефисами или без) соответствует ожиданиям принимающей стороны. Некоторые системы требуют формат "bare UUID" (без дефисов).

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

Проблема регистронезависимости

В некоторых старых внешних системах GUID может трактоваться регистрозависимо. В 1С тип УникальныйИдентификатор регистронезависим при сравнении, но при конвертации в строку буквы становятся строчными.

Особенности в распределенных информационных базах (РИБ)

В архитектуре РИБ (Распределенная Информационная База) уникальный идентификатор играет ключевую роль в механизме регистрации изменений. Каждому узлу распределенной базы присваивается свой префикс, но глобальный UUID объекта должен оставаться единым для всей сети узлов.

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

• 🌐 Идентификатор должен быть уникален в масштабах всей распределенной системы.
• 🔄 При слиянии веток РИБ конфликты по UUID разрешаются автоматически платформой.
• ⚙️ Настройка правил обмена данными должна учитывать тип ключа ссылки.

Разработчикам следует избегать ручного вмешательства в поля идентификаторов при настройке правил конвертации данных (КД 2.x или КД 3.x). Платформа сама сопоставляет объекты по их внутренним ключам.

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

Диагностика и анализ идентификаторов в консоли запросов

Для глубокого анализа данных администраторы и разработчики часто используют консоль запросов или обработку "Администрирование". Просмотр сырых данных таблиц позволяет увидеть реальные значения полей, хранящихся в СУБД.

Чтобы увидеть идентификаторы, необходимо включить отображение системных полей или явно выбрать их в запросе. В таблицах базы данных (например, _Reference12) это поле обычно имеет имя _FldRRef или подобное, но работать с ним напрямую через SQL не рекомендуется из-за различий в хранении для разных СУБД (MSSQL, PostgreSQL, Oracle).

Лучшим способом является использование родного языка запросов 1С, который абстрагирует физические особенности хранения данных в конкретной СУБД.

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

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

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

Можно ли изменить УникальныйИдентификатор у уже созданного объекта?

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

Совпадает ли УникальныйИдентификатор в 1С с GUID в SQL Server?

Да, при использовании СУБД MS SQL Server внутренний формат хранения типа УникальныйИдентификатор 1С совместим с типом данных uniqueidentifier. Однако доступ к нему следует осуществлять только через механизмы платформы 1С.

Зачем нужен ИИК, если есть Код и Наименование элемента?

Код и Наименование могут дублироваться или меняться пользователем. УникальныйИдентификатор (ИИК/UUID) является неизменяемым техническим ключом, который гарантирует однозначную идентификацию записи даже при изменении её атрибутов или в случае удаления объекта (для истории).

Как получить UUID удаленного элемента справочника?

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