Skip to main content
The ABBYY Vantage Connector for Blue Prism ships with a sample process named ABBYY Vantage Skills example. It demonstrates how to use the ABBYY Vantage Skills VBO in a Blue Prism process, how to pass input data to the actions, and how to receive the processing results. The sample process creates a multi-file transaction in ABBYY Vantage, sets transaction and file registration parameters, and processes the results from several documents in one transaction. When you run it, one person’s Bank Statement and Utility Bill documents are processed together in a single transaction.

​
Registration parameters used by the sample

The sample sets these registration parameters for demonstration purposes. Passing them is optional. To view these values in ABBYY Vantage, add the matching columns in the Transactions section of the Skill Monitor.

​
Run the sample process

1

Import the default business objects

Download the default business objects from Blue Prism Digital Exchange. Unzip the folder and copy the files to C:\Program Files\Blue Prism Limited\Blue Prism Automate\VBO.In the main Blue Prism window, go to File > Import > Process / Object and import these three business objects:
  • BPA Object - Utility - Environment
  • BPA Object - Utility - Collection Manipulation
  • BPA Object - Utility - File Management
If you already opened the ABBYY Vantage Skills example, close and reopen it so the new business objects are recognized.
2

Open the sample process

On the Studio tab, expand the Processes and ABBYY Vantage Processes sections, and then double-click the ABBYY Vantage Skills example process.The process appears on the Studio tab only after all installation steps are complete, in particular after the .bprelease import. For more information, see Install via the installation wizard.
3

Set the server address

In the Input data items area, double-click the baseUrl data item. In the Data Properties window, specify the address of the ABBYY Vantage server in the Initial Value field.
4

Set the credentials

Double-click the login data item and fill in the Initial Value field with the login used to register your ABBYY Vantage account. Do the same for the password data item.If your ABBYY Vantage user belongs to multiple tenants, also fill in the Initial Value field of the tenant data item.
5

Create a working folder

On a local disk, create a folder that the user running Blue Prism can access, for example C:\ABBYY_Vantage.
6

Set the input folder

Inside the working folder, create an Input folder and copy the sample Bank Statement and Utility Bill images from the SampleImages folder into it. The default location is Program Files\ABBYY Vantage Connector for Blue Prism\SampleImages.Specify the full path to the Input folder in the Initial Value field of the inputDirectoryPath data item, for example C:\ABBYY_Vantage\Input.
7

Set the output folder

Inside the working folder, create an Output folder and specify its full path in the Initial Value field of the outputDirectoryPath data item, for example C:\ABBYY_Vantage\Output. The processing results for all documents in the transaction are saved there.
8

Set the log file

Specify the path to the text log file in the logFilePath data item, for example C:\ABBYY_Vantage\log.log. To disable logging, leave this data item empty.
9

Run the process

Run the process. It uses the Default Process Skill, named in the skill data item, to process the transactions created from the input files.

​
Where the sample process saves results

When the process completes, it creates a subfolder in the folder set in the outputDirectoryPath data item. The subfolder name matches the transaction identifier. Inside that subfolder, the process creates one subfolder per transaction document, named <document class name>_<document identifier>, and saves that document’s result files there. The sample also demonstrates how to extract individual fields from the Fields collection of the documentProcessingResults output. It searches for the Customer::Name field in the Utility Bill and the Bank Name field in the Bank Statement, and adds the fields it finds to the filteredFields collection.
You do not have to save the files to disk. You can process the results from the documentProcessingResults output property in a different way in Blue Prism.