Как изменить имя расширения в 1С: 3 проверенных способа

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

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

Материал актуален для всех актуальных релизов платформы 1С:Предприятие 8.3 (включая 8.3.23 и новее) и типовых конфигураций на их основе (Бухгалтерия 3.0, УТ 11, ЗУП 3.1 и др.). Если вы работаете с устаревшими версиями (8.2 или ранние 8.3), часть методов может потребовать адаптации.

Почему может понадобиться изменить имя расширения

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

• 📌 Стандартизация наименований. В крупных компаниях часто вводят единые правила именования расширений (например, префиксы по подразделениям: Фин_, Склад_, Кадры_), и старые названия приходится приводить в соответствие.
• 🔄 Рефакторинг кода. При изменении функционала расширения его название может устареть. Например, расширение "ДопОтчетПоЗаказам" превратилось в универсальный модуль анализа продаж — логично переименовать его в "АналитикаПродаж".
• 🤝 Конфликты имён. При слиянии баз или подключении внешних расширений могут возникать конфликты имён, которые проще разрешить переименованием, чем редактированием зависимостей.
• 📦 Экспорт/импорт. При переносе расширений между базами удобно, когда их имена отражают назначение, а не являются случайным набором символов (например, "Extension1" → "ИнтеграцияСККМ").

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

⚠️ Внимание: Если расширение используется в распределённой информационной базе (РИБ), его переименование может потребовать синхронизации изменений на всех узлах. Перед началом работ убедитесь, что у вас есть актуальные резервные копии всех связанных баз.

Способ 1: Переименование через конфигуратор (рекомендуемый метод)

Самый безопасный и универсальный способ — использование встроенных инструментов конфигуратора. Он подходит для большинства сценариев и минимизирует риск ошибок. Вот пошаговая инструкция:

1. Откройте базу в режиме Конфигуратор (с правами администратора).
2. В дереве объектов конфигурации найдите ветку Расширения и выделите нужное расширение.
3. Кликните по нему правой кнопкой мыши и выберите пункт Переименовать (или нажмите F2).
4. Введите новое имя, соблюдая правила:
   • Допустимы только латинские буквы, цифры и символ подчёркивания (_).
   • Имя не должно начинаться с цифры.
   • Максимальная длина — 128 символов.
   • Зарезервированные слова (например, And, Or) использовать нельзя.
5. Подтвердите изменение. Система автоматически обновит все ссылки на расширение в конфигурации.
6. Сохраните конфигурацию (Ctrl+S) и обновите базу данных (Конфигурация → Обновить конфигурацию базы данных).

Создать резервную копию базы|Закрыть все сеансы пользователей|Проверить отсутствие блокировок|Отключить фоновые задания|Убедиться в наличии прав администратора-->

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

• 🔗 Подписки на события других объектов.
• 📊 Отчёты или обработки с жёстко прописанными ссылками.
• 🔌 Интеграции с внешними системами (например, через HTTP-сервисы).

⚠️ Внимание: Если расширение подключено к системе контроля версий (например, Git или 1С:Сервер хранилищ), переименование приведёт к потере истории изменений для этого объекта. В таком случае лучше создать новое расширение с нужным именем и перенести в него код старого.

Способ 2: Программное переименование (для опытных пользователей)

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

Используйте следующий код в консоли отладки (Отладка → Консоль) или в отдельной обработке:

// Получаем ссылку на расширение по старому имени
Расширение = Конфигурация.Расширения.НайтиПоИмени("СтароеИмяРасширения");

// Проверяем, что расширение найдено
Если Расширение = Неопределено Тогда
Сообщить("Расширение не найдено!", СтатусСообщения.Важное);
Возврат;
КонецЕсли;

// Меняем имя
Расширение.Имя = "НовоеИмяРасширения";

// Сохраняем конфигурацию
Конфигурация.Записать();
Сообщить("Расширение успешно переименовано!", СтатусСообщения.Информация);

Особенности этого метода:

• 🔒 Требует монопольного режима работы с базой.
• 🔄 Не обновляет автоматически ссылки в других объектах (например, в коде, где явно указано старое имя).
• 📝 После выполнения необходимо вручную обновить конфигурацию базы данных.

