> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Blue Prism sample process

> Run the bundled ABBYY Vantage Skills example process to see how the Blue Prism connector processes a multi-file transaction and returns results from several documents.

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.

| Parameter        | Scope       | Description                                                                      |
| ---------------- | ----------- | -------------------------------------------------------------------------------- |
| **SourceFolder** | File        | Path to the file's source folder.                                                |
| **SourceType**   | File        | The value `Blue Prism`.                                                          |
| **Resource PC**  | Transaction | The name of the computer that launched the Blue Prism process and the connector. |
| **Creator**      | Transaction | The name of the ABBYY Vantage user specified in the **login** data item.         |

To view these values in ABBYY Vantage, add the matching columns in the **Transactions** section of the Skill Monitor.

## Run the sample process

<Steps>
  <Step title="Import the default business objects">
    Download the default business objects from [Blue Prism Digital Exchange](https://digitalexchange.blueprism.com/cardDetails?id=138317). 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.
  </Step>

  <Step title="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](/vantage/connectors/blue-prism/install#install-via-the-installation-wizard).
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Create a working folder">
    On a local disk, create a folder that the user running Blue Prism can access, for example `C:\ABBYY_Vantage`.
  </Step>

  <Step title="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`.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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.

<Note>
  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.
</Note>

## Related topics

* [Install the Blue Prism connector](/vantage/connectors/blue-prism/install)
* [StartTransaction action](/vantage/connectors/blue-prism/actions/start-transaction)
* [SaveTransactionResult action](/vantage/connectors/blue-prism/actions/save-transaction-result)