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

# Installer le connecteur Blue Prism

> Installez le ABBYY Vantage Connector for Blue Prism à l’aide de l’assistant d’installation ou en mode silencieux, puis importez l’objet métier ABBYY Vantage Skills.

Le ABBYY Vantage Connector for Blue Prism est un objet métier visuel (VBO) qui fournit un ensemble d’actions pour envoyer des documents à ABBYY Vantage, les traiter à l’aide d’une compétence disponible et récupérer les résultats. Il est fourni avec un processus d’exemple préconfiguré nommé **ABBYY Vantage Skills example**, qui est importé avec le fichier `.bprelease`.

Installez le connecteur sur chaque machine exécutant un processus Blue Prism qui l’utilise. Utilisez l’assistant d’installation pour une seule machine, ou le mode silencieux pour automatiser l’installation sur plusieurs machines.

<Warning>
  L’installation, la mise à jour et la désinstallation du connecteur nécessitent des privilèges d’administrateur. Le programme d’installation exige que tous les processus Blue Prism `Automate.exe` soient arrêtés pendant l’installation. Si un processus `Automate.exe` est en cours d’exécution, le programme d’installation affiche un avertissement et, si vous continuez, met fin de force à ces processus.
</Warning>

<div id="install-via-the-installation-wizard">
  ## Installez à l’aide de l’assistant d’installation
</div>

<Steps>
  <Step title="Téléverser le fichier d’installation">
    Téléversez le fichier d’installation `ABBYYVantageConnectorForBluePrism<version>.exe` sur la machine où Blue Prism est installé.
  </Step>

  <Step title="Exécuter le programme d’installation">
    Exécutez `ABBYYVantageConnectorForBluePrism<version>.exe` et suivez les instructions de l’assistant d’installation.
  </Step>

  <Step title="Importer la release dans Blue Prism">
    Dans Blue Prism, ouvrez l’onglet **Studio** et cliquez sur **File > Import > Release / Skill**. Sélectionnez le fichier `ABBYY Vantage Skills <version>.bprelease` dans le dossier où le connecteur a été installé, puis suivez les instructions d’installation.

    L’emplacement par défaut est `C:\Program Files (x86)\ABBYY Vantage Connector for Blue Prism` sur les systèmes 64 bits, ou `C:\Program Files\ABBYY Vantage Connector for Blue Prism` sur les systèmes 32 bits.

    Si vous installez le connecteur sur plusieurs machines, vous ne devez importer la release qu’une seule fois, sur n’importe quelle machine où le client Blue Prism est installé.
  </Step>

  <Step title="Confirmer l’importation">
    Une fois l’importation terminée, une section **ABBYY Vantage Processes** (contenant le processus d’exemple) apparaît dans la liste des processus, et une section **ABBYY Vantage** (contenant le VBO **ABBYY Vantage Skills**) apparaît dans la liste des objets.

    <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="Onglet Studio de Blue Prism avec la section ABBYY Vantage Processes (exemple ABBYY Vantage Skills) et l’objet ABBYY Vantage (VBO ABBYY Vantage Skills) mis en évidence" 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">
  ## Installer en mode silencieux
</div>

Utilisez le mode silencieux pour installer automatiquement le connecteur sur un grand nombre de machines.

<Steps>
  <Step title="Ouvrir l’invite de commandes en tant qu’administrateur">
    Sur la machine où Blue Prism est installé, exécutez l’invite de commandes en tant qu’administrateur.
  </Step>

  <Step title="Accéder à l’emplacement du fichier d’installation">
    Accédez au répertoire où se trouve le fichier d’installation du connecteur.
  </Step>

  <Step title="Exécuter la commande d’installation">
    Exécutez la commande suivante :

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

    Cette commande extrait les fichiers de distribution dans le dossier par défaut (`C:\Program Files (x86)\ABBYY Vantage Connector for Blue Prism` sur les systèmes 64 bits, ou `C:\Program Files\ABBYY Vantage Connector for Blue Prism` sur les systèmes 32 bits) et copie la bibliothèque `Abbyy.Rpa.Vantage.BluePrism.dll` dans le dossier d’installation de Blue Prism. Cette bibliothèque est requise pour le VBO **ABBYY Vantage Skills**.
  </Step>
