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