> ## 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 Connector for Blue Prism をインストールし、その後 ABBYY Vantage Skills ビジネスオブジェクトをインポートします。

ABBYY Vantage Connector for Blue Prism は、ドキュメントを ABBYY Vantage に送信し、利用可能な Skill で処理して結果を取得するための一連のアクションを提供する、ビジュアル ビジネスオブジェクト (VBO) です。これには、**ABBYY Vantage Skills example** という名前の事前設定済みサンプル プロセスが含まれており、`.bprelease` ファイルとともにインポートされます。

このコネクタは、これを使用する Blue Prism プロセスを実行するすべてのマシンにインストールしてください。単一のマシンにインストールする場合はインストール ウィザードを使用し、多数のマシンへのインストールを自動化する場合はサイレント モードを使用します。

<Warning>
  コネクタのインストール、更新、およびアンインストールには管理者権限が必要です。インストーラでは、インストール中にすべての Blue Prism `Automate.exe` プロセスが停止している必要があります。`Automate.exe` プロセスがいずれか 1 つでも実行中の場合、インストーラは警告を表示し、そのまま続行するとそれらのプロセスは強制終了されます。
</Warning>

<div id="install-via-the-installation-wizard">
  ## インストール ウィザードでインストールする
</div>

<Steps>
  <Step title="セットアップ ファイルを配置する">
    Blue Prism がインストールされているマシンに、`ABBYYVantageConnectorForBluePrism<version>.exe` セットアップ ファイルを配置します。
  </Step>

  <Step title="インストーラーを実行する">
    `ABBYYVantageConnectorForBluePrism<version>.exe` を実行し、インストール ウィザードの指示に従います。
  </Step>

  <Step title="リリースを Blue Prism にインポートする">
    Blue Prism で **Studio** タブを開き、**File > Import > Release / Skill** をクリックします。コネクタがインストールされたフォルダーにある `ABBYY Vantage Skills <version>.bprelease` ファイルを選択し、その後はセットアップの指示に従います。

    既定の場所は、64 ビット システムでは `C:\Program Files (x86)\ABBYY Vantage Connector for Blue Prism`、32 ビット システムでは `C:\Program Files\ABBYY Vantage Connector for Blue Prism` です。

    コネクタを複数のマシンにインストールする場合でも、リリースのインポートは 1 回だけで済みます。Blue Prism クライアントがインストールされているいずれかのマシンで実行してください。
  </Step>

  <Step title="インポートを確認する">
    インポートが完了すると、プロセスの一覧に **ABBYY Vantage Processes** セクション (サンプル プロセスを含む) が表示され、オブジェクトの一覧に **ABBYY Vantage** セクション (**ABBYY Vantage Skills** VBO を含む) が表示されます。

    <Frame>
      <img src="https://mintcdn.com/abbyy/fsp_01hRYkHg4Ey_/images/vantage/developer/connectors/blue-prism/studio-import-tree.png?fit=max&auto=format&n=fsp_01hRYkHg4Ey_&q=85&s=a7829b15ff339c240d02caf1c0f9a1ef" alt="ABBYY Vantage Processes セクション（ABBYY Vantage Skills の例）と ABBYY Vantage オブジェクト（ABBYY Vantage Skills VBO）が強調表示された Blue Prism の Studio タブ" width="323" height="235" data-path="images/vantage/developer/connectors/blue-prism/studio-import-tree.png" />
    </Frame>
  </Step>
</Steps>

<div id="install-in-silent-mode">
  ## サイレント モードでインストールする
</div>

サイレント モードを使用すると、多数のマシンにコネクタを自動でインストールできます。

<Steps>
  <Step title="管理者としてコマンドラインを開く">
    Blue Prismがインストールされているマシンで、管理者権限でコマンドラインを起動します。
  </Step>

  <Step title="セットアップファイルの場所に移動する">
    コネクタのセットアップファイルがあるディレクトリに移動します。
  </Step>

  <Step title="インストールコマンドを実行する">
    次のコマンドを実行します。

    ```text theme={null}
    ABBYYVantageConnectorForBluePrism.<version>.exe -install /q
    ```

    このコマンドは、配布ファイルを既定のフォルダー (64 ビット システムでは `C:\Program Files (x86)\ABBYY Vantage Connector for Blue Prism`、32 ビット システムでは `C:\Program Files\ABBYY Vantage Connector for Blue Prism`) に展開し、`Abbyy.Rpa.Vantage.BluePrism.dll` ライブラリを Blue Prism のインストールフォルダーにコピーします。このライブラリは、**ABBYY Vantage Skills** VBO で必要です。
  </Step>
</Steps>

コネクタをアンインストールするには、次のコマンドを実行します。

