Scanner settings do not persist when scanning using Dynamic Web TWAIN Interface

In Datacap Navigator, when scanning using the Dynamic Web TWAIN Interface, the scanner settings do not persist and sometimes also causes application crash.

Symptoms

In Datacap Navigator, when scanning using the Dynamic Web TWAIN Interface, the scanner settings do not persist. This sometimes causes the application to hang and crash.

Causes

Datacap applications prior to Version 9.1.1 did not support skipping the blank pages during scan process, hence there was no option to persist the scanner setting for skipping the blank pages using the Dynamic Web TWAIN API.

Resolving the problem

User response: You can now skip the blank pages during the scan process, by using the Advanced Task scanner settings. After you configure the Skip Blank Pages option, the setting is persisted.

Perform the following steps to resolve this issue in the Datacap Navigator.
  1. Add the line of code (highlighted in the following code-snippet) as the last child element of the ScannerSet paragraph in your application scan task XML.
    Note: For OOTB application TravelDocs, the file to be updated is nscan.set.xml 
    <V label="Enable Autofeeder" n="Autofeed" tip="Controls scanner source
 - manual vs. autofeeder option" type="checkbox">1</V> 
<V label="Use Duplex Mode" n="Duplex" tip="When enabled - scans both 
sides of the image - duplex mode" type="checkbox">0</V> 
<V label="Pixel Type" n="PixelType" tip="Specify pixel type for scanning
 (0-BnW, 1-Grayscale, 2-RGB)" type="text">0</V> 
<V label="Bit Depth" n="Bits" tip="Specify bitdepth for above image type" 
type="text">1</V> 
<V label="Image Resolution DPI" n="Resolution" tip="Specify image resolution
 (X and Y resolution assumed the same) DPI" type="text">200</V> 
<V label="Paper Size" n="PaperSize" tip="Specify paper size for scanning
 (0-none, 1-A4, 2-JISB5)" type="text">0</V> 
<V label="Image format" n="Extension" 
tip="Specify extension for the scanned images: tif, jpeg, bmp, png" 
type="text">tif</V> 
<V label="Skip Blank Pages" n="SkipBlankPages" 
tip="Specify whether to discard blank pages, default is do not discard. 
For some scanners, duplex must be unchecked for this to be enabled." 
type="checkbox">0</V>
  2. Take a backup of DatacapWebPlugin.jar file before proceeding to update it, in case you need to revert the fix later.
  3. Stop the IBM WebSphere Application Server service.
  4. Replace the updated DatacapWebPlugin.jar in the Datacap installation folder.
    Note: Example: C:\Datacap\tmweb.java
  5. Start the IBM WebSphere Application Server service.
  6. Log in to admin desktop.
    Note: Example URL of Admin desktop: http://localhost:9080/navigator/?desktop=admin
  7. Click on Plug-ins, and select the Datacap Navigator. Click Edit, then Load. Next click Save and Close. Next, click Close to exit and then log out from the application.
  8. Now, log on to your desktop and test the fix. To change the skip blank pages value, go to NScan application. Open the Advanced tab. In the section Scanner Setup, select or clear the Skip Blank Pages check box.
Note: If you want to revert this fix in the Datacap Navigator, complete the steps 3 - 7 using the backed-up copy of DatacapWebPlugin.jar.