Welcome to Kofax RPA > Desktop Automation > Desktop Automation Step Actions > Document Transformation > DT Browser and Action Steps

DT Browser and Action Steps

The DT (Document Transformation) browser shows transformation results and helps you work with extracted data in the document. The following table explains the DT browser toolbar elements.


Document Transformation browser toolbar

Button

Description

The Page section helps you navigate in a multi-page document

Go back button in the built-in Kapow browser

Navigates one page back in a multi-page document.

Go forward button in the built-in Kapow browser

Navigates one page forward in a multi-page document.

Go to page number

Navigates to the specified page in a multi-page document.

The Document section helps you navigate in multiple and separated documents

Go back button in the built-in Kapow browser

Navigates to the previous document.

Go forward button in the built-in Kapow browser

Navigates to the next document.

open document by its number.

Navigates to the document by number.

Open document by name

Navigates to the document by name.

  • For normal documents, specify the filename without extension, such as mydocument for the mydocument.pdf file.
  • For separated documents, specify the filename without extension followed by an underscore and a page range suffix. For example, if a four-page mydocument.pdf file is split into half two pages each, the two resulting documents are called mydocument_1-2 and mydocument_3-4.

The Validation section helps you validate a document

Send for validation

Sends a document for manual validation to the specified Document Transformation Thin Client server.

Document transformation status

Status of the transformed document with error description if any.

Application action steps

All of the actions that appear on the toolbar are also available from the context menu when you right-click the DT Browser tab. The following table lists and describes those actions that are available only from the context menu.

Action step Description
Count Pages Gets the number of pages in the currently active document.
Count Documents Gets the number of document in the batch.
Close Closes the application window.
Get Document Extracts a particular document from the batch.

You can use this action to extract a subdocument when your Document Transformation Service project is configured to use Document Separation.

  1. In the step properties, select a name of the subdocument to extract or its index (number in the batch). The Index option takes precedence over the Name option, so if you specify both, the index is used to select the document.

  2. Select a file format to extract a document: Get Image (.tif) and/or Get XDoc (.xdc).

  3. Specify a binary variable to store the result.

Then, you can use the binary data in several different ways, such as send it to Kofax TotalAgility with the Create Document action or use the Write File step to write the data into a file on a local or remote computer.

For example, when using the Write File step, consider the following for a file name for the file to contain the extracted document, :

  • If you selected "Get Image" only, use the extension .tif.
  • If you selected "Get XDoc" only, use the extension .xdc.
  • If you selected both formats, use the extension .zip. In this case, an archive is created containing the extracted document in two formats.

The .xdc format can be read with the XDoc Browser application included in your Document Transformation Service installation.

Component actions

Action

Description

Get Field Value

Extracts document field value to the specified variable.