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