Подключаем файл .cfe к базе 1С 8.3: два способа и проверка после загрузки

Чтобы установить расширение в 1С 8.3, откройте Функции для технического специалиста → Стандартные → Управление расширениями конфигурации, нажмите «Добавить из файла» и укажите файл .cfe. После этого перезапустите программу: новые объекты появятся только в новом сеансе. Второй путь — Конфигуратор: Конфигурация → Расширения конфигурации, загрузка из файла и обновление конфигурации базы данных.

Ниже оба способа по шагам, с настройками, которые чаще всего упускают новички. Это безопасный режим, режим совместимости и роли. Из-за них расширение «встало», а пользователи его не видят. Инструкция общая для платформы 8.3: Бухгалтерия 3.0, ЗУП 3.1, УТ 11 и другие типовые конфигурации ставят расширения одинаково.

Что такое расширение конфигурации и зачем его ставить

Расширение — это отдельный небольшой модуль, который подключается к основной конфигурации и меняет её поведение. Механизм появился в платформе 8.3.6. Главный плюс: типовая конфигурация остаётся на поддержке, без снятия замка. Её можно обновлять как обычно, а доработка живёт рядом.

Что обычно делают расширениями:

• 🧾 новые и исправленные печатные формы;
• 📊 дополнительные отчёты и обработки, встроенные прямо в разделы меню;
• 🔁 обмены с сайтом, банком, складской программой, маркетплейсом;
• 🛠️ исправления ошибок типового релиза до выхода официального обновления;
• ➕ новые реквизиты в справочниках и документах.

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

Расширения, внешние обработки и доработки конфигурации: в чём разница

Новички часто называют «расширением» всё, что приходит отдельным файлом. На деле это разные вещи, и ставятся они по-разному.

Если вам прислали .epf или .erf, это не расширение. Такие файлы подключают через Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки. Список расширений их не примет.

У самих расширений есть свойство «Назначение». Оно описывает, для чего расширение создано: исправление ошибок, адаптация типового решения под задачи компании или дополнение функциональности. На установку назначение не влияет, но подсказывает, чего ждать после обновления типовой конфигурации. Исправления обычно становятся не нужны, когда фирма выпустила релиз с той же правкой.

Откуда брать расширения и как проверить источник

Расширение — это программный код, который работает с вашими данными. Поэтому источник важнее удобства.

Нормальные источники:

1. ✅ Разработчик, с которым у вас договор: штатный программист или обслуживающая фирма-партнёр.
2. ✅ Каталог тиражных решений, где продаются расширения для типовых конфигураций.
3. ✅ Сервисы интеграции (банки, ЭДО, маркетплейсы), которые публикуют свои модули на официальных страницах.

Что должно насторожить:

• ❌ файл с форума или из мессенджера без автора;
• ❌ расширение «для бесплатного продления поддержки» или «обхода лицензии»;
• ❌ отказ разработчика сказать, для какой конфигурации и релиза сделан модуль.

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

Установка расширения в 1С: пошаговая инструкция

Перед первой установкой сделайте резервную копию базы или выгрузку .dt. Лучше сначала проверить расширение на копии, а в рабочую базу ставить после проверки.

Права нужны административные: роль «Полные права» или «Администратор системы». Обычному пользователю кнопка добавления недоступна.

Способ 1. В пользовательском режиме (без Конфигуратора)

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

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

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

Способ 2. Через Конфигуратор

Так удобнее программисту и администратору, особенно если нужно сразу посмотреть объекты расширения.

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

Способ 3. Пакетно из командной строки

Если расширение нужно раскатать на десяток баз, используют пакетный режим Конфигуратора с параметром -Extension:

"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" /Out "D:\ext\log.txt"

Путь к платформе и номер версии подставьте свои. Для серверной базы вместо /F указывают /S"сервер\база". Результат смотрите в файле лога: при ошибке он не пустой.

Настройки после загрузки: безопасный режим, роли, совместимость

Расширение загрузилось, но кнопки нет или отчёт падает с ошибкой. Обычно причина в одной из четырёх настроек ниже.

Безопасный режим

В безопасном режиме расширение не может работать с файлами на диске, запускать внешние программы, использовать COM-объекты и внешние компоненты. Для печатной формы это не нужно. Для обмена с банком или загрузки из Excel — нужно.

Снимайте флажок «Безопасный режим» только для расширений из проверенного источника. Если разработчик просит отключить его без объяснения причин, это повод задать вопросы.

Защита от опасных действий

Отдельная защита платформы: при попытке кода выполнить потенциально опасное действие пользователь видит предупреждение. Её настраивают у расширения и у пользователя информационной базы. Не отключайте защиту «на всякий случай» для всех. Если предупреждение мешает конкретной операции, обсудите с разработчиком, можно ли переписать код.

Роли

Расширение может добавлять свои роли. Если пользователям не назначить их, объекты расширения останутся невидимыми для всех, кроме администратора.

Решения два:

• 👥 назначить роли расширения пользователям или группам доступа;
• ⚙️ в Конфигураторе у расширения включить свойство «Использовать основные роли для всех пользователей» — тогда права на объекты расширения берутся из основных ролей.

Режим совместимости

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

Ошибки при установке расширения и что с ними делать

Как обновить, отключить или удалить расширение

Обновление на новую версию

Разработчик прислал новый .cfe. Действия зависят от места установки:

• 🖱️ в пользовательском режиме — выделите расширение в списке и нажмите «Обновить из файла » (команда есть в форме типовых конфигураций);
• 🧩 в Конфигураторе — откройте расширение, загрузите конфигурацию из нового файла поверх старой и снова нажмите F7.

Не удаляйте старое расширение, чтобы поставить новое. Если в нём есть свои реквизиты и справочники, при удалении пропадут их данные.

Обновление основной конфигурации

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

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

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

Отключение и удаление

Снятый флажок «Активно» — мягкий вариант: расширение остаётся в базе, данные сохраняются, но код не работает . Удобно для диагностики, когда непонятно, кто виноват — типовая или доработка.

Удаление — кнопка «Удалить» в списке или в Конфигураторе. Данные, которые хранились в реквизитах и объектах расширения, удаляются вместе с ним. Если там что-то ценное, сначала сделайте .dt.

Как не навредить базе: правила работы с расширениями

Ещё несколько правил из практики:

• 📁 храните все .cfe в одной папке с датой и номером версии в имени файла. Через год вы не вспомните, какая версия стоит в базе;
• 🧪 держите копию рабочей базы для проверки обновлений и расширений;
• 🔢 ставьте расширения по одному и проверяйте каждое — так проще найти виновника сбоя;
• 📝 ведите список: имя расширения, назначение, автор, дата установки;
• 🧹 удаляйте расширения, которыми никто не пользуется: каждое лишнее замедляет запуск и усложняет обновления.

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