DataCap: 2012

Saturday, November 17, 2012

Error : FNP8_Upload failing when using IBM Datacap

When Exporting Documents to Filenet ,It is getting Fail

In the export.log file, the following errors were listed:

15:04:43.931 (313) t:1278 p:5E24A68 Upload failed.
15:04:43.931 (0) t:1278 p:5E24A68 ERROR!!! N-2146233088
Error description = Error executing the batch operation
....
15:04:43.932 (0) t:1278 p:5E24A68 Error (385875969=hex:17000001). In CIMainAlgorithm::execute4DCO: Aborting: Action [FNP8_Upload] requested abort [api source:]
15:04:43.932 (0) t:1278 p:5E24A68 EXCEPTION: code="385875969" msg="Aborting: Action [FNP8_Upload] requested abort" loc="CIMainAlgorithm::execute4DCO" API=""

Reason:

Upon further investigation, it was found that one of the property fields was a choice list. The export log showed that the property list was being set to "", which was not a valid selection according to the choice list definition on the customer's IBM P8 Content Engine (CE).

It was necessary to remove the blank field from the Datacap choice list and correct the spelling of all items in the Datacap choice list. The Datacap choice list and the CE choice list must be identical, since the CE is case sensitive when comparing choice list fields.

Diagnosing & Solution

Review the export.log and find all of the document properties that are being set by the function FNP8_SetProperty. Determine which ones are choice lists and what the return value is from the operator input. Verify that the spelling is identical to the CE property definition. Be aware that the spelling is case sensitive.

After the Datacap choice list content's spelling was corrected to match the CE choice list, the export operated correctly.

DotEdit does not consistently display snippets when using a custom panel

One or more fields do not have snippets displayed even if data is populated and other clients such as Taskmaster Web show them for the same batch.

Reason:

This is applicable in certain versions of DotEdit.exe where DotEdit loads panels for multiple forms. Certain fields may be shared across forms, thus resulting in this behavior.

Diagnosing & Resolving the problem

To ensure that your symptoms are applicable to this Technote, make zero changes after replicating the issue and then place the batch on hold. Re-run the batch one or more times and snippets should display every other batch or so. If snippets never display data, then it is likely a separate problem; auto-form all panels if possible to eliminate any customization as the root cause.

For performance reasons it is not desirable for DotEdit to unload and load panels dynamically. Thus to resolve this problem assign a unique Name for all dcimage (snippet) controls on custom panels being used. For example, pre-append the letter 'a' to all dcimage controls in form A, 'b' to those in form B, etc. Backup the DotEdit project files before making changes in case modifications need to be quickly reverted.

How to display validation errors for a Taskmaster Web start panel

While running validations in a start panel in Taskmaster Web, messages indicating invalid data - according to the application rules - may not be displayed. Additionally, an invalid field's background color may remain unchanged. This is a result of the field statuses not being updated.

Solution:

Call Status_Preserve_OFF from the rrunner library against the batch level node so that all start panel fields have their statuses updated upon failure of any respective field level rule. Field level MESSAGE variables will be used to indicate to the operator why any input data was incorrect, and such fields will be distinguished by a red background color. The action PilotMessage_Set from the rrunner library can be leveraged to compose custom validations failure messages.

Task setup error - Wrong number of arguments or invalid property assignment: SetProfileString in Datacap

When trying to save task settings in Taskmaster Client, the following error is displayed:

Wrong number of arguments or invalid property assignment: 'SetProfileString'

When trying to run the task, receive the error:
Type mismatch: 'Pilot.MsgLog'

Reason & Solution

This happens when the task module is configured to Batch Pilot DLL

To overcome this Change the task module's program name to Batch Pilot (BPilot.exe) and then re-test.

Rulesets library collection.xml isn't loaded error reported in Taskmaster Web

Taskmaster Web reports an error when running rules or validations, the error states "rulesets library (collection.xml) isn't loaded" similar to the following screenshot:

Reasons:

Cause of this error is when the [dco] table of the admin database has a dco_id value that is not identical to the corresponding workflow name.

Solution:

Open the admin database and then the [dco] table. The value listed inside the dco_id column should be identical to the first part of the dco_setup, and also identical to the workflow name listed inside Taskmaster Application Manager. This name should also be specified inside the \Datacap\\dco_\rules\collection.xml files.

For example, Flex contains the following default values:dco_id = Flex
dco_setup = Flex@C:\Datacap\Flex\dco_Flex\Flex.xml
Taskmaster Application Manager:

collection.xml = <rsapp name="Flex">

Make all values uniform across your configuration. Once finished, restart the Datacap Taskmaster Server Service to ensure that changes take effect and are not cached by Taskmaster Server. If all values specified are valid, then double-check file permissions for the application pool identity running Taskmaster Web, ensure that the error received is identical to that listed in the Symptom section of this Technote, and then engage IBM Support for further assistance as necessary.

Cannot get data from Application Service with Datacap

When attempting to run a task using Rulerunner, the task aborts. The quattro0.log shows:

Error: RunGrabbedQNRelease: Error preparing task. Cannot get data from Application Service. Key:[tasks/VScan:profile], attempt #[0]. Error from DCApp:[]

Reasons:

Rulerunner references configuration settings in the Quattro tab in Taskmaster Application Manager. If they are incorrect, this error will occur.

Solution:

To correct the configuration:

Run Taskmaster Application Manager.

Select the application on the left and click on the Quattro tab.

Locate the profile for the task that is failing.

Change the spelling of the Task and Task profile name to exactly match the name of the Task as shown in Datacap Studio. This name is case-sensitive. If there is no entry for the Task, then add it.

Exit Taskmaster Application Manager and restart Rulerunner.

Reasons to Batch going into offline status

When a batch is inaccessible, it immediately is placed into offline status by a client. Ensure that:

1. The batch directory exists at the listed folder path

-- Click or double-click on batch ID in Job Monitor for this value

2. The Windows user has sufficient privileges to the batch directory

3. There are no network issues from the client PC to the server

Once these have been confirmed, simply rollback the batch to "pending" or "hold" status and reprocess.

Note: Network logs should be audited around the times batches are run and placed into "offline" status if the issue becomes problematic.

Error starting client service in Taskmaster Client Service Manager - Cannot start service DCTMSub on computer

Reason:

This error message is commonly displayed if the account running the Datacap Taskmaster Client Service on the Rulerunner has insufficient permissions to the local machine, or if the service is disabled.

Solution:

Open the Services control panel from Administrative Tools:

1. If the service's start up mode is disabled, then change it to be automatic or manual.

2. Set the service account to a local administrator account that has sufficient permissions to network resources such as the batches directory and application rules files.

Note: Test after making required changes. If the problem persists, consider performing a repair or reinstall of the Taskmaster software using a local admin account.

Running a custom .NET Taskmaster action results in batch aborting with RRS log message "couldn't load needed object"

Signs:

Batch logging will state something similar to the following:

Error (385875972=hex:17000004). In CCom::Call: Couldn't load needed object: Datacap.Libraries.vScanSample.Actions into Datacap.Libraries. vScanSample.Actions instance [api source:]

Reason:

This issue can occur if the .NET action components are not installed properly.

Solution:

When using the vScanSample .NET template actions available from the IBM Datacap Taskmaster Capture 8.0.1 Publication Library, compiling the project will generate new files including interop DLL's, vScanSample.dll, vScanSample.tlb and vScanSample.pdb. Place vScanSample.dll into \Datacap\dcshared\NET and register it using regasm.exe and the /codebase flag:

C:\Windows\Microsoft.NET\Framework\v2.0.50727\RegAsm.exe C:\Datacap\dcshared\NET\vScanSample.dll /codebase

Re-run the actions when finished to confirm the solution.Note: If the problem persists with a more customized project then unregister the main DLL and place it into a sub-folder along with all other compiled components (interops, main DLL and TLB file). Re-register vScanSample.dll using regasm.exe and the /codebase flag before reprocessing; the set of files specific to your project can be isolated afterward.

How to set Hotkeys in IBM Datacap Taskmaster Batch Pilot Verify

Steps to create custom a custom hot key:

1. Open verify DCF form in Batch Pilot.
2. Go to Form > Hotkeys.
3. Make sure the Form button is pressed.
4. Place cursor in 'Selected key combination'.
5. Press the hotkeys wanted for use.
6. Add Title of hotkey.
7. Click the Add button.
8. Note the Hot Key index number.
9. Add the Hot Key index value as a new Select case in the Pilot_OnHotKey event with the desired code. For example if the HotKey index is 10 the Select Case needs to be Case 10.
10. Save form.

Is the "LOOKUP" variable, that is added to a line item field, supported to work in the thin client verify panel prelayout.aspx

