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

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

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

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

Подготовка среды и открытие конфигуратора

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

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

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

Процедура переименования объекта расширения

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

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

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

Особенности работы с расширенными правами доступа

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

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

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

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

Обновление подключений и клиентских настроек

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

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

Параметр	Старое значение	Новое значение	Где изменяется
Имя расширения	OldExtensionName	NewExtensionName	Конфигуратор
Синоним	Старое Название	Новое Название	Конфигуратор
Версия	1.0.0.0	1.0.0.1	Свойства расширения
Безопасный режим	Да	Да	Настройки расширения

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

Диагностика возможных ошибок после переименования

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

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

Как очистить кэш 1С на клиенте?

Для очистки кэша закройте приложение 1С. Нажмите Win+R, введите %appdata%\1C\1cv8 и удалите содержимое папок с именами, соответствующим вашим базам данных. Также можно использовать утилиту очистки кэша, входящую в состав платформы.

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

⚠️ Внимание: Интерфейс и точные названия пунктов меню могут отличаться в зависимости от версии платформы 1С:Предприятие (8.2, 8.3, 8.3.хх) и типа используемой конфигурации. Всегда сверяйтесь с документацией к вашей конкретной версии ПО.

Финальная проверка и тестирование системы

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

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

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

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

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

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

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

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

Нужно ли менять имя файла расширения при переименовании в конфигураторе?

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

Как откатить изменения, если после переименования система не работает?

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

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

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