Синоним в 1С:Предприятие: что это и как работает

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

Простой пример: объект метаданных называется ПоступлениеТоваровУслуг, а его синоним — «Поступление товаров и услуг». Разработчик обращается к объекту по имени, пользователь видит синоним. Благодаря этому разделению можно переименовывать отображаемые названия без переписывания программного кода.

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

Где задаётся синоним объекта

Синоним устанавливается в конфигураторе через палитру свойств. Чтобы открыть её, нужно выделить объект метаданных в дереве конфигурации, нажать правую кнопку мыши и выбрать пункт «Свойства» (или воспользоваться сочетанием клавиш Alt+Enter). В открывшейся палитре среди первых строк будут два поля: «Имя» и «Синоним».

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

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

Чем синоним отличается от имени, представления и заголовка

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

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

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

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

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

Как получить синоним программно

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

СинонимСправочника = Метаданные.Справочники.Номенклатура.Синоним;
// Результат: "Номенклатура"

СинонимРеквизита = Метаданные.Документы.РеализацияТоваровУслуг.Реквизиты.Контрагент.Синоним;
// Результат: "Контрагент"

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

Сообщить(Метаданные.Документы.ПриходныйОрдер.Синоним);

Мультиязычность и синонимы

Платформа 1С поддерживает несколько языков интерфейса. Если в конфигурации настроено более одного языка (свойство «Языки» в корне конфигурации), то синоним можно задать отдельно для каждого языка. В палитре свойств рядом с полем «Синоним» появляется кнопка с изображением лупы, открывающая окно ввода значений на разных языках.

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

Когда и как правильно менять синоним

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

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

Как проверить результат после изменения

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

Если название не изменилось, чаще всего причина в том, что конфигурация базы данных не была обновлена, либо пользователь смотрит на представление, формируемое другим свойством (например, «Представление списка» или заголовок, заданный в форме программно). В управляемых формах заголовок можно переопределить в коде, и тогда синоним метаданных отображаться не будет.

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