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