Exécution de DataUploader

Suivez ces étapes pour charger des données à l'aide de DataUploader.

1. Téléchargez le Téléchargeur de données.
2. Créez un dossier et copiez les fichiers d'entrée que vous souhaitez télécharger à l'aide de DataUploader dans ce dossier.
3. Ouvrez un Windows Powershell.
4. Accédez à l'emplacement où vous avez téléchargé DataUploader.
5. Exécutez l'une des commandes suivantes :
   Important :

   Mettez chaque valeur de paramètre entre guillemets.

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"

Une barre de progression s’affiche pour chaque téléchargement de fichier.

Exemple de chaîne de commande

./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"

Extraction incrémentielle

Suivez ces étapes pour exécuter DataUploader avec une synchronisation incrémentielle.

1. Ouvrez un Windows Powershell et accédez à l'emplacement où vous avez téléchargé DataUploader.
2. Assurez-vous que tous les fichiers d’entrée suivent le format de nommage requis. Voir Nom du fichier pour la synchronisation incrémentielle.
3. Exécutez DataUploader avec le paramètre --tables . Le code suivant affiche un exemple de commande.

   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"}]'
   

   Important :

   Mettez chaque valeur de paramètre entre guillemets.

Remarque :

Après chaque exécution, DataUploader enregistre le statut de synchronisation dans un fichier situé dans le même dossier que l'exécutable.

Remarque :

Les fichiers dont le préfixe ne correspond à aucune entrée dans le paramètre --tables sont ignorés. Lorsque --tables n'est pas fourni, tous les fichiers du dossier sont téléchargés.

Affectation de noms de fichier pour la synchronisation incrémentielle

Tous les fichiers destinés à une ingestion incrémentielle doivent suivre ce format de nommage:

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

Exemple :

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

Partie	Description
<table-prefix>	Doit correspondre à un préfixe défini dans le paramètre --tables . Ne doit pas contenir de traits de soulignement.
<any text>	Tout texte descriptif. Non utilisé par DataUploader.
<yyyymmdd>T<HHMMSS>	Horodatage de l'extraction des données de la source. T sépare la date et l'heure.
<extension>	N'importe quelle extension de fichier.

Résolution des problèmes

Taille maximale du fichier

La taille maximale du fichier (par fichier) est de 5 To.

NombreNouvellesTentatives

Si le téléchargement échoue, par exemple en raison d’une connexion instable, DataUploader réessaiera le téléchargement jusqu’à 4 fois. Si le chargement des données n'a pas réussi après 5 fois, un rapport est créé.

Avertissement :

Dans certaines configurations réseau, DataUploader ne parvient pas à atteindre l'API de fin de téléchargement en raison d'un certificat auto-signé, et vous obtiendrez l'erreur telle que UNABLE_TO_GET_ISSUER_CERT_LOCALLY. Ce problème peut être résolu en pointant DataUploader vers le certificat de l'autorité de certification (CA) de votre organisation. Suivez ces étapes.

1. Créez une variable d'environnement appelée NoDE_EXTRA_CA_CERTS.
2. Définissez la valeur de la nouvelle variable d'environnement sur le chemin d'accès au fichier de votre certificat CA.

Si le chargement de certains fichiers a échoué, vous pouvez redémarrer DataUploader à l'aide de la même commande et avec les mêmes fichiers.

Appel de fin de l'API de téléchargement

Que se passe-t-il si mes fichiers sont téléchargés mais que le point de terminaison de fin de téléchargement n’est pas appelé ?

Parfois, il peut arriver que l'option Fin de l'API de téléchargement (End of upload API) ne soit pas appelée avec succès, même après que tous les fichiers ont été téléchargés. Si le journal suivant ne s'affiche pas après le téléchargement des fichiers à partir du téléchargeur de données, cela signifie que la fin de l'API de téléchargement n'a pas été appelée avec succès :

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

Dans ce cas, vous pouvez copier et exécuter le code suivant dans une session PowerShell pour appeler la fin de l'API de téléchargement.

$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

Certificats

Avertissement :

Dans certaines configurations réseau, DataUploader ne parvient pas à atteindre l'API de fin de téléchargement en raison d'un certificat auto-signé, et vous obtiendrez une erreur telle que UNABLE_TO_GET_ISSUER_CERT_LOCALLY. Vous pouvez résoudre ce problème en fournissant à DataUploader la chaîne de certificats valide.

Suivez ces étapes pour fournir DataUploader avec la chaîne de certificats valide.

1. Accédez au portail Process Mining et à partir de l'onglet Applications de processus , ouvrez l'application de processus.

2. Accédez à la barre d'adresse dans le navigateur Web et sélectionnez l'icône Afficher les informations du site à gauche dans la barre d'adresse.

   

3. Sélectionnez La connexion est sécurisée, puis sélectionnez Le certificat est valide pour afficher le certificat.

   

4. Accédez à l'onglet Détails et développez la Hiérarchie du certificat.

5. Sélectionnez l'entrée cloud.uipath.com et sélectionnez Exporter....

   

6. Sélectionnez un emplacement pour enregistrer le fichier de certificat sur votre ordinateur et assurez-vous de l'enregistrer sous le nom ASCII encodé en Base64, chaîne de certificats (*.pem;*crt).

   Le fichier cloud.uipath.crt s'affiche à l'emplacement sélectionné.

7. Créez une variable d'environnement NODE_EXRA_CA_CERTS et définissez la valeur de cette variable sur le chemin d'accès complet au fichier du certificat sélectionné à l'étape 6

   1. Ouvrez les Propriétés système de Windows.
   2. Go to the Advanced tab.
   3. Sélectionnez Variables d'environnement.
   4. Sélectionnez Nouveau pour ajouter une nouvelle variable système.

8. Lancez une nouvelle session PowerShell pour vous assurer que la variable d'environnement est reconnue par DataUploader.