History

On the History tab, you can view the actions of users throughout the workspace. Relativity has a comprehensive audit system that logs actions that users perform, object types, timestamps, and other details. This tab also includes views and filters to help you navigate through the audit records.

If the workspace has been restored, ensure that Audits have been migrated properly. Also, ensure you have allowed viewing of audits at the workspace level for the group.

When you view a document in the Review Interface, you can display its history in the related items pane by selecting the Document History icon.

History view fields

You can customize the views available on the History tab or create new views as necessary. The History tab includes pre-configured views for recently updated documents, long running queries, and imaging history, which you can modify.

The following fields are available in views on this tab:

  • Action—the user activity captured in the audit record.
  • Artifact ID—the artifact ID of the audit action.
  • Details—the detailed description of the audit action.
  • Execution time—the length of time in milliseconds for a document query to run.
  • ID—the identifier for the audited item; each tracked action has its own unique identifier.
  • Name—the name of the object.
  • Object type—the type of object.
  • Request origination—the connection details for the user that sent the change request.
  • Timestamp—the date and time when the audit action occurred.
  • User name—the user who initiated the action.

You can export the contents of a view to Excel using Excel icon at the top of the screen. Only the currently-loaded records are included in the Excel file. For example, in the following workspace, only 1,000 records would be included instead of the full 2,501 records.

Document view first 1,000

Some features' history views are more detailed.

Filters on the History tab

On the History tab, you can search for specific audit records by using filters just as you would on other tabs. For more information on filtering, see Filters.

You can also search for choice values using the Details Filter. Actions related to field choices are recorded using Artifact ID. To display the Artifact ID for choice values, click the Choice Legend icon in the view bar.

On the Choice Legend pop-up, you can search for choices in the workspace, their artifact IDs, and their associated fields. You can then enter Artifact ID listed for a choice value in the Details Filter and filter the audit records.

You can also use views to filter audit records. See History view fields.

Audited actions

The following table lists audited actions in Relativity:

If you perform a job while previewing a user's security settings, the audit action will be credited to your user name and not to the user whose security you were previewing when you started the job.

Action nameDescription of activity
CaseMap - Add DocumentA document was sent to CaseMap.
CaseMap - Add FactA selection of text from the viewer was sent to CaseMap as a fact.
Conversion CompleteA file was converted by way of a user clicking on a file link in the document list, running an imaging set, imaging on the fly, running a mass image operation, or switching to text or production mode in the viewer.
CreateAn item was created.
DeleteAn item was deleted.
Document QueryA query was run on a list of documents, or a document query was canceled. (A message indicating that a query was canceled is displayed in the details and on the Query Text pop-up.)
ExportThe contents of a production set, saved search, folder, or subfolder were exported.
Images - CreatedImages were created.
File DownloadA file was downloaded through the Single Simple File Upload application. For example, a user clicked Download File on the Error Actions console of an individual processing error layout.
File UploadA file was uploaded through the Single SimpleFile Upload application. For example, a user clicked Upload Replacement File on the Error Actions console of an individual processing error layout.
Images - Created for ProductionImages corresponding to a production outside of Relativity were imported into the system.
Images - DeletedImages were deleted.
ImportContent associated with a load, production, or image file was imported.
Markup - Image - CreatedRedactions or highlights were added to an image.
Markup - Image - DeletedRedactions or highlights were removed from an image.
Markup - Image - ModifiedRedactions or highlights were moved, resized or edited on an image.
Markup - Native - CreatedRedactions or highlights were added. This audit entry applies to transcripts only.
Markup - Native - DeletedRedactions or highlights were removed. This audit entry applies to transcripts only.
Markup - Native - UpdatedRedactions or highlights were moved, resized or edited. This audit entry applies to transcripts only.
MoveA document was moved from one folder to another.
Native - CreatedA native file was loaded into Relativity.
Native - DeletedA native file was removed from Relativity.
Pivot QueryA Pivot report was run, or a Pivot report was canceled. (A message indicating that a query was canceled is displayed in the details and on the Query Text pop-up.)
PrintA document was printed. (ActiveX viewer only)
Production - Add DocumentA document was added to a production.
Production - Remove DocumentA document was removed from a production.
QueryA process ran a query (such as categorization), or a query was canceled. (A message indicating that a query was canceled is displayed in the details and on the Query Text pop-up.)
RelativityScriptExecutionA Relativity script was run.
ReportQueryA summary report was run.
RunA file was imaged, saved as a PDF, or otherwise converted for viewing
Search Cache Table CreationA search cache table was created. (Search cache tables are created the first time you search for a term or phrase using dtSearch or Relativity Analytics.)
SecuritySecurity rights were assigned or changed
Tally/Sum/AverageThe mass operation Tally/Sum/Average was run in the workspace.
UpdateDocument metadata was updated on a single-document basis. In addition, filters on information related to applications installed through the workspace or by an agent.
Update - Mass EditDocument metadata was updated on a mass basis.
Update - Mass Replace Document metadata was edited using a text mass replacement.
Update - PropagationDocument metadata was edited according to a propagation rule.
ViewA document was viewed.
Workspace UpgradeDetails about scripts run on a workspace during an upgrade.

No login action exists when you access a workspace. Relativity interprets the login based on any other auditable action in the workspace. For example, if you view a document in Workspace A, Relativity audits that view action on the History tab and indicates that a user accessed Workspace A.

Exporting the history list

You can export a history list view as a .csv file using the following steps:

When Audit is installed, you can't export from the History tab.

  1. Navigate to the History tab.
  2. Select the history objects you would to export.
  3. Click Export to File.
  4. A pop-up appears. Select values for the fields:
    1. Format—select Comma Separated Values, .csv, which creates a comma delimited text file.
    2. Encoding—select the desired encoding for the output file.
    3. Escape Formulas—select yes or no. When you select yes, any line starts with the following special characters: =,@,+,-, or if the line starts with any combination of spaces before those characters, Relativity prepends a single quote to the line.
  5. Click Run to export the file or Cancel to cancel the export.
Return to top of the page
Feedback