Copy redactions across workspaces

The Copy Redactions Across Workspaces solution copies redactions from a source markup set to a destination markup set in a separate workspace.

To download the solution files, visit the Relativity Community.

This page includes the following sections: 

Before you begin

The Copy Redactions Across Workspaces solution copies redactions from a source markup set to a destination markup set in a separate workspace. The solution does not remove original redactions. It only appends new ones to the selected destination set.

Supported versions

This script is supported in Relativity 8.0 – Server 2021 and RelativityOne.

Solution version Supported Relativity version
4.4.0.1 9.4.254.2 - Server 2021, RelativityOne
4.2 9.4 - 9.4.224.2
4.1 8.0 - 9.3

Components

This solution consists of the following components:

  • Relativity scripts that run at the workspace level.
  • Relativity script that runs at the admin level.

Considerations

  • These scripts should only be run by a system admin. If you are not a system admin, we recommend you do not run these scripts.
  • The results of the script cannot be undone. We recommend that you create a back-up copy of all redactions before you run the solution.
  • If there are no redactions in the selected markup set for the Source Markup Set input, no documents are affected.
  • The saved search used as inputs to the Read Source Markup Set script and Write Destination Markup Set script needs to have images. Otherwise no documents are affected.
  • This solution doesn't support the client domains (multi-tenancy) and Data Grid features of Relativity.

Deploying and configuring the solution

Installing the Read Source Markup Set script

Install the Read Source Markup Set script to the workspace you want to copy redactions from.

  1. Navigate to the workspace which you are copying redactions from.
  2. Click the Administration tab, and then click the Scripts tab.
  3. Click New Relativity Script.
  4. Next to Script Type, click Select from Script Library.
  5. Next to Scripts, click Ellipsis (...) button.
  6. Select the radio button next to the Copy Redactions Across Workspaces - Read Source Markup Set script.
  7. Click OK.
  8. Click Save.

Installing the Write Destination Markup Set script

Install the Write Destination Markup Set script to the workspace you want to copy redactions to.

  1. Navigate to the workspace which you are copying redactions to.
  2. Click the Administration tab, and then click the Scripts tab.
  3. Click New Relativity Script.
  4. Next to Script Type, click Select from Script Library.
  5. Next to Scripts, click Ellipsis (...) button.
  6. Select the radio button next to the Copy Redactions Across Workspaces - Write Destination Markup Set script.
  7. Click OK.
  8. Click Save.

Running the solution

After you prepare the workspaces, you can configure and run each solution in its respective workspace.

Note: There should only be one instance of the solution running at a time. If you run multiple instances of the solution at the same time, the results may be unreliable.

Running the Setup script

  1. At the instance level, click Applications & Scripts. Then click Relativity Script Library.
  2. Find and select Copy Redactions Across Workspaces - Setup.
  3. Click Run.

Running the Read Source Markup Set script

Run the Read Source Markup Set script in the workspace which you are copying redactions from.

  1. In the workspace which you are copying redactions from, click the Administration tab, and then click the Scripts tab.
  2. Click the name of the Copy Redactions Across Workspaces - Read Source Markup Set script.
  3. Complete the following fields:
    • Source Document Set – Required, select the saved search that contains a list of documents you wish to execute upon.
    • Doc Identifier – Required, select the fixed-length text field that contains the Document Identifier field.
    • Source Markup Set – Required, select the markup set field that you would like to copy the redactions from.
  4. Click Run.

Running the Write Destination Markup Set script

Run the Write Destination Markup Set script in the workspace which you are copying redactions to.

  1. In the workspace which you are copying redactions to, click the Administration tab, and then click the Scripts tab.
  2. Click the name of the Copy Redactions Across Workspaces - Write Destination Markup Set script.
  3. Complete the following fields:
    • Dest. Document Set – Required, select the saved search that contains a list of documents you wish to execute upon.
    • Doc Identifier – Required, select the fixed-length field that contains the Document Identifier field.
    • Dest. Markup Set – Required, select the markup set field that you would like to copy the redactions to.
  4. Click Run.

Note: Doc Identifier fields for both the source and destination workspaces need to contain identical values in order to copy all redactions.

Viewing the results

After you run the solution by running the Read Source Markup Set script, the results appear as a report on the script page. The report includes a list that indicates how many markup sets have successfully been copied.

The Copy Redactions Across Workspaces - Read Source script report indicating that six markup sets were copied successfully.

After you run the solution by running the Write Destination Markup Set script, the results appear as a report on the script page. The report includes a list that indicates how many markup sets have successfully been copied.

The Copy Redactions Across Workspaces - Write Destination script report indicating that six markup sets were copied successfully.