Vintasoft Web TWAIN сервис (Windows версия)

В этом разделе

VintaSoft Web TWAIN сервис (Windows версия) - это Windows сервис, который предоставляет Web API для доступа к локальным TWAIN сканерам для всех пользователей локального компьютера.

VintaSoft Web TWAIN сервис (Windows версия) - это .NET Framework 4.0 приложение, и оно может использоваться на компьютере с любой версией Windows (Windows 11/10/8.1/8/7/Vista; Windows Server 2022/2019/2016/2012/2008) с установленным .NET Framework 4+.

VintaSoft Web TWAIN сервис (Windows версия) обеспечивает доступ к 64- и 32-битным TWAIN сканерам, если сервис установлен на 64-битный компьютер.
VintaSoft Web TWAIN сервис (Windows версия) обеспечивает доступ к 32-битным TWAIN сканерам, если сервис установлен на 32-битный компьютер.

Доступ к VintaSoft Web TWAIN сервису (Windows версия) может осуществляться через HTTPS протокол с использованием URL "https://localhost:25329/api/VintasoftTwainApi" или через HTTP протокол с использованием URL "http://localhost:25319/api/VintasoftTwainApi".
Сетевые порты 25319 и 25329 могут быть изменены во время или после инсталляции VintaSoft Web TWAIN сервиса (Windows версия).

1. Инсталляция Vintasoft Web TWAIN сервиса (Windows версия) на локальный Windows компьютер

Для инсталляции Vintasoft Web TWAIN сервиса (Windows версия) на Windows компьютер, необходимо выполнить следующие действия:

Загрузите ZIP-архив с Windows инсталлятором по ссылке: https://www.vintasoft.com/zip/VintasoftWebTwainService-15.0.0.zip
Распакуйте содержимое ZIP-архива в локальную папку.
Прочитайте файл "description.txt" для информации о параметрах командной строки инсталлятора.
Запустите файл "VintasoftWebTwainService-15.0.0-setup.exe" для инсталляции VintaSoft Web Twain сервиса на Ваш Windows компьютер и следуйте инструкциям по установке.

2. Деинсталляция Vintasoft Web TWAIN сервиса (Windows версия) с локального Windows компьютера

Для деинсталляции Vintasoft Web TWAIN сервиса (Windows версия) с локального Windows компьютера, необходимо выполнить следующие действия:

Запустите деинсталлятор "<Vintasoft_Web_Twain_service_install_path>/uninstall.exe" и следуйте инструкциям по удалению.

3. Инициализация Vintasoft Web TWAIN сервиса (Windows версия)

Vintasoft Web TWAIN сервис (Windows версия) имеет файл инициализации - файл "VintasoftWebTwainService.ini", который размещается в папке сервиса.
Файл "VintasoftWebTwainService.ini" может содержать следующие параметры:

HTTPSERVICEPORT - определяет сетевой порт для веб-сервера, который обслуживает HTTP-запросы к сервису. По умолчанию значение равно 25319.
HTTPSSERVICEPORT - определяет сетевой порт для веб-сервера, который обслуживает HTTPS-запросы к сервису. По умолчанию значение равно 25329.
RUN32BITWEBSERVICE - определяет, должен ли быть запущен 32-битный веб сервис. Параметр может иметь следующие значения: 0 - должен быть запущен 64-битный сервис; 1 - должен быть запущен 32-битный сервис. По умолчанию значение равно 0.
TWAINLOGGING - определяет режим ведения журнала работы сервиса. Параметр может иметь следующие значения: 0 - ведение журнала отключено; 1 - включено ведение журнала работы; 2 - включено ведение журнала работы с расширенной информацией. По умолчанию значение равно 0.
Если ведение журнала включено, служба сохраняет лог-информацию в лог-файл "C:\Users\%USERNAME%\AppData\Local\Temp\VSWebTwainService32-debug.log" или "C:\Users\%USERNAME%\AppData\Local\Temp\VSWebTwainService64-debug.log".

4. Получение информации о статусе Vintasoft Web TWAIN сервиса (Windows версия)

