Sunday, March 11, 2012

Cannot Load OLE Control with IBM Datacap Taskmaster Capture

Cannot Load OLE Control with IBM Datacap Taskmaster  Capture


Abstract


When scanning using a KScan task the following error occurs:

Cannot Load OLE Control - Invalid License Information

Cause




License files have not been copied over to the install location for Kofax.


Resolving the problem




Copy all files with the extension LIC from the \Datacap\support\KScan_license folder to the C:\Program Files\Kofax\Imagctls\bin folder or wherever the Kofax Image Controls are installed.


 

Configuring RV2 for SQL or Oracle with IBM Datacap Taskmaster Capture

Configuring RV2 for SQL or Oracle with IBM Datacap


Taskmaster Capture


Abstract


How do I configure RV2 to use SQL or Oracle databases?

Answer




To configure RV2

  1. On the machine hosting RV2, open the \Datacap\RV2 folder.

  2. Backup reports.xml and then edit the original file.

  3. Change dbtype="0" to:

    • dbtype="1" for SQL Server

    • dbtype="2" for Oracle



  4. Apply for all applicable reports.

  5. Save reports.xml.

  6. Test and confirm the resolution.

  7. If errors are encountered, review user permissions for the account running the Internet Information Services (IIS) application pool for RV2. The account must be able to access the datacap.xml and application (\\.app) files on the Taskmaster Server or wherever the application files are placed.





 

Field validations succeed on dates with invalid years in IBM Datacap Taskmaster Capture

Field validations succeed on dates with invalid


years in IBM Datacap Taskmaster Capture


 


Abstract


Field validations succeed on dates with invalid years in IBM Datacap Taskmaster Capture

Symptom




Bogus date values such as 1/1/111 pass validations.


Resolving the problem




Adjust application rules to specify a date range or number of days from which the entered date is valid. Use of a regular expression to validate user data is also possible. Actions such as IsFieldDateWithinRange, IsFieldDateWithinXDays and IsPatternInField are but some of the options available in the Validations action library that can help tighten field validations to help meet business requirements

Zonal word find actions searches entire page when no zone positions are set in IBM Datacap Taskmaster Capture.

Zonal word find actions searches entire page when


no zone positions are set in IBM Datacap Taskmaster Capture.


Abstract


Field level zonal word find action searches the entire page when no zone position is set in IBM Datacap Taskmaster Capture.

Symptom




When using a word find action such as FindKeyList_InZone or RegExFind_InZone on a field with no previously defined zone, the search term is applied to the entire page.


Diagnosing the problem




The problem field will have a Position variable with value "0,0,0,0" prior to the locate action(s)


Resolving the problem




The software is working as designed and the application rules should be adjusted to handle this scenario. Calling rrCompareNot / rr_Compare_Not or rrCompare / rr_Compare prior to the word find action is one way

For example, in IBM Datacap Taskmaster Capture 8.0.1 you can call at the field level rrCompareNot(@STRING(0,0,0,0),@F.Position) prior to FindKeyList_InZone or similar actions to avoid the latter from running when there is no previously defined zone

Alternatively, you can have a single function with rrCompare(@STRING(0,0,0,0),@F.Position) followed by any appropriate actions to avoid calling rrCompareNot multiple times within subsequent functions

Taskmaster Web reporting a Capability error during scanning in IBM Datacap Taskmaster Capture

Taskmaster Web reporting a Capability error


during scanning in IBM Datacap Taskmaster Capture


 


Abstract


Attempting real scan in Taskmaster Web results in a "capability 6" or similar error

Symptom




While scanning in Taskmaster Web, a "capability 6 is not supported" message is reported. Pages fail to scan.


Resolving the problem




Capability errors reported during scanning in Taskmaster Web usually indicate a scanner problem with the Windows operating system's connectivity or device detection. If you receive a Capabilty error, perform the following steps:

1. Ensure that the scanner can scan offline using the same exact TWAIN source. A test program such as Twacker from twain.org can be used to test the TWAIN driver. Note: scanning with ISIS or Kofax is invalid since Taskmaster Web supports only TWAIN. If scanning offline fails, try restarting the scanner and/or machine. Please note that certain scanners may require that the scanner be turned on prior to starting up the PC.

 

2. If step one completes successfully, ensure that all scanner settings specified in it are identical to those used in Taskmaster Web. You can enable the "alter scan settings" check box prior to clicking Scan in Taskmaster Web to review basic and advanced scanner settings.

 

3. If scanning offline using TWAIN succeeds, using the identical scanner source and scanner settings, but the problem persists in Taskmaster Web, then ensure that all browser settings for Taskmaster Web are valid. Use the "IE Test Page" linked from the login to validate settings; let the test page completely load before clicking the Test! button.

 

4. Should the problem persist, ensure that the Windows user logged into the machine has full permissions to the local scan folder, assuming the workflow has an upload task. This folder is typically C:\Datacap\scan. Alternatively, use a local administrator account for testing.

If you continue to have problems, contact IBM Support for additional assistance




TwainPRO License Validation Check error reported during real scan in IBM Datacap Taskmaster Capture

TwainPRO License Validation Check error reported


during real scan in IBM Datacap Taskmaster Capture


Abstract


TwainPRO License Validation Check error reported during real scan in IBM Datacap Taskmaster Capture

Symptom




During real scan -- Taskmaster Web scanning with a scanner -- you may receive an error with the following message:

The Pegasus Imaging Corp. license validation check has failed for the TwainPRO control. You do not have an appropriate license to use this ActiveX control.


