Utiliser des sources de données de script génériques

Introduction

UiPath Process Mining contient des fonctionnalités qui prennent en charge le traitement des données avec des outils externes, tels que le script R, Python, JavaScript, Ruby, Swift, etc., qui peuvent être utilisés comme source de données dans votre application.

En tant que développeur d'applications, vous pouvez définir les attributs à exporter vers le processus externe.

Remarque : seuls les attributs explicitement mis à disposition pour le traitement externe peuvent être utilisés dans le processus externe.

Traitement des données avec des outils externes

Vue d'ensemble (Overview)

Lorsque la source de données est rechargée, la plate-forme UiPath Process Mining génère les attributs définis dans un fichier. La plate-forme exécute ensuite le processus externe avec les arguments fournis par le développeur.

Le processus externe doit effectuer son traitement en lisant les données du fichier et en écrivant le résultat sur le canal de sortie standard. Le processus externe peut afficher des messages tels que des indications de progression, des avertissements et/ou des erreurs en écrivant dans son canal d'erreur standard.

Les données sur le canal de sortie standard du processus externe sont interprétées par la plate-forme UiPath Process Mining comme des données séparées par des points-virgules et entre guillemets.

Voir l'illustration ci-dessous pour un aperçu du flux de données de la plate-forme UiPath Process Mining vers le processus externe, et vice-versa.

Sources de données de script génériques

La source de données utilise le pilote mvscript , ce qui signifie qu'il s'agit d'une source de données de script. Le paramètre script utilisé par le pilote mvscript fait référence au script générique. Par exemple, la chaîne de connexion :

‘driver={mvscript}; script=Rscript’

fait référence à une source de données Rscript.

 

Dans ce guide, nous appelons ces sources de données une source de données de script générique. En principe, le script 'générique' ne prend pas uniquement en charge les scripts, mais aussi tout exécutable qui, étant donné la bonne combinaison d'arguments :

• peut lire les données d'un fichier, et
• afficher son résultat sous la forme de données séparées par un point-virgule et entre guillemets doubles.

Cependant, la cible principale de la source de données de script générique exécute des scripts personnalisés écrits en R, Python, etc.

Paramètres du serveur

Avant de pouvoir utiliser la source de données de script générique, vous devez configurer les gestionnaires disponibles dans les Paramètres du serveur. Pour ce faire, ajoutez une clé GenericScriptHandlers aux Paramètres du serveur. La valeur de cette clé est un objet, où :

• chaque clé désigne un identifiant pour le type de script,
• la valeur de chaque clé indique le chemin d'accès à l'exécutable de l'interpréteur du script.

L'identifiant peut être n'importe quelle chaîne. Cependant, il est recommandé d'utiliser l'extension de vos fichiers de script, car la plate-forme UiPath Process Mining essaiera de détecter automatiquement le bon gestionnaire à partir de l'extension du fichier de script. Vous trouverez ci-dessous un exemple du paramètre GenericScriptHandlers du serveur.

"GenericScriptHandlers": {
    "r": "D:/R/R.exe",
    "py": "P:/Python/bin/python.exe",
    "perl": "C:/Strawberry/perl/bin/perl.exe"
}

Les clés avec les extensions « .r » et « .py » sélectionneront automatiquement les exécutables R et Python.

Remarque : pour les scripts Perl, qui ont généralement l'extension « .pl », la détection automatique ne sélectionnera pas le gestionnaire « perl ». Dans ce cas, le paramètre de requête avancée scriptType peut être spécifié pour identifier le gestionnaire souhaité.

Autorisations

L'utilisateur Windows qui exécute Microsoft (c'est-à-dire IIS_IUSRS ) doit disposer de l'autorisation appropriée pour exécuter les exécutables référencés par les gestionnaires de script. Sinon, l’exécutable est introuvable.

Sources de données

Pour configurer une source de données de script générique, vous devez créer une table de chaînes de connexion qui utilise le pilote mvscript avec le script generic . Le script générique comporte plusieurs paramètres, dont généralement seuls les paramètres scriptFile et inputData doivent être spécifiés, car le reste peut être déduit par la plate-forme UiPath Process Mining .

 

