Подключаем расширения и внешние обработки к базе 1С:Предприятие 8.3

Модуль в 1С ставят одним из трёх способов. Расширение конфигурации (файл .cfe) загружают в Администрирование → Печатные формы, отчеты и обработки → Расширения кнопкой «Добавить из файла» и перезапускают программу. Внешнюю обработку или отчёт (.epf, .erf) подключают там же, в списке «Дополнительные отчеты и обработки». Конфигуратор и командная строка нужны, когда надо загрузить расширение в несколько баз сразу или поставить его без входа в пользовательский режим.

Какой путь выбрать, зависит от того, что вам прислали. Файл .cfe — это расширение: оно меняет поведение конфигурации, но не снимает её с поддержки. Файлы .epf и .erf живут отдельно от конфигурации и обновлений не боятся вовсе. Файл .cf — уже не модуль, а целая конфигурация, и с ним обращаются совсем иначе.

Инструкция написана для платформы 8.3 с интерфейсом «Такси» и типовых конфигураций на БСП: Бухгалтерия 3.0, ЗУП 3.1, УТ 11, КА и ERP. Пути меню в разделе «Администрирование» у них одинаковые.

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

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

Права пользователя. Добавлять расширения и дополнительные обработки может пользователь с профилем «Администратор» (роль «Полные права»). Обычному бухгалтеру команды «Добавить из файла» просто не видно.

Версия платформы. Расширения появились в платформе 8.3.6, но реально пригодны с более поздних версий. Откройте Справка → О программе и посмотрите номер платформы и режим совместимости конфигурации. Разработчик расширения обычно указывает минимальный номер — ваш должен быть не ниже.

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

Резервная копия. Перед установкой расширения в рабочую базу сделайте выгрузку: Конфигуратор → Администрирование → Выгрузить информационную базу (файл .dt). Для внешней обработки копия базы не нужна, пока вы её только подключаете. Нужна — перед первым запуском обработки, которая что-то массово меняет.

Источник файла. Расширение и обработка выполняют произвольный код с вашими правами. Файл из чата «скачал на форуме» может удалить данные или отправить их наружу.

Установка расширения конфигурации в пользовательском режиме

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

Шаг 1. Включите раздел расширений

1. Откройте Администрирование → Печатные формы, отчеты и обработки.
2. Найдите ссылку «Расширения» и перейдите по ней.

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

Шаг 2. Загрузите файл

1. В списке расширений нажмите «Добавить из файла…».
2. Подтвердите предупреждение безопасности. Программа прямо напишет, что расширение получает доступ к данным.
3. Выберите файл .cfe на диске.

Расширение появится в списке. Строка с ним будет помечена как требующая перезапуска.

Шаг 3. Настройте флажки

У каждого расширения в списке есть несколько свойств. От них зависит, заработает ли модуль.

• 🔒 Безопасный режим. Включён по умолчанию. В нём расширение не может работать с файлами на диске, внешними компонентами и COM-объектами. Если разработчик пишет, что модулю нужен файловый обмен или загрузка из Excel через COM, флажок придётся снять.
• 🛡 Защита от опасных действий. Перед каждым потенциально опасным действием программа спросит подтверждение. Снимайте только для расширений, которым доверяете.
• 🔁 Передавать в подчинённые узлы РИБ. Нужен, если база работает в распределённой информационной базе и модуль должен оказаться во всех филиалах.
• ✅ Активно. Позволяет временно выключить расширение, не удаляя его.

Шаг 4. Перезапустите программу

Расширение применяется только в новом сеансе. Нажмите «Перезапустить» в окне списка или закройте 1С и войдите заново. Остальные пользователи увидят модуль, когда перезайдут в базу.

Подключение внешней обработки и отчёта в 1С

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

Регистрация в «Дополнительных отчетах и обработках»

1. Откройте Администрирование → Печатные формы, отчеты и обработки.
2. Отметьте флажок «Дополнительные отчеты и обработки», если он снят.
3. Перейдите по ссылке «Дополнительные отчеты и обработки».
4. Нажмите «Добавить из файла…» и подтвердите предупреждение безопасности.
5. Выберите файл .epf или .erf.

Откроется карточка обработки. Программа сама прочитает её вид: дополнительная обработка, отчёт, печатная форма, заполнение объекта.

Размещение и доступ

Дальше определите, где модуль будет виден.

• 📂 Размещение. Для обработки или отчёта выберите разделы командного интерфейса, например «Продажи» или «Зарплата и кадры».
• 📄 Объекты назначения. Для печатной формы и заполнения — список документов, к которым она привязана. Его обычно задаёт разработчик.
• 👥 Быстрый доступ. На вкладке команд отметьте пользователей, у которых команда будет выведена на панель.
• 🟢 Публикация. Значение «Используется» включает модуль, «Отключена» — скрывает без удаления, «Режим отладки» — показывает только администраторам.

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

Когда регистрация невозможна

Регистрировать в справочнике можно только обработку, которую разработчик подготовил для БСП: в модуле её объекта есть экспортная функция СведенияОВнешнейОбработке(). Без неё программа откажется добавлять файл.

Такую обработку открывают разово: Главное меню → Файл → Открыть и выбор .epf. Для этого у пользователя должно быть право интерактивного открытия внешних обработок. В типовых конфигурациях оно есть у администратора.

Загрузка модулей через Конфигуратор

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

Расширение .cfe

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

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

Конфигурация .cf вместо модуля

Иногда «модулем» называют доработанную типовую конфигурацию в файле .cf. Её грузят через Конфигурация → Сравнить, объединить с конфигурацией из файла.

Команда «Загрузить конфигурацию из файла » полностью заменяет конфигурацию базы — все ваши доработки исчезнут, а база потеряет связь с поставкой. Без программиста в эту ветку лучше не заходить.

Проверка модуля после загрузки

Перед тем как отдавать расширение пользователям, проверьте его командой Конфигурация → Проверка конфигурации при открытом расширении. Ошибки компиляции видны здесь сразу, а не в виде падения у бухгалтера.

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

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

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

Что здесь происходит:

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

Путь к 1cv8.exe подставьте свой: номер каталога совпадает с установленной версией платформы.

Для нескольких баз команду оборачивают в цикл по списку путей:

@echo off
for /f "usebackq delims=" %%B in ("D:\Ext\bases.txt") do (
  "C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" DESIGNER /F"%%B" ^
    /N"Администратор" /P"пароль" /DisableStartupDialogs ^
    /LoadCfg "D:\Ext\MyExtension.cfe" -Extension "MyExtension" ^
    /UpdateDBCfg -Extension "MyExtension" /Out "D:\Logs\ext.log" -NoTruncate
)

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

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

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

Предупреждение о небезопасном действии при каждом открытии

С платформы 8.3.9 работает защита от опасных действий. При открытии внешнего файла программа спрашивает подтверждение. Для отдельного пользователя её отключают в Конфигураторе: Администрирование → Пользователи, карточка пользователя, флажок «Защита от опасных действий».

Для всех баз на компьютере есть параметр DisableUnsafeActionProtection в файле conf.cfg каталога платформы. Отключать защиту целиком стоит только на машине разработчика, но не на рабочих местах бухгалтеров.

Расширение есть в центральной базе, но нет в филиале

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

Частые вопросы об установке модулей