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