Как реализовать печать из веб-версии 1С на Android через внешнее приложение?

← На главную

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

Вариант 1. Использование URI-схем для вызова нативного приложения

Основная проблема заключается в том, что веб-страница, открытая в мобильном браузере, находится в "песочнице" и не может напрямую запускать исполняемые файлы или обращаться к портам устройства. Решить эту задачу можно через механизм Deep Linking или использование собственных URI-схем.

Проанализируем алгоритм реализации этого метода:

Регистрация схемы в Android-приложении: В манифесте вашего мобильного приложения (которое умеет печатать) должен быть прописан intent-filter. Например, вы регистрируете схему myprintapp://.
Вызов из 1С: В конфигурации 1С на форме веб-клиента мы можем разместить гиперссылку или программно вызвать переход по URL.

Разберем пример кода на стороне 1С для вызова приложения:


&НаКлиенте
Процедура КомандаПечать(Команда)
    // Формируем параметры: например, ID документа или ссылку на PDF
    ИдентификаторФайла = "doc_12345";
    СсылкаДляПриложения = "myprintapp://print?id=" + ИдентификаторФайла;
    
    // Переходим по ссылке, что заставит Android открыть связанное приложение
    ПерейтиПоСсылке(СсылкаДляПриложения);
КонецПроцедуры

Важный нюанс: Попытка передать весь PDF-файл в строке Base64 через URI-схему, скорее всего, провалится из-за ограничений на длину URL в браузерах (обычно около 2000 символов). Поэтому правильнее передавать только уникальный идентификатор, по которому мобильное приложение само скачает файл с сервера 1С через HTTP-запрос.

Вариант 2. Прямая печать по протоколу TCP/IP (Raw Printing)

Если ваши принтеры являются сетевыми и имеют статические IP-адреса в локальной сети, мы можем полностью исключить мобильное приложение-прокладку из цепочки. В этом случае печать инициируется сервером 1С напрямую на принтер.

Рассмотрим ситуацию, когда принтер поддерживает протокол JetDirect (порт 9100). Выясним причину, почему это удобно: сервер 1С "видит" принтер по IP, и нам не важен тип клиента (браузер на Android или компьютер).

Пример реализации отправки данных на принтер по IP из 1С:


&НаСервере
Процедура ОтправитьНаПринтер(ДанныеФайла, IPАдрес, Порт = 9100)
    // ДанныеФайла - это ДвоичныеДанные документа (например, в формате ESC/POS или PDF)
    Поток = Новый ЗаписьДанных(IPАдрес, Порт);
    Поток.Записать(ДанныеФайла);
    Поток.Закрыть();
КонецПроцедуры

Этот способ требует, чтобы принтер понимал формат данных, который вы отправляете. Большинство чековых принтеров работают с системой команд ESC/POS. Если же принтер поддерживает прямую печать PDF, вы можете отправлять двоичные данные PDF-файла напрямую в сокет.

Вариант 3. Использование Web Share API

Современные браузеры (например, Google Chrome на Android) поддерживают Web Share API. Мы можем программно вызвать системное окно "Поделиться", в котором пользователь выберет ваше приложение для печати.

Рассмотрим, как это работает: 1. 1С формирует PDF и передает его на клиент в виде ДвоичныеДанные. 2. С помощью JavaScript (через механизм ЗапуститьСценарий или через внедрение JS в HTML-поле) вызывается метод navigator.share. 3. Ваше Android-приложение должно быть зарегистрировано в системе как обработчик файлов типа application/pdf.

Это более дружелюбный интерфейс для пользователя, так как он видит стандартное меню Android, но требует написания небольшого объема JavaScript-кода внутри управляемой формы 1С.

Вариант 4. Переход на Мобильный клиент 1С

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

Преимущества этого подхода:

Доступ к библиотекам: Вы можете подключить .jar или .so библиотеки от производителя принтера через механизм внешних компонент.
Работа с Bluetooth: Мобильный клиент может напрямую работать с Bluetooth-принтерами, что практически невозможно из чистого веб-клиента.
Расширения: Вы можете использовать расширения мобильного клиента для написания кода на языке Java/Kotlin, который будет выполняться непосредственно на устройстве, обеспечивая максимальную скорость печати.

Вариант 5. Промежуточный Print-сервис на Android

Разберем еще один "промышленный" вариант. На Android-устройстве запускается фоновая служба (Service), которая открывает локальный HTTP-порт (например, localhost:8080). Веб-клиент 1С отправляет AJAX-запрос на этот локальный адрес.

Преимущество метода заключается в его надежности:

Браузер считает запрос на localhost безопасным.
Служба на Android принимает JSON с данными для печати.
Служба использует SDK принтера (те самые DLL или библиотеки производителя) для отправки задания на печать.

Для реализации этого метода в 1С используется объект HTTPЗапрос, направленный на локальный адрес устройства. Это позволяет избежать открытия новых вкладок браузера или переключения между приложениями, что значительно ускоряет работу оператора.

Подведем итог: Выбор метода зависит от инфраструктуры. Если принтеры сетевые — используйте прямую печать по IP с сервера. Если принтеры локальные (USB/Bluetooth) или требуют специфических драйверов — оптимальным будет использование URI-схем для вызова внешнего приложения или переход на Мобильный клиент 1С для полноценной интеграции с оборудованием.