К статье
Практический материал

Другое · 7 мин

Как установить гуид объекта в 1С: порядок действий и проверка

Как установить гуид объекта в 1С: где найти идентификатор, как задать его программно, проверить результат и избежать ошибок при обмене данными.

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

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

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

Что такое гуид объекта в 1С и зачем его задавать

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

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

Где найти и посмотреть гуид объекта

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

Для элементов справочника и документов

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

Для объектов конфигурации

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

Порядок действий
  1. 1
    Откройте объект на редактирование в форме или модуле
  2. 2
    Создайте значение Новый УникальныйИдентификатор
  3. 3
    Присвойте его реквизиту УникальныйИдентификатор объекта
  4. 4
    Запишите объект и проверьте сохранение

Как установить гуид программно

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

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

1c
Объект.УникальныйИдентификатор = Новый УникальныйИдентификатор();

Особенности по типам объектов

Для элементов справочника гуид чаще всего используется при выгрузке номенклатуры или контрагентов во внешние системы. Для документов идентификатор помогает связать первичный документ с данными в другой базе без использования номера и даты, которые могут повторяться. Регистры и другие табличные объекты могут не иметь удобного поля для прямого задания гуида в интерфейсе.

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

Контрольные точки

Как проверить результат

Поле УникальныйИдентификатор в форме объекта
Норма

Заполнено и не меняется при повторном открытии

Тревожный признак

Пустое поле или разные значения при открытии

Уникальность в базе
Норма

Никаких предупреждений о дубликатах при записи

Тревожный признак

Сообщение о существующем объекте с таким идентификатором

Как проверить, что гуид установлен правильно

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

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

Ограничения и риски при изменении идентификатора

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

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

Типичные ошибки
01
Изменение гуида у уже выгруженного объекта — нарушение связи с внешней базой
02
Присвоение одинакового гуида разным записям — конфликты при загрузке и дубли

Альтернативы и когда гуид не нужен

Если обмен данными не планируется и объекты идентифицируются внутри одной базы по коду или номеру, явное задание гуида может быть избыточным. В некоторых типовых конфигурациях платформа сама управляет идентификаторами, и ручное вмешательство не требуется. Решение о задании гуида должно приниматься на основе задачи интеграции, а не «на всякий случай».

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

Итог

Что важно запомнить

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

Часто задаваемые вопросы

Можно ли задать гуид для любого объекта в 1С?

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

Что будет, если два объекта получат одинаковый гуид?

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

Нужно ли делать резервную копию перед массовым присвоением гуидов?

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

Можно ли менять гуид после выгрузки данных во внешнюю систему?

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