Для массового переименования можно модифицировать код, добавив цикл по коллекции расширений:

Для Каждого Расширение Из Конфигурация.Расширения Цикл
Если НачалоСтроки(Расширение.Имя, "Префикс_") Тогда
Расширение.Имя = СтрЗаменить(Расширение.Имя, "Префикс_", "НовыйПрефикс_");
КонецЕсли;
КонецЦикла;

💡

Перед выполнением программного переименования откройте журнал регистрации (Администрирование → Журнал регистрации) и включите запись событий конфигуратора. Это поможет отследить возможные ошибки, если что-то пойдёт не так.

Способ 3: Ручное редактирование файлов конфигурации (для экспертов)

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

• 🔧 Конфигуратор не запускается из-за ошибок.
• 📂 Нужно переименовать расширение в файловом хранилище (например, для переноса между базами).
• 🔍 Требуется массовая замена имён в нескольких конфигурациях.

Алгоритм действий:

1. Закройте все сеансы 1С:Предприятия, работающие с этой базой.
2. Сделайте резервную копию каталога базы данных (или файла 1Cv8.1CD для файловых баз).
3. Откройте каталог конфигурации в файловом менеджере. Путь зависит от типа базы:
   • Для файловой базы: [Каталог базы]\1Cv8Log\ (внутри будут файлы с расширением .epf для расширений).
   • Для клиент-серверной базы: файлы хранятся на сервере в каталоге информационной базы (путь указывается в параметрах кластера).
4. Найдите файл расширения (имя файла соответствует имени расширения с расширением .epf или .epftmp для временных файлов).
5. Переименуйте файл, соблюдая те же правила, что и для имени в конфигураторе.
6. Откройте базу в конфигураторе — система обнаружит изменение и предложит обновить конфигурацию.

Тип базы	Путь к файлам расширений	Особенности
Файловая	[Каталог базы]\1Cv8Log\Extensions\	Файлы имеют расширение .epf. Имя файла = имя расширения.
Клиент-серверная (PostgreSQL)	[Каталог кластера]\data\ibases\[ИД базы]\	Файлы хранятся в бинарном виде. Редактирование не рекомендуется.
Клиент-серверная (MS SQL)	Хранится в таблице Config базы данных	Редактирование возможно только через SQL-запросы.
Удалённое хранилище (1С:Сервер хранилищ)	Централизованное хранилище на сервере	Переименование требует прав администратора хранилища.

⚠️ Внимание: При ручном редактировании файлов клиент-серверных баз (особенно на MS SQL или PostgreSQL) высок риск повреждения конфигурации. Если вы не уверены в своих действиях, используйте первые два способа или обратитесь к специалисту.

Через конфигуратор|Программно (код 1С)|Ручное редактирование файлов|Не переименовывал никогда-->

Что делать, если после переименования расширение перестало работать

Даже при корректном переименовании могут возникать ошибки. Вот типичные проблемы и способы их решения:

• 🔴 Ошибка "Не найден объект метаданных":

  Причина: В коде других объектов (модулях, запросах) жёстко прописано старое имя расширения.

  Решение: Выполните глобальный поиск (Ctrl+Shift+F) по старому имени и замените все вхождения на новое. Обратите внимание на:

  • Вызов методов расширения (например, Расширения.СтароеИмя.МойМетод()).
  • Ссылки в запросах (ВЫБРАТЬ Расширения.СтароеИмя.МойОтчёт).
  • Подписки на события (ПодписатьсяНаСобытие("СтароеИмя.Событие", ...)).
• 🔴 Ошибка при обновлении базы данных:

  Причина: Конфликт версий конфигурации или повреждение метаданных.

  Решение: Выполните Тестирование и исправление (Администрирование → Тестирование и исправление) с галочками:

  • 🗹 Реиндексация таблиц базы данных.
  • 🗹 Проверка логической целостности.
  • 🗹 Проверка ссылочной целостности.
• 🔴 Исчезли данные расширения:

  Причина: При ручном редактировании файлов могли быть удалены критические секции.

  Решение: Восстановите расширение из резервной копии или создайте новое с тем же функционалом.

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

Используйте регулярное выражение для поиска:

