В работе с 1С:Предприятие 8.3 часто возникает задача: есть уникальный идентификатор объекта (UID), но нужно получить прямую ссылку на него — например, для интеграции с внешними системами, формирования отчетов или автоматизации бизнес-процессов. На первый взгляд задача простая, но на практике сталкиваешься с нюансами: разные типы объектов хранят UID по-разному, а методы получения ссылок зависят от конфигурации и версии платформы.

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

Что такое UID в 1С и почему его недостаточно для ссылки

UID (Unique Identifier) в 1С:Предприятие — это глобально уникальный идентификатор объекта, который присваивается автоматически при создании и остается неизменным даже при переносе данных между базами. Однако UID сам по себе не является ссылкой: он не содержит информации о типе объекта (справочник, документ, регистр) и не привязан к конкретной базе данных.

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

  • 📌 Тип объекта (Документ.ЗаказПокупателя)
  • 🔢 Идентификатор в пределах типа (обычно номер или код)
  • 🌐 Привязку к текущей базе данных

UID же — это просто строка вроде "a1b2c3d4-5678-90ef-1234-567890abcdef", и без дополнительных данных превратить её в ссылку невозможно.

Более того, в разных конфигурациях UID может храниться в разных местах:

  • 📁 В справочниках — в реквизите УникальныйИдентификатор или UID
  • 📄 В документах — в стандартном реквизите УникальныйИдентификатор (если не отключен)
  • 🗃 В регистрах — может отсутствовать вообще или храниться в измерениях

Это означает, что универсального способа получить ссылку по UID нет — нужно знать контекст.

📊 С какой целью вам нужно преобразовать UID в ссылку?
Интеграция с внешней системой
Автоматизация отчетов
Перенос данных между базами
Другое

Способ 1: Стандартный метод платформы (ПолучитьСсылкуПоUID)

Начиная с версии 1С:Предприятие 8.3.14, в платформе появился встроенный метод ПолучитьСсылкуПоUID(), который кажется идеальным решением. Однако у него есть серьезные ограничения:

ПараметрОписаниеОграничения
УникальныйИдентификаторСтрока UID (формат GUID)Должен существовать в текущей базе
ТипОбъектаСтрока с типом (например, "Документ.ЗаказПокупателя")Обязателен, если UID не уникален в базе
ПараметрыПоискаДополнительные фильтры (например, дата документа)Работает не для всех типов объектов

Пример использования:

UID = "a1b2c3d4-5678-90ef-1234-567890abcdef";

ТипОбъекта = "Справочник.Контрагенты";



// Попытка получить ссылку


Ссылка = ПолучитьСсылкуПоUID(UID, ТипОбъекта);



Если Ссылка = Неопределено Тогда


Сообщить("Объект с таким UID не найден!");


Иначе


Сообщить("Ссылка получена: " + Ссылка);


КонецЕсли;

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

💡

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

Способ 2: Поиск по метаданным и реквизитам

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

Алгоритм действий:

  1. Получить список всех метаданных (справочников, документов и т.д.)
  2. Для каждого типа объекта проверить наличие реквизита с UID
  3. Выполнить запрос к базе с фильтром по UID

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

Функция НайтиОбъектПоUID(UID)

// Получаем все справочники в конфигурации


Метаданные = Метаданные.Справочники();



Для Каждого Справочник Из Метаданные Цикл


// Проверяем, есть ли реквизит с UID


Если Справочник.Реквизиты.Найти("УникальныйИдентификатор") <> Неопределено Тогда


Запрос = Новый Запрос;


Запрос.Текст =


"ВЫБРАТЬ


|   Ссылка КАК Ссылка


|ИЗ


|   Справочник." + Справочник.Имя + " КАК Объект


|ГДЕ


|   Объект.УникальныйИдентификатор = &UID";



Запрос.УстановитьПараметр("UID", UID);


Результат = Запрос.Выполнить();



Если НЕ Результат.Пустой() Тогда


Возврат Результат[0].Ссылка;


КонецЕсли;


КонецЕсли;


КонецЦикла;



Возврат Неопределено;


КонецФункции;

