Что такое синоним в 1С и как с ним работать

Синоним — одно из базовых свойств любого объекта метаданных в 1С: справочника, документа, регистра, реквизита, отчёта и даже самой конфигурации. Если имя объекта — это технический идентификатор, который используется в коде и запросах, то синоним — это «человеческое» название, которое видит пользователь в меню, в заголовках форм, в списках документов и в отчётах.

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

Ниже разберём, где именно задаётся синоним, как он влияет на интерфейс и код, какие правила его заполнения считаются хорошей практикой и какие ошибки встречаются чаще всего.

Что такое синоним и чем он отличается от имени

У каждого объекта метаданных в конфигураторе 1С есть как минимум два ключевых свойства: Имя и Синоним. Имя — технический идентификатор: оно пишется без пробелов, начинается с буквы, используется во встроенном языке (Документы.РеализацияТоваров) и в запросах. Менять имя после того, как на объект завязан код, — рискованно и трудоёмко.

Синоним — свободное текстовое представление. Он может содержать пробелы, знаки препинания, цифры и буквы любого регистра: «Реализация товаров и услуг», «Склад (основной)», «Остатки по партиям». Именно синоним платформа показывает пользователю в заголовках форм, списках выбора, панелях разделов и полях ввода.

Важно понимать: синоним существует не только у «крупных» объектов. Он есть у реквизитов, табличных частей, измерений и ресурсов регистров, команд, ролей, подсистем, общих модулей и даже у предопределённых элементов. Фактически любой элемент конфигурации, который может «показаться» пользователю, имеет синоним.

Где задаётся синоним в конфигураторе

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

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

Если синоним не заполнен, платформа в большинстве случаев подставляет вместо него имя объекта, автоматически разбивая его по заглавным буквам: имя РеализацияТоваров превратится в «Реализация товаров». Однако автоматическая подстановка не всегда удачна — аббревиатуры и сложные составные имена часто превращаются в нечитаемые надписи.

Для реквизитов форм и элементов управления синоним может переопределяться дополнительно: у элемента формы есть свойство «Заголовок», которое имеет приоритет над синонимом реквизита. Это позволяет в одной форме назвать поле «Склад-отправитель», а в другой — просто «Склад».

Как синоним влияет на интерфейс и поиск

Синоним напрямую формирует то, что видит пользователь. Он выводится в заголовках окон и форм, в списках выбора при подборе значений, в названиях команд и кнопок, в шапках отчётов, построенных на СКД, и в подсказках при вводе по строке.

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

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

Синоним в коде: представления и методы

Хотя синоним не используется для обращения к объектам в коде, получить его программно можно и иногда нужно — например, при формировании сообщений пользователю или заголовков произвольных отчётов. Для этого служит объект Метаданные и свойство Синоним (или метод Представление()).

СинонимДокумента = Метаданные.Документы.РеализацияТоваров.Синоним;
// или универсально:
Представление = Метаданные.НайтиПоТипу(ТипЗнч(Ссылка)).Представление();

Метод Представление() предпочтительнее прямого обращения к свойству: он корректно работает с многоязычными конфигурациями и возвращает синоним для текущего языка сеанса. Прямое чтение свойства Синоним вернёт значение для основного языка конфигурации.

Обратная ситуация — поиск объекта по синониму — штатно не поддерживается: метаданные ищутся по имени. Если в коде встречается сравнение строк с синонимом, это признак хрупкого решения: любое переименование синонима «сломает» логику, и платформа об этом не предупредит.

Правила хорошего синонима

Хороший синоним отвечает на вопрос пользователя «что это такое?» на языке его предметной области. Документ для кладовщика должен называться так, как эта операция называется на складе, а не так, как её назвал разработчик.

Практические рекомендации сводятся к нескольким пунктам:

• Используйте существительные или короткие словосочетания: «Поступление товаров», «Остатки на складах».
• Не дублируйте тип объекта в синониме: «Справочник Контрагенты» избыточен, достаточно «Контрагенты».
• Сохраняйте единый стиль: если документы названы от существительного («Поступление», «Реализация»), не добавляйте рядом «Оформить продажу».
• Избегайте аббревиатур, понятных только разработчику: «РС СвЦенНом» вместо «Свободные цены номенклатуры».
• Проверяйте длину: слишком длинный синоним обрезается в панелях разделов и заголовках колонок.

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

Изменение синонима — безопасная операция с точки зрения кода: запросы, обращения через имя и структура данных не пострадают. Переименование синонима документа не требует реструктуризации и не затрагивает хранимые данные.

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

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

FAQ