Синонимы в 1С: что это, как создать и использовать в конфигураторе

В системе 1С:Предприятие термин «синоним» часто вызывает вопросы у начинающих разработчиков и пользователей. Это неудивительно: в отличие от привычных справочников или документов, синонимы не имеют отдельного интерфейса, но при этом активно используются в конфигураторе, запросах и даже в типовых решениях. Если вы когда-нибудь видели в коде конструкцию вида Синоним.ИмяОбъекта или сталкивались с ошибкой «Не найден синоним», эта статья поможет разобраться в сути явления.

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

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

Что такое синоним в 1С: определение и отличие от псевдонима

В 1С:Предприятие 8 синоним — это альтернативное имя объекта метаданных, которое можно использовать вместо его полного имени в коде, запросах или при обращении через встроенный язык. Например, для справочника Справочник.Контрагенты можно задать синоним Партнёры, и затем обращаться к нему через это короткое имя.

Важно не путать синонимы с псевдонимами (алиасами), которые используются в запросах SQL или в языке 1С для временного переименования полей. Основные отличия:

🔹 Синоним — постоянное альтернативное имя объекта метаданных, задаётся в конфигураторе и действует глобально во всей базе.
🔹 Псевдоним — временное имя, используемое только в рамках одного запроса или процедуры (например, ВЫБРАТЬ Товар КАК Т).
🔹 Синонимы влияют на ПолноеИмя() объекта, псевдонимы — нет.

Синонимы особенно полезны в следующих случаях:

📌 При миграции данных между базами с разной структурой (например, при переходе с 1С:УТ 10.3 на 1С:ERP 2.5).
📌 Для совместимости с внешними обработками или отчётами, написанными под старые версии конфигурации.
📌 Когда нужно сократить код без потери читаемости (например, вместо Документ.РеализацияТоваровУслуг использовать Реализация).

⚠️ Внимание: Синонимы не заменяют оригинальные имена объектов — они лишь добавляют альтернативные варианты обращения. Удаление объекта из метаданных автоматически удаляет и все его синонимы.

Где и как хранятся синонимы в конфигурации 1С

Синонимы не являются самостоятельными объектами метаданных — они привязаны к конкретным справочникам, документам, регистрам и другим сущностям. Их можно просматривать и редактировать только через Конфигуратор в режиме 1С:Предприятие (не путать с режимом Отладка!).

Чтобы найти синонимы для объекта:

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

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

Тип объекта	Пример синонима	Где применяется
Справочник	`Товары` для `Справочник.Номенклатура`	В модулях, запросах, внешних отчётах
Документ	`Поступление` для `Документ.ПоступлениеТоваровУслуг`	При создании документов через код
Регистр сведений	`ЦеныНоменклатуры` для `РегистрСведений.ЦеныНоменклатуры`	В запросах к регистрам
Перечисление	`СтатусыЗаказов` для `Перечисление.СтатусыДокументовЗаказПокупателя`	При работе со значениями перечислений

Как создать и редактировать синонимы: пошаговая инструкция

Добавление синонима — простая процедура, но требует прав на изменение конфигурации. Рассмотрим процесс на примере справочника Контрагенты.

Открыть конфигуратор в режиме редактирования|

Найти объект в дереве метаданных|

В палитре свойств найти поле "Синонимы"|

Нажать кнопку "..." и добавить новое имя|

Сохранить конфигурацию (F7)-->

Шаг 1. Откройте конфигуратор и найдите нужный объект. Например, для справочника Контрагенты путь будет: Справочники → Контрагенты.

Шаг 2. В палитре свойств (обычно справа) найдите строку Синонимы. Если её нет, убедитесь, что объект поддерживает синонимы (не все типы объектов их имеют).

Шаг 3. Нажмите на многоточие (...) рядом с полем Синонимы. Откроется окно со списком текущих синонимов. Добавьте новое имя, например, Партнёры.

