

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 Agent solution determines whether any document files are missing from a file server. The solution performs the following tasks:
The File Validation Agent 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 Agent search string. You must be logged in to the Community for that string to return results.
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:
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:
Log in to the Community and click this File Validation Agent search string.
Select the version that is compatible with your Relativity instance.
Note: The solutions in the Relativity Applications folder are sorted from most recently modified to oldest. As a result, solutions at the top of the page are normally the newest versions of the respective solutions. If you see more than one version of the solution, select the .rap file with the higher version number to ensure you're deploying the most up-to-date solution.
Click Download.
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. By default, you can only run the File Validation job once for a workspace. 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:
The job status changes to Waiting. When the File Validation Manager agent begins running the job, its status changes to In Progress. The agent runs the jobs based on the order used to submit them.
After the job is complete, its status changes to New. The Messages section displays the date and time when the job completed.
To cancel a File Validation job after submitting it, click Cancel in the console. The job stops after the agent 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 agent 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 agent sets the missing file indicator field Yes. If all of a document’s files exist on the file server, the agent 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 agent 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 agent 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!