There are two options for uploading files to the workspace: using the workspace web interface or using an application programming interface (API).
It is also possible to create files within the workspace instead of uploading pre-existing files. For more information, refer to the Accessing Tools From Within Your Workspace article. For information about using the build-in editor to create files in a workspace, visit the Aridhia Knowledge Base.
To learn more about file types, sizes, and other best practices for uploading, first read the Know Before You Upload article.
Upload Files Using the Web Interface
Users can upload files of various types up to 250 GB in the workspace using the web interface. For files that are larger than 250GB and less than 1TB, use the API method with AZ Copy seen in the bottom section of this article.
- Navigate to the Files dropdown menu in the Workspace.
- Select Upload File.
3. Drag and drop your files into the Upload File panel or browse and select the file to upload.
- You can change the upload destination folder within your workspace by using the link at the bottom left of the screen. Alternatively, you can upload your files to your workspace Inbox where they can then be filed later.
- Before uploading, confirm that your data has no personally identifiable information (PII) by clicking the checkbox.
- Click the Upload button, and your files will be uploaded into the selected folder or sent to the Inbox, depending on the destination you previously selected.
Upload Files Via an Application Programming Interface (API)
As well as uploading files via the user interface, it is also possible to do so using an API.
There are a few reasons you may wish to do this. Firstly, API tokens allow people who are not workspace members to upload to the workspace. Secondly, the use of the API allows users to upload data programmatically. For example, perhaps you have a regular stream of data coming into your study and you want it to be automatically pushed on to your workspace.
To use the API interface, a user first generates an API token, which is like a password that is used to authenticate your request to upload files to a workspace. This ensures that only valid and secure uploads are permitted within the workspace.
1. Generate an Upload Token
First, go to the Upload dropdown menu and select Manage upload tokens. This will take you to a new tab showing existing tokens and a form to generate new ones.
Provide a reason for the token generation and select the validity period for your new token – the default is set to the maximum (30 days).
If you tick the 'Upload data to database' checkbox, uploaded CSV files and associated metadata will be used to create a dataset. If you do not check it, the files will be uploaded to your workspace Inbox.
Your new token will be listed as the first entry in the table. Use the Copy button to copy your token to your clipboard.
Be aware that once you close the tab you will not be able to copy the token anymore. Save the copied token if you wish to use it again.
2. Download AzCopy
To use the API, you will need to download AzCopy to your computer. You can add the AzCopy directory to your path, which allows you to use AzCopy from any directory on your system.
If you choose not to add the AzCopy directory to your path, you'll have to first navigate to the location of your AzCopy executable before using it in the command line.
3. Upload Your Files
To run AzCopy on your own machine, if you did not add it to your path, first navigate to the location where you have installed AzCopy and run the following command:
azcopy copy "/path/to/your/file" "token"
If you want to recursively copy data from a local directory, add the --recursive=true flag at the end.
Depending on whether you checked the 'Upload data to database' box, the files uploaded through an API will be found either in the Database tab or in the Inbox.
For assistance uploading large files or any other difficulty, please contact support@alzheimersdata.org.