Подключаем файл .cfe к рабочей базе: от пользовательского режима до пакетного запуска
Содержание
Загрузить расширение в 1С можно без Конфигуратора: в БП 3.0, ЗУП 3.1 и УТ 11 откройте Администрирование → Печатные формы, отчеты и обработки → Расширения, нажмите Добавить из файла…, выберите файл .cfe и перезапустите программу. Через Конфигуратор путь другой: Конфигурация → Расширения конфигурации, добавить расширение, загрузить в него файл и обновить конфигурацию
базы данных.
Типичная ситуация: подрядчик прислал архив с доработкой печатной формы счёта, бухгалтер распаковал его, а дальше не знает, куда этот файл «вставить». Загрузка расширения конфигурации делается в два счёта, но несколько настроек решают, заработает ли оно. Механизм общий для платформы 8.3 (расширения появились в 8.3.6), инструкция подходит и пользователям, и разработчикам.
Подготовка файла .cfe перед загрузкой в 1С
Расширение приходит одним файлом с расширением .cfe. Перед загрузкой проверьте пять вещей.
- Тип файла.
.cfe— расширение..epf— внешняя обработка,.erf— внешний отчёт,.cf— целая конфигурация. Файл.cfчерез список расширений не загрузить, и загружать его «вместо» не нужно: это обновление или замена всей конфигурации. - Файл распакован. Если пришёл
.zipили.rar, сначала извлеките.cfeв обычную папку. Выбор файла прямо из окна архиватора часто заканчивается ошибкой чтения. - Размер не нулевой. Файл в несколько байт — признак оборванной загрузки из почты или мессенджера. Попросите прислать заново.
- Совместимость. Уточните у автора, для какой конфигурации и какого релиза сделано расширение и с какой версией платформы оно проверено. Расширение для БП 3.0 не встанет на УТ 11, даже если «выглядит похоже».
- Версия платформы. Посмотрите номер в
Справка → О программе. Номер платформы на компьютере должен быть не ниже того, под который собрано расширение.
Расширение может менять код типовых документов и проводок. Ставьте его в рабочую базу только от проверенного автора. Перед первой установкой в рабочую базу сделайте резервную копию — это единственное место, где без неё не обойтись.
💡 Хороший порядок: сначала копия базы, загрузка туда, проверка на двух-трёх документах, и только потом рабочая база.
Как загрузить расширение в режиме 1С:Предприятие
Это основной способ для бухгалтера и администратора базы. Конфигуратор не нужен, работу пользователей останавливать не требуется.
Типовые конфигурации на БСП
В БП 3.0, ЗУП 3.1, УТ 11, КА 2 и ERP 2 список расширений встроен в раздел администрирования.
| Конфигурация | Где список расширений |
|---|---|
| Бухгалтерия предприятия 3.0 | Администрирование → Печатные формы, отчеты и обработки → Расширения |
| ЗУП 3.1 | Администрирование → Печатные формы, отчеты и обработки → Расширения |
| Управление торговлей 11 | раздел НСИ и администрирование, ссылка Печатные формы, отчеты и обработки → Расширения |
Порядок действий:
- Откройте список расширений по пути из таблицы.
- Нажмите
Добавить из файла…. - Программа покажет предупреждение о безопасности. Прочитайте и подтвердите, если доверяете источнику.
- Выберите файл
.cfeна диске. - Расширение появится в списке. Откройте его карточку и проверьте флажки (о них ниже).
- Перезапустите 1С. Расширение подключается при старте сеанса.
Остальные пользователи получат расширение при следующем входе в программу. Тем, кто сейчас работает, достаточно выйти и зайти снова.
Стандартная функция «Управление расширениями конфигурации»
Если конфигурация нетиповая или пункта в администрировании нет, используйте средство платформы. Включите в параметрах пункт «Все функции»: Главное меню (☰) → Сервис → Параметры → Отображать команду "Все функции". Дальше Все функции → Стандартные → Управление расширениями конфигурации.
Здесь та же кнопка добавления из файла и те же колонки: «Активно», «Безопасный режим», «Защита от опасных действий». После добавления — перезапуск.
Флажки, которые решают судьбу расширения
| Флажок | Что делает | Когда снимать |
|---|---|---|
| Активно | Расширение подключается при входе | Временно отключить без удаления |
| Безопасный режим | Запрещает работу с файлами, COM, внешними компонентами | Только если автор прямо требует и вы ему доверяете |
| Защита от опасных действий | Показывает предупреждение при опасных операциях кода | Обычно оставляют включённым |
Не снимайте «Безопасный режим» по привычке. Он ограничивает только опасные операции. Большинству расширений с печатными формами и доработками документов он не мешает. Снимать его нужно, когда расширение работает с файлами на диске, обменивается данными с внешними программами или подключает компоненты — и автор об этом предупредил.
Установка расширения через Конфигуратор
Этот способ нужен разработчикам и администраторам: когда расширение надо посмотреть, сравнить с прошлой версией или поставить в базу без входа в пользовательский режим.
Пошагово
- Запустите базу в режиме «Конфигуратор» под пользователем с полными правами.
- Откройте конфигурацию:
Конфигурация → Открыть конфигурацию. - Откройте список:
Конфигурация → Расширения конфигурации. - В окне списка нажмите
Добавить. Задайте имя и префикс, если создаёте пустое расширение. При загрузке из файла их перезапишут данные из.cfe. - Выделите новую строку и в меню окна выберите команду загрузки конфигурации из файла. Укажите
.cfe. - Откроется дерево расширения. Выполните
Конфигурация → Обновить конфигурацию базы данных(F7) для этого расширения. - Запустите 1С:Предприятие и проверьте работу.
Загрузка файла и обновление конфигурации базы данных — два разных шага. Без шага 6 расширение лежит в списке, но в пользовательском режиме ничего не меняется. Это самая частая причина вопроса «загрузил, а не работает».
Обновление уже установленного расширения
Если в базе стоит старая версия, есть два пути:
- 📥 Загрузить файл поверх. Выделите расширение в списке и снова загрузите
.cfe. Старое содержимое заменится целиком. - 🔀 Сравнить и объединить. Откройте дерево расширения и выполните сравнение и объединение с конфигурацией из файла. Так видно, что изменилось, и можно сохранить свои правки в расширении.
Имя расширения в базе и в новом файле должно совпадать. Иначе вы получите два расширения рядом, и они начнут конфликтовать за одни и те же объекты.
Перенос расширения из тестовой базы в рабочую
Частый сценарий: расширение доработали и проверили в копии, теперь его нужно поставить в рабочую базу. Файла .cfe под рукой нет — его делают сами.
- В тестовой базе откройте
Конфигурация → Расширения конфигурации. - Выделите нужное расширение и выберите в меню окна команду сохранения конфигурации в файл.
- Укажите папку и имя, например
Pechat_2026-10-07.cfe. Дата в имени помогает не перепутать версии. - В рабочей базе загрузите этот файл любым способом из этой инструкции.
Если тестовая база уже на новом релизе типовой, а рабочая ещё нет, сначала обновите рабочую. Иначе расширение, собранное под новый релиз, может не примениться к старому.
Пакетный запуск для разработчиков
Когда базу обслуживают скриптами (CI, ночные регламенты), Конфигуратор открывать не обязательно. Платформа умеет загружать расширение из командной строки:
"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" DESIGNER /F "D:\Bases\Buh" /N "Администратор" /P "" ^
/LoadCfg "D:\Ext\Pechat.cfe" -Extension "Pechat" ^
/UpdateDBCfg -Extension "Pechat" ^
/DisableStartupDialogs /Out "D:\Logs\ext_load.log"
Здесь:
/F— путь к файловой базе. Для клиент-серверной используйте/S "сервер\база"./LoadCfg … -Extension— загрузка файла в расширение с указанным именем./UpdateDBCfg -Extension— тот самый шаг обновления конфигурации базы данных./Out— журнал. Смотрите его после запуска: при ошибке окно не покажется.
Путь к 1cv8.exe и номер версии подставьте свои.
Права доступа и роли расширения
Расширение загружено, но у кладовщика или бухгалтера ничего не появилось? Почти всегда дело в правах.
Кто может загружать расширения
Добавлять и удалять расширения может пользователь с ролью полных прав («Полные права», в разных конфигурациях — администратор системы). Обычному бухгалтеру пункт Добавить из файла… недоступен, и это нормально.
Кто увидит изменения
Здесь два случая:
- 🧩 Расширение меняет существующие объекты (печатную форму, модуль документа). Права берутся из основной конфигурации. Кто видел документ раньше, увидит и доработку.
- 🆕 Расширение добавляет новые объекты (свой отчёт, справочник, обработку). На них нужны отдельные права. Автор либо кладёт в расширение свою роль, либо включает свойство «Использовать основные роли для всех пользователей».
Если в расширении есть своя роль, её надо выдать пользователям. В конфигурациях на БСП роли выдают через группы доступа: Администрирование → Настройки пользователей и прав → Профили групп доступа. Откройте нужный профиль, найдите роль расширения в списке ролей, отметьте её и запишите профиль. После этого пользователям достаточно перезайти.
💡 Не создавайте ради одной роли новый профиль, если доработкой пользуются все бухгалтеры. Добавьте роль в профиль, который у них уже есть.
Ошибки при загрузке расширения и что с ними делать
Тексты сообщений отличаются по версиям платформы, поэтому ниже — по смыслу сообщения.
Если не помогло
- 🔁 Удалите расширение из списка и загрузите заново. Перед этим уточните у автора, хранит ли расширение свои данные: при удалении они теряются.
- 🗂 Проверьте журнал регистрации:
Администрирование → Обслуживание → Журнал регистрации, отбор по уровню «Ошибка» за время загрузки. - 🧪 Загрузите то же расширение в чистую копию базы . Если там встало — проблема в доработках вашей конфигурации или в другом расширении.
- 🧱 Отключите остальные расширения флажком «Активно» и проверьте снова. Два расширения, которые правят один объект, мешают друг другу.
Проверка работоспособности после установки
Расширение встало без ошибок — это ещё не значит, что оно работает правильно. Проверьте по шагам.
- Статус. В списке расширений у строки стоит «Активно», сообщения об ошибке подключения нет.
- Функция. Откройте тот документ или отчёт, который дорабатывали. Новая печатная форма появилась в меню «Печать», новый отчёт — в своём разделе.
- Результат. Сформируйте печатную форму или проведите тестовый документ в копии базы. Сверьте суммы и реквизиты с прежним вариантом.
- Другой пользователь. Зайдите под обычным бухгалтером, а не под администратором. Так сразу видно, хватает ли прав.
- Скорость. Если после установки заметно медленнее открываются документы, сообщите автору. Расширение может выполнять лишние запросы при открытии формы.
Запишите, какое расширение и какой версии стоит в базе, от кого и когда получено. Через полгода, при обновлении типовой, эта запись сэкономит поиск по почте.
Что делать при обновлении конфигурации
Расширение привязано к релизу. После обновления типовой откройте программу и посмотрите, подключилось ли оно. Если расширение перестало применяться, запросите у автора версию под новый релиз. Временно его можно отключить флажком «Активно» — остальная база продолжит работать.