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

Другое · 6 мин

Синоним в 1C: что это, зачем нужен и как менять

Разбираем, что такое синоним объекта конфигурации в 1C, чем он отличается от имени объекта, где отображается и как безопасно менять без риска для конфигурации.

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

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

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

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

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

Что представляет собой синоним объекта конфигурации

Каждый элемент метаданных в конфигурации 1C обладает набором свойств, одним из которых является синоним. Это строка, предназначенная для показа человеку, а не для использования в запросах или вычислениях.

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

Отличие имени от синонима

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

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

Где пользователь видит синоним

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

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

Списки и формы

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

Порядок действий
  1. 1
    Откройте конфигурацию в режиме разработчика
  2. 2
    Найдите нужный объект метаданных в дереве конфигурации
  3. 3
    Откройте свойства объекта и отредактируйте поле синонима
  4. 4
    Сохраните изменения и обновите конфигурацию
  5. 5
    Проверьте отображение в интерфейсе

Отчёты и конструктор запросов

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

Когда менять синоним, а когда лучше оставить

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

Не стоит менять синоним только ради косметического обновления, если пользователи уже привыкли к текущему названию. Частые переименования могут сбить с толку и привести к ошибкам в работе с документами.

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

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

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

Отображение в списке объектов
Норма

Показывается новый синоним

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

Отображается старое имя или пустое поле

Работа в форме объекта
Норма

Открывается и сохраняется без ошибок

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

Ошибка при открытии или сохранении

Выполнение отчёта
Норма

Отчёт формируется корректно

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

Отчёт не находит объект или выдаёт ошибку

Как посмотреть и изменить синоним безопасно

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

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

Типичные ошибки
01
Использование синонима вместо программного имени в коде и запросах
02
Массовое переименование синонимов без проверки отчётов и форм

Типичные ошибки и ограничения

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

Другая ошибка — изменять синонимы массово без проверки влияния на отчёты и печатные формы. Некоторые шаблоны могут жестко завязываться на отображаемые названия.

Итог

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

Синоним в 1C — это отображаемое имя объекта для пользователя, оно не заменяет программное имя и не ломает ссылки в коде при корректном изменении.

Часто задаваемые вопросы

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

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

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

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

Что будет, если оставить синоним пустым?

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

Нужно ли обновлять базу после смены синонима?

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