Accessing Your Vault's File Staging Server

Each Vault in your domain has its own file staging server, which supports various features including Vault Loader and Unclassified Document Creation. The file staging server is a temporary storage area for files you’re uploading to or extracting from Vault. For example, when using Vault Loader to create a new document, you upload the source file to the file staging server before loading the CSV file. The CSV then references the source file location on the file staging server.

The file staging server deletes files according to the following rules:

Refreshing your Vault removes all files from the file staging server.
The server automatically deletes uploaded files and empty directories after one year.
The server automatically deletes extracted files and folders every 72 hours by default. This auto-deletion timeframe does not apply to files that users upload to the file staging server.
Deleted files are not recoverable.

Server URL

The URL for each staging server is the same as the corresponding Vault, for example, veepharm.veevavault.com.

How to Access File Staging Servers

You can access your staging server using your Vault Loader, the Vault API, or Vault File Manager.

Vault Loader Details

You can view and manage files and folders on your Vault’s file staging server using the Vault Loader command line tool. Learn more in the Vault Loader File Staging Command Line Tool Reference.

Users do not need access to the staging server to access files on it with Vault Loader. For example, one user with file staging server access could upload files, and another user without access could create documents via Vault Loader that reference files on the staging server.

Vault File Manager Details

You can view, upload, move, rename, and delete files and folders on your Vault’s file staging server using Vault File Manager. Users with the Vault Owner or System Administrator security profile can view and access the root folders of all Vault users in the File Staging tab. Users with the File Staging: Access via Vault File Manager permission can view their root folder on the File Staging tab.

Legacy FTP Access

Veeva no longer recommends accessing the file staging server via FTP. The Developer Portal has information for any legacy implementations.

File Staging Server Limits

The following limits affect file uploads to the file staging server:

File names cannot exceed 218 bytes, including the file extension. Note that one character does not always equal one byte. For example, the character “菌” is three bytes.
Complete folder paths cannot exceed 955 bytes.
Folders cannot be renamed or moved.
Folder modification times reported in file listings are incorrect.
Listing large folders is slow.
- Structure large datasets into trees and remove old files when they are no longer required to achieve better performance.
Folder listings are truncated at 65,000 rows.
- Integrations dependent upon full folder listings should ensure that folders are kept below this value.

Your file staging server is a temporary storage solution and you should not retain files on the server for an entire year.

The automated deletion of all content after one year has the following effects on directories:

Directory objects in the underlying storage are deleted one year after creation.
Directories with contents will continue to appear until they are empty, at which point they will vanish.

Any integrations that anticipate the existence of a directory should catch the error when the directory does not exist and recreate the directory. Actively accessing content around the time of the automatic deletion can result in corrupted directory listings. This will normally clear after a refresh. If it persists, contact Veeva Support.

Inbox Details

You can create Staged documents by uploading files to the Inbox directory on your Vault’s file staging server. Staged is the name of the document type, lifecycle, and lifecycle state. Staged documents are unclassified. You and other users with access can classify these documents like any other unclassified document. However, Staged documents do not use the Unclassified lifecycle and may have different roles and access control settings.

The file staging server’s Inbox is automatically available in all Vaults. Before using this feature, Admins should:

Add default users for the Editor role within the Staged document lifecycle.
Modify the Editor role within the Staged document lifecycle to assign default users during document creation (using the Add Default Users When setting).
Optional: Edit the notification message templates used by this feature.

Message Templates

Cannot Upload LSA to Binder or Placeholder (ftp_inbox_attach_to_unsupported_document__v): Vault uses this error message when the target document for a rendition is a binder or placeholder.
Large Size Asset Attached (ftp_inbox_lsa_uploaded_to_exsting_doc__v): This notification goes to the user who uploaded a Large Size Asset rendition to an existing document.
Cannot Attach Viewable Rendition to Video (ftp_inbox_attach_viewable_rendition_to_video__v): Vault uses this error message when the target document for an uploaded Viewable Rendition file is a video.
Max File Size Exceeded (ftp_upload_too_large__v): Vault uses this error message when a file exceeds the size limits. It is not specific to the file staging server Inbox.
Missing Rendition Type (ftp_inbox_missing_rendition_type__v): Vault uses this error message when the uploading user does not specify a rendition type or specifies an invalid rendition type.
No Appropriate Permission (ftp_inbox_no_appropriate_rendition_permission__v): Vault uses this error message when the uploading user attempts to update a document on which they don’t have the required permissions.
Target Document Not Found (ftp_inbox_target_document_notFound__v): This error message occurs when the file name targets a Document ID that does not exist. In some cases, the ID is valid, but the user uploading does not have View Document access to the targeted document.

