Новое имя для расширения конфигурации: синоним, техническое имя и файл .cfe

Чтобы переименовать расширение 1С, откройте Конфигуратор, выберите Конфигурация → Расширения конфигурации, откройте дерево нужного расширения и в свойствах его корневого элемента измените поле Имя (техническое имя) или Синоним (то, что видят пользователи). Затем обновите расширение в базе данных клавишей F7. Переименование файла .cfe на диске имя расширения не меняет.

Какой способ выбрать, зависит от задачи. Если нужно, чтобы в списке расширений стояло понятное название, — хватит синонима, это безопасно и занимает минуту. Если меняется техническое имя, на которое ссылается код, обмены или регламент обновления, — это уже изменение конфигурации, и его делают на копии базы. Инструкция ниже — для платформы 8.3 и любых конфигураций на ней: механизм расширений общий, от Бухгалтерии или ЗУП он не зависит.

Имя, синоним и префикс: что из этого вы меняете

У корневого элемента расширения три свойства, которые путают между собой. Сначала определите, какое из них вам на самом деле мешает.

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

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

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

Как сменить синоним расширения

Синоним меняется в Конфигураторе. Работа идёт с самим расширением, основная конфигурация при этом не меняется.

1. Запустите базу в режиме Конфигуратор под пользователем с правами администратора.
2. Выберите Конфигурация → Расширения конфигурации. Откроется список расширений базы.
3. Выделите нужное расширение и откройте его дерево (кнопка открытия конфигурации расширения или двойной щелчок по строке).
4. В дереве щёлкните правой кнопкой по корневому элементу и выберите Свойства (или нажмите Alt+Enter).
5. Введите новый текст в поле Синоним.
6. Нажмите F7 — обновить конфигурацию базы данных для этого расширения.

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

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

Как изменить техническое имя расширения

Это главный и самый рискованный сценарий. Перед сменой имени сохраните расширение в файл .cfe и сделайте копию базы — при ошибке вернуть всё назад можно будет за пару минут.

Способ 1. Переименование на месте в Конфигураторе

Подходит в большинстве случаев, особенно если у расширения есть собственные данные.

1. Откройте Конфигурация → Расширения конфигурации и дерево нужного расширения.
2. Сохраните текущую версию в файл: в меню Конфигурация открытого расширения есть команда сохранения расширения в файл. Получится .cfe — это ваша страховка.
3. Откройте свойства корневого элемента (Alt+Enter).
4. В поле Имя введите новое имя. Правила такие же, как для любого идентификатора 1С: буквы, цифры и подчёркивание, первым символом — буква или _, без пробелов и дефисов.
5. Нажмите F7. Платформа обновит расширение в базе.
6. Вернитесь в список Расширения конфигурации и проверьте, что в колонке имени стоит новое значение, а флажок Активно не слетел.
7. Запустите базу в режиме 1С:Предприятие и проверьте, что доработки расширения работают: открываются формы, печатаются макеты, выполняются заимствованные обработчики.

Способ 2. Создать новое расширение и перенести в него содержимое

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

1. В списке Расширения конфигурации нажмите Добавить и сразу задайте новое имя, синоним и префикс.
2. Перенесите объекты из старого расширения: через сравнение и объединение с файлом .cfe старого расширения либо выгрузкой в XML-файлы.
3. Обновите новое расширение (F7) и проверьте работу.
4. Отключите старое расширение (снимите флажок Активно), убедитесь, что всё работает, и только потом удалите его.

Способ 3. Через выгрузку в XML

Удобен для тех, кто ведёт расширение в Git или в EDT.

1. В меню открытого расширения выберите выгрузку конфигурации в файлы. Получится папка с XML.
2. Откройте корневой файл Configuration.xml и замените значение в теге <Name> на новое имя.
3. Загрузите файлы обратно в расширение тем же меню, затем F7.

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

Сравнение способов

Как выбрать имя расширения, чтобы не переименовывать его снова

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

• 🎯 Имя отражает назначение, а не автора или дату. ПечатьДоговоров, ЗагрузкаВыписокБанка понятнее, чем Доработки_Иванов_2.
• 🔤 Префикс — короткий и уникальный для расширения. Например, пд_ для «печати договоров». Так в отладчике и в запросах сразу видно, чьи это объекты.
• 📦 Одно расширение — одна задача. Если в расширении живут печатные формы, обмен и исправление ошибки типовой, его со временем захочется разделить, а это сложнее, чем переименование.
• 🔢 Версию пишите в свойство Версия, а не в имя. ПечатьДоговоров_v3 придётся переименовывать при каждом выпуске.

Файл .cfe: имя файла и имя расширения — разные вещи

Самая частая путаница. Файл ДоработкиПечати.cfe может содержать расширение с именем Расширение1. Имя файла — это просто подпись на диске. Имя расширения записано внутри файла и задаётся свойством корня.

Что из этого следует на практике:

• 📁 Переименовали файл .cfe в проводнике — в базе ничего не изменится.
• 🔁 Загрузили через форму управления расширениями файл с другим внутренним именем — в базе может появиться второе расширение рядом со старым, а не обновиться первое.
• ⚔️ Два активных расширения, которые меняют одни и те же объекты, конфликтуют. Платформа сообщит об ошибке применения, а доработки начнут работать непредсказуемо.

Чтобы обновить расширение из файла, а не добавить второе, внутреннее имя в .cfe должно совпадать с именем расширения в базе. Значит, если вы переименовали расширение в одной базе, остальные базы нужно переименовать тем же способом или загрузить в них новый файл и удалить старое расширение (с учётом данных, см. выше).

Для пакетной работы Конфигуратор принимает параметр -Extension в командах загрузки и обновления. Пример загрузки файла в расширение с указанным именем и обновления базы:

"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" DESIGNER /F "D:\Bases\Buh" /N "Администратор" /P "" ^
  /LoadCfg "D:\cfe\Dorabotki.cfe" -Extension "ДоработкиПечати" ^
  /UpdateDBCfg -Extension "ДоработкиПечати" ^
  /Out "D:\cfe\log.txt"

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

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

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

Что действительно проверить после обновления типовой — применимость расширения. Если в новом релизе изменились заимствованные объекты, платформа сообщит, что расширение не может быть применено, и укажет конкретные объекты. К имени это отношения не имеет: проблема в содержимом.

Где имя всё-таки важно:

• 🧩 Код, который ищет расширение по имени. Отбор по свойству Имя в методах менеджера РасширенияКонфигурации перестанет находить переименованное расширение.
• 🛠️ Скрипты и регламент обновления. Командные файлы, задания планировщика, утилиты автоматического обновления — всё, где имя прописано текстом.
• 🌐 Несколько баз. В распределённой базе и в группе одинаковых баз имена должны совпадать везде, иначе вы получите разные расширения под одним синонимом.
• 📝 Документация и заявки. Звучит мелко, но через полгода никто не вспомнит, что ДоработкиУчета раньше называлось Расширение2.

Найти упоминания старого имени в коде основной конфигурации и других расширений помогает глобальный поиск Конфигуратора Ctrl+Shift+F. Ищите имя в кавычках — так быстрее отсеять совпадения в комментариях.

Если что-то пошло не так

Ниже — ситуации, которые возникают именно при переименовании, а не при работе с расширениями вообще.

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