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.

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:

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


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


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