Thursday, February 2, 2012

Converting multiple file types with IBM Datacap Taskmaster Capture

Converting multiple file types with IBM Datacap Taskmaster Capture


create a rule to convert them all to tiffs.

Taskmaster Capture has several actions to convert file types to tiff format. However, some of these will abort if applied to the wrong file type. If the batch contains multiple file types, use this solution to convert all of them.

This ruleset will take all files with a DCO status of 49 and convert them to tiff format, setting the DCO status to 75. It uses the Convert action library.

  • Convert

    • Convert to TIFF

      • Function Images

        • ChkDCOStatus("49")

        • ImageFileTypesToConvert("jpg,jpeg,gif,bmp")

        • ImageMonoType(1)

        • ImageMonoThreshold(50)

        • ImageToTIFF()

        • SetDCOStatus("75")



      • Function TIFF

        • ChkDCOStatus("49")

        • SplitMultipageTiff()

        • SetDCOStatus("75")



      • Function PDF

        • ChkDCOStatus("49")

        • PDFDocumentToImage()

        • SetDCOStatus("75")



      • Function Word

        • ChkDCOStatus("49")

        • WordDocumentToImage()

        • SetDCOStatus("75")



      • Function Outlook

        • ChkDCOStatus("49")

        • OutlookMessageToImageAndAttachment()

        • SetDCOStatus("75")



      • Function Excel

        • ChkDCOStatus("49")

        • ExcelWorkbookToImage()

        • SetDCOStatus("75")







Verify/Fixup Forms open minimized with IBM Datacap Taskmaster Capture

Verify/Fixup Forms open minimized with IBM Datacap Taskmaster Capture


When running the Verify or Fixup tasks, forms are opened minimized requiring the user to select them on the Windows Task Bar to display them.

To resolve:

  1. Run regedit and navigate to HKEY_CURRENT_USER\Control Panel\Desktop.

  2. Right click on the key ForegroundLockTimeout and select Modify.

  3. Change the value to 0.


Note: The installed default is 30d40.

Creating a custom column in Job Monitor for IBM Datacap Taskmaster Capture

Creating a custom column in Job Monitor for IBM Datacap Taskmaster Capture


To add a column:

  1. In the tmBatch table in the Taskmaster engine database, add a column, giving it the desired name preceded with pb_ (ex: pb_MyColumn).

  2. Save the table.

  3. For SQL only, also do the following:

    1. Open the JMView view for design.

    2. Delete each item appearing in the 'Alias' column.

    3. Press the ! (exclamation mark) icon.

    4. Save the view.

    5. Open the JobMonitor view for design.

    6. Press the ! (exclamation mark) icon.

    7. Save the view.



  4. Restart Taskmaster Server.

  5. To populate this field with dynamic content, scripting is required.



  • If using a Batch Pilot form, the following command is used.
    pilot.XtraBatchFieldValue("pb_MyColumn") = "my value"

  • If using a Rulerunner action, the pilot.XtraBatchFieldValue parameter must be uppercase. For example:
    sValue = pilot.XtraBatchFieldValue("PB_MYCOLUMN")

ERROR:Couldn't load needed object with IBM Datacap Taskmaster Capture

ERROR:Couldn't load needed object with IBM Datacap Taskmaster Capture


When we are using the PDF at Datacap , Conversion  is failing and generating the following message in the rrs log:

Couldn't load needed object: Datacap.Libraries.Convert.Pdf into Datacap.Libraries.Convert.PDF instance.

This error occurs when the Datacap Taskmaster PDF (DCPDF) components have not been installed or registered correctly.

Resolving the problem

To resolve this issue:

  • Make sure that all the system32 files have been copied to the system folder on the computer running the DCPDF actions.

  • Make sure that pdfshell.dll and PDF2TIFFEx.dll have been registered.

Verify aborts in Taskmaster Client with IBM Datacap Taskmaster Capture

Verify aborts in Taskmaster Client with IBM Datacap Taskmaster Capture


To configure the Task Profile:

  1. Open Taskmaster client.

  2. Go to Settings > Workflow.

  3. Drop down the Job in question.

  4. Highlight the Verify task.

  5. Click Setup.

  6. Click in the Workflow field and drop down to pick the application name.

  7. In Task Profile to run make sure the correct Task Profile is selected

  8. Press Done, and then Apply.

  9. Unload the task (red handle bar), and then run Verify.

IBM Datacap Taskmaster Capture cannot complete Verification on some documents

IBM Datacap Taskmaster Capture cannot complete Verification on some documents


After verifying the document, Verification reports: "Verification is not complete. Put Batch on Hold?" Unable to complete Verification despite having all fields completed.

Cause

The document type must have a problem STATUS filter assigned to it and Verification must be able to change the status as fields are corrected.

How to Resolve the problem

Set the STATUS filter

  1. In Taskmaster Client, go to Settings -> Workflow.

  2. Expand the job being used and highlight the Verify task.

  3. Click Setup from the right side and then File -> Task Settings.

  4. Click on the Filters tab and in the Type section, select the document type.

  5. Make sure that the Level drop-down list is set to PAGE and Property is set to STATUS.

  6. Enter 1 into Problem Value field and click Add.

  7. Save changes, apply, and restart Taskmaster Client.


Allow Verification to change the status

Add the Status_Preserve_OFF action as the first action of the function that handles page validation.

ERROR: Maximum connections reached with IBM Datacap Taskmaster Capture

ERROR:Maximum connections reached with IBM Datacap Taskmaster Capture


Datacap Taskmaster client applications fail login to the Taskmaster Server service. Logging shows an error stating that the maximum number of available connections has been reached.

Cause

Certain rare events can leave an orphaned login within Taskmaster. If enough of these occur for a specific station, than any further logins from that station will fail, as no more connections are available. This requires that either the connections be reset or the maximum increased.

How to Resolve the problem

Reset the connections

  1. Make sure that no client applications are logged in from the station that will be reset.

  2. Run Taskmaster Client. It can be run from any station including the one being reset.

  3. Log in as admin or any other user with full rights.

  4. Select Settings, Stations, and highlight the station to be reset.

  5. Click Advanced, Reset.

  6. Click Yes of the warning window.

  7. Click OK, Apply, and Done to close the remaining windows.


Increase the maximum connections

  1. Run Taskmaster Client. It can be run from any station including the one being reset.

  2. Log in as admin or any other user with full rights.

  3. Select Settings, Stations, and highlight the station to be reset.

  4. Click Advanced.

  5. Change Maximum number of virtual stations to 1000 or some other large value.

  6. Click OK, Apply, and Done to close the remaining windows.