Resolving the problem




 

  1. Browser settings must allow for download, installation and execution of ActiveX components. Normally this is done by allowing the Taskmaster website to be in Trusted Zones, and configuring Trusted Zones settings accordingly. If using SSL, enable the browser setting "do not save encrypted pages to disk" in Tools | Internet Options | Advanced and then retest

  2. In Taskmaster Web, click the link to "IE Test Page" in the login page. Once the IE Test Page has fully loaded, click the "Test!" button and ensure that all listed items succeed. If any does not, then address each issue accordingly. Refer to the IBM Datacap Taskmaster Capture installation and configuration guide, as well as the Taskmaster Web Client Configuration utility (\Datacap\support\WebConfiguration\WebClientConfig.exe) for assistance

  3. If the problem persists, try deleting all Temporary Internet files through Tools | Internet Options | (Temporary Internet files) Settings | View Files. In Settings, also set "check for newer versions of stored pages" to "Every visit to the page". Run only the x86 version of Microsoft Windows Internet Explorer and contact IBM Support if you continue to receive the error





 

Stopping writes into the taskstats table by tmclient.exe and TMSub.exe in IBM Datacap Taskmaster Capture


Stopping writes into the taskstats table by tmclient.exe


and TMSub.exe in IBM Datacap Taskmaster Capture




Abstract


How to stop Taskmaster Client or Taskmaster Client Service from writing into the taskstats table in in IBM Datacap Taskmaster Capture

Answer




You can prevent Taskmaster Client and Taskmaster Client Service from writing into the engine database's [taskstats] table on a per task and per status basis. To do this:

1. Locate the Batch Pilot Project (BPP) file corresponding to the task for which you want to disable writing into the [taskstats] table.

2. Backup the BPP file and then open the original using Notepad or similar text editor.

3. Add section [TaskStats] if it does not already exist.

4. Under [TaskStats], add SkipTaskStatsOnStatus=x, where x is the status to avoid.

5. Repeat step #4 as many times as necessary and then save the BPP.

 

Here are the most common list of returned task statuses:

0 = Abort

1 = Canceled

2 = Finished

3 = Waiting

4 = Hold

5 = Suspended

8 = Pending

Here is an example of content from a BPP:

[TaskStats]

SkipTaskStatsOnStatus=8

 

Assuming that this was the BPP of a VScan task, Taskmaster Client and Taskmaster Client Service will avoid inserting data into the [taskstats] data when the task returns a "pending" status due to no files being found in the input folder for VScan. However, if the task returns "finished" because files are in the source directory, then a record will be inserted into the [taskstats] table by Taskmaster Client or Taskmaster Client Service.


Setting focus to a specific control in Batch Pilot Verify in IBM Datacap Taskmaster Capture

Setting focus to a specific control in Batch Pilot


Verify in IBM Datacap Taskmaster Capture


Abstract


How to set focus to a specific control in Batch Pilot Verify in IBM Datacap Taskmaster.

Answer




You can manually set focus to a specific field when the Batch Pilot verify form loads by adding ControlName.setfocus() to the end of the Pilot Form Run event where "ControlName" represents the name of the control to set focus




 

Batch Pilot scan error: "Wrong object passed as an argument" in IBM Datacap Taskmaster Capture


Batch Pilot scan error: "Wrong object passed


as an argument" in IBM Datacap Taskmaster Capture


 


Abstract


Receiving message "wrong object passed as an argument" when scanning with Batch Pilot in IBM Datacap Taskmaster Capture

Symptom




Error reported when scanning with Batch Pilot in IBM Datacap Taskmaster Capture


Resolving the problem




To resolve the issue, enable the "unload form on end batch" task setting:

1. Open IBM DatacapTaskmaster Client

2. Go to Settings | Workflow

3. Expand a job and highlight the scan task

4. Click Setup to bring up Task Setup

5. Choose File | Task Settings

6. Enable the "Unload form on End Batch" checkbox

7. Click OK, Done and then Apply/Done

8. Restart IBM DatacapTaskmaster Client and resume scanning

 

If the problem persists, try temporarily setting Task Instances to Leave Running. This is a user specific setting that must be performed on the scan machine when logged into Windows as the operator; the setting can be modified through Settings | General | Advanced.


Barcode recognition aborts with message "hDIB property was not set" in IBM Datacap Taskmaster Capture

Barcode recognition aborts with message


"hDIB property was not set" in IBM Datacap


Taskmaster Capture


 


Abstract


Barcode recognition aborts with message "hDIB property was not set" in IBM Datacap Taskmaster Capture

Symptom




Batches aborting during barcode recognition with this specific RRS log error message:

A problem was encountered while performing smooth zoom :

[....]

************************************************************

* ERROR! --> 'RRunner OnActionEnd() has caught an error from the previous action.'

* DESCRIPTION: BarcodeXpress Error. The hDIB property was not set. Please set it or adjust the ImageSource property.

* NUMERIC ID: -2147212485

* SOURCE: PegasusImaging.ActiveX.BarcodeXpress.5

************************************************************


Diagnosing the problem




Enable RRS logging and examine the RRS log reporting the aborting action in the problem batch


Resolving the problem




Upgrade to the latest software version, including Fix Packs If the problem persists, open up a service request with IBM Support and upload a sample batch for analysis to the new service request record.


 

What file types are supported by the ColorToBW actions in IBM Datacap Taskmaster Capture?


What file types are supported by the ColorToBW


actions in IBM Datacap Taskmaster Capture?



Abstract


What file types are supported by the ColorToBW actions in IBM Datacap Taskmaster Capture?

Answer




The following are supported input file formats for the ColorToBW / Color2BW actions library in Datacap Taskmaster Capture:

  1. BMP (1, 4, 8, or 24-bit)

  2. GIF (1, 4 or 8-bit), standard JPG or JPEG (8 and 12-bit grayscale and 24-bit color)

  3. PNG (1, 4, 8 and 24-bit)