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

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

Без этого расширения веб-клиент не может сам выбрать файл на диске, сохранить выгрузку в папку, открыть вложение в Word или Excel. Типичный симптом — 1С при загрузке выписки или прикреплении скана просит «установить расширение для работы с файлами» и дальше не идёт.

Что проверить до установки: клиент, браузер, компонента

Сначала поймите, в каком клиенте вы работаете. От этого зависит, нужно ли вообще что-то ставить.

Как отличить веб-клиент: в адресной строке браузера видна ссылка на базу, а вкладка браузера — это и есть окно программы.

Для веб-клиента проверьте:

• 🌐 браузер — Chrome, Edge, Firefox, Safari на macOS в актуальной версии. Старый Internet Explorer работал с ActiveX-компонентой, сейчас его не используют;
• 👤 права — в корпоративной сети установку расширений браузера часто блокирует групповая политика. Тогда поможет только системный администратор;
• 🔌 задача — если нужна электронная подпись, кроме файлового понадобится расширение для работы с криптографией и криптопровайдер. Для сканера штрихкодов или ККТ — драйвер оборудования.

Установка расширения для работы с файлами в браузере

Расширение состоит из двух частей. Первая — дополнение браузера, оно связывает страницу 1С с компьютером. Вторая — небольшая программа, которая ставится в Windows, macOS или Linux и выполняет сами операции с файлами. Работать будет только пара целиком.

Chrome, Edge и другие браузеры на Chromium

1. Откройте базу в браузере и выполните действие с файлом — например, команду загрузки или прикрепления.
2. 1С покажет окно с предложением установить расширение. Нажмите кнопку установки.
3. Браузер откроет страницу дополнения «1С:Предприятие» в Chrome Web Store. Нажмите Установить и подтвердите.
4. Вернитесь на вкладку с 1С. Платформа предложит скачать и запустить установщик программной части. Запустите его и дождитесь окончания.
5. Полностью закройте браузер, все окна, и откройте базу заново.
6. Повторите действие с файлом. Окно с предложением установки больше не появится.

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

Firefox

Порядок тот же, отличается источник дополнения: Firefox берёт его с addons.mozilla.org. После установки дополнения и программной части перезапустите Firefox. В настройках дополнения проверьте, что ему разрешено работать на сайте с базой.

Safari на macOS

На Mac программная часть ставится пакетом, а дополнение включается в настройках Safari на вкладке расширений. Если флажок не включён, установщик отработает, но веб-клиент расширение не увидит.

Внешние компоненты: регистрация в операционной системе

Часто под «расширением для работы с файлами» понимают любую надстройку, без которой 1С не видит сканер, принтер этикеток или подпись. Это уже внешние компоненты, и подключаются они иначе.

Технологий две.

Как зарегистрировать COM-компоненту

1. Скопируйте библиотеку в постоянную папку, например C:\AddIns\. Из «Загрузок» не регистрируйте — файл потом удалят.
2. Запустите командную строку от имени администратора.
3. Выполните регистрацию, указав полный путь:

regsvr32 "C:\AddIns\Component.dll"

4. Дождитесь сообщения об успешной регистрации и перезапустите 1С.

Разрядность компоненты должна совпадать с разрядностью клиента 1С. 32-битную библиотеку на 64-битной Windows регистрируют утилитой из C:\Windows\SysWOW64\regsvr32.exe, и работать она будет только с 32-битным клиентом. Это главный приём, который решает большинство жалоб «компонента зарегистрирована, а 1С её не видит».

Отменить регистрацию можно ключом /u:

regsvr32 /u "C:\AddIns\Component.dll"

Драйверы оборудования и подписи

• 📠 сканер штрихкодов, ККТ, весы — драйвер от производителя или из поставки 1С подключают в карточке подключаемого оборудования. В БП 3.0 она открывается через Администрирование → РМК и оборудование → Подключаемое оборудование, в других конфигурациях ищите раздел подключаемого оборудования в администрировании;
• 🔐 электронная подпись — ставится криптопровайдер, затем в 1С добавляется сертификат. В веб-клиенте дополнительно нужно расширение для работы с криптографией, его 1С предложит установить при первой попытке подписать документ.

Тонкий клиент: что работает сразу, а что нет

В тонком клиенте файловые операции доступны без установки чего-либо. Окно выбора файла, сохранение выгрузок, открытие вложений идут через саму платформу.

