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