</Steps>

Pour désinstaller le connecteur, exécutez la commande suivante :

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

<div id="update-the-connector">
  ## Mettre à jour le connecteur
</div>

Si vous avez une ancienne version du connecteur, mettez-la à jour vers la version la plus récente.

<Steps>
  <Step title="Exécuter la mise à jour">
    Selon la façon dont le connecteur a été installé, effectuez l’une des opérations suivantes :

    * Si le connecteur a été installé avec l’[assistant d’installation](#install-via-the-installation-wizard), exécutez `ABBYYVantageConnectorForBluePrism<version>.exe` de la version la plus récente, puis cliquez sur **Update**.
    * Si le connecteur a été installé en [mode silencieux](#install-in-silent-mode), exécutez `ABBYYVantageConnectorForBluePrism.<version>.exe -install /q`.
  </Step>

  <Step title="Importer la dernière release et résoudre les conflits">
    Dans Blue Prism, ouvrez l’onglet **Studio** et cliquez sur **File > Import > Release / Skill**. Sélectionnez le fichier `ABBYY Vantage Skills <version>.bprelease` à l’emplacement où se trouve la dernière version, puis suivez les instructions de configuration.

    Pendant la configuration, dans la section **Resolve Import Conflicts**, sélectionnez les options suivantes :

    * Pour le composant **ABBYY Vantage Skills example**, sélectionnez **Overwrite the existing process with the incoming process**.
    * Pour le composant **ABBYY Vantage Skills**, sélectionnez **Overwrite the existing business object with the incoming business object**.
  </Step>
</Steps>

<div id="replace-the-gettransactionresult-action-with-savetransactionresult">
  ## Remplacer l’action GetTransactionResult par SaveTransactionResult
</div>

Si vous utilisez la version 7.2 de Blue Prism, mettez le connecteur à jour vers sa dernière version. Ensuite, dans chaque processus Blue Prism contenant l’action **GetTransactionResult**, remplacez-la par l’action **SaveTransactionResult**.

<Steps>
  <Step title="Ouvrir le processus">
    Ouvrez un processus dans Blue Prism Process Studio.
  </Step>

  <Step title="Remplacer l’action par SaveTransactionResult">
    Double-cliquez sur l’action **GetTransactionResult** pour ouvrir ses propriétés. Dans la fenêtre **Action Properties** :

    1. Dans le champ **Action**, sélectionnez l’action **SaveTransactionResult**.
    2. Dans l’onglet **Inputs**, pour le paramètre **outputDirectoryPath**, indiquez le chemin du dossier qui contient les résultats de la transaction.

    <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="Fenêtre Action Properties avec l’action définie sur SaveTransactionResult et le paramètre d’entrée outputDirectoryPath" width="624" height="406" data-path="images/vantage/developer/connectors/blue-prism/action-properties-save-transaction-result.png" />
    </Frame>
  </Step>

  <Step title="Reconstruire la collection de résultats">
    Modifiez la structure des résultats du traitement des fichiers :

    1. Dans la zone **Output Data Items**, ouvrez la collection de documents issus de la transaction.
    2. Ouvrez **Collection Properties**, puis cliquez sur **Clear** pour réinitialiser les paramètres.
    3. Importez les champs de la collection pour le paramètre **documentProcessingResults** de l’action **SaveTransactionResult** : cliquez sur **Import**, sélectionnez **Business Object: ABBYY Vantage Skills**, sélectionnez **Action: SaveTransactionResult**, puis sélectionnez **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="Fenêtre Fields Import important le paramètre documentProcessingResults (output) de l’action SaveTransactionResult" width="1100" height="807" data-path="images/vantage/developer/connectors/blue-prism/fields-import-document-processing-results.png" />
    </Frame>
  </Step>

  <Step title="Supprimer les actions d’enregistrement de fichiers">
    Ouvrez le processus et supprimez du workflow les actions qui enregistraient des fichiers.
  </Step>
</Steps>

<div id="next-steps">
  ## Étapes suivantes
</div>

Configurez et exécutez le [processus d’exemple Blue Prism inclus](/fr/vantage/connectors/blue-prism/sample-process).