Шаг 4. Сохраните конфигурацию (F7) и обновите базу данных (Ctrl+F7), если требуется.

Теперь в коде можно использовать оба варианта обращения:

// Старый способ СпрКонтрагенты = Справочники.Контрагенты; // Через синоним

СпрПартнёры = Партнёры; // Коротко и понятно!

⚠️ Внимание: Изменение синонимов в работающей базе может привести к ошибкам в существующем коде, если он полагается на старые имена. Всегда тестируйте изменения на копии базы!

Практические примеры использования синонимов в коде

Синонимы наиболее полезны в трёх сценариях: упрощение кода, обеспечение совместимости и работа с внешними обработками. Рассмотрим каждый случай с примерами.

1. Упрощение обращений в модулях

Длинные имена объектов ухудшают читаемость кода. Синонимы решают эту проблему:

| Товары КАК Товары";

2. Совместимость при обновлении конфигураций

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

// Старая обработка ожидает справочник "Клиенты" Если НЕ ЗначениеЗаполнено(Справочники.Клиенты) Тогда // Ошибка! Но если задан синоним "Клиенты" для "Контрагенты", код сработает

КонецЕсли;

3. Работа с внешними отчётами

Внешние отчёты часто пишутся под конкретные имена объектов. Синонимы позволяют адаптировать их под разные базы без изменения исходного кода отчёта.

💡

Если вы разрабатываете универсальную обработку для нескольких конфигураций, заведите синонимы для ключевых объектов (например, Товары, Заказы, Склады) и используйте их в коде. Это упростит адаптацию под разные версии 1С.

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

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

1. Ошибка «Не найден синоним»

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

🔴 Синоним не был сохранён в конфигурации (забыли нажать F7).
🔴 Объект, для которого задан синоним, был удалён или переименован.
🔴 Опечатка в имени синонима (регистр имеет значение!).

Решение: проверьте наличие синонима в конфигураторе и правильность его написания в коде.

2. Конфликт имён

Если два объекта имеют одинаковые синонимы, 1С не сможет однозначно определить, к какому из них идёт обращение. Например:

// Ошибка: неясно, к какому справочнику относится синоним "Объекты" Справочники.Номенклатура.Синонимы.Добавить("Объекты");

Справочники.Контрагенты.Синонимы.Добавить("Объекты"); // Конфликт!

Решение: используйте уникальные синонимы или уточняйте контекст через полное имя.

3. Синонимы не работают в запросах

В языке запросов 1С синонимы объектов метаданных не поддерживаются напрямую. Например, этот код вызовет ошибку:

// НЕРАБОТАЕТ!

Запрос.Текст = "ВЫБРАТЬ Товары.Наименование ИЗ Товары";

Решение: используйте полные имена объектов в запросах или создавайте псевдонимы (алиасы) прямо в тексте запроса:

// Правильно:

Запрос.Текст = "ВЫБРАТЬ Номенклатура.Наименование ИЗ Справочник.Номенклатура КАК Номенклатура";

⚠️ Внимание: В некоторых версиях платформы (до 8.3.10) синонимы могли некорректно обрабатываться в динамических вызовах методов (например, через Выполнить()). Всегда тестируйте такой код на целевой версии!

Синонимы vs. Полные имена: когда что использовать

Хотя синонимы упрощают код, их не всегда стоит применять. Вот критерии выбора:

Критерий	Полное имя	Синоним
Читаемость кода	❌ Длинные конструкции (`Справочник.Номенклатура`)	✅ Короткие имена (`Товары`)
Совместимость	✅ Всегда работает, независимо от конфигурации	❌ Может сломаться при обновлении
Производительность	✅ Нет накладных расходов на разрешение имён	✅ Разница минимальна, но есть
Поддержка в запросах	✅ Работает всегда	❌ Не поддерживается

Рекомендации по использованию:

