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

Другое · 6 мин

Как получить UID в запросе 1С 8.3

Практические способы получить уникальный идентификатор объекта в запросе 1С 8.3, поля и функции, проверка результата и типичные ошибки.

В языке запросов 1С:Предприятия 8.3 уникальный идентификатор объекта чаще всего извлекается не отдельной универсальной функцией, а из системного поля ссылки или специального атрибута объекта. Точный набор доступных полей зависит от конфигурации, метаданных справочника, документа или регистра, а также от поддерживаемых платформой конструкций.

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

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

Что считать идентификатором объекта

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

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

Есть реквизит УникальныйИдентификаторПрямое поле в запросе

Проверьте состав справочника или документа в конфигураторе

Только ссылкаИдентификатор внутри базы

Подходит для отбора, не всегда удобен для обмена

Нет явного идентификатораТребуется доработка

Добавьте реквизит или используйте программный доступ

Как получить идентификатор в языке запросов

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

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

Пример проверки результата запроса

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

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

Ограничения и риски при работе с UID

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

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

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

Частые ошибки и способы их исправления

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

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

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

Альтернативы, если прямой запрос не подходит

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

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

Итог

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

UID в запросе 1С 8.3 берут из ссылки или реквизита объекта, если он есть; проверяйте пустые значения, дубли и не правьте идентификаторы вручную.

Можно ли получить UID любого объекта обычным запросом?

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

Чем отличается ссылка от уникального идентификатора?

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

Почему UID может отличаться в разных базах?

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

Что делать, если поле УникальныйИдентификатор отсутствует?

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