Расширения\.СтароеИмя|Расширения\[["']СтароеИмя["']\]

Это поможет найти как точечные обращения (Расширения.СтароеИмя.Метод()),

так и динамические (Расширения["СтароеИмя"]).

Если проблема не решена, проверьте:

1. Наличие зависимостей между расширениями (в свойствах расширения есть вкладка Зависимости).
2. Правильность прав доступа (расширение может быть недоступно текущему пользователю).
3. Совместимость версий платформы (некоторые методы расширений могут быть недоступны в старых релизах).

Нюансы работы с расширениями в распределённых базах (РИБ)

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

Алгоритм для РИБ:

1. Выполните переименование на главном узле (см. способы 1 или 2).
2. Экспортируйте изменённое расширение в файл (.epf) через конфигуратор.
3. Импортируйте этот файл на все дочерние узлы, заменив старое расширение.
4. Выполните полную синхронизацию РИБ (Администрирование → Распределённые информационные базы → Синхронизировать).
5. Проверьте отсутствие конфликтов в журнале синхронизации.

Особенности для РИБ:

• 🔄 Если расширение используется в правилах обмена, их также нужно обновить.
• 📡 При большом количестве узлов удобнее автоматизировать импорт через скрипт.
• 🔒 На время синхронизации рекомендуется заблокировать работу пользователей на дочерних узлах.

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

Как избежать типичных ошибок при переименовании

Опыт показывает, что большинство проблем возникает из-за несоблюдения простых правил. Вот чек-лист для безопасного переименования:

Создана резервная копия базы|Закрыты все пользовательские сеансы|Проверены зависимости от других расширений|Новое имя соответствует правилам синтаксиса|Тестирование запланировано на нерабочее время-->

Распространённые ошибки и как их избежать:

• 🚫 Использование кириллицы или пробелов в имени:

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

  • Экспорте/импорте между базами с разными кодировками.
  • Работе с Git или другими системами контроля версий.
  • Выполнении SQL-запросов к метаданным.

  ✅ Решение: Используйте только латиницу, цифры и _ (например, SalesReports_2026 вместо Отчёты по продажам 2026).

• 🚫 Переименование без обновления ссылок в коде:

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

  ✅ Решение: Используйте глобальный поиск (Ctrl+Shift+F) по старому имени и замените все вхождения. Для динамических ссылок (например, через Расширения[Имя]) может потребоваться ручная правка.

• 🚫 Игнорирование зависимостей:

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

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

Для сложных конфигураций с большим количеством расширений рекомендуется:

• 📝 Вести журнал изменений, где фиксировать все переименования.
• 🔄 Использовать систему контроля версий (например, Git с 1С:EDT или 1С:Сервер хранилищ).
• 🧪 Тестировать изменения на копии рабочей базы перед применением на продуктивной системе.
💡

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

FAQ: Частые вопросы по переименованию расширений 1С

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

Да, но это приведёт к потере истории изменений для этого расширения в хранилище. Лучше создать новое расширение с нужным именем, перенести в него код старого, а старое удалить. Так вы сохраните историю коммитов.

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

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

Как переименовать расширение, если конфигуратор не открывается из-за ошибок?

В этом случае можно попробовать:

1. Запустить конфигуратор в безопасном режиме (с зажатой клавишей Shift).
2. Использовать утилиту chdbfl.exe для восстановления целостности базы (chdbfl.exe /F [путь к файлу базы]).
3. Применить способ 3 (ручное редактирование файлов), но только если вы уверены в своих действиях.

Если ничего не помогает, восстановите базу из резервной копии или обратитесь в службу поддержки 1С.

Нужно ли переименовывать файлы расширений (.epf) при экспорте/импорте?

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

Как переименовать расширение в облачной версии 1С (1С:Fresh)?

В 1С:Fresh прямого доступа к конфигуратору нет, поэтому переименовать расширение можно только:

• Через личный кабинет (раздел "Настройки конфигурации"), если такая опция доступна для вашего тарифа.
• Обратившись в техническую поддержку 1С:Fresh с запросом на переименование.
• Экспортировав конфигурацию локально, переименовав расширение и загрузив её обратно (если разрешено тарифом).

Уточните актуальные ограничения в документации вашего тарифа 1С:Fresh.