Подключаем расширение конфигурации из файла .cfe: пользовательский режим, Конфигуратор, командная строка
Содержание
Чтобы установить CFE
-файл в 1С 8.3, откройте базу в режиме Предприятия, перейдите в Администрирование → Печатные формы, отчеты и обработки → Расширения, нажмите «Добавить из файла…», выберите файл .cfe и перезапустите программу. После перезапуска расширение начнёт работать у всех, кто заново войдёт в базу. Конфигуратор для этого не нужен, хватит прав администратора.
Файл CFE — это расширение конфигурации . Его присылают разработчики, внедренцы и сервисы: доработанная печатная форма, исправление ошибки типового релиза, интеграция с сайтом или банком. Порядок действий один для Бухгалтерии предприятия 3.0, ЗУП 3.1, Управления торговлей 11 и других конфигураций на Библиотеке стандартных подсистем.
Что лежит в файле .cfe и чем он отличается от .cf и .epf
Расширение — это надстройка над основной конфигурацией. Оно хранится в базе отдельно и подключается поверх типового решения, не снимая его с поддержки. Обновили Бухгалтерию до нового релиза — расширение осталось на месте, доработки сохранились.
Механизм появился в платформе 8.3.6. В последующих релизах 8.3 расширения научились добавлять собственные справочники, документы и реквизиты, а не только менять формы и модули.
Чтобы не перепутать форматы, сверьтесь с таблицей:
| Расширение файла | Что это | Как устанавливают |
|---|---|---|
.cfe | Расширение конфигурации | Список расширений в Предприятии или Конфигуратор |
.cf | Полная конфигурация | Конфигуратор: загрузка или обновление конфигурации |
.cfu | Файл обновления типовой конфигурации | Конфигуратор: обновление конфигурации на поддержке |
.epf | Внешняя обработка | Дополнительные отчеты и обработки или «Файл → Открыть» |
.erf | Внешний отчёт | Так же, как обработка |
.dt | Выгрузка всей информационной базы | Конфигуратор: загрузка информационной базы |
Файл .cf нельзя «установить как расширение», а .cfe нельзя загрузить вместо основной конфигурации. Если разработчик прислал .cf и сказал «это доработка», уточните, что именно он имел в виду: загрузка .cf в рабочую базу заменит всю конфигурацию.
Что обычно делают через расширения:
- 🖨️ меняют печатные формы: счёт, акт, УПД с логотипом и подписью;
- 🛠️ закрывают ошибки типового релиза до выхода исправления от фирмы 1С;
- 🔗 подключают обмен с сайтом, маркетплейсом, банком или складской системой;
- ➕ добавляют реквизиты в документы и справочники, новые отчёты и команды;
- 🔒 ограничивают действия пользователей, которых нет в типовых правах.
Подготовка перед установкой: версия, режим совместимости, копия базы
Расширение пишут под конкретную конфигурацию и её релиз. Если оно собрано под Бухгалтерию 3.0.1xx, а у вас старый релиз, подключение может завершиться ошибкой: в расширении упоминаются объекты или реквизиты, которых в вашей базе ещё нет.
Перед установкой проверьте четыре вещи.
- Конфигурацию и релиз. Откройте
Справка → О программе(кнопка с вопросительным знаком или меню-«гамбургер» в шапке). Там видны название, номер релиза и версия платформы. Сравните с тем, что указал автор расширения. - Версию платформы. Номер платформы должен быть не ниже того, под который собрано расширение. Расширение, созданное в 8.3.24, на 8.3.18 может не загрузиться из-за режима совместимости расширения.
- Режим совместимости основной конфигурации. Если конфигурация работает в режиме совместимости с 8.2 (так бывает со старыми УПП и самописными базами), расширения ей недоступны. Это проверяют в Конфигураторе в свойствах корня конфигурации.
- Права пользователя. Добавлять расширения может пользователь с полными правами или с правом администрирования расширений конфигурации. Обычному бухгалтеру команда «Добавить из файла…» не будет доступна.
Сделайте резервную копию базы до подключения расширения. Для файловой базы достаточно скопировать каталог с файлом 1Cv8.1CD при закрытой программе или выгрузить базу
в .dt через Конфигуратор. Для клиент-серверной базы — копия средствами СУБД или та же выгрузка .dt. Расширения, которые меняют структуру данных (добавляют реквизиты или таблицы), при неудачном применении проще откатить из копии, чем чистить вручную.
Попросите у разработчика список изменений в расширении и номер его версии. Через полгода, когда понадобится обновить расширение, по этому списку легко понять, какой файл сейчас стоит в базе.
Способ 1. Установить CFE через режим Предприятия
Это основной способ для бухгалтеров и администраторов баз. Пользователи могут продолжать работать: новое расширение подключится у каждого после перезапуска сеанса.
- Войдите в базу под администратором в обычном режиме (не в Конфигураторе).
- Откройте
Администрирование → Печатные формы, отчеты и обработки. - Перейдите по ссылке «Расширения». Откроется список уже подключённых расширений.
- Нажмите «Добавить из файла…» и укажите файл
.cfeна диске. - Платформа покажет предупреждение о том, что расширения из ненадёжных источников опасны. Если файл от проверенного автора — подтвердите.
- Расширение появится в списке. Нажмите «Перезапустить» в сообщении внизу или закройте и снова откройте программу.
Если в разделе Администрирование нет нужной ссылки (бывает в самописных и сильно переделанных базах), откройте список расширений штатной командой платформы: меню-«гамбургер» → Все функции → ветка Стандартные → «Управление расширениями конфигурации». Команда «Все функции» включается в Сервис и настройки → Параметры, флаг «Отображать команду “Все функции”».
В списке расширений у каждой строки есть флаги, которые стоит проверить сразу:
| Флаг | Что означает | Когда менять |
|---|---|---|
| Активно | Расширение применяется при входе в базу | Снимите, чтобы временно отключить расширение без удаления |
| Безопасный режим | Код расширения не может работать с файлами, внешними компонентами и COM | Снимают, только если автор прямо требует и вы ему доверяете |
| Защита от опасных действий | Платформа предупреждает о потенциально опасных операциях | Обычно оставляют включённым |
| Передавать в подчинённые узлы РИБ | Расширение уходит в периферийные базы распределённой ИБ | Включают, если у вас есть узлы и расширение нужно там |
Расширения для обмена с внешними сервисами часто не работают в безопасном режиме: им нужен доступ к файлам или интернету. Снимайте флаг «Безопасный режим» только для файлов от известного разработчика. Код без ограничений может читать и менять любые данные базы.
Способ 2. Загрузить расширение через Конфигуратор
Через Конфигуратор расширения ставят разработчики и администраторы, когда нужно посмотреть содержимое, сравнить с предыдущей версией или подключить расширение к базе без входа в Предприятие.
- Запустите базу в режиме «Конфигуратор».
- Откройте меню
Конфигурация → Расширения конфигурации. - В окне списка нажмите «Добавить», задайте имя нового расширения. Имя лучше взять такое же, как у автора, — так проще обновлять.
- Выделите созданное расширение и через меню команд окна («Еще» или «Конфигурация») выберите загрузку конфигурации из файла, укажите
.cfe. - Откроется дерево объектов расширения. Выполните
Конфигурация → Обновить конфигурацию базы данных(клавишаF7) именно для этого расширения.
Загрузка файла и обновление конфигурации
базы данных — два отдельных шага. Пока вы не нажали F7, расширение лежит в Конфигураторе, но пользователи его не видят.
Если расширение с таким именем уже есть, загрузка из файла заменит его содержимое. Перед этим сохраните текущую версию: выделите расширение и выберите сохранение в файл. Получится .cfe, к которому можно вернуться.
В Конфигураторе удобно сравнить старую и новую версию расширения: откройте расширение и выберите сравнение с конфигурацией из файла. Видно, какие формы и модули поменял разработчик.
Способ 3. Пакетная загрузка из командной строки
Когда расширение нужно поставить в 10–20 баз одной организации или встроить в регламентный скрипт, удобна пакетная загрузка через 1cv8.exe. Используются два параметра режима DESIGNER: /LoadCfg с ключом -Extension и /UpdateDBCfg с тем же ключом.
Пример для файловой базы:
"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" DESIGNER /F"D:\Bases\Buh" /N"Администратор" /P"пароль" /LoadCfg "D:\Ext\PechForm.cfe" -Extension "PechForm" /UpdateDBCfg -Extension "PechForm" /Out "D:\Ext\log.txt"
Для клиент-серверной базы вместо /F указывают /S"сервер\имя_базы". Путь к 1cv8.exe подставьте свой: номер каталога совпадает с установленной версией платформы.
Что важно в этой команде:
- 📄
/Outпишет протокол в файл — без него вы не узнаете, почему загрузка не прошла; - 🏷️ имя после
-Extensionдолжно совпадать с именем расширения в базе, иначе появится второе расширение рядом с первым; - 🔑 пароль в открытом виде в bat-файле — риск: держите такие скрипты в каталоге с ограниченным доступом.
Для серверных баз на платформе 8.3.14 и новее есть утилита ibcmd, которая работает с базой без запуска Конфигуратора и тоже умеет управлять расширениями. Состав её команд меняется от версии к версии, поэтому параметры смотрите в справке ibcmd help для вашей сборки.
Ошибки при подключении CFE и что с ними делать
Ниже симптомы, которые встречаются чаще всего. Тексты сообщений платформы могут немного различаться между версиями, но смысл узнаваем.
Отдельная история — ошибки после обновления типовой конфигурации. Расширение раньше работало, а после установки нового релиза выдаёт ошибку применения. Причина та же: в релизе поменялся объект, который расширение дорабатывало. Разработчик в Конфигураторе проверяет расширение на совместимость с новой версией основной конфигурации и исправляет заимствованные объекты. До выхода исправленной версии расширение лучше отключить, чем откатывать обновление.
Если вы обновляете типовую конфигурацию в клиент-серверной базе, после обновления все пользователи должны перезайти. Проверку расширений делайте в нерабочее время: сеансы, открытые со старой версией, при перезапуске получат новую комбинацию «конфигурация + расширение».
Особенности для файловых, серверных, облачных и распределённых баз
Сам механизм расширений одинаков во всех вариантах работы 8.3, но некоторые детали различаются.
- 💾 Файловая база. Расширение применяется у каждого пользователя при следующем входе. Если программа открыта на нескольких компьютерах, перезапустить нужно все копии.
- 🖥️ Клиент-серверная база. То же самое, но пользователей бывает много. Добавить расширение можно в рабочее время, а попросить всех перезайти — в удобный момент.
- ☁️ Облако (1С:Фреш и похожие сервисы). В разделённых базах у расширения есть область действия: на всю информационную базу или на одну область данных. Права на загрузку собственных расширений обычно ограничены, их ставят через менеджер сервиса или по заявке в поддержку провайдера.
- 🔄 Распределённая база (РИБ). Расширение ставят в главном узле и включают флаг «Передавать в подчинённые узлы РИБ». Ставить тот же файл вручную в каждом узле не нужно — получите дубли.
- 📱 Мобильные и веб-клиенты. Отдельной установки не требуют: расширение живёт в базе, а не на компьютере пользователя.
Для 1С 8.2 и 7.7 файлов .cfe не существует. Доработки в таких базах вносят прямо в конфигурацию или подключают как внешние обработки.
Проверка, обновление и удаление установленного расширения
Как убедиться, что расширение работает
После перезапуска проверьте результат на трёх уровнях.
- Список расширений. В
Администрирование → Печатные формы, отчеты и обработки → Расширениястрока должна быть с включённым флагом «Активно» и без пометки об ошибке. Здесь же видна версия расширения, если автор её заполнил. - Функция, ради которой ставили. Откройте документ, у которого должна появиться печатная форма, команда или реквизит. Проверка на живом объекте надёжнее любого списка.
- Журнал регистрации.
Администрирование → Обслуживание → Журнал регистрации, отбор по уровню «Ошибка» за последние полчаса. Ошибки применения расширения и исключения в его коде появятся именно здесь.
Если расширение добавляет новые реквизиты или таблицы, проверьте и сохранение данных: заполните новый реквизит, запишите документ, откройте его заново. Значение должно остаться на месте.
Как отключить, обновить или удалить расширение
Рано или поздно расширение понадобится заменить. Здесь всё делается в том же списке расширений.
- ⏸️ Отключить временно: снимите флаг «Активно» и перезапустите сеанс. Данные, которые расширение добавило, останутся в базе.
- 🔁 Обновить на новую версию: выделите строку и выберите замену из файла через меню списка. Не добавляйте новую версию отдельной строкой — два одинаковых расширения конфликтуют.
- 🗑️ Удалить: кнопка «Удалить» в списке. Если расширение хранило свои реквизиты или справочники, их данные удалятся вместе с ним.
Удаление расширения со своими данными необратимо без резервной копии. Прежде чем удалить расширение, которое добавляло реквизиты, выгрузите базу в .dt или сохраните нужные значения отчётом.