Staging Server Permissions

To download files from the staging server, you must have the standard Vault Owner or System Admin security profile or have a custom security profile that includes the File Staging: Access and API: Access API permissions.

The staging server does not support SAML SSO authentication.

To upload files to the root folder on the staging server, you must have the standard Vault Owner or System Admin security profile. Users with the File Staging: Access permission can upload files to a personal folder.

When referencing a file in a user’s personal folder on the staging server, you must include the user directory in the file path. For example, Clara is not a Vault Owner or System Admin. She can only upload files directly to Vault1234/u5678, where 1234 is her Vault ID and 5678 is her user ID. Note that Clara can still make new directories inside of her user directory, such as /u5678/uploads.

File Staging Linking

Admins can link a Vault’s File Staging server to a different Vault, without needing to rely on Veeva Support. You can use File Staging Linking during migrations where it’s common for users to link file staging rather than manually moving documents between different File Staging servers.

The File Staging Settings page allows Admins to view and modify File Staging Linking. To use File Staging Linking, you must have the standard Vault Owner or System Admin security profile. To manage the permissions for the File Staging Linking page, navigate to Admin > User & Groups > Permission Sets > [Permission Set] > Admin.

From the Admin page, navigate to Settings > File Staging Settings to edit the File Staging Settings for a Vault.

This page includes the following sections:

Vault Details provides information about the Vault that the Admin is currently in.
Vault shows the Vault’s name and ID.
File Staging used by indicates whether the Vault’s File Staging server is linked to another Vault. Each Vault can only have one file staging link, but multiple Vaults can point to a single file staging area.
Update File Staging allows Admins to link the current Vault to a different File Staging server.

Configuring File Staging Linking

To link a Vault’s File Staging server to a different Vault:

From the File Staging Settings menu, next to the Use File Staging from drop-down, click Edit.
The Use File Staging from drop-down shows the list of File Staging servers that are available to be linked to the Vault that the Admin is currently in. Select an available dropdown option, and click Save.
A dialog will appear warning the Admin that files in the File Staging server of the current Vault will no longer be accessible. Click Continue to confirm.

Upon confirmation, the Link Status changes from Active to Pending. A notification is available once the linking is complete, and the Link Status will change to Active. The amount of time that the link update takes is dependent on the number of files in the selected file staging server.

Note: File Staging Linking is unavailable during migrations. The Update File Staging section is hidden if the File Staging for the Vault that the Admin is currently in is in use by another Vault. To resolve this issue, Admins must remove the linking between the other Vault, and the file staging server of the Vault that the Admin is currently in.

Troubleshooting Error Messages

Error Message	Troubleshooting Step
File Staging linking for this Vault could not be completed successfully due to: A stale browser tab allowed an invalid selection. Please refresh Vault Settings tabs and try again.	This error occurred because a stale tab allowed an invalid selection. Refresh the Vault Settings tab and update the linking again.
File Staging linking for this Vault could not be completed successfully due to: Files are currently being transferred to long term storage. Users should wait several minutes and try again.	This error occurred because files in the Vault’s existing File Staging are currently being transferred over to the Vault. All files need to be transferred over before the File Staging link can be updated.
File Staging linking for this Vault could not be completed successfully due to: A server error.	Contact Veeva Support.

You can complete all steps in this article with the standard System Administrator or Vault Owner security profile. If your Vault uses custom security profiles, your profile must grant the following permissions:

Type	Permission Label	Controls
Security Profile	API: Access API	Ability to access your Vault’s file staging server and download files via the API.
Security Profile	Application: File Staging: Access	Ability to access your Vault’s file staging server and upload documents to a personal folder via the API.
Security Profile	Application: File Staging: Access via Vault File Manager	Ability to access your Vault’s file staging server in Vault File Manager.