VintaSoft Twain .NET SDK 15.4: Документация для Веб разработчика
В этом разделе
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 компьютер, необходимо выполнить следующие действия:

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

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

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

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

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 в списке устройств или он работает некорректно, выполните следующие действия:
  1. Загрузите последнюю версию драйвера TWAIN для вашего сканера изображений с веб-сайта производителя сканера изображений и переустановите драйвер TWAIN.
  2. Убедитесь, что у Вас установлена последняя версия VintaSoft Web TWAIN сервиса (Windows версия).
  3. Если проблема не исчезла, пожалуйста, отправьте информацию о Вашей проблеме в нашу службу поддержки, и мы постараемся Вам помочь.
    Нам необходимо:
    • Фрагмент Вашего кода. Рабочий проект, демонстрирующий проблему, будет приветствоваться.
    • Лог-файл, сгенерированный VintaSoft Web Twain сервисом. Пожалуйста прочитайте как включить ведение журнала для VintaSoft Web TWAIN сервиса в разделе "Инициализация Vintasoft Web TWAIN сервиса" выше.

5.3. Проблемы со сканерами изображений WIA

Если вы не видите сканер изображений WIA в списке устройств или он работает некорректно, выполните следующие действия:
  1. Загрузите последнюю версию драйвера WIA для вашего сканера изображений с веб-сайта производителя сканера изображений и переустановите драйвер WIA.
  2. Убедитесь, что у Вас установлена последняя версия VintaSoft Web TWAIN сервиса (Windows версия).
  3. Если проблема не исчезла, пожалуйста, отправьте информацию о Вашей проблеме в нашу службу поддержки, и мы постараемся Вам помочь.
    Нам необходимо:
    • Фрагмент Вашего кода. Рабочий проект, демонстрирующий проблему, будет приветствоваться.
    • Лог-файл, сгенерированный VintaSoft Web Twain сервисом. Пожалуйста прочитайте как включить ведение журнала для VintaSoft Web TWAIN сервиса в разделе "Инициализация Vintasoft Web TWAIN сервиса" выше.

5.4. Проблемы со сканерами изображений eSCL

Если вы не видите сканер изображений eSCL в списке устройств, выполните следующие действия:
  1. Узнайте IP-адрес вашего Windows компьютера, узнайте IP-адрес сканера изображений eSCL и убедитесь, что оба IP-адреса принадлежат одной сети.
  2. Попробуйте использовать команду "ping" для проверки сетевого соединения со сканером изображений eSCL.

Если вы видите сканер образов eSCL в списке устройств, но он работает некорректно, выполните следующие действия:
  1. Убедитесь, что у Вас установлена последняя версия VintaSoft Web TWAIN сервиса (Windows версия).
  2. Если проблема не исчезла, пожалуйста, отправьте информацию о Вашей проблеме в нашу службу поддержки, и мы постараемся Вам помочь.
    Нам необходимо:
    • Фрагмент Вашего кода. Рабочий проект, демонстрирующий проблему, будет приветствоваться.
    • Лог-файл, сгенерированный VintaSoft Web Twain сервисом. Пожалуйста прочитайте как включить ведение журнала для VintaSoft Web TWAIN сервиса в разделе "Инициализация Vintasoft Web TWAIN сервиса" выше.