Verwenden Sie generische Skriptdatenquellen

Einleitung

UiPath Process Mining enthält Funktionen, die die Verarbeitung von Daten mit externen Tools wie R-Skript, Python, JavaScript, Ruby, Swift usw. unterstützen, die als Datenquelle in Ihrer Anwendung verwendet werden können.

Als Anwendungsentwickler können Sie definieren, welche Attribute in den externen Prozess exportiert werden müssen.

Hinweis: Nur Attribute, die explizit für die externe Verarbeitung zur Verfügung gestellt werden, sind für die Verwendung im externen Prozess verfügbar.

Verarbeiten von Daten mit externen Tools

Überblick

Wenn die Datenquelle neu geladen wird, gibt die UiPath Process Mining- Plattform die definierten Attribute in eine Datei aus. Die Plattform führt dann den externen Prozess mit den vom Entwickler bereitgestellten Argumenten aus.

Der externe Prozess sollte seine Verarbeitung durchführen, indem er die Daten aus der Datei liest und das Ergebnis in den Standardausgabekanal schreibt. Der externe Prozess kann Meldungen wie Fortschrittsanzeigen, Warnungen und/oder Fehler anzeigen, indem er in seinen Standardfehlerkanal schreibt.

Die Daten im Standardausgabekanal des externen Prozesses werden von der UiPath Process Mining -Plattform als durch Semikolon getrennte Daten in Anführungszeichen interpretiert.

In der folgenden Abbildung finden Sie eine Übersicht über den Datenfluss von der UiPath Process Mining-Plattform zum externen Prozess und wieder zurück.

Generische Skriptdatenquellen

Die Datenquelle verwendet den Treiber mvscript , was bedeutet, dass es sich um eine Skriptdatenquelle handelt. Der vom mvscript -Treiber verwendete Parameter script } bezieht sich auf das generische Skript. Zum Beispiel die Verbindungszeichenfolge:

‘driver={mvscript}; script=Rscript’

verweist auf eine Rscript-Datenquelle.

 

In diesem Handbuch bezeichnen wir diese Datenquellen als generische Skriptdatenquelle. Im Prinzip unterstützt das „generische“ Skript nicht nur Skripte, sondern jede ausführbare Datei, die bei der richtigen Kombination von Argumenten:

• kann Daten aus einer Datei lesen und
• gibt das Ergebnis als durch Semikolon getrennte Daten in doppelten Anführungszeichen aus.

Das Hauptziel für die generische Skriptdatenquelle ist jedoch die Ausführung benutzerdefinierter Skripts, die in R, Python usw. geschrieben wurden.

Servereinstellungen

Bevor Sie die generische Skriptdatenquelle verwenden können, müssen Sie die verfügbaren Handler in den Servereinstellungenkonfigurieren. Fügen Sie dazu einen Schlüssel GenericScriptHandlers zu den Servereinstellungenhinzu. Der Wert dieses Schlüssels ist ein Objekt, wobei:

• jeder Schlüssel bezeichnet einen Bezeichner für den Skripttyp,
• Der Wert für jeden Schlüssel gibt den Pfad zur ausführbaren Interpreterdatei des Skripts an.

Der Bezeichner kann eine beliebige Zeichenfolge sein. Es wird jedoch empfohlen, die Erweiterung Ihrer Skriptdateien zu verwenden, da die UiPath Process Mining -Plattform versucht, den richtigen Handler automatisch aus der Erweiterung der Skriptdatei zu erkennen. Nachfolgend finden Sie ein Beispiel für die GenericScriptHandlers -Servereinstellung.

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

Die Schlüssel mit den Erweiterungen „.r“ und „.py“ wählen automatisch die ausführbaren R- und Python-Dateien aus.

Hinweis: Bei Perl-Skripten, die normalerweise die Erweiterung „.pl“ haben, wählt die automatische Erkennung den „perl“-Handler nicht aus. In diesem Fall kann der erweiterte Abfrageparameter scriptType angegeben werden, um den gewünschten Handler zu identifizieren.

Berechtigungen

Der Windows-Benutzer, der Microsoft ausführt (d. h. IIS_IUSRS ) muss über die richtige Berechtigung zum Ausführen der ausführbaren Dateien verfügen, auf die von den Skript-Handlern verwiesen wird. Andernfalls kann die ausführbare Datei nicht gefunden werden.

Datenquellen

Um eine generische Skriptdatenquelle zu konfigurieren, müssen Sie eine Verbindungszeichenfolgentabelle erstellen, die den Treiber mvscript mit dem Skript generic verwendet. Das generische Skript verfügt über mehrere Parameter, von denen normalerweise nur die Parameter scriptFile und inputData angegeben werden müssen, da der Rest von der UiPath Process Mining- Plattform abgeleitet werden kann.

 

Parameterübersicht

