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