Как переименовать расширение 1С: Пошаговая инструкция

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

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

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

Различие между техническим именем и синонимом

Первым шагом в решении задачи является четкое понимание архитектуры метаданных 1С. Каждое расширение обладает двумя ключевыми идентификаторами: техническим именем (Имя) и синонимом. Техническое имя используется системой для внутренней адресации объектов, хранения данных в таблицах и формирования ссылок в коде. Оно должно быть уникальным в рамках базы данных и обычно пишется латиницей без пробелов. Изменение этого параметра является наиболее рискованной операцией.

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

Если ваша цель — просто сделать название более понятным для бухгалтеров или менеджеров, достаточно изменить только синоним. Но если требуется привести имя в соответствие с новыми корпоративными стандартами (например, сменить префикс «УНФ_Доп» на «УНФ_Кастом»), тогда придется менять и техническое имя. В последнем случае система будет воспринимать расширение как совершенно новый объект, если не выполнить процедуру корректного экспорта и импорта.

⚠️ Внимание: Изменение технического имени расширения разрывает связь с ранее установленной версией. Пользователи увидят в списке подключений два разных расширения: старое (которое перестанет обновляться) и новое.

Для проверки текущих значений откройте конфигуратор и перейдите в дерево метаданных. Найдите ветку «Расширения», раскройте её и выберите нужное расширение. В палитре свойств вы увидите поля «Имя» и «Синоним». Запомните текущее значение имени, так как оно понадобится для поиска объектов, зависящих от этого расширения, если таковые имеются в смежных конфигурациях.

Изменение отображаемого названия (Синонима)

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

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

• 🛠️ Откройте конфигурацию в режиме Конфигуратор.
• 📂 Раскройте ветку Расширения и выберите нужный объект.
• ✏️ В палитре свойств измените значение поля Синоним.
• 💾 Сохраните конфигурацию и выполните обновление базы данных.

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

Следует также учитывать, что если расширение публикуется через веб-сервис или передается партнерам как файл, то в описании к файлу (в свойствах файла расширения) также может дублироваться название. Проверьте вкладку «Дополнительно» в свойствах расширения, чтобы убедиться, что там нет устаревшей информации, которая может быть использована при автообновлении через интернет.

Полная смена технического имени расширения

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

Первый этап — это экспорт старого расширения в файл. Даже если вы работаете в файловой базе или в базе данных, рекомендуется выгрузить расширение в отдельный файл формата .cfu или .cfe (в зависимости от версии платформы и типа расширения). Это позволит вам иметь «чистый» исходник, который можно будет открыть в отдельном окне конфигуратора и манипулировать им без риска повредить основную базу.

Меню: Конфигурация -> Сохранить расширение в файл...

После сохранения файла создайте в основной конфигурации новое расширение. Присвойте ему сразу правильное техническое имя и синоним. Теперь вам предстоит открыть сохраненный файл старого расширения в новом окне конфигуратора (через меню «Файл» -> «Открыть») и скопировать оттуда все объекты: справочники, документы, отчеты, обработки и общие модули. Вставьте их в новое расширение, соблюдая структуру папок.

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

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

Особенности работы с файлами расширений

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

Для продвинутых пользователей, работающих с внешними обработками или механизмом Расширение конфигурации через внешние файлы, существует возможность редактирования файла расширения как текстового документа (в формате XML), однако это крайне не рекомендуется без глубоких знаний внутренней структуры. Ошибка в XML-теге name может привести к полной неработоспособности файла.

Параметр	Синоним	Техническое имя	Имя файла
Назначение	Отображение для пользователя	Идентификатор в системе	Имя файла на диске
Можно менять	В любой момент	Только через пересоздание	В любой момент
Влияние на код	Минимальное	Критическое	Отсутствует
Требует обновления БД	Да	Да (фактически замена)	Нет

Имя файла на диске (например, MyExtension.cfe) никак не влияет на работу системы внутри 1С. Вы можете переименовывать файл сколько угодно раз перед загрузкой. Главное, чтобы внутри файла, в заголовке метаданных, было прописано корректное техническое имя, соответствующее тому, что ожидает система или то, которое вы хотите внедрить.

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

Файл расширения можно открыть в текстовом редакторе (если он не зашифрован). В начале файла в XML-структуре будет тег , внутри которого есть атрибут или узел Name. Именно это значение является техническим именем.

Влияние переименования на обновления типовой конфигурации

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

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

⚠️ Внимание: При обновлении типовой конфигурации всегда проверяйте список установленных расширений. Наличие «осиротевших» расширений со старыми именами может замедлить работу системы и запутать при диагностике ошибок.

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

Для автоматизированных систем непрерывной интеграции (CI/CD) изменение имени расширения является критическим событием. Скрипты выгрузки и загрузки могут перестать работать, если они жестко завязаны на имя файла или имя расширения в репозитории. Необходимо обновить конфигурационные файлы сборки, чтобы они учитывали новое имя.

Типичные ошибки и способы их устранения

В практике администрирования 1С встречается ряд типовых ошибок, связанных с переименованием. Самая частая из них — попытка изменить имя в свойствах уже подключенного расширения в режиме предприятия (через интерфейс администрирования). Это невозможно, так как интерфейс позволяет менять только параметры подключения (включение/выключение), но не структуру метаданных. Изменять имя можно только в режиме Конфигуратор.

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

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

Для устранения ошибок используйте журнал регистрации 1С. Там подробно фиксируются все этапы загрузки расширения и причины неудач. Если расширение не загружается, попробуйте выгрузить его заново из конфигуратора-источника, убедившись, что конфигурация успешно проверена на ошибки перед выгрузкой.

Также стоит помнить о версиях платформы. Некоторые старые версии платформы 1С:Предприятие 8.3 могли иметь ограничения на длину имени расширения или допустимые символы. Если вы работаете в устаревшей среде, убедитесь, что новое имя соответствует техническим ограничениям вашей версии платформы.

ℹ️ Интерфейс и возможности работы с расширениями могут незначительно отличаться в зависимости от версии платформы 1С и режима работы базы (файловый/клиент-серверный). Всегда сверяйтесь с официальным руководством пользователя для вашей конкретной версии.

Часто задаваемые вопросы (FAQ)

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

Нет, техническое имя расширения является его уникальным идентификатором. Для смены имени необходимо создать новое расширение с желаемым именем и перенести в него все объекты, после чего удалить старое. Смена синонима возможна без удаления.

Что будет с данными, если я переименую расширение?

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

Как переименовать файл расширения на диске?

Вы можете просто переименовать файл .cfe или .cfu в проводнике Windows. Это никак не повлияет на внутреннее имя расширения. Главное — не потерять сам файл. Внутреннее имя меняется только через конфигуратор при сохранении или создании.

Нужно ли перезапускать сервер 1С после переименования?

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

Влияет ли переименование на лицензирование?

Нет, лицензирование 1С не привязано к именам расширений. Лицензии выдаются на количество рабочих мест или серверные подключения. Расширения являются частью конфигурации и не требуют отдельных лицензий, если они не используют сторонние защищенные компоненты.