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