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