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

Другое · 7 мин

Как по UID получить объект в 1С:Предприятии

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

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

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

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

Что такое UID в 1С и где он пригодится

UID не заменит код, номер документа или наименование. Это системный идентификатор, который остаётся привязанным к конкретной записи в рамках одной информационной базы. Он удобен при обмене с внешними сервисами, когда сторона не знает внутренней нумерации 1С, но передаёт уникальный ключ записи.

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

UID передан внешней системойНужно убедиться в формате и принадлежности к текущей базе

Проверить длину, регистр и отсутствие лишних пробелов перед поиском

Ссылка найденаОбъект существует и доступен по текущим правам

Получить объект и проверить признак пометки на удаление

Ссылка не найденаUID неверен, объект удалён или нет прав

Не пытаться подбирать идентификатор вручную

Как найти ссылку по уникальному идентификатору

Для справочников, документов и ряда других метаданных платформа предоставляет поиск по уникальному идентификатору на уровне менеджера объекта. Нужно указать имя метаданных и передать значение UID в поддерживаемом платформе формате.

Пример для справочника

Типичная конструкция выглядит как получение ссылки через менеджер справочника, а затем преобразование ссылки в объект. Точное название метода уточняется в справке по синтаксису вашего релиза.

UID = Новый УникальныйИдентификатор(СтрокаUID);
Ссылка = Справочники.Контрагенты.НайтиПоУникальномуИдентификатору(UID);
Если Ссылка = Неопределено Тогда
// объект не найден
КонецЕсли;

Если UID приходит как текст, его предварительно преобразуют в тип уникального идентификатора. Неправильная строка может привести к ошибке при преобразовании или к пустому результату поиска.

Порядок действий
  1. 1
    Убедиться, что UID принадлежит текущей информационной базе
  2. 2
    Найти ссылку по UID через менеджер нужного метаданных
  3. 3
    Проверить, что ссылка не пустая
  4. 4
    Получить объект через ПолучитьОбъект
  5. 5
    Проверить результат и права доступа

Как получить объект из ссылки

После успешного поиска ссылка передаётся в метод получения объекта того же метаданных. Для справочника это обычно ПолучитьОбъект, для документа — аналогичный метод менеджера документа. Полученный объект можно изменять, если у пользователя есть права и объект не помечён на удаление.

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

Если объект нужен только для чтения, всё равно стоит проверять доступность и актуальность данных. В многопользовательском режиме запись может быть изменена другим пользователем между поиском по UID и моментом записи.

Проверка результата и обработка отсутствия объекта

После поиска по UID обязательно проверяйте, что ссылка не равна Неопределено и не пустая ссылка. Только после этого вызывайте получение объекта. Иначе попытка обратиться к реквизитам приведёт к ошибке выполнения.

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

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

Ограничения, права и типичные ошибки

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

Частая ошибка — использовать UID из одной информационной базы в другой. Идентификаторы не переносятся автоматически при обмене или копировании базы без специальных настроек, поэтому такой поиск вернёт пустой результат.

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

Сравнение вариантов

Поиск по UID

Подходит для интеграций и точного доступа к записи, но требует корректного формата и доступа к текущей базе

Поиск по коду или наименованию

Понятнее пользователю, но может быть неоднозначным при совпадении реквизитов

Поиск по номеру документа

Удобен внутри одной конфигурации, но менее стабилен при переносе данных

Когда не стоит использовать поиск по UID

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

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

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

Итог

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

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

Частые вопросы

Можно ли найти объект по UID, не зная имя справочника?

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

Что делать, если поиск по UID вернул пустую ссылку?

Проверьте правильность идентификатора, принадлежность к текущей информационной базе и права доступа. Объект может быть удалён, помечён на удаление или просто не существовать в этой базе.

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

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

Безопасно ли изменять объект, найденный по UID?

Только после проверки прав, отсутствия пометки на удаление и тестирования на копии базы. Изменения могут затронуть связанные регистры и документы, поэтому запись следует выполнять осознанно.

Останется ли UID неизменным после копирования базы?

Не обязательно. Идентификаторы привязаны к конкретной информационной базе, а при копировании, восстановлении или переносе могут появиться новые записи с другими UID. Сверяйте ключ в той базе, где ведётся работа.