No, unfortunately prelayout.aspx does not have the capability for line item fields to be filled in with values based on a Lookup. Neither does aptlayout.aspx. Pages that can perform this capability are averify.aspx, and aindex.aspx.

How can you programmatically send keystrokes in Batch Pilot

To send keystrokes via Batch Pilot scripting, you can invoke the WScript.Shell object's SendKeys method. The following is an example for sending Ctrl + N:

Dim shell

Set shell = CreateObject("WScript.Shell")

shell.SendKeys("^n")
Set shell = Nothing

Note: Some hot keys may be alternatively accomplished. For example, calling Pilot.BatchContinue is equivalent to clicking the Navigate to Next Problem button

Taskmaster Application Manager crashes when updating one or more fields in Datacap

Taskmaster Application Manager crashes when updating one or more fields with the message box stating "Debug Error! [...]" is displayed.

Signs:

Fields in Taskmaster Application Manager are disabled. Editing fields causes the following "Microsoft Visual C++ Debug Library" message box:

"Debug Error! \ Program: C:\Datacap\tmclient\DCOrchard.exe \ abnormal program termination \ (Press Retry to debug the application)

Pointing to a Datacap.xml in another environment may work.

Reason:

The application file, <app_name>.app, is locked

Solution:

First confirm that this Technote applies to your situation. See other Technotes for other scenarios where similar but not exactly identical behavior may apply. Some of those resolutions include:

- Installing Datacap Studio on the machine running Taskmaster Application Manager

- Installing IBM Datacap Taskmaster Capture 8.x on UAC-enabled PC's using Run as Administrator

- Installing Microsoft.NET Framework 3.5.1

Second, confirm that your problem is not resolved when right-clicking and running the Taskmaster Application Manager shortcut or executable using the Run As Administrator command.

Third, confirm that all following paths point to the correct locations:

1. Path to datacap.xml file as indicated in Service tab of Taskmaster Application Manager:

- x64: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Datacap\Application\Location\'TopPath'

- x86: HKEY_LOCAL_MACHINE\SOFTWARE\Datacap\Application\Location\'TopPath'

2. Path to the general Datacap application folder inside the datacap.xml file

- This is inside the "ref" tag, which generally defaults to a local path or folder

Fourth, ensure that the Windows user has full sharing and security permissions to the application file. Try creating a file or folder where the application file is located.

Lastly, see if using the Taskmaster Application Manager when pointed to another environment works and/or if there are locks against the application file in question using a program such as Microsoft's Process Explorer.

Note: In case the application file is locked, try rebooting the server on which the application file is hosted. If this is the Taskmaster Server, this will affect all clients, including Rulerunners, Taskmaster Client and Taskmaster Web. Alternatively, try using a program such as Process Explorer to detect and kill any unnecessary file locks. The latter must be done carefully and is not generally recommended.

Is Net Framework 4.0 compatabil with Datacap on Microsoft Server 2008 R2 64 bit

No, IBM Datacap Taskmaster Capture was built to run on Microsoft .Net 3.5.1 framework. It has not been fully tested to be run with .Net 4.0.

Batch Pilot hangs after a period of inactivity in DataCap 8.0.1

IBM DataCap 8.0.1 Batch Pilot hangs when a user tries to open Batch Pilot after an hour of inactivity. This is reproducible using the Window 7 (64 bit) OS with the workstation attached to scanner.

Reason

The Taskmaster components are native 32-bit, requiring that the PixTools/ISIS version used is 32-bit as well. If the ISIS driver installed is 64-bit , a hang situation will occur in Batch Pilot.

Environment

Window 7 64-bit, DataCap 8.0.1 and ISIS Driver 64-bit.

Solution:

Install the 32-bit ISIS driver.

Manual/Automatic(NENU) Roll back to reset batches left in running or aborted status

Certain errors can prevent a task from completing successfully. The batch or batches affected may be left in running or aborted status. By design such batches require intervention before they can advance in the workflow. A privileged operator can manually reset them, or NENU can be configured to automatically reset them on a schedule.
This document explains general roll back scenarios and procedures but it is not a substitute for procedures and instructions which

In the course of processing a batch of documents, Taskmaster may encounter internal or external errors. If the software is unable to continue, or fails to update the batch status in the Engine database for any reason, the affected batch will remain in running status. If the error is not recoverable or if data integrity could be compromised by continued operation, the batch will be set to aborted status. In either case, the batch will not advance until a human operator or an automated process resets or "rolls back" the batch.

Basic manual roll back procedure

The simplest way to roll back a batch is to set its status to Pending. An operator holding Job Monitor and Status change/rollback privileges can perform this in the Job Monitor. In Taskmaster Web click on the Batch ID (in the Batch column). In the resulting dialog, change the Status to pending. In most cases this is sufficient and the batch will be picked up and processed by the task that previously failed. If the error condition has been resolved the batch will advance in the workflow, if not it may be left running or aborted again.

How to tell if a batch in running status is taking a long time, or is actually stuck

Before resetting a batch from running to pending status, check that the batch is actually stuck as opposed to simply taking a long time to complete the task. The simplest way to approach this is to estimate the longest time any batch takes to complete this task (you can factor in the size of the batch), and add 50%. If the task is taking longer than that it is probably stuck. To increase your confidence you could 1) check system logs, 2) for an interactive task you could check the operator or workstation for recent activity, or 3) for a background process you could check logs and system activity on the workstation that was last processing the batch.

Advanced roll back scenarios and procedures

If the task which failed cannot be safely run twice in a row, some additional steps are required.

Before rolling back batches in a production environment you should confirm that the task involved is safe for rollback, and/or follow roll back instructions for your specific application.

For example if a batch creation task (Vscan, email input, fax input, etc.) fails after some images have already been ingested, a person or a process must ensure that those images are not lost. It may be necessary to re-insert those images into the input stream before rolling the batch back.

Tasks that perform file format conversion, image processing, or other one-way operations can typically be rolled back, but in some cases the Page file must be reset to its previous value. If image processing includes operations such as erosion, dilation, or unconditional rotation, the original image files must be restored.

Export tasks or tasks that modify external data are only safe for rollback if they explicitly keep track of each external transaction, and prevent re-execution of those transactions when the task runs more than once on the same batch. All of the IBM repository connectors include this feature and thus are safe for rollback.

In some cases it may not be safe or practical to roll a batch back in the current task, but it is safe to roll it back to its initial state after batch creation, or to some intermediate state. In this situation, the files in the batch should be restored to the desired state, the Task ID reset to the desired task for processing, and the Status set to Pending.

Automated roll back with NENU

In any of the above scenarios, the roll back procedures that can be performed manually can also be automated. The NENU utility and the is designed for this purpose. NENU can be configured to run on a schedule, or NENU rules can be run continuously via a NENU task configured in Rulerunner Server. NENU actions suitable for roll back rulesets include QuerySetStatus, QuerySetTaskID, QuerySetAge, ProcessChangeBatchStatus and ProcessRunQuery, For advanced roll back scenarios, FileIO actions may also be useful. Documentation for NENU can be found in the Taskmaster InfoCenter. NENU actions are documented in Datacap Studio action help.

Datacap Taskmaster 8.1 Client Support for Microsoft Windows® XP SP3

The client components of Datacap Taskmaster 8.1 are supported under Microsoft Windows® XP SP3. This note describes Taskmaster client installation, configuration and usage specific to Microsoft Windows® XP.

Abstract:

IBM only certifies the Microsoft Windows^® XP SP3 platforms for the Datacap Taskmaster 8.1 client component.

IBM does not support the Microsoft Windows^® XP SP3 platform to run the Datacap Server component.

Datacap Taskmaster Datacap 8.1 thick client installation
The standard method of double-clicking the Setup icon produces an error message, stating that the operating system is not supported.

To install Taskmaster Client v8.1 on Windows XP^® SP3, you must run the installer from a DOS command prompt, as follows:

Choose Start ->Programs->Accessories->Command Prompt

At the command prompt, type the command to run the Taskmaster installer. For example if the installer is on a DVD or flash drive mounted on F: type
F:\setup.exe /V"OS_OVERRIDE=1"
including the quotation marks.

You can install the full Taskmaster 8.1 product or select the client component. However, only the clients are supported on Windows XP.

Accessing Taskmaster Web
To access Taskmaster Web from a Windows XP client, use Microsoft Internet Explorer (IE) version 8 or above. Browser security settings need to be configured according to the documentation, either manually or by using the Web Client Configuration tool. Use the Taskmaster Web Test tab on each web client to confirm correct configuration. Taskmaster Client installation is not required to use Taskmaster Web.

