Как поменять название расширения 1С

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

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

Ниже разобраны оба сценария: когда достаточно поменять синоним, как корректно переименовать расширение без потери данных и какие проверки выполнить после изменения. Материал подходит для типовых конфигураций на управляемых формах (Бухгалтерия, Управление торговлей, ERP, ЗУП и другие), где расширения подключаются через стандартный механизм.

Что именно вы хотите поменять: имя или синоним

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

Если задача — чтобы в списке «Администрирование → Печатные формы, отчеты и обработки → Расширения» отображалось другое название, менять «Имя» не нужно. Достаточно открыть расширение в конфигураторе и отредактировать синоним. Это не влияет ни на хранение данных, ни на программные обращения к расширению.

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

Как поменять отображаемое название (синоним)

Это самый частый и самый безопасный сценарий. Порядок действий:

1. Запустите конфигуратор под пользователем с правами администратора.
2. Откройте меню «Конфигурация → Расширения конфигурации».
3. Дважды щелкните по нужному расширению — откроется окно его редактирования.
4. В палитре свойств найдите поле «Синоним» и введите новое название, например «Доработки печатных форм для отдела продаж».
5. Сохраните расширение (F7 или «Конфигурация → Сохранить») и обновите конфигурацию базы данных (F7 / «Обновить конфигурацию базы данных»).

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

Как переименовать расширение (свойство «Имя»)

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

Безопасный порядок действий выглядит так:

1. 1
   Сделайте выгрузку информационной базы (dt) или хотя бы резервную копию средствами СУБД.
2. 2
   Проверьте, хранит ли расширение данные: собственные справочники, регистры сведений, сохраняемые настройки.
3. 3
   Откройте «Конфигурация → Расширения конфигурации», выберите расширение.
4. 4
   В палитре свойств измените поле «Имя» — только латинские буквы, цифры и подчёркивания, начинаться должно с буквы.
5. 5
   Сохраните расширение и обновите конфигурацию базы данных.
6. 6
   Зайдите в режим «Предприятие», откройте список расширений и убедитесь, что расширение подключено и активно.
7. 7
   Проверьте работу функциональности, которую добавляет расширение: формы, отчёты, обработчики.

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

Если расширение при переходе на новую версию конфигурации отключается как несовместимое, переименование не решит эту проблему — потребуется адаптация кода расширения. Не пытайтесь «обойти» проверку совместимости сменой имени.

Что происходит с данными при смене имени

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

Простое редактирование имени в конфигураторе обычно сохраняет расширение «на месте», и данные не теряются. Но если вы действуете по схеме «удалить старое расширение → загрузить новое с другим именем», то вместе с удалением потеряете и данные добавленных объектов, и сохранённые настройки. Это самая частая причина «исчезнувших» данных после переименования.

Отдельный нюанс — настройки пользователей и сохранённые варианты отчётов, если они ссылались на объекты расширения. После смены имени часть таких настроек может перестать подхватываться, и пользователям придётся настроить отчёты заново.

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

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

Контрольные точки

Как проверить результат

Список расширений в режиме «Предприятие»

Норма

Расширение присутствует, активно, без пометок об ошибках

Тревожный признак

Расширение отключено, появилась надпись о несовместимости, или в списке два похожих расширения

Функциональность расширения

Норма

Добавленные формы, кнопки, печатные формы открываются и работают

Тревожный признак

Команды пропали из интерфейса, при обращении возникают ошибки

Данные объектов расширения

Норма

Записи в регистрах и справочниках расширения на месте

Тревожный признак

Таблицы пусты или объекты недоступны

Журнал регистрации

Норма

Нет ошибок при обновлении и при старте сеансов

Тревожный признак

Ошибки обновления конфигурации БД или обращения к расширению

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

Типичные ошибки и как их избежать

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

Альтернативные способы и когда они нужны

Если прямое переименование по каким-то причинам невозможно или нежелательно, есть обходные варианты:

Сравнение вариантов

Изменить только синоним

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

Переименовать имя в конфигураторе

Подходит, когда нужен новый технический идентификатор. Требует резервной копии и проверки данных. Ограничение: риск потери связи с настройками.

Выгрузить в файл, переименовать, загрузить заново

Подходит для переноса в другую базу. Ограничение: в исходной базе данные расширения будут потеряны при удалении старого.

Оставить как есть

Если имя используется в коде, интеграциях или внешних обработках, обращающихся к расширению, — часто дешевле не переименовывать, а поправить только синоним.

При выборе варианта руководствуйтесь простым правилом: чем больше у расширения собственных данных и внешних связей, тем меньше смысла менять техническое имя. В большинстве практических задач достаточно синонима.

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

Можно ли переименовать расширение прямо в режиме «Предприятие»?

Нет. В списке расширений в пользовательском режиме можно только подключать, отключать и удалять расширения, а также загружать их из файла. Изменение имени и синонима доступно только в конфигураторе.

Потеряются ли данные, если я просто изменю имя и сохраню расширение?

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

Почему после переименования расширение стало неактивным?

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

Можно ли задать название расширения на русском языке?

В свойстве «Имя» — нет, допустимы только латинские буквы, цифры и подчёркивания. Русскоязычное название указывается в свойстве «Синоним», именно его увидят пользователи в списке расширений.

Нужно ли переименовывать расширение при обновлении типовой конфигурации?

Нет. Обновление конфигурации не требует переименования расширений. Если после обновления расширение отключилось как несовместимое, проблема решается адаптацией его кода к новой версии конфигурации, а не сменой имени.

Что делать, если в базе уже есть расширение с нужным именем?

Платформа не позволит иметь два расширения с одинаковым именем. Либо выберите другое уникальное имя, либо сначала удалите или переименуйте конфликтующее расширение, предварительно убедившись, что его данные не нужны.