Types de chaîne de connexion

Introduction

Plusieurs types de chaînes de connexion peuvent être utilisés. Ce guide décrit les différents types de chaînes de connexion.

Fichiers

Les fichiers peuvent être chargés dans une table en définissant un paramètre de pilote de la chaîne de connexion sur {mvfile} .

driver={mvfile}

Les types de fichiers suivants peuvent être chargés :

• Fichiers Excel .xls et .xlsx
• Fichiers texte .csv , .tsv et .txt

Des paramètres supplémentaires peuvent être spécifiés pour charger des fichiers.

Vous trouverez ci-dessous un aperçu des paramètres génériques disponibles ou des fichiers de chargement.

Paramètre	Description
FileName	Il peut s'agir d'un chemin d'accès relatif à un fichier sur le serveur ou d'une URL HTTP. Lorsque le fichier se trouve sur le serveur, il doit être placé dans l'onglet Données de développement (Development data ) ou Données du serveur ( Server data ), et l' étendue Table de la table doit être définie en conséquence. Lorsque vous utilisez une URL HTTP, vous pouvez spécifier les paramètres user et pass pour l'authentification.
poste	Par défaut, l'extension de nom de fichier est utilisée pour déterminer le type de fichier, mais vous pouvez la remplacer.
Utilisateur (User)	Le nom d'utilisateur du fichier distant lors de l'utilisation d'une URL HTTP.
passer	Le mot de passe du fichier distant lors de l'utilisation d'une URL HTTP.

Fichiers Excel

Vous trouverez ci-dessous un aperçu des paramètres supplémentaires pouvant être utilisés pour charger des fichiers Excel.

Paramètre	Description
Feuille	La feuille ou la plage nommée à importer. Pour les noms de feuille, un signe dollar doit être ajouté à la fin. Si la plage n'est pas spécifiée, la feuille entière sera effacée.
Première colonne	La première colonne à partir de laquelle commencer. Le paramètre par défaut est {autodetect}.
Première ligne	La première ligne de départ. Le paramètre par défaut est {autodetect}.

Le tableau ci-dessous contient des exemples de chaînes de connexion pour le chargement de fichiers Excel.

Chaîne de connexion	Chargements...
'driver={mvfile}; filename=Data/Dataset.xlsx;'	la première feuille d'un fichier Excel
'driver={mvfile}; filename=Data/Dataset.xlsx; sheet=MySheet$;'	la feuille nommée « MySheet »

Fichiers texte

Vous trouverez ci-dessous un aperçu des paramètres supplémentaires pouvant être utilisés pour charger des fichiers texte.

Paramètre	Description
A une en-tête	Indique si la première ligne du fichier est une ligne d'en-tête. Le paramètre par défaut est {true} .
délimiter	Le caractère de délimitation. Le paramètre par défaut est {tab} .
devis	Le caractère utilisé pour mettre les valeurs entre guillemets. Le paramètre par défaut est {autodetect} .
échapper	Caractère utilisé pour échapper les caractères. Le paramètre par défaut est {none}.
Encodage	L'encodage utilisé dans le fichier, par exemple, UTF8 ou LATIN1. Le paramètre par défaut est {UTF8} .

Le tableau ci-dessous contient des exemples de chaînes de connexion pour le chargement de fichiers texte.

Chaîne de connexion	Charge un fichier texte...
driver={mvfile}; filename=Textfile.txt; delim=,; quote=";'	avec des virgules (,) comme séparateurs et des guillemets "
'driver={mvfile}; filename=Textfile.txt; delim=|; quote=";'	avec des séparateurs pipe (|) et des guillemets "
"driver={mvfile}; filename=Textfile.txt; delim=9; quote=';"	avec des séparateurs de tabulation et des guillemets
'driver={mvfile}; filename=Textfile.txt; delim=59; quote=none;'	avec des séparateurs point-virgule et sans guillemets
'driver={mvfile}; filename=Textfile.txt; delim=,; quote="; escape=\;'	avec des virgules (,) comme séparateurs, des guillemets " et des caractères d'échappement \
'driver={mvfile}; filename=http://www.example.com/files/example.txt;'	à partir d'un serveur Web
'driver={mvfile}; filename=http://www.example.com/files/example.txt; User=Jane; mv-credential-Pass=example_com_credentials'	à partir d'un serveur Web avec authentification d'accès de base

ODBC

ODBC est utilisé pour se connecter à des sources de données externes, généralement des bases de données. Vous pouvez le faire à l'aide du système d'exploitation, tel que le gestionnaire de sources de données ODBC dans Microsoft Windows, ou fournir directement la chaîne de connexion au format correct.

Il est possible que le pilote ODBC ait besoin d'une requête pour s'exécuter. La requête qui doit être exécutée sur la base de données peut être fournie sous forme de chaîne dans le champ Requête .

Important : lorsque vous testez une connexion ODBC, assurez-vous que le champ Requête est rempli avec une requête valide.