Log files and configuration information
Log files and stored configurations for thick clients including Datacap Studio, DotEdit, DotScan, and DCOrchard are generated in C:\Documents and Settings\\Local Settings\Application Data\IBM, where is the Windows user that ran the component.

How to update fingerprint statistics such as the hit count and last hit date in Datacap

Fingerprint statistics can be very useful when auditing a system and determining which fingerprints are most frequently used. Metrics such as the number of times a fingerprint has been used in its lifetime and the last date it was used can be used to remove unnecessary fingerprints from the system during maintenance periods. This cleanup may improve performance when loading fingerprints and decrease the size of the setup hierarchy (unless FPXMLs are enabled) due to removal of fingerprint zones.

Solution:

Updating fingerprint statistics can be performed through application rules via the UpdateFingerprintStats action of the autodoc library. This action may be named UpdateFPStats in certain versions of the software. It updates the [Template] table of the fingerprint database by incrementing the tp_HitCount column's integer value and also updating the tp_LastHit column's date for the associated fingerprint ID.

Execution of UpdateFingerprintStats requires an open connection to the fingerprint database using OpenConnection action from the Lookup library, prior to calling UpdateFingerprintStats. It is recommended that any database connection be later closed, using CloseConnection or equivalent logic.

How to use an ODBC data source in the Lookup variable in Datacap

The Lookup variable allows certain clients such as askmaster Web to provide to operators a link for querying a database and presenting returned data for population. An OLEDB example can be found within foundation applications and general documentation such as Application Development using IBM Datacap Taskmaster Capture.

Solution:

Use dsn="DSN=..." notation, particularly when supplying the user name and password in cases where credentials are not stored within the ODBC data source.

Here is an example using a SQL fingerprint database:
TestFP;User ID=uid;Password=pwd">SELECT tp_TemplateID FROM Template

Note: In this example the Vendor field will be updated with whatever value is stored in the template ID (tp_templateID) column of the record that the operator selects. The user name "uid" and password "pwd" are used to login to the SQL database corresponding with the DSN "TestFP"; please note that TestFP is not necessarily the exact database name.

SuperVars and application rules do not execute simultaneously in ProtoID.aspx in Datacap

When configuring a web FlexID (ProtoID) task to use SuperVars and also to run a task profile, only the custom rules are used and executed.

Solution:

ProtoID.aspx is working as designed, which is to run SuperVars or a specific task profile. To resolve the problem, modify your application rules to use either a task profile or super variables.

No fingerprint/RulesDB connection Established error in Datacap

Cause

This error indicates that the software failed to connect to the Fingerprint/Rules Database. Typical causes are that the server which the Fingerprint/Rules Database resides on is disconnected from the network, the user attempting to access the database does not have sufficient permissions, or the database has been corrupted.

Solution:

If using an Access Database type for the Fingerprint/Rules Database, backup the database and then run a Compact and Repair on it to resolve the error.

When using Microsoft Access admin/engine databases in Datacap ,Applications are getting slow.

Clients such as Taskmaster Client and Taskmaster Web are slow in an environment containing one or more applications that have Microsoft Access admin and engine databases in IBM Datacap Taskmaster Capture

Latency may be apparent in client such as Taskmaster Client and Taskmaster Web when attempting to view the Job Monitor, Operations page, workflow, etc.

Reason:

Only Taskmaster Server communicates to the admin and engine databases. In cases where either database is large, communication may be slow, which may lead to other certain incoming requests (e.g. Job Monitor page, running a new batch) to become backed up. When using multiple applications, one application's databases may impact other applications if they share the same Taskmaster Server.

Solution:

Microsoft Access is not recommended in large scale environments, SQL Server or Oracle should be considered depending upon volume. However, even small volume systems using Microsoft Access may be affected over time if older batches and task statistics are not removed. Resolution steps A and B are recommended.

A) Decrease the size of the databases by removing or transferring any older unnecessary data. Deletion or transfer of database records is facilitated by NENU or AutoDelete, where NENU replaces AutoDelete in IBM Datacap Taskmaster Capture 8.0.0 and later. What data can or cannot be deleted or transferred will depend upon corporate policy and requirements:

1. Admin database - the [audit] table can be cleared if login and logoff records are not required.

2. Engine database - batches and task statistics can be removed based on a date range adequate for applicable retention policies.

i. Task statistics are contained in various tables such as [de2kst], [scan2kst], etc.
ii. Records for batches visible in the Job Monitor are stored in [queue], [qstats] and [tmbatch].

iii. The [debug] table will contain a record for each transaction that updates a batch status -- writing to debug is enabled on a

client basis and will quickly grow.
Note: if updating the engine database manually (e.g. external to NENU), it is generally recommended to keep the file system and database in sync in some manner.B) Compacting and repairing the Microsoft Access databases regularly during maintenance windows is recommended. It is feasible to automate compact and repair using some program or batch file. The databases should be compacted and repaired after using NENU or AutoDelete to clean up the databases.

Older,Same batch is displayed in a Taskmaster Web session in Datacap

When trying to run a shortcut or batch in Taskmaster Web, a previously worked batch is displayed to the operator

Signs:

An operator clicks on an Operations shortcut link or attempts to run a batch manually through the Job Monitor, but the batch attempting to be selected is not displayed; instead a batch that was previously worked on by the user during his or her Taskmaster Web session is brought up.

Note: These symptoms occur even if Taskmaster Web (IIS) and Internet browser settings are configured to not cache pages, and even when bypassing the load balancer if one is applicable to the environment.

Reason:

If an operator starts a batch but does not finish it correctly, then this behavior will occur. That is to say, the operator did not cancel the batch, place it on hold, or submit/finish it. In many cases the user may have navigated away from the batch using the Internet browser's navigation buttons rather than the Taskmaster Web content buttons.

Solution:

This feature is by design for data integrity reasons. To avoid these symptoms or resolve them when they occur, the operator should use the appropriate Taskmaster Web buttons to release the original batch per normal processing. For example, in Verify the operator should index and Submit all pages or place the batch on hold. Once the batch has been processed and released per normal business procedures, the user will be able to move on to any other batch.

XML document must have a top level element error reported in Datacap

Description:

Message "Could not load application descriptionXML document must have a top level element" during rules execution or when running Setup on the task in Taskmaster Client:

Reason:

The workflow name is case and space sensitive and if the name is not synchronized in the environment then this message may result.

Solution:

Stop and close any open clients, including background services, before attempting resolution.

1. Open Taskmaster Application Manager and select your application

2. Place the cursor into the workflow name(s) and write down the name(s) exactly

3. Open your datacap.xml file using Notepad or any other text editor

- Exact path to datacap.xml is listed in the Service tab of Taskmaster Application Manager

4. Locate your application reference (there should only be one), ensure that the ref="path" is a valid relative or UNC path and write

down the 'app name' exactly as listed

5. Open the admin database's [dco] table and write down the values for the dco_id and dco_setup columns

Compare values retrieved from the admin database, datacap.xml file and the application file (Taskmaster Application Manager). The workflow name must be uniform across all entries, including case and space sensitivity. Update any values that require changes, save all modifications, and then open a new client to test and confirm resolution.

Note: It is recommended that to backup the database, datacap.xml file and application file (*.app inside the application folder) prior to any changes.

Unable to login to two applications simultaneously in Datacap

When attempting to login to a specific application, login fails unless another application is closed and stopped from all clients and services, including Rulerunner Quattro and Taskmaster Web.

Reason:

Taskmaster Server tracks which applications which are connected to the server using the db_index column stored inside the admin and engine databases (the value is identical between the two databases). If creating a new application or deploying a configuration such that the db_index values are not unique across all applications, login issues may result.

Diagnosing the problem

Login succeeds using a static set of credentials if and only if one or more additional applications are not being used (either by an operator or a background service). If enabling verbose Taskmaster Server logging, a line similar to the following is reported in the Taskmaster Server log file:

Database index 156 is the same for 'C:\Datacap\Flex\FlexAdm.mdb' and 'C:\Datacap\APT\APTAdm.mdb'. Thread: 8dc

Solution:

Update the db_index value inside the offending application(s)' admin and engine databases. The values are stored inside the [adminfo] and [enginfo] respectively. It is recommended that you use a random 3-digit number that will be unique for the application; once set, the db_index column value inside the [admin] and [engine] databases for that single application should be identical.

Note: If batches were previously scanned then it is required to update the engine database's [queue] table such that the qu_admDB column is updated to reflect the new db_index value. Otherwise such previously scanned batches will not be visible in the Job Monitor.

InstallingTaskmaster Web controls in Datacap Manually

