Подключаем файл .cfe к рабочей базе 1С 8.3 без ошибок

Чтобы установить расширение в 1С 8.3, откройте в пользовательском режиме Администрирование → Печатные формы, отчеты и обработки → Расширения, нажмите Добавить из файла…, выберите файл .cfe и перезапустите программу. Конфигуратор для этого не нужен, а снимать конфигурацию с поддержки — тем более.

Частая путаница: расширением называют любой файл «доработки». Но внешняя обработка (.epf) и внешний отчёт (.erf) подключаются в другом месте — через «Дополнительные отчеты и обработки». Расширение конфигурации — это только файл .cfe. Механизм работает в платформе 8.3, начиная с версии 8.3.6, и одинаков для Бухгалтерии 3.0, ЗУП 3.1, УТ 11 и других типовых конфигураций.

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

Расширение меняет поведение программы для всех пользователей базы. Поэтому сначала проверьте три вещи.

1. Права пользователя. Установить расширение может пользователь с полными правами или с правом АдминистрированиеРасширенийКонфигурацииБазыДанных. Обычному бухгалтеру команда добавления будет недоступна или выдаст ошибку прав доступа.

2. Совместимость. Расширение пишется под конкретную конфигурацию и её релиз. Уточните у разработчика:

• 📌 для какой конфигурации сделан файл (БП, ЗУП, УТ, КА);
• 📌 на каком релизе его проверяли;
• 📌 какой номер версии платформы нужен — он не ниже того, что указан в требованиях к расширению.

3. Резервная копия. Расширение, которое добавляет свои реквизиты и справочники, меняет структуру базы. Если что-то пойдёт не так, откат проще всего сделать из копии.

💡 Если расширение пришло от стороннего разработчика, сначала поставьте его в копию базы . Проверьте печатные формы, проведение пары документов и отчёты, которые оно затрагивает. Только потом переносите в рабочую.

Три способа подключить расширение конфигурации

Файл .cfe можно установить тремя путями. Результат одинаковый: расширение попадает в базу и применяется при следующем запуске сеанса.

Есть и четвёртый вариант для конфигураций без БСП — стандартная функция платформы «Управление расширениями конфигурации». О ней ниже.

Установка расширения в режиме 1С:Предприятие

Это основной способ для бухгалтера и администратора типовой базы. Конфигуратор не открываем.

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

Путь в типовых конфигурациях:

Пошаговая установка

1. Попросите пользователей завершить работу. Это не обязательное условие, но чужие сеансы всё равно не увидят расширение до перезапуска.
2. Откройте список расширений по пути из таблицы.
3. Нажмите Добавить из файла….
4. Программа покажет предупреждение о безопасности: расширение получит доступ к данным базы. Подтвердите, если доверяете источнику файла.
5. Выберите файл .cfe на диске.
6. Расширение появится в списке. Проверьте, что у него стоит флажок «Активно».
7. Перезапустите программу. Если расширение добавляет новые объекты, при запуске 1С может обновить структуру базы — дождитесь окончания.

После перезапуска проверьте, что изменения на месте: новая печатная форма в меню «Печать», новый реквизит на форме документа, новый отчёт в разделе.

Безопасный режим и защита от опасных действий

В списке расширений у каждой строки есть два важных флажка.

• 🔒 Безопасный режим. Код расширения не может работать с файлами на диске, COM-объектами, внешними компонентами и привилегированным режимом. Для расширений, которые меняют только формы и печать, этого достаточно.
• 🛡 Защита от опасных действий. Платформа предупреждает пользователя, когда расширение пытается выполнить потенциально опасную операцию.

Если расширение загружает данные из файлов, обращается к сайту поставщика или работает с оборудованием, в безопасном режиме оно упадёт с ошибкой. Снимите флажок «Безопасный режим» — программа ещё раз спросит подтверждение — и перезапустите сеанс.

Функция «Управление расширениями конфигурации»

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

1. Включите Сервис и настройки → Параметры → Режим технического специалиста.
2. Откройте Главное меню → Функции для технического специалиста.
3. В ветке «Стандартные» выберите «Управление расширениями конфигурации».
4. Нажмите «Добавить» и укажите файл .cfe.
5. Перезапустите программу.

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

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

Загрузка .cfe из файла

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

Загрузка из файла и обновление конфигурации БД — два разных шага. Пропустили второй — расширение видно в Конфигураторе, но пользователи его не получат.

💡 В свойствах расширения смотрите поле «Назначение»: «Исправление», «Адаптация» или «Дополнение». От него зависит порядок применения, если в базе несколько расширений меняют один и тот же объект.

Перенос расширения из одной базы в другую

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

1. В базе-источнике откройте Конфигуратор и окно Конфигурация → Расширения конфигурации.
2. Выделите нужное расширение и в подменю Конфигурация выберите сохранение в файл.
3. Укажите имя файла, например Pechat_1.0.3.cfe. Версию в имени удобно держать, чтобы не путать сборки.
4. Установите полученный файл в базу-приёмник через форму «Расширения» или Конфигуратор.

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

Пакетная установка из командной строки

Для десятка баз ручная установка отнимает много времени. Расширение можно загрузить командой 1cv8 в пакетном режиме Конфигуратора:

"C:\Program Files\1cv8\8.3.24.1586\bin\1cv8.exe" DESIGNER /F "D:\Bases\Buh" /N "Администратор" /P "пароль" /LoadCfg "D:\Ext\Pechat.cfe" -Extension "Pechat" /UpdateDBCfg -Extension "Pechat" /Out "D:\Logs\ext.log"

Что здесь важно:

• /F — каталог файловой базы; для серверной используйте /S "сервер\база";
• имя после -Extension — внутреннее имя расширения, а не имя файла;
• /UpdateDBCfg с тем же ключом применяет расширение в базе;
• /Out пишет лог — по нему видно, почему загрузка не прошла.

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

Расширения в веб-клиенте, тонком клиенте и в облаке

Само расширение хранится в базе, поэтому тип клиента на установку почти не влияет. Отличия есть в мелочах.

Тонкий клиент. Работает так же, как описано выше. Файл .cfe выбирается с диска компьютера, на котором запущен клиент. При работе через RDP файл должен лежать на терминальном сервере или в подключённом диске.

Веб-клиент. Форма «Расширения» доступна и в браузере. Нажмите Добавить из файла… — браузер откроет стандартный диалог выбора файла и отправит его на сервер. Иногда браузер просит установить расширение для работы с файлами 1С; без него выбор файла тоже работает, но с дополнительным подтверждением. После установки обновите страницу или войдите заново.

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

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

Что делать с расширением после обновления конфигурации

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

Порядок действий при обновлении:

1. Перед обновлением конфигурации выясните у разработчика, совместимо ли расширение с новым релизом.
2. Обновите конфигурацию обычным способом.
3. При первом запуске посмотрите, не появилось ли сообщение о том, что расширение не может быть применено.
4. Если появилось — загрузите новую версию .cfe поверх старой. В форме «Расширения» для этого есть команда обновления выделенного расширения из файла.

Почему расширение не устанавливается: разбор ошибок

Тексты сообщений зависят от версии платформы, поэтому ориентируйтесь на смысл.

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

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