Разработка и Конфигурация · 11 мин
Как переименовать расширение 1С
Как переименовать расширение в 1С через конфигуратор и в файле манифеста. Безопасность, синоним, имя, проверка результата и типичные ошибки при переименовании.
Расширение конфигурации в 1С имеет два названия: имя (внутренний идентификатор, по которому система обращается к расширению) и синоним (отображаемое название, которое видят пользователи и администраторы). Путаница между ними — главная причина, почему «переименование не сработало»: меняют синоним, а имя остаётся прежним, или наоборот.
Переименование может понадобиться при передаче разработки заказчику, приведении к единому стандарту именования, разделении нескольких расширений от разных поставщиков или исправлении опечатки в названии. В зависимости от задачи процедура занимает от минуты — если нужно поправить только отображаемое название — до полного цикла выгрузки и загрузки, если меняется имя расширения в работающей базе.
Ниже разобраны все способы: через конфигуратор, через справочник расширений в режиме предприятия, через редактирование файла манифеста и через пакетную загрузку. Отдельно описаны риски для баз с подключёнными расширениями и способы проверить, что после переименования ничего не сломалось.
Что именно вы переименовываете: имя, синоним и файл
Прежде чем менять название, определите, какое из трёх «имён» расширения вам нужно изменить. Имя — технический идентификатор на языке конфигурации: только латиница, цифры и подчёркивания, без пробелов, начинаться должно с буквы. По имени расширение выгружается в файл, подключается программно и различается в списке расширений базы.
Синоним — понятное человеку название, которое отображается в списке расширений в режиме предприятия и в конфигураторе. Синоним может содержать пробелы, кириллицу и любые символы. Менять синоним безопасно всегда — он ни на что программно не влияет.
Отдельная сущность — имя файла .cfe, в который выгружено расширение. Файл можно переименовать средствами операционной системы, и это никак не повлияет на содержимое: при загрузке платформа читает имя расширения из манифеста внутри файла, а не из названия файла.
Переименование через конфигуратор
Основной и рекомендуемый способ — изменить свойства расширения в конфигураторе. Откройте конфигуратор, перейдите в меню Конфигурация → Расширения конфигурации. В списке расширений выделите нужное и откройте его двойным щелчком — расширение загрузится для редактирования, а в дереве конфигурации появится его структура.
Выделите корневой узел дерева расширения (самая верхняя строка с текущим именем) и откройте палитру свойств — правой кнопкой мыши → Свойства или через меню Правка → Свойства. В палитре найдите поля Имя и Синоним. Введите новые значения: имя — по правилам идентификаторов, синоним — в свободной форме.
После изменения сохраните расширение: Конфигурация расширения → Сохранить. Если расширение подключено к базе, конфигуратор предложит обновить конфигурацию базы данных — соглашайтесь. При наличии активных сеансов пользователей обновление может потребовать монопольного режима либо выполниться в фоне с перезапуском сеансов.
- 1Откройте конфигуратор и меню «Конфигурация → Расширения конфигурации»
- 2Дважды щёлкните по нужному расширению, чтобы открыть его
- 3Выделите корневой узел дерева и откройте палитру свойств
- 4Измените поля «Имя» и «Синоним» на новые значения
- 5Сохраните расширение и согласитесь на обновление конфигурации базы данных
- 6Проверьте список расширений: отображается новое название
Изменение названия в режиме предприятия
Если менять нужно только отображаемое название и нет доступа к конфигуратору, воспользуйтесь стандартной обработкой управления расширениями. В большинстве конфигураций на БСП она находится по пути Администрирование → Печатные формы, отчеты и обработки → Расширения либо НСИ и администрирование → Расширения. В простых конфигурациях список доступен через Все функции → Стандартные → Управление расширениями конфигурации.
В форме списка расширений колонка с названием показывает синоним. Редактирование синонима напрямую из этой формы зависит от версии платформы и библиотеки стандартных подсистем: в части версий доступен только просмотр и подключение/отключение. Если поле недоступно для редактирования, синоним меняется только через конфигуратор или через выгрузку и правку манифеста.
Переименование через выгрузку и правку манифеста
Когда конфигуратор недоступен или расширение нужно переименовать «офлайн», измените имя прямо в файле. Файл .cfe — это контейнер, внутри которого лежит манифест с описанием расширения. Выгрузите расширение: в конфигураторе Конфигурация → Расширения конфигурации → Сохранить в файл, либо выгрузите из списка расширений в режиме предприятия.
Для редактирования манифеста удобнее выгрузить расширение в файлы конфигурации через пакетный режим конфигуратора командой DumpConfigExtensionToFiles — тогда описание будет в читаемом XML, где имя задаётся элементом <Name>. Измените значение, соберите обратно командой LoadConfigExtensionFromFiles и загрузите результат в базу.
1cv8 DESIGNER /F"D:\Bases\Trade" /DumpConfigExtensionToFiles "D:\Ext\src" -Extension "СтароеИмя" -Format Hierarchical
# правим имя в Configuration.xml (элемент <Name>)
1cv8 DESIGNER /F"D:\Bases\Trade" /LoadConfigExtensionFromFiles "D:\Ext\src" -Extension "НовоеИмя" -UpdateDBCfgПосле загрузки переименованного расширения старое останется в базе как отдельный объект — его нужно удалить из списка расширений, иначе оба варианта будут работать одновременно и могут конфликтовать, например дублировать подписки на события.
Риски при переименовании подключённого расширения
Главный риск — потеря связи с данными и настройками, которые хранятся с привязкой к имени расширения. Если расширение добавляет собственные объекты (справочники, регистры, документы), при обновлении конфигурации базы данных платформа сопоставляет их по внутренним идентификаторам, и переименование самого расширения обычно проходит безболезненно. Но внешние механизмы — регламентные задания, настройки в хранилищах, программные обращения по имени — привязку могут потерять.
Проверьте код основной конфигурации и других расширений на обращения к переименовываемому расширению по строковому имени — например, через РасширенияКонфигурации.Получить() с фильтром по имени. Такие места после переименования перестанут находить расширение.
Проверка результата после переименования
После сохранения откройте список расширений в режиме предприятия и убедитесь, что отображается новый синоним, а в колонке имени — новый идентификатор. Проверьте, что расширение активно (флаг подключения установлен) и безопасный режим не изменился.
Затем проверьте функциональность: откройте формы и отчёты, которые добавляет или изменяет расширение, выполните типовую операцию, затронутую расширением. Если расширение добавляло объекты данных — убедитесь, что записи в них сохранились и доступны для редактирования.
Как проверить результат
Виден новый синоним, расширение подключено
Старое название или расширение отключено
Записи справочников и регистров на месте
Объекты пусты или недоступны
Нет ошибок обновления и обращений к расширению
Ошибки вида «расширение не найдено»
Формы открываются, изменения применяются
Ошибки при открытии, изменения не видны
Типичные ошибки и как их избежать
Самая частая ошибка — переименование только файла .cfe с ожиданием, что в базе изменится название. Имя берётся из манифеста, поэтому файл можно назвать как угодно — в списке расширений появится имя изнутри файла. Вторая ошибка — использование в имени пробелов, кириллицы или дефисов: конфигуратор такое имя не примет, вернитесь к правилам идентификаторов.
Третья группа ошибок связана с одновременным существованием старой и новой версии: после загрузки переименованного расширения из файла забывают удалить исходное. Оба расширения применяют одни и те же изменения, что приводит к конфликтам и непредсказуемому поведению форм.
Удобный стандарт именования: префикс компании или проекта плюс суть, например «Ромашка_ОбменССайтом». Так в базе с несколькими расширениями от разных поставщиков сразу видно, чьё расширение и за что отвечает, а риск совпадения имён при загрузке сторонних решений минимален.
Частые вопросы
Можно ли переименовать расширение без конфигуратора?
Да, но ограниченно. В режиме предприятия в ряде версий платформы и БСП синоним редактируется прямо в списке расширений. Полное изменение имени без конфигуратора возможно только через выгрузку расширения в файлы, правку манифеста и загрузку обратно — для этого всё равно понадобится пакетный режим конфигуратора.
Пропадут ли данные объектов расширения после переименования?
Обычно нет: платформа сопоставляет объекты по внутренним идентификаторам, а не по имени расширения. Однако перед обновлением рабочей базы обязательно сделайте резервную копию и проверьте процедуру на тестовой копии — особенно если расширение добавляет регистры и справочники.
Почему после переименования в списке снова старое название?
Скорее всего, вы переименовали файл .cfe или загрузили старую версию файла, где имя в манифесте не изменено. Платформа читает имя изнутри файла. Откройте расширение в конфигураторе и проверьте свойства корневого узла.
Какие символы допустимы в имени расширения?
Те же, что для любого идентификатора встроенного языка: латинские буквы, цифры и знак подчёркивания; первый символ — буква или подчёркивание. Пробелы, дефисы и кириллица в имени недопустимы, но их можно использовать в синониме.
Нужно ли переименовывать расширение во всех базах после изменения?
Если одно и то же расширение подключено к нескольким базам, изменение имени в одной базе на другие не влияет. Чтобы имена совпадали везде, выгрузите переименованное расширение в файл и загрузите его в остальные базы, удалив старые варианты.
Влияет ли переименование на безопасный режим и профили безопасности?
Сама смена имени настройки безопасного режима не сбрасывает, но при удалении старого и загрузке нового расширения параметры подключения (безопасный режим, защита от опасных действий) нужно проверить и при необходимости выставить заново.
Что важно запомнить
Переименование расширения — это изменение свойств «Имя» и «Синоним» в конфигураторе, а не переименование файла .cfe. Перед изменением в рабочей базе сделайте резервную копию, после — удалите старую версию из списка расширений и проверьте работу форм, отчётов и данных объектов расширения.