Einrichten automatisierter Datenaktualisierungen

Einleitung

Wenn Sie häufig oder in Intervallen Daten für UiPath Process Mining laden möchten, können Sie automatisierte Datenaktualisierungen einrichten. In dieser Anleitung wird beschrieben, wie Sie automatisierte Datenaktualisierungen mithilfe eines Batchskripts einrichten.

Beim Ausführen des Skripts wird zuerst die Ordnerstruktur für ein Dataset generiert, das den von Ihnen angegebenen Dataset-Namen verwendet. Dann werden alle Tabellen im Connector neu geladen und für das angegebene Modul zwischengespeichert. Diese zwischengespeicherten Tabellen werden verwendet, um die Ausgabetabellen aus dem Connector zu exportieren. Das Ausgabe-Dataset wird verwendet, um einen Cache für die Anwendung in der angegebenen Umgebung zu generieren.

Voraussetzungen

Sie benötigen Zugriff auf den Server oder die virtuelle Maschine, die die UiPath Process Mining- Installation enthält.

Außerdem benötigen Sie einen Connector in einem Arbeitsbereich.

Hinweis: Das Skript nimmt die Identität Ihres Arbeitsbereichs an. Sie sollten einen Arbeitsbereich für den Connector erstellen und sicherstellen, dass der Arbeitsbereich auf dem neuesten Stand ist. Die Datenaktualisierung verwendet den angegebenen Arbeitsbereich unverändert und verwendet alle nicht festgeschriebenen Änderungen, falls vorhanden. Daher wird empfohlen, einen dedizierten Arbeitsbereich nur für die Datenaktualisierung zu verwenden.

Wichtig:

Dieses Batch-Skript erfordert, dass der Build des Arbeitsbereichs und der Superadministrator identisch sind. Wenn Sie den Build des Superadministrators aktualisieren, ohne ihn für den Arbeitsbereich zu ändern (oder umgekehrt), schlägt das Skript fehl, sodass keine Daten aktualisiert werden.

Daher wird empfohlen, den Build an allen Orten (Superadmin, Connector und andere Anwendungen) gleichzeitig zu aktualisieren.

Schritt 1: Vorbereitung

Erstellen Sie ein Batch-Skript, das Sie für die automatisierten Datenaktualisierungen aus dem folgenden Codebeispiel verwenden möchten, und speichern Sie es im Stammordner Ihrer UiPath Process Mining- Installation.

Hinweis: Es wird empfohlen, den Namen des Prozesses und des Systems in den Batchdateinamen aufzunehmen.

set MAINDIR=%~dp0
set DATASET=FullData
set ENVIRONMENT=production
set WORKSPACE=Peter/Connector
mkdir "%MAINDIR%\datax\_datasets\%DATASET%"
mkdir "%MAINDIR%\datax\_datasets\%DATASET%\_org"
echo. > "%MAINDIR%\datax\_datasets\%DATASET%\nomodcodes.marker"
for %%M in (..) do (
              call "%MAINDIR%\builds\processgold.bat" -dataserver -workspace "%WORKSPACE%" "" -CCDB app="%%M" o= refreshmvncaches=true
              mkdir "%MAINDIR%\datax\_datasets\%DATASET%\_org\MVNCache" 
              call "%MAINDIR%\builds\processgold.bat" -dataserver -workspace "%WORKSPACE%" "" -export app="%%M" out="%MAINDIR%\datax\_datasets\%DATASET%\_org\MVNCache" o= refreshmvncaches=false reusecache=true onlymarked=true
)
call "%MAINDIR%\builds\processgold.bat" -dataserver -skipmail -env "%ENVIRONMENT%" -CCDB o=* dataset="%DATASET%" p=*

Schritt 2: Festlegen der Parameter im Skript

Nachfolgend finden Sie eine Beschreibung der Parameter, die Sie im Skript angeben müssen.

Parameter	Beschreibung
Dataset	der Name des Ausgabe-Datasets, das Sie aus dem Skript generieren möchten. Dieses Dataset wird auf der Registerkarte Superadmin-Entwicklungsdaten angezeigt .
Umgebung	die Umgebung, für die Sie einen Cache generieren möchten. Hinweis: Normalerweise ist dies die Umgebung, in der AppOne für Ihren Prozess aktiv ist.
Arbeitsbereich	der Pfad zum Arbeitsbereich, in dem sich der Connector befindet. Dies ist Ihr Anmeldename, gefolgt vom Namen des Arbeitsbereichs. Wenn das Skript den richtigen Arbeitsbereich nicht finden kann, verwenden Sie einen Schrägstrich anstelle eines umgekehrten Schrägstrichs.

Arbeitsbereichsname

Führen Sie diese Schritte aus, um den Pfad zum Arbeitsbereich zu bestimmen.

Schritt	Aktion
1	Wechseln Sie zum Installationsordner von UiPath Process Mining .
2	Wechseln Sie zum Arbeitsbereichsordner.
3	Wechseln Sie zum Ordner [Ihr Anmeldename] . Der Ordner enthält einen Ordner für jeden Ihrer Arbeitsbereiche.

Wichtig:

Wenn Ihr Anmeldename Sonderzeichen enthält, wird der Ordner mit dem Benutzernamen für HTML codiert. Für die Verwendung im Skript muss % jedoch mit drei zusätzlichen %s maskiert werden.

Beispiel: Wenn Ihr Benutzername [e-mail] ist, wird daraus der Ordner test%2Eexample%40uipath%2Ecom . Im Skript muss der Benutzername als test%%%%2Eexample%%%%40uipath%%%%2Ecom angegeben werden. Wenn der Benutzername einen Unterstrich ('_') enthält, muss dieser Unterstrich mit %%%%5F werden.

