Example: Creating an R Script

Introduction

Cet exemple explique comment interfacer la plate-forme UiPath Process Mining avec des scripts R externes pour implémenter le traitement des données externes.

Installation de R

Suivez ces étapes pour pouvoir utiliser R-script dans la plate-forme.

Étape	Action
1	Téléchargez la dernière version du package R à partir de https://cran.r-project.org/bin/windows/base/.
2	Installez R sur le serveur. Remarque : il doit s'agir du serveur sur lequel UiPath Process Mining est installé.
3	Localisez le répertoire d'installation et trouvez le chemin de Rscript.exe. Par exemple : C:/Apps/Rscript.exe

R est installé sur le serveur et les développeurs peuvent s'y connecter avec une chaîne de connexion.

Le chemin d'installation est nécessaire pour créer des chaînes de connexion pour un script R.

Important :

Commencez par utiliser des données factices pour tester la configuration de votre espace de travail. Par exemple, utilisez l'exemple « Hello World » comme décrit dans Exemple : Création d'un script Python.

Le script R factice contiendra alors :

write("Hello world!", stderr()); quit("default", 1)

Présentation générale

Dans cet exemple, un script R est créé pour regrouper les incidents en fonction de leurs traces.

Étapes

1. Configuration des paramètres du serveur ;
2. Écriture du script.
3. Configuration de la source de données ;
4. Configuration d'une source de données de script ;

Configuration des paramètres du serveur

La source de données de script générique nécessite des gestionnaires pour tous les processus externes que vous souhaitez exécuter.

Suivez ces étapes pour ajouter le gestionnaire de script pour le script R.

Étape	Action
1	Accédez à l'onglet Paramètres du Superadmin (Superadmin Settings).
2	Ajoutez un champ GenericScriptHandlers avec comme valeur un objet avec une clé, « r », qui a pour valeur le chemin d’accès à votre exécutable python. Par exemple : "GenericScriptHandlers": {"r": "C:/Apps/Rscript.exe",}
3	Cliquez sur ENREGISTRER (SAVE).

Écriture du script

Dans votre éditeur de texte, démarrez un fichier texte vierge et entrez le code suivant.

## get command line arguments
args <- commandArgs(trailingOnly=TRUE)
inputfile <- args[1]
## read csv file
input <- file(inputfile, 'r')
df <- read.table(input, header=TRUE, sep=";")
## pre-processing
df <- table(df)
df <- as.data.frame.matrix(df)
df <- df[, sapply(data.frame(df), function(df) c(length(unique(df)))) > 1] #remove columns with unique value 
## cluster
df <- scale(df)
kc <- kmeans(df, centers = 5)
cluster <- kc$cluster
## output
resultdata <- cbind(rownames(df), cluster)
colnames(resultdata)[1] <- 'Case ID'
write.table(resultdata, row.names = FALSE, sep=";", qmethod = "double")

Suivez les étapes ci-dessous :

Étape	Action
1	Enregistrez le fichier texte sous le nom script.r .
2	Téléchargez le fichier script.r dans votre espace de travail.

Configuration de la source de données

Pour définir les données d'entrée, créez un attribut qui génère une chaîne de type .CSV . Il doit être placé dans la table Globals , car il servira d'entrée dans une définition de table.

Remarque : vous pouvez utiliser la fonction csvtable pour définir les données d'entrée.

Pour cet exemple, nous avons une application avec une table Events. Voir illustration ci-dessous.

Suivez ces étapes pour créer une expression de recherche R_input_data de la table Globals vers Events.

Étape	Action
1	Ouvrez l'application dans votre environnement de développement et accédez à l'onglet Données (Data) .
2	Sélectionnez la table Globals . Cliquez avec le bouton droit sur la table Globals dans la liste des éléments de la table et sélectionnez Nouvelle expression….
3	Définissez le type sur Recherche (Lookup).
4	Sélectionnez Événements comme table d'entrée.
5	Saisissez l'expression suivante : csvtable( 'CaseID', records.text(Case_ID) , 'Activity', records.text(Activity) )
6	Saisissez R_input_data dans le champ du nom.
7	Cliquez sur OK pour enregistrer l'attribut d'expression dans la table Globals .

L'attribut d'expression est créé dans la table Globals . Voir l'illustration ci-dessous.

Configuration d'une source de données de script

Ensuite, configurez une table de source de données dans l'application qui appellera le script.

Suivez ces étapes pour configurer la source de données de script.

Étape	Action
1	Dans l'onglet Données (Data), créez une table de chaînes de connexion.
2	Renommez New_table en RscriptExample .
3	Cliquez avec le bouton droit sur la table RscriptExample et cliquez sur Avancé (Advanced) > Options… ( Advanced > Options…).
4	Dans la boîte de dialogue Options de la table , définissez l' étendue de la table sur Espace de travail.
5	Double-cliquez sur la table RscriptExample pour ouvrir la fenêtre Modifier la table de chaînes de connexion ( Edit Connection String Table) .
6	Entrez ce qui suit comme chaîne de connexion: ``'driver={mvscript
7	Entrez ce qui suit en tant que requête: '' +'&scriptFile=' + urlencode("script.r") +'&inputData=' + urlencode(R_input_data) Voir illustration ci-dessous.
8	Cliquez sur OK, puis sur OUI pour recharger les données.

Lors du chargement des données, de nouveaux attributs sont détectés. Cliquez sur OUI(2x) et cliquez sur OK.

La table Rscript_example a maintenant deux attributs de source de données, Case_ID et cluster.

Voir illustration ci-dessous.

Définition du script R dans le champ de requête

Au lieu d'utiliser un fichier séparé contenant le script R, vous pouvez également définir le script R dans le champ Requête de la boîte de dialogue Modifier la chaîne de connexion ( Edit Connection String) . Dans ce cas, vous utilisez le paramètre scriptText au lieu du paramètre scriptFile .

Voir illustration ci-dessous.