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

Другое · 7 мин

Как получить идентификатор объекта метаданных в 1С

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

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

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

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

Чем отличается идентификатор метаданных от кода и ссылки

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

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

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

Где посмотреть идентификатор в Конфигураторе

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

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

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

Как получить идентификатор в коде 1С

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

Примерная логика в коде на языке 1С: обратиться к Метаданные.Объекты[ИмяОбъекта] и получить свойство, если оно существует. Результат обычно представляет собой строку или специальное значение, которое можно вывести в сообщение, журнал регистрации или использовать в условии.

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

1c
Метаданные.Объекты[ИмяОбъекта].УникальныйИдентификатор

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

Когда идентификатор можно использовать, а когда нельзя

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

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

Типичные ошибки
01
Путают идентификатор метаданных со ссылкой на запись справочника или документа
02
Сохраняют идентификатор как постоянный ключ без учёта обновления конфигурации
03
Пытаются получить идентификатор через внешний интерфейс, который не поддерживает доступ к метаданным

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

Проверка результата и частые ошибки

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

Контрольные точки

Как проверить результат

Значение идентификатора
Норма

Не пустое и совпадает со свойствами объекта в Конфигураторе

Тревожный признак

Пустое, меняется без причины или не соответствует имени объекта

Повторный запрос
Норма

Возвращает тот же результат в одной конфигурации

Тревожный признак

Разные значения для одного и того же объекта

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

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

Итог

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

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

Часто задаваемые вопросы

Можно ли использовать идентификатор метаданных вместо кода справочника?

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

Работает ли один способ получения идентификатора во всех версиях 1С?

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

Безопасно ли показывать идентификатор метаданных пользователям?

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

Что делать, если свойство идентификатора не найдено?

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