> ## 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 サンプルプロセス

> 同梱の ABBYY Vantage Skills サンプルプロセスを実行して、Blue Prism コネクタが複数ファイルのトランザクションをどのように処理し、複数のドキュメントから結果を返すかを確認します。

ABBYY Vantage Connector for Blue Prism には、**ABBYY Vantage Skills example** というサンプルプロセスが付属しています。これは、Blue Prism のプロセスで **ABBYY Vantage Skills** VBO を使用する方法、アクションに入力データを渡す方法、処理結果を受け取る方法を示すものです。

このサンプルプロセスでは、ABBYY Vantage で複数ファイルのトランザクションを作成し、トランザクションとファイルの登録パラメーターを設定して、1 つのトランザクション内で複数のドキュメントの結果を処理します。実行すると、1 人分の Bank Statement と Utility Bill ドキュメントが 1 つのトランザクションでまとめて処理されます。

<div id="registration-parameters-used-by-the-sample">
  ## サンプルで使用する登録パラメーター
</div>

このサンプルでは、デモ目的で以下の登録パラメーターを設定します。これらの指定は任意です。

| パラメーター           | 範囲       | 説明                                       |
| ---------------- | -------- | ---------------------------------------- |
| **SourceFolder** | ファイル     | ファイルの保存元フォルダーのパス。                        |
| **SourceType**   | ファイル     | 値 `Blue Prism`。                          |
| **Resource PC**  | トランザクション | Blue Prismのプロセスとコネクタを起動したコンピューター名。       |
| **Creator**      | トランザクション | **login** データ項目で指定されたABBYY Vantageユーザー名。 |

ABBYY Vantageでこれらの値を表示するには、Skill Monitorの**Transactions**セクションに対応する列を追加します。

<div id="run-the-sample-process">
  ## サンプルプロセスを実行する
</div>

<Steps>
  <Step title="デフォルトのビジネスオブジェクトをインポートする">
    [Blue Prism Digital Exchange](https://digitalexchange.blueprism.com/cardDetails?id=138317) からデフォルトのビジネスオブジェクトをダウンロードします。フォルダーを解凍し、ファイルを `C:\Program Files\Blue Prism Limited\Blue Prism Automate\VBO` にコピーします。

    Blue Prism のメインウィンドウで、**File > Import > Process / Object** を選択し、次の 3 つのビジネスオブジェクトをインポートします。

    * **BPA Object - Utility - Environment**
    * **BPA Object - Utility - Collection Manipulation**
    * **BPA Object - Utility - File Management**

    すでに **ABBYY Vantage Skills example** を開いている場合は、いったん閉じてから開き直し、新しいビジネスオブジェクトが認識されるようにします。
  </Step>

  <Step title="サンプルプロセスを開く">
    **Studio** タブで、**Processes** セクションと **ABBYY Vantage Processes** セクションを展開し、**ABBYY Vantage Skills example** プロセスをダブルクリックします。

    このプロセスは、すべてのインストール手順が完了した後、特に `.bprelease` のインポート後にのみ **Studio** タブに表示されます。詳細については、[インストールウィザードを使用してインストールする](/ja/vantage/connectors/blue-prism/install#install-via-the-installation-wizard) を参照してください。
  </Step>

  <Step title="サーバーアドレスを設定する">
    **Input data items** 領域で、**baseUrl** データアイテムをダブルクリックします。**Data Properties** ウィンドウで、**Initial Value** フィールドに ABBYY Vantage サーバーのアドレスを指定します。
  </Step>

  <Step title="認証情報を設定する">
    **login** データアイテムをダブルクリックし、ABBYY Vantage アカウントの登録に使用したログイン名を **Initial Value** フィールドに入力します。**password** データアイテムについても同様に設定します。

    ABBYY Vantage ユーザーが複数のテナントに属している場合は、**tenant** データアイテムの **Initial Value** フィールドにも入力します。
  </Step>

  <Step title="作業フォルダーを作成する">
    ローカルディスク上に、Blue Prism を実行するユーザーがアクセスできるフォルダーを作成します。たとえば `C:\ABBYY_Vantage` です。
  </Step>

  <Step title="Input フォルダーを設定する">
    作業フォルダー内に `Input` フォルダーを作成し、`SampleImages` フォルダーからサンプルの Bank Statement と Utility Bill の画像をそこにコピーします。既定の場所は `Program Files\ABBYY Vantage Connector for Blue Prism\SampleImages` です。

    **inputDirectoryPath** データアイテムの **Initial Value** フィールドに、`Input` フォルダーのフルパスを指定します。たとえば `C:\ABBYY_Vantage\Input` です。
  </Step>

  <Step title="Output フォルダーを設定する">
    作業フォルダー内に `Output` フォルダーを作成し、そのフルパスを **outputDirectoryPath** データアイテムの **Initial Value** フィールドに指定します。たとえば `C:\ABBYY_Vantage\Output` です。トランザクション内のすべての文書の処理結果はここに保存されます。
  </Step>

  <Step title="ログファイルを設定する">
    **logFilePath** データアイテムに、テキストログファイルのパスを指定します。たとえば `C:\ABBYY_Vantage\log.log` です。ログ記録を無効にするには、このデータアイテムを空のままにします。
  </Step>

  <Step title="プロセスを実行する">
    プロセスを実行します。このプロセスは、**skill** データアイテムで指定された **Default Process Skill** を使用して、入力ファイルから作成されたトランザクションを処理します。
  </Step>
</Steps>

<div id="where-the-sample-process-saves-results">
  ## サンプルプロセス が結果を保存する場所
</div>

プロセスが完了すると、**outputDirectoryPath** データアイテムで設定されたフォルダ内にサブフォルダが作成されます。サブフォルダ名はトランザクション識別子と一致します。

そのサブフォルダ内で、プロセスはトランザクション内のドキュメントごとに 1 つのサブフォルダを作成し、`<document class name>_<document identifier>` という名前を付けて、そのドキュメントの結果ファイルを保存します。

この sample では、**documentProcessingResults** 出力の **Fields** collection から個々の field を抽出する方法も示しています。Utility Bill では **Customer::Name** field を、Bank Statement では **Bank Name** field を検索し、見つかった field を **filteredFields** collection に追加します。

<Note>
  ファイルをディスクに保存する必要はありません。Blue Prism では、**documentProcessingResults** 出力プロパティの結果を別の方法で処理できます。
</Note>

<div id="related-topics">
  ## 関連項目
</div>

* [Blue Prism コネクタのインストール](/ja/vantage/connectors/blue-prism/install)
* [StartTransaction アクション](/ja/vantage/connectors/blue-prism/actions/start-transaction)
* [SaveTransactionResult アクション](/ja/vantage/connectors/blue-prism/actions/save-transaction-result)
