Новое название объекта без правки типовой: синонимы, заголовки форм и команд в расширении

· 9 мин

Содержание

Синоним в расширении 1С меняют в Конфигураторе: Конфигурация → Расширения конфигурации, откройте нужное расширение, выделите объект в дереве и исправьте свойство «Синоним» в палитре свойств (Alt+Enter). Затем выполните Обновить конфигурацию базы данных для расширения и перезапустите сеанс 1С:Предприятия. Для собственных объектов расширения поле редактируется свободно. У заимствованных объектов название, которое видит пользователь, надёжнее менять там, где оно выводится: в заголовках формы, её элементов и команд.

Такой подход позволяет переименовать объект метаданных «для глаз пользователя», не снимая типовую конфигурацию с поддержки. Основная конфигурация остаётся нетронутой, и очередное обновление не затрёт ваши названия. Всё описанное относится к платформе 8.3 (расширения появились в версии 8.3.6) и не зависит от конкретной конфигурации: БП 3.0, ЗУП 3.1 и УТ 11 работают одинаково.

Как устроены названия в расширении: имя, синоним и заимствование

У каждого объекта метаданных три «названия», и путать их нельзя:

  • 🔤 Имя — идентификатор для кода (ПоступлениеТоваровУслуг). Его видит только программист.
  • 🏷️ Синоним — то, что видит пользователь в меню, заголовках, списках. Может быть на нескольких языках.
  • 📋 Представления — «Представление объекта», «Представление списка», «Расширенное представление» у справочников, документов и регистров. Если они заполнены, в заголовках форм платформа показывает их, а не синоним.

В расширении объекты бывают двух видов.

Вид объектаОткуда берётсяЧто можно менять
СобственныйСоздан в расширении, имя с префиксом (например, Расш1_)Все свойства, включая синоним и представления
ЗаимствованныйДобавлен из основной конфигурации командой «Добавить в расширение»Ограниченный набор свойств; формы, модули и командный интерфейс — дорабатываются

Заимствованный объект — это ссылка на объект основной конфигурации. Его имя менять нельзя: по имени платформа сопоставляет объект расширения с объектом типовой. Большинство свойств наследуется. Недоступные для изменения поля палитра показывает серыми.

Прежде чем что-то делать, решите, где именно пользователь должен увидеть новое название. Пункт в разделе меню, заголовок списка, подпись поля на форме и колонка отчёта — это четыре разных места, и меняются они по-разному.

Подготовка: доступ, копия и открытие расширения

Что нужно до начала работы:

  1. 🔑 Права администратора в информационной базе и вход в Конфигуратор.
  2. 💾 Свежая выгрузка расширения в файл .cfe. Делается в окне расширения: Конфигурация → Сохранить в файл. Если что-то пойдёт не так, вы вернётесь к рабочей версии за минуту.
  3. 🧪 По возможности — копия базы для проверки. Изменения в расширении обычно безопасны, но проверять их лучше не на рабочих пользователях.

Как открыть расширение:

  1. Запустите Конфигуратор.
  2. Если основная конфигурация ещё не открыта, откройте её: Конфигурация → Открыть конфигурацию.
  3. Выберите Конфигурация → Расширения конфигурации. Появится список расширений базы.
  4. Выделите нужное и откройте его дерево двойным щелчком или через командную панель списка.

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

Расширение, установленное через режим 1С:Предприятия (из файла .cfe), тоже видно в Конфигураторе. Но если его потом снова загрузят из старого файла, ваши правки пропадут. Договоритесь, где хранится актуальная версия.

Как изменить синоним объекта в расширении

Синоним собственного объекта

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

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

Синонимы стандартных реквизитов («Код», «Наименование», «Владелец») правят отдельно: в свойствах объекта найдите «Стандартные реквизиты» и откройте их список.

Синоним заимствованного объекта

Здесь задача обычно такая: в типовой документ называется «Поступление (акты, накладные, УПД)», а бухгалтеры хотят видеть короче.

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

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

Синоним самого расширения

Иногда меняют не синоним объекта, а название расширения в списке. Оно задаётся в свойствах корня дерева расширения:

  • Имя — менять у работающего расширения не стоит: по нему расширение идентифицируется в базе, на него могут опираться обработки и регламентные процедуры.
  • Синоним — можно менять свободно. Именно его видит администратор в списке Администрирование → Печатные формы, отчеты и обработки → Расширения (БП 3.0, ЗУП 3.1, УТ 11).
  • Версия — заодно увеличьте её, чтобы потом понимать, какая сборка установлена.

Переименование реквизитов и подписей на формах

Подпись поля на форме не всегда совпадает с синонимом реквизита. Если у элемента формы заполнено свойство «Заголовок», выводится оно. Если пусто — берётся синоним реквизита. Поэтому иногда достаточно поправить только форму.

Через редактор заимствованной формы

  1. В дереве основной конфигурации раскройте объект, ветку «Формы».
  2. На нужной форме — «Добавить в расширение».
  3. Откройте заимствованную форму в расширении. В дереве элементов выделите поле, группу или кнопку.
  4. В палитре свойств элемента заполните «Заголовок» новым текстом.
  5. Для заголовка всего окна выделите корень дерева «Форма» и заполните его свойство «Заголовок».

Так же переименовывают колонки динамического списка в форме списка: у каждой колонки свой элемент и своё свойство «Заголовок».

