User workspace access and last login

The User Workspace Access and Last Login solution provides a comprehensive report of enabled users who had access to Relativity within a specified month, along with the corresponding time of their last login and their current Relativity Access flag value. The report also includes details about the associated groups and workspaces for each user.

Use the links in the Supported versions section to download the solution from the Relativity Community.

Note: To download any Community file linked to the documentation site, please ensure that you have valid Relativity Community credentials. If you are not already logged in to the Community, you'll be prompted to enter your credentials on the Community login screen.

If you are already logged in to the Community when you click a link, the file will be automatically downloaded to the bottom left corner of your screen.

In case you encounter an error message stating "URL No Longer Exists" after clicking a Community link, it could be related to a single sign-on issue with the SAML Assertion Validator. If this happens, we recommend reaching out to your IT department for assistance.

Before you begin

The User Workspace Access and Last Login solution generates a report by looking up all users that accessed Relativity during the month and year added to the Inputs pop-up modal. The solution then lists the following information for each of those users:

  • Current workspace access
  • Last login date
  • Current Relativity Access flag value

Supported versions

Note: Some versions of this application may not be eligible for support by Customer Support. For more information, see the Version support policy.

Click on any of these links to download the appropriate version from the Relativity Community:

Solution version Supported Relativity version
8.5 10.3 and above, RelativityOne
8.2 10.2
8.1 8.0 - 10.1

Category

This solution consists of a Relativity script that runs in Home mode for the Relativity instance.

Considerations

Review the following considerations for this solution:

  • This script should only be run by a system admin. If you are not a system admin, we recommend you do not run this script.
  • The solution reports on users listed in the Billing Agent table. This table is updated once a day during agent off hours. If you add users today, the report won't include them until the next time the Billing Agent runs.
  • If a user doesn't belong to any workspaces, report won't include the user.
  • The solution doesn't record historical workspace access. It reports only on workspaces that users can access on the date and time when the script runs.
  • This solution can't be run by client domain admins (multi-tenancy).
  • The report doesn’t include any workspaces that have been deleted. Any information about deleted workspaces won’t be included in the report.
  • The report doesn’t include any users that have been deleted. The report won’t include any information about workspaces accessed by these users.
  • The report doesn't include users in the System Administrator group.

Deploying and configuring the solution

Note: This solution is now available as an application. If you are upgrading from a script version of the solution to an application version of the solution, you must delete the original script before adding the new application to your environment and installing it to a workspace.

To deploy the solution, you first add it to the Application Library as a Relativity application. You can then install it from the Application Library to one or more workspaces.

Note: This script runs from the Admin level, you must install this application into a workspace for it to appear in the Script Library (at the instance level).

To add the solution to the Application Library:

  1. Log in to Relativity.
  2. Navigate to the Application Library tab.
  3. Click New Library Application.
  4. Either click Select File, or drag and drop the file into the Application.
  5. Navigate to and select the application file included in the solution, and then click Open.
  6. Click Save to upload the file to the Application Library.

To add the solution to a workspace:

  1. In the Workspaces Installed section, click Select to install the application to one or more workspaces.
  2. Select the workspace(s) where you want to install the application, and then click the Move selected left to right icon.
  3. Click Apply.
    The application is installed to the selected workspace(s). A list of workspace(s) where the application has been installed displays in the Workspaces Installed section.

Note: This script runs from the Admin level, you must install this application into a workspace for it to appear in the Script Library (at the instance level).

Running the solution

You configure and run the User Workspace Access and Last Login script from Home mode for the Relativity instance.

Complete the following steps to configure and run the script:

  1. Click the Relativity Script Library tab.
  2. Click the name of the User Workspace Access and Last Login script.
  3. In the console, click Run Script. The script input page appears.
  4. Complete the following fields: 
    • Month (mm) - Enter a two-digit numerical value for the month.
    • Year (yyyy) - Enter a four-digit numerical value for the year.
    • Group By - Select 'User' or 'User and Workspace' for a more detailed analysis.
  5. Click Run.

Viewing the results

After running the User Workspace Access and Last Login script, the results appear as a report on the script page.

User Report

(Click to expand)

User and Workspace Report

(Click to expand)

The following table describes the columns in the report:

Column Description
Workspace Name The display of the workspace depends on the input selections:
  • If you select User in the Group By field, this column displays a semi-colon delimited list of all workspaces that the user can currently access.
Client Name The name of the client associated with the user.
Matter Name The name of the matter associated with the user.
User Name The name of the user. It use the format Last name, First name.
User Artifact ID The Artifact ID of the user.
Email Address The email address of the user.
Group Name A semi-colon delimited list of groups the user is associated with in the workspace.
User Type The choice value of the user in the Type field.
Relativity Access The user’s current Relativity Access. It displays as Enabled or Disabled.
Date of Last Login The most recent date that the user logged in to Relativity. For a single user, this field is the same across all workspaces.
User Status When the script runs, it populates this column with the word Duplicate if same email address is associated with more than one workspaces.