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

Другое · 7 мин

Как получить имя объекта в 1С

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

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

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

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

Что понимать под именем объекта в 1С

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

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

Получение имени из дерева конфигурации

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

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

Когда этот способ удобен

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

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

Получение имени из ссылки на объект

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

Альтернативный способ — использовать функцию определения типа значения. Результат часто представляет строку вида «ТипОбъекта.ИмяОбъекта», из которой можно выделить часть после точки. Этот метод требует дополнительной обработки строки и менее надёжен, чем прямой доступ к метаданным, но может пригодиться, когда тип объекта известен только во время выполнения.

Сравнение способов

Через дерево метаданных

Подходит, когда известно имя конфигурационного объекта на этапе разработки

Через ссылку на объект

Подходит, когда в коде есть только экземпляр справочника или документа

Через тип значения

Помогает определить имя по строке типа, но требует дополнительной обработки

Имя формы, команды и реквизита

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

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

Проверка результата и ограничения

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

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

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

Безопасная работа с конфигурацией

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

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

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

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

Полученное значение
Норма

Непустая строка, совпадающая с именем в дереве конфигурации

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

Пустая строка, синоним или представление экземпляра

Альтернативы и границы самостоятельной работы

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

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

Итог

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

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

В чем разница между именем и синонимом объекта?

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

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

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

Можно ли использовать представление объекта вместо его имени?

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

Что делать, если после переименования объекта перестал работать код?

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