Important : toutes les bases de données disposant d'une version 64 bits sont accessibles via une connexion ODBC. Le pilote ODBC 64 bits requis doit être installé sur le serveur UiPath Process Mining et le serveur doit pouvoir accéder à ce système spécifique.

Vous trouverez ci-dessous un aperçu des paramètres pouvant être utilisés pour les connexions ODBC.

Paramètre	Description
pilote	Le pilote ODBC à utiliser pour cette connexion. Non nécessaire lors de l'utilisation du paramètre 'dsn' .
dsn	Le DSN ODBC à utiliser pour cette connexion. Non nécessaire lors de l'utilisation du paramètre 'driver' . Remarque : lors de la configuration d'un DSN à utiliser dans la chaîne de connexion, assurez-vous qu'il s'agit d'un DSN système 64 bits.
Utilisateur (User)	Nom d'utilisateur à utiliser pour se connecter à la source de données externe.
passer	Le mot de passe à utiliser pour se connecter à la source de données externe.
autre	Tous les autres paramètres sont définis tels que spécifiés au pilote ODBC.

Le tableau ci-dessous contient des exemples de chaînes de connexion pour les connexions ODBC.

Chaîne de connexion	Se connecte...
'Driver={SQL Server Native Client 11.0};Server=SERVERNAME;Database=MyDatabase;'	à une base de données SQL Server
'Driver={Oracle in OraClient12Home1};Dbq=MyTSN;'	à une base de données Oracle
'DSN=MyDSN; Utilisateur=MonUtilisateur; Pass=MyPass;'	à l'aide d'un DSN configuré avec un nom d'utilisateur et un mot de passe

La chaîne de connexion et le champ Requête sont des expressions. Par exemple, une table de chaînes de connexion à une base de données imaginaire peut être créée.

Voir illustration ci-dessous.

Remarque : les données de la table ne peuvent être utilisées que lorsque la table a été chargée. Dans cet exemple, la table Globals est nécessaire pour utiliser les données d'autres tables.

Trucs et astuces

Pour connaître les formats de chaîne de connexion d'autres systèmes, consultez le fabricant de ce système ou une ressource en ligne telle que https://www.connectionstrings.com/.

Si l'utilisateur ayant accès à la base de données est un utilisateur Windows, assurez-vous que cet utilisateur Windows :

• est un compte de service et non un utilisateur réel.
• dispose d'un accès en lecture/écriture au dossier d'installation de Process Mining .
• est l'utilisateur qui exécute les scripts (par exemple, dans les tâches planifiées) pour le chargement des données.
• est utilisé pour exécuter le pool d’applications dans IIS.

SAP HANA

Vous pouvez utiliser une connexion ODBC pour vous connecter à SAP HANA.

Vous trouverez ci-dessous un exemple de chaîne de connexion pour SAP HANA.

'Driver={HDBODBC};User=MyUser;Pass=MyPass;ServerNode=MyServer:30015;DatabaseName=TDB1'

Remarque : au lieu de se connecter à une base de données SAP, il est recommandé d'utiliser le type de chaîne de connexion SAP pour se connecter au serveur d'applications SAP.

Scripts génériques

Vous pouvez utiliser une chaîne de connexion pour exécuter un script afin de charger des données à partir de sources de données.

Important : le gestionnaire de script que vous souhaitez exécuter doit être installé sur le serveur UiPath Process Mining .

Les fichiers peuvent être chargés dans une table en définissant le paramètre de pilote de la chaîne de connexion sur {mvscript} et le paramètre de script sur « générique » :

driver={mvscript}; script=generic

Remarque : vous devez spécifier les paramètres de script dans le champ Requête à l'aide du codage d'URL.

Vous trouverez ci-dessous un aperçu des paramètres qui peuvent être spécifiés dans le champ Requête .

Paramètre	Description	Obligatoire/Facultatif
TexteScript	Le texte du script.	Obligatoire Remarque : uniquement si scriptFile n'est pas utilisé.
scriptFile	Nom du fichier à partir duquel charger le script. Il peut s'agir d'un chemin d'accès relatif à un fichier sur le serveur. Lorsque le fichier se trouve sur le serveur, il doit être placé dans l'onglet Données de développement (Development data ) ou Données du serveur ( Server data ), et l' étendue Table de la table doit être définie en conséquence.	Obligatoire Remarque : uniquement si scriptText n'est pas utilisé.
Données d’entrée	Un texte séparé par un point-virgule avec des en-têtes de colonne qui contient l'entrée du script. Remarque : la fonction csvtable peut être utilisée pour générer des données au format correct.	Obligatoire
TypeScript	Le nom du descripteur à utiliser, comme spécifié dans le paramètre GenericScriptHandlers des Paramètres du serveur. Remarque : si scriptFile est spécifié, cela sera automatiquement détecté en fonction de l'extension de fichier.	En option
arguments	Personnalisez les arguments à transmettre au script. Il doit s'agir d'une liste encodée en JSON . Il existe deux arguments spéciaux ; '<SCRIPT>' et '<INPUT>' . Les occurrences de '<SCRIPT>' sont remplacées par le chemin d'accès à un fichier de script, et les occurrences de '<INPUT>' sont remplacées par le chemin d'accès au fichier d'entrée. Cela vous permet de personnaliser l'appel au gestionnaire de script avec des arguments supplémentaires. La valeur par défaut est ["<SCRIPT>", "<INPUT>"] .	Facultatif
debugPath	Chemin d'accès absolu à un dossier. Si ce paramètre est spécifié, UiPath Process Mining produira le fichier d'entrée (telle que donnée au processus externe) et la sortie du processus externe (telle que lue à partir de la sortie standard du processus externe) dans ce dossier à des fins de débogage.	Facultatif

