Verwenden Sie generische Skriptdatenquellen

Einleitung

UiPath Process Mining enthält Funktionen, die die Verarbeitung von Daten mit externen Tools unterstützen, wie z. B. R-Skript, Python, JavaScript, JavaScript, Aktivitätspakete, API-Zwecke usw., 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, stehen für die Verwendung im externen Prozess zur Verfügung.

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 auf dem Standardausgabekanal des externen Prozesses werden von der UiPath Process Mining Plattform als durch Semikolon getrennte Daten und in doppelte 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 Servereinstellungen konfigurieren . Fügen Sie dazu einen Schlüssel GenericScriptHandlers zu den Servereinstellungen hinzu. Der Wert dieses Schlüssels ist ein Objekt, bei dem:

• 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 versuchen wird, den richtigen Handler automatisch von der Erweiterung der Skriptdatei zu erkennen. Nachfolgend sehen Sie ein Beispiel für die Servereinstellung GenericScriptHandlers .

"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-Skripts, die typischerweise die Erweiterung „.pl“ haben, wählt die automatische Erkennung nicht den „perl“-Handler 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 mvscript -Treiber mit dem generic -Skript verwendet. Das generische Skript hat 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. Zum Beispiel: resources/my_script.r . Hinweis: Anstelle von scriptFile können Sie auch das Argument scriptText verwenden.	N
Skripttyp	Welcher Handler für die scriptFile verwendet werden soll. Sollte einer der Handler in der 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

Die Position des Skripts wird als relativ zum Tabellen-Scope interpretiert. Daher muss der Tabellen-Scope entweder auf Server oder Workspace festgelegt sein. Wenn sie auf Keine festgelegt ist, ist der Pfad zur Skriptdatei nicht vorhanden und das Laden der Daten schlägt fehl. Sie können den Tabellen-Scope in den erweiterten Tabellenoptionen festlegen.

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, d. h. 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 folgt 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 die Verarbeitung durch; … Schreibt das Ergebnis in einem Semikolon getrennt und in doppelten Anführungszeichen in den Standardausgabekanal. Die erste Zeile der Ausgabe sollte ein Header sein, der 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: * null ist, analysiert die Plattform den Standardausgabekanal des externen Prozesses als durch Semikolon getrennte Daten und in doppelten Anführungszeichen. Nicht null, zeigt die Plattform eine Fehlermeldung an, einschließlich aller Meldungen, die vom externen Prozess in den Standardfehlerkanal geschrieben wurden. Das Laden der Tabelle wird abgebrochen.