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.4.0.zip
- Распакуйте содержимое ZIP-архива в локальную папку.
- Прочитайте файл "description.txt" для информации о параметрах командной строки инсталлятора.
- Запустите файл "VintasoftWebTwainService-15.4.0-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.4\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) на свой Windows компьютер, но видите сообщение об ошибке, указывающее на недоступность сервиса, откройте веб-страницу "
https://localhost:25329/api/VintasoftTwainApi/Status
" и посмотрите информацию о сервисе VintaSoft Web TWAIN.
Если веб-страница недоступна, проверьте, установлен ли сервис VintaSoft Web TWAIN на вашем Windows компьютере.
Если веб-страница доступна, но вы видите предупреждение о подключении от веб-браузера - у вас проблема с SSL-сертификатом для веб-сайта "localhost".
Если вы не можете решить проблему самостоятельно, обратитесь в службу поддержки VintaSoft.
5.2. Проблемы со сканерами изображений TWAIN
Если вы не видите сканер изображений TWAIN в списке устройств или он работает некорректно, выполните следующие действия:
- Загрузите последнюю версию драйвера TWAIN для вашего сканера изображений с веб-сайта производителя сканера изображений и переустановите драйвер TWAIN.
- Убедитесь, что у Вас установлена последняя версия VintaSoft Web TWAIN сервиса (Windows версия).
-
Если проблема не исчезла, пожалуйста, отправьте информацию о Вашей проблеме в нашу службу поддержки, и мы постараемся Вам помочь.
Нам необходимо:
- Фрагмент Вашего кода. Рабочий проект, демонстрирующий проблему, будет приветствоваться.
- Лог-файл, сгенерированный VintaSoft Web Twain сервисом. Пожалуйста прочитайте как включить ведение журнала для VintaSoft Web TWAIN сервиса в разделе "Инициализация Vintasoft Web TWAIN сервиса" выше.
5.3. Проблемы со сканерами изображений WIA
Если вы не видите сканер изображений WIA в списке устройств или он работает некорректно, выполните следующие действия:
- Загрузите последнюю версию драйвера WIA для вашего сканера изображений с веб-сайта производителя сканера изображений и переустановите драйвер WIA.
- Убедитесь, что у Вас установлена последняя версия VintaSoft Web TWAIN сервиса (Windows версия).
-
Если проблема не исчезла, пожалуйста, отправьте информацию о Вашей проблеме в нашу службу поддержки, и мы постараемся Вам помочь.
Нам необходимо:
- Фрагмент Вашего кода. Рабочий проект, демонстрирующий проблему, будет приветствоваться.
- Лог-файл, сгенерированный VintaSoft Web Twain сервисом. Пожалуйста прочитайте как включить ведение журнала для VintaSoft Web TWAIN сервиса в разделе "Инициализация Vintasoft Web TWAIN сервиса" выше.
5.4. Проблемы со сканерами изображений eSCL
Если вы не видите сканер изображений eSCL в списке устройств, выполните следующие действия:
- Узнайте IP-адрес вашего Windows компьютера, узнайте IP-адрес сканера изображений eSCL и убедитесь, что оба IP-адреса принадлежат одной сети.
- Попробуйте использовать команду "ping" для проверки сетевого соединения со сканером изображений eSCL.
Если вы видите сканер образов eSCL в списке устройств, но он работает некорректно, выполните следующие действия:
- Убедитесь, что у Вас установлена последняя версия VintaSoft Web TWAIN сервиса (Windows версия).
-
Если проблема не исчезла, пожалуйста, отправьте информацию о Вашей проблеме в нашу службу поддержки, и мы постараемся Вам помочь.
Нам необходимо:
- Фрагмент Вашего кода. Рабочий проект, демонстрирующий проблему, будет приветствоваться.
- Лог-файл, сгенерированный VintaSoft Web Twain сервисом. Пожалуйста прочитайте как включить ведение журнала для VintaSoft Web TWAIN сервиса в разделе "Инициализация Vintasoft Web TWAIN сервиса" выше.