Программно, если форма собирается кодом

Многие формы типовых конфигураций достраивают элементы в модуле при создании. Тогда изменение в редакторе не поможет — элемента в дереве просто нет, или код перезаписывает заголовок. Решение — дописать обработчик в модуле заимствованной формы, который отработает после типового:

&НаСервере
&После("ПриСозданииНаСервере")
Процедура Расш1_ПриСозданииНаСервереПосле(Отказ, СтандартнаяОбработка)

    Заголовок = "Поступление от поставщика";

    Элемент = Элементы.Найти("Контрагент");
    Если Элемент <> Неопределено Тогда
        Элемент.Заголовок = "Поставщик";
    КонецЕсли;

КонецПроцедуры

Пояснения к примеру:

  • 🧩 Аннотация &После работает, только если в модуле основной формы есть процедура ПриСозданииНаСервере. Посмотрите её точное имя в модуле типовой формы.
  • 🔍 Элементы.Найти вместо Элементы.Контрагент защищает от ошибки, если после обновления типовой элемент переименуют или удалят.
  • 🏷️ Имя элемента смотрите в дереве элементов формы, а не в списке реквизитов: они могут отличаться.

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

Команды, разделы и командный интерфейс

Пункт меню в разделе — это не синоним объекта как таковой, а представление команды. Варианты:

  1. Команда собственного объекта. Меняется вместе с синонимом объекта или через свойство «Представление» у команды.
  2. Своя общая команда или команда формы. Создаётся в расширении, ей задаются «Синоним» и «Представление». Удобно, когда нужно добавить в раздел пункт с понятным названием, который открывает типовую форму.
  3. Кнопка на форме. Заимствуйте форму, выделите кнопку и заполните ей «Заголовок» — как у полей.
  4. Командный интерфейс подсистемы. Заимствуйте подсистему (раздел), откройте её командный интерфейс в расширении и скройте, переставьте или добавьте команды. Так можно спрятать типовой пункт и показать вместо него свою команду с новым названием.
Что видит пользовательГде меняется в расширении
Заголовок окна формы«Заголовок» корня заимствованной формы или код &После
Подпись поля, колонка списка«Заголовок» элемента формы
Кнопка на форме«Заголовок» кнопки или представление команды формы
Пункт в разделе менюКомандный интерфейс заимствованной подсистемы, своя команда
Название разделаСиноним подсистемы — если поле доступно; иначе своя подсистема

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

После правки обязательно примените расширение к базе. Сохранение в Конфигураторе само по себе пользователям ничего не меняет.

Проверка после изменения синонима
Выполнено: 0 / 7

Если ничего не изменилось:

  • 🔄 Сеанс не перезапущен. Уже открытые сеансы продолжают работать со старыми метаданными. Пусть пользователь выйдет полностью, а не просто закроет окно.
  • 🧹 Сохранённые настройки формы. Пользователь мог когда-то сам переименовать колонку. Его личная настройка сильнее заголовка из метаданных. Откройте Ещё → Изменить форму и верните стандартные настройки.
  • 📄 Заполненное представление. Синоним меняли, а «Представление объекта» осталось старым — заголовок карточки не изменится.
  • 🧾 Синоним читается кодом. Некоторые механизмы берут название прямо из метаданных: история изменений, отчёты по объектам, тексты сообщений. Если синоним заимствованного объекта изменить нельзя, там останется типовое название, и это нормально.

Отладку обработчика &После делайте обычной точкой останова в модуле формы расширения: отладчик в Конфигураторе заходит и в код расширения.

Частые ошибки при правке синонимов

Диагностика: выберите симптом

Ещё две ошибки, которые встречаются при переименовании через расширение:

  • ❌ Правка заимствованной формы «целиком». Чем больше элементов вы меняете в заимствованной форме, тем выше шанс конфликта после обновления типовой. Для переименования достаточно трогать только нужные элементы.
  • ❌ Смена имени расширения ради нового названия. Для пользователя достаточно синонима. Имя меняйте только на этапе разработки, пока расширение не установлено в рабочие базы.

Частые вопросы

Можно ли изменить синоним в расширении в режиме 1С:Предприятия, без Конфигуратора?
Нет. В списке расширений в режиме 1С:Предприятия можно загрузить, обновить из файла, отключить или удалить расширение. Сами свойства объектов правят в Конфигураторе или в 1С:EDT.
Слетит ли новое название после обновления типовой конфигурации?
Нет, если правка сделана в расширении: основная конфигурация обновляется отдельно. После обновления проверьте, что расширение применилось, — элемент формы мог исчезнуть из типовой.
Влияет ли безопасный режим расширения на смену заголовков?
Нет. Безопасный режим ограничивает доступ к файлам, внешним компонентам и привилегированным операциям. Присвоить заголовок элементу формы он не мешает.
Что делать, если одну и ту же форму заимствуют два расширения?
Оба применятся, но порядок их обработчиков заранее не очевиден. Если оба меняют один и тот же заголовок, оставьте переименование только в одном расширении.
Можно ли переименовать объект для одного пользователя, а остальным оставить типовое название?
Через синоним — нет, он общий для всех. Для отдельных пользователей заголовок можно задать в коде формы по условию, например по роли, либо пользователь сам переименует колонку в настройках формы.