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:

1. Run Taskmaster Application Manager.


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


3. Locate the profile for the task that is failing.


4. 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.


5. 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.

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.