1Scan
Описание
1Scan — бесплатное приложение для интеграции веб‑клиента 1С с Android‑устройством.
Приложение 1Scan внутри себя запускает веб‑клиент 1С и позволяет взаимодействовать с возможностями устройства прямо из 1С.
Просто установите, укажите веб‑адрес вашей базы 1С — и пользуйтесь привычным интерфейсом с расширенным доступом к функциям устройства: лазерный и имидж‑сканер ТСД, сканер штрихкода камерой, GPS, Bluetooth, фотокамера, NFC и многое другое.
Системные требования
Android 7.0 (API 24) и выше.
1С Платформа 8.3.16 и выше.
Прикладное решение 1C должно предоставлять доступ с помощью веб-клиента (опубликовано на веб-сервере).
Принцип работы
Приложение 1Scan служит «мостом» между мобильным устройством (ТСД, смартфоны, планшеты) и веб-клиентом 1С. Запускает ваш веб-клиент внутри самого приложения (WebView). Для этого нужно, чтобы ваша база 1С была опубликована на веб-клиенте.
Взаимодействие происходит просто: когда нужно получить данные сканера штрихкода, камеры и т. п., вы в коде 1С отправляете JSON-сообщение Android-устройству и получаете ответ с данными в интерфейсе веб-клиента для дальнейшей обработки.
Прямо из формы интерфейса 1С можно будет обращаться к функциям устройства.
Пример взаимодействия из 1С
Чтобы поступали сообщения с устройства в модуль формы, используется API интеграции веб-клиента 1С. Для этого нужно подключить обработчик сообщений внешнего сайта.
&НаКлиенте
Процедура ПриОткрытии(Отказ)
// Подключение обработчика сообщений внешнего сайта
...
ОбработчикСобытия = Новый ОписаниеОповещения("ПриПолученииСообщенияОтВнешнегоСайта", ЭтотОбъект);
ОкноВнешнегоСайта.ПодключитьОбработчикСообщений(ОбработчикСобытия);
...
КонецПроцедуры
В процедуре ПриПолученииСообщенияОтВнешнегоСайта будут приходить данные от устройства (штрихкоды, файлы и т.п.).
Отправка команды в устройство происходит в процедуре ОтправитьСообщениеУстройству.
&НаКлиенте
Процедура ОтправитьСообщениеУстройству(Запрос)
...
СообщениеСайту = Новый СообщениеВнешнемуСайту(JsonСтрокаЗапрос);
ОкноВнешнегоСайта.ОтправитьСообщение(СообщениеСайту);
...
КонецПроцедуры
Теперь можно начинать вызывать нужные функции устройства.
Пример открытия камеры сканирования:
Запрос = Новый Структура("request", "start_scan_camera");
ОтправитьСообщениеУстройству(Запрос);
Устройство получит команду. Откроет камеру со сканером штрихкодов и после считывания штрихкода пользователем отправить данные на веб-клиент 1С. В модуле формы вызовется событие процедуры ПриПолученииСообщенияОтВнешнегоСайта с полученными данными.
Еще примеры значений параметра запроса "request":
"start_scan_camera" — открытие камеры сканирования.
"show_toast" — показать системное сообщение.
"get_app_id" — получить уникальный идентификатор устройства (альтернатива MAC-адресу или серийному номеру).
Так же доступны много других функций.
Ознакомьтесь с демо конфигурацией где приведены подробные примеры кода.
Установочные файлы apk и демо конфигурация cf - файлообменник.
Быстрый старт
1С интеграция веб-клиента
Перед тем как запустить приложение 1Scan, убедитесь, что адрес вашего веб-клиента 1С доступен и запускается на вашем устройстве. Для этого в любом браузере устройства введите адрес вашей опубликованной базы, и если запускается — значит, можно
работать с приложением.
Установите приложение 1Scan из магазина Google Play или скачайте установочный apk-файл из файлообменника.
Запустите приложение. Добавьте новый клиент «1С: интеграция веб-клиента» нажав "Создать+". В «Адрес веб-клиента 1С» в поле «URL» введите полный путь адреса вашей опубликованной базы. Например,
для https://fscan.mywire.org/demo основной адрес — https://fscan.mywire.org, имя базы — demo.
Для http://localhost/demo основной адрес — http://localhost, а имя базы — demo.
Убедитесь, что поля «Основной адрес» и «Имя базы» корректно автозаполнились из «URL». При необходимости поправьте вручную. Нажмите «Ок». Заполните поля «Пользователь» и «Пароль» для входа в базу. Нажмите «Назад», вернитесь в общий список,
где появится созданное подключение. Нажмите для запуска. Запустится клиент 1С. Теперь из кода 1С можно вызывать функции ОС Android, и полученные данные будут отправляться в 1С.
Источники данных
Раздел "Источники данных" позволяет настроить, откуда приложение будет получать информацию из устройства для передачи в веб-клиент. Вы можете выбрать один или несколько источников одновременно. На этой же странице можно протестировать и увидеть результат.
Типы источников:
- События нажатий (Key Events)
Получение данных от устройств, подключенных как HID device: USB/Bluetooth сканеры штрихкодов, RFID-считыватели, физические кнопки устройства. Универсальность, не требует драйверов, работает почти с любыми устройствами. - Bluetooth
Подключение к Bluetooth-сканерам и другим устройствам. Для беспроводных сканеров, мобильных терминалов. Поддерживается Bluetooth LE и SPP (Serial Port Profile). - Broadcast Receiver (приёмник широковещательных сообщений)
Получение данных от других приложений через системные сообщения. Для интеграции с внешними системами, приложениями. Укажите фильтры сообщений и ключи данных из шаблона или вручную. - SDK
Использует встроенное ПО устройства без дополнительных настроек. Поддерживаются ТСД Atol, Urovo (получение фото штрихкода), Honeywell. - NFC
Считывание и запись NFC-меток. - Геолокация (GPS)
Получения текущих координат широты и долготы. Требует разрешение на доступ к местоположению. - Камера
Сканирование через камеру устройства. Поддержка различных режимов отображения (полноэкранный, мини-окно, прикрепленный вверх или низ). Фильтрация по типам штрихкодов (QR, DataMatrix, Code128 и др.). Варианты поведения после сканирования: автоматическое закрытие после сканирования, непрерывное сканирование, пауза между сканированиями, пропуск повторных одинаковых кодов.
Сбор данных (локальный клиент)
Позволяет собирать и хранить отсканированную информацию в виде списка внутри приложения без подключения к веб-клиенту — все данные сохраняются в памяти устройства. Поддерживается прикрепление файлов и фотографий, экспорт в текстовые файлы, ZIP-архивы, а также обмен через другие приложения. Возможна автоматическая отправка данных на HTTP-сервер и получение данных из выбранных Источников данных.