Подключаем файл .cfe к базе: три способа установки расширения конфигурации
Содержание
Чтобы добавить расширение
в 1С:Предприятие 8.3, откройте базу под администратором, перейдите в Администрирование → Печатные формы, отчеты и обработки → Расширения, нажмите «Добавить из файла» и выберите файл .cfe. После этого перезапустите программу — расширение начнёт работать со следующего сеанса.
Типичная ситуация: программист прислал файл с доработкой печатной формы, а бухгалтер не знает, куда его «положить». Ниже — установка без Конфигуратора, через Конфигуратор и из командной строки, плюс разбор ошибок, из-за которых расширение не применяется.
Расширение конфигурации: что это и когда его ставят
Расширение — это отдельный пакет доработок, который накладывается на типовую конфигурацию , не меняя её. Механизм появился в платформе 8.3.6 и с тех пор стал основным способом дорабатывать типовые решения.
Главный плюс: конфигурация остаётся «на поддержке». Обновления от фирмы 1С ставятся как обычно, без ручного сравнения и объединения.
Чем обычно бывает расширение:
- 🖨️ новая или изменённая печатная форма — счёт, акт, накладная со своим макетом;
- 🧩 дополнительный реквизит, кнопка или табличная часть в документе;
- 🔁 доработка обмена с сайтом, складской программой, банком;
- 🛠️ исправление ошибки типового релиза до выхода официального обновления;
- 📊 свой отчёт, который должен быть в меню, а не открываться как внешний файл.
У каждого расширения есть свойство «Назначение»: исправление, адаптация или дополнение. От него зависит порядок применения, если расширений в базе несколько. Пользователю это поле менять не нужно — его задаёт разработчик.
Где взять файл расширения и как проверить источник
Расширение распространяется одним файлом с расширением .cfe. Источников обычно три:
| Источник | Пример | На что смотреть |
|---|---|---|
| Ваш программист или обслуживающая фирма | Доработка под конкретную задачу | Для какой конфигурации и релиза сделано |
| Разработчик тиражного решения | Модуль интеграции, отраслевая надстройка | Совместимость с вашей версией конфигурации |
| Открытые каталоги и форумы | Бесплатные печатные формы | Кто автор, есть ли исходники и отзывы |
Расширение выполняет код внутри вашей базы. Если снять с него безопасный режим, код получает доступ к файлам, сети и внешним компонентам. Не ставьте в рабочую базу расширения от неизвестных авторов, особенно если они просят отключить защиту.
Перед установкой уточните у автора три вещи: под какую конфигурацию и релиз собран файл, меняет ли расширение структуру данных (добавляет свои справочники, реквизиты, регистры) и нужен ли ему небезопасный режим.
Подготовка к установке: версия платформы, права и копия базы
Версия платформы и конфигурации
Откройте Справка → О программе (или значок «i» в правом верхнем углу). Там видны номер платформы и релиз конфигурации.
Расширение собирается в определённом режиме совместимости. Если он выше, чем у вашей конфигурации, расширение не применится. Сравнивайте релиз из «О программе» с тем, что указал разработчик: номер вашего релиза должен быть не ниже требуемого.
Права пользователя
Добавлять расширения может пользователь с полными правами или с правом «Администрирование расширений конфигурации». Под обычной ролью бухгалтера команды добавления в списке не будет.
Если кнопка «Добавить из файла» неактивна или её нет, первым делом проверьте права, а уже потом ищите проблему в файле.
Файловая или серверная база
В файловой базе расширение, которое меняет структуру данных, лучше ставить, когда остальные пользователи вышли из программы. Иначе обновление структуры может не пройти из-за открытых сеансов, и платформа попросит повторить позже.
В клиент-серверной базе расширение применяется ко всем, кто зайдёт после установки. Те, кто уже работает, продолжают в старом сеансе до перезапуска. Для крупных доработок удобно ставить расширение вечером и утром попросить всех перезайти.
Распределённая база
Если у вас РИБ с филиалами, решите заранее, нужно ли расширение в узлах. Расширение с флажком «Использовать в распределённой ИБ» ставится в центральной базе и уходит в подчинённые узлы с обменом. Без флажка его придётся добавлять в каждый узел отдельно.
Резервная копия
Расширение, которое добавляет свои объекты, меняет структуру базы. Перед установкой такого расширения в рабочую базу сделайте копию: в файловой — выгрузку .dt или копию каталога базы, в клиент-серверной — бэкап СУБД.
Сначала поставьте расширение в копию базы и проверьте, что печать и проведение документов работают. В рабочую базу — только после этого.
Как установить расширение в 1С 8.3 из пользовательского режима
Этот способ подходит бухгалтеру и не требует Конфигуратора. Работает во всех типовых конфигурациях на библиотеке стандартных подсистем.
Шаг 1. Откройте список расширений
Путь зависит от конфигурации:
| Конфигурация | Путь меню |
|---|---|
| Бухгалтерия предприятия 3.0 | Администрирование → Печатные формы, отчеты и обработки → Расширения |
| ЗУП 3.1 | Администрирование → Печатные формы, отчеты и обработки → Расширения |
| Управление торговлей 11 | НСИ и администрирование → Печатные формы, отчеты и обработки → Расширения |
| Любая конфигурация | Все функции → Стандартные → Управление расширениями конфигурации |
Пункт Все функции включается в Сервис и настройки → Параметры: флажок «Отображать команду “Все функции”». Стандартная обработка управления расширениями есть в любой базе, даже нетиповой.
Шаг 2. Загрузите файл
- В списке расширений нажмите «Добавить из файла».
- Платформа покажет предупреждение о том, что расширения могут быть небезопасны. Подтвердите, если доверяете источнику.
- Выберите файл
.cfeна диске. - Расширение появится в списке с включённым флажком «Активно».
Шаг 3. Настройте режимы
В списке у каждого расширения есть флажки:
- ✅ Активно — расширение подключается при запуске;
- 🔒 Безопасный режим — ограничивает код расширения; снимайте только по требованию автора;
- 🛡️ Защита от опасных действий — при включённой защите пользователь получает предупреждение перед потенциально опасными операциями;
- 🌐 Использовать в распределённой ИБ — нужно, если расширение должно попасть в узлы обмена РИБ.
Шаг 4. Перезапустите программу
Расширение применяется при старте сеанса. Нажмите «Перезапустить» в форме или закройте 1С и откройте снова. Остальным пользователям тоже нужно перезайти — до этого они работают без доработки.
Установка расширения через Конфигуратор и командную строку
Конфигуратор удобнее, когда расширение нужно посмотреть, сравнить со старой версией или поставить сразу в несколько баз.
Через меню Конфигуратора
- Запустите базу в режиме «Конфигуратор» под администратором.
- Откройте
Конфигурация → Расширения конфигурации. - В открывшемся окне нажмите «Добавить» — появится пустое расширение.
- Выделите его и через меню окна выполните загрузку конфигурации из файла, указав
.cfe. Расположение команды в меню окна отличается в разных версиях платформы: ищите пункт со словами «Загрузить конфигурацию из файла ». - Откройте дерево расширения и нажмите
F7(«Обновить конфигурацию базы данных»).
Загрузка файла и обновление конфигурации базы данных — два отдельных шага. Если пропустить второй, расширение будет в Конфигураторе, но не в базе.
Пакетный запуск
Для админа, который ставит одно расширение в десяток баз, есть ключи командной строки:
"C:\Program Files\1cv8\8.3.24.1586\bin\1cv8.exe" DESIGNER /F "D:\Bases\Buh" /N "Администратор" /P "пароль" /LoadCfg "D:\ext\PechatSchet.cfe" -Extension "PechatSchet" /UpdateDBCfg -Extension "PechatSchet" /Out "D:\ext\log.txt"
Здесь /F — путь к файловой базе (для серверной используется /S "сервер\база"), -Extension — имя расширения в базе, /Out — файл журнала. Номер платформы в пути замените на свой.
Перед пакетной установкой проверьте результат в журнале из /Out. Пустой журнал без ошибок — признак успешной загрузки.
Почему расширение не применяется: типичные ошибки
Самая частая жалоба — «добавил, перезапустил, а ничего не изменилось». Разбор по симптомам:
В Конфигураторе причину отказа удобно смотреть командой проверки применимости в окне Конфигурация → Расширения конфигурации: платформа выведет список несовпадений с основной конфигурацией.
Включение, отключение, обновление и удаление расширения
Все операции выполняются в том же списке расширений, где вы его добавляли.
| Задача | Что сделать | Что учесть |
|---|---|---|
| Временно отключить | Снять флажок «Активно», перезапустить сеанс | Данные расширения сохраняются |
| Обновить до новой версии | Выделить расширение и загрузить новый .cfe поверх старого | Имя расширения должно совпадать |
| Удалить | Выделить и нажать «Удалить» | Данные из объектов расширения будут потеряны |
| Поменять порядок | Задаётся назначением расширения | Вручную не настраивается |
Обновление
При обновлении не удаляйте старое расширение и не добавляйте новое рядом. Загрузите файл поверх существующего: так сохранятся данные в реквизитах и справочниках расширения. Если удалить и поставить заново, эти данные пропадут.
Удаление
Если расширение добавляло свои справочники, реквизиты или регистры, удаление стирает всё, что в них хранилось. Перед удалением такого расширения сделайте копию базы.
Если сомневаетесь, нужно ли расширение, сначала снимите «Активно» и поработайте неделю. Ничего не сломалось — тогда удаляйте.
Исправления от фирмы 1С — тоже расширения
Типовые конфигурации на БСП умеют сами загружать исправления ошибок через интернет-поддержку. Технически это те же расширения, они видны в общем списке. Отключать и удалять их вручную не нужно: патч снимается автоматически, когда вы ставите релиз, в котором ошибка уже исправлена.
Автозагрузку исправлений настраивают в Администрирование → Интернет-поддержка и сервисы. Если вы не хотите, чтобы в базе что-то менялось без вас, загрузку можно перевести в ручной режим.
Порядок после обновления конфигурации
После установки нового релиза типовой конфигурации зайдите в список расширений и проверьте, что все они применились. Расширение, которое перестало подходить к новому релизу, платформа просто не подключит, и доработка тихо пропадёт из интерфейса.
Расширение, внешняя обработка или правка конфигурации — что выбрать
Не каждую доработку стоит оформлять расширением. Сравнение трёх подходов:
| Критерий | Расширение | Внешняя обработка / печатная форма | Правка основной конфигурации |
|---|---|---|---|
| Меняет типовые формы и модули | Да | Нет | Да |
| Добавляет свои объекты и данные | Да | Нет | Да |
| Обновление типовой | Без снятия с поддержки | Без влияния | Ручное сравнение и объединение |
| Установка | Файл .cfe, без Конфигуратора | Файл .epf/.erf, без Конфигуратора | Только Конфигуратор |
| Кто ставит | Администратор базы | Администратор базы | Программист |
Внешняя обработка годится, когда нужен отдельный отчёт или печатная форма и не надо менять поведение документа. Расширение — когда нужно вмешаться в типовую форму, добавить реквизит или поменять алгоритм проведения.
Правку основной конфигурации оставляют для глубоких изменений, которые расширением не сделать. Цена — каждое обновление превращается в работу программиста.
Пример выбора. Нужно, чтобы в счёте на оплату печатался логотип и подпись директора — хватит внешней печатной формы. Нужно, чтобы документ «Реализация» не проводился без заполненного договора — это вмешательство в проведение, его делают расширением. Нужно переписать половину учёта под отраслевую специфику — здесь уже думают о собственной конфигурации или отраслевом решении.