```text theme={null}
ABBYYVantageConnectorForBluePrism.<version>.exe -uninstall /q
```

<div id="update-the-connector">
  ## コネクタを更新する
</div>

古いバージョンのコネクタを使用している場合は、最新バージョンに更新してください。

<Steps>
  <Step title="更新を実行する">
    コネクタのインストール方法に応じて、次のいずれかを行います。

    * コネクタを[インストール ウィザード](#install-via-the-installation-wizard)でインストールした場合は、最新バージョンの`ABBYYVantageConnectorForBluePrism<version>.exe`を実行し、**Update**をクリックします。
    * コネクタを[サイレント モード](#install-in-silent-mode)でインストールした場合は、`ABBYYVantageConnectorForBluePrism.<version>.exe -install /q`を実行します。
  </Step>

  <Step title="最新のReleaseをインポートして競合を解決する">
    Blue Prismで**Studio**タブを開き、**File > Import > Release / Skill**をクリックします。最新バージョンが保存されている`ABBYY Vantage Skills <version>.bprelease`ファイルを選択し、セットアップ手順に従います。

    セットアップ中に、**Resolve Import Conflicts**セクションで、次の解決方法を選択します。

    * **ABBYY Vantage Skills example**コンポーネントでは、**Overwrite the existing process with the incoming process**を選択します。
    * **ABBYY Vantage Skills**コンポーネントでは、**Overwrite the existing business object with the incoming business object**を選択します。
  </Step>
</Steps>

<div id="replace-the-gettransactionresult-action-with-savetransactionresult">
  ## GetTransactionResult アクションを SaveTransactionResult に置き換える
</div>

Blue Prism バージョン 7.2 を使用している場合は、コネクターを最新バージョンに更新してください。次に、**GetTransactionResult** アクションを含む各 Blue Prism プロセスで、そのアクションを **SaveTransactionResult** アクションに置き換えます。

<Steps>
  <Step title="プロセスを開く">
    Blue Prism Process Studio でプロセスを開きます。
  </Step>

  <Step title="アクションを SaveTransactionResult に切り替える">
    **GetTransactionResult** アクションをダブルクリックしてプロパティを開きます。**Action Properties** ウィンドウで、次の操作を行います。

    1. **Action** フィールドで、**SaveTransactionResult** アクションを選択します。
    2. **Inputs** タブで、**outputDirectoryPath** パラメーターに、トランザクション結果が保存されるフォルダーへのパスを指定します。

    <Frame>
      <img src="https://mintcdn.com/abbyy/fsp_01hRYkHg4Ey_/images/vantage/developer/connectors/blue-prism/action-properties-save-transaction-result.png?fit=max&auto=format&n=fsp_01hRYkHg4Ey_&q=85&s=0e949444470977fb8fe06251de653204" alt="Action が SaveTransactionResult に設定され、outputDirectoryPath 入力パラメーターが表示された Action Properties ウィンドウ" width="624" height="406" data-path="images/vantage/developer/connectors/blue-prism/action-properties-save-transaction-result.png" />
    </Frame>
  </Step>

  <Step title="結果コレクションを再構築する">
    ファイル処理結果の構造を変更します。

    1. **Output Data Items** 領域で、トランザクションから取得した **documents** のコレクションを開きます。
    2. **Collection Properties** を開き、**Clear** をクリックしてパラメーターをリセットします。
    3. **SaveTransactionResult** アクションの **documentProcessingResults** パラメーター用のコレクション フィールドをインポートします。**Import** をクリックし、**Business Object: ABBYY Vantage Skills** を選択してから、**Action: SaveTransactionResult**、**Parameter: documentProcessingResults (output)** の順に選択します。

    <Frame>
      <img src="https://mintcdn.com/abbyy/fsp_01hRYkHg4Ey_/images/vantage/developer/connectors/blue-prism/fields-import-document-processing-results.png?fit=max&auto=format&n=fsp_01hRYkHg4Ey_&q=85&s=31962ff4bc66bcd7fd2205c9bd2aa964" alt="SaveTransactionResult アクションの documentProcessingResults (output) パラメーターをインポートしている Fields Import ウィンドウ" width="1100" height="807" data-path="images/vantage/developer/connectors/blue-prism/fields-import-document-processing-results.png" />
    </Frame>
  </Step>

  <Step title="ファイル保存アクションを削除する">
    プロセスを開き、ワークフローからファイル保存用のアクションを削除します。
  </Step>
</Steps>

<div id="next-steps">
  ## 次のステップ
</div>

付属の[Blue Prism サンプルプロセス](/ja/vantage/connectors/blue-prism/sample-process)をセットアップして実行します。
