Как получить GUID документа 1С: способы и примеры кода

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

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

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

Природа уникального идентификатора в 1С

Уникальный идентификатор (или UUID) генерируется платформой в момент создания записи в базе данных. Это 128-битное число, которое гарантирует уникальность объекта не только в пределах одной базы, но и теоретически позволяет избегать коллизий при объединении данных из разных источников.

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

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

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

⚠️ Внимание: Не пытайтесь хранить GUID в обычных строковых полях базы данных без предварительного анализа длины. Стандартное представление UUID занимает 36 символов с дефисами, и обрезка этого значения приведет к потере уникальности и ошибкам при поиске.

Получение GUID через свойства ссылки

Самый распространенный способ получения уникального идентификатора — обращение к свойству ссылки на объект. В коде на языке 1С это делается через стандартное свойство УникальныйИдентификатор.

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

ДокСсылка = Документы.РеализацияТоваровУслуг.ПолучитьСсылку(КлючДокумента);
Если ДокСсылка.Пустая() Тогда
Сообщить("Документ не найден");
Иначе
УникальныйID = ДокСсылка.УникальныйИдентификатор;
СтрокаID = Строка(УникальныйID);
КонецЕсли;

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

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

Извлечение GUID из результата запроса

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

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

Ниже приведен пример корректного формирования запроса для выборки идентификаторов документов:

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

Результат = ВыполнитьЗапрос(ТекстЗапроса);
Выборка = Результат.Выбрать();

Пока Выборка.Следующий() Цикл
// Выборка.GUID уже содержит значение типа UUID
Сообщить(Строка(Выборка.GUID));
КонецЦикла;

Важно отметить, что в результате запроса поле будет иметь тип UUID. Если вам требуется сразу строковое представление для выгрузки в файл, можно использовать функцию ЕСТЬNULL() в сочетании с преобразованием, хотя чаще это делают на этапе обработки выборки в коде.

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

☑️ Проверка перед выгрузкой GUID

Убедиться, что ссылка не пустаяПроверить тип возвращаемого значенияПроверить кодировку при конвертации в строкуУбедиться в наличии прав на чтение

Выполнено: 0 / 4

Работа с GUID в внешних системах и JSON

Современная интеграция невозможна без использования формата JSON. При сериализации объектов 1С в JSON уникальный идентификатор часто является ключевым полем для связи записей. Однако стандартный механизм сериализации может представлять UUID по-разному в зависимости от настроек.

При записи значения типа UUID в JSON-запись с помощью объекта ЗаписьJSON, платформа автоматически преобразует его в строку формата "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx". Это стандартный формат представления, понятный большинству внешних систем, включая веб-браузеры и сервисы на Java или .NET.

Если вы разрабатываете HTTP-сервис на стороне 1С, то получение GUID из входящего запроса также не вызывает сложностей. Конструктор объектов 1С умеет автоматически распознавать строку формата UUID и преобразовывать её во внутренний тип данных при чтении JSON.

Метод получения	Тип возвращаемого значения	Производительность	Рекомендуемое использование
Свойство ссылки	UUID	Высокая	Работа с единичными объектами
Язык запросов	UUID	Очень высокая	Массовая выборка данных
COM-соединение	String / BSTR	Низкая	Внешняя автоматизация из других приложений
ODBC / JDBC	String (GUID)	Средняя	Прямой доступ к СУБД

Следует учитывать, что при передаче GUID через URL в качестве параметра (например, в REST API), символы могут требовать кодирования. Хотя сам формат UUID содержит только безопасные символы (цифры и буквы латинского алфавита), дефисы иногда могут интерпретироваться шлюзами безопасности неверно.

Особенности хранения в SQL

В СУБД MS SQL Server тип данных UNIQUEIDENTIFIER хранится в бинарном виде, но при прямых запросах через SQL Management Studio отображается как строка. В PostgreSQL используется тип UUID. Платформа 1С абстрагирует эти различия, предоставляя единый интерфейс работы.

Генерация нового GUID для временных объектов

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

Для этих целей в глобальном контексте платформы существует метод НовыйУникальныйИдентификатор(). Этот метод генерирует новое значение типа UUID согласно стандарту RFC 4122.

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

Использование этого метода гарантирует, что полученное значение не совпадет ни с одним из существующих в базе данных идентификаторов (вероятность коллизии стремится к нулю). Это надежный способ создания ключей для временных таблиц или регистров накопления, где запись не имеет статуса "документа".

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

⚠️ Внимание: Не используйте сгенерированный НовыйУникальныйИдентификатор() для попытки найти существующий документ, если вы не знаете его точный ID. Поиск по несуществующему ключу вернет пустую ссылку, но не создаст новую запись автоматически.

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

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

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

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

💡

При отладке кода удобно использовать панель "Значения". Если добавить туда переменную типа UUID, система автоматически покажет её строковое представление, что упрощает верификацию данных без написания дополнительного кода вывода.

💡

Оптимальная стратегия работы с GUID — хранить и сравнивать значения в нативном типе UUID внутри 1С, выполняя преобразование в строку только в момент экспорта данных.

Можно ли изменить GUID уже записанного документа?

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

Почему GUID в базе данных и в коде выглядят по-разному?

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

Как получить GUID справочника, если известна только его ссылка?

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

Влияет ли удаление и создание документа заново на его GUID?

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

Как получить GUID документа 1С: Полное руководство