Skip to main content
The ABBYY FlexiCapture 12 Listener process is deployed on the Blue Prism side. The listener receives SOAP requests sent by the FlexiCapture Export Connector. It is assumed that the user will import the ABBYY FlexiCapture 12 Listener into Blue Prism and modify it to suit his needs.
To execute the FlexiCapture 12 Listener process, the machine with Blue Prism that will receive exported files and data must be running as a Resource PC. To make sure that your Blue Prism machine is running as a Resource PC, start Blue Prism, click the Control tab, and make sure that the machine is displayed as “connected” in the Resources window. If this is not the case, open the command line prompt and execute the following command:
“C:\Program Files\Blue Prism Limited\Blue Prism Automate\Automate.exe” /resourcepc /public
A window named “Blue Prism - Resource PC (Port 8181)” will open where you will see logs for your Resource PC. Click Hide to minimize this window.
The ABBYY FlexiCapture 12 Listener process comprises the following one file:
ComponentDescription
BPA Process - FlexiCapture 12 Listener.xmlA process that accepts and processes SOAP requests sent by the FlexiCapture Export Connector.

​
Installing the ABBYY FlexiCapture 12 Listener

To make the FlexiCapture 12 Listener process available on the Blue Prism, you need to import the BPA Process - FlexiCapture 12 Listener.xml file into Blue Prism and expose the resulting process as a web service. To do this:
  1. Open Blue Prism and on the File menu, click Import.
  2. Prompted by the on-screen instructions, select the following files to import, one by one:
    • BPA Process - FlexiCapture 12 Listener.xml
    • Additional object required to run the ABBYY FlexiCapture 12 Listener usage example (its default location is C:\Program Files\Blue Prism Limited\Blue Prism Automate\VBO):
      • BPA Object - Utility - File Management.xml
        A business object for working with files stored on the local hard drive.
        Note: The FlexiCapture 12 Listener usage example already includes a request processing example. The user can freely modify this example with the exception of the parameters that have to be accepted on the Start block (see below).
  3. Once the import is complete, all the business objects and the usage example will be displayed in Blue Prism on the Studio tab.
  4. On the System tab, expand the Processes node and click Exposure. Then in the top right corner of the Process - Exposure window, click the Expose a Process link.
  5. In the Expose Process dialog box, select FlexiCapture 12 Listener and click Next.
  6. In the next dialog box, make sure that FlexiCapture12Listener is specified as the exposed name of the process and click Finish.
The process will appear in the list of exposed processes. To make sure that the process has been exposed as a web service, open the following link on the computer running Blue Prism: http://localhost:8181/ws/FlexiCapture12Listener?wsdl. If all the settings are correct, you will see a WSDL file with a description of the web service.

​
Configuring the ABBYY FlexiCapture 12 Listener process

Before you can start using the FlexiCapture 12 Listener process, you need to configure the following settings in Blue Prism:
  1. On the Studio tab, double-click the name of the process to open the process editor.
  2. By default, the FlexiCapture 12 Listener process saves received files and fields to the output folder, where it creates a subfolder with results for each exported document. You can specify an output folder in the data item named “RootDir.”
The user can freely modify this process with the exception of the process name and the set of input parameters. The input parameters, their names, and data types must match those in requests sent by the FlexiCapture Export Connector. Open the properties of the very first element of the “Start” process and specify data items and their values in the “Store In” column:
  • DocumentDefinition – the name of the Document Definition that was applied to the input image by ABBYY FlexiCapture (must be stored as the “Text” data type)
  • Fields – a collection of objects with “Name” and “Value” text fields for storing the names and extracted values of fields
  • Files – a collection of objects with a “Name” text field and a “Content” binary field for storing exported image files and their names
  • BatchRegistrationParameters – a collection of objects with “Name” and “Value” text fields (contains the names and values of the batch registration parameters)

​
Starting the ABBYY FlexiCapture 12 Listener process

The ABBYY FlexiCapture 12 Listener process exposed as a web service is started by a SOAP request sent during document export from the ABBYY FlexiCapture server to the address of the web service.