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

Другое · 6 мин

Имя объекта в 1C для разработчика: программное имя или синоним

Разбор свойств Имя и Синоним в конфигурации 1C: где использовать программное имя, как не сломать код при переименовании и какие проверки сделать.

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

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

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

Чем отличаются Имя и Синоним для разработчика

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

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

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

Где программное имя используется в коде

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

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

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

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

Переименование объектов и риски для кода

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

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

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

Проверка ссылок перед изменением

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

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

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

Ссылки на объект по программному имени
Норма

Код компилируется и работает после переименования

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

Появляются ошибки компиляции или не найдены объекты

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

Исключения и альтернативы

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

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

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

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

Итог

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

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

Можно ли использовать синоним вместо имени в запросе?

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

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

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

Влияет ли изменение синонима на существующие данные?

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

Нужно ли переименовывать объект, если не нравится его название в интерфейсе?

Не обязательно. Часто достаточно изменить Синоним, оставив программное имя без изменений. Переименование по Имени оправдано только при необходимости привести метаданные в соответствие с принятыми правилами именования.