Add event handlers to applications

After your event handler assembly builds successfully, you can upload it to an application or object in the Relativity UI. For more information, see Build your first event handler.

Use the following procedure to add your event handler assembly to an application:

  1. Open a Relativity instance used for development.
  2. Create an application in a workspace that you want to use for development. See Create an application in Relativity.

    Note: For information about linking your event handler to a custom object, see Creating and editing Relativity Objects.

  3. Navigate to the Resource File tab, and click New Resource File. For more details, see Resource Files on the Relativity Documentation site.
  4. In the Resource File field, click Browse to select the .dll file for your event handler from the directory where you built your project.

    Note: If you want to debug your event handler, you should also upload your Symbol files (.pdb) and associate it with the same application as you did for your event handler. See Troubleshoot event handlers.

  5. In the Application field, click ellipsis button to select your custom application. In general, you don't want to link to event handler assembly to the default application.
  6. Click Save. You can now link your event handler to a custom object in Relativity.

    Note: Add the event handler to a custom object before adding it to an application, If you don't first add it to a custom object, the event handler won't be displayed in the list used for adding it to an application. For more information, see Creating and editing Relativity Objects.

  7. Navigate to the workspace containing your application.
  8. Click the Relativity Applications tab and then click on your application name.
  9. On the details view of the application, scroll down to the associative list for your event handler type:
  10. To attach the event handler to your application, click the New or the Link button on the associative list.
  11. Select the your event handler in the dialog box. After you attach your event handler, it executes in Relativity as part of your application.