Новое название объекта без правки типовой: синонимы, заголовки форм и команд в расширении
Содержание
Синоним в расширении 1С меняют в Конфигураторе: Конфигурация → Расширения конфигурации, откройте нужное расширение, выделите объект в дереве и исправьте свойство «Синоним» в палитре свойств (Alt+Enter). Затем выполните Обновить конфигурацию базы данных для расширения и перезапустите сеанс 1С:Предприятия. Для собственных объектов расширения поле редактируется свободно. У заимствованных объектов название, которое видит пользователь, надёжнее менять там, где оно выводится: в заголовках формы, её элементов и команд.
Такой подход позволяет переименовать объект метаданных «для глаз пользователя», не снимая типовую конфигурацию с поддержки. Основная конфигурация остаётся нетронутой, и очередное обновление не затрёт ваши названия. Всё описанное относится к платформе 8.3 (расширения появились в версии 8.3.6) и не зависит от конкретной конфигурации: БП 3.0, ЗУП 3.1 и УТ 11 работают одинаково.
Как устроены названия в расширении: имя, синоним и заимствование
У каждого объекта метаданных три «названия», и путать их нельзя:
- 🔤 Имя — идентификатор для кода (
ПоступлениеТоваровУслуг). Его видит только программист. - 🏷️ Синоним — то, что видит пользователь в меню, заголовках, списках. Может быть на нескольких языках.
- 📋 Представления — «Представление объекта», «Представление списка», «Расширенное представление» у справочников, документов и регистров. Если они заполнены, в заголовках форм платформа показывает их, а не синоним.
В расширении объекты бывают двух видов.
| Вид объекта | Откуда берётся | Что можно менять |
|---|---|---|
| Собственный | Создан в расширении, имя с префиксом (например, Расш1_) | Все свойства, включая синоним и представления |
| Заимствованный | Добавлен из основной конфигурации командой «Добавить в расширение» | Ограниченный набор свойств; формы, модули и командный интерфейс — дорабатываются |
Заимствованный объект — это ссылка на объект основной конфигурации. Его имя менять нельзя: по имени платформа сопоставляет объект расширения с объектом типовой. Большинство свойств наследуется. Недоступные для изменения поля палитра показывает серыми.
Прежде чем что-то делать, решите, где именно пользователь должен увидеть новое название. Пункт в разделе меню, заголовок списка, подпись поля на форме и колонка отчёта — это четыре разных места, и меняются они по-разному.
Подготовка: доступ, копия и открытие расширения
Что нужно до начала работы:
- 🔑 Права администратора в информационной базе и вход в Конфигуратор.
- 💾 Свежая выгрузка расширения в файл
.cfe. Делается в окне расширения:Конфигурация → Сохранить в файл. Если что-то пойдёт не так, вы вернётесь к рабочей версии за минуту. - 🧪 По возможности — копия базы для проверки. Изменения в расширении обычно безопасны, но проверять их лучше не на рабочих пользователях.
Как открыть расширение:
- Запустите Конфигуратор.
- Если основная конфигурация ещё не открыта, откройте её:
Конфигурация → Открыть конфигурацию. - Выберите
Конфигурация → Расширения конфигурации. Появится список расширений базы. - Выделите нужное и откройте его дерево двойным щелчком или через командную панель списка.
Если расширения ещё нет, создайте его кнопкой «Добавить» в том же списке. В свойствах укажите имя, синоним, префикс имён и назначение. Для правки названий подходит назначение «Адаптация» или «Дополнение».
Расширение, установленное через режим 1С:Предприятия (из файла .cfe), тоже видно в Конфигураторе. Но если его потом снова загрузят из старого файла, ваши правки пропадут. Договоритесь, где хранится актуальная версия.
Как изменить синоним объекта в расширении
Синоним собственного объекта
Самый простой случай. Справочник, документ, отчёт или обработка созданы в расширении:
- Выделите объект в дереве расширения.
- Откройте палитру свойств:
Alt+Enterили пункт «Свойства» в контекстном меню. - В поле «Синоним» введите новое название. Кнопка с многоточием открывает окно со значениями для каждого языка конфигурации.
- Проверьте «Представление объекта» и «Представление списка». Если они заполнены старым текстом, исправьте и их, иначе заголовки форм останутся прежними.
- Сохраните расширение и выполните для него
Конфигурация → Обновить конфигурацию базы данных(F7) в окне расширения.
Синонимы стандартных реквизитов («Код», «Наименование», «Владелец») правят отдельно: в свойствах объекта найдите «Стандартные реквизиты» и откройте их список.
Синоним заимствованного объекта
Здесь задача обычно такая: в типовой документ называется «Поступление (акты, накладные, УПД)», а бухгалтеры хотят видеть короче.
- В дереве основной конфигурации найдите объект.
- Правой кнопкой мыши — «Добавить в расширение» — выберите ваше расширение.
- Откройте палитру свойств заимствованного объекта в дереве расширения.
- Если поле «Синоним» доступно для ввода — измените его так же, как у собственного объекта, и обновите конфигурацию базы данных.
- Если поле серое, метаданные переименовать не выйдет. Меняйте название там, где его видит пользователь: заимствуйте формы и команды объекта (два следующих раздела).
Не пытайтесь «переименовать» заимствованный объект, создав рядом собственный с нужным синонимом. Получится второй, пустой справочник или документ, а пользователи начнут вносить данные не туда.
Синоним самого расширения
Иногда меняют не синоним объекта, а название расширения в списке. Оно задаётся в свойствах корня дерева расширения:
- Имя — менять у работающего расширения не стоит: по нему расширение идентифицируется в базе, на него могут опираться обработки и регламентные процедуры.
- Синоним — можно менять свободно. Именно его видит администратор в списке
Администрирование → Печатные формы, отчеты и обработки → Расширения(БП 3.0, ЗУП 3.1, УТ 11). - Версия — заодно увеличьте её, чтобы потом понимать, какая сборка установлена.
Переименование реквизитов и подписей на формах
Подпись поля на форме не всегда совпадает с синонимом реквизита. Если у элемента формы заполнено свойство «Заголовок», выводится оно. Если пусто — берётся синоним реквизита. Поэтому иногда достаточно поправить только форму.
Через редактор заимствованной формы
- В дереве основной конфигурации раскройте объект, ветку «Формы».
- На нужной форме — «Добавить в расширение».
- Откройте заимствованную форму в расширении. В дереве элементов выделите поле, группу или кнопку.
- В палитре свойств элемента заполните «Заголовок» новым текстом.
- Для заголовка всего окна выделите корень дерева «Форма» и заполните его свойство «Заголовок».
Так же переименовывают колонки динамического списка в форме списка: у каждой колонки свой элемент и своё свойство «Заголовок».
Программно, если форма собирается кодом
Многие формы типовых конфигураций достраивают элементы в модуле при создании. Тогда изменение в редакторе не поможет — элемента в дереве просто нет, или код перезаписывает заголовок. Решение — дописать обработчик в модуле заимствованной формы, который отработает после типового:
&НаСервере
&После("ПриСозданииНаСервере")
Процедура Расш1_ПриСозданииНаСервереПосле(Отказ, СтандартнаяОбработка)
Заголовок = "Поступление от поставщика";
Элемент = Элементы.Найти("Контрагент");
Если Элемент <> Неопределено Тогда
Элемент.Заголовок = "Поставщик";
КонецЕсли;
КонецПроцедуры
Пояснения к примеру:
- 🧩 Аннотация
&Послеработает, только если в модуле основной формы есть процедураПриСозданииНаСервере. Посмотрите её точное имя в модуле типовой формы. - 🔍
Элементы.НайтивместоЭлементы.Контрагентзащищает от ошибки, если после обновления типовой элемент переименуют или удалят. - 🏷️ Имя элемента смотрите в дереве элементов формы, а не в списке реквизитов: они могут отличаться.
Обработчик можно создать и без ручного набора: в палитре свойств заимствованной формы, на закладке событий, у события «ПриСозданииНаСервере» Конфигуратор предлагает вариант вызова — перед, после или вместо типового. Выбирайте «после», иначе типовой код перепишет ваш заголовок.
Команды, разделы и командный интерфейс
Пункт меню в разделе — это не синоним объекта как таковой, а представление команды. Варианты:
- Команда собственного объекта. Меняется вместе с синонимом объекта или через свойство «Представление» у команды.
- Своя общая команда или команда формы. Создаётся в расширении, ей задаются «Синоним» и «Представление». Удобно, когда нужно добавить в раздел пункт с понятным названием, который открывает типовую форму.
- Кнопка на форме. Заимствуйте форму, выделите кнопку и заполните ей «Заголовок» — как у полей.
- Командный интерфейс подсистемы. Заимствуйте подсистему (раздел), откройте её командный интерфейс в расширении и скройте, переставьте или добавьте команды. Так можно спрятать типовой пункт и показать вместо него свою команду с новым названием.
| Что видит пользователь | Где меняется в расширении |
|---|---|
| Заголовок окна формы | «Заголовок» корня заимствованной формы или код &После |
| Подпись поля, колонка списка | «Заголовок» элемента формы |
| Кнопка на форме | «Заголовок» кнопки или представление команды формы |
| Пункт в разделе меню | Командный интерфейс заимствованной подсистемы, своя команда |
| Название раздела | Синоним подсистемы — если поле доступно; иначе своя подсистема |
Как проверить, что новое название применилось
После правки обязательно примените расширение к базе. Сохранение в Конфигураторе само по себе пользователям ничего не меняет.
Если ничего не изменилось:
- 🔄 Сеанс не перезапущен. Уже открытые сеансы продолжают работать со старыми метаданными. Пусть пользователь выйдет полностью, а не просто закроет окно.
- 🧹 Сохранённые настройки формы. Пользователь мог когда-то сам переименовать колонку. Его личная настройка сильнее заголовка из метаданных. Откройте
Ещё → Изменить формуи верните стандартные настройки. - 📄 Заполненное представление. Синоним меняли, а «Представление объекта» осталось старым — заголовок карточки не изменится.
- 🧾 Синоним читается кодом. Некоторые механизмы берут название прямо из метаданных: история изменений, отчёты по объектам, тексты сообщений. Если синоним заимствованного объекта изменить нельзя, там останется типовое название, и это нормально.
Отладку обработчика &После делайте обычной точкой останова в модуле формы расширения: отладчик в Конфигураторе заходит и в код расширения.
Частые ошибки при правке синонимов
Конфигурация → Проверить конфигурацию и уберите ссылки на отсутствующие элементы. Код с Элементы.Найти такие ситуации переживает.Ещё две ошибки, которые встречаются при переименовании через расширение:
- ❌ Правка заимствованной формы «целиком». Чем больше элементов вы меняете в заимствованной форме, тем выше шанс конфликта после обновления типовой. Для переименования достаточно трогать только нужные элементы.
- ❌ Смена имени расширения ради нового названия. Для пользователя достаточно синонима. Имя меняйте только на этапе разработки, пока расширение не установлено в рабочие базы.