Taskmaster Web installs various controls for certain functionality such as interfacing with scanners. These controls are normally downloaded and installed automatically when accessing the website with proper browser settings and user permissions. However, there may be rare cases due to corporate security / user environment where manual installation may be desirable or required.

Steps to install components used for physical scanning:
1. Login to the end user's machine with an account that has rights to install and register files
2. Make \Datacap\tmweb.net\Task\twpro.cab from Taskmaster Web available on the end user's machine
3. Extract the contents of twpro.cab into a new folder
4. Copy all extracted files into %windir%\system32 and, if present (x64 OS), %windir%\SysWOW64
This is typically C:\Windows\system32 and C:\Windows\SysWOW64
5. Right-click and run Command Prompt with the "Run As Administrator" option if User Account Control (UAC) is enabled
6. Execute the following command, adjust paths as necessary:
C:\Windows\system32\regsvr32.exe C:\Windows\system32\TWNPRO3.dll

Steps to install general Taskmaster Web files:
1. Login to the end user's machine with an account that has rights to install and register files
2. Make \Datacap\tmweb.net\Task\dcim.cab from Taskmaster Web available on the end user's machine
3. Extract the contents of dcim.cab into a new folder
4. Copy all extracted files into %windir%\system32 and, if present (x64 OS), %windir%\SysWOW64
This is typically C:\Windows\system32 and C:\Windows\SysWOW64
5. Right-click and run Command Prompt with the "Run As Administrator" option if User Account Control (UAC) is enabled
6. Execute the following commands, adjust paths as necessary:
regsvr32 C:\Windows\system32\DcEdit.ocx
regsvr32 C:\Windows\system32\dcimage.ocx
regsvr32 C:\Windows\system32\dcthumbs.ocx

Cross Check
Ensure that all other prerequisites mentioned in the installation and configuration guide such as the ability to run ActiveX components are met before confirming resolution.

Using LDAP or ADSI with RV2 in Datacap

In addition to any configuration within Taskmaster Server Manager, RV2 has its own requirement when using ADSI or LDAP authentication.

Taskmaster Server Manager offers multiple authentication systems for login. When using ADSI or LDAP authentication, password authentication is not performed and login is based on membership within certain AD/LDAP groups and their inclusion within the Taskmaster Administrator's Groups tab.

Solution:

RV2 has an EnableLDAP setting specific for ADSI and LDAP authentication. If left to the default of false, then login to RV2 will require that the operator enter a non-blank password even though password authentication will not be performed. Any login attempt without a password specific will fail and the user ID will generally include the domain name, e.g. DOMAIN\username.

To set the EnableLDAP option:

Make sure no operators are using RV2 to avoid them having his or her session abruptly terminated during this time. This can be enforced at server side by stopping IIS or the application pool servicing RV2.

Backup \Datacap\RV2\web.config using copy and paste.

Edit web.config using Notepad.

Locate the following line:
<add key="EnableLDAP" value="false"/>

Change "false" to "true":
<add key="EnableLDAP" value="true"/>Save changes.

In Datacap Taskmaster web,After scanning Batch contains document structure

After scanning through Taskmaster Web, the corresponding scan page file contains a document node.

Solution:

To avoid a document structure from being created at time of scanning:
1. Locate the ICP or BPP file corresponding to the Taskmaster Web task
2. Backup the file and open the original using a text editor like Notepad
3. Browse to the [General] section and add a CreateDoc=0 setting:
[General]
CreateDoc=0
<other settings>
4. Save changes and scan a new batch
The newly created batch will not contain a document structure if steps are followed correctly.

How to enabling verbose Taskmaster Server logging in Datacap

By default the installed version of logging for Taskmaster Server is a lightweight version. This version is sufficient to log many errors, but does not offer full logging. For troubleshooting ADSI or LDAP authentication, or reviewing all low-level queries in depth given a particular problem, verbose Taskmaster Server logging may need to be enabled.

Enabling verbose logging requires a one-time step of replacing dclog.dll in the tmserver folder, which means that the server service must be stopped temporarily. Enabling, disabling or truncating the log can be done transparently.

Steps to Replacing DCLog.dll :

1. Stop and close all clients and background services
2. Backup \Datacap\tmserver\dclog.dll on Taskmaster Server
3. a) Stop the Datacap Taskmaster Server Service
b) Close the Taskmaster Server Manager
4. Replace \Datacap\tmserver\dclog.dll using a copy of \Datacap\dcshared\dclog.dll
Note: Do not move or rename the dcshared file
5. Start the Datacap Taskmaster Server Service

Steps to Enabling Taskmaster Server Logging:
1. Open Taskmaster Server Manager on Taskmaster Server
2. Go to Logging -> Datacap Log
3. Configure logging parameters:
a) Output to file = Enabled
b) Number of Messages = All or a sufficient level
c) File path and name = Normally a local disk with sufficient space
d) Reflash buffer = Normally disabled, enable if immediate log writes are required
e) Write to common buffer = Disabled
4. Click Save
5. Click Yes to immediately load settings

Steps to Disabling Taskmaster Server Logging:
1. Open Taskmaster Server Manager on Taskmaster Server
2. Go to Logging -> Datacap Log
3. Disable 'Output to file'
4. Click Save
5. Click Yes to immediately load settings
Steps to Truncating a Taskmaster Server Log:
1. Open Taskmaster Server Manager on Taskmaster Server
2. Go to Logging -> Datacap Log
3. Enable or disable and re-enable 'Overwrite existing log file'
4. Click Save
5. a) Click Yes to immediately load settings
b) Disable 'Overwrite existing log file' if desired, Save and click Yes

Note: Disk consumption should be closely monitored when logging is turned on, with full logging severity the log file can have a very rapid growth rate.

Datacap Taskmaster Application Manager is disabled

Taskmaster Application Manager can be opened but when selecting an application, all fields are disabled (greyed out) such that settings cannot be altered through the user interface.

Reason & Solution

This issue is typically caused by one of two items:

1. A restricted version of Taskmaster Application Manager is being used

2. The application file has been previously locked, e.g. by another user

To eliminate the first possibility, close Taskmaster Application Manager and run it only on a machine where Datacap Studio has been previously installed. Continue below if the issue is not resolved.

Close any known open instance of the Taskmaster Application Manager and re-test. Should the problem persist, browse to the application folder where the application file (*.app) resides and identify if there is a lock file (*.app.lock). Identify and close the instance of the Taskmaster Application Manager that created the lock file; if confident that the application is not locked elsewhere, backup all files within the folder, delete the lock file manually, and test again.

If all else fails, reboot the machine, test, and then contact IBM support if not successful.

Path1 cannot be NULL error received when calling the DeleteFingerprints Action

Abstract

When calling the Datacap DeleteFingerprints function, the following error is in the rss log:
System.ArgumentNullException: Value cannot be null. Parameter name: path1
at System.IO.Path.Combine(String path1, String path2)
at Datacap.Libraries.FingerprintMaintenance.Actions.DeleteFingerprint(String ID)

Signs

The application aborts when trying to delete fingerprint files and fingerprints from the fingerprint database. The fingerprint is deleted from the database, but the fingerprint files are not deleted from the fingerprint folder.

Reason & Solution

The path to the fingerprint folder does not exist.

To resolve this add the following call to the application:

SetFingerprintDir("@APPPATH(fingerprint)") --to set the path to the folder that contains the fingerprint files.

Saturday, August 11, 2012

when using RightFax, batches contain images that were imported in previous batches

This is due to the cache problem. To overcome this Problem Images must be deleted in RightFax after they are imported to avoid importing them again.

To delete images in RightFax after they are imported, add the action SetFaxRemovalAfterImport(True) prior to the ImportFaxes action.

At Scan or Fixup task, Insert button inserting Images in reverse order

The Insert button is designed to only insert single images, and should not be used to scan in multiple images.

If we insert multiple images , the images placed in reverse order in hierarchy.

To insert multiple images, use the Append button instead.

Using mapped drives in Datacap

How to use a mapped drive to point workstations to a Datacap Server ?

Solution

Using a mapped drive is not recommended, particularly with newer operating systems, as Microsoft is limiting access to mapped drives from a service. Instead, use the UNC path (e.g. \\servername\sharename) to point the workstation to the server.

Take Emails as input with no attachment

Take Emails as input without attachment

procedure to import emails if there are no attachments :-

The ewsmail action library states that it is used for importing image attachments from email messages. Although this is its primary use, it does provide a method of importing emails even when there is no attachment.

Solution

To import all emails, even if there is no attachment, use the ex_types action leaving the parameter field blank.

Thursday, August 9, 2012

Scanning Driver Support in IBM Datacap Taskmaster Capture 8.0.1 and above

Query

What scanner drivers are supported in IBM Datacap Taskmaster Capture 8.0.1 and above?

