Файл .cfe в 1С: загрузка расширения, права и обновление

Файл CFE в 1С ставится за пару минут: в БП 3.0 и ЗУП 3.1 откройте Администрирование → Печатные формы, отчеты и обработки → Расширения, нажмите «Добавить из файла», выберите .cfe и перезапустите программу. Конфигуратор для этого не нужен, а снимать конфигурацию с поддержки не придётся.

Типичная ситуация: франчайзи или программист присылает файл Исправление_печати.cfe и пишет «установите и настройте». Сама загрузка — минута работы. Время уходит на другое: проверить, под какой релиз сделан файл, дать права, решить вопрос с безопасным режимом и не забыть про перезапуск у пользователей. Если баз десяток, удобнее поставить расширение скриптом.

Что такое CFE и что подготовить до установки

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

Главный плюс: типовая остаётся на полной поддержке и обновляется штатно. Доработки живут отдельно и подключаются поверх.

Чем CFE отличается от похожих файлов:

Что проверить до загрузки:

• 🧾 Для какой конфигурации и релиза сделан файл. Расширение опирается на объекты типовой по именам. Если в вашем релизе объект переименован или удалён, расширение не применится.
• 🖥 Версия платформы. Файл, сохранённый в более новой платформе, может не загрузиться в старую. Номер вашей платформы — в окне Справка → О программе. Он должен быть не ниже того, что указал разработчик.
• 🔐 Источник файла. Расширение исполняет код на сервере. Ставьте только файлы от того, кого знаете.
• 💾 Резервная копия. Расширение, которое добавляет свои реквизиты и таблицы, меняет структуру базы. Перед первой установкой сделайте копию базы — выгрузку .dt или бэкап СУБД.
• 👥 Окно для работы. После подключения пользователям нужно перезапустить программу, чтобы расширение у них заработало. Договоритесь о времени заранее.

Как установить CFE в 1С из пользовательского режима

Это основной способ для бухгалтера или администратора без навыков разработки. Он работает в конфигурациях на Библиотеке стандартных подсистем: БП 3.0, ЗУП 3.1, УТ 11, КА, ERP, УНФ.

Где находится список расширений

Если меню «Все функции» не видно, включите его: Сервис и настройки → Параметры → Отображать команду "Все функции". Стандартная обработка «Управление расширениями конфигурации» есть в любой конфигурации на 8.3, включая самописные.

Порядок установки

1. Откройте список расширений по пути из таблицы.
2. Нажмите «Добавить из файла» и выберите файл .cfe.
3. Программа предупредит, что расширения стоит брать только из надёжных источников. Подтвердите.
4. Расширение появится в списке. Проверьте, что оно включено (флажок использования в строке).
5. Если расширению нужны операции вне безопасного режима (работа с файлами, внешние компоненты, COM), снимите флажок «Безопасный режим». Разработчик обычно пишет об этом в инструкции.
6. Перезапустите программу. Остальные пользователи увидят расширение после своего перезапуска.

Как обновить уже установленное расширение

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

Установка расширения CFE через Конфигуратор

Конфигуратор нужен, когда расширение надо посмотреть, поправить или когда у пользователя нет прав на администрирование в рабочем режиме.

1. Запустите базу в режиме «Конфигуратор» под администратором.
2. Откройте Конфигурация → Расширения конфигурации.
3. Нажмите «Добавить», задайте имя и префикс. Имя лучше взять то, что указал разработчик: оно используется в командах автоматизации.
4. Выделите новое расширение и в меню «Конфигурация» этого окна выберите загрузку конфигурации из файла. Укажите .cfe.
5. Согласитесь с заменой содержимого расширения.
6. Откройте дерево расширения и выполните «Обновить конфигурацию базы данных» (F7) — для расширения это отдельный шаг, загрузка файла сама его не делает.
7. Закройте Конфигуратор и проверьте работу в пользовательском режиме.

Свойства расширения (палитра свойств, вызывается двойным щелчком по корню дерева расширения) показывают его назначение — «Исправление», «Адаптация» или «Дополнение» — и режим совместимости. Режим совместимости расширения не должен быть новее, чем у основной конфигурации.

Права пользователей и безопасный режим расширения

Добавлять и отключать расширения может пользователь с правом «Администрирование» или отдельным правом «Администрирование расширений конфигурации». В типовых БП и ЗУП это профиль «Администратор». Обычный бухгалтер кнопки «Добавить из файла» не увидит или получит отказ.

Дальше — две настройки, которые чаще всего путают:

• 🛡 Безопасный режим. Код расширения выполняется с ограничениями: нельзя работать с файловой системой, запускать внешние приложения, подключать внешние компоненты. Для расширений, которые меняют печатные формы или добавляют реквизиты, этого обычно хватает. Для обменов, загрузки файлов, интеграций — нет.
• ⚔️ Защита от опасных действий. Отдельный механизм: при попытке опасной операции пользователь получает предупреждение. Это не то же самое, что безопасный режим.

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

Как расширение встраивается в работу платформы 1С:Предприятие

После установки расширение подключается при каждом запуске сеанса. Отсюда несколько практических следствий.

Нужен перезапуск. Уже открытые сеансы продолжают работать без расширения. Это нормально, а не ошибка установки.

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

1. Перед обновлением типовой узнайте у автора, совместимо ли расширение с новым релизом.
2. Обновите конфигурацию.
3. Проверьте список расширений: нет ли сообщений об ошибках применения.
4. При необходимости загрузите новую версию .cfe.

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

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

Облако и разделение данных. В сервисах вроде 1С:Фреш расширения ставятся через средства сервиса. Возможности установки своего файла там зависят от тарифа и правил провайдера.

Ошибки при загрузке CFE и как их устранить

Если база после установки не запускается, откройте её в Конфигураторе, отключите или удалите расширение в окне Конфигурация → Расширения конфигурации и запустите программу снова. Типовая конфигурация при этом не пострадает: расширение лежит отдельно от неё.

Автоматическая установка и обновление CFE

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

Пример .bat для файловой базы:

@echo off
set V8="C:\Program Files\1cv8\8.3.24.1586\bin\1cv8.exe"
set BASE=C:\Bases\Buh
set CFE=C:\Ext\Pechat.cfe
set EXT=Pechat

%V8% DESIGNER /F"%BASE%" /N"Администратор" /P"" ^
  /LoadCfg "%CFE%" -Extension %EXT% ^
  /UpdateDBCfg -Extension %EXT% ^
  /Out "C:\Ext\log_%EXT%.txt"

Для клиент-серверной базы вместо /F"путь" указывается /S"сервер\имя_базы". Путь к 1cv8.exe замените на свою версию платформы, а пароль администратора не держите в открытом виде в общем каталоге.

Что учесть:

• 🏷 Имя в параметре -Extension должно совпадать с именем расширения в базе. Если такого расширения нет, оно будет создано.
• 📄 Смотрите лог из /Out: при ошибке пакетный режим не показывает окон, всё пишется в файл.
• ⏰ Запускайте скрипт вне рабочего времени. Пользователям потом всё равно нужен перезапуск, а изменение структуры расширения может потребовать завершения их сеансов.

Второй путь — программный, из встроенного языка. Его используют в своих обработках для раздачи расширений по базам:

ДанныеФайла = Новый ДвоичныеДанные("C:\Ext\Pechat.cfe");
Расширение = РасширенияКонфигурации.Создать();
Расширение.БезопасныйРежим = Истина;
Расширение.Записать(ДанныеФайла);

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

Частые вопросы