Ausführen von DataUploader

Führen Sie die folgenden Schritte aus, um Daten mit DataUploader zu laden.

1. Laden Sie den DataUploader herunter.
2. Erstellen Sie einen Ordner und kopieren Sie die Eingabedateien, die Sie mit DataUploader in diesen Ordner hochladen möchten.
3. Öffnen Sie eine Windows Powershell.
4. Navigieren Sie zu dem Speicherort, an den Sie den DataUploader heruntergeladen haben.
5. Führen Sie einen der folgenden Befehle aus:
   Wichtig:

   Schließen Sie jeden Parameterwert in Anführungszeichen ein.

process-mining-data-uploader.exe "<csv dir>" "<sas url>" "<end-of-upload api>"

process-mining-data-uploader.exe -c "<myfolder>" -s "<my-sas-uri>" -e "<my-end-of-upload-api>"

process-mining-data-uploader.exe --config-file "path\to\config\file"

Für jeden Dateiupload wird ein Fortschrittsbalken angezeigt.

Beispiel für eine Befehlszeichenfolge

./process-mining-data-uploader.exe "data" "https://asdf.blob.core.windows.net/a28d10b0-6822-4xxy-a197-02zz39824ad4?sv=2020-06-12&si=sap-a58d10b0-6822-4ffc-a197-02ed649824ad4&sr=c&sig=WELk3bW8zpY5rL71lJ8pPPhlOq0odLNoQleY%2BL3nPqek%3D" "https://asdf.uipath.com/org/tenant/processmining_/api/v4.0/apps/a28d10b0-6822-4ffc-a197-02ed39824ad4/ingest/authenticated?AppSecretToken=A5B221CD00E77F02677G36H572IJKLM61N2440320O44666PQ4RS3T0U81410VW" "44"

Inkrementelle Extraktion

Führen Sie diese Schritte aus, um den Datenuploader mit inkrementeller Synchronisierung auszuführen.

1. Öffnen Sie eine Windows Powershell und navigieren Sie zu dem Speicherort, an den Sie den DataUploader heruntergeladen haben.
2. Stellen Sie sicher, dass alle Eingabedateien dem erforderlichen Namensformat folgen. Siehe Dateibenennung für die inkrementelle Synchronisierung.
3. Führen Sie den DataUploader mit dem Parameter --tables aus. Der folgende Code zeigt einen Beispielbefehl.

   process-mining-data-uploader.exe -c "<csv dir>" -s "<sas url>" -e "<end-of-upload api>" --tables '[{"prefix": "pfx01", "name": "Table01", "load-type": "incremental"}, {"prefix": "pfx02", "name": "Table02", "load-type": "full"}]'
   

   Wichtig:

   Schließen Sie jeden Parameterwert in Anführungszeichen ein.

Hinweis:

Nach jeder Ausführung speichert DataUploader den Synchronisierungsstatus in einer Datei im selben Ordner wie die ausführbare Datei.

Hinweis:

Dateien, deren Präfix mit keinem Eintrag im Parameter --tables übereinstimmt, werden ignoriert. Wenn --tables nicht angegeben ist, werden alle Dateien im Ordner hochgeladen.

Dateibenennung für die inkrementelle Synchronisierung

Alle Dateien, die für die inkrementelle Erfassung vorgesehen sind, müssen diesem Namensformat folgen:

<table-prefix>_<any text>_<yyyymmdd>T<HHMMSS>.<extension>

Beispiel:

pfx01_filename-part-not-read-by-data-uploader_20240221T142100.csv

Teil	Beschreibung
<table-prefix>	Muss mit einem im Parameter --tables definierten Präfix übereinstimmen. Darf keine Unterstriche enthalten.
<any text>	Beliebiger beschreibender Text. Nicht von DataUploader verwendet.
<yyyymmdd>T<HHMMSS>	Zeitstempel der Datenextraktion aus der Quelle. T trennt Datum und Uhrzeit.
<extension>	Eine beliebige Dateierweiterung.

Fehlersuche und ‑behebung

Maximale Dateigröße

Die maximale Dateigröße (pro Datei) beträgt 5 TB.

AnzahlDerWiederholungen

Wenn der Upload fehlschlägt, z. B. aufgrund einer instabilen Verbindung, wiederholt DataUploader den Upload bis zu vier Mal. Wenn der Datenupload nach 5 Mal nicht erfolgreich war, wird ein Bericht erstellt.

Warnung:

Unter bestimmten Netzwerkkonfigurationen kann DataUploader aufgrund eines selbstsignierten Zertifikats die API für das Ende des Uploads nicht erreichen und Sie erhalten einen Fehler wie UNABLE_TO_GET_ISSUER_CERT_LOCALLY. Dies kann behoben werden, indem Sie DataUploader auf das Zertifikat der Zertifizierungsstelle Ihrer Organisation verweisen. Führen Sie die folgenden Schritte aus.

1. Erstellen Sie eine Umgebungsvariable mit dem Namen NODE_EXTRA_CA_certs.
2. Legen Sie den Wert der neuen Umgebungsvariablen auf den Dateipfad Ihres Zertifizierungsstellenzertifikats fest.

Falls bei einigen Dateien der Upload fehlgeschlagen ist, können Sie den DataUploader mit demselben Befehl und mit denselben Dateien neu starten.

Aufrufen der API für das Ende des Uploads

Was passiert, wenn meine Dateien hochgeladen werden, der Endpunkt für das Ende des Uploads jedoch nicht aufgerufen wird?

Gelegentlich kann es vorkommen, dass die API für das Ende des Uploads nicht erfolgreich aufgerufen wird, auch nachdem alle Dateien hochgeladen wurden. Wenn Sie das folgende Protokoll nach dem Hochladen von Dateien mit dem Datenuploader nicht sehen, bedeutet dies, dass die API für das Ende des Uploads nicht erfolgreich aufgerufen wurde:

End-of-upload API reached successfully, data transformation started.

In diesem Fall können Sie den folgenden Code in einer PowerShell-Sitzung kopieren und ausführen, um die API für das Ende des Uploads aufzurufen.

$endOfUploadUri = "*******"
$delimiter = 9 # you can change this to the ascii of the character of your choice
$fullUri = "$endOfUploadUri&dataLoadOptionsJson=%7B%22UseSampleData%22%3Afalse%2C%22FileFormatOptions%22%3A%7B%22FieldDelimiter%22%3A%22$delimiter%22%7D%7D"
$response = Invoke-WebRequest -Uri $fullUri -Method POST
Write-Output $response.StatusCode

Zertifikat

Warnung:

Unter bestimmten Netzwerkkonfigurationen kann DataUploader aufgrund eines selbstsignierten Zertifikats die API für das Ende des Uploads nicht erreichen und Sie erhalten eine Fehlermeldung wie UNABLE_TO_GET_ISSUER_CERT_LOCALLY. Sie können dies beheben, indem Sie DataUploader die gültige Zertifikatkette zur Verfügung stellen.

Führen Sie die folgenden Schritte aus, um DataUploader mit der gültigen Zertifikatkette bereitzustellen.

1. Wechseln Sie zum Process Mining-Portal und öffnen Sie die Prozess-App auf der Registerkarte Prozess-Apps .

2. Navigieren Sie im Webbrowser zur Adressleiste und wählen Sie das Symbol Siteinformationen anzeigen links in der Adressleiste aus.

   

3. Wählen Sie Verbindung ist sicher aus und wählen Sie dann Zertifikat ist gültig aus, um das Zertifikat anzuzeigen.

   

4. Wechseln Sie zur Registerkarte Details und erweitern Sie die Zertifikatshierarchie.

5. Wählen Sie den Eintrag cloud.uipath.com und dann Exportieren... aus.

   

6. Wählen Sie einen Speicherort aus, um die Zertifikatsdatei auf Ihrem Computer zu speichern, und stellen Sie sicher, dass Sie sie als Base64-codiertes ASCII, Zertifikatkette (*.pem;*crt) speichern.

   Die cloud.uipath.crt -Datei wird am ausgewählten Speicherort angezeigt.

7. Erstellen Sie eine Umgebungsvariable NODE_EXTRA_CA_certs und legen Sie den Wert dieser Variablen auf den vollständigen Dateipfad des in Schritt 6 ausgewählten Zertifikats fest ( einschließlich des Ordnerpfads, des Dateinamens und der Dateierweiterung)

   1. Öffnen Sie die Windows-Systemeigenschaften.
   2. Go to the Advanced tab.
   3. Wählen Sie Umgebungsvariablen aus.
   4. Wählen Sie Neu aus, um eine neue Systemvariable hinzuzufügen.

8. Starten Sie eine neue PowerShell-Sitzung, um sicherzustellen, dass die Umgebungsvariable vom DataUploader erkannt wird.