Этот метод более гибкий, но имеет свои минусы:

  • ⚠️ Низкая производительность: обход всех метаданных может занять много времени в больших конфигурациях.
  • ⚠️ Не работает для удаленных объектов: если объект помечен на удаление, его UID может остаться в базе, но ссылку получить не удастся.
  • ⚠️ Требует прав на чтение метаданных: в некоторых конфигурациях это может быть ограничено.

Проверьте наличие реквизита "УникальныйИдентификатор" в целевом объекте|

Убедитесь, что у вас есть права на чтение метаданных|

Ограничьте поиск конкретными типами объектов для ускорения|

Используйте транзакции, если поиск выполняется в рабочей базе-->

Способ 3: Использование регистра УникальныеИдентификаторыОбъектов

В большинстве типовых конфигураций (например, 1С:ERP или 1С:Управление торговлей) есть специальный регистр сведений УникальныеИдентификаторыОбъектов, который хранит соответствие между UID и ссылками. Это самый надежный способ, если регистр не был отключен или очищен.

Пример запроса к регистру:

Запрос = Новый Запрос;

Запрос.Текст =


"ВЫБРАТЬ


|   УникальныеИдентификаторыОбъектов.Ссылка КАК Ссылка


|ИЗ


|   РегистрСведений.УникальныеИдентификаторыОбъектов КАК УникальныеИдентификаторыОбъектов


|ГДЕ


|   УникальныеИдентификаторыОбъектов.УникальныйИдентификатор = &UID";



Запрос.УстановитьПараметр("UID", UID);


Результат = Запрос.Выполнить();



Если НЕ Результат.Пустой() Тогда


Ссылка = Результат[0].Ссылка;


// Дополнительно можно проверить тип объекта


ТипОбъекта = Ссылка.Метаданные().Имя;


Иначе


Сообщить("UID не найден в регистре УникальныеИдентификаторыОбъектов");


КонецЕсли;

Преимущества этого метода:

  • 🔍 Высокая скорость: запрос к регистру выполняется мгновенно даже в больших базах.
  • 🛡 Надежность: регистр обновляется автоматически при изменении объектов.
  • 🔄 Поддержка архивных объектов: даже если объект помечен на удаление, его UID остается в регистре.

⚠️ Внимание: В некоторых нетиповых конфигурациях регистр УникальныеИдентификаторыОбъектов может быть отключен или модифицирован. Перед использованием проверьте его наличие в метаданных (Метаданные.РегистрыСведений.Найти("УникальныеИдентификаторыОбъектов")).

Типичные ошибки и как их избежать

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

ОшибкаПричинаРешение
Неопределено вместо ссылкиUID не существует в базе или принадлежит другому типу объектаПроверьте UID в регистре УникальныеИдентификаторыОбъектов или уточните тип объекта
Ошибка приведение типа недопустимоПопытка присвоить UID переменной типа Ссылка напрямуюИспользуйте ПолучитьСсылкуПоUID() или явное приведение типов
Неверный формат UIDUID передан без дефисов или в неправильном регистреНормализуйте строку с помощью СтрЗам(UID, "-", "") или ВРег(UID)
Долгий поиск по метаданнымОбход всех объектов в большой конфигурацииОграничьте поиск конкретными типами (например, только документами)

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

// Пример обработки конфликта UID

UID = "a1b2c3d4-5678-90ef-1234-567890abcdef";


ПредполагаемыйТип = "Документ.РеализацияТоваровУслуг";



Ссылка = ПолучитьСсылкуПоUID(UID, ПредполагаемыйТип);


Если Ссылка = Неопределено Тогда


// Попробуем другой тип


ПредполагаемыйТип = "Документ.ПоступлениеТоваровУслуг";


Ссылка = ПолучитьСсылкуПоUID(UID, ПредполагаемыйТип);


КонецЕсли;

⚠️ Внимание: Если вы работаете с распределенной базой 1С (РИБ), UID одного и того же объекта может отличаться в разных узлах! В этом случае для получения ссылки нужно использовать механизмы синхронизации, а не прямую конвертацию.

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

