Как получить протокол (логи) программного обеспечения считывателей Regula?

Программное обеспечение Document Reader SDK может создавать протокол работы (лог) в виде набора служебных (отладочных) сообщений. Данные сообщения поступают от всех компонентов SDK и сопровождают операции, выполняемые программным обеспечением. В случае возникновения каких-либо ошибок и сбоев логи способны оказать неоценимую помощь разработчикам в поиске и изоляции их источника.

При нормальной работе считывателя документов служебные сообщения не генерируются. Чтобы их включить, выполните две операции:

Включите выдачу служебных сообщений основными компонентами Document Reader SDK. Соответствующая настройка может быть в вашем основном приложении для работы со считывателями. Если в вашем приложении такой функции нет, вы можете воспользоваться настройками программы Document Reader. Для этого запустите программу, используя ярлык на рабочем столе Windows (при отсутствии ярлыка поищите программу C:\Program Files (x86)\Regula\Document Reader SDK\readerdemo.exe, откройте настройки, и на первой закладке установите флаг Вести протокол считывателя.

При необходимости установите флаг протокола считывателя RFID, если возникающая ошибка затрагивает чтение RFID-микросхемы документа.

Чтобы получить и сохранить логи для последующей передачи разработчикам следует использовать специальное приложение DebugView, которое входит в комплект поставки программного обеспечения к считывателям Regula. Данное приложение (файл dbgview.exe) располагается в папке, в которую было установлено программное обеспечение Document Reader SDK.

Служебное сообщение от компонента представляет собой строку текста следующего формата:

[ID процесса] (ID потока) Компонент: {объем памяти в байтах} – время: действие/ результат

Для предоставления информации разработчикам о возникающей ошибке выполните следующие действия начиная с версии SDK 4.12.1:

1. Включите получение логов, как описано выше.
2. DebugView будет запущен автоматически в фоне и будет сохранять логи в файлы с дневной ротацией.
3. Последовательно воспроизведите все операции, приводящие к возникновению ошибки.
4. Перейдите в папку C:\ProgramData\Regula\Logs\.
5. Отправьте соответствующий файл, прикрепив его к письму, на адрес электронной почты support@regulaforensics.com.

Для версий SDK ниже 4.12.1:

1. Включите получение логов, как описано выше.
2. Запустите DebugView до запуска приложения для работы со считывателем и оставьте его работать.
3. Последовательно воспроизведите все операции, приводящие к возникновению ошибки.
4. Перейдите к приложению DebugView. Выполните команду меню File/Save as… Укажите имя файла, в который будет сохранен протокол работы программного обеспечения.
5. Отправьте созданный файл, прикрепив его к письму, на адрес электронной почты support@regulaforensics.com.