Answer

IBM Datacap Taskmaster Capture 8.x supports scanning directly through both the ISIS and TWAIN APIs. The three types of scanning supported in IBM Datacap Taskmaster Capture 8.x are thick client scanning ISIS scan, ISIS fixup, and thin client TWAIN scan. In either case IBM Datacap Taskmaster Capture 8.x supports scanning "through" Kofax VRS drivers, underneath the ISIS and TWAIN layers. In the case of ISIS the ISIS driver is called "pixkofax"

Please note that in IBM Datacap Taskmaster Capture 8.x, IBM does NOT support the classic thick Kofax scan task (kScan) from IBM Datacap Taskmaster Capture 7.x and older, that goes direct to the Kofax ImageControls API.

Setting Up Taskmaster Web Client Service for the Automation of Uploading Batches in IBM Datacap Taskmaster Capture

Query

How can I setup the Taskmaster Web Client Service to automate the upload of web scan batches?

Answer

1. Install the Taskmaster Web Service by running Setup.exe found in the \Datacap\support\WebClientService folder.

2. Double click on \Datacap\tmclient\dc2Run.exe.config. This will allow you to configure the parameters used by this service.

3. The dc2Run.exe.config file has a section for a ShortcutIndex. You can determine what index value corresponds to what shortcut by looking it up in the Buttons Table of the Administrator Database. Update this index to run the upload shortcut..

4. In the dc2Run_localhost_utility section of the dc2Run.exe.config file change the server from “localhost” to your server name or IP address.

5. Update the application name in the Application Settings section of the file to specify your application name.

6. Update the user name in the user section to the user you want to log in and run the upload task.

7. Upload the station name in the station section from “remote” to the station you want the service to log in with.

8. Add the following xml text into the tabs.xml file which is located in the \Datacap\tmclient folder:

<section name="dc2run">
<key.named.list name="Users" kxp="dc2run/?" itemname="User" valuemask="{0}">
<pwd name="password" kxp=":pwd" tip="Set passwords for upload service user"/>
</key.named.list>
</section>

6. Launch DCOrchard.exe whose executable is located in the \Datacap\tmclient folder:
There will be a new tab called dc2run. Under this tab add your user and password which will be used to log into the service with. The user name and password are stored in the applications .app file with the password encrypted.

Note: The user name needs to match the user name that was configured in the dc2Run.exe.config file.

8. To test the uploading of batch first log into Taskmaster Web, scan can at least one batch, and then start the Web Client Service from the Window Services Control Manager. The station that you use to create batches that will be uploaded by the Web Client Service have to be created logged in as the same station that is configured in the dc2Run.exe.config file.

9. After you start the Web Client Service, confirm that the batches have been uploaded.

Saturday, July 28, 2012

Optimizing barcode recognition with IBM Datacap Taskmaster Capture

Problem

What can be done to give the best recognition results in Datacap Taskmaster?

Cause

During printing, the ink can bleed or spread out over the white area, and then, during scanning, additional spreading of black may occur. As a result, the white spaces end up disappearing and the bars blend into each other. This can be seen by looking at the scanned image at high magnification. The barcode must meet the specifications after accounting for this.

Solution

To optimize barcode recognition:

The width of the thinnest bar (called the X-dimension) must be at least one pixel, and two pixels are recommended for best results. At 200 DPI this means each bar must be at least .01 inch. Generally this translates to about 4 to 5 characters per inch.

The X-dimension or width of the narrowest black bar and white space between bars must be at least 20 mils (1/50 inch, 1/2 mm). When scanned perfectly at 200 DPI this would result in 4 pixels, and at 300 DPI 6 pixels.

For Code 39 symbols: a 20 mil X-dimension results in a density of approx 3.6 characters per inch. Optimally the height should be at least 1/4 inch or 15% of the width, whichever is greater, though this is not an absolute requirement. The minimum quiet zone (white space before and after the bar code) specified by the standard is 1/5 inch.

Scanning can sometimes introduce white or black stripes on the image running in the scanning direction, typically vertical stripes if the paper is scanned in Portrait orientation. Bar codes printed in normal horizontal orientation cannot be read reliably when this occurs. It is advisable to print barcodes perpendicular to the direction of scanning. If the barcode must be printed horizontally on a page, scanning in landscape orientation will make the barcode more robust in the presence of common scanner issues.

By default, Taskmaster Capture only accepts high confidence barcode images. To modify it to accept low confidence barcodes also, add the following action to run prior to barcode detection:

Performing image enhancement (ImageFix) prior to running any barcode recognition action can possibly degrade the barcode, lowering recognition. If it is necessary to use image enhancement prior to barcode recognition, pay close attention to the configuration settings, especially vertical line removal and despeckle. To ensure image processing is not interfering with barcode recognition, test with the ImageFix() action removed.

Verify unable to populate fields during Click n Key in IBM Datacap Taskmaster Capture

Abstract

The fields are not getting populated during Verify in Taskmaster when selecting data from a page (Click n Key).

Cause

Full Page Recognition action was never called.

Resolving the problem

Recognize Page ruleset must call a Full Page Recognition action from ICR, OCR or OCRA in order for Click n Key to work properly.

Tuesday, July 24, 2012

How to restrict batches with IBM Datacap Taskmaster Capture

How to restrict batches with IBM Datacap Taskmaster Capture.

Abstracct

How can users be restricted to run only their own batches in Taskmaster Client or Taskmaster Web?

Solution

To have users scan, upload and verify only their own batches (or something similar), use the Store and Queue To task settings specified in Taskmaster Administrator's Workflow tab.

Run Taskmaster Client or Taskmaster Web.

Select Settings, Workflow in the client or go to Settings tab of Administrator in Taskmaster Web.

Highlight each Task in turn, and set the following:
- Queue To - Select the option on how batches need to be restricted.
- Store - Select the information that needs to be stored. Note that Queue To settings will not work properly if the needed information was not set to Store in the previous Task.

Select the Users tab if using TMA or LLLDAP authentication; else navigate to the Groups tab.

Highlight each user or group for which this restriction will apply and uncheck the Priority/Operator/Station change or Priority/Operator change privilege under the Job Monitor section.

By design the Store and Queue To settings will not have the same behavior in Taskmaster Client for pending batches. For example, a Verify pending batch may be run by any user, not necessarily by the operator who originally scanned the batch. However, batches that are in hold status can be limited to the operator that originally ran the task (e.g. Verify).

Note: This requires that the general Job Monitor not be used to run the batch. Batches should be run through the Operations panel or tab.

Example configuration:

Scan - (Store) Station and User

Upload - (Queue to) Same station same user

Verify - (Queue to) Same user

In this example, all batches scanned by a user will be uploaded only when logged into Taskmaster Web with the same user name and station ID, where the operator is a restricted user, and selecting the appropriate Operations shortcut. The same batches will be verified when logged into Taskmaster Web with the same user name, but not necessarily the same station ID.

Tuesday, July 17, 2012

How to make a Batch Pilot combo box list read only in IBM Datacap Taskmaster Capture

Question

How to make a Batch Pilot combo box control drop down list read only.

Cause

By default, users may be able to type custom values into the control.

Answer

To make the control read only:

Open the form in Batch Pilot standalone and select the combo box.

Right-click and choose Properties.

Update Style to 2 - DropDownList.

Apply and save changes. Users will only be able to select a list option once accessing the updated form.

Using the Match Required and Locked properties can also provide similar behavior.

Saturday, July 14, 2012

How to configure NENU for Windows authentication with IBM Datacap Taskmaster Capture

Question

My Taskmaster Server service uses Windows authentication (ADSI, LDAP, or LLLDAP). How do I configure NENU to authenticate to the Taskmaster Server service?

Answer

Employ the SetUser action to specify the Windows user name to use for authentication.

example: SetUser(MyDomain\UserName)

Note: The SetPassword action is not used for this type of authentication and should not be included in the NENU ruleset.

Rebuild button missing on Fixup window with IBM Datacap Taskmaster Capture

Abstract

When performing a Fixup operation, the Rebuild button is not visible.

Cause

Feature is not enabled in Task Settings.

Resolving the problem

To enable the Rebuild button:

In Taskmaster Client, select Settings, Workflow.

Expand the Fixup job, highlight the Fixup task, and select Setup.

Check Allow Assemble and click Done, Apply, Done.

Why is an error received when IBM Datacap Taskmaster Client Service VScan accesses a remote directory?

Abstract

IBM Datacap Taskmaster Client Service reports 'Folder ... does not exist' on the VScan rule action SetSourceDirectory(), where the directory path is a remote shared directory.

Symptom

Remote shared directory is specified using UNC path such as \\server\share.

Remote directory does exist.

