Другое · 9 мин
Как получить GUID объекта в 1С: практическое руководство
Как получить GUID объекта в 1С: через свойство УникальныйИдентификатор, программно и в обмене данными, с проверкой результата и ограничениями.
GUID объекта в 1С используется для однозначной идентификации записи независимо от её кода, номера или наименования. Такой идентификатор полезен при обмене данными между информационными базами, интеграции с внешними системами и сравнении объектов, когда реквизиты могут совпадать, а экземпляры быть разными.
Платформа 1С:Представление предоставляет несколько способов получения идентификатора: через свойство объекта, программно в модуле объекта или формы, а также средствами метаданных. Выбор способа зависит от типа объекта, доступа к конфигурации и того, нужно ли получить значение в режиме предприятия или в конфигураторе.
Перед началом работы уточните, поддерживает ли конкретный объект свойство уникального идентификатора. Не все справочники, документы и регистры одинаково предоставляют этот реквизит, а в некоторых конфигурациях значение может быть пустым до первого сохранения или публикации объекта.
Что представляет собой GUID объекта в 1С
GUID — это уникальный идентификатор, который платформа может присвоить объекту при создании или хранении. В интерфейсе 1С он обычно не отображается в обычной форме списка, но доступен программно. Основное отличие GUID от кода или номера в том, что он не предназначен для ввода пользователем и не меняется при редактировании реквизитов в пределах одной базы.
Идентификатор востребован, когда нужно сослаться на объект извне: выгрузить данные в другую систему, загрузить обратно без потери связи или сравнить записи из двух баз. При этом GUID не заменяет код объекта и не является основным реквизитом для отчетов и печатных форм, если конфигурация не предусматривает иное.
Способы получения GUID через встроенные средства
Свойство УникальныйИдентификатор у объекта
Для многих объектов конфигурации достаточно обратиться к экземпляру и прочитать свойство УникальныйИдентификатор. Это справедливо для справочников, документов, элементов планов обмена и некоторых других метаобъектов, если платформа и конфигурация поддерживают такое свойство. Значение возвращается в виде строки или специального типа идентификатора, который можно использовать в запросах и обмене.
Если объект только что создан и ещё не записан, свойство может быть не заполнено. После записи объекта и повторного чтения идентификатор обычно становится доступным. Проверяйте результат сразу после сохранения, чтобы не пытаться использовать пустой GUID в процессах выгрузки.
Различия для справочников, документов и регистров
Справочники и документы чаще всего предоставляют прямой доступ к уникальному идентификатору через объект. Регистры накопления и бухгалтерии могут не иметь единого объекта с таким свойством, поэтому идентификацию записей ведут через измерения и реквизиты, а не через один GUID строки регистра.
Перед использованием в интеграции уточните у разработчика конфигурации, какие объекты участвуют в обмене и каким полем они сопоставляются. Не полагайтесь на наличие GUID только по названию справочника или документа.
Объект = Справочники.Контрагенты.НайтиПоНаименованию("ООО Пример");
Если Объект <> Неопределено Тогда
Guid = Объект.УникальныйИдентификатор;
Сообщить(Guid);
КонецЕсли;Получение GUID программно
В модуле объекта или формы можно получить текущий идентификатор прямо из контекста. Например, при обработке события записи документа достаточно обратиться к свойству УникальныйИдентификатор у объекта ЭтотОбъект. Такой подход удобен, когда нужно сохранить связь с созданной записью или передать её во внешний сервис.
Если доступен только менеджер объекта, а не экземпляр, сначала найдите нужную запись по коду, наименованию или другому уникальному реквизиту, а затем читайте свойство у найденного экземпляра. Поиск по не уникальному полю может вернуть несколько объектов, поэтому уточняйте критерий отбора.
Для массового получения идентификаторов используйте запросы к табличным частям или объектам, если конфигурация позволяет выбирать свойство УникальныйИдентификатор в запросе. В противном случае придётся обходить коллекцию объектов в цикле, что медленнее и создаёт большую нагрузку на сервер.
Когда GUID недоступен или может измениться
Не во всех ситуациях идентификатор остаётся стабильным. При копировании информационной базы, восстановлении из резервной копии или переносе данных между базами значения GUID могут не совпадать, даже если внешние реквизиты объектов идентичны. Это важно учитывать при планировании обмена и синхронизации.
В некоторых конфигурациях идентификатор может быть скрыт или недоступен для редактирования, а в отдельных релизах платформа ведёт себя иначе. Не вносите изменения в конфигурацию только ради получения GUID, если это не требуется для бизнес-процесса.
Безопасная самостоятельная работа ограничивается чтением свойства и использованием его в отчетах или выгрузках. Попытки вручную присвоить или изменить GUID могут нарушить целостность данных и привести к ошибкам при обмене.
Проверка результата и использование в обмене
После получения идентификатора убедитесь, что значение не пустое и соответствует ожидаемому объекту. Сравните GUID с тем, который возвращается при повторном чтении той же записи. Если значения различаются без причины, проверьте, не идёт речь о разных экземплярах или версиях объекта.
При выгрузке в формах обмена или через веб-сервисы передавайте GUID вместе с кодом и наименованием. Получающая сторона сможет найти запись по идентификатору, даже если код изменился, либо использовать код как резервный критерий поиска.
Документируйте, какие объекты и в каких ситуациях идентифицируются через GUID. Это упростит поддержку интеграций и поможет избежать ситуации, когда один и тот же реальный контрагент или документ имеет разные идентификаторы в разных базах.
Типичные ошибки при работе с GUID
Одна из частых ошибок — попытка получить GUID у несохранённого объекта. В этом случае свойство может быть пустым, а последующая выгрузка приведёт к потере связи. Всегда записывайте объект перед использованием его идентификатора во внешних процессах.
Как выбрать действие
Другая ошибка — сравнение GUID из разных информационных баз как одинаковых. Даже идентичные по наименованию объекты могут иметь разные идентификаторы после независимого создания или копирования базы. Проверяйте соответствие по нескольким реквизитам, а не только по GUID.
Не используйте GUID вместо кода в пользовательских отчетах без согласования с разработчиками. Код остаётся понятным человеку, а GUID — техническим идентификатором, который трудно проверить в интерфейсе без программного доступа.
Сравнение вариантов
Подходит для отдельных объектов, если конфигурация поддерживает свойство. Ограничение: не работает у несохранённых и некоторых системных объектов.
Удобен для массового получения идентификаторов. Ограничение: зависит от поддержки свойства в запросе и структуры конфигурации.
Универсальный вариант, когда прямой доступ к свойству затруднён. Ограничение: требует уникальности критерия поиска.
Как выбрать подходящий способ получения
Если доступ к конфигурации ограничен, начните с проверки в модуле формы или отчёта, где объект уже открыт. Так вы минимизируете риск изменения структуры базы и сможете быстро убедиться, что идентификатор доступен. При необходимости автоматизации подготовьте отдельный внешний обработчик с чтением без записи.
Для интеграции с внешними системами согласуйте поле сопоставления заранее. Иногда удобнее передавать и код, и GUID, чтобы получающая система могла выбрать надёжный способ поиска в зависимости от доступных данных.
Что важно запомнить
GUID объекта в 1С получают через свойство УникальныйИдентификатор после записи, проверяют на пустоту и не меняют вручную. При копировании базы идентификаторы могут отличаться, поэтому используйте их вместе с другими реквизитами.
Нужно ли сохранять объект перед получением GUID?
Да, в большинстве случаев идентификатор становится доступен после записи объекта. Для только что созданного, но не записанного экземпляра свойство может быть пустым.
Может ли GUID измениться при редактировании объекта?
В пределах одной информационной базы при обычном редактировании реквизитов идентификатор обычно остаётся прежним. Изменения возможны при копировании базы, восстановлении или специфических операциях конфигурации.
Что делать, если свойство УникальныйИдентификатор отсутствует?
Уточните у разработчика конфигурации, поддерживает ли объект этот реквизит. В противном случае используйте код, наименование или другие уникальные поля для идентификации и обмена.
Безопасно ли использовать GUID в качестве ключа в собственных таблицах?
Только после согласования с разработчиком и проверки стабильности идентификатора в вашей конфигурации. Несанкционированное использование может нарушить связи и процессы обмена данными.