Загрузка внешних обработок, отчётов и расширений в 1С 8.3

Коллега прислал файл и просит «загрузить модуль» в 1С, а подходящего пункта в меню не видно. Чаще всего за словом «модуль» скрывается одно из трёх: внешняя обработка, внешний отчёт или расширение конфигурации — и подключаются они по-разному.

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

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

Что скрывается под словом «модуль»

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

Отдельно стоит развести два значения слова «модуль». В речи программиста модуль — это часть кода внутри конфигурации (модуль объекта, общий модуль, модуль формы). Его нельзя «загрузить» отдельным файлом: он правится только в конфигураторе. А вот когда загрузить модуль в 1С просит бухгалтер или менеджер, речь почти всегда про .epf, .erf или .cfe — именно их мы и подключаем.

Отдельно про облачные базы и маркетплейс. Если вы работаете не с локальной базой, а с арендованной в сервисе, часть решений ставится иначе: типовые дополнительные обработки обычно подключаются так же, через список в разделе администрирования, а произвольные расширения в таких базах чаще подключает администратор сервиса — у пользователя может не быть нужных прав. Готовые отраслевые решения и обработки удобно искать в каталоге решений 1С: там файлы проходят проверку, и риск получить вредоносный код ниже, чем при скачивании с случайного сайта.

Что проверить до загрузки

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

• 🧩 Версия платформы. Расширения конфигурации работают на платформе с номером не ниже 8.3.6, а подключение расширения прямо в пользовательском режиме — с номером не ниже 8.3.11. Если файл собран в более новой платформе, он не загрузится в старую.
• 🧱 Совместимость с конфигурацией. Обработка под «1С:Бухгалтерию» не обязана работать в «Управлении торговлей»: у конфигураций разные объекты. Уточните у поставщика, под какую конфигурацию и релиз сделан файл.
• 🔑 Права. Чтобы добавить дополнительную обработку или подключить расширение , нужны права администратора или специальное право на добавление дополнительных отчётов и обработок. Обычному пользователю этих команд не видно.
• 💾 Резервная копия. Расширение, которое меняет структуру данных, при подключении перестраивает таблицы. Перед загрузкой такого расширения сделайте резервную копию базы — откатить проще, чем чинить.

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

Разовый запуск через «Файл → Открыть»

Если обработку нужно выполнить один раз и не хранить в базе — это самый быстрый путь.

1. В режиме «1С:Предприятие» откройте Файл → Открыть.
2. Выберите файл .epf или .erf.
3. Откроется форма обработки или отчёта — работайте как с обычной.

Файл при этом нигде не сохраняется: закрыли форму — и следа в базе не осталось. Способ удобен для разовой загрузки данных или проверки, но у него есть ограничение по правам.

Постоянное подключение обработки или отчёта

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

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

После записи команда обработки появляется там, где вы указали размещение. Если забыли настроить размещение — файл в базе есть, а вызвать его из документа не получится. Это, кстати, одна из самых частых причин «обработка загрузилась, а кнопки нет».

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

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

Расширение (.cfe) — это надстройка над типовой конфигурацией. Оно добавляет свои формы, реквизиты и алгоритмы, но не снимает конфигурацию с поддержки и не мешает обновлениям. Подключить его можно двумя путями.

В пользовательском режиме

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

Если расширение меняет структуру данных (добавляет реквизиты, таблицы), платформа при перезапуске перестроит базу.

Через конфигуратор

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

1. В конфигураторе откройте Конфигурация → Расширения конфигурации.
2. Добавьте новое расширение в список.
3. Войдите в него и выполните Конфигурация → Загрузить конфигурацию из файла, указав .cfe.
4. Выполните Обновить конфигурацию базы данных (клавиша F7).

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

Загрузка через командную строку

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

"C:\Program Files\1cv8\8.3.x.x\bin\1cv8.exe" DESIGNER ^
  /F "C:\base" /N "Администратор" /P "пароль" ^
  /LoadCfg "C:\ext.cfe" -Extension "ИмяРасширения" ^
  /UpdateDBCfg ^
  /Out "C:\log.txt"

Что означают ключи:

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

Пакетный режим работает с конфигурацией (.cf) и расширениями (.cfe). А вот внешние обработки .epf и отчёты .erf через командную строку не «загружают»: это не часть конфигурации, их либо регистрируют в базе через список дополнительных обработок, либо открывают интерактивно.

Точный набор ключей и модификаторов зависит от версии платформы — полный список выводит сам конфигуратор по ключу /?. Не используйте параметры, в которых не уверены.

Безопасность: проверьте файл до подключения

Внешняя обработка и расширение — это не данные, а исполняемый код. Он может читать и менять любые данные базы, обращаться к файловой системе и в интернет с правами запустившего пользователя. Поэтому к источнику файла относятся серьёзно.

• 🛡️ Доверенный источник. Загружайте только то, что получили от вендора, своего разработчика или из официального каталога решений. Файл из письма от незнакомца — повод насторожиться.
• ✍️ Цифровая подпись. Если файл подписан, платформа это покажет. Неподписанный внешний файл платформа отметит предупреждением — не игнорируйте его.
• 🔒 Безопасный режим. При подключении оставляйте флаг безопасного режима включённым. Он ограничивает привилегированные операции кода. Снимать его стоит, только когда вы точно знаете, зачем расширению такие права.
• 👤 Узкий круг прав. Не выдавайте право на открытие внешних обработок всем подряд. Чем меньше людей может запускать произвольные файлы, тем спокойнее.

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

Частые ошибки при загрузке

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

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