Keyboard Shortcuts Manager (.NET)

The Keyboard Shortcuts Manager API supports retrieving all keyboard shortcuts available in a workspace, or a specific subset of them, such as those assigned to the system, choices, or fields. It also provides information about the actions that these shortcuts trigger.

As a sample use case, you might want to implement custom keyboard shortcuts in layouts, such as the review interface. You could use this service to retrieve the information required to attach the appropriate shortcut to a specific field or choice, or for global use at the system level. Users could then navigate with the custom keyboard shortcuts through fields and choices or trigger global actions with them.

You can also use the Keyboard Shortcuts Manager API through REST. For more information, see Keyboard Shortcuts Manager (REST).

This page contains the following information:

The Relativity.Review.SDK contains this API. For compatibility and package installation instructions, see Download the SDKs and NuGet packages.

Fundamentals for the Keyboard Shortcuts Manager API

The Keyboard Shortcuts Manager API contains the following methods and classes.

Methods

The Keyboard Shortcuts Manager API exposes the following method on the IKeyboardShortcutsManager interface in the Relativity.Review.Server.Versioned.<VersionNumber>.KeyboardShortcuts namespace:

  • ReadAsync() method - retrieves all the keyboard shortcuts for a workspace. This method takes the Artifact ID of the workspace containing the keyboard shortcuts and an optional Boolean value indicating the type of shortcuts to return, such as those for the system, choices, or fields. It returns a list of KeyboardShortcutInformation objects. See Retrieve keyboard shortcuts

Classes

The Keyboard Shortcuts Manager API includes the following classes available in the Relativity.Review.<VersionNumber>.KeyboardShortcuts.Models namespace:

  • KeyboardShortcutInformation class - represents information about a keyboard shortcut, including the type of shortcut such as choice, field, or system, the action triggered by executing the shortcut, and other information.

  • KeyCombination class - represents of a key combination used to activate a keyboard shortcut.

Retrieve keyboard shortcuts

To retrieve a list of all keyboard shortcuts in a workspace, call the ReadAsync() method and pass the Artifact ID of a workspace to it. This method also supports filtering on choice, field, or system shortcuts by passing a set of Boolean arguments. You can set these properties to the type of shortcuts that you want to return.

Use these guidelines to retrieve keyboard shortcuts:

  • Don't use the admin level context, specified by -1, as the target workspace.
  • Ensure that the user has permissions to view documents in the workspace.
  • Ensure that the user has permissions to view any fields associate with keyboard shortcuts. This requirement includes fields used for choices.

Additional Resources

DevHelp Community GitHub Release Notes NuGet

Share knowledge with the Relativity developer community.

Access tools and resources to build an application.

Review the most recent product release notes.

Create .NET Apps faster with NuGet.