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