Разработка и Конфигурация · 9 мин
Как установить расширение 1С в конфигураторе
Как установить расширение 1С через конфигуратор: подготовка, подключение файла .cfe, настройки безопасности, проверка работы и типичные ошибки с решениями.
Расширение конфигурации (файл с расширением .cfe) — это механизм платформы 1С:Предприятие, который позволяет добавлять или изменять функциональность типовой конфигурации без снятия её с поддержки. Доработки, выполненные через расширение, не мешают штатному обновлению конфигурации, что делает этот способ предпочтительным по сравнению с прямым изменением объектов.
Установить расширение можно двумя путями: через конфигуратор (подходит разработчикам и администраторам) и через пользовательский режим «1С:Предприятие». Ниже разобран основной сценарий — установка через конфигуратор, а также проверка результата, настройки безопасности и типичные проблемы.
Перед началом работы убедитесь, что у вас есть файл расширения (.cfe), права администратора в информационной базе и актуальная резервная копия. Для файловой базы достаточно скопировать каталог, для клиент-серверной — сделать выгрузку через конфигуратор или средствами СУБД.
Что нужно подготовить перед установкой
Для установки расширения через конфигуратор потребуется монопольный доступ к информационной базе — все пользователи должны завершить сеансы. В файловом варианте достаточно попросить коллег выйти из программы, в клиент-серверном — можно принудительно завершить сеансы через консоль кластера или административную обработку.
Проверьте совместимость расширения с вашей версией платформы и конфигурации. Расширение, разработанное под другую версию конфигурации, может отказаться применяться или привести к ошибкам при обновлении. Обычно разработчик указывает, для каких релизов предназначен файл .cfe.
Обязательно сделайте резервную копию. Хотя расширения считаются безопасным механизмом, ошибка в коде расширения способна нарушить работу базы: вызвать ошибки при открытии форм, проведении документов или обновлении конфигурации.
Пошаговая установка расширения через конфигуратор
Запустите конфигуратор и войдите в нужную информационную базу под пользователем с правами администратора. Если база требует монопольного режима, конфигуратор сообщит об этом при попытке изменить структуру данных.
Порядок действий следующий:
- 1Откройте конфигуратор и авторизуйтесь в базе с правами администратора
- 2Перейдите в меню «Конфигурация» → «Расширения конфигурации»
- 3В открывшемся окне нажмите кнопку «Добавить» (или F4)
- 4Укажите путь к файлу .cfe и подтвердите загрузку
- 5Задайте имя и префикс расширения, при необходимости измените свойства
- 6Закройте окно расширений и обновите конфигурацию базы данных клавишей F7
- 7Запустите режим «1С:Предприятие» и проверьте работу доработки
После загрузки файла расширение появится в списке, но изменения вступят в силу только после обновления конфигурации базы данных. Если забудете нажать F7, расширение останется в списке, но не будет работать, а при следующем запуске конфигуратор напомнит о необходимости обновления.
Настройки расширения: имя, безопасность и профиль
При добавлении расширения платформа предлагает задать его свойства. Имя расширения должно быть уникальным в пределах базы и не содержать пробелов — по нему расширение идентифицируется в коде и журналах. Префикс используется для именования добавляемых объектов, чтобы они не конфликтовали с объектами основной конфигурации.
Обратите внимание на флажки «Безопасный режим» и «Защита от опасных действий». В безопасном режиме расширению запрещены операции с файловой системой, COM-объектами и внешними компонентами. Если расширение получено извне, оставляйте безопасный режим включённым, пока не убедитесь в корректности кода.
Установка через режим «1С:Предприятие» как альтернатива
Если конфигуратор по какой-то причине недоступен (например, вы работаете с облачной базой или нет монопольного доступа), расширение можно подключить из пользовательского режима. Путь: «Администрирование» → «Печатные формы, отчёты и обработки» → «Расширения» (в некоторых конфигурациях пункт называется «Дополнительные отчёты и обработки» — это другой механизм, не путайте их).
В пользовательском режиме расширение подключается без обновления конфигурации базы данных и может применяться только к текущему сеансу или ко всем сеансам. Этот способ удобен для быстрого тестирования, но для постоянной работы в клиент-серверной базе надёжнее установка через конфигуратор.
Сравнение вариантов
Подходит для постоянной установки и разработки. Требует монопольного доступа и обновления конфигурации базы данных.
Подходит для быстрого подключения без монопольного доступа. Ограниченные возможности управления, зависит от настроек функциональности конфигурации.
Проверка результата после установки
После обновления конфигурации базы данных запустите режим «1С:Предприятие» и убедитесь, что доработка работает: откройте изменённую форму, выполните добавленную команду или проверьте новый отчёт. Проверять нужно под учётной записью обычного пользователя, а не только под администратором — права могут отличаться.
Дополнительно откройте журнал регистрации («Администрирование» → «Журнал регистрации») и проверьте, нет ли ошибок, связанных с расширением, при запуске и выполнении типовых операций.
Как проверить результат
Отображается в окне «Расширения конфигурации» без пометок об ошибках
Строка подсвечена или отсутствует после перезапуска конфигуратора
Новые команды, формы или отчёты открываются и выполняются без ошибок
Ошибки вида «метод не обнаружен» или «объект не найден»
Обычные пользователи видят и используют доработку
Функции доступны только администратору
Типичные ошибки и способы их устранения
Наиболее частая проблема — конфликт расширения с обновлённой версией конфигурации. После обновления типовой конфигурации расширение может перестать применяться, если изменились объекты, на которые оно опирается. В этом случае расширение нужно доработать под новый релиз или временно отключить.
Вторая распространённая ситуация — ошибки прав доступа. Добавленные расширением объекты не попадают в существующие роли автоматически, поэтому пользователи могут не видеть новые элементы. Проверьте флажок «Использовать в основных ролях» или настройте роли вручную.
Как отключить или удалить расширение
Если расширение вызывает проблемы, его не обязательно удалять — достаточно снять флажок в колонке активности в окне «Расширения конфигурации» и обновить конфигурацию базы данных. Доработка перестанет действовать, но файл и настройки сохранятся, что удобно для диагностики.
Для полного удаления выделите расширение в списке и нажмите кнопку удаления, затем снова обновите конфигурацию базы данных. Перед удалением убедитесь, что другие доработки или расширения не ссылаются на объекты удаляемого.
Что важно запомнить
Установка расширения сводится к четырём шагам: резервная копия, загрузка .cfe через «Конфигурация» → «Расширения конфигурации», обновление конфигурации базы данных и проверка под обычным пользователем. Для файлов из внешних источников сохраняйте безопасный режим включённым.
Частые вопросы
Можно ли установить расширение без монопольного доступа?
Через конфигуратор — нет, обновление конфигурации базы данных требует монопольного режима. Однако подключить расширение без монопольного доступа можно в режиме «1С:Предприятие» через раздел «Администрирование», если в конфигурации включена соответствующая функциональность.
Чем расширение отличается от внешней обработки?
Внешняя обработка (.epf) запускается вручную или по расписанию и не изменяет конфигурацию. Расширение (.cfe) встраивается в конфигурацию: может изменять формы, добавлять подсистемы, роли и переопределять обработчики типовых объектов, работая постоянно для всех пользователей.
Что делать, если после обновления конфигурации расширение перестало работать?
Откройте окно расширений в конфигураторе — проблемное расширение обычно помечено как несовместимое. Варианты: запросить у разработчика версию под новый релиз, доработать расширение самостоятельно, проверив изменившиеся объекты, или временно отключить его, сняв флажок активности.
Можно ли установить несколько расширений одновременно?
Да, количество расширений в базе не ограничено. Учитывайте, что они применяются в определённом порядке, и если два расширения изменяют один и тот же объект или метод, результат зависит от очерёдности. Порядок можно менять кнопками перемещения в окне расширений.
Как перенести расширение в другую базу?
В окне «Расширения конфигурации» выделите нужное расширение и сохраните его в файл .cfe через команду сохранения. Затем в целевой базе добавьте этот файл стандартным способом. Убедитесь, что версии конфигураций в обеих базах совместимы.
Опасно ли отключать безопасный режим у расширения?
Отключение безопасного режима разрешает расширению доступ к файловой системе, внешним компонентам и другим потенциально опасным операциям. Делайте это только для расширений из доверенных источников, код которых проверен, и только если доработка действительно требует таких возможностей.