🛠 В внутренних модулях конфигурации (например, в обработках событий документов) можно активно использовать синонимы — это упрощает поддержку.
📄 В внешних отчётах и обработках лучше придерживаться полных имён, чтобы избежать проблем при переносе между базами.
🔄 При обмене данными (например, через Универсальный формат обмена) синонимы могут помочь сопоставить объекты с разными именами в разных базах.
🔍 В отладочном коде (например, в временных скриптах) синонимы ускоряют написание, но не забывайте возвращаться к полным именам в финальной версии.

💡

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

Синонимы в типовых конфигурациях: примеры из 1С:ERP и УТ 11

В типовых решениях фирмы 1С синонимы используются ограниченно, но есть несколько заметных примеров. Рассмотрим их на базе 1С:ERP Управление предприятием 2.5 и 1С:Управление торговлей 11.

1. Синонимы в 1С:ERP 2.5

В ERP синонимы часто применяются для:

📦 Справочника Номенклатура — может иметь синоним Товары или Продукция в некоторых отчётах.
📄 Документа ЗаказПокупателя — иногда используется синоним Заказ для упрощения кода в модулях.
📊 Регистра ТоварыНаСкладах — в запросах к остаткам может фигурировать как ОстаткиТоваров.

2. Синонимы в 1С:УТ 11

В Управлении торговлей синонимы встречаются реже, но есть ключевые примеры:

🏢 Справочник Контрагенты — в старых версиях мог иметь синоним Клиенты или Поставщики (в зависимости от контекста).
📦 Справочник ХарактеристикиНоменклатуры — иногда сокращается до Характеристики.

В новых версиях типовых конфигураций (1С:ERP 2.5.10+, 1С:УТ 11.5+) синонимы используются реже, так как фирма 1С стремится к унификации имён объектов. Однако они по-прежнему актуальны для:

🔄 Обмена данными между разными конфигурациями (например, 1С:Бухгалтерия и 1С:ЗУП).
📂 Работы с внешними обработками, написанными под старые версии.

Как найти все синонимы в типовой конфигурации?

Чтобы увидеть все синонимы в типовой базе, откройте конфигуратор, выделите корневой узел "Конфигурация" и воспользуйтесь поиском по свойствам (Ctrl+F). В поле поиска введите "Синонимы" и нажмите "Найти всё". Система покажет все объекты, у которых заданы альтернативные имена. Обратите внимание, что в некоторых типовых решениях (например, в 1С:БП 3.0) синонимы почти не используются, а в других (например, в 1С:УТ 10.3) их может быть несколько десятков.

FAQ: Частые вопросы о синонимах в 1С

Можно ли создать синоним для объекта, которого нет в конфигурации?

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

Как узнать, какие синонимы используются в текущей базе?

Есть два способа:

Через конфигуратор: откройте каждый объект в дереве метаданных и проверьте свойство Синонимы.

Через код: выполните этот скрипт в отладчике:

Для Каждого Объект Из Метаданные.Объекты Цикл
Если Объект.Синонимы.Количество() > 0 Тогда
Сообщить(Объект.Имя + " имеет синонимы: " + Объект.Синонимы.ПолучитьСтрокуЧерезЗапятую());
КонецЕсли;
КонецЦикла;

Могут ли синонимы конфликтовать с именами переменных в коде?

Да, это возможная проблема. Например, если у вас есть синоним Товары для справочника и переменная с таким же именем, 1С может неправильно интерпретировать обращение. Чтобы избежать конфликтов:

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

Как синонимы влияют на производительность?

Влияние минимально, так как синонимы разрешются на этапе компиляции кода, а не во время выполнения. Однако:

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

На практике разница неощутима, если не злоупотреблять синонимами (например, не создавать по 10 альтернативных имён для одного объекта).

Можно ли экспортировать/импортировать синонимы отдельно от объектов?

Нет, синонимы являются частью метаданных объекта и экспортируются только вместе с ним. Если вам нужно перенести синонимы между базами:

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

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