Using StudyUploader

Requirements and limitations

• The default number of files that can be simultaneously uploaded is set up to 5 in order to enhance the flow's performance. Furthermore, a speed metric is displayed on the Upload page to provide information about the uploaded files/minute.
• The selected directory must contain .zip files so the Uploader can access and manipulate the files. The application won't recognize and upload nested folders.
• The datasets you upload need to contain a minimum of 40,000 actions. Our recommendation is to upload data sets that contain 100K to 200K actions to get more optimal results.

Authenticating in the StudyUploader

1. Access the PC location where the StudyUploader.exe is saved. Run it.
   
   

   

   
   
2. The authentication pop up is displayed. Click the Sign In button to proceed.
   
   

   

   
   
3. Your system default web browser opens to complete the Cloud sign-in.

   If the browser does not open, copy/paste the URL displayed in the Uploader into your browser.

   
   

   

   
   
4. If your organization contains several tenants, select the tenant where Task Mining and AI Center services are enabled.
   
   

   

   
   
5. Select the Project you created in AI Center.
   
   

   

   
   
6. Select the following details related to your project:
   • the name of the project you created in the Task Mining instance;
   • the name of the project you created in AI Center;
   • the name of the Dataset created for the AI Center project.
7. Click Start upload.
   
   

   

   
   
8. Wait for the files to be transferred.
   
   

   

   
   
9. Once all the files are uploaded a confirmation message is displayed. Close the window.
   
   

   

   
   

Uploader configuration with JSON file

The JSON file contained in the ZIP along the StudyUploader executable contains its configuration and application data path to write logs.

In the JSON file you can find the default path to write application logs: %AppData%\\Task Mining Study Uploader

The Limits section sets the minimum and maximum threshold of how many files (user actions) should be uploaded in a single upload run.

The Uploading section sets how many files could be uploaded simultaneously (MaxParallelUploads), how many times a single file that has failed to upload will be attempted to be uploaded again (MaxFileUploadAttempts), and how many files could be skipped during the upload once they reach the MaxFileUploadAttempts before the uploader application would throw an error (FailedFilesThreshold).

You can modify the MaxParallelUploads parameter to control the network bandwidth used by the Uploader app. Lowering this number could improve the OS performance during the upload but will slow down the upload process. Increasing the number could speed up the upload when a fast network connection is available.

Note: Uploader application requires a minimum of 8 Mbps internet connection speed, >40 Mbps recommended.

Logs and troubleshooting

You can find details about the upload process in the application logs. After the first application execution, the logs are created in the AppData directory of the user who launched it:

C:\Users\{username}\AppData\Roaming\Task Mining Study Uploader or copy and paste the following path into the File Explorer: %AppData%\Task Mining Study Uploader

In case of any issues with the Uploader, share the logs folder content with the support team.

In the case of network and connectivity issues, you can cancel the upload or close the app to continue the upload later or retry it - files already uploaded to the selected dataset won't be uploaded repeatedly.