Vous trouverez ci-dessous un exemple de requête simple.

+'&scriptFile=' + urlencode("script.py")
+'&inputData='  + urlencode("a;b;c"+#10+"1;2;3"+#10+"4;5;6")

Vous trouverez ci-dessous un exemple de requête plus avancée.

+'&scriptText=' + urlencode(/* your script as text */)
+'&scriptType=' + urlencode("HandlerName")
+'&inputData='  + urlencode(csvtable(
    "Case_ID", jsontolist(InputData_Case_ID)
    "Amount" , jsontolist(InputData_Amount)
))
+'&args='       + urlencode(listtojson(["<SCRIPT>", "--filename", "<INPUT>"]))

Voir aussi : Utiliser des sources de données de script génériques

SAP

Les chaînes de connexion SAP peuvent être utilisées pour se connecter à un serveur d'applications SAP, tel que SAP R3, SAP ERP, SAP ECC 5.0, SAP ECC 6.0, S/4HANA.

Important : la bibliothèque SAP NWRFC doit être installée sur le serveur UiPath Process Mining pour utiliser une source de données SAP à partir de la chaîne de connexion.

Les sources de données SAP peuvent être chargées en définissant le paramètre de pilote de la chaîne de connexion sur {SAP} .

driver={SAP}

Vous trouverez ci-dessous un aperçu des paramètres pouvant être utilisés pour les sources de données SAP.

Paramètre	Description	Obligatoire/Facultatif
Host (Hôte)	Le nom d'hôte ou l'adresse IP du serveur d'applications SAP.	Obligatoire
SystemNumber	Le nombre à deux chiffres situé entre 00 et 99 qui identifie l'instance désignée.	Obligatoire
ModuleFonction	Remarque : lors de la configuration d'une extraction SAP native, le module de fonction SAP Z_XTRACT_IS_TABLE est requis. Si, par exemple, le module de fonction est renommé dans votre système SAP, vous pouvez spécifier le nom correct dans le paramètre FunctionModule de la chaîne de connexion SAP.FunctionModule Paramètres Remplace le module de fonction Z_XTRACT_IS_TABLE par défaut qui est utilisé lors de l'interrogation de cette table.	Facultatif
Nom d'utilisateur (Username)	Le nom d'utilisateur du compte utilisé pour se connecter à l'instance SAP.	Obligatoire
passer	Le mot de passe de l'utilisateur ci-dessus. Peut être utilisé en combinaison avec le magasin d'informations d'identification, utilisez mv-credential-pass dans ce cas.	Obligatoire
Client (Client)	Le client utilisé.	Obligatoire
Langue	La langue utilisée lors de la connexion.	Obligatoire

Vous trouverez ci-dessous un aperçu des paramètres qui peuvent être spécifiés dans le champ Requête .

Paramètre	Description	Obligatoire/Facultatif
Table	Nom de la table SAP à partir de laquelle les données doivent être chargées. Par exemple EKPO .	Obligatoire
Champs	Tableau de champs qui seront récupérés de la table SAP spécifiée dans la propriété table . Remarque : si la propriété fields est vide, tous les champs seront récupérés.	Obligatoire
Où	Une clause where pour récupérer un sous-ensemble d'une table.	Facultatif
limit	Un nombre entier qui spécifie un nombre fixe d'enregistrements à récupérer à partir de la table. Remarque : si limit est défini sur « 0 », il n’y aura pas de limite.	Facultatif

Remarque : chaque champ dans SAP a une longueur. Pour des raisons de performances, assurez-vous que la somme de toutes les longueurs de champ récupérées pour une table ne dépasse pas 512.

Vous trouverez ci-dessous un exemple de chaîne de connexion SAP.

'Driver={SAP};Host=10.10.10.10;SystemNumber=00;Username=MyUser;pass=secretPassword;client=100;Language=EN'

Vous trouverez ci-dessous quelques exemples de requêtes.

Requête	Récupère...
'table=' + urlencode("EKPO")	tous les champs de tous les enregistrements de la table EKPO .
'table=' + urlencode("EKPO") + '&fields=' + urlencode(listtojson(["MANDT", "EBELN"]))	les champs MANDT et EBELN pour tous les enregistrements de la table EKPO .
'table=' + urlencode("EKPO") + '&where=' + urlencode("EBELN = 4500000001")	tous les champs de la table EKPO où EBELN est égal à 4500000001.