Подключаем файл .cfe к рабочей базе 1С 8.3 без снятия с поддержки

Установить расширение в 1С Предприятие 8.3 можно двумя путями. В типовых конфигурациях на БСП (Бухгалтерия 3.0, ЗУП 3.1, УТ 11) откройте Администрирование → Печатные формы, отчеты и обработки → Расширения, нажмите «Добавить из файла» и укажите файл .cfe. Во всех остальных случаях подойдёт Конфигуратор: Конфигурация → Расширения конфигурации, загрузка файла и обновление конфигурации базы данных.

Расширение применяется со следующего сеанса. Пользователям нужно перезайти в программу, иначе они изменений не увидят. Основную конфигурацию снимать с поддержки не нужно: в этом и смысл механизма, который появился в платформе 8.3.6.

Перед установкой: что проверить в базе и у себя в правах

Пять минут подготовки снимают большую часть проблем, которые потом выглядят как «расширение не работает ».

📌 Что проверить:

• 🔑 Ваши права. Устанавливать расширения может пользователь с ролью полного доступа (в типовых — «Полные права» или «Администратор системы»). Обычный бухгалтер кнопку «Добавить из файла» не увидит.
• 🧩 Версию платформы. У расширения есть свой режим совместимости. Если он выше, чем у платформы на сервере или у вас на компьютере, файл не загрузится. Номер платформы смотрите в окне «О программе» (кнопка с буквой «i» или знаком вопроса в правом верхнем углу).
• 📦 Для какого релиза сделано расширение. Расширение «заимствует» объекты основной конфигурации. Если разработчик писал его под другой релиз, часть заимствований не найдётся. Спросите у автора номер релиза, под который оно проверено, и сравните со своим в «О программе».
• 💾 Резервную копию. Само подключение безопасно, его можно откатить удалением. Но расширение, которое добавляет свои реквизиты и справочники, меняет структуру данных. Перед установкой такого расширения в рабочую базу сделайте копию: выгрузку .dt или бэкап СУБД.
• 🌐 Режим работы базы. Файловая, клиент-серверная, опубликованная на веб-сервере, 1С:Фреш. От этого зависит, нужен ли вам отдельный шаг с публикацией (о нём ниже).

Способ 1. Установка расширения в пользовательском режиме

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

В типовых конфигурациях на БСП

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

Через стандартную функцию платформы

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

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

Способ 2. Загрузка файла расширения через Конфигуратор

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

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

Загрузка .cfe и обновление конфигурации БД — два разных действия. Частая ловушка: файл загрузили, Конфигуратор закрыли, а F7 не нажали.

Свойства расширения, которые стоит проверить

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

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

Установка расширения из командной строки

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

"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 "сервер\имябазы". Путь к 1cv8.exe замените на свою версию платформы. Результат смотрите в log.txt.

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

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

1. В тестовой базе откройте в Конфигураторе Конфигурация → Расширения конфигурации.
2. Выделите расширение и сохраните его в файл командой сохранения в меню «Конфигурация» дерева расширения. Получится новый .cfe.
3. В рабочей базе установите этот файл любым из способов выше.

Если в рабочей базе уже стоит старая версия расширения с тем же именем, не удаляйте её перед установкой новой. Загрузите новый файл поверх существующей записи: так сохранятся данные в реквизитах, которые добавляло расширение. Удаление с повторной установкой эти данные сотрёт.

Публикация на веб-сервере: нужен ли отдельный шаг

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

Отдельная настройка нужна в одном случае: расширение добавляет HTTP-сервисы или веб-сервисы. Например, интеграция с сайтом или мобильным приложением.

1. В Конфигураторе откройте Администрирование → Публикация на веб-сервере.
2. На вкладках HTTP-сервисов и веб-сервисов проверьте, что включена публикация сервисов расширений по умолчанию, и отметьте нужные сервисы.
3. Нажмите «Опубликовать». Конфигуратор перепишет файл default.vrd.

Если публикацию настраивали вручную, проверьте в default.vrd атрибут у сервисов:

<httpServices publishExtensionsByDefault="true"/>
<ws publishExtensionsByDefault="true"/>

Права пользователей на объекты расширения

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

В конфигурациях на БСП

Роли назначаются через группы доступа:

1. Откройте Администрирование → Настройки пользователей и прав → Профили групп доступа.
2. Скопируйте профиль, который используют сотрудники (типовые профили менять нельзя).
3. В копии на вкладке ролей найдите роли расширения. Их легко отличить по имени, которое задал разработчик.
4. Отметьте нужные роли и запишите профиль.
5. В Группах доступа замените для сотрудников старый профиль на новый.

В конфигурациях без БСП

Роли назначаются в Конфигураторе: Администрирование → Пользователи, карточка пользователя, вкладка «Прочие». Роли расширения появятся в списке после того, как расширение применено к базе (после F7).

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

После установки расширение может числиться в списке, но фактически не применяться. Проверка занимает минуту.

✅ Признаки, что всё в порядке:

• в списке расширений флажок «Активно» (или флажок подключения в БСП) стоит;
• после перезахода появились новые команды, печатные формы или реквизиты, которые обещал разработчик;
• в окне «О программе» нет предупреждения о неприменённых расширениях.

Если в списке напротив расширения есть пометка об ошибке, откройте его карточку. Платформа пишет причину: какой объект не найден или какое свойство конфликтует.

Как временно отключить или удалить

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

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

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

Платформа обычно честно пишет причину отказа. Ниже — расшифровка самых частых ситуаций.

Чего не делать

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

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