Vintasoft Web TWAIN сервис (Windows версия) состоит из Windows сервиса (файл VintaSoftWebTwainService.exe), который управляет веб TWAIN сервисом, и из веб TWAIN сервиса (файл VintaSoftWebTwainService32.exe или VintaSoftWebTwainService64.exe), который обслуживает запросы к локальным TWAIN устройствам.

Информация о статусе Windows сервиса (файл VintaSoftWebTwainService.exe) сохраняется в лог-файле "<ServiceInstallPath>\VintaSoft\Web TWAIN Service v15.0\log\VSWebTwainService.log".

Информация о статусе 32-битного веб TWAIN сервиса (файл VintaSoftWebTwainService32.exe) сохраняется в лог-файле "C:\Users\%USERNAME%\AppData\Local\Temp\VSWebTwainService32.log".
Отладочная информация о работе с 32-битными TWAIN устройствами сохраняется в лог-файле "C:\Users\%USERNAME%\AppData\Local\Temp\VSWebTwainService32-debug.log", если включено ведение журнала TWAIN.

Информация о статусе 64-битного веб TWAIN сервиса (файл VintaSoftWebTwainService64.exe) сохраняется в лог-файле "C:\Users\%USERNAME%\AppData\Local\Temp\VSWebTwainService64.log".
Отладочная информация о работе с 64-битными TWAIN устройствами сохраняется в лог-файле "C:\Users\%USERNAME%\AppData\Local\Temp\VSWebTwainService64-debug.log", если включено ведение журнала TWAIN.

5. Устранение неполадок

5.1 VintaSoft Web TWAIN сервис (Windows версия) не доступен

Если Вы установили VintaSoft Web TWAIN сервис (Windows версия) на Ваш компьютер, но всё ещё видите сообщение об ошибке, что сервис не доступен, пожалуйста, выполните следующие действия:

Откройте URL "http://localhost:25319/api/VintasoftTwainApi/Status" и посмотрите информацию об онлайн-статусе веб сервиса, который обслуживает HTTP-запросы. Если URL не доступен, пожалуйста, убедитесь, что системный брандмауэр разрешает доступ к порту 25319 для VintaSoft Web TWAIN сервиса (файл "C:\Program Files (x86)\VintaSoft\Web TWAIN Service v15.0\VintasoftTwainService.exe").
Откройте URL "https://localhost:25329/api/VintasoftTwainApi/Status" и посмотрите информацию об онлайн-статусе веб сервиса, который обслуживает HTTPS-запросы. Если URL не доступен, пожалуйста, убедитесь, что системный брандмауэр разрешает доступ к порту 25329 для VintaSoft Web TWAIN сервиса (file "C:\Program Files (x86)\VintaSoft\Web TWAIN Service v15.0\VintasoftTwainService.exe").

5.1.1. VintaSoft Web TWAIN сервис (Windows версия) не работает в Windows 7 и Chrome 84+

VintaSoft Web TWAIN сервис (Windows версия) использует Transport Security Layer (TLS), который обеспечивается .NET Framework. .NET Framework использует TLS, который доступен в системе (Windows 7).
Windows 7 поддерживает только TLS 1.0 и 1.1, и это значит, что VintaSoft Web TWAIN сервис может использовать только TLS 1.0 и 1.1 в Windows 7.
Google удалил поддержку TLS 1.0 и TLS 1.1 в Chrome 84, как написано здесь. Начиная с Chrome 84 поддерживается только версия TLS 1.2 и выше.
К сожалению, Chrome 84+ может быть установлен в Windows 7, и это означает, что Chrome 84+ может использовать только TLS 1.2+ в Windows 7.
VintaSoft TWAIN JavaScript API необходимо отправлять CORS-запросы из домена веб-приложения (например, your-domain.com) к VintaSoft Web TWAIN сервису (localhost). Все современные браузеры разрешают CORS запросы к "localhost" только для HTTPS соединений.
VintaSoft Web TWAIN сервис не работает в Windows 7 и Chrome 84+, т.к. VintaSoft TWAIN JavaScript API не может создать безопасное соединение из Chrome 84+ (поддерживает TLS 1.2+) с VintaSoft Web TWAIN сервисом (поддерживает TLS 1.0 и TLS 1.1).
Если, все же, Вам нужно использовать Windows 7, пожалуйста, используйте Opera браузер вместо Chrome. Но наилучшим решением будет обновление Windows.