Taskmaster Client (thick client) works (without reporting the error).

Taskmaster Client Service Logon User is set to a user having full permission to read/write to the remote directory.

Remote share is a Unix-hosted file system.

vscan_rrs.log reports Error: Folder '\\server\share' does not exist.

Cause

The Logon ID format is not accepted by the remote host.

Environment

Windows 2008

Resolving the problem

Change the Taskmaster Client Service Windows service Logon ID from a "User1@Domain" format to a "Domain\User1" format. For example, use the format FINANCE\jdoe instead of jdoe@FINANCE.local.

Monday, July 9, 2012

Action execution failed with SetPassword in IBM Datacap Taskmaster Capture

Abstract

When running NENU, it fails on the SetPassword action with the following error:

13:45:13.811 (93) t:12E8 p:35FEED8 Error (-2147352567=hex:80020009). In CCom::Call: Action execution failed: object [Datacap.Libraries.Nenu.Actions] method [SetPassword] [api source:]

Cause

There is no password defined in the SetPassword action. This most commonly occurs when setting up a NENU ruleset to connect using Windows (NTA) authentication, as NTA authentication does not use a password.

Resolving the problem

If no password is needed, remove the action completely. Do not leave it in the ruleset with a null parameter.

Sunday, July 1, 2012

Can Fixup rescan in duplex or multi-stream with IBM Datacap Taskmaster Capture?

Abstract

When scaning a batch using duplex and/or multi-stream, can the Rescan button be made to rescan in duplex or multi-stream also?

Answer

No. Only simplex rescanning is supported with the standard Fixup screen.

Action execution failed with SetPassword in IBM Datacap Taskmaster Capture

Abstract

Cause

Resolving the problem

If no password is needed, remove the action completely. Do not leave it in the ruleset with a null parameter.

Lookup column headers in wrong order with IBM Datacap Taskmaster Capture

Abstract

When using the Lookup field variable with Taskmaster Web, selecting the field lookup link during Verify brings up a window with Lookup results. In the window, the column headers do not align with the column data.

Symptom

When a column is selected, data posts correctly. That is, it posts to the fields as defined in the Lookup variable, not as shown in the Lookup window.

Cause

The column headers are being listed in alphabetical order, not the order defined in the Lookup variable. This has been identified as a product defect under APAR IO16583

Resolving the problem

The workaround is to list the database fields in alphabetical order within the SELECT query when configuring the Lookup variable.

Saturday, June 16, 2012

User unable to run batches from the Taskmaster Client Job Monitor in IBM Datacap Taskmaster Capture

Abstract

An operator cannot run batches through Taskmaster Client's Job Monitor window.

Symptom

When logged into Taskmaster Client, the operator can only run batches using an Operations shortcut. Running a batch through the general Job Monitor does not work by double-clicking the QID or Job Monitor record number, and the Record | Execute menu option is disabled.

Cause

The user or group is missing the Run Task dialog privilege.

Resolving the problem

Grant the user or group the 'Run Task dialog' privilege.

Run Taskmaster Client and login as admin or a user with full rights.

From the Settings menu select Users (or Groups).

Highlight the user (or group) to grant the privilege to and check the Run Task dialog box.

Click Apply, then Done to close the window.

Note that the 'Run Task dialog' privilege allows users to run any batch listed in the Job Monitor regardless of his or her user/group and station permissions. Granting this privilege to specific users or groups will depend upon exact business requirements.

Thursday, June 14, 2012

Can Line Item Grids be nested in IBM Datacap Taskmaster Capture?

Question

Can Line Item Grids be nested in a Datacap Taskmaster application? That is, can a Line Item Grid reside inside each line item of another Line Item Grid?

Answer

No. The actions from the Invoice Action Library that handle Line Item Grids require predefined fields defined for that fingerprint. The autoformed fields generated by those actions do not meet that requirement.

However it is possible to create Line Item Grids where a Line Item is more than one line, as long as the format for each multiline Line Item is the same. For example, an invoice contains the quantity and price on one line, but the description is on the next line, such as:

Line 1 - Quantity/Price of first item.

Line 2 - Description of first item.

Line 3 - Quantity/Price of second item.

Line 4 - Description of second item.

To set this up as a Line Item Grid, follow the standard procedure as defined in the Datacap Taskmaster Application Guide, except that when you define the zone for the Line Item, have it encompass both Lines 1 and 2.

Configuring Taskmaster Client login information for IBM Datacap Taskmaster Capture

Configuring Taskmaster Client login information for

IBM Datacap Taskmaster Capture

Question

How can Taskmaster Client login information be stored or configured to change the default behavior? Can an INI file or registry entry be used?

Cause

IBM Datacap Taskmaster Client can obtain much of the required login information from stored locations, or from command line flags. The working StationID, the address or host name of the Taskmaster Server, and the database connection strings can be stored in the registry, in one or more configuration (INI) files, in the IBM Datacap Taskmaster Client shortcut target, or in a combination of these locations.

Answer

When Taskmaster Client is started from a shortcut with a “target” command line such as “c:\Datacap\tmclient\tmclient.exe –ic:\Some.ini” the Admin and Engine database connections (e.g. DSNs) are retrieved from \Some.ini.

The Station ID is normally stored in HKEY_CURRENT_USER\Software\Datacap\Task Master Client\Station. The Host name is stored in HKEY_CURRENT_USER\Software\Datacap\Task Master Client\NetTM. When Taskmaster Client is run from a command line with the flag /INI (e.g. “c:\Datacap\tmclient\tmclient.exe /INI”) it retrieves the Station ID and Host name from “c:\windows\tmclient.ini” and the database connection strings from “c:\Datacap\tmclient\tmclient.ini”. Using the -s flag allows the Station ID to be specified at the command line. For example
C:\Datacap\tmclient\tmclient.exe -s3
will cause Taskmaster Client to set Station ID to 3 when logging in.

To use INI files instead of the registry entries, start with command line flag
-iC:\Datacap\tmclient\tmclient.ini – This file should already exist.

To create c:\windows\tmclient.ini from the registry, run the command
C:\Datacap\tmclient\tmclient.exe /REG:INI.

A shortcut such as “c:\Datacap\tmclient\tmclient.exe –iC:\Some.ini /INI” retrieves the Station ID and Host name from “c:\windows\tmclient.ini” and the database connections strings from “C:\Some.ini”.

Wednesday, June 13, 2012

How to add a lineitem before or after the current one in Batch Pilot Verify in IBM Datacap Taskmaster Capture

How to add a lineitem before or after the current one in Batch

Pilot Verify in IBM Datacap Taskmaster Capture

Question

How to add a lineitem before or after the current one in Batch Pilot Verify in IBM Datacap Taskmaster Capture

Answer

Applications such as APT and MClaims provide the ability to add and remove lineitems. When adding a new lineitem, it may be placed either before or after the one already being reviewed by the operator. APT offers two buttons in order to allow operators to create a lineitem either before or after, however they desire; in other applications, the default behavior may only be present for a newly created lineitem to be placed before the one that already has focus.

This default behavior can be changed by setting the AddAfter variable to True inside the panel scripting. The value of the variable is checked by the AddField subroutine, which is standard within an auto-formed panel. For example, if there is only one button within the panel to add lineitems, this could be set at the global level. If adding another button to mimic APT, the variable could be set to True or False accordingly inside the button click events.

Example:

btnAddBefore_Click

Call AddField("Lineitem")
btnAddAfter_Click
AddAfter = True
Call AddField("Lineitem")
AddAfter = False

An Internal 500 error reported when attempting to log into Taskmaster Web Server 8.0.1 in IBM Datacap Taskmaster Capture

An Internal 500 error reported when attempting to log into

Taskmaster Web Server 8.0.1 in IBM Datacap Taskmaster Capture

Abstract

When an Active Directory user password is changed, users are not able to log into Taskmaster Web Server with the updated password. Instead, an "Internal 500 Error.. " is reported

Cause

Complete update procedures not run

Resolving the problem

The following settings are need to be updated when Active Directory user passwords are changed:

1. Launch IIS Manager (Windows 2008 Server)
2. Select "Default Website" and in the "Actions" menu > "Basic Settings" > "Connect As", update the User account's password.
3. Verify that this change was propagated in
Default Website > tmweb.net > Go to the "IIS" section and right-click on "Authentication > Basic Settings > "Connect As" button.
4. Restart and Test.

ProtoID does not display thumbnails for newly inserted pages in IBM Datacap Taskmaster Capture

ProtoID does not display thumbnails for newly inserted pages

in IBM Datacap Taskmaster Capture

Abstract

ProtoID does not display thumbnails for newly inserted pages in IBM Datacap Taskmaster Capture

