Merge pull request #548 from dynamsoft-docs/preview

Preview

Author: lunaaaw

faq/error-message-user-cancelled-the-operation.md

@@ -0,0 +1,31 @@
+---
+layout: default-layout
+noTitleIndex: true
+needAutoGenerateSidebar: true
+title: Error message - User cancelled the operation
+keywords: Dynamic Web TWAIN, Error Troubleshooting, product key does not support version
+breadcrumbText: Error message - User cancelled the operation
+description: Error message - User cancelled the operation
+permalink: /faq/error-message-user-cancelled-the-operation.html
+---
+
+# Error Troubleshooting
+
+## Error message - User cancelled the operation
+
+### Symptom
+
+You may encounter the error "user cancelled the operation" after successfully scanning all pages. But you can still run the application normally.
+
+### Cause
+
+1) The user manually terminated thte ongoing operation.
+
+2) This is known to happen if you use a WIA driver instead of TWAIN driver. Our SDK is developed based upon the TWAIN protocol, therefore the performance in WIA driver cannot be guaranteed.
+
+### Resolution
+
+To avoid issues using the WIA driver, please use the manufacturer supplied TWAIN driver.
+
+> **If you want to continue with WIA driver:**
+_You can ignore the error message since it won't affect the actual usage. Dynamic Web TWAIN will officially support WIA driver in the coming release._

faq/general-troubleshooting-steps.md

@@ -34,11 +34,11 @@ permalink: /faq/general-troubleshooting-steps.html
     }
     ```
 
-3. Reproduce the issue
+3. Reproduce the issue (If the time span of the log is greater than 3 days, please create a txt file to indicate the date when the issue occurred)
 
 4. Zip the log files and share with [Dynamsoft Support Team]({{site.about}}getsupport.html) via email.
   - On Windows, the log files are in `C:\Windows\SysWOW64\Dynamsoft\DynamsoftServicex64_17\log` or `C:\Users\{UserName}\AppData\Roaming\Dynamsoft\DynamsoftService\log`
   - On macOS, the log files are in `Go > Applications > Dynamsoft > DynamsoftServicex64_17 > {installed version No.} > log`
   - On Linux, the log files are in `/opt/dynamsoft/DynamsoftServicex64_17/log`
 
-5. Set log level back to the default value (0) to disable the debugger mode, otherwise the operation speed will be affected.
+5. Set log level back to the default value (0) to disable the debugger mode, otherwise the operation speed will be affected.

faq/how-to-exclude-wia-sources-in-the-source-list.md

@@ -15,12 +15,23 @@ permalink: /faq/how-to-exclude-wia-sources-in-the-source-list.html
 
 > Applicable to Windows only
 
-
+There are two ways to achieve this:
 
 * Set [IfUseTwainDSM]({{site.info}}api/WebTwain_Acquire.html#ifusetwaindsm) to `true`
 
 ``` javascript
 DWObject.IfUseTwainDSM = true;
 ```
 
+* Filter sources before listing them
+
+``` javascript
+var sources = DWObject.GetSourceNames();
+for (var i = 0; i < sources.length; i++) {
+    if (sources[i].toLowerCase().indexOf('wia') != -1) {
+        sources.splice(i, 1);
+    }
+}
+```
+
 If you are still having issues with a device, please feel free to [contact us](https://www.dynamsoft.com/company/contact/) via email, live chat, or phone call.

faq/index.md

@@ -359,7 +359,9 @@ permalink: /faq/
 
 <li><a href="{{site.faq}}chrome-106-107-warning.html">Warning Message - Canvas2D: Multiple readback operations using getImageData are faster with the willReadFrequently attribute set to true</a></li>
 
-<li><a href="{{site.faq}}type-error-appendchild.html">Error Message - Uncaught TypeError: Cannot read properties of null (reading 'appendChild') or Failed to execute 'appendChild' on 'Node': parameter 1 is not of type 'Node'.</a></li>
+<li><a href="{{site.faq}}type-error-appendchild.html">Error Message - Uncaught TypeError: Cannot read properties of null (reading 'appendChild') or Failed to execute 'appendChild' on 'Node': parameter 1 is not of type 'Node'</a></li>
+
+<li><a href="{{site.faq}}error-message-user-cancelled-the-operation.html">Error Message - User cancelled the operation</a></li>
  </ol>
 
 ## Licensing and Purchase