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

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

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

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

Служба VintaSoft Web TWAIN (редакция Windows) обеспечивает доступ к 64- и 32-разрядным сканерам изображений TWAIN, 64-разрядным сканерам изображений WIA, сканерам изображений eSCL, если служба установлена на 64-разрядном компьютере.
Служба VintaSoft Web TWAIN (редакция Windows) предоставляет доступ к 32-разрядным сканерам изображений TWAIN, 32-разрядным сканерам изображений WIA и сканерам изображений eSCL, если служба установлена на 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.ru/zip/VintasoftWebTwainService-15.3.1.zip
Распакуйте содержимое ZIP-архива в локальную папку.
Прочитайте файл "description.txt" для информации о параметрах командной строки инсталлятора.
Запустите файл "VintasoftWebTwainService-15.3.1-setup.exe" для инсталляции VintaSoft Web Twain сервиса на Ваш Windows компьютер и следуйте инструкциям по установке.

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

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

Запустите деинсталлятор "/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.
ISTWAINSUPPORTENABLED - определяет значение, указывает на включение поддержки TWAIN. 0 - поддержка TWAIN отключена; 1 - поддержка TWAIN включена.
ISWIASUPPORTENABLED - определяет значение, указывает на включение поддержки WIA. 0 - поддержка WIA отключена; 1 - поддержка WIA включена.
ISESCLSUPPORTENABLED - определяет значение, указывает на включение поддержки eSCL. 0 - поддержка eSCL отключена; 1 - поддержка eSCL включена.
LOGGING - определяет режим ведения журнала для службы. Этот параметр может принимать следующие значения: 0 - ведение журнала отключено; 1 - ведение журнала включено; 2 - расширенное ведение журнала включено. Значение по умолчанию - 0.
Если ведение журнала включено, служба сохраняет информацию журнала для устройств TWAIN в файле журнала "C:\Users\%USERNAME%\AppData\Local\Temp\VSWebTwainService32-debug.log" или "C:\Users\%USERNAME%\AppData\Local\Temp\VSWebTwainService64-debug.log".
Если ведение журнала включено, служба сохраняет информацию журнала для устройств WIA в файле журнала "C:\Users\%USERNAME%\AppData\Local\Temp\VSWebWiaService-debug.log".
Если ведение журнала включено, служба сохраняет информацию журнала для устройств eSCL в файле журнала "C:\Users\%USERNAME%\AppData\Local\Temp\VSWebEsclService-debug.log".
ALLOWABLESESSIONINACTIVITYTIME - определяет интервал в миллисекундах, в течение которого сеанс должен быть обновлен, т.е. помечен как активный. Значение по умолчанию - 120000 миллисекунд (2 минуты). Минимальное значение - 100, максимальное значение - 3600000.

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

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

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

Информация о статусе 32-битного веб TWAIN сервиса (файл VintaSoftWebTwainService32.exe) сохраняется в лог-файле "C:\Users\%USERNAME%\AppData\Local\Temp\VSWebTwainService32.log".
Информация о статусе 64-битного веб TWAIN сервиса (файл VintaSoftWebTwainService64.exe) сохраняется в лог-файле "C:\Users\%USERNAME%\AppData\Local\Temp\VSWebTwainService64.log".

Отладочная информация о работе с 32-битными TWAIN устройствами сохраняется в лог-файле "C:\Users\%USERNAME%\AppData\Local\Temp\VSWebTwainService32-debug.log", если включено ведение журнала TWAIN.
Отладочная информация о работе с 64-битными TWAIN устройствами сохраняется в лог-файле "C:\Users\%USERNAME%\AppData\Local\Temp\VSWebTwainService64-debug.log", если включено ведение журнала TWAIN.
Отладочная информация о работе с устройствами WIA сохраняется в файле журнала "C:\Users\%USERNAME%\AppData\Local\Temp\VSWebWiaService-debug.log", если включено ведение журнала TWAIN.
Отладочная информация о работе с устройствами eSCL сохраняется в файле журнала "C:\Users\%USERNAME%\AppData\Local\Temp\VSWebEsclService-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 15.3\VintasoftTwainService.exe").
Откройте URL "https://localhost:25329/api/VintasoftTwainApi/Status" и посмотрите информацию об онлайн-статусе веб сервиса, который обслуживает HTTPS-запросы. Если URL не доступен, пожалуйста, убедитесь, что системный брандмауэр разрешает доступ к порту 25329 для VintaSoft Web TWAIN сервиса (file "C:\Program Files (x86)\VintaSoft\Web TWAIN Service 15.3\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 ("\VintaSoft\Twain .NET 15.3\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")
- Нажмите правой кнопкой мыши на иконку "Мой компьютер"
- Выберите меню "Свойства" из контекстного меню
- Выберите вкладку "Дополнительно"
- Нажмите на кнопку "Переменные среды"
- Добавить системную переменную

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