Schritt 3: Hinzufügen des Connector-Modulcodes

Einige Connectors verfügen über mehrere Module. Daher müssen Sie den Modulcode für den Connector angeben, für den Sie automatisierte Datenaktualisierungen implementieren möchten.

Fügen Sie den Modulcode Ihres Connectors in der Schleife for %M in (…) do hinzu.

Führen Sie diese Schritte aus, um den Modulcode zu finden und dem Skript hinzuzufügen.

Schritt	Aktion
1	Öffnen Sie den Connector in Ihrer Entwicklungsumgebung.
2	Klicken Sie auf das Logo-Symbol und wählen Sie Module...aus.
3	Kopieren Sie den Modulcode aus dem Feld Anwendungscode .
4	Klicken Sie auf ABBRECHEN , um das Dialogfeld Module zu schließen.
5	Schließen Sie den Connector.
6	Ersetzen Sie im Skript das „...“ innerhalb von ( ) durch den Modulcode Ihres Connectors in der Schleife for %M in (…) do .

Schritt 4: Planen einer Aufgabe für die Synchronisierung

Sie können die Windows-Aufgabenplanung verwenden, um eine Aufgabe zu planen, die das Batch-Skript für automatisierte Datenaktualisierungen ausführt.

Hinweis: Es wird empfohlen, das lokale SYSTEM-Benutzerkonto für die Ausführung der Aufgabe auszuwählen und beim Erstellen der Aufgabe in der Aufgabenplanung die Option Mit höchster Priorität ausführen im Fenster Aufgabe erstellen auszuwählen.

Die für diese Aufgabe benötigte Zeit hängt stark von den Datenmengen ab, die sich durch Ihren Connector bewegen. Wenn die Aufgabe zu lange ausgeführt wird, sollten Sie die folgenden Dinge in der richtigen Reihenfolge berücksichtigen:

• Minimieren Sie das Datenvolumen, das in den Connector geht;
• Überprüfen Sie auf fehlerhafte Join-Bedingungen, die eine Datenduplizierung verursachen;

• Entfernen Sie alle nicht verwendeten Attribute im Connector (jedes zusätzliche Attribut im Connector erhöht die Laufzeit des Skripts).

  Wichtig: Es wird dringend empfohlen, die Aufgabe abzubrechen, nachdem sie mehr als 3 Tage lang ausgeführt wurde.

Format des Datasets

Die Datasets zur Verwendung mit Process Mining haben ein bestimmtes Format, das von einer Markierung abhängt. Diese Markierung wird im Stamm des Datasets gespeichert. Ein Beispiel finden Sie in der Abbildung unten.

Die Markierung ist nur eine leere Datei und wird nur für ihren Namen verwendet. Es gibt zwei verschiedene Markierungen: nomodcodes.marker und usemodcodes.marker .

usemodcodes.marker ist nur anwendbar, wenn Daten-Sharding verwendet wird, um den Bereich der Daten zu bestimmen.

Nomodcodes.marker

nomodcodes.marker verwendet die unten angezeigte Datenstruktur.

<DATASET NAME>\<ORGANIZATION CODE>\MVNCache

Nachfolgend finden Sie eine Beschreibung der Elemente von nomodcodes.marker.

Element	Beschreibung
<DATASET NAME>	Der Name, der im Superadmin angezeigt wird Registerkarte „Entwicklungsdaten “.
<ORGANIZATION CODE>	Der Standardwert ist: _org , was in 99 % der Fälle der Fall ist

Usemodcodes.marker

usemodcodes.marker verwendet die unten angezeigte Datenstruktur.

<DATASET NAME>\<ORGANIZATION CODE>\<MODULE CODE>\MVNCache

Nachfolgend finden Sie eine Beschreibung der Elemente von usemodcodes.marker.

Element	Beschreibung
<DATASET NAME>	Der Name, der im Superadmin angezeigt wird Registerkarte „Entwicklungsdaten “.
<ORGANIZATION CODE>	Der Standardwert ist: _org , was in 99 % der Fälle der Fall ist
<MODULE CODE>	Der Code, der in der Anwendung festgelegt ist. Siehe Module. Mit dieser Option können Sie mehrere Anwendungscodes in einer App verwenden.

Das in Schritt 1 bereitgestellte Skript gilt für nomodcodes.marker . Für usemodcodes.marker sollten Sie das folgende Skript verwenden.

set MAINDIR=%~dp0
set DATASET=FullData
set ENVIRONMENT=production
set WORKSPACE=Peter/Connector
mkdir "%MAINDIR%\datax\_datasets\%DATASET%"
mkdir "%MAINDIR%\datax\_datasets\%DATASET%\_org"
echo. > "%MAINDIR%\datax\_datasets\%DATASET%\usemodcodes.marker"
for %%M in (..) do (
              call "%MAINDIR%\builds\processgold.bat" -dataserver -workspace "%WORKSPACE%" "" -CCDB app="%%M" o= refreshmvncaches=true
              mkdir "%MAINDIR%\datax\_datasets\%DATASET%\_org\%%M\MVNCache" 
              call "%MAINDIR%\builds\processgold.bat" -dataserver -workspace "%WORKSPACE%" "" -export app="%%M" out="%MAINDIR%\datax\_datasets\%DATASET%\_org\%%M\MVNCache" o= refreshmvncaches=false reusecache=true onlymarked=true
)
call "%MAINDIR%\builds\processgold.bat" -dataserver -skipmail -env "%ENVIRONMENT%" -CCDB o=* dataset="%DATASET%" p=*