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