Die folgende Tabelle gibt einen Überblick über die generic -Skriptparameter.

Parameter	Beschreibung	Obligatorisch: J/N
scriptFile	Der Pfad zu Ihrem Skript. Beispiel: resources/my_script.r . Hinweis: Anstelle von scriptFile können Sie auch das Argument scriptText verwenden.	N
Skripttyp	Welcher Handler für scriptFile verwendet werden soll. Sollte einer der Handler in GenericScriptHandlers sein.	N
Eingabedaten	Die Daten, die zur Verarbeitung an das Skript übergeben werden sollen.	Y
debugPath	Ein absoluter Pfad zu einem Ordner. Wenn dieser Parameter angegeben ist, gibt UiPath Process Mining Folgendes aus: • die Eingabedatei (wie an den externen Prozess übergeben) und • die Ausgabe des externen Prozesses (wie aus der Standardausgabe des externen Prozesses gelesen) in diesem Ordner zu Debugzwecken.	N
Argumente	Ein Array zusätzlicher Argumente, die an den Handler des Skripts übergeben werden, z. B. bei der Verwendung von Python, kann dies verwendet werden, um das Flag -I zu übergeben, um den isolierten Modus zu aktivieren. • Mindestens eines der Array-Elemente muss der Text <SCRIPT> sein, um anzugeben, wo in der Befehlszeile der Pfad zur Skriptdatei eingefügt werden soll. • Mindestens eines der Array-Elemente muss der Text <INPUT> sein, um anzugeben, wo in der Befehlszeile der Pfad zur Eingabedatei eingefügt werden soll.	N

Table Scope

Der Speicherort des Skripts wird als relativ zum Tabellenbereich interpretiert. Daher muss der Tabellenbereich entweder auf Server oder Arbeitsbereichfestgelegt werden. Wenn es auf Nonefestgelegt ist, ist der Pfad zur Skriptdatei nicht vorhanden und das Laden der Daten schlägt fehl. Sie können den Tabellenbereich in den erweiterten Tabellenoptionenfestlegen.

Daten

Die Daten können auf jede Weise exportiert werden, die für den empfangenden externen Prozess am bequemsten ist.

Führen Sie diese Schritte aus, um die Daten zu exportieren, die Sie in einem externen Skript verarbeiten möchten.

Schritt	Aktion
1	Bestimmen Sie die Felder, die im Skript verfügbar sein müssen.
2	Erstellen Sie eine neue globale Tabelle in Ihrer Anwendung.
3	Erstellen Sie ein Lookup-Ausdrucksattribut in der globalen Tabelle für jedes Feld von Schritt 1.

Hinweis: Diese Tabelle kann dann exportiert werden, damit das Skript sie einlesen kann. Die Funktion csvtable() kann verwendet werden, um die Daten in ein CSV-ähnliches Format zu konvertieren. Da diese Funktion eine Liste von (Text-)Datensätzen erwartet, muss der Ergebnistyp des Suchausdrucks eine Textliste sein, dh ein Datensatz mit allen Daten, die in einer Liste codiert sind.

API-Schnittstelle

Die Schnittstelle zwischen UiPath Process Mining und jedem externen Prozess, auf den über die generische Skriptdatenquelle zugegriffen wird, ist wie unten beschrieben definiert.

Schritt	Beschreibung
1	UiPath Process Mining erstellt eine Datei mit den durch den Parameter inputData angegebenen Daten.
2	Der externe Prozess: • liest die Daten aus der Datei; • führt deren Verarbeitung durch; • schreibt das Ergebnis in den Standardausgabekanal in einem durch Semikolon getrennten Format und in doppelten Anführungszeichen. Die erste Ausgabezeile sollte eine Kopfzeile sein, die Spaltennamen angibt. Zum Beispiel: "Case_ID"; "Amount" "110553"; "73650" "110565"; "14420" "110689"; "262370" "110754"; "3500" "110939"; "50270" "111155"; "2400" "111251"; "27530" "111251"; "27530" "111397"; "123450" "111418"; "100"
3	Der externe Prozess schreibt alle Statusmeldungen in seinen Standardfehlerkanal.
4	Der externe Prozess wird entweder mit einem Statuscode von Null (Erfolg) oder einem Statuscode ungleich Null (Fehler) beendet.
5	UiPath Process Mining wertet den vom externen Prozess zurückgegebenen Statuscode aus. Wenn der Statuscode lautet: • null, die Plattform analysiert den Standardausgabekanal des externen Prozesses als durch Semikolon getrennte und in doppelte Anführungszeichen gesetzte Daten. • ungleich Null zeigt die Plattform eine Fehlermeldung an, einschließlich aller Meldungen, die vom externen Prozess in den Standardfehlerkanal geschrieben werden. Das Laden der Tabelle wird abgebrochen.