Move to folder path

You can use the move to folder path mass operation to move documents to a new folder that you specify in a text field on the document object. Relativity automatically creates the new folder when you run this mass operation. You can also specify a default folder that Relativity uses when the destination folder path isn't set on a document. You must install the Document Utilities application to add the Move to folder path mass operation to your workspace. The Document Utilities application also contains the Document Unitization solution. For more information, see Document Unitization.

A sample use case for this mass operation involves updating the folder path for documents loaded into the wrong folder on a workspace. For example, you may have inadvertently selected file path as the folder path when importing documents through the Relativity Desktop Client (RDC).

In addition, the move to folder path mass operation provides you with the ability to move multiple documents to different folders simultaneously. Unlike the mass move operation, where you can only select a single folder when moving documents. For more information, see Mass move.

This page contains the following information:

Prerequisites for the move to folder path mass operation

You must complete the following prerequisites before you can use the move to folder path mass operation:

Installing the Document Utilities application

Setting required security permissions

Running the move to folder path mass operation

When you run the move to folder mass operation, Relativity moves all the documents with the same destination folder in a single batch. While the Move to folder path mass operation batches documents moving to the same folder, the MassCustomBatchAmount and the MassMoveBatchAmount instance settings control the batching process. The MassCustomBatchAmount instance setting controls the number of documents per batch for each unique destination folder. The MassMoveBatchAmount value controls the number of documents for each batch size.

For optimum performance, use these guidelines when running this mass operation:

  • Perform a test on a small sample set of documents before moving a large number of them.
  • Execute only one move to folder path mass operation at a time.

Use these steps to move documents to a new folder:

  1. Navigate to the Documents tab in your workspace.
  2. Select the documents that you want to move to the destination folder path.
  3. In the first drop-down menu in the mass operations bar, choose Checked or All based on your selections from the current document set.
  4. Select Move to folder path in the second drop-down menu, and then click Go.
  5. Complete the fields in the Folder path settings dialog. See Fields for move to folder path mass operation.
  6. Click OK to run the mass operation. Relativity creates any destination folders that don't currently exist, and moves the documents to their specified destination folders. It also moves any documents with an empty folder path field to the location specified in the Empty folder path placeholder field. See Fields for move to folder path mass operation.

    Note: To stop the mass operation, click Cancel. The mass operation finishes moving the current batch of documents before it stops. Relativity then displays a message indicating the percent of documents that were moved.

  7. Optionally, refresh the page to see the newly created folders. See the following screen shot for an example of a new folder structure:

    new folder structure created by Move to folder path operation

Fields for move to folder path mass operation

The Folder path settings dialog includes the following fields:

Move to folder path dialog

  • Folder Path Field - click ellipsis button to select the field that you populated with the destination folder path. See Move to folder path.
  • Delimiter - select forward slash (/) or back slash (\) as the delimiter for any nested folders.
  • Move documents with empty folder path - select this checkbox if you want to move documents with empty folder path fields to the location specified in the Empty folder path placeholder option. If you don't select this checkbox, Relativity doesn't move documents with empty folder path fields.
  • Empty folder path placeholder - enter the name of a folder where you want to move documents that don't have a destination specified in their folder path field. If the path contains subfolders, separate the folders with the same delimiter as you selected in the Delimiter field. This folder path may include Unicode characters.

    The following list describes how Relativity handles empty folders:

    • If a folder path contains one or more empty folders, then Relativity replaces the blank location with the name in the Empty folder path placeholder field. For example, it updates the folder path MyFolder\\MySubfolder to MyFolder\[BLANK]\MySubfolder, if the name in this field is [BLANK].

      example of blank folder in a folder path

    • If a folder path contains consecutive empty directories, Relativity consolidates them into a single directory, so that MyFolder\\ \\\MySubfolder becomes MyFolder\[BLANK]\MySubfolder when the name in this field is [BLANK].
    • If a folder path contains two consecutive delimiters separated by a space, Relativity sets the name of the newly created folder to blank.
  • Delete empty folders - select this checkbox if you want to delete any folders that are empty after you move the documents. Relativity doesn't delete empty folders when they have dependencies.

    Note: If an error occurs during the deletion of empty folders, Relativity stops this process and displays an error message. It also logs any errors on the Error tab. For more information, see Errors.