Installation de l'extracteur de données UiPath

L'extracteur de données local UiPath doit être installé dans le même environnement réseau que la source de données (par exemple, le système SAP). Par exemple, si SAP est hébergé dans un cloud privé ou dans un centre de données, l'extracteur de données UiPath doit être déployé dans ce même environnement ou segment de réseau, afin de garantir une connectivité fiable et sécurisée.

Remarque :

Si l'installation de l'extracteur de données UiPath dans le même réseau que le système SAP n'est pas possible, il est possible de l'installer en dehors du réseau privé. Dans ce cas, vous devez ouvrir les ports requis (par exemple, 33<xx>) sur le système SAP, où <xx> correspond au numéro de système SAP, pour permettre la communication entrante et sortante entre l'extracteur de données UiPath et le serveur SAP.

Si un proxy est utilisé, il doit transférer le même port 33<xx> depuis le proxy vers le port 33<xx> correspondant sur le système SAP. En effet, Theobald RFC ne prend pas en charge la connexion aux ports personnalisés ou remappés. Il doit se connecter en utilisant le format de port par défaut en fonction du numéro de système SAP.

Reportez-vous à la documentation officielle de Theobald sur les exigences du port pour plus d'informations.

L'installation de l'extracteur de données local Uipath comprend les étapes suivantes.

1. Configurez votre organisation UiPath Automation Cloud.
2. Installez l'extracteur de données UiPath dans votre environnement local.
3. Installez le RFC Theobald sur votre serveur SAP.
   Remarque : cette étape est requise uniquement lors de l'installation de l'extracteur de données UiPath pour l'extraction de données SAP.

1. Configuration de l’organisation UiPath Cloud

Suivez ces étapes pour configurer l'organisation UiPath Cloud pour l'extracteur de données Uipath.

1. Dans Automation Cloud, accédez à Admin.
2. Sélectionnez la vignette Applications externes pour ajouter une application externe.
3. Dans l'onglet Applications OAuth , sélectionnez + Ajouter une application.
4. Saisissez un nom descriptif pour la nouvelle application dans le champ Nom de l'application . Par exemple, « Extracteur sur site Process Mining »
5. Sélectionnez +Ajouter des étendues.
   1. Sélectionnez Accès à l'API Process Mining dans la liste des Ressources.
   2. Sélectionnez Étendue(s) de l’application et sélectionnez l’option ProcessMining.DataExtractor pour activer l’accès à Process Mining.
   3. Sélectionnez Enregistrer (Save).
6. Sur la page Ajouter une application , sélectionnez Ajouter. Un message de confirmation s’affiche
7. Copiez et collez l’ ID d’application et la Clé secrète de l’application, par exemple dans le Bloc-notes.
   Remarque : vous aurez besoin de l' ID de l'application et de la clé secrète de l'application lors de l'installation de l'extracteur de données local dans l'environnement local.
8. Sélectionnez Fermer(Close).

2. Installation de l'extracteur de données UiPath dans l'environnement local

Prérequis

L’extracteur de données local UiPath nécessite l’installation de .NET 8 ASP.NET Core Runtime. Vous pouvez télécharger la dernière version du site Web officiel de Microsoft .NET.

Téléchargement de l'extracteur de données UiPath local

Utilisez le lien suivant pour télécharger l’extracteur de données local UiPath :

https://uipath.blob.core.windows.net/download/UiPathDataExtractor.zip

Étapes d'installation

1. Extrayez le package d'installation.
2. Ouvrez PowerShell en tant qu'administrateur dans le dossier extrait.
3. Configurez DataExtractor/appsettings.json avec vos paramètres.
   Remarque : vous aurez besoin de l' ID de l'application et de la clé secrète de l'application enregistrés lors de la configuration de l'organisation UiPath Cloud.
   Attention : Assurez-vous que les informations d'identification de l'utilisateur définies dans le ConnectionString ont accès aux tables que vous souhaitez extraire.

   {
   "UiPathURL": "https://cloud.uipath.com/<OrgName>/<TenantName>",
   "S2S": {
       "ClientId": "<Application id from UiPath admin portal>",
       "ClientSecret": "<Application secret from UiPath admin portal>"
   },
   "LogFilePath": "<OPTIONAL: Path to log file, otherwise will be in /Logs>",
   "Connections":[
      {
        "Type": "sapOnPrem",
        "Name": "<Connection Name>",
        "ConnectionString": "USER=<User>;PASSWORD=<Password>;LANG=<Language>;CLIENT=<ClientNumber>;HOST=<Host IP address>;SYSNR=<System number>;FUNCTIONMODULE=<Function module name>;"
      },
       {
         "Type": "sqlServer",
         "Name": "<Connection Name>",
         "ConnectionString": "Server=<ServerAddr>;Initial Catalog=<DatabaseName>;User Id=<User>;Password=<Password>;"
       }
    ]
   }

4. Exécutez le script d'installation à l'aide de la commande Powershell suivante : ./Setup.ps1 -Install.

Remarque : Suivez ces étapes pour ajouter, modifier ou supprimer des connexions SQL Server ou SAP :

1. Modifiez le fichier appsettings.json et mettez à jour les valeurs selon vos besoins.
2. Exécutez à nouveau la commande d'installation ./Setup.ps1 -Install.

Astuce : Pour les options de script supplémentaires, vous pouvez utiliser la commande Powershell suivante : ./Setup.ps1 -Help

3. Installation de Theobald RFC sur votre serveur SAP

Theobald Xtract Universal est l'outil d'extraction certifié SAP utilisé pour l'extraction de données à partir de systèmes sources SAP, s'intégrant à SAP via des appels de fonction à distance (RFC). Theobald Xtract Universal contient le module de fonction personnalisé en lecture seule Z_THEO_READ_TABLE-transport1 qui doit être installé dans SAP.

Le dossier XtractCore/Transports de l'extracteur de données UiPath contient plusieurs versions des appels de fonction à distance (RFC) utilisés pour lire les tables, ainsi qu'un fichier README qui fournit des détails sur chaque version.

Reportez-vous à la section Configuration de Theobald Xtract Universal pour plus d'informations sur la configuration de l'environnement SAP pour qu'il s'exécute avec l'extracteur de données UiPath.

Désinstallation de l'extracteur de données UiPath

Utilisez la commande Powershell suivante pour désinstaller l'extracteur de données UiPath ./Setup.ps1 -Uninstall.

Tous les services sous-jacents sont arrêtés et désinstallés.