Если в тонком клиенте всё же появляется сообщение про расширение, причин обычно три:

• ⚙️ внешняя компонента не подходит по разрядности — 64-битный клиент и 32-битная COM-библиотека;
• 🧩 компонента Native API не поставляется под вашу ОС, например под Linux;
• 🧱 доработка в конфигурации проверяет веб-клиент неправильно и просит расширение всегда.

Разрядность клиента видна в окне «О программе» (откройте его через меню справки в правом верхнем углу). Там же указан номер платформы.

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

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

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

&НаКлиенте
Асинх Процедура ВыбратьФайлExcel(Команда)

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

	Если Не Подключено Тогда
		Сообщить("Расширение для работы с файлами не установлено. Перезапустите браузер и повторите.");
		Возврат;
	КонецЕсли;

	Диалог = Новый ДиалогВыбораФайла(РежимДиалогаВыбораФайла.Открытие);
	Диалог.Фильтр = "Книга Excel (*.xlsx)|*.xlsx";
	Диалог.МножественныйВыбор = Ложь;

	ВыбранныеФайлы = Ждать Диалог.ВыбратьАсинх();
	Если ВыбранныеФайлы = Неопределено Тогда
		Возврат;
	КонецЕсли;

	Сообщить("Выбран файл: " + ВыбранныеФайлы[0]);

КонецПроцедуры

Для старых режимов совместимости используйте пару НачатьПодключениеРасширенияРаботыСФайлами и НачатьУстановкуРасширенияРаботыСФайлами с объектом ОписаниеОповещения. Синхронную ПодключитьРасширениеРаботыСФайлами() в новых конфигурациях не применяйте: при отключённом модальном режиме она вызовет ошибку.

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

Переустановка и удаление расширения

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

1. Закройте все вкладки с базой 1С.
2. Удалите дополнение «1С:Предприятие» в списке расширений браузера.
3. Удалите программную часть через Параметры Windows → Приложения — в списке она называется по имени расширения 1С:Предприятия.
4. Перезагрузите компьютер. Так процесс программной части гарантированно не останется в памяти.
5. Откройте базу и выполните действие с файлом — 1С заново предложит установку обеих частей.

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

Когда расширение больше не нужно — например, пользователь перешёл на тонкий клиент, — удалите обе части тем же способом. Ничего в базе 1С от этого не меняется: расширение хранится только на компьютере.

Расширение для работы с файлами не подключается: диагностика

Начинайте с самого простого: браузер перезапущен полностью? Половина повторных запросов уходит после закрытия всех окон. Если нет — идите по симптомам.

Где смотреть подробности

• 🧾 журнал регистрации — в БП 3.0 и ЗУП 3.1 открывается через Администрирование → Обслуживание → Журнал регистрации. Отфильтруйте по пользователю и уровню «Ошибка» за время сбоя;
• 🛠 консоль браузера — клавиша F12, вкладка консоли. Ошибки связи с расширением видны здесь, их текст пригодится администратору;
• 📂 технологический журнал — для тонкого клиента включается файлом logcfg.xml в папке conf установленной платформы. Это инструмент для администратора, после диагностики журнал выключают: он быстро занимает место на диске.

Безопасность расширений и внешних компонент

Расширение для работы с файлами даёт странице 1С доступ к диску пользователя. Поэтому несколько правил.

• ✅ Ставьте дополнение только из официального магазина браузера — Chrome Web Store или addons.mozilla.org. Копии с файлообменников не используйте.
• ✅ Программную часть берите у платформы 1С: ссылку на неё выдаёт сам веб-клиент при установке.
• ✅ COM-библиотеки берите только у производителя оборудования или поставщика сервиса. Чужая .dll, зарегистрированная в системе, получает права процесса 1С.
• ✅ В конфигурациях на БСП внешние компоненты и обращения к внешним ресурсам на сервере ограничивают профили безопасности кластера. Отключать их ради удобства не стоит.
• ✅ Не открывайте базу в веб-клиенте по ссылке из письма, если не уверены в адресе. Расширение будет работать с любой страницей, которая выдаёт себя за 1С на разрешённом адресе.

Регистрацию компонент на сервере 1С делайте вне рабочего времени. Подключение новой компоненты на сервере часто требует перезапуска службы, а это обрывает сеансы всех пользователей.

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