Example: Creating an R Script

Einleitung

In diesem Beispiel wird erläutert, wie die UiPath Process Mining-Plattform mit externen R-Skripts verbunden wird, um die externe Datenverarbeitung zu implementieren.

Installieren von R

Führen Sie diese Schritte aus, um R-Skript auf der Plattform verwenden zu können.

Schritt	Aktion
1	Laden Sie die neueste Version des R-Pakets von . herunter https://cran.r-project.org/bin/windows/base/.
2	Installieren Sie R auf dem Server. Hinweis: Dies muss der Server sein, auf dem UiPath Process Mining installiert ist.
3	Suchen Sie das Installationsverzeichnis und den Pfad von Rscript.exe. Zum Beispiel: C:/Apps/Rscript.exe

R ist auf dem Server installiert und Entwickler können sich mit einer Verbindungszeichenfolge damit verbinden.

Der Installationspfad wird benötigt, um Verbindungszeichenfolgen für ein R-Skript zu erstellen.

Wichtig:

Beginnen Sie mit einigen Dummy-Daten, um die Einrichtung Ihres Arbeitsbereichs zu testen. Verwenden Sie beispielsweise das Beispiel „Hello World“, wie unter Beispiel: Erstellen eines Python-Skriptsbeschrieben.

Das Dummy-R-Skript enthält dann:

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

Allgemeine Übersicht

In diesem Beispiel wird ein R-Skript erstellt, das Fälle basierend auf ihren Ablaufverfolgungen gruppiert.

Schritte

1. Einrichten der Servereinstellungen;
2. Schreiben des Skripts.
3. Einrichten der Datenquelle;
4. Einrichten einer Skriptdatenquelle;

Einrichten der Servereinstellungen

Die generische Skriptdatenquelle erfordert Handler für alle externen Prozesse, die Sie ausführen möchten.

Führen Sie diese Schritte aus, um den Skript-Handler für das R-Skript hinzuzufügen.

Schritt	Aktion
1	Gehen Sie zur Registerkarte Superadministrator-Einstellungen.
2	Fügen Sie ein Feld GenericScriptHandlers mit einem Objekt als Wert mit einem Schlüssel „r“ hinzu, der als Wert den Pfad zu Ihrer ausführbaren Python-Datei hat. Zum Beispiel: "GenericScriptHandlers": {"r": "C:/Apps/Rscript.exe",}
3	Klicken Sie auf SPEICHERN.

Schreiben des Skripts

Starten Sie in Ihrem Texteditor eine leere Textdatei und geben Sie den folgenden Code ein.

## 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")

Führen Sie die folgenden Schritte aus.

Schritt	Aktion
1	Speichern Sie die Textdatei als script.r .
2	Laden Sie die script.r -Datei in Ihren Arbeitsbereich hoch.

Einrichten der Datenquelle

Um Eingabedaten zu definieren, erstellen Sie ein Attribut, das eine .CSV -ähnliche Zeichenfolge generiert. Er sollte in der Globals -Tabelle platziert werden, da er als Eingabe in einer Tabellendefinition dient.

Hinweis: Sie können die Funktion csvtable verwenden, um Eingabedaten zu definieren.

In diesem Beispiel haben wir eine Anwendung mit der Ereignistabelle. Siehe Abbildung unten.

Führen Sie diese Schritte aus, um einen Nachschlageausdruck R_input_data aus der Tabelle Globals zu Eventszu erstellen.

Schritt	Aktion
1	Öffnen Sie die App in Ihrer Entwicklungsumgebung und wechseln Sie zur Registerkarte Daten.
2	Wählen Sie die Tabelle Globale aus . Klicken Sie mit der rechten Maustaste auf die Tabelle Globals in der Tabellenelementliste, und wählen Sie Neuer Ausdruck…aus.
3	Legen Sie den Typ auf Lookup fest.
4	Wählen Sie Ereignisse als Eingabetabelle aus.
5	Geben Sie den folgenden Ausdruck ein: csvtable( 'CaseID', records.text(Case_ID) , 'Activity', records.text(Activity) )
6	Geben Sie R_input_data in das Namensfeld ein.
7	Klicken Sie auf OK , um das Ausdrucksattribut in der Tabelle Globals zu speichern.

Das Ausdrucksattribut wird in der Tabelle Globals erstellt. Siehe Abbildung unten.

Einrichten einer Skriptdatenquelle

Als Nächstes richten Sie eine Datenquellentabelle in der Anwendung ein, die das Skript aufruft.

Führen Sie diese Schritte aus, um die Skriptdatenquelle einzurichten.

Schritt	Aktion
1	Erstellen Sie auf der Registerkarte Daten eine neue Verbindungszeichenfolgentabelle.
2	Benennen Sie New_table in RscriptExample um.
3	Klicken Sie mit der rechten Maustaste auf die Tabelle RscriptExample und klicken Sie auf Erweitert > Optionen….
4	Legen Sie im Dialogfeld Tabellenoptionen den Tabellenbereich auf Arbeitsbereichfest.
5	Doppelklicken Sie auf die Tabelle RscriptExample , um das Fenster Verbindungszeichenfolgentabelle bearbeiten zu öffnen.
6	Geben Sie Folgendes als Verbindungszeichenfolge ein: ``'driver={mvscript
7	Geben Sie Folgendes als Abfrage ein: '' +'&scriptFile=' + urlencode("script.r") +'&inputData=' + urlencode(R_input_data) Siehe Abbildung unten.
8	Klicken Sie auf OKund dann auf JA , um die Daten neu zu laden.

Beim Laden der Daten werden neue Attribute erkannt. Klicken Sie auf JA(2x) und klicken Sie auf OK.

Die Tabelle Rscript_example hat jetzt zwei Datenquellenattribute, Case_ID und cluster.

Siehe Abbildung unten.

Definieren des R-Skripts im Abfragefeld

Anstatt eine separate Datei zu verwenden, die das R-Skript enthält, können Sie das R-Skript auch im Feld „ Abfrage “ des Dialogfelds „ Verbindungszeichenfolge bearbeiten “ definieren. In diesem Fall verwenden Sie den Parameter scriptText anstelle des Parameters scriptFile .

Siehe Abbildung unten.