Как посмотреть УИД объекта в 1С 8.3

Работа с платформой 1С:Предприятие 8.3 часто требует глубокого понимания внутренней структуры метаданных. Одной из самых важных характеристик любого объекта конфигурации является его Уникальный Идентификатор, или сокращенно УИД (UUID). Этот параметр служит цифровым отпечатком элемента, позволяя системе однозначно различать объекты даже при совпадении их имен.

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

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

Зачем нужен УИД и где он применяется

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

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

⚠️ Внимание: Никогда не пытайтесь вручную подменить УИД объекта в файлах конфигурации (xml) без веских причин. Это может привести к потере истории изменений, невозможности корректного обновления и конфликтам при слиянии веток разработки.

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

Просмотр УИД в режиме Конфигуратора

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

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

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

Значение в этом поле и есть искомый УИД. Он имеет стандартный формат UUID, например: 95284278-0f63-47f9-b21c-957428372165. Вы можете скопировать его, выделив мышью и нажав Ctrl+C, чтобы использовать в дальнейшем.

Использование встроенной обработки "Идентификаторы объектов"

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

В таком случае можно воспользоваться специальными обработками. Существует множество внешних обработок, написанных сообществом, которые выводят список всех объектов метаданных с их УИДами. Однако, если у вас есть права администратора, можно использовать штатные возможности отладки.

• 🔍 Запустите режим отладки в конфигураторе.
• 💻 Напишите простой код в модуле формы или внешнем обработчике.
• 📋 Выведите результат в окно сообщений или консоль.

Пример кода для получения УИД конкретного объекта метаданных:

Метаданные = Метаданные.Справочники.Номенклатура;
Сообщить(Метаданные.Ссылка);

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

Получение УИД через консольную утилиту chdbfl

Для системных администраторов и разработчиков, работающих с файловыми базами или нуждающихся в автоматизации процессов, отличным инструментом является консольная утилита chdbfl.exe. Она поставляется в дистрибутиве платформы 1С:Предприятие.

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

Команда для выгрузки конфигурации выглядит следующим образом:

chdbfl.exe C:\Base\1Cv8.1CD /DumpConfig C:\ConfigDump

После выполнения команды в папке C:\ConfigDump появится структура файлов. Изучив содержимое файлов расширением .xml или служебных файлов .txt внутри папок объектов, можно найти строку вида UUID = {..}.

⚠️ Внимание: Утилита chdbfl работает только с файловыми базами данных. Для клиент-серверного варианта (SQL) этот метод неприменим напрямую, сначала потребуется выгрузить конфигурацию из базы в файл.

Использование консольных утилит позволяет встроить проверку УИДов в скрипты непрерывной интеграции (CI/CD), автоматически сравнивая версии конфигураций перед деплоем на продуктивный сервер.

Анализ УИД в таблицах базы данных SQL

Если вы работаете с клиент-серверным вариантом базы данных на основе PostgreSQL, MS SQL Server или Oracle, информация об УИД объектов метаданных хранится в системных таблицах самой СУБД. Это самый мощный метод, не требующий запуска платформы 1С.

В зависимости от используемой СУБД, структура таблиц может отличаться, но логика остается единой. В таблицах, хранящих описание конфигурации (обычно это таблицы с префиксом _v8 или специфичные системные таблицы), есть поля, содержащие бинарное или строковое представление UUID.

Рассмотрим пример для наиболее популярной связки 1С + PostgreSQL. Информация о объектах метаданных хранится в таблице _v8mdlog или аналогичных служебных таблицах, в зависимости от версии платформы.

СУБД	Системная таблица	Тип данных UUID	Особенности
PostgreSQL	_v8mdlog / _users	uuid / bytea	Хранится в нативном формате
MS SQL Server	_v8mdlog	uniqueidentifier	Требует конвертации при чтении
Oracle	_v8mdlog	RAW(16)	Бинарное представление

Для извлечения данных необходимо выполнить SQL-запрос. Любые операции UPDATE или DELETE могут необратимо повредить базу.

Пример SQL запроса для PostgreSQL

SELECT name, uuid FROM _v8mdlog WHERE name LIKE '%Номенклатура%'; Этот запрос покажет имя объекта и его уникальный идентификатор в текстовом виде.

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

Определение УИД через панель администрирования кластера

В клиент-серверном варианте работы 1С существует еще один уровень абстракции — кластер серверов. Панель администрирования кластера (ras) позволяет управлять информационными базами, сеансами и пользователями.

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

Чтобы посмотреть УИД самой информационной базы (а не объекта внутри нее), можно воспользоваться командной строкой утилиты rmngr или ras. Команда cluster info выведет список всех баз с их параметрами, включая ClusterID и InfobaseID.

ras cluster list --cluster=hostname:port

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

Частые ошибки и проблемы при работе с идентификаторами

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

Еще одна проблема связана с кодировкой и форматом представления. В разных контекстах (SQL, 1С код, XML) UUID может представляться по-разному: с дефисами, без дефисов, в верхнем или нижнем регистре, в виде байтового массива. Неправильная конвертация приводит к тому, что система не находит объект.

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

Также стоит помнить о различии между УИД объекта метаданных и УИД элемента данных. УИД справочника "Номенклатура" (как структуры) постоянен, а УИД конкретной позиции "Кирпич красный" (как записи в таблице) генерируется при создании и уникален для этой записи.

Можно ли изменить УИД объекта в 1С?

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

Где хранится УИД элемента справочника?

УИД конкретного элемента справочника (записи) хранится в таблице базы данных, соответствующей этому справочнику. Обычно это поле с именем _idrref или аналогичным, имеющее тип уникальный идентификатор. В коде 1С это свойство доступно как Ссылка.УникальныйИдентификатор.

Зачем знать УИД при обновлении типовой конфигурации?

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

Как найти объект по УИД, если я не знаю его имя?

В режиме конфигуратора нет прямого поиска "по УИД". Однако можно выгрузить конфигурацию в файлы и воспользоваться поиском по файлам (например, в Notepad++ или Total Commander), найдя строку с нужным UUID. Имя файла или папки укажет на имя объекта метаданных.

Отличается ли УИД в файловой и SQL базе для одного объекта?

Нет, УИД объекта метаданных является свойством самой конфигурации и не зависит от типа хранилища данных. Один и тот же файл конфигурации (.cf), загруженный в файловую базу или в SQL базу, будет содержать объекты с идентичными УИД.