Unable to perform Rubber band on invoice rotated on KTM Validation

Question

We are unable to perform rubber band on image which is rotated on validation stage. Is there any way we can save the data of OCR index field before rotating the image and the rotate then image manually. Once the image is rotated all the Index field becomes invalid and user cannot perform rubber band also on the same image. After rotating the image we moved the same batch to KTM server and back to KTM validation still the Rubber band is not possible

Answer 1

There isn't a clear easy answer to this, but I can suggest some options. First few clarifications. Even if you already know these, it will help the question make more sense to others:

• Although Kofax Capture actually does a zonal OCR read on-demand when you lasso a section of the image, Kofax Transformation Modules actually just returns words within the coordinates of the OCR that has already performed during KTM Server.
• Out of the box, KTM Validation only has the ability to do "permanent" rotation, in the sense that it isn't simply rotating what you see at the moment, but persisting the rotation either in the image on disk or in metadata (depending on project settings).
• The implication of rotation is that the stored OCR is no longer valid for the new orientation, thus it gets removed. Any fields which have word objects (which are tied to the OCR) are removed and invalidated.
• KTM Server has already marked the batch as processed, so it won't try again.

Preserve field results during rotation

I believe if you remove the word objects from a field then it won't clear it on rotation. You may need to also unset the page index so it isn't connected to the page being rotated.

Dim FieldIndex as Integer
For FieldIndex=0 to pXDoc.Fields.Count-1  
   While pXDoc.Fields.ItemByIndex(FieldIndex).Words.Count>0
      pXDoc.Fields.ItemByIndex(FieldIndex).Words.Remove(0)
   Wend
pXDoc.Fields.ItemByIndex(FieldIndex).PageIndex=-1
Next

If there are any issues with this, you can also take other approaches to storing and restoring the values in the Batch_BeforeRotateImage and Batch_AfterRotateImage events.

Rubberband OCR (Lassoing Words) After Rotation

There is no clear simple way to do this. I considered suggesting calling OCR from script after rotation, but aside from being a gray area of whether the relevant objects are supported, trying that shows that the OCR components don't even get loaded into validation.

A Different Direction: Rotating Only The Display Image

I mentioned earlier that out of the box KTM Validation cannot just do a temporary rotation, however, if you don't need the rotation to persist, you can accomplish this in script. Use this function:

Public Sub RotateCurrentValidationImage(pXDoc As CscXDocument, ValForm As CscScriptValidationForm, Optional RotateCounterClockwise As Boolean=False)
   Dim Img As CscImage
   Set Img=pXDoc.CDoc.Pages(ValForm.CurrentPageIndex).GetImage()
   Img.RotateImage(IIf(RotateCounterClockwise,CscImgRotation90Left,CscImgRotation90Right))
   pXDoc.CDoc.Pages(ValForm.CurrentPageIndex).SetImage(Img)

   ValForm.DocViewer.DisplayPage(-1)
   ValForm.DocViewer.DisplayPage(ValForm.CurrentPageIndex)
End Sub

From a Button Click event like so:

Private Sub ValidationForm_ButtonClicked(ByVal ButtonName As String, ByVal pXDoc As CASCADELib.CscXDocument)
   Select Case ButtonName
      Case "RotateDisplayImage"
         RotateCurrentValidationImage(pXDoc,ValidationForm)
   End Select
End Sub

This only rotates the currently displayed image in memory. It does not affect the existing OCR (it will still exist, however it also cannot be rotated to match the coordinates of the image), nor does it affect the existing fields, nor will the rotation persist once the batch is closed.

In this situation rubberband OCR technically works, however words and the image won't line up, so it won't be useful while rotated. This might help if you need to rotate to manually key something, but rubberband OCR will only be useful when returned to the original orientation.