Разные конфигурации 1С могут иметь свои особенности работы с UID. Рассмотрим наиболее распространенные случаи:

1. 1С:Бухгалтерия 3.0

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

Запрос = Новый Запрос;

Запрос.Текст =


"ВЫБРАТЬ ПЕРВЫЕ 1


|   УникальныеИдентификаторыОбъектов.Ссылка КАК Ссылка


|ИЗ


|   РегистрСведений.УникальныеИдентификаторыОбъектов КАК УникальныеИдентификаторыОбъектов


|ГДЕ


|   УникальныеИдентификаторыОбъектов.УникальныйИдентификатор = &UID


|   И НЕ УникальныеИдентификаторыОбъектов.ПометкаУдаления";



Запрос.УстановитьПараметр("UID", UID);


Результат = Запрос.Выполнить();

2. 1С:Управление торговлей 11

Здесь UID активно используется для интеграции с сайтами и CRM. Для документов (например, заказов) можно использовать прямой запрос:

UID = "a1b2c3d4-5678-90ef-1234-567890abcdef";

Ссылка = Документы.ЗаказПокупателя.НайтиПоРеквизиту("УникальныйИдентификатор", UID);

3. 1С:ERP Управление предприятием 2

В ERP UID хранится не только в объектах, но и в плановых показателях. Для поиска ссылки по UID здесь лучше использовать комбинированный подход:

// Сначала ищем в регистре

Запрос = Новый Запрос;


Запрос.Текст = "ВЫБРАТЬ Ссылка ИЗ РегистрСведений.УникальныеИдентификаторыОбъектов ГДЕ УникальныйИдентификатор = &UID";


Запрос.УстановитьПараметр("UID", UID);


Результат = Запрос.Выполнить();



// Если не найдено — ищем по метаданным


Если Результат.Пустой() Тогда


Ссылка = НайтиОбъектПоUID(UID); // Используем функцию из Способа 2


Иначе


Ссылка = Результат[0].Ссылка;


КонецЕсли;

Почему в 1С

Зарплата и Управление Персоналом UID может отсутствовать?:

В конфигурациях, ориентированных на кадровый учет (например, 1С:ЗУП 3.1), UID по умолчанию может быть отключен для некоторых объектов (например, физических лиц) из-за особенностей законодательства о защите персональных данных. В этом случае для интеграции рекомендуется использовать внешние идентификаторы (ВнешнийКод) или настраивать обмен через ПланыОбмена.

Автоматизация: как получить ссылки по UID пакетно

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

  1. Принимает на вход таблицу с UID (например, из Excel или JSON)
  2. Для каждого UID определяет тип объекта (если неизвестен — обходит возможные варианты)
  3. Сохраняет результаты в файл или базу данных

Пример кода для пакетной обработки:

Процедура ОбработатьСписокUID(СписокUID)

Результаты = Новый ТаблицаЗначений;


Результаты.Колонки.Добавить("UID");


Результаты.Колонки.Добавить("Ссылка");


Результаты.Колонки.Добавить("ТипОбъекта");


Результаты.Колонки.Добавить("Статус");



Для Каждого СтрокаUID Из СписокUID Цикл


НоваяСтрока = Результаты.Добавить();


НоваяСтрока.UID = СтрокаUID.UID;



Попытка


// Пробуем стандартный метод


Ссылка = ПолучитьСсылкуПоUID(СтрокаUID.UID);


Если Ссылка <> Неопределено Тогда


НоваяСтрока.Ссылка = Ссылка;


НоваяСтрока.ТипОбъекта = Ссылка.Метаданные().Имя;


НоваяСтрока.Статус = "Найдено";


Продолжить;


КонецЕсли;



// Если не найдено — ищем в регистре


Запрос = Новый Запрос;


Запрос.Текст = "ВЫБРАТЬ ПЕРВЫЕ 1 Ссылка ИЗ РегистрСведений.УникальныеИдентификаторыОбъектов ГДЕ УникальныйИдентификатор = &UID";


Запрос.УстановитьПараметр("UID", СтрокаUID.UID);


Результат = Запрос.Выполнить();