5.1.2. VintaSoft Web TWAIN сервис (Windows версия) не работает в Windows 7 и Firefox 74+

VintaSoft Web TWAIN сервис (Windows версия) использует Transport Security Layer (TLS), который обеспечивается .NET Framework. .NET Framework использует TLS, который доступен в системе (Windows 7).
Windows 7 поддерживает только TLS 1.0 и 1.1, и это значит, что VintaSoft Web TWAIN сервис может использовать только TLS 1.0 и 1.1 в Windows 7.
Mozilla удалил поддержку TLS 1.0 и TLS 1.1 в Firefox 74 и, начиная с Firefox 74, поддерживается только TLS 1.2 и выше.
К сожалению, Firefox 74+ может быть установлен в Windows 7, и это означает, что Firefox 74+ может использовать только TLS 1.2+ в Windows 7.
VintaSoft TWAIN JavaScript API необходимо отправлять CORS-запросы из домена веб-приложения (например, your-domain.com) к VintaSoft Web TWAIN сервису (localhost). Все современные браузеры разрешают CORS запросы к "localhost" только для HTTPS соединений.
VintaSoft Web TWAIN сервис не работает в Windows 7 и Firefox 74+, т.к. VintaSoft TWAIN JavaScript API не может создать безопасное соединение из Firefox 74+ (поддерживает TLS 1.2+) с VintaSoft Web TWAIN сервисом (поддерживает TLS 1.0 и TLS 1.1).
Если, все же, Вам нужно использовать Windows 7, пожалуйста, поищите в интернете как включить TLS 1.0 и TLS 1.1 в Firefox 74+. Также Вы можете использовать Opera браузер вместо Firefox. Но наилучшим решением будет обновление Windows.

5.2. TWAIN сканер работает не корректно

Если VintaSoft Web TWAIN сервис (Windows версия) работает, но у Вас возникли проблемы с TWAIN сканером, мы рекомендуем попробовать следующие действия:

Получите последнюю версию TWAIN драйвера для TWAIN сканера с веб-сайта производителя TWAIN сканера и переустановите TWAIN драйвер.
Убедитесь, что у Вас установлена последняя версия VintaSoft Web TWAIN сервиса (Windows версия).
Некоторые "плохие" TWAIN драйверы могут работать не верно, если приложение попытается установить "не поддерживаемые" возможности TWAIN драйвера.
Попробуйте протестировать работу сканера с помощью нашего демо приложения VintaSoft TWAIN Simple Demo ("<SdkInstallPath>\VintaSoft\Twain .NET v15.0\Bin\DotNet4\AnyCPU\TwainSimple.exe"), т.к. VintaSoft TWAIN Simple Demo - очень простое приложение, оно просто получает изображения от TWAIN сканера и не устанавливает никаких возможностей TWAIN устройства. Все остальные наши демо приложения (VintaSoft TWAIN Advanced Demo и т.д.) устанавливают возможности устройства.
Если проблема не исчезла, пожалуйста, отправьте информацию о Вашей проблеме в нашу службу поддержки, и мы постараемся Вам помочь.
Нам необходимо:
- Фрагмент Вашего кода. Рабочий проект, демонстрирующий проблему, будет приветствоваться.
- Лог-файл, сгенерированный TWAIN Data Source менеджером.
- Лог-файл, сгенерированный VintaSoft Web Twain сервисом. Пожалуйста прочитайте как включить ведение журнала для VintaSoft Web TWAIN сервиса в разделе "Инициализация Vintasoft Web TWAIN сервиса" выше.

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

Включите ведение журнала TWAIN Data Source менеджера (добавьте системную переменную "TWAINDSM_LOG" со значением "d:\twain.log")
- Нажмите правой кнопкой мыши на иконку "Мой компьютер"
- Выберите меню "Свойства" из контекстного меню
- Выберите вкладку "Дополнительно"
- Нажмите на кнопку "Переменные среды"
- Добавить системную переменную

Отправить отзыв