Другое · 7 мин
Как получить имя объекта в 1С
Как получить имя объекта в 1С: разница между именем, синонимом и представлением, способы из метаданных и ссылки, проверка результата и типичные ошибки.
В 1С:Предприятии под «именем объекта» могут понимать разные вещи: идентификатор конфигурационного объекта, пользовательский синоним и представление конкретного экземпляра. Имя используется в программном коде, синоним — для отображения в интерфейсе, а представление — для конкретной записи справочника, документа или другого объекта. Подмена одного значения другим часто приводит к неверным результатам в отчётах и обработках.
Конфигурационное имя задаётся в дереве конфигурации и подчиняется правилам идентификаторов: обычно это набор букв, цифр и нижнего подчёркивания без пробелов. Синоним может содержать пробелы и произвольные символы, поэтому он не подходит для использования в коде как имя метаданных. Представление экземпляра зависит от выбранного реквизита и может меняться, поэтому тоже не является стабильным именем объекта.
Получение имени зависит от того, что именно у вас есть в коде: ссылка на объект, метаданные конфигурации, форма или команда. Ниже рассмотрены основные способы, условия их применения и способы проверить, что получено именно имя, а не синоним или представление.
Что понимать под именем объекта в 1С
У каждого конфигурационного объекта есть свойство Имя, которое используется в языке запросов, в коде модулей и при обращении через дерево метаданных. Это стабильный идентификатор, который не должен меняться в процессе эксплуатации, если не проводится обновление конфигурации.
Синоним предназначен для пользователя и может отличаться от имени. Например, имя справочника может быть Контрагенты, а синоним — Контрагенты и заказчики. Если программа ожидает имя, а получает синоним, обращение к объекту по имени может завершиться ошибкой или вернуть не тот объект.
Получение имени из дерева конфигурации
Если известно, к какому разделу конфигурации относится объект, имя можно получить напрямую через метаданные. Например, для справочника используется обращение к узлу Справочники, для документа — к Документы, для перечисления — к Перечисления. После имени узла указывается имя конкретного объекта и свойство Имя.
Пример обращения может выглядеть как обращение к метаданным справочника и чтение свойства Имя. Этот способ подходит на этапе разработки, когда имя конфигурационного объекта известно заранее. Он не требует наличия экземпляра объекта в базе и работает независимо от того, есть ли в справочнике записи.
Когда этот способ удобен
Подходит для констант, реквизитов форм, команд и других элементов конфигурации, имя которых нужно использовать в коде без привязки к конкретной записи. Не подходит, если в коде есть только ссылка на выбранный пользователем элемент справочника или документа.
- 1Получить ссылку на объект
- 2Вызвать у ссылки метод Метаданные
- 3Обратиться к свойству Имя полученного метаданных
- 4Сравнить результат с ожидаемым именем
Получение имени из ссылки на объект
Когда в коде есть ссылка на экземпляр справочника, документа или другого объекта, имя метаданных можно получить через ссылку. Многие ссылки предоставляют доступ к метаданным, после чего читается свойство Имя. Это позволяет определить, к какому конфигурационному объекту относится выбранная запись.
Альтернативный способ — использовать функцию определения типа значения. Результат часто представляет строку вида «ТипОбъекта.ИмяОбъекта», из которой можно выделить часть после точки. Этот метод требует дополнительной обработки строки и менее надёжен, чем прямой доступ к метаданным, но может пригодиться, когда тип объекта известен только во время выполнения.
Сравнение способов
Подходит, когда известно имя конфигурационного объекта на этапе разработки
Подходит, когда в коде есть только экземпляр справочника или документа
Помогает определить имя по строке типа, но требует дополнительной обработки
Имя формы, команды и реквизита
Имя можно получать не только для справочников и документов, но и для форм, команд, реквизитов и других элементов конфигурации. У формы есть своё имя, которое используется при открытии формы из кода, а у команды — имя, по которому она вызывается. Реквизиты объектов тоже имеют имена, отличающиеся от синонимов, показываемых в списке полей.
При обращении к реквизиту формы или объекта важно не путать имя реквизита с его представлением. Имя используется в программном доступе, а представление может зависеть от языковых настроек и настройки интерфейса.
Проверка результата и ограничения
После получения имени рекомендуется проверить, что значение не пустое и совпадает с ожидаемым именем из дерева конфигурации. Если получено пустое значение, вероятно, обращение выполнено к неверному объекту или метод недоступен в текущем контексте. Если получено значение с пробелами или пользовательским текстом, скорее всего, возвращён синоним или представление, а не имя.
Некоторые способы получения метаданных работают только на сервере или только в тонком клиенте, в зависимости от платформы и типа приложения. Перед использованием в производственной базе убедитесь, что код работает в нужном режиме выполнения. Изменение имён объектов в уже используемой конфигурации может привести к потере связей с данными, поэтому такие правки требуют осторожности.
Безопасная работа с конфигурацией
Перед изменением имён объектов, реквизитов или структуры конфигурации создайте резервную копию информационной базы и конфигурации. Тестируйте изменения на отдельной копии базы, а не в рабочей среде. Переименование конфигурационного объекта может нарушить существующий код, отчёты, обработки и зависимости, которые ссылаются на старое имя.
Если после изменений код перестал компилироваться или отчёты перестали работать, верните конфигурацию из резервной копии и проверьте все места, где использовалось старое имя. Самостоятельные правки допустимы только в пределах вашей компетенции и при наличии резервных копий.
Как проверить результат
Непустая строка, совпадающая с именем в дереве конфигурации
Пустая строка, синоним или представление экземпляра
Альтернативы и границы самостоятельной работы
Если нужно получить имя объекта для отчёта или формы, иногда достаточно использовать представление или синоним, а не программное имя. Выбор зависит от задачи: для вывода пользователю подойдёт синоним, для фильтрации и программной обработки — имя метаданных. Не заменяйте одно другим без понимания последствий.
Если задача включает изменение конфигурации, интеграцию с внешними системами или восстановление после ошибки, привлеките специалиста по 1С. Не вносите структурные изменения в рабочую базу без резервной копии и проверки на тестовой среде.
Что важно запомнить
Имя берется из метаданных, синоним — для интерфейса, представление — для экземпляра; перед изменениями конфигурации делайте резервную копию и тестируйте на копии.
В чем разница между именем и синонимом объекта?
Имя — это идентификатор конфигурационного объекта, используемый в коде и метаданных. Синоним — пользовательская надпись для интерфейса, которая может содержать пробелы и отличаться от имени. Для программного обращения используйте имя, а не синоним.
Как получить имя объекта по ссылке на запись?
Получите метаданные ссылки и прочитайте их свойство Имя. Точный способ зависит от типа объекта и режима выполнения, поэтому перед использованием проверьте результат на непустую строку и соответствие ожидаемому имени из конфигурации.
Можно ли использовать представление объекта вместо его имени?
Представление экземпляра предназначено для отображения конкретной записи и может меняться. Оно не подходит для обращения к конфигурационному объекту в коде. Для таких целей используйте свойство Имя метаданных.
Что делать, если после переименования объекта перестал работать код?
Верните конфигурацию из резервной копии, проверьте все модули, отчёты и обработки, где использовалось старое имя, и исправьте ссылки. Проверяйте изменения на копии базы перед переносом в рабочую среду.