Если НЕ Результат.Пустой() Тогда


НоваяСтрока.Ссылка = Результат[0].Ссылка;


НоваяСтрока.ТипОбъекта = НоваяСтрока.Ссылка.Метаданные().Имя;


НоваяСтрока.Статус = "Найдено в регистре";


Иначе


НоваяСтрока.Статус = "Не найдено";


КонецЕсли;


Исключение


НоваяСтрока.Статус = "Ошибка: " + ОписаниеОшибки();


КонецПопытки;


КонецЦикла;



// Сохраняем результаты в файл


ЗаписьJSON = Новый ЗаписьJSON;


ЗаписьJSON.УстановитьСтроку();


ЗаписьJSON.Записать(Новый Структура("Результаты", Результаты));


ТекстJSON = ЗаписьJSON.Закрыть();



ЗаписатьФайл("C:\Temp\РезультатыПоискаUID.json", ТекстJSON);


КонецПроцедуры;

Для ускорения пакетной обработки:

  • 🚀 Используйте транзакции: оберните цикл в НачатьТранзакцию()/ЗафиксироватьТранзакцию(), чтобы уменьшить нагрузку на базу.
  • 📊 Разбивайте на партии: обрабатывайте UID блоками по 100-200 штук, чтобы избежать таймаутов.
  • 🔄 Кэшируйте результаты: если один и тот же UID встречается несколько раз, сохраняйте результат в словарь.

💡

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

FAQ: Частые вопросы по работе с UID в 1С

Можно ли получить UID объекта, если известна только ссылка?

Да, для этого используйте реквизит УникальныйИдентификатор:

Ссылка = Документы.ЗаказПокупателя.НайтиПоНомеру("000000001");

UID = Ссылка.УникальныйИдентификатор;

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

Почему метод ПолучитьСсылкуПоUID() возвращает Неопределено, хотя объект существует?

Вероятные причины:

  1. Объект помечен на удаление (проверьте реквизит ПометкаУдаления).
  2. UID принадлежит другому типу объекта (уточните тип в втором параметре метода).
  3. В конфигурации отключен реквизит УникальныйИдентификатор для этого типа объектов.

Решение: используйте запрос к регистру УникальныеИдентификаторыОбъектов с фильтром по типу объекта.

Как получить ссылку по UID в 1С:Управление нашей фирмой (УНФ)?

В УНФ UID хранится в регистре УникальныеИдентификаторыОбъектов, но для некоторых объектов (например, задач) может потребоваться явное указание типа:

UID = "a1b2c3d4-5678-90ef-1234-567890abcdef";

ТипОбъекта = "Документ.Задача";



// Используем расширенный поиск


Ссылка = ПолучитьСсылкуПоUID(UID, ТипОбъекта, Новый Структура("ДатаСоздания", НачалоДня(ТекущаяДата())));

Можно ли по UID получить ссылку на объект в другой базе 1С?

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

  • 🔄 Планы обмена (если базы синхронизируются)
  • 📤 Внешние идентификаторы (например, ВнешнийКод)
  • 🔗 Web-сервисы (если базы доступны по сети)

Пример запроса через web-сервис:

WSСсылка = WSСсылки.Добавить("http://server/ws/Exchange?wsdl");

WSПрокси = Новый WSПрокси(WSСсылка, "ExchangeService");



Результат = WSПрокси.ПолучитьСсылкуПоUID(UID, ИмяБазы);

Как проверить, существует ли объект с данным UID, не получая ссылку?

Используйте запрос к регистру УникальныеИдентификаторыОбъектов с проверкой на пустоту результата:

Функция ПроверитьСуществованиеUID(UID)

Запрос = Новый Запрос;


Запрос.Текст =


"ВЫБРАТЬ РАЗЛИЧНЫЕ 1 КАК Существует


|ИЗ РегистрСведений.УникальныеИдентификаторыОбъектов


|ГДЕ УникальныйИдентификатор = &UID";



Запрос.УстановитьПараметр("UID", UID);


Результат = Запрос.Выполнить();



Возврат НЕ Результат.Пустой();


КонецФункции;