Другое · 7 мин
Как установить гуид объекта в 1С: порядок действий и проверка
Как установить гуид объекта в 1С: где найти идентификатор, как задать его программно, проверить результат и избежать ошибок при обмене данными.
Гуид (уникальный идентификатор) объекта в 1С — это строка, которая однозначно отличает одну запись справочника, документа или другого объекта от всех остальных в информационной базе. Идентификатор используется при обмене данными, интеграции с внешними системами и поиске записей без привязки к номеру или коду.
Задать гуид можно как для объектов конфигурации в режиме настройки, так и для записей базы данных в режиме работы. Способ зависит от типа объекта: у элементов справочников и документов обычно есть реквизит УникальныйИдентификатор, а у метаобъектов конфигурации значение формируется платформой и править его вручную не следует.
Перед изменением идентификатора нужно понимать, где он хранится и какие процессы от него зависят. Неправильно заданный или дублирующийся гуид приведет к ошибкам при выгрузке и загрузке данных, поэтому работу стоит начинать с диагностики текущего состояния.
Что такое гуид объекта в 1С и зачем его задавать
Гуид представляет собой уникальный идентификатор, который платформа может генерировать автоматически или принимать от разработчика. В отличие от кода или номера документа, гуид не предназначен для показа пользователю и не должен быть понятным человеку. Его главное назначение — однозначная идентификация объекта при обмене между разными базами.
Идентификатор особенно важен при выгрузке в интернет-магазин, синхронизации с мобильным приложением или передаче данных в стороннюю систему. Если два объекта в разных информационных базах имеют одинаковый гуид, платформа может воспринять их как одну и ту же запись, что приведет к дублям или потере данных.
Где найти и посмотреть гуид объекта
В форме объекта справочника или документа реквизит УникальныйИдентификатор может быть скрытым. Чтобы его увидеть, нужно открыть настройку формы или добавить реквизит в список отображаемых полей. В конфигураторе значение для метаобъекта открывается в свойствах элемента дерева конфигурации, но часто доступно только для чтения.
Для элементов справочника и документов
Откройте нужную запись в режиме редактирования и найдите реквизит с именем УникальныйИдентификатор. Если поле пустое, объект еще не имеет присвоенного идентификатора. Если поле заполнено, значение уже используется системой и его изменение требует осторожности.
Для объектов конфигурации
Метаобъекты конфигурации — справочники, документы, регистры и другие элементы дерева — получают гуид при создании в конфигураторе. Это значение привязано к структуре конфигурации, а не к отдельной записи базы, и менять его вручную в конфигураторе не рекомендуется.
- 1Откройте объект на редактирование в форме или модуле
- 2Создайте значение Новый УникальныйИдентификатор
- 3Присвойте его реквизиту УникальныйИдентификатор объекта
- 4Запишите объект и проверьте сохранение
Как установить гуид программно
Для записи базы данных идентификатор присваивается через встроенный язык 1С. В модуле объекта или формы создается новый уникальный идентификатор и записывается в реквизит объекта перед сохранением. После записи значение фиксируется в базе и становится доступным для обмена.
Пример присваивания в коде выглядит как обращение к реквизиту объекта и создание нового идентификатора средствами платформы. Сохранение объекта происходит обычным образом через команду Записать, после чего гуид становится частью записи.
Объект.УникальныйИдентификатор = Новый УникальныйИдентификатор();Особенности по типам объектов
Для элементов справочника гуид чаще всего используется при выгрузке номенклатуры или контрагентов во внешние системы. Для документов идентификатор помогает связать первичный документ с данными в другой базе без использования номера и даты, которые могут повторяться. Регистры и другие табличные объекты могут не иметь удобного поля для прямого задания гуида в интерфейсе.
Если конфигурация разработана сторонним поставщиком, реквизит УникальныйИдентификатор может быть закрыт от редактирования или использоваться внутренней логикой системы. В таких случаях изменение значения вручную может нарушить работу типовых механизмов обмена и обновлений.
Как проверить результат
Заполнено и не меняется при повторном открытии
Пустое поле или разные значения при открытии
Никаких предупреждений о дубликатах при записи
Сообщение о существующем объекте с таким идентификатором
Как проверить, что гуид установлен правильно
Простейшая проверка — открыть карточку объекта и убедиться, что поле УникальныйИдентификатор заполнено и не пустое. Можно также выполнить запрос к базе, выбрав идентификатор по ссылке на объект, и сравнить значение с ожидаемым. При обмене данными стоит сверять гуиды в исходной и приемной базах.
Если после установки гуида объект корректно записывается, открывается и участвует в обмене без ошибок, можно считать результат положительным. При появлении сообщений о конфликте идентификаторов работу нужно приостановить и разобраться в причине.
Ограничения и риски при изменении идентификатора
Гуид не стоит менять после того, как объект уже участвовал в обмене или был передан во внешнюю систему. Изменение идентификатора разрывает связь между записями в разных базах и может привести к созданию дублей или невозможности загрузки обновлений. Это особенно критично для справочников номенклатуры и контрагентов.
Дублирование гуидов между разными объектами одной базы недопустимо. Перед массовым присвоением идентификаторов рекомендуется сделать резервную копию информационной базы и протестировать процедуру на копии. Самостоятельная работа допустима при наличии доступа к конфигурации и понимании механизмов обмена.
Альтернативы и когда гуид не нужен
Если обмен данными не планируется и объекты идентифицируются внутри одной базы по коду или номеру, явное задание гуида может быть избыточным. В некоторых типовых конфигурациях платформа сама управляет идентификаторами, и ручное вмешательство не требуется. Решение о задании гуида должно приниматься на основе задачи интеграции, а не «на всякий случай».
При необходимости переноса данных между базами без использования гуида можно полагаться на комбинацию реквизитов, например код и наименование, но такой подход менее надежен при наличии одноименных записей. Выбор способа идентификации зависит от архитектуры обмена и требований к точности сопоставления.
Что важно запомнить
Гуид задается через реквизит УникальныйИдентификатор, проверяется после записи и не меняется у объектов, участвующих в обмене данными.
Часто задаваемые вопросы
Можно ли задать гуид для любого объекта в 1С?
Не для любого. Реквизит УникальныйИдентификатор присутствует не у всех объектов и не во всех конфигурациях. Для метаобъектов конфигурации значение обычно формируется платформой и недоступно для ручного изменения.
Что будет, если два объекта получат одинаковый гуид?
Платформа может считать их одной записью при обмене, что приведет к дублям, потере данных или ошибкам загрузки. Идентификаторы должны быть уникальными в пределах базы и при межбазовом обмене.
Нужно ли делать резервную копию перед массовым присвоением гуидов?
Да. Массовое изменение идентификаторов может затронуть множество записей и нарушить связи, поэтому перед началом работы рекомендуется создать копию информационной базы и проверить процедуру в тестовой среде.
Можно ли менять гуид после выгрузки данных во внешнюю систему?
Не рекомендуется. Изменение идентификатора после обмена разрывает связь между записями в разных базах и может привести к невозможности загрузки обновлений или созданию дублей.