

Note: You must have valid Relativity Community credentials in order to download any Community file linked to the documentation site. You'll need to enter those credentials on the Community login screen if you're not already logged in. If you're already logged in to the Community at the time you click a link, the file is automatically downloaded in the bottom left corner of your screen. If you get an error message stating "URL No Longer Exists" after clicking a Community link, it may be due to a single sign-on error related to the SAML Assertion Validator, and you should contact your IT department.
The File Validation application solution determines whether any document files are missing from a file server. The solution performs the following tasks:
The File Validation application solution determines whether the files associated with documents in a workspace are missing. It searches for those files on a file server. It sets the value of a Yes/No field called the missing files indicator field. The value in this field indicates whether the files were found. Finally, the solution generates a report with detailed information about each missing file.
The solution validates document files in batches of 1,000. It validates only those documents where the value of the missing files indicator field is Null. You can use this report to determine which files to restore on the file server.
This solution is supported in the following versions, as well as previous versions that no longer receive technical support:
You can find all versions of this solution on the Community via this File Validation application search string. You must be logged in to the Community for that string to return results.
Note: Some versions of this application may not be eligible for support by Customer Support. For more information, see the Version support policy.
This solution consists of the following components:
To use this solution, the Relativity Services API must be configured on your web and agent servers.
Review the following considerations for this solution before running it:
The following permissions are required to run the File Validation application.
Object security | Tab visibility |
---|---|
File Validation Job - View, Edit, Delete |
File Validation Job - Job tab |
To deploy and configure the solution, download it from Relativity Community and add it to the Application Library as a Relativity application. These agents monitor and perform the file validation tasks.
Complete the following steps to download the solution:
Complete the following steps to add the solution to the Application Library:
After deploying the solution, you can install and configure it in a workspace by completing these tasks:
Complete these steps to install the application:
Complete these steps to create the missing files indicator field:
You can run the solution by creating and executing a File Validation job for the workspace.
Note: Only one File Validation job can be created for a single workspace at any point in time.
It validates files only for documents where the missing files indicator field is Null. The solution skips documents where the missing files indicator field is Yes or No. When running the solution a subsequent time, complete one of these tasks before each run:
Complete these steps to create and run a File Validation job:
To cancel a File Validation job after submitting it, click Cancel in the console. The job stops after the manager finishes validating the current set of document files. The job status changes to New. Additionally, the Messages section displays the date and time when the job was canceled.
While executing a job, the File Validation Worker validates document files in batches of 1,000. It validates files only for those documents where the missing files indicator field is Null. If a document’s files don't exist on the file server, the worker sets the missing file indicator field Yes. If all of a document’s files exist on the file server, the worker sets the missing file indicator field to No. You refer to the values in the missing file indicator field to determine which documents are missing files.
In addition to populating the missing files indicator field, a File Validation job generates a missing files report. The report contains a detailed list of files that weren't found on the file server. When you subsequently run a File Validation job, the worker clears and repopulates the missing files report with the results from that run.
Complete the following steps to view the missing files report:
The following table describes the columns in the report.
Column | Description |
---|---|
File Validated On | The date and time when the worker validated the document files. |
Document Identifier | The identifier of the document with one or more missing files. |
Document Identifier ID | The artifact ID of the document with one or more missing files. |
File Path | The path to the file that is missing from the file server. |
File Type | The type of file that is missing from the file server. For example, the file types include Native, Image, Production Image, or Transcript. |
If errors occur after you submit a File Validation job, its status changes to Error. The Messages section displays the errors that occurred. To rerun the job, click Retry/Resolve Errors in the console.
Why was this not helpful?
Check one that applies.
Thank you for your feedback.
Want to tell us more?
Great!