Как редактировать расширение 1С в формате CFE

Расширение конфигурации 1С в формате CFE — это файл, который содержит доработки типовой конфигурации без изменения самой конфигурации поставщика. Через расширение добавляют печатные формы, дополнительные реквизиты, роли, подписки на события и изменённые алгоритмы, не снимая основную базу с поддержки. Редактировать CFE нужно в конфигураторе 1С, загрузив его в базу или подключив к копии рабочей конфигурации.

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

Ниже разобран полный цикл: от подготовки стенда до выгрузки обновлённого файла и проверки, что доработки применились корректно.

Что такое CFE и когда его редактирование оправдано

CFE (Configuration Extension) — бинарный файл расширения, который платформа 1С накладывает поверх основной конфигурации при запуске сеанса. Внутри могут находиться заимствованные объекты (справочники, документы, общие модули, формы), собственные новые объекты и изменённые обработчики. Сам файл напрямую, как текстовый документ, не открывается — только через механизмы платформы.

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

Подготовка: стенд, копия базы и исходный файл

Перед началом работ сохраните исходный CFE-файл в отдельную папку с понятным именем и датой, например Rasshirenie_Pechat_2026-05.cfe. Это ваша точка отката: если правки окажутся неудачными, вы сможете вернуть прежнюю версию за минуту. Дополнительно полезно выгрузить из рабочей базы текущую версию расширения, даже если файл у вас уже есть, — так вы убедитесь, что редактируете именно актуальную версию.

Для правок поднимите тестовую базу: файловую копию рабочей базы или отдельную базу на сервере. В файловом варианте достаточно скопировать каталог с файлом 1Cv8.1CD. Убедитесь, что версия платформы на стенде совпадает с рабочей — расширение, созданное на другой версии платформы, может отказаться загружаться или повести себя иначе.

Загрузка CFE в конфигуратор

Откройте тестовую базу в конфигураторе под пользователем с правами администратора. Перейдите в меню Конфигурация → Расширения конфигурации. Если расширение уже подключено к базе, выделите его в списке; если нет — добавьте новое через кнопку «Создать» или команду загрузки из файла.

Для загрузки из файла используйте команду «Загрузить из файла» и укажите путь к CFE. Платформа может запросить пароль, если расширение защищено — без пароля редактирование будет недоступно. После загрузки в дереве конфигурации появится ветка расширения, где видны заимствованные и собственные объекты.

1. 1
   Откройте тестовую базу в конфигураторе
2. 2
   Меню: Конфигурация → Расширения конфигурации
3. 3
   Создайте новое расширение или выберите существующее
4. 4
   Выполните «Загрузить из файла» и укажите CFE
5. 5
   Введите пароль, если расширение защищено
6. 6
   Убедитесь, что ветка расширения появилась в дереве конфигурации

Внесение изменений: код, формы, объекты

Редактирование объектов расширения почти не отличается от работы с основной конфигурацией. Двойной щелчок по объекту открывает его свойства, модули и формы. В модулях заимствованных объектов доступны аннотации &ИзменениеИКонтроль, &Вместо, &Перед, &После — они определяют, как ваш код сочетается с типовым обработчиком.

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

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

Проверка применимости и тестирование

После правок выполните проверку расширения: в окне расширений конфигурации есть команда проверки применимости, а также полезна общая проверка конфигурации (Конфигурация → Проверка конфигурации) с отмеченным флагом проверки расширений. Платформа покажет ошибки: ссылки на удалённые объекты, нарушения контроля заимствованных методов, конфликты имён.

Затем обновите конфигурацию базы данных (F7) и запустите тестовую базу в режиме предприятия. Пройдите по сценариям, которые затрагивает доработка: откройте изменённый документ, сформируйте печатную форму, проверьте работу под пользователем с ограниченными правами, а не только под администратором. Многие ошибки расширений всплывают именно на неполных правах.

Контрольные точки

Как проверить результат

Проверка применимости в конфигураторе

Норма

Ошибок и предупреждений нет

Тревожный признак

Сообщения о нарушении контроля или отсутствующих объектах

Запуск в режиме предприятия

Норма

Изменённые объекты открываются, код выполняется

Тревожный признак

Ошибки при открытии форм или выполнении операций

Работа под ограниченными правами

Норма

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

Тревожный признак

Нарушение прав доступа у обычных пользователей

Выгрузка обратно в CFE и перенос в рабочую базу

Когда тесты пройдены, выгрузите расширение: в окне расширений конфигурации выберите его и выполните «Сохранить в файл», указав новое имя файла. Сохраните и старую, и новую версии — история версий расширения избавит от многих проблем при откате.

В рабочей базе загрузка выполняется тем же путём: Конфигурация → Расширения конфигурации → Загрузить из файла. Выберите момент, когда в базе минимум активных пользователей, заранее предупредите их о кратковременном обновлении. После загрузки убедитесь, что у расширения установлен флаг «Используется», и попросите пользователей перезапустить сеансы — изменения подхватываются при новом подключении.

Частые проблемы и их решение

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

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

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

FAQ

Можно ли открыть CFE без конфигуратора 1С?

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

Что делать, если расширение защищено паролем, а пароль утерян?

Восстановить пароль штатными средствами нельзя. Если исходников нет, потребуется разрабатывать расширение заново. Поэтому пароли к расширениям стоит хранить вместе с исходными файлами в ответственном хранилище.

Чем CFE отличается от CF?

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

Почему после загрузки расширения пользователи не видят изменений?

Расширение применяется при старте сеанса. Пользователям нужно перезапустить клиент 1С. Также проверьте, что у расширения установлен флаг «Используется» и оно подключено в нужной базе, а не только в тестовой копии.

Можно ли редактировать расширение в режиме предприятия?

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

Что произойдёт с расширением при обновлении типовой конфигурации?

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