Vue d'ensemble des paramètres

Le tableau suivant donne un aperçu des paramètres du script generic .

Paramètre	Description	Obligatoire O/N
scriptFile	Le chemin d'accès à votre script. Par exemple, resources/my_script.r . Remarque : au lieu de scriptFile , vous pouvez également utiliser l'argument scriptText .	N
TypeScript	Quel gestionnaire utiliser pour le scriptFile . Il doit s’agir de l’un des gestionnaires du fichier GenericScriptHandlers .	N
Données d’entrée	Les données qui doivent être transmises au script pour traitement.	Y
debugPath	Chemin d'accès absolu à un dossier. Si ce paramètre est spécifié, UiPath Process Mining affichera : • le fichier d'entrée (tel qu'il a été fourni 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.	N
arguments	Un tableau d'arguments supplémentaires à transmettre au gestionnaire du script, par exemple lors de l'utilisation de Python, cela peut être utilisé pour transmettre l'indicateur -I pour activer le mode isolé. • Au moins un des éléments du tableau doit être le texte <SCRIPT> pour indiquer où sur la ligne de commande le chemin d'accès au fichier de script doit être inséré. • Au moins un des éléments du tableau doit être le texte <INPUT> pour indiquer où sur la ligne de commande le chemin d'accès au fichier d'entrée doit être inséré.	N

Table Scope

L'emplacement du script est interprété comme relatif à l'étendue de la table. Par conséquent, l'étendue de la table doit être définie sur Serveur (Server) ou Espace de travail ( Workspace) . Lorsqu'il est défini sur Aucun, le chemin d'accès au fichier de script n'existe pas et le chargement des données échouera. Vous pouvez définir l'étendue de la table dans les options de table avancées ( Advanced table options).

Données

Les données peuvent être exportées de la manière la plus pratique pour le processus externe de réception.

Suivez ces étapes pour exporter les données que vous souhaitez traiter dans un script externe.

Étape	Action
1	Déterminez les champs qui doivent être disponibles dans le script.
2	Créez une nouvelle table globale dans votre application.
3	Créez un attribut d'expression de recherche dans la table globale pour chaque champ de l'étape 1.

Remarque : cette table peut ensuite être exportée afin que le script puisse la lire. La fonction csvtable() peut être utilisée pour convertir les données dans un format de type CSV. Étant donné que cette fonction attend une liste d'enregistrements (textes), le type de résultat de l'expression de recherche doit être une liste de texte, c'est-à-dire un enregistrement avec toutes les données encodées dans une liste.

Interface API

L'interface entre UiPath Process Mining et tout processus externe accessible via la source de données de script générique est définie comme décrit ci-dessous.

Étape	Description
1	UiPath Process Mining crée un fichier contenant les données spécifiées par le paramètre inputData .
2	Le processus externe : • lit les données du fichier ; • effectue son traitement ; • écrit le résultat sur son canal de sortie standard dans un format séparé par des points-virgules et entre guillemets doubles. La première ligne de sortie doit être un en-tête spécifiant les noms de colonnes. Par exemple : "Case_ID"; "Amount" "110553"; "73650" "110565"; "14420" "110689"; "262370" "110754"; "3500" "110939"; "50270" "111155"; "2400" "111251"; "27530" "111251"; "27530" "111397"; "123450" "111418"; "100"
3	Le processus externe écrit tous les messages d'état sur son canal d'erreur standard.
4	Le processus externe se termine avec un code de statut zéro, indiquant une réussite, ou un code de statut différent de zéro, indiquant un échec.
5	UiPath Process Mining évalue le code de statut renvoyé par le processus externe Si le code de statut est : • zéro, la plate-forme analysera le canal de sortie standard du processus externe en tant que données séparées par des points-virgules et entre guillemets doubles. • différent de zéro, la plate-forme affichera un message d'erreur, y compris tous les messages écrits sur le canal d'erreur standard par le processus externe. Le chargement de la table est abandonné.