Use the command line arguments and parameters in this reference to manage your Vault’s file staging server. This article lists actions and parameters available in the Vault Loader file staging command line tool. For information on getting started with the Vault Loader command line tool, including installation and authentication, see Using the Vault Loader Command Line Tool. For information on using the Vault Loader command line tool to to load data to your Vault or extract data from your Vault in bulk, see the Vault Loader Command Line Tool Reference.
File Staging Basics
When managing your Vault’s file staging server:
- To view the root folder on the staging server, you must have the standard Vault Owner or System Admin security profile. Non-Admin users with a security profile that grants the Application: File Staging: Access permission can view and manage items in a personal folder.
- When outputting a list of items on the staging server, Vault places the CSV output file in the same directory as your VaultDataLoader.jar file.
- When uploading items, place files in the same directory as your VaultDataLoader.jar file.
List Items
List files and folders on your Vault’s file staging server. You can specify the path to the folder to begin the listing. If omitted, the listing begins at the root (for Admin users) or user folder (for non-Admin users). If results are not output to a CSV file, Vault displays up to 25 items at a time. Press the spacebar followed by enter to see the next 25 items. This pagination option expires after 20 minutes.
Action | Parameters | Example |
-ls [PATH] |
-R -l -output [FILENAME] -outputoverwrite [FILENAME] |
java -jar VaultDataLoader.jar -ls u123456/cholecap_files -R -l -output cholecap_files.csv |
java -jar VaultDataLoader.jar -ls -outputoverwrite cholecap_files.csv |
Create a Folder
Create one or more folders at a given path on your Vault’s file staging server.
Action | Parameters | Example |
-mkdir [PATH] |
java -jar VaultDataLoader.jar -mkdir Folder1 /u123456/Folder2 |
Upload a File or Folder
Upload files or folders to the File Staging Server.
Action |
Parameters |
Example |
-put [ITEM] |
-parent [FOLDER] -overwrite -R -concurrent [NUMBER] -output [FILENAME] -outputoverwrite [FILENAME] |
java -jar VaultDataLoader.jar -put cholecap_files -parent u123456/Cholecap_folder -R -concurrent 5 -output cholecap_files_upload_progress.csv |
java -jar VaultDataLoader.jar -put nyaxa_files -parent u123456/Nyaxa_folder -outputoverwrite nyaxa_files_upload_progress.csv |
Download Files or Folders
Download one or more files or folders from the staging server.
Action |
Parameters |
Example |
-get [ITEM] |
-downloadpath [PATH] -overwrite -R -concurrent -output -outputoverwrite |
java -jar VaultDataLoader.jar -get cholecap_files -downloadpath Desktop/Cholecap_folder -R -concurrent 5 -output cholecap_files_download_progress.csv |
java -jar VaultDataLoader.jar -get nyaxa_files -outputoverwrite nyaxa_files_download_progress.csv |
Rename a File or Folder
Change the name of an existing file or folder.
Action |
Parameters |
Example |
-rename [ITEM] [NEWITEM] |
java -jar VaultDataLoader.jar -rename holecap_files cholecap_files |
Move a File or Folder
Move an existing file or folder.
Action |
Parameters |
Example |
-move [ITEM] [PATH] |
-overwrite |
java -jar VaultDataLoader.jar -move nyaxa_files/cholecap.pdf cholecap_files
-overwrite |
Delete a File or Folder
Delete one or more files or folders at a given path on your Vault’s file staging server. Use the -R parameter on a specified folder to remove all of its contents recursively, including files and subfolders.
Action | Parameters | Example |
-rm [PATH] |
-R |
java -jar VaultDataLoader.jar -rm /u123456/cholecap.docx /nyaxa.txt |
java -jar VaultDataLoader.jar -rm /folder1 /folder2/subfolder3 -R |
File Staging Parameters
Parameter | Description |
-R |
Use this flag to apply an action to all files and subfolders in a folder. |
-l |
Use this flag with the List Items action to return results in long format, including kind, name, path, size (for files only), and modified date (for files only). If omitted, the default is short format. |
-output [FILENAME] |
Use this flag to output results to a csv file with a specified name. Once generated, Vault places this file in the same directory as your VaultDataLoader.jar file. |
-outputoverwrite [FILENAME] |
Use this flag to overwrite an existing output file. |
-parent | When using the Upload a File or Folder action, this flag is required and specifies the path to the parent directory to place the uploaded files or folders. |
-concurrent | Use this flag with the Upload a File or Folder or Download Files or Folders action to specify the number of concurrent uploads or downloads, which can be between 1 and 10. |
-downloadpath | Use this flag with the Download Files or Folders action to specify the path to the folder in which to place the download. If omitted, Vault places the files in the "filedownloads" subfolder of the directory containing your VaultDataLoader.jar file. |
-overwrite | Use this flag with the Move a File or Folder action to overwrite an existing item with the same name. If omitted, the default is not to overwrite. |