Расширение работы с файлами в веб-клиенте 1С: установка, настройка, ошибки

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

Всё занимает 2–3 минуты, права администратора Windows обычно не нужны. Ниже — что подготовить, как пройти установку в разных браузерах, что делать, если окно не появилось или установка «не держится».

Что такое расширение работы с файлами и кому оно нужно

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

Оно состоит из двух частей:

• 🧩 расширение браузера — «1С:Предприятие. Расширение для работы с файлами», ставится из магазина расширений;
• ⚙️ компонент на компьютере — небольшая программа, через которую расширение браузера обращается к файловой системе.

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

• 📂 выбор нескольких файлов и каталогов сразу;
• 💾 сохранение отчётов и печатных форм в нужную папку без лишних вопросов браузера;
• ✏️ редактирование присоединённых файлов: открыли документ Word, поправили, 1С подхватила изменения;
• 📥 загрузка выписок банка, прайсов, файлов обмена с диска;
• 🔄 работа обработок, которые сами читают и пишут файлы.

Не путайте его с другими «расширениями» в 1С:

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

Подготовка перед установкой: что проверить

Пять минут проверки экономят полчаса поисков, почему «не ставится».

1. Браузер поддерживается. Подходят актуальные Google Chrome, Яндекс Браузер, Microsoft Edge, Mozilla Firefox, а на macOS — Safari. Устаревшие сборки и экзотические браузеры на движке Chromium могут не пустить в магазин расширений.
2. Установка расширений не запрещена. В организациях браузер часто управляется групповыми политиками. Откройте chrome://policy (для Chrome, Edge и Яндекса — аналогичный адрес): если там есть запрет на установку расширений, нужен системный администратор.
3. Магазин расширений открывается. Прокси или фильтр трафика могут блокировать Chrome Web Store или каталог дополнений Firefox.
4. Вы не в режиме инкогнито. В приватных окнах расширения по умолчанию отключены — установка пройдёт, а 1С его «не увидит».
5. База опубликована через HTTPS. По HTTP расширение тоже работает, но браузеры всё чаще ограничивают незащищённые страницы. Для рабочей базы с внешним доступом HTTPS обязателен.
6. Вы знаете учётную запись Windows. Компонент ставится в профиль текущего пользователя. Если за компьютером работают под разными учётками, установку повторяют для каждой.

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

Скачивать расширение с форумов и файлообменников не нужно. Правильных источника два.

1. Из самой базы. Окно установки в веб-клиенте содержит ссылку прямо на страницу расширения в магазине вашего браузера. Компонент для компьютера отдаёт сервер, на котором опубликована база, — его версия совпадает с версией платформы.

2. Из официального магазина браузера:

В магазине ищите расширение по названию «1С:Предприятие. Расширение для работы с файлами». Проверьте издателя: это должна быть фирма-разработчик платформы, а не сторонний автор с похожим названием.

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

Порядок одинаков для всех конфигураций — Бухгалтерии, ЗУП, УТ, Документооборота. Отличается лишь то, какое действие запускает установку.

Шаг 1. Вызовите окно установки

Есть три способа, выбирайте любой:

• 📎 выполнить действие с файлом: прикрепить файл к документу , загрузить выписку, сохранить печатную форму;
• ⚙️ в конфигурациях на БСП открыть персональные настройки пользователя (меню с вашим именем в правом верхнем углу или раздел настроек программы) и найти на форме ссылку про установку расширения для работы с файлами;
• 🔔 дождаться предупреждения при запуске: часть типовых конфигураций сама предлагает установку при первом входе в веб-клиент.

Появится окно с текстом примерно такого вида: Для продолжения необходимо установить расширение для работы с файлами. Нажмите «Установить» или «Продолжить».

Шаг 2. Установите расширение браузера

1. Платформа откроет новую вкладку со страницей расширения в магазине.
2. Нажмите «Установить» («Добавить в Chrome», «Добавить в Firefox»).
3. Браузер спросит разрешение на «обмен данными с взаимодействующими нативными приложениями» — подтвердите. Без этого разрешения расширение не сможет связаться с компонентом.
4. Вернитесь на вкладку с 1С.

Шаг 3. Установите компонент на компьютер

1. 1С предложит скачать и запустить установщик компонента.
2. Сохраните файл и запустите его. Окно установки короткое, обычно без вопросов.
3. Если Windows показывает предупреждение SmartScreen или запрос контроля учётных записей, проверьте издателя в окне и разрешите запуск.

Шаг 4. Перезагрузите страницу и проверьте

1. Нажмите F5 на вкладке с базой или закройте и снова откройте веб-клиент.
2. Повторите действие с файлом, с которого всё начиналось.
3. Если окно установки больше не появляется, а выбор файла открывает привычный проводник Windows с возможностью выбрать несколько файлов — расширение работает.

Типичные ошибки при установке и как их исправить

Чаще всего проблема не в 1С, а в браузере или политиках компьютера. Выберите свой симптом:

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

Настройка и практическое применение расширения

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

Каталог для временных файлов

Когда вы открываете присоединённый файл на редактирование, 1С кладёт его копию в рабочий каталог на компьютере. В конфигурациях на БСП путь к нему и лимит размера задаются в персональных настройках работы с файлами. Если на диске C: мало места, укажите другой каталог и периодически очищайте его кнопкой на той же форме.

Как пользоваться: три типовых сценария

Загрузка банковской выписки. В обработке обмена с банком укажите файл выписки. С расширением 1С запомнит каталог и в следующий раз откроет его сразу.

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

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

Для программиста: вызов установки из кода

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

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

В конфигурациях на БСП удобнее вызывать процедуры общего модуля ФайловаяСистемаКлиент — они сами показывают пользователю окно с предложением установки и учитывают тонкий клиент.

Обновление и удаление расширения

Обновление

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

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

Удаление и переустановка

1. Откройте страницу расширений браузера: chrome://extensions в Chrome, browser://extensions в Яндекс Браузере, edge://extensions в Edge, about:addons в Firefox.
2. Найдите «1С:Предприятие. Расширение для работы с файлами» и удалите его.
3. Проверьте список установленных программ Windows (Параметры → Приложения). Если компонент 1С для работы с файлами там есть — удалите.
4. Закройте все окна браузера и откройте базу заново.
5. Выполните действие с файлом — 1С предложит чистую установку.

Безопасность при работе с расширением

Расширение получает доступ к файловой системе, поэтому относитесь к нему как к любой программе с такими правами.

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

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

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