Symptom

1. Thumbnails do not display during ProtoID for newly inserted pages

2. Error message after finishing the batch that is similar to the following:

unable to open file C:\Datacap\Flex\dco_Flex\blank.tif

Resolving the problem

In order to resolve this problem, copy \Datacap\Flex\dco_Flex\blank.tif and paste it into your application's directory where the BPP or ICP used by ProtoID is stored.

Please note: Normally this path is located on the Taskmaster Server or where application files are centrally stored. The account servicing the Datacap Taskmaster Server Service must have read permissions to the image, and the image must be named "blank.tif".

OpenTextFaxServer actions abort with COM error in IBM Datacap Taskmaster Capture

Abstract

OpenTextFaxServer actions abort with a COM error in IBM Datacap Taskmaster Capture?

Symptom

The RRS log contains the following error:
Retrieving the COM class factory for component with CLSID {D7CA3941-DA83-4C87-949A-60DF378DD68E} failed

Cause

Issues with the RightFax v9.x client on the machine where the OpenTextFaxServer actions are being run

Resolving the problem

Install or repair the RightFax v9.x client on the machine where the OpenTextFaxServer actions are being run. RightFax client must be able to successfully login using the same parameters (e.g. server name and user credentials) without error externally from Taskmaster.

Taskmaster Client Service reporting trying again messages in IBM Datacap Taskmaster Capture

Taskmaster Client Service reporting trying again messages in

IBM Datacap Taskmaster Capture

Abstract

Taskmaster Client Service reporting trying again messages in IBM Datacap Taskmaster Capture

Symptom

In the Application Event Viewer logs or the Taskmaster Client Service disk log, you may occasionally notice "trying again" messages being reported by the service. For example:
Abnormal RunGrabbedQNRelease termination [rethrow to release batch] [Exception during running task]
trying again [1 of 3]

This may be most prevalent on machines performing VScan.

Resolving the problem

These messages are informational in nature and are not indicative of problems that need to be addressed. If the Datacap Taskmaster Client Service encounters an internal error during batch processing or attempting to grab a batch to perform work, then it will perform a retry of the failing operation. These retry attempts normally succeed on the first retry and thus transparently prevent issues as a result of the initial failure

Please Note: Application rules requesting an abort do not constitute an error in this context. The task and RRS logs should be audited in such cases and are not relevant to this Technote.

Single sign-on using Taskmaster Web in IBM Datacap Taskmaster Capture

Question

How to use automated or single sign-on and page redirection with Taskmaster Web in IBM Datacap Taskmaster Capture

Answer

Starting in IBM Datacap Taskmaster Capture 8.0.1 Fix Pack 3, it is feasible to use single sign-on to login to Taskmaster Web and have the operator automatically redirected to a particular page. To do this certain data must be submitted to the website using an HTML form or some equivalent. The form should be placed into the website where Taskmaster Web is run; failure to do so may not yield the anticipated results.

Here is an example HTML form as reference:
<form method="post" action="http://server/tmweb.net/default.aspx" id="frm1" name="frm1">
<input type="hidden" id="hdApp" name="hdApp" value="APT"/>
<input type="hidden" id="hdFuid" name="hdFuid" value="admin"/>
<input type="hidden" id="hdPwd" name="hdPwd" value="admin"/>
<input type="hidden" id="hdStn" name="hdStn" value="remote"/>
<input type="hidden" id="hdRedir" name="hdRedir" value="jmonitor.aspx"/>
<input type="Submit" value="Submit">
</form>

