Ошибка «Расширение для работы с файлами не подключено»: как исправить

Ошибка означает, что в веб-клиенте не установлено или не разрешено браузерное расширение 1С:Предприятие, через которое программа сохраняет и открывает файлы. Решение почти всегда одно: установить расширение работы с файлами, разрешить его в браузере и перезапустить окно.

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

Что означает, что расширение работы с файлами не подключено

Полный текст ошибки обычно такой:

Расширение для работы с файлами не подключено. Продолжение операции невозможно.

Или короче — Расширение работы с файлами не подключено.

Веб-клиент 1С работает в браузере и по правилам безопасности не может напрямую лезть в файловую систему компьютера. Чтобы сохранить печатную форму, приложить скан к документу, выгрузить отчёт или загрузить картинку, платформа использует отдельное браузерное расширение.

Нет расширения — нет доступа к диску. Отсюда и сообщение.

Ошибка вылезает, когда вы:

• 📎 прикрепляете файл к документу или элементу справочника;
• 💾 сохраняете печатную форму, отчёт или выгрузку в файл;
• 🖨 печатаете в PDF или отправляете документ по почте с вложением;
• 🖼 загружаете фото, скан или подпись;
• 🔌 работаете со сканером штрихкодов через веб-клиент.

Быстрая диагностика: почему расширение не подключается

Прежде чем переустанавливать, определите свой случай.

Как подключить расширение работы с файлами в веб-клиенте

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

Chrome и Яндекс.Браузер

Здесь расширение ставится из встроенного магазина. Если установка «молча» не проходит:

1. Откройте меню браузера → Расширения → Управление расширениями.
2. Найдите расширение 1С:Предприятие и включите переключатель.
3. Убедитесь, что для сайта базы не заблокированы всплывающие окна (значок в адресной строке).
4. Обновите страницу базы клавишей F5.

Firefox

Firefox использует своё дополнение. Логика та же: при первой операции 1С предложит установить, нужно подтвердить в жёлтой панели вверху и разрешить дополнению доступ.

Edge

Edge на движке Chromium ставит то же расширение, что и Chrome. Если магазин Edge пустой — разрешите установку расширений из стороннего источника в настройках браузера.

Причина на стороне платформы: асинхронность

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

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

Правильно — подключать через обработчик оповещения:

&НаКлиенте
Процедура СохранитьФайл()
    Оповещение = Новый ОписаниеОповещения("ПослеПодключения", ЭтотОбъект);
    НачатьПодключениеРасширенияРаботыСФайлами(Оповещение);
КонецПроцедуры

&НаКлиенте
Процедура ПослеПодключения(Подключено, ДопПараметры) Экспорт
    Если Не Подключено Тогда
        // расширения нет — предлагаем установить
        ОповещениеОбУстановке = Новый ОписаниеОповещения("ПослеУстановки", ЭтотОбъект);
        НачатьУстановкуРасширенияРаботыСФайлами(ОповещениеОбУстановке);
        Возврат;
    КонецЕсли;
    // здесь расширение уже готово — работаем с файлами
КонецПроцедуры

Логика простая: сначала НачатьПодключениеРасширенияРаботыСФайлами, и только внутри его обработчика — сама работа с файлами.

Современный подход для новых версий платформы

С версии платформы 8.3.18 доступны асинхронные методы с Ждать. Код становится линейным и читается сверху вниз:

&НаКлиенте
Асинх Процедура СохранитьФайлАсинх()
    Подключено = Ждать ПодключитьРасширениеРаботыСФайламиАсинх();
    Если Не Подключено Тогда
        Ждать УстановитьРасширениеРаботыСФайламиАсинх();
        Возврат;
    КонецЕсли;
    // расширение подключено — продолжаем
КонецПроцедуры

Оба варианта рабочие. Синхронные версии методов (ПодключитьРасширениеРаботыСФайлами без Начать/Асинх) в веб-клиенте не работают — только в тонком и толстом.

Нюансы мобильного и тонкого клиента

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

В мобильном клиенте набор файловых операций урезан платформой. Часть функций, которые есть в веб-клиенте, там недоступна в принципе — и корректно об этом сообщает. Это ограничение, а не поломка.

Если не помогло

Расширение стоит, браузер перезапущен, а ошибка держится. Тогда по порядку:

• 🔄 Удалите расширение 1С из браузера и установите заново — файл мог повредиться.
• 🧹 Очистите кеш браузера и кеш веб-клиента 1С.
• 🌐 Проверьте другой поддерживаемый браузер: если там работает — дело в настройках первого.
• 🛡 Временно отключите антивирус или добавьте сайт базы в исключения — некоторые модули веб-защиты режут расширение.
• 👤 В домене — попросите администратора разрешить расширение 1С:Предприятие групповой политикой.
• 🖥 Как обходной путь — откройте базу в тонком клиенте: там файловые операции доступны без браузерного расширения.

Как предотвратить повторение

• Заранее ставьте расширение всем пользователям веб-клиента централизованно.
• Держите браузеры в актуальных версиях — старые движки теряют поддержку.
• В своих обработках всегда подключайте расширение асинхронно перед работой с файлами.
• Не блокируйте всплывающие окна и расширения для адреса вашей базы.

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