Chargement de données à l'aide de DataUploader

Avec DataUploader , vous pouvez charger des fichiers de données jusqu'à 5 To chacun directement dans une application de processus Process Mining . Le chargement de données à l'aide de DataUploader est plus stable que le chargement de données à l'aide de l'option Télécharger des données ( Upload data ) dans Process Mining, également pour les fichiers de données plus petits. Si le téléchargement à l'aide de DataUploader échoue, par exemple en raison d'une connexion instable, DataUploader réessaiera le téléchargement jusqu'à 4 fois.

Remarque :

Veillez toujours à ce que les données soient au format requis pour le modèle d'application utilisé pour l'application de processus. Reportez-vous aux Modèles d'applications.

Paramètres

Vous trouverez ci-dessous un aperçu des paramètres de DataUploader.

Paramètre	Format	Description	Obligatoire O/N	Exemple
-c --csv-dir	<csv dir value>	Le répertoire contenant les fichiers CSV à télécharger. Remarque : Il peut également s’agir d’un chemin relatif.	Y	Données C:\P2P
-s --sas-url	<sas url value>	L'URL SAS de la signature d'accès partagé pour le conteneur Azure Blob Storage où les fichiers doivent être chargés. Voir Récupération des informations d'identification pour le stockage d'objets blob Azure	Y
-e --end-of-upload-api	<value>	URL de l'API de fin de téléchargement qui sera appelée lorsque les fichiers ont été téléchargés avec succès. Voir Récupération des informations d'identification pour le stockage d'objets blob Azure	Y
-d --delimiter	<delimiter value>	Le code ASII du délimiteur utilisé dans les fichiers d'entrée. Remarque : Il doit s'agir d'une valeur ASCII comprise entre 0 et 127. La valeur par défaut est 9 (Tab).	N	44 (= virgule) 9 (= Tab)
-p --proxy	<proxy value>	L'URL du proxy	N
-u --proxy-username	<proxy username>	Nom d'utilisateur si l'authentification est nécessaire pour se connecter au serveur proxy.	N
-P --proxy-password	<proxy password>	Le mot de passe si l'authentification est nécessaire pour se connecter au serveur proxy.	N
-r --recursive		Recherche tous les fichiers dans le dossier donné, y compris les sous-dossiers. Attention : Si des fichiers portant des noms dupliqués sont présents dans différents dossiers, le comportement peut être imprévisible. Remarque : Par défaut, seuls les fichiers du dossier donné sont téléchargés et les sous-dossiers sont ignorés.
-f --config-file	<config file value>	Vous permet d'utiliser un fichier de configuration au lieu de paramètres intégrés. Attention : Les paramètres alignés remplacent les valeurs du fichier de configuration.
-h		Vous permet d'afficher l'aide pour une commande DataUploader .

Téléchargement de DataUploader

Utilisez le lien suivant pour télécharger DataUploader : https://download.uipath.com/ProcessMining/versions/2.0.3/DataUploader/process-mining-data-uploader.exe

Chargement de données à l'aide 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"

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 tentera de le télécharger jusqu'à 4 fois. Si le téléchargement des données n'a pas réussi après 5 téléchargements, 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 une erreur telle que UNABLE_TO_GET_ISSUER_CERT_LOCALLY.

Ce problème peut être résolu en pointant DataUploader sur 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 télé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 :

Sous 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 une chaîne de certificats valide.

1. Accédez au Portail Process Mining et, dans l'onglet Applications de processus ( Process apps ), 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 (View site information ) à gauche dans la barre d'adresse.

   
   

   

   
   

3. Sélectionnez La connexion est sécurisée (Connection is secure), puis sélectionnez Le certificat est valide (Certificate is valid) pour afficher le certificat.

   
   

   

   
   

4. Accédez à l'onglet Détails (Details) et développez la Hiérarchie de certificat (Certificate Hierarchy).

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

   
   

   

   
   

6. Sélectionnez un emplacement pour enregistrer le fichier de certificat sur votre ordinateur et assurez-vous de l'enregistrer en tant que type 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_ExTra_CA_CERTS et définissez la valeur de cette variable sur le chemin complet du fichier du certificat sélectionné à l'étape 6 (y compris le chemin du dossier, le nom et l'extension du fichier)

   1. Ouvrez les Propriétés système de Windows.

   2. Accédez à l'onglet Avancé.

   3. Sélectionnez Variables d'environnement (Environment Variables).

   4. Sélectionnez Nouveau (New ) 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.