Names of the form elements must be identical. The 'hdRedir' element defines where to redirect users after login and it can be a shortcut to run a batch (e.g. button.aspx?ID=# as obtained by hovering over a shortcut link in the Operations tab), or in the above example, the Monitor page. For ADSI or LDAP authentication the 'hdPwd' element should be left blank.

Note: During logout or session termination users will be returned to the referring URL where the original logion request originated from.

Unable to open file in Taskmaster Web with IBM Datacap Taskmaster Capture

Abstract

On exiting Verify in Taskmaster Web, an error is displayed stating:

unable to open file C:\Datacap\(application)\batches\(batchname)\

Symptom

There will be no filename listed as part of the error, and the error may be repeated.

Cause

The rrCopy action was used to copy from a batch level field to a field located at some other level in the DCO hierarchy. This action also brings across underlying properties, including the imagefile property. Taskmaster Web attempts to locate the file specified in that property, then generates an error since the value is blank.

Resolving the problem

Use the rrSet action instead. This copies only the value of the field without bringing across the underlying properties.

ADSI or LDAP login for Taskmaster Web requires a blank password in IBM Datacap Taskmaster Capture

ADSI or LDAP login for Taskmaster Web requires a blank

password in IBM Datacap Taskmaster Capture

Abstract

When logging into Taskmaster Web with ADSI or LDAP authentication, the password field must be left blank

Cause

ADSI and LDAP authentication do not perform password authentication as documented in the following IBM technote:
Using Windows Active Directory, LDAP, or LLLDAP Authentication with IBM Datacap Taskmaster Capture

Taskmaster Web requires that the password field only be completed when using TMA or LLLDAP authentication.

Resolving the problem

Leave the password field blank in the login screen for Taskmaster Web.

Please note: As of the latest release and Fix Pack, only the application name (case sensitive) and a valid station ID (with sufficient virtual stations) are required for successful login to Taskmaster Web when Taskmaster Server is configured to use ADSI or LDAP authentication.

RV2 login failure when user does not have permission to view reports in IBM Datacap Taskmaster Capture

RV2 login failure when user does not have permission to view

reports in IBM Datacap Taskmaster Capture

Abstract

RV2 login failure when user does not have permission to view reports in IBM Datacap Taskmaster Capture

Symptom

Resolving the problem

Grant the user or group the Report Viewer privilege through Taskmaster Administrator.:

Please note: In Taskmaster Client's version of Taskmaster Administrator this will be stated as the "Report Viewer | Autodelete" privilege under Client(s), while in Taskmaster Web will state "Report Viewer" as the privilege. Autodelete is a client only applicable to legacy software versions, not available in Taskmaster 8.0.0 and later, and thus can be ignored.

Thursday, June 7, 2012

How to rearrange Job Monitor columns in IBM Datacap Taskmaster Capture

Abstract

How to change the order of the Job Monitor columns when running the DatacapTaskmaster Client?

Cause

Job Monitor columns can be dragged and dropped to new locations, but these settings are lost when exiting Taskmaster Client unless additional steps are taken.

Answer

To permanently configure the Job Monitor column order:

With Taskmaster Client running and the Job Monitor window open, drag and drop the columns into the desired order.

Close the Job Monitor window directly. Do not close Taskmaster Client.

Click Yes when prompted whether to make this the default layout.

Monday, May 28, 2012

Can Line Item Grids be nested in IBM Datacap Taskmaster Capture?

Abstract:

Can Line Item Grids be nested in a Datacap Taskmaster application? That is, can a Line Item Grid reside inside each line item of another Line Item Grid?

Answer

MClaims Application ICD-10 Compliance in IBM Datacap Taskmaster Capture

Abstract:

Is the MClaims application for IBM Datacap Taskmaster ICD-10 Compliant?

Answer

The MClaims application has support for ICD-10 built in to the code. However, revised forms are still being released by the regulatory agency, and so compliancy for any given form is dependent on it having been released long enough to be added to the MClaims application. Customers should test any form they use to confirm it meets ICD-10 compliancy standards.

Saturday, May 12, 2012

VScan intermittently aborts with IBM Datacap Taskmaster Capture

VScan intermittently aborts with IBM Datacap Taskmaster Capture Quattro

Abstract

When running VScan using Rulerunner Quattro, intermittent aborts occur. This may happen even with long periods of inactivity or when no images are waiting to be processed.

Symptom

This issue can also cause Rulerunner Quattro to appear to hang.

Cause

When VScan is run by Rulerunner Quattro, it repeatedly checks for incoming files, with no delay between requests. This can create too much overhead for the file system to keep up with, causing file access to fail and the batch to abort.

Resolving the problem

Configure Rulerunner Quattro to add a small delay between reruns of VScan.

Run Rulerunner Quattro Manager.

On the Datacap Quattro tab, stop the service.

On the Datacap Login tab, click Connect.

On the Workflow tab, expand the hierarchy on the right and highlight VScan.

In the Settings section in the lower right, set skipsamebatch to 1.

Highlight the line labeledabove VScan in the thread hierarchy.

Set skipsamebatch to 1 there also.

Click Save, then go back to the Datacap Quattro tab and start the service.

Friday, May 11, 2012

Rulerunner Quattro running on the same server as IBM Datacap Taskmaster Capture

Rulerunner Quattro running on the same server as

IBM Datacap Taskmaster Capture

Question

Can Rulerunner Quattro run on the same server as the IBM Datacap Taskmaster Server Service?

Answer

Rulerunner Quattro can be run on the Taskmaster Server, but only under the following circumstances.

The server is part of a Development or Test environment, not a Production environment.

Rulerunner is configured with a limited number of tasks, such that it leaves sufficient CPU resources for the Taskmaster Server Service to run.

Rulerunner Quattro is designed to run on its own server and can easily consume all of the available CPU resources when given multiple Tasks and/or multiple threads to process simultaneously. As a result, competition with the Taskmaster Server Service for the available resources can cause timeouts and other failures in either service.

Replaced actions when upgrading IBM Datacap Taskmaster Capture

Question

After upgrading from Datacap Taskmaster 7.6 to 8.0.1, there are some actions that no longer exist. What actions should be used to replace the old actions?

Cause

Newer actions created with Datacap Taskmaster 8.0.1 in some cases included the functionality of older actions, so those older actions have been removed.

Answer

7.6 action --> 8.0.1 action

SaveAsBatchVariable --> rrSet

MinimumLength --> IsFieldLengthMin

MaximumLength --> IsFieldLengthMax

Is_GreaterThan --> IsFieldGreaterOrEqual

Is_LessThan --> IsFieldLessOrEqual

ClearFieldValue --> ResetField

Default_Value --> AssignFieldDefault

Note that there may be some differences in how the parameters are specified and the functionality may not be identical, so parameters may need to be adjusted and tested to ensure that the functionality is maintained. Documentation on the new actions can be found by right clicking on them in Datacap Studio.

Sunday, May 6, 2012

Documents exporting to wrong folder in IBM Datacap Taskmaster Capture

Documents exporting to wrong folder

in IBM Datacap Taskmaster Capture

Abstract

When exporting documents to the Unfiled Documents folder in IBM FileNet P8 Content Engine, they export to the root folder instead.

Cause

This has been identified as a product defect with the FNP8_SetDestinationFolder action, and is tracked under APAR IO15939.

Resolving the problem

Install 8.0.1.3 Test Fix FNP8Actions:0609577 located on Fix Central.

Wednesday, May 2, 2012

SplitBatch only creates one child batch in IBM Datacap Taskmaster Capture

SplitBatch only creates one child batch in

IBM Datacap Taskmaster Capture

Abstract

When SplitBatch is run by Rulerunner Quattro, it only creates one child batch instead of the number of batches dictated by the SplitBatch rules. This problem does not occur if SplitBatch is run by Taskmaster Client.

Symptom

Batch priorities are also set incorrectly when SplitBatch is run by Rulerunner Quattro.

Cause

This has been identified as a product defect under APAR IO15741.

Environment

Datacap Taskmaster 8.0.1 Fix Pack 3

Resolving the problem

Download and install Interim Fix 8.0.1.3-Datacap-Taskmaster-WIN-TestFix-Quattro0228:0609577.

Go to the IBM Fix Central Identify Fixes page.

Select Individual Fix ID and enter:
8.0.1.3-Datacap-Taskmaster-WIN-TestFix-Quattro0228:0609577

Select Continue and step through the remaining screens to download the fix.

Read the readme file for instructions and restrictions prior to installing.

Batch aborts running NENU actions in Taskmaster Client with IBM Datacap Taskmaster Capture

Batch aborts running NENU actions in Taskmaster Client

with IBM Datacap Taskmaster Capture

Abstract

When attempting to run the NENU ProcessChangeBatchStatus, ProcessChangeBatchStatusOrder, or ProcessChangeBatchStatusTaskOrder actions in Taskmaster Client along with the actions required prior to these, the batch finishes with a status of aborted, even though no reasons are provided in any of the logs

Cause

Although it is allowable in general to run NENU actions with Taskmaster Client, they were designed and tested to be run by the NENU application. Some NENU actions that manipulate batch properties interfere with Taskmaster Client's manipulation of those properties

Resolving the problem

Only run the ProcessChangeBatchStatus, ProcessChangeBatchStatusOrder, or ProcessChangeBatchStatusTaskOrder actions with NENU

Batch aborts running SetFieldLocateVariables with IBM Datacap Taskmaster Capture

Batch aborts running SetFieldLocateVariables

with IBM Datacap Taskmaster Capture

Abstract

When running a batch within a Flex application, the batch aborts on the SetFieldLocateVariables action

Symptom

The RRS log shows:

Error: ADODB.Recordset
Description: Either BOF or EOF is True, or the current record has been deleted. Requested operation requires a current record.
Error code: 0x800a0bcd - (null)Source: (null)
Line: 2418, Char: 9 [api source:]

Cause

The SetFieldLocateVariables action accesses the Flex database to get the field information for that Document Type (Fingerprint Class). If that information is missing or misconfigured, this error can occur.

Resolving the problem

Run FlexConfigurator.exe, located in the dco folder for the application, and then make sure that all fields for that Document Type are correctly defined.

Tuesday, April 24, 2012

Color images are not separating properly in IBM Datacap Taskmaster Capture 8.0.1

Color images are not separating properly in IBM Datacap

Taskmaster Capture 8.0.1

Abstract

Color images are not separating based on the predefined color fingerprint images in Datacap Taskmaster 8.0.1.

Cause

Color images are not supported in Taskmaster Capture 8.0.1.

Resolving the problem

Use only black/white images for fingerprinting.

For best results use 300 DPI black/white, resolution quality.

Saturday, April 21, 2012

What are the Microsoft Primary Interoperability Assemblies 2005 used for in IBM Datacap Taskmaster Capture?

What are the Microsoft Primary Interoperability

Assemblies 2005 used for in IBM Datacap

Taskmaster Capture?

Abstract

What are the Microsoft Primary Interoperability Assemblies 2005 used for in IBM Datacap Taskmaster Capture?

Answer

The Microsoft Primary Interoperability Assemblies 2005 are used by the IBM Datacap Taskmaster Capture software for some Purchase Order Line Recognition (POLR) functionality present within the APT application.

If the assemblies fail to install and POLR is not a requirement, the corresponding POLR action and button can be removed through Datacap Studio and Batch Pilot stand-alone in the APT application rules and Verify form respectively. Otherwise the assemblies can be installed separately on the machines that will be running POLR.

How to migrate fingerprints with IBM Datacap Taskmaster Capture

Abstract

How to migrate fingerprints between applications.

Cause

Migrating fingerprints is not as simple as copying the directory and the database. All of the following must be considered:

Fingerprint database (including Template table)

Fingerprint directory

Fingerprint zones

Fingerprint database connection string

Answer

Fingerprint Database and Directory
For Taskmaster versions 7.6 and newer, first use the Fingerprint Maintenance Tool to export from the source application and then import into the destination application. Specific instructions for using this tool are located in the Datacap Taskmaster Application Development Guide.

For Taskmaster versions 7.5 and older, the database and directory will need to be manually copied.

Zone Information

For versions prior to 7.6, or upgraded applications where the zone information was not stored in the FPXML file, the zone information is contained in the setup hierarchy, located in the (application).xml file. Manually edit the file and copy and paste the zone information across to the new setup hierarchy. Zone information will look something like:

Fingerprint Database Connection String

The database connection string may need to be manually changed after migrating the fingerprint database.

Datacap Taskmaster 8.0 and newer

Run Taskmaster Application Manager.

Highlight the application.

Update the Fingerprint database field located under the workflow.

Datacap Taskmaster 7.6 and earlier

Run Datacap Studio and login to the application.

On the Zones tab, click on the gear-shaped icon beneath the Fingerprints subtab.

Enter the Fingerprint database connection information and click on Connect.

Friday, April 13, 2012

Using Oracle or SQL with Taskmaster Flex Manager in IBM Datacap Taskmaster Capture

Using Oracle or SQL with Taskmaster Flex Manager

in IBM Datacap Taskmaster Capture

Abstract

Is using an Oracle or SQL Taskmaster Flex Manager (FlexConfigurator) database supported in Taskmaster?

Resolving the Problem

No. Using an Oracle or SQL configuration database with Taskmaster Flex Manager is currently unsupported.

By default, Taskmaster Flex Manager, or \Datacap\Flex\dco_Flex\FlexConfigurator.exe, uses a Microsoft Access database to store certain Flex configuration data. In IBM Datacap Taskmaster Capture 8.0.0 and later, this defaults to \Flex\FLEXCFG.MDB, which is referenced in \Flex\dco_Flex\Settings.ini:

[Database]

ConfigurationDB="Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Datacap\Flex\FlexCfg.mdb;Persist Security Info=False"