Macro

Run a series of programmatic steps before and after export. No coding, just configuring macro rules!

MacroWith the CaptureBites Macro connector for Kofax Express, you can execute a series of programmatic steps before and after export.

You can run a batch command file, or an external program performing post-processing of index files for example.

The sample jobs “CB Macro ZIP after Export” and “CB Macro Excel Index” included with the installer is a good start to learn how this works.

Creating an Excel document index file

In the sample job, we first make use of the Macro connector to overwrite the master Excel file with a blank version before the export process starts.

Next, we update the Excel file with the CaptureBites database connector and output all scanned documents as PDF files.

Once the Excel is file is updated and the export is completed, we use a macro command to copy the updated Excel file to the export folder of the images and as such create a document index file in native xls format for every scanned batch.

When the creation of the excel file is complete we use the Macro connector to play a sound and open the excel file in the associated windows program (typically Microsoft Excel).

The file paths and commands are completely configurable with fixed values, system values and Kofax Express index values.

Macro connector setup

You enable the Macro connector by selecting it as the export connector in the Kofax Express Job Setup tab.

Press setup and first activate the connector by pressing Activate in the setup window. The activate window will display an express ID which you need to send us when requesting a trial activation code by email.

The main export connector is selected from the Export to: list. This is the export connector that will export your scanned documents and index information. Any installed connectors can be selected.

In our demo job, we are using the the CaptureBites database connector to update an Excel file via ODBC which will serve as our batch index file.

Copy and Delete file, folder rules setup

You can use fixed values, select system values or index values from the Setup menu to define your Source file and Target file.  The Copy folder, Delete file and Delete folder rules work in a similar way.

Execute Command

With the Execute command rule you can run any windows command, robocopy command, powershell command, a complete script as a batch command file (.BAT files) or a windows program before or after export of the batch or before or after export of each individual document.

You simply specify the command, the executable or .bat file in the Command field. Optionally add some parameters (also known as command line parameters) and define the working folder.

For example, in our demo job we run a small program to play sound files at the end of the export. You can quickly check your command rule settings by pressing Test.

Compressing your exported batch as a single zip file.

With CaptureBites Macro you can compress the whole batch after export as a single zip file. Since windows 7, PowerShell is included with windows and you can use it to compress your exported batch as a zip file at the end of the export process with a single command. PowerShell is a much more powerful command-line shell than the traditional Windows Command Prompt and you don’t need to install anything. It comes with Windows.

This is a macro rule running a PowerShell command to compress the content of an exported batch as a single zip file. If your batch name is called BATCH-0001, the resulting ZIP file will be called BATCH-0001.ZIP.

Click on the image to enlarge.

This is a basic PowerShell command that you can use as a start to define your own zip compression command:

Compress-Archive -Path 'C:\EXPORT\{@Batch Name}\*.*'  -DestinationPath 'C:\EXPORT\{Batch Name}' -Update

Note: Paths are enclosed in single quotes when using PowerShell commands as opposed to double quotes when using the traditional windows commands.

When running batch command files, you would typically enable the Hide program option to prevent the black command window to pop up. If you want to see the complete job setup, have a look at the CB Macro ZIP after Export job included with the Macro installer.

If you want to see the complete job setup to “zip your batches”, have a look at the CB Macro ZIP after Export job included with the Macro installer.

Find the complete description of the PowerShell Compress_Archive command here.

Below is another example of a command rule used in the demo job. We simply “run” the xls file after it has been copied to the export folder and windows will automatically open it in the associated application (typically Microsoft Excel).

This also works very well with TXT,  CSV, PDF, JPG files etc.

Do you have a feature request for the CaptureBites Macro connector?

Thanks to its modular design based on a collection of simple Rules, the CaptureBites Macro connector will be regularly updated with new functionality.

So visit this page regularly to check what’s new or contact us and let us know what you would like to see next in the CaptureBites Macro connector.

About the download and included demo job

The download installs the CaptureBites Database connector and the CaptureBites Macro connector. It also includes demo images and a demo job called CB Macro Excel Index to show the functionality. It also installs a sample MS Excel Sheet called Excel_Index.xls.

The Macro connector requires a trial acyivation code to see it in action. Just send us a request for a trial activation code.

After you activated the Macro connector with your trial code, just export the pre-scanned batch of the CB Macro Excel Index demo job and check the Excel Index file by looking at the result after export. You can find the export result on your desktop in \Desktop\CaptureBites after Export.